mirror of
https://github.com/odoo/documentation.git
synced 2025-12-12 07:29:27 +07:00
d229372795
task-none
Starting from 1 January 2026, companies in Belgium need to be registered
on the Peppol network. Specifically, even though there are two EASs for
Belgium, which are:
- 0208 - company registry number;
- 9925 - Belgian VAT;
all Belgian companies must be registered under scheme 0208 with their
Belgian company number.
Scheme 9925 is optional which means companies can be registered both
on 0208 and 9925. But in any case, they need to be registered on 0208.
We add an `important` block in the Belgium page to explain this
requirement.
closes odoo/documentation#15617
X-original-commit: e49cd7c319
Signed-off-by: Xavier Platteau (xpl) <xpl@odoo.com>
Signed-off-by: Antoine Dupuis (andu) <andu@odoo.com>
Odoo documentation
Build the documentation
Requirements
- Git
- Python 3.10 to 3.14.
- Make
- Python dependencies from
requirements.txt(see instructions below) - A local copy of the odoo/odoo repository (optional)
- A local copy of the odoo/upgrade-util repository (optional)
Quick start
- Create and activate a virtual environment.
- On Linux and macOS:
python3 -m venv .venv && source .venv/bin/activate - On Windows (PowerShell):
py3 -m venv .venv; .\.venv\Scripts\Activate.ps1
- On Linux and macOS:
- Install the Python dependencies:
pip install -r requirements.txt - Build the documentation:
make html(see more commands withmake help) - Open
documentation/_build/html/index.htmlin your web browser.
Additional build options
make fastto build the documentation with a shallow menu (faster).make cleanto delete the build files.make testto run the guidelines tests.make html CURRENT_LANG=frto build the documentation only in French.make html CURRENT_LANG=fr LANGUAGES=en,fr,deto build the documentation in French and enable the language switcher, with the specified LANGUAGES as available languages. This command must be invoked for each CURRENT_LANG you want to build.make html VERSIONS=17.0,18.0,saas-18.4,19.0,masterto build the documentation in the current version and enable the version switcher, with the specified VERSIONS as available versions. This command must be invoked for each of the VERSIONS you want to build.
The list of available languages can be found in conf.py, in the languages_names variable.
When building the documentation for a specific language or version, the build files are created in
documentation/_build/html/<language>/, documentation/_build/html/<version>/ or
documentation/_build/html/<version>/<language>/.
Using local Odoo sources
If you have local checkouts of odoo/odoo and/or odoo/upgrade-util, place them either:
- as siblings of this repository (in the parent directory), or
- inside the
documentationdirectory.
When present in one of these locations, the build will include Python docstrings from those repositories if their version matches the documentation's version.
Troubleshooting
- Verify your Python version:
python3 --version(must be 3.10–3.14) - Ensure your virtual environment is active and dependencies are installed.
- If you have made changes to the file structure, try
make cleanbefore building. - If the language or version switchers redirect to a missing file, check that you have built the documentation for all available languages and versions.
- The "Developer" documentation is only available in English.
Contribute to the documentation
For contributions to the content of the documentation, see the Introduction Guide.
To report a content issue, request new content, or ask a question, use the issue tracker.