Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Build guide docs - build docs from local #789

Merged
merged 5 commits into from
Oct 18, 2024
Merged
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions docs/advanced_documentation/build-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -466,3 +466,22 @@ the {{ "[`tests/package_tests`]({}/tests/package_tests)".format(gh_link_head_blo
This project has the main project as a required dependency. Configuration will fail if the main project has not been
built and installed, e.g. using `cmake --build --preset <preset> --target install` for the current preset.
```

## Documentation

The documentation is built in [Sphinx](https://github.com/sphinx-doc/sphinx). It can be built locally in a Python environment. The packages required for building it can be found under the `[docs]` optional dependencies. In addition, the `power-grid-model` Python package needs to be built by following the steps mentioned in the [above](#build-python-package). After that, the documentation specific packages can be installed via:
nitbharambe marked this conversation as resolved.
Show resolved Hide resolved

```shell
pip install -e .[doc]
nitbharambe marked this conversation as resolved.
Show resolved Hide resolved
nitbharambe marked this conversation as resolved.
Show resolved Hide resolved
```

The C API documentation is generated using [Doxygen](https://www.doxygen.nl). If you do not have Doxygen installed, it can also be temporarily bypassed by commenting out the `breathe` settings in `docs/conf.py`.

The documentation can be built by following which gives out the html in `docs/_build/html` directory.
nitbharambe marked this conversation as resolved.
Show resolved Hide resolved

```shell
cd docs/doxygen
doxygen
cd ..
sphinx-build -b html . _build/html
```
Loading