1695b41eeSopenharmony_ciThis directory contains the Ninja manual and support files used in 2695b41eeSopenharmony_cibuilding it. Here's a brief overview of how it works. 3695b41eeSopenharmony_ci 4695b41eeSopenharmony_ciThe source text, `manual.asciidoc`, is written in the AsciiDoc format. 5695b41eeSopenharmony_ciAsciiDoc can generate HTML but it doesn't look great; instead, we use 6695b41eeSopenharmony_ciAsciiDoc to generate the Docbook XML format and then provide our own 7695b41eeSopenharmony_ciDocbook XSL tweaks to produce HTML from that. 8695b41eeSopenharmony_ci 9695b41eeSopenharmony_ciIn theory using AsciiDoc and DocBook allows us to produce nice PDF 10695b41eeSopenharmony_cidocumentation etc. In reality it's not clear anyone wants that, but the 11695b41eeSopenharmony_cibuild rules are in place to generate it if you install dblatex. 12