[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
This commit is contained in:
Antoine Vandevenne (anv)
2022-05-20 09:59:25 +00:00
parent 9fbbbc9fcf
commit 250bc3ab21
2050 changed files with 1771 additions and 1770 deletions
@@ -21,19 +21,19 @@ Enable multi-currencies
In the accounting module, Go to :menuselection:`Configuration --> Settings`
and flag **Allow multi currencies**, then click on **apply**.
.. image:: media/exchange_rate03.png
.. image:: exchange/exchange_rate03.png
:align: center
Configure the currency rates in :menuselection:`Configuration --> Currencies`.
Write down the rate and make sure the currency is active.
.. image:: media/exchange_rate02.png
.. image:: exchange/exchange_rate02.png
:align: center
In this document, the base currency is **Euro** and we will record payments
in **Dollars**.
.. image:: media/exchange_rate08.png
.. image:: exchange/exchange_rate08.png
:align: center
.. tip::
@@ -48,14 +48,14 @@ In order to register payments in other currencies, you have to **remove
the currency constraint** on the journal. Go to the accounting
application, Click on **More** on the journal and **Settings**.
.. image:: media/exchange_rate06.png
.. image:: exchange/exchange_rate06.png
:align: center
Check if the **Currency** field is empty or in the foreign currency in which
you will register the payments. If a currency is filled in, it means
that you can register payments only in this currency.
.. image:: media/exchange_rate10.png
.. image:: exchange/exchange_rate10.png
:align: center
Record a payment in a different currency
@@ -65,7 +65,7 @@ In the **Accounting** application, go to :menuselection:`Sales --> Payments`.
Register the payment and indicate that it was done in the foreign currency. Then
click on **confirm**.
.. image:: media/exchange_rate05.png
.. image:: exchange/exchange_rate05.png
:align: center
The journal entry has been posted but not allocated.
@@ -73,7 +73,7 @@ The journal entry has been posted but not allocated.
Go back to your invoice (:menuselection:`Sales --> Customer Invoices`) and click on
**Add** to allocate the payment.
.. image:: media/exchange_rate04.png
.. image:: exchange/exchange_rate04.png
:align: center
Record a bank statement in a different currency
@@ -83,14 +83,14 @@ Create or import the bank statement of your payment. The **Amount** is in
the company currency. There are two complementary fields, the **Amount currency**,
which is the amount that was actually paid and the **Currency** in which it was paid.
.. image:: media/exchange_rate07.png
.. image:: exchange/exchange_rate07.png
:align: center
When reconciling it, Odoo will directly match the payment with the right
**Invoice**. You will get the invoice price in the invoice currency and the
amount in your company currency.
.. image:: media/exchange_rate09.png
.. image:: exchange/exchange_rate09.png
:align: center
Check the exchange rate differences
@@ -99,13 +99,13 @@ Check the exchange rate differences
Go to :menuselection:`Adviser --> Journal Entries` and look for the **Exchange difference**
journal entries. All the exchange rates differences are recorded in it.
.. image:: media/exchange_rate01.png
.. image:: exchange/exchange_rate01.png
:align: center
.. tip::
The Exchange difference journal can be changed in your accounting settings.
.. include:: full_reconcile_warning.rst
.. include:: exchange/full_reconcile_warning.rst
.. seealso::
* :doc:`../../bank/reconciliation/reconciliation_models`
@@ -20,7 +20,7 @@ Turn on multi-currency
In the accounting module, Go to :menuselection:`Configuration --> Settings` and flag
**Allow multi currencies**, then click on **Apply**.
.. image:: media/works01.png
.. image:: how_it_works/works01.png
:align: center
Exchange Rate Journal
@@ -34,7 +34,7 @@ by Odoo.
You can change it in the settings:
.. image:: media/works02.png
.. image:: how_it_works/works02.png
:align: center
View or edit rate being used
@@ -44,18 +44,18 @@ You can manually configure the currency rates in :menuselection:`Configuration -
Currencies`. Open the currencies you want to use in Odoo and edit it.
Make sure the currency is active.
.. image:: media/works03.png
.. image:: how_it_works/works03.png
:align: center
Click on **View Rates** to edit it and to see the history :
.. image:: media/works04.png
.. image:: how_it_works/works04.png
:align: center
Click on **Create** to add the rate. Fill in the date and the rate.
Click on **Save** when you are done.
.. image:: media/works05.png
.. image:: how_it_works/works05.png
:align: center
Live Currency Rate
@@ -70,7 +70,7 @@ Choose the interval : Manually, Daily, Weekly or Monthly. You can always
force the update by clicking on **Update Now**. Select the provider, and you
are set !
.. image:: media/works06.png
.. image:: how_it_works/works06.png
:align: center
.. note::
@@ -86,7 +86,7 @@ this account to have the account currency.
If you leave it empty, it means that it can handle all currencies that
are Active.
.. image:: media/works07.png
.. image:: how_it_works/works07.png
:align: center
Configure your journals
@@ -96,14 +96,14 @@ In order to register payments in other currencies, you have to remove
the currency constraint on the journal. Go to the accounting
application, Click on **More** on the journal and **Settings**.
.. image:: media/works08.png
.. image:: how_it_works/works08.png
:align: center
Check if the currency field is empty or in the foreign currency in which
you will register the payments. If a currency is filled in, it means
that you can register payments only in this currency.
.. image:: media/works09.png
.. image:: how_it_works/works09.png
:align: center
How is Odoo's multi-currency working?
@@ -119,7 +119,7 @@ You are now able to set a different currency than the company one on
your sale orders and on your invoices. The currency is set for the whole
document.
.. image:: media/works10.png
.. image:: how_it_works/works10.png
:align: center
Purchases orders and Vendor Bills
@@ -129,7 +129,7 @@ You are now able to set a different currency than the company one on
your purchase orders and on your vendor bills. The currency is set for
the whole document.
.. image:: media/works11.png
.. image:: how_it_works/works11.png
:align: center
Payment Registrations
@@ -138,7 +138,7 @@ Payment Registrations
In the accounting application, go to :menuselection:`Sales --> Payments`. Register the payment and
set the currency.
.. image:: media/works12.png
.. image:: how_it_works/works12.png
:align: center
Bank Statements
@@ -148,7 +148,7 @@ When creating or importing bank statements, the amount is in the company
currency. But there are now two complementary fields, the amount that
was actually paid and the currency in which it was paid.
.. image:: media/works13.png
.. image:: how_it_works/works13.png
:align: center
When reconciling it, Odoo will directly match the payment with the right
@@ -161,10 +161,10 @@ Exchange Rate Journal
Go to :menuselection:`Adviser --> Journal Entries` and look for the Exchange difference
journal entries. All the exchange rates differences are recorded in it.
.. image:: media/works14.png
.. image:: how_it_works/works14.png
:align: center
.. include:: full_reconcile_warning.rst
.. include:: exchange/full_reconcile_warning.rst
.. seealso::
* :doc:`invoices_payments`
@@ -34,14 +34,14 @@ In order to register payments in other currencies, you have to remove
the currency constraint on the journal. Go to the accounting
application, on the journal, click on :menuselection:`More --> Settings`.
.. image:: media/invoice01.png
.. image:: invoices_payments/invoice01.png
:align: center
Check if the currency field is empty or in the foreign currency in which
you will register the payments. If a currency is filled in, it means
that you can register payments only in this currency.
.. image:: media/invoice02.png
.. image:: invoices_payments/invoice02.png
:align: center
Multi-currency invoices & Vendor Bills
@@ -57,7 +57,7 @@ You are now able to set a different currency than the company one on
your sale orders and on your invoices. The currency is set for the whole
document.
.. image:: media/invoice03.png
.. image:: invoices_payments/invoice03.png
:align: center
Vendor Bills
@@ -67,7 +67,7 @@ You are now able to set a different currency than the company one on
your purchase orders and on your vendor bills. The currency is set for
the whole document.
.. image:: media/invoice04.png
.. image:: invoices_payments/invoice04.png
:align: center
Multi-currency Payments
@@ -77,7 +77,7 @@ In the accounting application, go to :menuselection:`Sales --> Payments`. Regist
payment and indicate that it was done in the foreign currency. Then
click on **Confirm**.
.. image:: media/invoice05.png
.. image:: invoices_payments/invoice05.png
:align: center
The journal entry has been posted but not allocated.
@@ -85,7 +85,7 @@ The journal entry has been posted but not allocated.
Go back to your invoice (:menuselection:`Sales --> Customer Invoices`) and click on
**Add** to allocate the payment.
.. image:: media/invoice06.png
.. image:: invoices_payments/invoice06.png
:align: center
Multi- Currency Bank Statements
@@ -95,14 +95,14 @@ When creating or importing bank statements, the amount is in the company
currency. But there are now two complementary fields, the amount that
was actually paid and the currency in which it was paid.
.. image:: media/invoice07.png
.. image:: invoices_payments/invoice07.png
:align: center
When reconciling it, Odoo will directly match the payment with the right
invoice. You will get the invoice price in the invoice currency and the
amount in your company currency.
.. image:: media/invoice08.png
.. image:: invoices_payments/invoice08.png
:align: center
Exchange Rate Journal
@@ -111,10 +111,10 @@ Exchange Rate Journal
Go to :menuselection:`Adviser --> Journal Entries` and look for the **Exchange
Difference** journal entries. All the exchange rates differences are recorded in it.
.. image:: media/invoice09.png
.. image:: invoices_payments/invoice09.png
:align: center
.. include:: full_reconcile_warning.rst
.. include:: exchange/full_reconcile_warning.rst
.. seealso::
* :doc:`how_it_works`