third_party_ninja/doc
liangxinyan e9e12353f0 IssueNo: https://gitee.com/openharmony/build/issues/I9ROAO
Signed-off-by: liangxinyan <liangxinyan2@huawei.com>
2024-05-24 15:53:22 +08:00
..
dblatex.xsl update OpenHarmony 2.0 Canary 2021-06-02 02:31:53 +08:00
docbook.xsl update OpenHarmony 2.0 Canary 2021-06-02 02:31:53 +08:00
doxygen.config update OpenHarmony 2.0 Canary 2021-06-02 02:31:53 +08:00
manual.asciidoc IssueNo: https://gitee.com/openharmony/build/issues/I9ROAO 2024-05-24 15:53:22 +08:00
README.md update OpenHarmony 2.0 Canary 2021-06-02 02:31:53 +08:00
style.css IssueNo: https://gitee.com/openharmony/build/issues/I9ROAO 2024-05-24 15:53:22 +08:00

This directory contains the Ninja manual and support files used in building it. Here's a brief overview of how it works.

The source text, manual.asciidoc, is written in the AsciiDoc format. AsciiDoc can generate HTML but it doesn't look great; instead, we use AsciiDoc to generate the Docbook XML format and then provide our own Docbook XSL tweaks to produce HTML from that.

In theory using AsciiDoc and DocBook allows us to produce nice PDF documentation etc. In reality it's not clear anyone wants that, but the build rules are in place to generate it if you install dblatex.