The documentation generated by this project is hosted at https://sites.ecmwf.int/docs/atlas

The documentation is written in ReStructuredText (rst), and converted by Pelican into HTML. The C++ API is generated via Doxygen. The generated documentation is using m.css which results in a nice looking and responsive web site.

The documentation is licensed with the Apache 2.0 license, see LICENSE file

• Python version 3.6 or higher
• Doxygen version 1.8.17 or higher
• LaTeX, ghostscript optional: Recommended for rendering maths

make html

For detailed options, see make help

make serve

Now open browser at http://localhost:8000. Voila.

Following script can be used to publish the website to https://sites.ecmwf.int/docs/atlas.

scripts/publish.sh

Note, this requires special access credentials, and is only intended for official maintainers.

On MacOS, ghostscript needs to be installed as well when using LaTeX, and the LIBGS environment variable needs to be set.

brew install ghostscript
export LIBGS=${HOMEBREW_PREFIX}/lib/libgs.dylib