tree: f2394b1e0fa1635669b2f5bc1bda7fdd0c638f6f [path history] [tgz]
  1. extensions/
  2. markdown/
  3. refman/
  4. theme/
  5. yaml/
  6. .editorconfig
  7. genrefman.py
  8. genrelnotes.py
  9. jsonvalidator.py
  10. meson.build
  11. meson_options.txt
  12. README.md
  13. sitemap.txt
docs/README.md

Meson Documentation

Build dependencies

Meson uses itself and hotdoc for generating documentation.

Minimum required version of hotdoc is 0.8.9.

Instructions on how to install hotdoc are here.

Our custom hotdoc extensions require:

Building the documentation

From the Meson repository root dir:

$ cd docs/
$ meson setup built_docs/
$ ninja -C built_docs/

Now you should be able to open the documentation locally

built_docs/Meson documentation-doc/html/index.html

Upload

Meson uses the git-upload hotdoc plugin which basically removes the html pages and replaces with the new content.

You can simply run:

$ ninja -C built_docs/ upload