From 5ac00824965d968c20f665ccd9b2005e2f896d30 Mon Sep 17 00:00:00 2001 From: MaxThevenet Date: Fri, 10 Jan 2020 14:51:24 -0800 Subject: document how to compile the documentation --- Docs/source/developers/documentation.rst | 25 ++++++++++++++++++++----- 1 file changed, 20 insertions(+), 5 deletions(-) (limited to 'Docs/source/developers/documentation.rst') diff --git a/Docs/source/developers/documentation.rst b/Docs/source/developers/documentation.rst index 45ff4cd46..3c728a4b6 100644 --- a/Docs/source/developers/documentation.rst +++ b/Docs/source/developers/documentation.rst @@ -3,10 +3,6 @@ Documentation ============= -.. warning:: - - Needs info on how to install all pieces to compile the doc! Some basic info is in the ``CONTRIBUTING.md`` . - Doxygen documentation --------------------- @@ -47,4 +43,23 @@ Your Doxygen documentation is not only useful for people looking into the code, Exhale documentation -------------------- -Very similar to Breathe, the Python module `exhale `__ reads the full Doxygen documentation and renders it in ` rst `__ format, and is accessible from the main WarpX ReadTheDocs page. +Very similar to Breathe, the Python module `exhale `__ reads the full Doxygen documentation and renders it in `rst `__ format, and is accessible from the main WarpX ReadTheDocs page. + +Building the documentation +-------------------------- + +To build the documentation, you will need to install Doxygen as well as the Python modules `breathe` and `exhale`. On MacOS this can by done by + +.. code-block:: sh + + brew install doxygen + pip install breathe exhale + +Then, to compile the documentation, use + +.. code-block:: sh + + cd Docs/ + make html + # This will first compile the Doxygen documentation (execute doxygen) + # and then build html pages from rst files using sphinx, breathe and exhale. -- cgit v1.2.3