Odoo documentation sources
Go to file
Julien Castiaux 508a324bc0 [FIX] deploy: set Content-Security-Policy on static
The Content-Security-Policy[^1] http header was only set on the response
generated by controllers but it was missing from the `/<module>/static/`
route.

It is not strictly necessary to set that header on the responses comming
from that routes as it is not possible to add new static files or edit
existing ones via the interface (not even as admin). Only the developers
and system administrator can access those files.

It is also worth mentionning that using the Odoo internal web server to
deliver static files is suboptimal. Outside of a dev environment, those
files will typically be delivered via a web server[^2] and sysadmins
should configure their web server to set the CSP header on static images.

[^1]: https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP
[^2]: https://www.odoo.com/documentation/master/administration/install/deploy.html#serving-static-files-and-attachments

closes odoo/documentation#6952

X-original-commit: f3f44fe5f2
Related: odoo/odoo#146588
Signed-off-by: Julien Castiaux (juc) <juc@odoo.com>
2023-12-18 22:48:47 +00:00
.tx [I18N] theme: remove reference to translation 2023-03-09 12:00:58 +01:00
content [FIX] deploy: set Content-Security-Policy on static 2023-12-18 22:48:47 +00:00
extensions [IMP] odoo_theme: toctrees-l1,l2 design improvement 2023-11-21 11:28:12 +00:00
locale [FIX] dev/reference: Fix external reference 2023-11-20 11:37:08 +00:00
redirects [REF] Inventory: Restructure Inventory scope 2023-12-11 21:56:19 +00:00
static [FIX] accounting: cheat sheet reconcile 2023-12-13 11:00:28 +00:00
tests [IMP] tests: make review UX and resource files 2023-11-13 18:06:55 +00:00
.gitattributes [ADD] .gitattributes: include RST files in language statistic on GitHub 2022-04-29 11:01:52 +02:00
.gitignore [ADD] .gitattributes: include RST files in language statistic on GitHub 2022-04-29 11:01:52 +02:00
commit_template.txt [FIX] *: enforce 1 newline on files end 2022-11-18 18:04:49 +01:00
conf.py [IMP] supported_versions: release 17.0 2023-11-07 12:29:43 +00:00
COPYRIGHT [ADD] Add LICENSE and COPYRIGHT 2023-09-13 01:53:45 +00:00
LICENSE [ADD] Add LICENSE and COPYRIGHT 2023-09-13 01:53:45 +00:00
Makefile [IMP] tests: make review UX and resource files 2023-11-13 18:06:55 +00:00
README.md [IMP] README: remove version from links and rephrase explanations 2023-01-03 20:14:55 +01:00
requirements.txt [FIX] requirements: bump libsass to match odoo 2023-05-16 08:24:19 +02:00

Odoo documentation

Build the documentation locally

Requirements

  • Git
  • Python 3.6, 3.7, or 3.8
  • Python dependencies listed in the file requirements.txt.
  • Make
  • A local copy of the odoo/odoo repository (optional)

Instructions

  1. In a terminal, navigate to the root directory of the documentation and build it make. Additional commands are available with make help.
  2. Open the file documentation/_build/html/index.html in your web browser.
  3. See this guide for more detailed instructions.

Optional: place your local copy of the odoo/odoo repository in the parent directory or in the root directory of the documentation to build the latter with the documented Python docstrings.

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.

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.