Build the docs#

Our documentation is written in sphinx. Read their primer to get up to speed on writing in the reStructuredText format.

Install Dependencies#

All of the dependencies should be installed with pip or conda, except for the package which documents TUV-x’s source code, sphinx-fortran. This is because published sphinx-fortran do not work with python3.

Install each of the requirements in requirments.txt.

Build and view the output#

From the root directory of tuv-x, run these commands

cd docs
make html

#macOS only
open _build/html/index.html

Navigate to tuv-x/docs/_build/html/index.html in your browser and you should see the docs.

Preview branch changes#

If you are added as a contributor to the github project, anytime you push a commit on your branch, a copy of your documentation is hosted on github pages at https://ncar.github.io/tuv-x/branch/<your-branch-name>. You can preview any changes you make there before submitting a PR to ensure that your changes work on our github pages.

Style guide#

We use the following identifiers to add logical structure in the documentation.

  • # (over and under) for module headings

  • = for sections

  • - for subsections

  • ^ for subsubsections

  • ~ for subsubsubsections

  • " for paragraphs