meson/docs
Christoph Reiter 8d04b3ce74 CI: Move all remaining jobs from travis-ci to GHA
Some changes:

* Set HOME to /root, since github mounts its own HOME and 'wine'
  (because of permissions) and 'dub' (can't find packages) don't
  like that.
* Remove the seccomp option, doesn't seem to be needed.
2020-12-11 13:45:11 -08:00
..
markdown CI: Move all remaining jobs from travis-ci to GHA 2020-12-11 13:45:11 -08:00
markdown_dynamic Made Commands.md dynamically generated (#7346) 2020-06-30 23:56:08 +03:00
theme/extra rename unstable-kconfig to unstable-keyval 2020-05-08 20:56:14 +03:00
.editorconfig editorconfig: Use tabs for sitemap.txt [skip ci] 2018-11-08 20:38:39 +02:00
README.md Update Meson docs README [skip ci] 2018-09-27 01:43:22 -07:00
genrelnotes.py Update Python2 syntax to Python3 syntax in genrelnotes.py 2019-12-06 15:24:44 +02:00
meson.build docs: fix "edit on GitHub" links 2020-12-10 00:26:28 +02:00
sitemap.txt Bump version number for release. This is the 10 000th commit! 2020-10-30 10:25:24 +02:00

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.

Building the documentation

From the Meson repository root dir:

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

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

Contributing to the documentation

Commits that only change documentation should have [skip ci] in their commit message, so CI is not run (it is quite slow). For example:

A commit message [skip ci]