[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
@@ -4,17 +4,17 @@ Connect an IoT Box to your database
Install the Internet of Things (IoT) App on your Odoo Database.
.. image:: media/connect01.png
.. image:: connect/connect01.png
:align: center
Go in the IoT App and click on Connect on the IoT Boxes page.
.. image:: media/connect02.png
.. image:: connect/connect02.png
:align: center
Follow the steps to connect your IoT Box.
.. image:: media/connect03.png
.. image:: connect/connect03.png
:align: center
Ethernet Connection
@@ -27,7 +27,7 @@ Ethernet Connection
3. Read the Pairing Code from a screen or a receipt printer connected to the IoT Box.
.. image:: media/connect04.png
.. image:: connect/connect04.png
4. Input the Pairing Code and click on the Pair button.
@@ -43,18 +43,18 @@ WiFi Connection
2. Copy the token
.. image:: media/connect05.png
.. image:: connect/connect05.png
3. Connect to the IoT Box WiFi Network (make sure there is no ethernet
cable plugged in your computer).
.. image:: media/connect06.png
.. image:: connect/connect06.png
4. You will be redirected to the IoT Box Homepage (if it doesn't work,
connect to the IP address of the box). Give a name to your IoT Box (not
required) and paste the token, then click on next.
.. image:: media/connect07.png
.. image:: connect/connect07.png
.. tip::
If you are on Runbot, do not forget to add the -all or -base in the
@@ -67,15 +67,15 @@ WiFi Connection
if there is one) and click on Submit. Wait a few seconds before being
redirected to your database.
.. image:: media/connect08.png
.. image:: connect/connect08.png
You should now see the IoT Box.
.. image:: media/connect09.png
.. image:: connect/connect09.png
:align: center
IoT Box Schema
~~~~~~~~~~~~~~
.. image:: media/connect10.png
.. image:: connect/connect10.png
:align: center

Before

Width:  |  Height:  |  Size: 3.8 KiB

After

Width:  |  Height:  |  Size: 3.8 KiB

Before

Width:  |  Height:  |  Size: 3.0 KiB

After

Width:  |  Height:  |  Size: 3.0 KiB

Before

Width:  |  Height:  |  Size: 52 KiB

After

Width:  |  Height:  |  Size: 52 KiB

Before

Width:  |  Height:  |  Size: 10 KiB

After

Width:  |  Height:  |  Size: 10 KiB

Before

Width:  |  Height:  |  Size: 23 KiB

After

Width:  |  Height:  |  Size: 23 KiB

Before

Width:  |  Height:  |  Size: 91 KiB

After

Width:  |  Height:  |  Size: 91 KiB

Before

Width:  |  Height:  |  Size: 9.6 KiB

After

Width:  |  Height:  |  Size: 9.6 KiB

Before

Width:  |  Height:  |  Size: 8.0 KiB

After

Width:  |  Height:  |  Size: 8.0 KiB

Before

Width:  |  Height:  |  Size: 2.5 KiB

After

Width:  |  Height:  |  Size: 2.5 KiB

Before

Width:  |  Height:  |  Size: 31 KiB

After

Width:  |  Height:  |  Size: 31 KiB

@@ -18,7 +18,7 @@ will be saved.
This process can take more than 30 minutes. Do not turn off or unplug
the IoT Box as it would leave it in an inconsistent state.
.. image:: media/flash_sdcard01.png
.. image:: flash_sdcard/flash_sdcard01.png
:align: center
Upgrade with Etcher
@@ -33,5 +33,5 @@ Then, open *Etcher* and select *Flash from file*, find the image you just
downloaded. Insert the IoT Box SD card into your computer and select it.
Click on *Flash* and wait for the process to finish.
.. image:: media/flash_sdcard02.png
.. image:: flash_sdcard/flash_sdcard02.png
:align: center

Before

Width:  |  Height:  |  Size: 79 KiB

After

Width:  |  Height:  |  Size: 79 KiB

Before

Width:  |  Height:  |  Size: 17 KiB

After

Width:  |  Height:  |  Size: 17 KiB

@@ -2,7 +2,7 @@
Use the IoT Box for the PoS
===========================
.. image:: media/pos01.png
.. image:: pos/pos01.png
:align: center
Prerequisites
@@ -62,7 +62,7 @@ Once it's done, you can connect the IoT Box to your PoS. For this, go in
and select the devices you want to use in this Point of Sale. Save the
changes.
.. image:: media/pos02.png
.. image:: pos/pos02.png
:align: center
Set up is done, you can launch a new PoS Session.

Before

Width:  |  Height:  |  Size: 30 KiB

After

Width:  |  Height:  |  Size: 30 KiB

Before

Width:  |  Height:  |  Size: 28 KiB

After

Width:  |  Height:  |  Size: 28 KiB

@@ -54,7 +54,7 @@ My printer is not detected
If one of your printers doesn't show up in your devices list, go to the
IoT Box homepage and make sure that it is listed under *Printers*.
.. image:: media/troubleshooting_printer_01.png
.. image:: troubleshooting/troubleshooting_printer_01.png
:align: center
If your printer is not present on the IoT Box homepage, hit
@@ -76,7 +76,7 @@ tab and select the printer in the list. In the Administration dropdown,
click on *Modify Printer*. Follow the steps and select the Make and Model
corresponding to your printer.
.. image:: media/troubleshooting_printer_02.png
.. image:: troubleshooting/troubleshooting_printer_02.png
:align: center
.. note::
@@ -121,7 +121,7 @@ recognized by the IoT Box.
You can manually change the device type by going to its form view and
activating the *Is scanner* option.
.. image:: media/troubleshooting_barcode_01.png
.. image:: troubleshooting/troubleshooting_barcode_01.png
:align: center
Cashdrawer
@@ -18,7 +18,7 @@ If your camera is a `*supported
one* <https://www.odoo.com/page/iot-hardware>`__, there is no need to
set up anything as it will be detected as soon as it is connected.
.. image:: media/camera_01.png
.. image:: camera/camera_01.png
:align: center
Link a Camera to a Quality Control Point
@@ -34,12 +34,12 @@ and open the control point you want to link with the camera.
Now, you can edit the control point and select the device from the
dropdown list. Now, hit save.
.. image:: media/camera_03.png
.. image:: camera/camera_03.png
:align: center
Then, your camera can be used with the picked *Control Point*. During
the manufacturing process, reaching the *Quality Control Point* you
chose before will allow you to take a picture.
.. image:: media/camera_04.png
.. image:: camera/camera_04.png
:align: center

Before

Width:  |  Height:  |  Size: 5.9 KiB

After

Width:  |  Height:  |  Size: 5.9 KiB

Before

Width:  |  Height:  |  Size: 7.1 KiB

After

Width:  |  Height:  |  Size: 7.1 KiB

Before

Width:  |  Height:  |  Size: 9.6 KiB

After

Width:  |  Height:  |  Size: 9.6 KiB

@@ -19,7 +19,7 @@ If your footswitch is a `supported
one <https://www.odoo.com/page/iot-hardware>`__, there is no need to
set up anything since it will be automatically detected when connected.
.. image:: media/footswitch_01.png
.. image:: footswitch/footswitch_01.png
:align: center
Link a Footswitch to a Workcenter
@@ -30,7 +30,7 @@ workcenter. Go to the workcenter you want to use the footswitch in and
add the device in the *IoT Triggers* tab. Then, you can link it to an
action and also add a key to trigger it.
.. image:: media/footswitch_03.png
.. image:: footswitch/footswitch_03.png
:align: center
Note that the one that is first in the list will be chosen. So, the

Before

Width:  |  Height:  |  Size: 6.3 KiB

After

Width:  |  Height:  |  Size: 6.3 KiB

Before

Width:  |  Height:  |  Size: 7.3 KiB

After

Width:  |  Height:  |  Size: 7.3 KiB

@@ -12,7 +12,7 @@ Connect in USB
To add a device connected by USB, just plug the USB cable in the *IoT
Box*, and the device should appear in your Odoo database.
.. image:: media/measurement_tool_01.png
.. image:: measurement_tool/measurement_tool_01.png
:align: center
Connect in Bluetooth
@@ -24,7 +24,7 @@ to the device.
Here is an example of what it should look like:
.. image:: media/measurement_tool_03.png
.. image:: measurement_tool/measurement_tool_03.png
:align: center
Link a measurement tool to a quality control point
@@ -41,12 +41,12 @@ assign a measurement tool.
Now, you can edit the control point and choose the device from the
dropdown list. Then, hit save.
.. image:: media/measurement_tool_04.png
.. image:: measurement_tool/measurement_tool_04.png
:align: center
Now, your measurement tool is linked to the chosen *Control Point*.
The value, which needs to be changed manually, will be automatically
updated while the tool is being used.
.. image:: media/measurement_tool_05.png
.. image:: measurement_tool/measurement_tool_05.png
:align: center
Binary file not shown.

Before

Width:  |  Height:  |  Size: 22 KiB

@@ -17,7 +17,7 @@ detected automatically and will appear in the *Devices* list of your IoT app.
.. note::
The printer can take up to two minutes to appear in your devices list.
.. image:: media/printer_01.png
.. image:: printer/printer_01.png
:align: center
Link the Printer
@@ -34,13 +34,13 @@ To do so, you need to create a *Quality Control Point* from the
operation and the work order operation. In type, choose *Print Label*
and hit save.
.. image:: media/printer_03.png
.. image:: printer/printer_03.png
:align: center
Now, each time you reach the quality control point for the chosen
product, a *Print Label* button will appear.
.. image:: media/printer_04.png
.. image:: printer/printer_04.png
:align: center
To Reports
@@ -50,19 +50,19 @@ You can also link a type of report to a certain printer. In the *IoT*
app, go to the *Devices* menu and select the printer you want to set
up.
.. image:: media/printer_05.png
.. image:: printer/printer_05.png
:align: center
Now, go to the *Printer Reports* tab.
.. image:: media/printer_06.png
.. image:: printer/printer_06.png
:align: center
Hit edit and then, click on *Add a line*. In the window that shows up,
check all the types of reports that should be linked to this printer.
Click on select and save.
.. image:: media/printer_07.png
.. image:: printer/printer_07.png
:align: center
Now, each time you click on *Print* in the control panel, instead of
@@ -80,7 +80,7 @@ Doing so is really easy. Go to your *Point of Sale* app and open your
and check the *IoT Box* feature. Then, choose your *Receipt Printer*
from the dropdown.
.. image:: media/printer_08.png
.. image:: printer/printer_08.png
:align: center
Now, you will be able to print different kinds of tickets from your *POS*:
@@ -93,14 +93,14 @@ Sales details can be printed by clicking on the printer icon on the
navbar at the top of the *PoS*. It will print the details of the sales
of the current day.
.. image:: media/printer_09.png
.. image:: printer/printer_09.png
:align: center
As for the bill, it is only available in restaurant mode. In your
restaurant settings, activate *Print Bills* and a *Bill* button will
appear in the left panel of the *PoS*.
.. image:: media/printer_10.png
.. image:: printer/printer_10.png
:align: center
Print Orders in the kitchen
@@ -111,14 +111,14 @@ In restaurant mode, you can send order tickets to the kitchen.
To do so, go to the *PoS* app and open your *PoS* settings. Then,
tick *Order Printer*.
.. image:: media/printer_11.png
.. image:: printer/printer_11.png
:align: center
Now, go to the *Printers* menu. Hit create, select the printer from
the dropdown and, in the *Printer Product Categories* field, choose
all the categories of products that should be printed on this printer.
.. image:: media/printer_12.png
.. image:: printer/printer_12.png
:align: center
In the *PoS*, when you add or remove a product from one of the

Before

Width:  |  Height:  |  Size: 5.4 KiB

After

Width:  |  Height:  |  Size: 5.4 KiB

Before

Width:  |  Height:  |  Size: 14 KiB

After

Width:  |  Height:  |  Size: 14 KiB

Before

Width:  |  Height:  |  Size: 10 KiB

After

Width:  |  Height:  |  Size: 10 KiB

Before

Width:  |  Height:  |  Size: 30 KiB

After

Width:  |  Height:  |  Size: 30 KiB

Before

Width:  |  Height:  |  Size: 12 KiB

After

Width:  |  Height:  |  Size: 12 KiB

Before

Width:  |  Height:  |  Size: 4.7 KiB

After

Width:  |  Height:  |  Size: 4.7 KiB

Before

Width:  |  Height:  |  Size: 16 KiB

After

Width:  |  Height:  |  Size: 16 KiB

Before

Width:  |  Height:  |  Size: 597 B

After

Width:  |  Height:  |  Size: 597 B

Before

Width:  |  Height:  |  Size: 1.2 KiB

After

Width:  |  Height:  |  Size: 1.2 KiB

Before

Width:  |  Height:  |  Size: 6.0 KiB

After

Width:  |  Height:  |  Size: 6.0 KiB

Before

Width:  |  Height:  |  Size: 21 KiB

After

Width:  |  Height:  |  Size: 21 KiB