Skip to content

Commit

Permalink
Update the documentation on how to build the documentation (#697)
Browse files Browse the repository at this point in the history
Co-authored-by: Enrico Stragiotti <enrico.stragiotti@onera.fr>
  • Loading branch information
enricostragiotti and Enrico Stragiotti authored Dec 17, 2024
1 parent 5722846 commit c65e721
Show file tree
Hide file tree
Showing 2 changed files with 4 additions and 2 deletions.
3 changes: 2 additions & 1 deletion doc/_src_docs/dev_docs.rst

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

3 changes: 2 additions & 1 deletion doc/_src_docs/dev_docs.rstx
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,8 @@ Users can read the docs online at `smt.readthedocs.io <https://smt.readthedocs.i
This is especially necessary because most of the docs in SMT contain code, code print output, and plots that are dynamically generated and embedded during the doc building process.
The docs are written using reStructuredText, and there are a few custom directives we have added for this embedding of dynamically-generated content.

First, install the required dependencies to build the doc with: ``pip install -r doc/requirements.txt``
First, install the required package dependencies with: ``pip install -e .``.
Additionally, install the required dependencies to build the doc with: ``pip install -r doc/requirements.txt``.

Then to generate the doc, the developer should go to the ``doc`` directory and run ``sphinx_auto_embed``, then ``make html``.

Expand Down

0 comments on commit c65e721

Please sign in to comment.