taiga-doc | Taiga documentation source | Calendar library

Install requirements: Ruby / asciidoctor + pygments.rb (installed via. bundler using the provided Gemfile). You can install Ruby through the apt package manager, pacman, rbenv, or rvm.
Open index.adoc in a text editor, make a minor modification and then save the file
If Guard is working properly, dist/index.html will be created/updated automatically
If libnotify is configured correctly, a notification will be shown confirming that index.adoc has been found and rendered accordingly
[Web][3] web browser (formerly Epiphany web browser) - has built-in auto-reload functionality
Firefox + [Auto Reload][4] add-on
[Please add other working configurations here]
Open dist/index.html in the browser
As before, save a modification to index.adoc
Once Guard has rendered the new copy of dist/index.html, the browser will auto-reload the page
Position the text editor and web browser windows side-by-side (or on different screens!), save changes and see the result in the browser almost immediately
Changes to any of the .adoc files within the api/ directory or its sub-dirs will render dist/api.html - since many .adoc files are combined to render the single HTML file, there is a slight lag in the live preview as the conversion process completes
Otherwise, there is a 1:1 relationship between the .adoc file and its rendered .html file - changes to these are displayed almost instantaneously