BUILD.adoc

Building

We use Asciidoctor for slides and assignments.

To compile .adoc to HTML, you need to have Ruby and bundler. Using rbenv for project-local ruby package installation is recommended.

We use Mermaid.js for diagrams in slides. It requres Node installed. You can use fnm to manage Node versions.

Prerequisites

$ eval "$(rbenv init -)" # when using rbenv
$ gem install bundler
$ bundle --path=.bundle/gems --binstubs=.bundle/.bin
$ npm ci

Building

$ eval "$(rbenv init -)" # when using rbenv
$ ./rake
$ firefox ./target/index.html

Links

• Rendered Presentations

• AsciiDoc Syntax Quick Reference

• Asciidoctor User Manual

Translations

The materials are in English. Translation to over languages is allowed and encouraged, if you would like to maintain a translation, send us a pull request with a link.

Partial translations to German, French and Spanish are available in the old repository.