aa1c6b3f07
This commit changes the way that Odoo python dependencies should be installed. Before this commit, the described way to install Odoo dependencies was by using the `pip` utility. Now, we explicitly recommend to use a Debian based system and install Odoo dependencies from their packaging tool. The main reasons are: * Odoo productions instances are, most of the time, run on Debian based systems with those package already installed * That way, a developer cannot mistakenly use a feature from a dependency that does not exists on those production environments * Avoid mixes of python packages on the developer/user 's system closes odoo/documentation#1364 Signed-off-by: Castillo Jonathan (jcs) <jcs@odoo.com> |
||
|---|---|---|
| .tx | ||
| content | ||
| extensions | ||
| locale | ||
| static | ||
| .gitignore | ||
| commit_template.txt | ||
| conf.py | ||
| Makefile | ||
| README.md | ||
| redirects.txt | ||
| requirements.txt | ||
Odoo documentation
Build the documentation locally
Requirements
- Git
- Python 3.7 or 3.8
- Python dependencies listed in the file
requirements.txt. - Make
- A local copy of the odoo/odoo repository in master (Optional)
Instructions
-
In a terminal, navigate to the root directory and compile the documentation to HTML with the following command:
makeAdditional commands are available with
make help. -
Open the file
documentation/_build/html/index.htmlin your web browser to display the render. -
See this guide for more detailed instructions.
Optional: to fully build the developer documentation with inline docstrings for documented Python
functions, place your local copy of the odoo/odoo repository in the root directory. Alternatively,
create a symbolic link with odoo as link name. If the Odoo sources are not found, a warning will
be shown.
Contribute to the documentation
For contributions to the content of the documentation, please refer to the Introduction Guide.
To report a content issue, request new content or ask a question, use the repository's issue tracker as usual.
Learn More
To learn more about Odoo, in addition to the documentation, have a look at the official eLearning and Scale-up, The Business Game.