42 lines
1.4 KiB
Markdown
42 lines
1.4 KiB
Markdown
# Documentation
|
|
|
|
This document describes how to generate documentation of the library from the sources.
|
|
If you're looking for the documentation please [follow this link](#).
|
|
|
|
## Prerequsites
|
|
|
|
1. Doxygen
|
|
2. Python 3.9+
|
|
3. Pipenv
|
|
|
|
## Installation
|
|
|
|
The first time setup is required before generating the documentation. Follow these steps:
|
|
1. Open terminal in the `docsrc` directory
|
|
2. Run `pipenv install`
|
|
|
|
### Apple Silicon M1
|
|
|
|
On Apple M1 processors you may get this error when trying to build the documentation: `Could not parse the contents of index.xml as an xml.`
|
|
|
|
Most likely this issue is caused by an architecture mismatch of the `lxml` package.
|
|
To fix this issue open the Pipenv shell by running `pipenv shell` and follow these steps:
|
|
1. Run `pip uninstall lxml`
|
|
2. Run `arch -arm64 pip install lxml --no-binary lxml`
|
|
|
|
This solution forces `lxml` to be built from the sources.
|
|
|
|
## Generating the documentation
|
|
|
|
1. Open terminal in the `docsrc` directory
|
|
2. Run the Doxygen command `doxygen`
|
|
3. Open the Pipenv shell `pipenv shell`
|
|
4. Run the build `make html`
|
|
|
|
The generated documentation will be available in the `docsrc/build/html` directory.
|
|
|
|
## Github pages
|
|
|
|
In order to build the documentation that's going to be published as Github pages run `make github`.
|
|
The generated HTML build will be automatically moved to the `docs` directory.
|