[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
+10 -10
View File
@@ -46,31 +46,31 @@ Once you have your authenticator of choice, go to the Odoo instance
you want to setup :abbr:`2FA (two-factor authentication)`, then open
:guilabel:`Preferences` (or :guilabel:`My Profile`):
.. figure:: media/totp_setup/preferences.png
.. figure:: 2fa/preferences.png
:align: center
Open the :guilabel:`Account Security` tab, then click the
:guilabel:`Enable two-factor authentication` button:
.. figure:: media/totp_setup/sec_tab.png
.. figure:: 2fa/sec_tab.png
:align: center
Because this is a security-sensitive action, you will need to input
your password:
.. figure:: media/totp_setup/sec_enhanced.png
.. figure:: 2fa/sec_enhanced.png
:align: center
After which you will see this screen with a barcode:
.. figure:: media/totp_setup/totp_scan.png
.. figure:: 2fa/totp_scan.png
:align: center
In most applications, you can simply *scan the barcode* via the
authenticator of your choice, the authenticator will then take care of
all the setup:
.. figure:: media/totp_setup/scan_barcode.jpg
.. figure:: 2fa/scan_barcode.jpg
:align: center
.. note::
@@ -80,17 +80,17 @@ all the setup:
click the provided link, or copy the secret to manually set-up your
authenticator:
.. figure:: media/totp_setup/secret_visible.png
.. figure:: 2fa/secret_visible.png
:align: center
.. figure:: media/totp_setup/input_secret.png
.. figure:: 2fa/input_secret.png
:align: center
Once this is done, the authenticator should display a *verification
code* with some useful identifying information (e.g. the domain and
login for which the code is):
.. figure:: media/totp_setup/authenticator.png
.. figure:: 2fa/authenticator.png
:align: center
You can now input the code into the :guilabel:`Verification Code`
@@ -100,7 +100,7 @@ button.
Congratulation, your account is now protected by two-factor
authentication!
.. figure:: media/totp_setup/totp_enabled.png
.. figure:: 2fa/totp_enabled.png
:align: center
Logging in
@@ -112,7 +112,7 @@ On the login page, input the username and password of the account for
which you set up :abbr:`2FA (two-factor authentication)`, rather than
immediately enter Odoo you will now get a second log-in screen:
.. figure:: media/totp_setup/2fa_input.png
.. figure:: 2fa/2fa_input.png
:align: center
Get your authenticator, input the code it provides for the domain and

Before

Width:  |  Height:  |  Size: 6.7 KiB

After

Width:  |  Height:  |  Size: 6.7 KiB

Before

Width:  |  Height:  |  Size: 30 KiB

After

Width:  |  Height:  |  Size: 30 KiB

Before

Width:  |  Height:  |  Size: 14 KiB

After

Width:  |  Height:  |  Size: 14 KiB

Before

Width:  |  Height:  |  Size: 13 KiB

After

Width:  |  Height:  |  Size: 13 KiB

Before

Width:  |  Height:  |  Size: 98 KiB

After

Width:  |  Height:  |  Size: 98 KiB

Before

Width:  |  Height:  |  Size: 6.3 KiB

After

Width:  |  Height:  |  Size: 6.3 KiB

Before

Width:  |  Height:  |  Size: 18 KiB

After

Width:  |  Height:  |  Size: 18 KiB

Before

Width:  |  Height:  |  Size: 12 KiB

After

Width:  |  Height:  |  Size: 12 KiB

Before

Width:  |  Height:  |  Size: 11 KiB

After

Width:  |  Height:  |  Size: 11 KiB

Before

Width:  |  Height:  |  Size: 22 KiB

After

Width:  |  Height:  |  Size: 22 KiB

+7 -7
View File
@@ -6,39 +6,39 @@ Sign in with LDAP
- Click on **Create** in Setup your LDAP Server.
.. image:: media/ldap01.png
.. image:: ldap/ldap01.png
:align: center
.. image:: media/ldap02.png
.. image:: ldap/ldap02.png
:align: center
- Choose the company about to use the LDAP.
.. image:: media/ldap03.png
.. image:: ldap/ldap03.png
:align: center
- In **Server Information**, enter the IP address of your server and the port it listens to.
- Tick **User TLS** if your server is compatible.
.. image:: media/ldap04.png
.. image:: ldap/ldap04.png
:align: center
- In **Login Information**, enter ID and password of the account used to query the server. If left empty, the server will be queried anonymously.
.. image:: media/ldap05.png
.. image:: ldap/ldap05.png
:align: center
- In **Process Parameter**, enter the domain name of your LDAP server in LDAP nomenclature (e.g. ``dc=example,dc=com``).
- In **LDAP filter**, enter ``uid=%s``
.. image:: media/ldap06.png
.. image:: ldap/ldap06.png
:align: center
- In **User Information**, tick *Create User* if you want Odoo to create a User profile the first time someone log in with LDAP.
- In **Template User**, indicate a template for the new profiles created. If left blanked, the admin profile will be used as template.
.. image:: media/ldap07.png
.. image:: ldap/ldap07.png
:align: center

Before

Width:  |  Height:  |  Size: 167 KiB

After

Width:  |  Height:  |  Size: 167 KiB

Before

Width:  |  Height:  |  Size: 38 KiB

After

Width:  |  Height:  |  Size: 38 KiB

Before

Width:  |  Height:  |  Size: 61 KiB

After

Width:  |  Height:  |  Size: 61 KiB

Before

Width:  |  Height:  |  Size: 61 KiB

After

Width:  |  Height:  |  Size: 61 KiB

Before

Width:  |  Height:  |  Size: 61 KiB

After

Width:  |  Height:  |  Size: 61 KiB

Before

Width:  |  Height:  |  Size: 61 KiB

After

Width:  |  Height:  |  Size: 61 KiB

Before

Width:  |  Height:  |  Size: 61 KiB

After

Width:  |  Height:  |  Size: 61 KiB

@@ -13,20 +13,20 @@ Setup in Google
- Go to the API & Services page.
.. image:: media/google_calendar_credentials00.png
.. image:: google_calendar_credentials/google_calendar_credentials00.png
:align: center
- Search for *Google Calendar API* and select it.
.. image:: media/google_calendar_credentials01.png
.. image:: google_calendar_credentials/google_calendar_credentials01.png
:align: center
.. image:: media/google_calendar_credentials02.png
.. image:: google_calendar_credentials/google_calendar_credentials02.png
:align: center
- Enable the API.
.. image:: media/google_calendar_credentials03.png
.. image:: google_calendar_credentials/google_calendar_credentials03.png
:align: center
- Select or create an API project to store the credentials if not yet done
@@ -34,13 +34,13 @@ Setup in Google
- Create credentials.
.. image:: media/google_calendar_credentials04.png
.. image:: google_calendar_credentials/google_calendar_credentials04.png
:align: center
- Select *Web browser (Javascript)*
as calling source and *User data* as kind of data.
.. image:: media/google_calendar_credentials05.png
.. image:: google_calendar_credentials/google_calendar_credentials05.png
:align: center
- Then you can create a Client ID.
@@ -49,7 +49,7 @@ Setup in Google
Odoo's instance URL. The *Authorized redirect URI* is your Odoo's instance
URL followed by '/google_account/authentication'.
.. image:: media/google_calendar_credentials06.png
.. image:: google_calendar_credentials/google_calendar_credentials06.png
:align: center
- Go through the Consent Screen step by entering a product name
@@ -60,7 +60,7 @@ Setup in Google
- Finally you are provided with your **Client ID**. Go to *Credentials* to
get the **Client Secret** as well. Both of them are required in Odoo.
.. image:: media/google_calendar_credentials07.png
.. image:: google_calendar_credentials/google_calendar_credentials07.png
:align: center
Setup in Odoo
@@ -69,13 +69,13 @@ Setup in Odoo
- Install the **Google Calendar** App from the *Apps* menu or by checking
the option in :menuselection:`Settings --> General Settings`.
.. image:: media/google_calendar_credentials08.png
.. image:: google_calendar_credentials/google_calendar_credentials08.png
:align: center
- Go to :menuselection:`Settings --> General Settings` and enter your
**Client ID** and **Client Secret** in Google Calendar option.
.. image:: media/google_calendar_credentials09.png
.. image:: google_calendar_credentials/google_calendar_credentials09.png
:align: center
- The setup is now ready. Open your Odoo Calendar and sync with Google.
@@ -83,7 +83,7 @@ Setup in Odoo
the connection. Once back in Odoo, click the sync button again.
You can click it whenever you want to synchronize your calendar.
.. image:: media/google_calendar_credentials10.png
.. image:: google_calendar_credentials/google_calendar_credentials10.png
:align: center
As of now you no longer have excuses to miss a meeting!
@@ -19,7 +19,7 @@ Register your application with the Microsoft identity platform
.. note::
When configuring your platform settings, choose *Web*.
.. image:: media/platform_configurations.png
.. image:: outlook_calendar/platform_configurations.png
:align: center
:alt: Adding a platform in Microsoft Azure for Outlook calendar sync in Odoo
@@ -27,7 +27,7 @@ Register your application with the Microsoft identity platform
| For the **Redirect URI restrictions**, copy your Odoo database URI followed by
``/microsoft_account/authentication``. Example:
.. image:: media/redirect_URIs.png
.. image:: outlook_calendar/redirect_URIs.png
:align: center
:alt: Odoo's database URI that is accepted when microsoft returns authentication
@@ -43,21 +43,21 @@ Configuration in Odoo
Go to general *Settings* and activate the *Outlook Calendar* feature.
.. image:: media/outlook_calendar.png
.. image:: outlook_calendar/outlook_calendar.png
:align: center
:alt: Outlook Calendar feature activated in Odoo
From your Azure portal, under *Overview*, copy your *Application (client) ID*, and paste it to
*Client ID* in Odoo.
.. image:: media/application_client_ID.png
.. image:: outlook_calendar/application_client_ID.png
:align: center
:alt: Client ID token to be copied from Microsoft to Odoo
Going back to your Azure portal, now under *Certificates & secrets*, copy your *Client Secret Value*
and paste it to *Client Secret* in Odoo.
.. image:: media/client_secrets.png
.. image:: outlook_calendar/client_secrets.png
:align: center
:alt: Client Secret token to be copied from Microsoft to Odoo
@@ -75,21 +75,21 @@ Sync with Outlook
created in Outlook, and therefore, no redundant emails will be sent during the first
synchronization. After the sync, events will only send one confirmation email.
.. image:: media/archive_odoocalendar.png
.. image:: outlook_calendar/archive_odoocalendar.png
:align: center
:alt: Archive events in Odoo Calendar
Go to the *Calendar* application and *Sync with Outlook*. You are asked to log in to
your account, if you are not already, and grant the required permissions.
.. image:: media/sync_with_outlook.png
.. image:: outlook_calendar/sync_with_outlook.png
:align: center
:alt: Calendar view and the button Sync with Outlook in Odoo Calendar
The synchronization is a two-way process, meaning that events are reconciled in both accounts
(Outlook and Odoo).
.. image:: media/synched_with_outlook.png
.. image:: outlook_calendar/synched_with_outlook.png
:align: center
:alt: View of Odoo's Calendar synched with Outlook's Calendar
@@ -204,7 +204,7 @@ Configure Odoo VOIP
In Odoo, the configuration should be done in the user's preferences.
.. image:: media/voip_config01.png
.. image:: asterisk/voip_config01.png
:align: center
- The SIP Login/Browser's Extension is the number you configured previously in the sip.conf file (in our example: 1060).
@@ -216,7 +216,7 @@ In Odoo, the configuration should be done in the user's preferences.
The configuration should also be done in the General Settings under the "Integrations" section.
.. image:: media/onsip02.png
.. image:: onsip/onsip02.png
:align: center
- The PBX Server IP should be the same as the IP you define in the http.conf file.

Before

Width:  |  Height:  |  Size: 64 KiB

After

Width:  |  Height:  |  Size: 64 KiB

+6 -6
View File
@@ -14,7 +14,7 @@ Configuration
Go to Apps and install the module **VoIP OnSIP**.
.. image:: media/onsip01.png
.. image:: onsip/onsip01.png
:align: center
Go to Settings/General Settings. In the section Integrations/Asterisk (VoIP), fill in the 3 fields:
@@ -23,7 +23,7 @@ Go to Settings/General Settings. In the section Integrations/Asterisk (VoIP), fi
- **WebSocket** should contain wss://edge.sip.onsip.com
- **Mode** should be Production
.. image:: media/onsip02.png
.. image:: onsip/onsip02.png
:align: center
Go to **Settings/Users**. In the form view of each VoIP user, in the Preferences tab, fill in the section **PBX Configuration**:
@@ -35,7 +35,7 @@ Go to **Settings/Users**. In the form view of each VoIP user, in the Preferences
You can find all this information by logging in at https://admin.onsip.com/users, then select the user you want to configure and refer to the fields as pictured below.
.. image:: media/onsip03.png
.. image:: onsip/onsip03.png
:align: center
You can now make phone calls by clicking the phone icon in the top right corner of Odoo (make sure you are logged in as a user properly configured in Odoo and in OnSIP).
@@ -44,19 +44,19 @@ You can now make phone calls by clicking the phone icon in the top right corner
If you see a *Missing Parameters* message in the Odoo softphone, make sure to refresh your Odoo window and try again.
.. image:: media/onsip04.png
.. image:: onsip/onsip04.png
:align: center
.. note::
If you see an *Incorrect Number* message in the Odoo softphone, make sure to use the international format, leading with the plus (+) sign followed by the international country code. E.g.: +16506913277 (where +1 is the international prefix for the United States).
.. image:: media/onsip05.png
.. image:: onsip/onsip05.png
:align: center
You can now also receive phone calls. Your number is the one provided by OnSIP. Odoo will ring and display a notification.
.. image:: media/onsip06.png
.. image:: onsip/onsip06.png
:align: center
OnSIP on Your Cell Phone

Before

Width:  |  Height:  |  Size: 26 KiB

After

Width:  |  Height:  |  Size: 26 KiB

Before

Width:  |  Height:  |  Size: 48 KiB

After

Width:  |  Height:  |  Size: 48 KiB

Before

Width:  |  Height:  |  Size: 113 KiB

After

Width:  |  Height:  |  Size: 113 KiB

Before

Width:  |  Height:  |  Size: 13 KiB

After

Width:  |  Height:  |  Size: 13 KiB

Before

Width:  |  Height:  |  Size: 16 KiB

After

Width:  |  Height:  |  Size: 16 KiB

Before

Width:  |  Height:  |  Size: 57 KiB

After

Width:  |  Height:  |  Size: 57 KiB