• You need:

  • Docker CE 18.09+ (with local bind-mount capability - Docker4Mac, Docker4Windows or a local Linux Docker install)

  • docker-compose in your PATH (automatically installed with Docker4Mac and Docker4Windows)

  • GNU Make in your PATH

• If you want to build and serve the slides locally, with a live-reloading capability (e.g. change a *.adoc, regenerate the HTML and reload the web-browser) to get a WYSIWYG experience:

  • Clone the repository

  • Run the following make command:

• Open the URL link:http://localhost:8000

• Edit one of the *.adoc file, save it, and see the page reload

  • it is valid for images and styles also

You can validate the HTTP links and the HTML’s w3c compliance of the generated slide deck.

If you already generated the file ./dist/index.html, then run the following make command:

Otherwise, you can run the all command ,as the CI process is doing:

If you want to get a shell inside the "build and serve" container, run the following make command:

Example: updating the package.json (and lock) depencies

make shell
/app # ncu -u
...