Commit Graph

173 Commits

Author SHA1 Message Date
Alvaro Fuentes
3e331b75e3 [IMP] conf: strip odoo.upgrade.testing
The prefix that includes the full module path is just noise. This patch
follows the same strategy used to remove `odoo.upgrade.util` prefix.

To be merged after: odoo/upgrade-util#324

closes odoo/documentation#14914

X-original-commit: 33aea00007
Signed-off-by: Alvaro Fuentes Suarez (afu) <afu@odoo.com>
2025-10-17 17:54:35 +00:00
Antoine Vandevenne (anv)
6f52af539b [IMP] supported_versions: release 19.0
closes odoo/documentation#14630

X-original-commit: 2a2ca31370
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2025-09-22 13:55:56 +00:00
Olivier Dony
b32728c4a1 [FIX] legal: fix minor issues
- consistently translate OE contract names
- fix minor wording/typo in spanish translation
2025-07-05 06:55:20 +02:00
Christophe Monniez
f02364e65a [REL] saas-18.4 2025-06-24 11:05:34 +00:00
Xavier-Do
6226fbb93d [IMP] conf: vendor python inventories
Reaching external ressources while running tests is an important source
of random error and can even causes deterministic errors when a service
is down for a while.

Runbot will soon block all external requests, this commit follows
changes introduced in #13669 and vendors the python inventories.

closes odoo/documentation#13759

X-original-commit: 5a69ad5e14
Signed-off-by: Xavier Dollé (xdo) <xdo@odoo.com>
2025-06-24 08:35:32 +00:00
Xavier Morel
144051120d [FW][IMP] conf: remove pillow inventory, cache werkzeug
The pallets website is regularly unreachable (due to DNS failures so it's not even that we get rate limited even though we probably hit it excessively), which causes a warning during documentation build, which in turn causes a completely unnecessary build failure.

Some werkzeug links seem to be generated (in the backend docs), so just commit the werkzeug inventory file as it's pretty small.

Also remove the pillow inventory entirely, it doesn't seem to cause issues but also seems completely unused.

closes odoo/documentation#13699

Forward-port-of: odoo/documentation#13669
Signed-off-by: Xavier Morel (xmo) <xmo@odoo.com>
2025-06-13 12:35:54 +00:00
Alvaro Fuentes
17d60d228e [IMP] conf.py: strip module path from upgrade utils
The full module path in upgrade utils docs causes confusion for users.
See issues odoo/upgrade-util#272 and odoo/upgrade-util#175.

All utils we document online should be used via the top-level module
--i.e. `util.name` instead of `util.submodule.name`

Stripping the module path can be achieved in the configuration with
[`add_module_name=False`](https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-add_module_names)
Unfortunately this is a global setting that could affect other parts of
Odoo documentation. Thus in current patch we strip the module path from
the signature of `odoo.upgrade.util` functions and classes.

Technical links:
https://www.sphinx-doc.org/en/master/extdev/event_callbacks.html#event-object-description-transform
https://www.sphinx-doc.org/en/master/extdev/nodes.html#sphinx.addnodes.desc_signature
https://github.com/sphinx-doc/sphinx/blob/v4.3.2/sphinx/domains/python.py#L512
https://sphinx-docutils.readthedocs.io/en/latest/docutils.nodes.html#docutils.nodes

closes odoo/documentation#13554

X-original-commit: fa506a68db
Signed-off-by: Victor Feyens (vfe) <vfe@odoo.com>
Signed-off-by: Alvaro Fuentes Suarez (afu) <afu@odoo.com>
2025-05-26 15:16:43 +00:00
samueljlieber
8789531c10 [ADD] legal: i18n pt_BR terms of sale
closes odoo/documentation#13536

X-original-commit: 42c3efc53a
Signed-off-by: Olivier Dony (odo) <odo@odoo.com>
2025-05-25 10:15:58 +00:00
Antoine Vandevenne (anv)
d099df1888 [IMP] supported_versions: release saas-18.3
closes odoo/documentation#13331

X-original-commit: 0b16382558
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2025-05-13 09:26:50 +00:00
Brandon Mercier
8122da1c51 [ADD] tutorials/website_theme: Add tutorials to build a website theme
closes odoo/documentation#13225

X-original-commit: 3b5d7e9d40
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Céline de Lannoy (cede) <cede@odoo.com>
2025-05-08 04:08:40 +00:00
Antoine Vandevenne (anv)
aed90fcfed [FIX] core: list versions in descending order in the version switcher
closes odoo/documentation#12377

X-original-commit: 344228852e
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2025-03-12 19:34:06 +00:00
Antoine Vandevenne (anv)
5327f0b128 [IMP] supported_versions: release saas-18.2
closes odoo/documentation#12342

Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2025-03-10 12:55:35 +00:00
Antoine Vandevenne (anv)
ac30647c20 [IMP] conf.py: use SaaS branch names as labels in the version switcher
This removes the confusion induced by simultaneously labelling several
SaaS branches as "Odoo Online" in the version switcher.

New branches will be automatically labelled as "Odoo xx.y" as they are
frozen by the freeze script.

task-4597225

Part-of: odoo/documentation#12342
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2025-03-10 12:55:35 +00:00
Antoine Vandevenne (anv)
4e16ba9c2e [IMP] conf.py: allow referencing unlabelled versions and languages
This commit removes the requirement on versions and languages to have a
label in `versions_names`/`languages_names` to be displayed in the
version/language switcher. Instead, if a version/language has no label
defined, the raw version/language string will be used as fallback.

This change makes it easier to add new versions or languages to the
documentation without having to explicitly define display labels for
them in `conf.py`. The responsibility of ensuring that referenced
versions and languages actually exist is shifted to the build
configuration.

Part-of: odoo/documentation#12342
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2025-03-10 12:55:35 +00:00
Krzysztof Magusiak (krma)
c9b4545e8f [IMP] release: PEP440 release naming
Use the PEP440 release naming.

closes odoo/documentation#11863

Related: odoo/odoo#195176
Signed-off-by: Krzysztof Magusiak (krma) <krma@odoo.com>
2025-01-27 19:38:21 +00:00
Antoine Vandevenne (anv)
a8d555494f [IMP] supported_versions: release saas-18.1
closes odoo/documentation#11807

X-original-commit: 9b7d3d559b
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2025-01-21 22:03:20 +00:00
Louis Wicket (wil)
381ae7793b [I18N] add es_419 to the documentation
This commit adds es_419 (LATAM Spanish) to the available languages. It
populates LATAM Spanish translation based on the existing Spanish
translation.

closes odoo/documentation#11221

X-original-commit: da7fe3d69d
Signed-off-by: Louis Wicket (wil) <wil@odoo.com>
2024-11-07 10:49:02 +00:00
Louis Wicket (wil)
973c9a1f5a [I18N] add vi and id to the language switcher
closes odoo/documentation#11323

X-original-commit: 204db28154
Signed-off-by: Tiffany Chang (tic) <tic@odoo.com>
2024-11-05 09:30:53 +00:00
Antoine Vandevenne (anv)
5627bea8aa [IMP] supported_versions: release 18.0
closes odoo/documentation#11126

X-original-commit: a0472c95e5
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2024-10-01 12:07:13 +00:00
Louis Wicket (wil)
7916a08773 [FIX] change the display name of Korean to KR in the switcher
According to feedback from our Korean translator,the abbreviation for
Korean is usually KR instead of KO.

This commit updates the name of the language as displayed in the
language switcher.

closes odoo/documentation#10834

X-original-commit: 6ba02094ba
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Signed-off-by: Louis Wicket (wil) <wil@odoo.com>
2024-08-23 09:57:56 +00:00
Antoine Vandevenne (anv)
a8820ba3bb [IMP] supported_versions: release saas-17.4
closes odoo/documentation#10797

X-original-commit: 0e3c58de53
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2024-08-19 19:15:46 +00:00
Louis Wicket (wil)
50ff7a625a [FIX] add missing language names to the language switcher
Even though the Thai documentation has been built and is available, it
didn't show up in the language switcher. This is because it needs to be
given a "language name" first.

This commis add the language names corresponding to the newly added
translations (namely, into Thai and Japanese).

closes odoo/documentation#10741

X-original-commit: 9cf55e3fc0
Signed-off-by: Tiffany Chang (tic) <tic@odoo.com>
Signed-off-by: Louis Wicket (wil) <wil@odoo.com>
2024-08-16 08:01:45 +00:00
Antoine Vandevenne (anv)
e661c7f66e [FIX] reference/view_architectures: remove outdated and broken link
The external link to `AbstractController` class was broken, both because
the placeholder substitution mechanism doesn't work in included RST
excerpts and because the class has long been removed.

Since it makes little sense to replace the link with another link to
the `useActionLinks` hook in the context of this reference doc, this
commit removes the link altogether, as well as the erroneous mention
of class limitations.

closes odoo/documentation#10733

X-original-commit: e7d2be6366
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2024-08-16 06:40:59 +00:00
Alvaro Fuentes
16fd9dc828 [IMP] upgrade-util: link code documentation
Add direct code documentation from upgrade-util repo.
Adapt `extensions/github_link`.

Original commit: 3352d33997

X-original-commit: 26fd5f3192
Part-of: odoo/documentation#8849
Co-authored-by: Victor Feyens <vfe@odoo.com>
2024-04-19 13:35:52 +00:00
Antoine Vandevenne (anv)
258fa17a76 [IMP] supported_versions: release saas-17.2
closes odoo/documentation#8500

X-original-commit: a906478bc7
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2024-04-03 05:24:06 +00:00
Martin Trigaux (mat)
2058488eaa [I18N] conf: add more language codes
closes odoo/documentation#8251

X-original-commit: 88fa5d6e0a
Signed-off-by: Martin Trigaux (mat) <mat@odoo.com>
2024-03-22 06:03:59 +00:00
Martin Trigaux (mat)
f2ceb28cb5 [FIX] conf: don't use None in language switcher
In a lang is not present in languages_names, the menu was displaying None

X-original-commit: 8b40d49

add Swedish

closes odoo/documentation#8161

X-original-commit: 8e647c342a
Signed-off-by: Martin Trigaux (mat) <mat@odoo.com>
2024-03-18 17:31:17 +00:00
Antoine Vandevenne (anv)
279ae26b85 [IMP] supported_versions: release saas-17.1
closes odoo/documentation#7708

X-original-commit: e116579c99
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2024-02-14 05:10:11 +00:00
Olivier Dony
d0b7363de5 [IMP] conf: special case alt lang links for legal terms
Legal terms live under specific URL as their translations are not
managed in the same manner.

Layout is like this:
  /terms/enterprise.html (EN)
  /terms/i18n/enterprise_fr.html (FR)

This commit adapts the generation of alternative languages links for each
"legal terms page", so that it targets the correct i18n link, or goes
back to the canonical EN one, depending on the target language.

closes odoo/documentation#7382

closes odoo/documentation#7384

closes odoo/documentation#7387

Signed-off-by: Olivier Dony (odo) <odo@odoo.com>
2024-01-15 22:56:16 +01:00
Antoine Vandevenne (anv)
89539f7379 [IMP] supported_versions: release 17.0
closes odoo/documentation#6314

X-original-commit: 2c805d9813
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-11-07 17:10:19 +00:00
Olivier Dony
babd571b8b [ADD] legal: update terms of sales for monthly subs, add ES,DE
closes odoo/documentation#5851

X-original-commit: 76570c1e9d
Signed-off-by: Olivier Dony (odo) <odo@odoo.com>
2023-09-13 04:37:10 +00:00
Antoine Vandevenne (anv)
fa4cfcd042 [IMP] supported_versions: release saas-16.4
This commit also moves all versions from 8.0 to 12.0 from the table to
the "older versions" section.

closes odoo/documentation#5327

X-original-commit: 6225ef9e32
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-08-07 19:58:22 +02:00
Xavier-Do
2954463d6e [FIX] werkzeug version
https://werkzeug.palletsprojects.com/en/1.0.x/objects.inv now returns a
404.
2023-06-09 01:07:49 +02:00
Antoine Vandevenne (anv)
369aa4a662 [IMP] supported_versions: release saas-16.3
"September" didn't fit in the current table, so this commit also
replaces the previous implementation of the table by a `list-table`
directive... The real reason is that it was long due to ease future
updates of the table.

closes odoo/documentation#4629

X-original-commit: 3d1293757a
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-06-06 10:30:08 +02:00
Olivier Dony
d7324b6950 [FIX] legal: rename pt_BR + build PDF version
X-original-commit: 0df79a70e0
Part-of: odoo/documentation#4552
2023-05-26 11:40:39 +02:00
Antoine Vandevenne (anv)
3ab7232f8e [IMP] supported_version: release saas-16.2
closes odoo/documentation#3929

X-original-commit: dc2a988173
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-03-29 09:33:49 +02:00
Olivier Dony
f4d032ecbc [FIX] legal: fix some broken links (pdfs, translations)
1) PDF files are generated and stored at the root of the CURRENT_BRANCH
directory. The links to those files are generated at different levels of
the doctree, which makes it impossible to use a relative path.
For example the same "Enterprise Agreement" doc in EN is published on:
 - /16.0/legal/terms/enterprise.html
 - /16.0/fr/legal/terms/enterprise.html

As a workaround, use absolute links for the PDFs. They won't work
locally for now. Can be improved later, as long as we don't break
those links located in various depths of the troctree.

2) The legal constracts aren't translated in all availables languages
(yet), so those links are 404s now. Introduced a conf.py variable
`legal_translations` with the list of languages where translated
contracts are indeed available, and falling back to the EN version
otherwise. Some languages don't have *all* the contracts translated, so
some 404 may remain temporarily.

Forward-port of f69dba70be
2023-03-23 16:43:12 +01:00
Antoine Vandevenne (anv)
009ae8ffde [ADD] extensions/cards: add an extension to implement cards
The extension adds two new directive:
- `cards` is the row container for one or more `card` directives.
- `card` is the implementation of a Bootstrap card that accepts a
  `target` argument for the href of the card, a `large` option to render
  the card on two columns, a `tag` option to display a single arbitrary
  tag on the card, and arbitrary content that is shown in the card
  body.

task-3141419

closes odoo/documentation#3689

X-original-commit: 34bc63d2bc
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-02-28 18:08:29 +01:00
Martin Trigaux
67dff9aa43 [IMP] conf: add names for newly activated languages
closes odoo/documentation#3502

X-original-commit: 734c0ee6ef
Signed-off-by: Martin Trigaux (mat) <mat@odoo.com>
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-02-08 12:25:57 +01:00
Antoine Vandevenne (anv)
cc13f28fd2 [CLN] remove files for saas-15.1 and saas-15.3
closes odoo/documentation#3324

X-original-commit: ce4aa42fb4
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2023-01-12 16:30:25 +01:00
Antoine Vandevenne (anv)
b3a1f27461 [IMP] conf.py, *: interpolate the version and releases in the content
This commit replaces hard-coded occurrences of the version and of the
last, current and next releases' version with placeholders interpolated
at build time to avoid manually updating these after each freeze.

task-2917614

closes odoo/documentation#3170

X-original-commit: fa2d0f6363
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-12-09 13:03:46 +01:00
Morgane (morm)
10bf041900 [IMP] documentation: legal page design
Prior to this commit, the terms and conditions were displayed in a table
with all the languages and it was not practical for the futur, with many
more languages.

task-3073198

closes odoo/documentation#3139

X-original-commit: a52a9eef2d
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-12-08 12:31:09 +01:00
fdardenne
2110671090 [ADD] developer: add a tutorial on Owl
This commit adds the introduction and the chapter 1 of the new
Owl/JavaScript framework tutorial.

This new tutorial allows people to discover Owl and the building blocks
of the Odoo JavaScript framework.

closes odoo/documentation#3069

X-original-commit: 62051b643f
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Co-authored-by: Géry Debongnie <ged@odoo.com>
Co-authored-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-12-02 10:11:21 +01:00
Victor Feyens
5e3d4d0414 [CLN] core: upgrade to python 3.6
& sort imports

closes odoo/documentation#2976

X-original-commit: 57784a2f90
Signed-off-by: Victor Feyens (vfe) <vfe@odoo.com>
2022-11-17 11:58:56 +01:00
Antoine Vandevenne (anv)
a154e01cee [IMP] extensions/spoilers: add an extension for spoilers
It is often needed in developer tutorials to show excerpts of code for
examples and solutions. This takes quite some page space and, for the
latter, it is not always desired to show the final code result right
after the exercise objective.

This commit adds a spoiler feature to the documentation to allow hiding
content until the reader wants to display it.

The feature relies on the new `.. spoiler:: Button label` directive.

task-3036845

closes odoo/documentation#2877

X-original-commit: 4d7a88639a
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
Co-authored-by: Morgan Meganck <morm@odoo.com>
Co-authored-by: Stefano Rigano <sri@odoo.com>
2022-10-28 14:21:05 +02:00
Antoine Vandevenne (anv)
cd549cb386 [IMP] supported_version: release 16.0 and deprecate 13.0
closes odoo/documentation#2814

X-original-commit: 3c61d24b1d
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-10-12 09:39:45 +02:00
Xavier-Do
53e7277b6a [FIX]: fix odoo_version detection
Right now if the version is not "final (and not alpha)"
documentation will say 16.0beta != 16.0

closes odoo/documentation#2748

X-original-commit: 406f3aac18
Signed-off-by: Xavier Dollé (xdo) <xdo@odoo.com>
2022-09-26 09:35:48 +02:00
Victor Feyens
a1d7e430c7 [FIX] accounting_localization: use relative paths in csv-table's option
The `file` option for the `csv-table` directive expects relative file
paths rather than absolute file paths since Sphinx 4. Since this was the
only usage of the `ODOO_ABSPATH` placeholder, it is removed with this
commit.

Task - 2898477

closes odoo/documentation#2455

Signed-off-by: Victor Feyens (vfe) <vfe@odoo.com>
2022-07-14 16:42:08 +02:00
Victor Feyens
fb149f3cb3 [IMP] conf.py, requirements.txt, *: allow building with Python 3.10
- Bump Sphinx version to 4.3.2 (default for Debian Jammy).
- Remove the retrocompatibility for Sphinx < 3.5 (warnings are raised in
  4.5).
- Fix translator issue crashing builds.
- Unpin jinja2 from the requirements as the base issue is solved in sphinx 4

Task - 2898477

Part-of: odoo/documentation#2455
2022-07-14 16:42:08 +02:00
Antoine Vandevenne (anv)
4249e50049 [CLN] conf.py: stop labelling saas-15.1 in version switcher
The branch was recently dropped from the supported versions. We no
longer need to add a label for it in the version switcher.

closes odoo/documentation#2437

X-original-commit: 2481e3d842
Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com>
2022-07-11 20:25:26 +02:00