The Meson Build System http://mesonbuild.com/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

37 lines
856 B

# Meson Documentation
## Build dependencies
Meson uses itself and [hotdoc](https://github.com/hotdoc/hotdoc) for generating documentation.
Minimum required version of hotdoc is *0.8.9*.
Instructions on how to install hotdoc are [here](https://hotdoc.github.io/installing.html).
Our custom hotdoc extensions require:
- [chevron](https://pypi.org/project/chevron)
- [strictyaml](https://pypi.org/project/strictyaml)
## 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
```