documentation/content/applications/websites/website/publish/translate.rst
Antoine Vandevenne (anv) 250bc3ab21 [MOV] content/*: move resource files into their related page's directory
Since odoo/documentation#903, the guideline for the location of new
resource (images, downloadable files, RST includes...) files is to place
those inside the directory of the RST page that references them.

For example, if `doc1.rst` has a reference to `image.png` and to
`download.zip`, the file structure should look like this:

├── parent_doc/
│     └── doc1/
│     │     └── image.png
│     │     └── download.zip
│     └── doc1.rst
│     └── doc2.rst
├── parent_doc.rst

Before this commit, most of the resource files were still located inside
'media' directories holding all the resource files referenced by RST
pages located at the same level as these directories. In the example
above, a single 'media' directory would hold all the resource files
referenced by both `doc1.rst` and `doc2.rst`. Doing so prevented us from
figuring out easily which resource file was referenced by which RST page
and, thus, lead to unused resource files piling up in the repository. It
also made it more complicated to define codeowners regex rules because a
team could not simply be assigned to `/some_page.*` but needed to be
assigned to both `/some_page\.rst` and to the location of 'media'.

In order to help new content writers figure out the guideline when
taking examples from other RST pages, this commit retroactively applies
the guideline to existing resource files and 'media' directories. The
left-over resource files that are not referenced by any RST page are
removed.

task-2497965

Part-of: odoo/documentation#2066
2022-05-20 14:48:37 +02:00

41 lines
1.1 KiB
ReStructuredText

===============================
How to translate my website
===============================
Overview
========
In addition to creating great modern websites, Odoo gives you the
possibility to translate it in different languages.
Process
=======
Once your website is created, you have the opportunity to translate it
in as many different languages as you want.
You can only translate your website manually, follow the next step.
Now go to your website. On the bottom right corner of the page, click on
**Add a language**.
.. image:: translate/translate_website01.png
:align: center
Choose the language in which you want to translate your website and then
click on **Load.**
.. image:: translate/translate_website02.png
:align: center
You will see that Now, next to English there is also French, which means
that the page for the translation has been created. You can also see
that some of the text has been translated automatically.
.. image:: translate/translate_website03.png
:align: center
To translate the content of the website, click on **Translate** (here
**Traduire** since we want to translate the website in French).