diff --git a/Makefile b/Makefile index c8c9ebe34..d73a2ec4c 100644 --- a/Makefile +++ b/Makefile @@ -55,13 +55,10 @@ latexpdf: cp $(BUILD_DIR)/latex/*.pdf $(BUILD_DIR)/html/ @echo "Build finished." -l10n: +gettext: @echo "Generating translatable files..." - $(SPHINX_BUILD) -c $(CONFIG_DIR) -b gettext $(SOURCE_DIR) $(BUILD_DIR)/gettext + $(SPHINX_BUILD) -c $(CONFIG_DIR) -b gettext $(SOURCE_DIR) locale/sources @echo "Generation finished." - @echo "Localizing translation strings..." - sphinx-intl update -p $(BUILD_DIR)/gettext -l $(L10N_LANGUAGES) - @echo "Localization finished." extensions/odoo_theme/static/style.css: extensions/odoo_theme/static/style.scss extensions/odoo_theme/static/scss/*.scss @echo "Compiling stylesheets..." diff --git a/conf.py b/conf.py index e81770374..0ec57b517 100644 --- a/conf.py +++ b/conf.py @@ -5,6 +5,7 @@ from pathlib import Path from pygments.lexers import JsonLexer, XmlLexer from sphinx.util import logging +import sphinx _logger = logging.getLogger(__name__) @@ -128,7 +129,13 @@ intersphinx_mapping = { github_user = 'odoo' github_project = 'documentation' -locale_dirs = ['locale/'] +locale_dirs = ['../locale/'] + +# custom docname_to_domain to devide the translations of applications in subdirectories +sphinx.transforms.i18n.docname_to_domain = ( + sphinx.util.i18n.docname_to_domain +) = lambda docname, compact: docname.split('/')[1 if docname.startswith('applications/') else 0] + supported_languages = { 'de': 'Deutsch', 'en': 'English', diff --git a/content/administration/deployment/email_gateway.rst b/content/administration/deployment/email_gateway.rst index ea25fcd78..caea66041 100644 --- a/content/administration/deployment/email_gateway.rst +++ b/content/administration/deployment/email_gateway.rst @@ -44,5 +44,5 @@ For Exim - `Exim `_ .. tip:: - If you don't have access/manage your email server, use `inbound messages - `_. + If you don't have access/manage your email server, use :ref:`inbound messages + `. diff --git a/content/administration/odoo_sh/advanced/containers.rst b/content/administration/odoo_sh/advanced/containers.rst index 10e456d8c..0b7b18d27 100644 --- a/content/administration/odoo_sh/advanced/containers.rst +++ b/content/administration/odoo_sh/advanced/containers.rst @@ -167,7 +167,7 @@ In the above commands, the argument: * ``--stop-after-init`` will immediately shutdown the server instance after it completed the operations you asked. More options are available and detailed in the -`CLI documentation `_. +:doc:`CLI documentation `. You can find in the logs (*~/logs/odoo.log*) the addons path used by Odoo.sh to run your server. Look for "*odoo: addons paths*": diff --git a/content/administration/odoo_sh/getting_started/branches.rst b/content/administration/odoo_sh/getting_started/branches.rst index f0a2623f3..e4443f420 100644 --- a/content/administration/odoo_sh/getting_started/branches.rst +++ b/content/administration/odoo_sh/getting_started/branches.rst @@ -42,7 +42,7 @@ instance will be held temporarily unavailable for maintenance reason. This method is equivalent to perform an upgrade of the module through the Apps menu, or through the :code:`-u` switch of -`the command line `_. +:doc:`the command line `. In the case the changes in the commit prevent the server to restart, or if the modules update fails, @@ -318,15 +318,15 @@ Staging builds duplicate the production build and the production build only inst **Test suite** For development branches, you can choose to enable or disable the test suite. It's enabled by default. -When the test suite is enabled, you can restrict them by specifying test tags `test tags -`_. +When the test suite is enabled, you can restrict them by specifying test tags :ref:`test tags +`. **Odoo Version** For development branches only, you can change the version of Odoo, should you want to test upgraded code or develop features while your production database is in the process of being upgraded to a newer version. -In addition, for each version you have two options regarding the code update. +In addition, for each version you have two options regarding the code update. * You can choose to benefit from the latest bug, security and performance fixes automatically. The sources of your Odoo server will be updated weekly. This is the 'Latest' option. diff --git a/content/administration/odoo_sh/getting_started/create.rst b/content/administration/odoo_sh/getting_started/create.rst index e0dc54d36..f44ff19cf 100644 --- a/content/administration/odoo_sh/getting_started/create.rst +++ b/content/administration/odoo_sh/getting_started/create.rst @@ -108,8 +108,7 @@ Access the URL :file:`/web/database/manager` of your on-premise database and dow .. Warning:: If you cannot access the database manager, it may have been disabled by your system administrator. - See the `database manager security documentation - `_. + See the :ref:`database manager security documentation `. You will need the master password of your database server. If you do not have it, contact your system administrator. @@ -152,7 +151,7 @@ Check your outgoing email servers There is a default mail server provided with Odoo.sh. To use it, there must be no enabled outgoing mail server configured in your database in :menuselection:`Settings --> Technical --> Outgoing Mail Servers` -(:doc:`Developer mode <../../../../applications/general/developer_mode/activate>` must be activated). +(:doc:`Developer mode ` must be activated). After the import of your database, all outgoing email servers are disabled so you use the Odoo.sh email server provided by default. diff --git a/content/administration/odoo_sh/getting_started/first_module.rst b/content/administration/odoo_sh/getting_started/first_module.rst index bb51152d2..d2ad364b3 100644 --- a/content/administration/odoo_sh/getting_started/first_module.rst +++ b/content/administration/odoo_sh/getting_started/first_module.rst @@ -88,8 +88,7 @@ From the Odoo.sh editor, in a terminal: $ odoo-bin scaffold my_module ~/src/user/ -Or, from your computer, if you have an `installation of Odoo -`_: +Or, from your computer, if you have an :ref:`installation of Odoo `: .. code-block:: bash @@ -150,7 +149,7 @@ Manually -------- If you want to create your module structure manually, -you can follow `Build an Odoo module `_ to understand +you can follow :doc:`Build an Odoo module ` to understand the structure of a module and the content of each file. Push the development branch @@ -264,7 +263,7 @@ and on your production you would not like your module to be installed automatica Your module may not appear directly in your apps to install either, you need to update your apps list first: -* activate the :doc:`Developer mode <../../../applications/general/developer_mode/activate>` +* activate the :doc:`Developer mode ` * in the apps menu, click the *Update Apps List* button, * in the dialog that appears, click the *Update* button. diff --git a/content/applications/finance/accounting/fiscal_localizations/localizations/argentina.rst b/content/applications/finance/accounting/fiscal_localizations/localizations/argentina.rst index 2b5757b8a..e467e9709 100644 --- a/content/applications/finance/accounting/fiscal_localizations/localizations/argentina.rst +++ b/content/applications/finance/accounting/fiscal_localizations/localizations/argentina.rst @@ -276,7 +276,7 @@ Sequences ~~~~~~~~~ In case that you want to synchronize the next number in the sequence in Odoo based on the next number in the AFIP POS, the next button that is visible under :doc:`developer mode -<../../../../../applications/general/developer_mode>` can be used: +` can be used: .. image:: media/argentina_edi_05.png :align: center diff --git a/content/applications/finance/accounting/fiscal_localizations/localizations/colombia.rst b/content/applications/finance/accounting/fiscal_localizations/localizations/colombia.rst index c9ec9768e..2b4c2817d 100644 --- a/content/applications/finance/accounting/fiscal_localizations/localizations/colombia.rst +++ b/content/applications/finance/accounting/fiscal_localizations/localizations/colombia.rst @@ -142,7 +142,7 @@ Journals Once the DIAN has assigned the official sequence and prefix for the electronic invoice resolution, the Sales journals related to your invoice documents need to be updated in Odoo. The sequence can be -accessed using the :doc:`Developer mode <../../../../../applications/general/developer_mode>`: :menuselection:`Accounting --> +accessed using the :doc:`Developer mode `: :menuselection:`Accounting --> Settings --> Configuration Setting --> Journals`. .. image:: media/colombia09.png diff --git a/content/applications/finance/accounting/fiscal_localizations/localizations/france.rst b/content/applications/finance/accounting/fiscal_localizations/localizations/france.rst index defa23cf2..e4a224723 100644 --- a/content/applications/finance/accounting/fiscal_localizations/localizations/france.rst +++ b/content/applications/finance/accounting/fiscal_localizations/localizations/france.rst @@ -2,44 +2,44 @@ France ====== -FEC +FEC === If you have installed the French Accounting, you will be able to download the FEC. -For this, go in :menuselection:`Accounting --> Reporting --> France --> FEC`. +For this, go in :menuselection:`Accounting --> Reporting --> France --> FEC`. .. tip:: If you do not see the submenu **FEC**, go in **Apps** and search for the module - called **France-FEC** and verify if it is well installed. + called **France-FEC** and verify if it is well installed. French Accounting Reports ========================= -If you have installed the French Accounting, you will have access to some accounting reports specific to France: +If you have installed the French Accounting, you will have access to some accounting reports specific to France: - Bilan comptable - Compte de résultats -- Plan de Taxes France +- Plan de Taxes France Get the VAT anti-fraud certification with Odoo ============================================== -As of January 1st 2018, a new anti-fraud legislation comes into effect -in France and DOM-TOM. This new legislation stipulates certain criteria -concerning the inalterability, security, storage and archiving of sales data. -These legal requirements are implemented in Odoo, version 9 onward, +As of January 1st 2018, a new anti-fraud legislation comes into effect +in France and DOM-TOM. This new legislation stipulates certain criteria +concerning the inalterability, security, storage and archiving of sales data. +These legal requirements are implemented in Odoo, version 9 onward, through a module and a certificate of conformity to download. Is my company required to use an anti-fraud software? ----------------------------------------------------- -Your company is required to use an anti-fraud cash register software like +Your company is required to use an anti-fraud cash register software like Odoo (CGI art. 286, I. 3° bis) if: * You are taxable (not VAT exempt) in France or any DOM-TOM, * Some of your customers are private individuals (B2C). -This rule applies to any company size. Auto-entrepreneurs are exempted from +This rule applies to any company size. Auto-entrepreneurs are exempted from VAT and therefore are not affected. Get certified with Odoo @@ -47,34 +47,34 @@ Get certified with Odoo Getting compliant with Odoo is very easy. -Your company is requested by the tax administration to deliver a certificate +Your company is requested by the tax administration to deliver a certificate of conformity testifying that your software complies with the anti-fraud -legislation. This certificate is granted by Odoo SA to Odoo Enterprise users +legislation. This certificate is granted by Odoo SA to Odoo Enterprise users `here `_. -If you use Odoo Community, you should -`upgrade to Odoo Enterprise `_ +If you use Odoo Community, you should +:doc:`upgrade to Odoo Enterprise ` or contact your Odoo service provider. In case of non-conformity, your company risks a fine of €7,500. To get the certification just follow the following steps: -* Install the anti-fraud module fitting your Odoo environment from the +* Install the anti-fraud module fitting your Odoo environment from the *Apps* menu: * if you use Odoo Point of Sale: *l10n_fr_pos_cert*: France - VAT Anti-Fraud Certification for Point of Sale (CGI 286 I-3 bis) * in any other case: *l10n_fr_certification*: France - VAT Anti-Fraud Certification (CGI 286 I-3 bis) -* Make sure a country is set on your company, otherwise your entries won’t be - encrypted for the inalterability check. To edit your company’s data, - go to :menuselection:`Settings --> Users & Companies --> Companies`. +* Make sure a country is set on your company, otherwise your entries won’t be + encrypted for the inalterability check. To edit your company’s data, + go to :menuselection:`Settings --> Users & Companies --> Companies`. Select a country from the list; Do not create a new country. * Download the mandatory certificate of conformity delivered by Odoo SA `here `__. .. note:: * To install the module in any system created before December 18th 2017, you should update the modules list. - To do so, activate the :doc:`Developer mode <../../../../../applications/general/developer_mode>`. + To do so, activate the :doc:`Developer mode `. Then go to the *Apps* menu and press *Update Modules List* in the top-menu. * In case you run Odoo on-premise, you need to update your installation and restart your server beforehand. @@ -91,52 +91,52 @@ Anti-fraud features The anti-fraud module introduces the following features: -* **Inalterability**: deactivation of all the ways to cancel or modify +* **Inalterability**: deactivation of all the ways to cancel or modify key data of POS orders, invoices and journal entries; * **Security**: chaining algorithm to verify the inalterability; -* **Storage**: automatic sales closings with computation of both period +* **Storage**: automatic sales closings with computation of both period and cumulative totals (daily, monthly, annually). Inalterability ~~~~~~~~~~~~~~ -All the possible ways to cancel and modify key data of paid POS orders, -confirmed invoices and journal entries are deactivated, -if the company is located in France or in any DOM-TOM. +All the possible ways to cancel and modify key data of paid POS orders, +confirmed invoices and journal entries are deactivated, +if the company is located in France or in any DOM-TOM. -.. note:: If you run a multi-companies environment, only the documents of +.. note:: If you run a multi-companies environment, only the documents of such companies are impacted. Security ~~~~~~~~ -To ensure the inalterability, every order or journal entry is encrypted -upon validation. -This number (or hash) is calculated from the key data of the document as +To ensure the inalterability, every order or journal entry is encrypted +upon validation. +This number (or hash) is calculated from the key data of the document as well as from the hash of the precedent documents. -The module introduces an interface to test the data inalterability. -If any information is modified on a document after its validation, -the test will fail. The algorithm recomputes all the hashes and compares them -against the initial ones. In case of failure, the system points out the first +The module introduces an interface to test the data inalterability. +If any information is modified on a document after its validation, +the test will fail. The algorithm recomputes all the hashes and compares them +against the initial ones. In case of failure, the system points out the first corrupted document recorded in the system. -Users with *Manager* access rights can launch the inalterability check. -For POS orders, go to -:menuselection:`Point of Sales --> Reporting --> French Statements`. -For invoices or journal entries, +Users with *Manager* access rights can launch the inalterability check. +For POS orders, go to +:menuselection:`Point of Sales --> Reporting --> French Statements`. +For invoices or journal entries, go to :menuselection:`Invoicing/Accounting --> Reporting --> French Statements`. Storage ~~~~~~~ -The system also processes automatic sales closings on a daily, monthly +The system also processes automatic sales closings on a daily, monthly and annual basis. -Such closings distinctly compute the sales total of the period as well as -the cumulative grand totals from the very first sales entry recorded +Such closings distinctly compute the sales total of the period as well as +the cumulative grand totals from the very first sales entry recorded in the system. -Closings can be found in the *French Statements* menu of Point of Sale, +Closings can be found in the *French Statements* menu of Point of Sale, Invoicing and Accounting apps. .. note:: @@ -144,33 +144,33 @@ Invoicing and Accounting apps. * For multi-companies environments, such closings are performed by company. - * POS orders are posted as journal entries at the closing of the POS session. - Closing a POS session can be done anytime. - To prompt users to do it on a daily basis, the module prevents from resuming - a session opened more than 24 hours ago. + * POS orders are posted as journal entries at the closing of the POS session. + Closing a POS session can be done anytime. + To prompt users to do it on a daily basis, the module prevents from resuming + a session opened more than 24 hours ago. Such a session must be closed before selling again. - * A period’s total is computed from all the journal entries posted after the - previous closing of the same type, regardless of their posting date. - If you record a new sales transaction for a period already closed, + * A period’s total is computed from all the journal entries posted after the + previous closing of the same type, regardless of their posting date. + If you record a new sales transaction for a period already closed, it will be counted in the very next closing. .. tip:: For test & audit purposes such closings can be manually generated in the - :doc:`Developer mode <../../../../../applications/general/developer_mode>`. Then go to + :doc:`Developer mode `. Then go to :menuselection:`Settings --> Technical --> Automation --> Scheduled Actions`. Responsibilities ---------------- -Do not uninstall the module! If you do so, the hashes will be reset and none +Do not uninstall the module! If you do so, the hashes will be reset and none of your past data will be longer guaranteed as being inalterable. -Users remain responsible for their Odoo instance and must use it with -due diligence. It is not permitted to modify the source code which guarantees +Users remain responsible for their Odoo instance and must use it with +due diligence. It is not permitted to modify the source code which guarantees the inalterability of data. - -Odoo absolves itself of all and any responsibility in case of changes + +Odoo absolves itself of all and any responsibility in case of changes in the module’s functions caused by 3rd party applications not certified by Odoo. diff --git a/content/applications/finance/accounting/fiscal_localizations/localizations/italy_IT.rst b/content/applications/finance/accounting/fiscal_localizations/localizations/italy_IT.rst index 54421efb4..544d77c8f 100644 --- a/content/applications/finance/accounting/fiscal_localizations/localizations/italy_IT.rst +++ b/content/applications/finance/accounting/fiscal_localizations/localizations/italy_IT.rst @@ -25,7 +25,7 @@ elettronica sono i seguenti: di posta elettronica certificata sono fornite dal tuo fornitore o dal Ministero. Lo stesso server deve essere configurato come server che gestisce tutta la corrispondenza mail in Odoo, per saperne di più si - puo’ consultare la relativa :doc:`guida <../../../../productivity/discuss/advanced/email_servers>`. + puo’ consultare la relativa :doc:`guida `. - Indirizzo PEC dell’ Azienda, tale indirizzo deve essere lo stesso registrato presso l’Agenzia delle Entrate per l’utilizzo dei servizi diff --git a/content/applications/finance/accounting/fiscal_localizations/localizations/mexico.rst b/content/applications/finance/accounting/fiscal_localizations/localizations/mexico.rst index f8af7c1b7..536983250 100644 --- a/content/applications/finance/accounting/fiscal_localizations/localizations/mexico.rst +++ b/content/applications/finance/accounting/fiscal_localizations/localizations/mexico.rst @@ -469,7 +469,7 @@ Landed Costs`. There you will find the option to attach the Pedimentos number. with the transfer(s). .. seealso:: - :doc:`../../../../inventory_and_mrp/inventory/management/reporting/integrating_landed_costs`. + :doc:`/applications/inventory_and_mrp/inventory/management/reporting/integrating_landed_costs`. Payment Terms ~~~~~~~~~~~~~ @@ -1333,7 +1333,7 @@ Enabling Explicit errors on the CFDI using the XSD local validator (CFDI 3.3) Frequently you want receive explicit errors from the fields incorrectly set on the xml, those errors are better informed to the user if the check is enable, to enable the Check with xsd feature follow the next steps (with the -:doc:`Developer mode <../../../../general/developer_mode/activate>` enabled). +:doc:`Developer mode ` enabled). - Go to :menuselection:`Settings --> Technical --> Actions --> Server Actions` - Look for the Action called "Download XSD files to CFDI" diff --git a/content/applications/finance/accounting/others/analytic/timesheets.rst b/content/applications/finance/accounting/others/analytic/timesheets.rst index 4071c5bb5..c004e869c 100644 --- a/content/applications/finance/accounting/others/analytic/timesheets.rst +++ b/content/applications/finance/accounting/others/analytic/timesheets.rst @@ -73,7 +73,7 @@ of measures. :align: center For more information on how to create a sales order based on time and -material please see :doc:`../../../../sales/sales/invoicing/time_materials`. +material please see :doc:`/applications/sales/sales/invoicing/time_materials`. We save a Sales Order with the service product **External Consulting**. An analytical account will automatically be generated once the **Sales Order** diff --git a/content/applications/finance/accounting/others/inventory.rst b/content/applications/finance/accounting/others/inventory.rst index f02c7da41..1c589508c 100644 --- a/content/applications/finance/accounting/others/inventory.rst +++ b/content/applications/finance/accounting/others/inventory.rst @@ -1,10 +1,9 @@ -=========== +========= Inventory -=========== +========= .. toctree:: :titlesonly: inventory/avg_price_valuation - ../../../inventory_and_mrp/inventory/management/reporting/inventory_valuation_config - + /applications/inventory_and_mrp/inventory/management/reporting/inventory_valuation_config diff --git a/content/applications/finance/accounting/payables/supplier_bills/purchase_receipts.rst b/content/applications/finance/accounting/payables/supplier_bills/purchase_receipts.rst index 50650a3d7..36ed3821b 100644 --- a/content/applications/finance/accounting/payables/supplier_bills/purchase_receipts.rst +++ b/content/applications/finance/accounting/payables/supplier_bills/purchase_receipts.rst @@ -12,7 +12,7 @@ amount is first credited on a debt account before a later payment reconciliation .. note:: Expenses paid by employees can be managed with **Odoo Expenses**, an app dedicated to the approval of such expenses and the payments management. Click :doc:`here - <../../../expense/expense>` for more information on how to use Odoo Expenses. + ` for more information on how to use Odoo Expenses. Register a receipt ================== @@ -42,4 +42,4 @@ needs, and click on *Post*. .. seealso:: - :doc:`manage` - - :doc:`../../../expense/expense` \ No newline at end of file + - :doc:`/applications/finance/expense/expense` diff --git a/content/applications/finance/accounting/receivables/customer_invoices/overview.rst b/content/applications/finance/accounting/receivables/customer_invoices/overview.rst index 62a08ba87..f080107ed 100644 --- a/content/applications/finance/accounting/receivables/customer_invoices/overview.rst +++ b/content/applications/finance/accounting/receivables/customer_invoices/overview.rst @@ -42,7 +42,7 @@ lines, invoice a fixed advance. This process is good for both services and physical products. .. seealso:: - - :doc:`../../../../sales/sales/invoicing/proforma` + - :doc:`/applications/sales/sales/invoicing/proforma` Sales Order ‣ Delivery Order ‣ Invoice -------------------------------------- @@ -58,7 +58,7 @@ later), the customer will receive two invoices, one for each delivery order. .. seealso:: - - :doc:`../../../../sales/sales/invoicing/invoicing_policy` + - :doc:`/applications/sales/sales/invoicing/invoicing_policy` eCommerce Order ‣ Invoice ------------------------- @@ -91,9 +91,9 @@ mostly based on time and material. For services companies that invoice on fix price, they use a regular sales order. .. seealso:: - - :doc:`../../../../sales/sales/invoicing/time_materials` - - :doc:`../../../../sales/sales/invoicing/expense` - - :doc:`../../../../sales/sales/invoicing/milestone` + - :doc:`/applications/sales/sales/invoicing/time_materials` + - :doc:`/applications/sales/sales/invoicing/expense` + - :doc:`/applications/sales/sales/invoicing/milestone` Recurring Contracts ‣ Invoices ------------------------------ @@ -103,7 +103,7 @@ The frequency of the invoicing and the services/products invoiced are defined on the contract. .. seealso:: - - :doc:`../../../../sales/sales/invoicing/subscriptions` + - :doc:`/applications/sales/sales/invoicing/subscriptions` Others ====== diff --git a/content/applications/finance/accounting/receivables/customer_payments/online_payment.rst b/content/applications/finance/accounting/receivables/customer_payments/online_payment.rst index 817d07214..3c1064c62 100644 --- a/content/applications/finance/accounting/receivables/customer_payments/online_payment.rst +++ b/content/applications/finance/accounting/receivables/customer_payments/online_payment.rst @@ -17,7 +17,7 @@ Configuration Make sure your :ref:`Payment Acquirers are correctly configured `. .. note:: - By default, ":doc:`Wire Transfer <../../../../general/payment_acquirers/wire_transfer>`" is the only + By default, ":doc:`Wire Transfer `" is the only Payment Acquirer activated, but you still have to fill out the payment details. To activate the Invoice Online Payment, go to :menuselection:`Accounting --> Configuration --> @@ -42,4 +42,4 @@ They can choose which Payment Acquirer to use by clicking on *Pay Now*. .. seealso:: - - :doc:`../../../../general/payment_acquirers/payment_acquirers` + - :doc:`/applications/general/payment_acquirers/payment_acquirers` diff --git a/content/applications/finance/accounting/reporting/overview/customize.rst b/content/applications/finance/accounting/reporting/overview/customize.rst index 60fc8946b..6aa7cba3b 100644 --- a/content/applications/finance/accounting/reporting/overview/customize.rst +++ b/content/applications/finance/accounting/reporting/overview/customize.rst @@ -14,7 +14,7 @@ Activate the developer mode =========================== In order to have access to the financial report creation interface, the -:doc:`Developer mode <../../../../../applications/general/developer_mode>` needs to be activated. +:doc:`Developer mode ` needs to be activated. Create your financial report ============================ diff --git a/content/applications/general/in_app_purchase/in_app_purchase.rst b/content/applications/general/in_app_purchase/in_app_purchase.rst index a78e75492..427b807d9 100644 --- a/content/applications/general/in_app_purchase/in_app_purchase.rst +++ b/content/applications/general/in_app_purchase/in_app_purchase.rst @@ -24,12 +24,12 @@ IAP accounts Credits to use IAP services are stored on IAP accounts, which are specific to each service and database. By default, IAP accounts are common to all companies, but can be restricted to specific -ones. Activate the :doc:`Developer mode <../../../../applications/general/developer_mode>`, then go to +ones. Activate the :doc:`Developer mode `, then go to :menuselection:`Technical Settings --> IAP Account`. .. image:: media/image2.png :align: center - + IAP Portal ========== @@ -62,10 +62,10 @@ Different services are available depending on the hosting type of your Database: - *Odoo.sh and Odoo Enterprise (on-premise)*: both the services provided by Odoo and by third-party apps can be used. -Offering my own services +Offering my own services ======================== I am more than welcome to offer my own IAP services through Odoo Apps! It is the perfect opportunity to get recurring revenue for an ongoing service use rather than — and possibly instead of — a sole -initial purchase. Please, find more information at: `In-App Purchase -`_ +initial purchase. Please, find more information at: :doc:`In-App Purchase +`. diff --git a/content/applications/general/multi_companies/manage_multi_companies.rst b/content/applications/general/multi_companies/manage_multi_companies.rst index ebdf30361..8ddbd1fc9 100644 --- a/content/applications/general/multi_companies/manage_multi_companies.rst +++ b/content/applications/general/multi_companies/manage_multi_companies.rst @@ -127,5 +127,5 @@ at an invoice/bills level or at a sales/purchase orders level. Remember to test all workflows as an user other than the administrator. .. seealso:: - - `Multi-company Guidelines `_ + - :doc:`Multi-company Guidelines ` - :doc:`../../finance/accounting/others/multicurrencies/how_it_works` diff --git a/content/applications/general/odoo_basics/users.rst b/content/applications/general/odoo_basics/users.rst index a8cac1ae4..1df85dfad 100644 --- a/content/applications/general/odoo_basics/users.rst +++ b/content/applications/general/odoo_basics/users.rst @@ -39,7 +39,7 @@ the user. The user must click on it to accept the invitation and create a login. `pricing page `_ for more information. -With the :doc:`Developer mode <../../../../applications/general/developer_mode>` activated, *User Types* can +With the :doc:`Developer mode ` activated, *User Types* can be selected. .. image:: users/user-type.png @@ -121,7 +121,7 @@ can reaccess your database using your new password. Access Rights in detail ======================= -Activate the :doc:`Developer mode <../../../../applications/general/developer_mode>`, then go to +Activate the :doc:`Developer mode `, then go to :menuselection:`Settings --> Users & Companies --> Groups`. Groups @@ -194,7 +194,7 @@ the user can have access. .. note:: Note that if not handled correctly, it may be the source of a lot of inconsistent multi-company behaviors. Therefore, a good knowledge of Odoo is required. For technical explanations refer - to `this `_ documentation. + to :doc:`this ` documentation. .. image:: users/multi-companies.png :align: center @@ -203,4 +203,4 @@ the user can have access. .. seealso:: - :doc:`../multi_companies/manage_multi_companies` - - :doc:`../../settings/users_and_features` \ No newline at end of file + - :doc:`../../settings/users_and_features` diff --git a/content/applications/inventory_and_mrp/inventory/barcode/operations/barcode_nomenclature.rst b/content/applications/inventory_and_mrp/inventory/barcode/operations/barcode_nomenclature.rst index d749ad677..7af121f5e 100644 --- a/content/applications/inventory_and_mrp/inventory/barcode/operations/barcode_nomenclature.rst +++ b/content/applications/inventory_and_mrp/inventory/barcode/operations/barcode_nomenclature.rst @@ -14,7 +14,7 @@ Create a Barcode Nomenclature Odoo supports Barcode Nomenclatures, which determine the mapping and interpretation of the encoded information. You can configure your barcode nomenclature being in -:doc:`Developer mode <../../../../../applications/general/developer_mode>`. +:doc:`Developer mode `. To do so, go to :menuselection:`Inventory --> Configuration --> Barcode Nomenclature`. You can create a barcode nomenclature from there, and then add a line to diff --git a/content/applications/inventory_and_mrp/inventory/management/incoming/handle_receipts.rst b/content/applications/inventory_and_mrp/inventory/management/incoming/handle_receipts.rst index 339313c45..937fb40db 100644 --- a/content/applications/inventory_and_mrp/inventory/management/incoming/handle_receipts.rst +++ b/content/applications/inventory_and_mrp/inventory/management/incoming/handle_receipts.rst @@ -38,7 +38,7 @@ The principles are the following: correspond to the quality requirements agreed with the suppliers. Adding a quality control step in the goods receipt process can become essential. - + You receive the goods in an input area, then transfer them into quality area for quality control. When your quality check process finishes then you can move the goods from QC to stock. @@ -66,4 +66,4 @@ Please read documentation on :doc:`three_steps` .. seealso:: - :doc:`../delivery/inventory_flow` - - :doc:`../../../purchase/advanced/analyze` \ No newline at end of file + - :doc:`/applications/inventory_and_mrp/purchase/advanced/analyze` diff --git a/content/applications/inventory_and_mrp/inventory/management/reporting.rst b/content/applications/inventory_and_mrp/inventory/management/reporting.rst index a1fd03662..b95e79f4d 100644 --- a/content/applications/inventory_and_mrp/inventory/management/reporting.rst +++ b/content/applications/inventory_and_mrp/inventory/management/reporting.rst @@ -9,4 +9,4 @@ Valuation Methods reporting/inventory_valuation_config reporting/using_inventory_valuation reporting/integrating_landed_costs - ../../../finance/accounting/others/inventory/avg_price_valuation \ No newline at end of file + /applications/finance/accounting/others/inventory/avg_price_valuation diff --git a/content/applications/inventory_and_mrp/inventory/management/reporting/inventory_valuation_config.rst b/content/applications/inventory_and_mrp/inventory/management/reporting/inventory_valuation_config.rst index e5cde804e..aecf568de 100644 --- a/content/applications/inventory_and_mrp/inventory/management/reporting/inventory_valuation_config.rst +++ b/content/applications/inventory_and_mrp/inventory/management/reporting/inventory_valuation_config.rst @@ -184,7 +184,7 @@ accounting modes. Usually, based on your country, the correct accounting mode will be chosen by default. If you want to verify your accounting mode, activate -the :doc:`Developer mode <../../../../../applications/general/developer_mode>` and open your accounting +the :doc:`Developer mode ` and open your accounting settings. Manual Inventory Valuation diff --git a/content/applications/marketing/sms_marketing/pricing/pricing_and_faq.rst b/content/applications/marketing/sms_marketing/pricing/pricing_and_faq.rst index 7e173a3a8..62b38743c 100644 --- a/content/applications/marketing/sms_marketing/pricing/pricing_and_faq.rst +++ b/content/applications/marketing/sms_marketing/pricing/pricing_and_faq.rst @@ -100,7 +100,7 @@ More common questions Yes, the SMS is logged as a note under the chatter of the corresponding record, and a complete history of the SMSs sent is available on - :doc:`Developer mode <../../../general/developer_mode/activate>` under + :doc:`Developer mode ` under :menuselection:`Technical --> SMS`. diff --git a/content/applications/productivity/discuss/advanced/email_servers.rst b/content/applications/productivity/discuss/advanced/email_servers.rst index 5d1174be9..669346bb4 100644 --- a/content/applications/productivity/discuss/advanced/email_servers.rst +++ b/content/applications/productivity/discuss/advanced/email_servers.rst @@ -108,6 +108,8 @@ Restriction ----------- Please note that the port 25 is blocked for security reasons. Try using 587, 465 or 2525. +.. _discuss/email_servers/inbound_messages: + How to manage inbound messages ============================== @@ -161,10 +163,10 @@ alias in your mail server. You should set redirections for all the email addresses to Odoo's domain name in your email server (e.g. *catchall@mydomain.ext* to *catchall@mycompany.odoo.com*). -.. tip:: All the aliases are customizable in Odoo. +.. tip:: All the aliases are customizable in Odoo. Object aliases can be edited from their respective configuration view. To edit catchall and bounce aliases, you first need to activate the - :doc:`Developer mode <../../../../applications/general/developer_mode>`. + :doc:`Developer mode `. Then go to :menuselection:`Settings --> Technical --> Parameters --> System Parameters` to customize the aliases (*mail.catchall.alias* & * mail.bounce.alias*). @@ -172,11 +174,11 @@ alias in your mail server. .. image:: media/system_parameters.png :align: center -.. note:: By default inbound messages are fetched every 5 minutes in Odoo on-premise. - You can change this value in :doc:`Developer mode <../../../../applications/general/developer_mode>`. - Go to :menuselection:`Settings --> Technical --> Automation --> +.. note:: By default inbound messages are fetched every 5 minutes in Odoo on-premise. + You can change this value in :doc:`Developer mode `. + Go to :menuselection:`Settings --> Technical --> Automation --> Scheduled Actions` and look for *Mail: Fetchmail Service*. - + .. _Office 365 documentation: https://support.office.com/en-us/article/how-to-set-up-a-multifunction-device-or-application-to-send-email-using-office-365-69f58e99-c550-4274-ad18-c805d654b4c4 @@ -195,7 +197,7 @@ or Sendgrid for mass mailings. unless you want to use a specific external outgoing email server for technical reasons. To do this, you should first enable the :doc:`Developer mode -<../../../../applications/general/developer_mode>` and then go to :menuselection:`Settings --> Technical +` and then go to :menuselection:`Settings --> Technical --> Outgoing` e-mail servers. There you have to create two e-mail MTA server settings. One for transactional e-mails and one for mass mail servers. Be sure to mark the priority of transactional e-mail servers as low as the mass email servers. diff --git a/content/applications/productivity/discuss/advanced/email_template.rst b/content/applications/productivity/discuss/advanced/email_template.rst index 9f2ee287b..993b95a20 100644 --- a/content/applications/productivity/discuss/advanced/email_template.rst +++ b/content/applications/productivity/discuss/advanced/email_template.rst @@ -11,7 +11,7 @@ improving their overall experience with the company. Enable it and understand a few concepts ======================================= -The :doc:`Developer mode <../../../../applications/general/developer_mode>` must be activated. Then, go to +The :doc:`Developer mode ` must be activated. Then, go to :menuselection:`Settings --> Technical --> Templates`. A view of the existing templates is shown. .. warning:: diff --git a/content/applications/productivity/iot/config/pos.rst b/content/applications/productivity/iot/config/pos.rst index d0d1d2070..ff76988eb 100644 --- a/content/applications/productivity/iot/config/pos.rst +++ b/content/applications/productivity/iot/config/pos.rst @@ -55,7 +55,7 @@ Then, you have to connect the peripheral devices to your IoT Box. - **Payment terminal**: The connection process depends on the terminal, please refer to the :doc:`payment terminals documentation - <../../../sales/point_of_sale/payment>`. + `. Once it's done, you can connect the IoT Box to your PoS. For this, go in :menuselection:`Point of Sale --> Configuration --> PoS`, tick *IoT Box* diff --git a/content/applications/productivity/studio/concepts/understanding_automated_actions.rst b/content/applications/productivity/studio/concepts/understanding_automated_actions.rst index 29838a11c..123cff680 100644 --- a/content/applications/productivity/studio/concepts/understanding_automated_actions.rst +++ b/content/applications/productivity/studio/concepts/understanding_automated_actions.rst @@ -50,7 +50,7 @@ For every Trigger option, **conditions** can be applied, such as: - *Send Email*: an automatic :doc:`email <../../discuss/advanced/email_template>` is sent. - *Add Followers*: followers are notified of changes in the task. - *Create Next Activity*: creates an activity such as: *Call*, *Email*, *Reminder*. -- *Send SMS Text Message*: sends an :doc:`SMS <../../../marketing/sms_marketing/pricing/pricing_and_faq>`. +- *Send SMS Text Message*: sends an :doc:`SMS `. Example ~~~~~~~ diff --git a/content/applications/productivity/studio/how_to/reports.rst b/content/applications/productivity/studio/how_to/reports.rst index fa951c56b..0c059e067 100644 --- a/content/applications/productivity/studio/how_to/reports.rst +++ b/content/applications/productivity/studio/how_to/reports.rst @@ -34,7 +34,7 @@ them. Fields with related objects have their directives shown on *Field Expressi | Under **Visible if**, define the rule(s) to set visibility conditions to fields. | Example: if choosing to display a product image, you could set a visibility rule to only display the ones that are *set* in the product form, avoiding having a plain icon when they are not set. -| **Visible for** is used to set which :doc:`groups <../../../general/odoo_basics/users>` +| **Visible for** is used to set which :doc:`groups ` can have access to specific elements in the report. **Limit visibility to groups**, under *Report*, sets the visibility of the report to specifics groups, meaning that users belonging to other groups do not see the same final document. @@ -50,7 +50,7 @@ added to the *Print* menu list on its respective document form. :align: center :alt: View of an invoice form emphasizing the menu print for Odoo Studio -If activating the :doc:`Developer mode <../../../general/developer_mode/activate>`, additional fields +If activating the :doc:`Developer mode `, additional fields such as *Class* under *Options*, and *Reload from attachment* under *Report*, become visible. - *Class*: add custom CSS classes to the selected element (e.g. Bootstrap classes such as diff --git a/content/applications/productivity/studio/use_cases/models_fields.rst b/content/applications/productivity/studio/use_cases/models_fields.rst index 9d31ac785..8a898e68d 100644 --- a/content/applications/productivity/studio/use_cases/models_fields.rst +++ b/content/applications/productivity/studio/use_cases/models_fields.rst @@ -116,7 +116,7 @@ Administrator* or managers. - **Case scenario 5: change the tooltip of a field for all views.** -| Activate the :doc:`Developer mode <../../../general/developer_mode/activate>` and open Studio. +| Activate the :doc:`Developer mode ` and open Studio. | Select the necessary field and, under *Properties*, click on *More* to write your tooltip message on *Field Help*. The tooltip message is the explanatory message shown when the user hovers the field. The message here written is displayed on all views forms where the field is added. diff --git a/content/applications/sales/crm/acquire_leads/lead_mining.rst b/content/applications/sales/crm/acquire_leads/lead_mining.rst index 74ff7eb3a..220f7455e 100644 --- a/content/applications/sales/crm/acquire_leads/lead_mining.rst +++ b/content/applications/sales/crm/acquire_leads/lead_mining.rst @@ -68,5 +68,5 @@ Credits`; or go to :menuselection:`Settings --> In-App Purchases --> View my Ser If you are on Odoo Online (SAAS) and have the Enterprise version, you benefit from free trial credits to test the feature. .. seealso:: - * :doc:`In-App Purchases (IAP) <../../../general/in_app_purchase/in_app_purchase>` + * :doc:`In-App Purchases (IAP) ` diff --git a/content/applications/sales/point_of_sale/overview/getting_started.rst b/content/applications/sales/point_of_sale/overview/getting_started.rst index d3a905b45..1bac5d8f2 100644 --- a/content/applications/sales/point_of_sale/overview/getting_started.rst +++ b/content/applications/sales/point_of_sale/overview/getting_started.rst @@ -122,8 +122,8 @@ If everything is correct, validate the session and post the closing entries. .. tip:: To connect the PoS hardware with an Odoo IoT Box, please refer to these docs: :doc:`Connect an IoT Box to your database - <../../../productivity/iot/config/connect>` and :doc:`Use the IoT Box for the PoS - <../../../productivity/iot/config/pos>`. + ` and :doc:`Use the IoT Box for the PoS + `. View your statistics ==================== diff --git a/content/applications/sales/point_of_sale/payment/ingenico.rst b/content/applications/sales/point_of_sale/payment/ingenico.rst index 24de3cac0..56fd4aed9 100644 --- a/content/applications/sales/point_of_sale/payment/ingenico.rst +++ b/content/applications/sales/point_of_sale/payment/ingenico.rst @@ -16,7 +16,7 @@ Connect an IoT Box Connecting an Ingenico Payment Terminal to Odoo is a feature that requires an IoT Box. For more information on how to connect an IoT Box -to your database, please refer to the :doc:`IoT documentation <../../../productivity/iot/config/connect>`. +to your database, please refer to the :doc:`IoT documentation `. Configure the Lane/5000 for Ingenico BENELUX -------------------------------------------- diff --git a/content/applications/sales/sales/amazon_connector/manage.rst b/content/applications/sales/sales/amazon_connector/manage.rst index 431f44cce..3c61c43cb 100644 --- a/content/applications/sales/sales/amazon_connector/manage.rst +++ b/content/applications/sales/sales/amazon_connector/manage.rst @@ -17,14 +17,14 @@ order is automatically canceled in Odoo. .. note:: To force the synchronization of an order whose status has not changed since the last - synchronization, activate the :doc:`Developer mode <../../../../applications/general/developer_mode>`, + synchronization, activate the :doc:`Developer mode `, navigate to your Amazon account and modify the date under :menuselection:`Orders Follow-up --> Last Order Sync`. Pick a date anterior to the last status change of the order that you wish to synchronize and save. .. tip:: To synchronize immediately the orders of your Amazon account switch to - :doc:`Developer mode <../../../../applications/general/developer_mode>`, head to your Amazon account and + :doc:`Developer mode `, head to your Amazon account and click on **SYNC ORDERS**. The same can be done with pickings by clicking on **SYNC PICKINGS**. Manage deliveries in FBM diff --git a/content/applications/sales/sales/amazon_connector/setup.rst b/content/applications/sales/sales/amazon_connector/setup.rst index 213292b96..32f0ea545 100644 --- a/content/applications/sales/sales/amazon_connector/setup.rst +++ b/content/applications/sales/sales/amazon_connector/setup.rst @@ -98,7 +98,7 @@ code, a default database product **Amazon Sale** is used. The same is done with .. note:: To modify the default products, activate the - :doc:`Developer mode <../../../../applications/general/developer_mode>` and navigate to + :doc:`Developer mode ` and navigate to :menuselection:`Sales --> Configuration --> Settings --> Connectors --> Amazon Sync --> Default Products`. @@ -131,7 +131,7 @@ marketplaces. must belong to the same region as that of your seller account. To add a new marketplace, you must first enable :doc:`Developer mode -<../../../../applications/general/developer_mode>`. +`. Once that is done, go to :menuselection:`Sales --> Configuration --> Settings --> Connectors --> Amazon Sync --> Amazon Marketplaces`. diff --git a/content/applications/sales/sales/ebay_connector/setup.rst b/content/applications/sales/sales/ebay_connector/setup.rst index 14330cd26..190ab6b66 100644 --- a/content/applications/sales/sales/ebay_connector/setup.rst +++ b/content/applications/sales/sales/ebay_connector/setup.rst @@ -48,7 +48,7 @@ parallel in existing installations. To switch to the new synchronization mechanism: -#. Enable the :doc:`Developer mode <../../../../applications/general/developer_mode>`. +#. Enable the :doc:`Developer mode `. #. Go to :menuselection:`Settings --> Technical --> Scheduled Actions` #. Archive the old synchronization actions (both are named *Ebay: update product status*) #. Activate the new synchronization actions (*Ebay: get new orders* which runs every 15min by default and *Ebay: synchronise stock (for 'get new orders' synchronisation)* which runs once a day per default) diff --git a/content/applications/sales/sales/products_prices/prices/pricing.rst b/content/applications/sales/sales/products_prices/prices/pricing.rst index 18946a77e..f730ea7dd 100644 --- a/content/applications/sales/sales/products_prices/prices/pricing.rst +++ b/content/applications/sales/sales/products_prices/prices/pricing.rst @@ -138,4 +138,4 @@ In case of discount, you can show the public price and the computed discount % o .. seealso:: * :doc:`currencies` - * :doc:`../../../../websites/ecommerce/maximizing_revenue/pricing` + * :doc:`/applications/websites/ecommerce/maximizing_revenue/pricing` diff --git a/content/applications/sales/sales/products_prices/products/variants.rst b/content/applications/sales/sales/products_prices/products/variants.rst index 7ba2f9b98..26b4d4781 100644 --- a/content/applications/sales/sales/products_prices/products/variants.rst +++ b/content/applications/sales/sales/products_prices/products/variants.rst @@ -221,5 +221,5 @@ When you have entered all the extra values, click on **Save**. .. seealso:: - `Accounting Memento: Details of Journal Entries - <../../../accounting/overview/main_concepts/memento.html#journal-entries>`_ - - :doc:`../../../../finance/accounting/overview/process_overview/supplier_bill` + `_ + - :doc:`/applications/finance/accounting/overview/process_overview/supplier_bill` diff --git a/content/applications/sales/sales/products_prices/taxes.rst b/content/applications/sales/sales/products_prices/taxes.rst index f0ebee561..7a36bae84 100644 --- a/content/applications/sales/sales/products_prices/taxes.rst +++ b/content/applications/sales/sales/products_prices/taxes.rst @@ -1,12 +1,12 @@ -================= +========= Set taxes -================= +========= .. toctree:: :titlesonly: - ../../../finance/accounting/taxation/taxes/default_taxes - ../../../finance/accounting/taxation/taxes/fiscal_positions - ../../../finance/accounting/taxation/taxes/taxes - ../../../finance/accounting/taxation/taxes/taxcloud - ../../../finance/accounting/taxation/taxes/B2B_B2C + /applications/finance/accounting/taxation/taxes/default_taxes + /applications/finance/accounting/taxation/taxes/fiscal_positions + /applications/finance/accounting/taxation/taxes/taxes + /applications/finance/accounting/taxation/taxes/taxcloud + /applications/finance/accounting/taxation/taxes/B2B_B2C diff --git a/content/applications/sales/sales/send_quotations/get_paid_to_validate.rst b/content/applications/sales/sales/send_quotations/get_paid_to_validate.rst index fb4659eda..41759013e 100644 --- a/content/applications/sales/sales/send_quotations/get_paid_to_validate.rst +++ b/content/applications/sales/sales/send_quotations/get_paid_to_validate.rst @@ -22,9 +22,9 @@ feature. There, you will have direct access to the **Payment Acquirers** page. It will allow you to select and configure your acquirers of choice. Before creating or modifying a payment acquirer, be sure to check out our documentation about how to be paid with payment acquirers such as -:doc:`../../../general/payment_acquirers/paypal`, -:doc:`../../../general/payment_acquirers/authorize`, and others in the -:doc:`../../../general/payment_acquirers` documentation. +:doc:`/applications/general/payment_acquirers/paypal`, +:doc:`/applications/general/payment_acquirers/authorize`, and others in the +:doc:`/applications/general/payment_acquirers` documentation. .. note:: If you are familiar with this documentation: :doc:`quote_template`; you @@ -48,8 +48,8 @@ possibilities to make their online payments. For example: .. seealso:: - :doc:`quote_template` - - :doc:`../../../general/payment_acquirers` - - :doc:`../../../general/payment_acquirers/paypal` - - :doc:`../../../general/payment_acquirers/authorize` + - :doc:`/applications/general/payment_acquirers` + - :doc:`/applications/general/payment_acquirers/paypal` + - :doc:`/applications/general/payment_acquirers/authorize` diff --git a/content/applications/services/helpdesk/advanced/after_sales.rst b/content/applications/services/helpdesk/advanced/after_sales.rst index 841c5975d..829875aaf 100644 --- a/content/applications/services/helpdesk/advanced/after_sales.rst +++ b/content/applications/services/helpdesk/advanced/after_sales.rst @@ -64,4 +64,4 @@ same way as if you were on the *Field Service* application. :height: 300 .. seealso:: - - `Coupons `_ \ No newline at end of file + - `Coupons `_ diff --git a/content/applications/services/helpdesk/overview/getting_started.rst b/content/applications/services/helpdesk/overview/getting_started.rst index b8be76c1e..e968a409b 100644 --- a/content/applications/services/helpdesk/overview/getting_started.rst +++ b/content/applications/services/helpdesk/overview/getting_started.rst @@ -61,4 +61,4 @@ or use the stage. :alt: View of a team’s kanban view in Odoo Helpdesk .. seealso:: - - :doc:`../../../general/odoo_basics/users` + - :doc:`/applications/general/odoo_basics/users` diff --git a/content/applications/services/helpdesk/overview/receiving_tickets.rst b/content/applications/services/helpdesk/overview/receiving_tickets.rst index c280940ce..5a8ef6422 100644 --- a/content/applications/services/helpdesk/overview/receiving_tickets.rst +++ b/content/applications/services/helpdesk/overview/receiving_tickets.rst @@ -58,7 +58,7 @@ Live Chat | Through live interactions with your website visitors, helpdesk tickets can be instantly created and redirected to the right person. | Click on your helpdesk team's name - for the example below: *Customer Care* - - and :doc:`set up your channel <../../../websites/livechat/overview/get_started>`. + and :doc:`set up your channel `. .. image:: media/live_chat.png :align: center @@ -66,7 +66,7 @@ Live Chat in Odoo Helpdesk Now, your operators can create tickets by using the -:doc:`command <../../../websites/livechat/overview/responses>` */helpdesk (subject_of_ticket)*. +:doc:`command ` */helpdesk (subject_of_ticket)*. Prioritize tickets ================== @@ -86,4 +86,4 @@ the Kanban view. .. seealso:: - :doc:`sla` - :doc:`../advanced/close_tickets` - - :doc:`../../../productivity/discuss/advanced/email_servers` + - :doc:`/applications/productivity/discuss/advanced/email_servers` diff --git a/content/applications/services/helpdesk/timesheet_and_invoice/invoice_time.rst b/content/applications/services/helpdesk/timesheet_and_invoice/invoice_time.rst index d1147372c..7238b8959 100644 --- a/content/applications/services/helpdesk/timesheet_and_invoice/invoice_time.rst +++ b/content/applications/services/helpdesk/timesheet_and_invoice/invoice_time.rst @@ -109,4 +109,4 @@ order. .. seealso:: - :doc:`reinvoice_from_project` - - :doc:`../../../inventory_and_mrp/inventory/management/products/uom` + - :doc:`/applications/inventory_and_mrp/inventory/management/products/uom` diff --git a/content/applications/services/project/tasks/email_alias.rst b/content/applications/services/project/tasks/email_alias.rst index ec50a410a..30c422a0e 100644 --- a/content/applications/services/project/tasks/email_alias.rst +++ b/content/applications/services/project/tasks/email_alias.rst @@ -12,7 +12,7 @@ Set up an incoming email server | On the *Settings* application, enable *External Email Servers* and define the incoming email alias you would like to use. -| **For more information**: :doc:`../../../productivity/discuss/advanced/email_servers` +| **For more information**: :doc:`/applications/productivity/discuss/advanced/email_servers` Configure the email alias in your project ----------------------------------------- diff --git a/content/applications/services/timesheets/overview/time_off.rst b/content/applications/services/timesheets/overview/time_off.rst index 58bfe2699..5b3162138 100644 --- a/content/applications/services/timesheets/overview/time_off.rst +++ b/content/applications/services/timesheets/overview/time_off.rst @@ -6,7 +6,7 @@ Odoo automatically timesheets on project/tasks upon time off requests. This allo overall control over the validation of timesheets, as it does not leave place for forgetfulness and questions after hours that have not been timesheeted by the employee. -Activate the :doc:`Developer mode <../../../../applications/general/developer_mode>`, go to *Timesheets*, +Activate the :doc:`Developer mode `, go to *Timesheets*, and change the *Project* and *Task* set by default, if you like. .. image:: media/record_time_off.png diff --git a/content/applications/websites/ecommerce/getting_started/product_page.rst b/content/applications/websites/ecommerce/getting_started/product_page.rst index 58606ef45..87404b87d 100644 --- a/content/applications/websites/ecommerce/getting_started/product_page.rst +++ b/content/applications/websites/ecommerce/getting_started/product_page.rst @@ -24,7 +24,7 @@ See how to configure your products from links here below. .. seealso:: * :doc:`../managing_products/variants` - * :doc:`../../../sales/sales/products_prices/taxes` + * :doc:`/applications/sales/sales/products_prices/taxes` * :doc:`../maximizing_revenue/cross_selling` * :doc:`../maximizing_revenue/reviews` * :doc:`../maximizing_revenue/pricing` diff --git a/content/applications/websites/ecommerce/maximizing_revenue/pricing.rst b/content/applications/websites/ecommerce/maximizing_revenue/pricing.rst index 4deb92f60..612db3d0a 100644 --- a/content/applications/websites/ecommerce/maximizing_revenue/pricing.rst +++ b/content/applications/websites/ecommerce/maximizing_revenue/pricing.rst @@ -9,7 +9,7 @@ This section sheds light on pricing features found in the eCommerce app: * let the customer choose the currency. As a pre-requisite, check out how to managing product pricing: -:doc:`../../../sales/sales/products_prices/prices/pricing`). +:doc:`/applications/sales/sales/products_prices/prices/pricing`). Geo-IP automatically applies the right price ============================================ @@ -32,6 +32,6 @@ can be found in *Pricelists* under the *Products* menu, located in the Website a .. seealso:: - * :doc:`../../../sales/sales/products_prices/prices/pricing` - * :doc:`../../../sales/sales/products_prices/prices/currencies` + * :doc:`/applications/sales/sales/products_prices/prices/pricing` + * :doc:`/applications/sales/sales/products_prices/prices/currencies` * :doc:`promo_code` diff --git a/content/applications/websites/website/optimize/link_tracker.rst b/content/applications/websites/website/optimize/link_tracker.rst index ea0f0f2c3..5fd5d479a 100644 --- a/content/applications/websites/website/optimize/link_tracker.rst +++ b/content/applications/websites/website/optimize/link_tracker.rst @@ -52,5 +52,5 @@ country of origin for those clicks. get access to the *Link Tracker* module and its back-end functionalities. #. Integrated with :doc:`Google Analytics `, those trackers allow you to see the number of clicks and visitors to keep you on top of your marketing campaigns. - #. The integration with the :doc:`CRM <../../../sales/crm/track_leads/prospect_visits>` application allows - you to understand where your leads and opportunities are coming from. \ No newline at end of file + #. The integration with the :doc:`CRM ` application allows + you to understand where your leads and opportunities are coming from. diff --git a/content/applications/websites/website/optimize/seo.rst b/content/applications/websites/website/optimize/seo.rst index 637a8e9b3..0b01bcf4c 100644 --- a/content/applications/websites/website/optimize/seo.rst +++ b/content/applications/websites/website/optimize/seo.rst @@ -480,7 +480,7 @@ page. As these files are shared across all pages, further clicks by the same visitor will not load any other Javascript resource. .. note:: - If you work on :doc:`Developer mode <../../../../applications/general/developer_mode>`, the CSS and + If you work on :doc:`Developer mode `, the CSS and Javascript are neither concatenated, nor minified. Thus, it's much slower. But it allows you to easily debug with the Chrome debugger as CSS and Javascript resources are not transformed from their original versions. @@ -639,6 +639,6 @@ and there is no other indexing rule than specified in the sitemap to be found at following address. You can customize the file *robots* in -:doc:`Developer mode <../../../../applications/general/developer_mode>` from *Settings --> Technical --> +:doc:`Developer mode ` from *Settings --> Technical --> User Interface --> Views* (exclude robots, exclude some pages, redirect to a custom Sitemap). Make the Model Data of the view *Non Updatable* to not reset the file after system upgrades. diff --git a/content/applications/websites/website/publish/domain_name.rst b/content/applications/websites/website/publish/domain_name.rst index 30f8491e3..caafb70a0 100644 --- a/content/applications/websites/website/publish/domain_name.rst +++ b/content/applications/websites/website/publish/domain_name.rst @@ -2,14 +2,14 @@ How to use my own domain name ============================= -By default, your Odoo Online instance and website have a *.odoo.com* domain name, -for both the URL and the emails. +By default, your Odoo Online instance and website have a *.odoo.com* domain name, +for both the URL and the emails. But you can change to a custom one (e.g. www.yourcompany.com). What is a good domain name ========================== -Your website address is as important to your branding as the name of your -business or organization, so put some thought into changing it for a proper +Your website address is as important to your branding as the name of your +business or organization, so put some thought into changing it for a proper domain. Here are some tips: - Simple and obvious @@ -24,18 +24,18 @@ How to buy a domain name ======================== Buy your domain name at a popular registrar: -- `GoDaddy `__ -- `Namecheap `__ -- `OVH `__ +- `GoDaddy `__ +- `Namecheap `__ +- `OVH `__ -.. note:: Steps to buy a domain name are pretty much straight forward. +.. note:: Steps to buy a domain name are pretty much straight forward. In case of issue, check out those easy tutorials: - `GoDaddy `__ - `Namecheap `__ Feel free to buy an email server to have email addresses using your domain name. - However don't buy any extra service to create or host your website. + However don't buy any extra service to create or host your website. This is Odoo's job! .. _custom_domain: @@ -60,7 +60,7 @@ First let's authorize the redirection (yourcompany.com -> yourcompany.odoo.com): .. image:: media/domain_name03.png :align: center -* A database domain prompt will appear. Enter your custom domain +* A database domain prompt will appear. Enter your custom domain (e.g. www.yourcompany.com). @@ -72,7 +72,7 @@ We can now apply the redirection from your domain name's manager account: * Log in to your account and search for the DNS Zones management page. * Create a CNAME record *www.yourdomain.com* pointing to *mywebsite.odoo.com*. - If you want to use the naked domain (e.g. yourdomain.com), you need to redirect + If you want to use the naked domain (e.g. yourdomain.com), you need to redirect *yourdomain.com* to *www.yourdomain.com*. .. note:: Here are some specific guidelines to create a CNAME record: @@ -100,7 +100,7 @@ How to make sure that all my URLs use my custom domain? To set up the root URL of your website and of all the links sent in emails, you can ask an administrator of your database (any user in the *Settings* group) to perform a login from the login screen. It's as simple as that! -If you want to do it manually, you can go to :menuselection:`Settings --> Technical --> System Parameters` . +If you want to do it manually, you can go to :menuselection:`Settings --> Technical --> System Parameters` . Find the entry called ``web.base.url`` (you can create it if it does not exist) and enter the full URL of your website, like ``https://www.myodoowebsite.com``. .. warning:: @@ -117,4 +117,4 @@ Google indexes your website under both names. This is a limitation of the Odoo c .. seealso:: - * :doc:`../../../productivity/discuss/advanced/email_servers` + * :doc:`/applications/productivity/discuss/advanced/email_servers` diff --git a/content/applications/websites/website/publish/on-premise_geo-ip-installation.rst b/content/applications/websites/website/publish/on-premise_geo-ip-installation.rst index edb481a22..69d09513e 100644 --- a/content/applications/websites/website/publish/on-premise_geo-ip-installation.rst +++ b/content/applications/websites/website/publish/on-premise_geo-ip-installation.rst @@ -33,11 +33,11 @@ Installation ./odoo-bin --geoip-db= ~/Downloads/GeoLite2-City.mmdb .. seealso:: - - `CLI documentation `_. + - :doc:`CLI documentation `. .. warning:: ``GeoIP`` Python library can also be used. However this version is discontinued since January - 2019. See `GeoLite Legacy databases are now discontinued + 1. See `GeoLite Legacy databases are now discontinued `_ How To Test GeoIP Geolocation In Your Odoo Website @@ -59,11 +59,6 @@ You should end up with a dictionary indicating the location of the IP address. If the curly braces are empty ``{}``, it can be for any of the following reasons : - The browsing IP address is the localhost (``127.0.0.1``) or a local area network one (``192.168.*.*``) - - If a reversed proxy is used, make sure to configure it correctly. See `--proxy-mode `__ + - If a reversed proxy is used, make sure to configure it correctly. See :option:`proxy mode ` - ``geoip2`` is not installed or the GeoIP database file wasn't found - The GeoIP database was unable to resolve the given IP address - - - - - diff --git a/content/developer/reference/testing.rst b/content/developer/reference/testing.rst index 5f04644ed..2489b3636 100644 --- a/content/developer/reference/testing.rst +++ b/content/developer/reference/testing.rst @@ -108,6 +108,8 @@ Odoo server. .. _unittest documentation: https://docs.python.org/3/library/unittest.html +.. _developer/reference/testing/selection: + Test selection -------------- diff --git a/content/developer/webservices/localization.rst b/content/developer/webservices/localization.rst index 4e1628cd1..0f3057807 100644 --- a/content/developer/webservices/localization.rst +++ b/content/developer/webservices/localization.rst @@ -290,7 +290,9 @@ Adding a new fiscal position to my Chart of Accounts #################################################### .. note:: - If you need more information about what is a fiscal position and how it works in Odoo, please refer to `How to adapt taxes to my customer status or localization `_. + + If you need more information about what is a fiscal position and how it works in Odoo, + please refer to :doc:`/applications/finance/accounting/taxation/taxes/fiscal_positions`. To create a new fiscal position, simply use the ``account.fiscal.position.template`` model: @@ -361,7 +363,8 @@ How to create a new bank operation model? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. note:: - How a bank operation model works exactly in Odoo? See `Configure model of entries `_. + + How a bank operation model works exactly in Odoo? See :doc:`/applications/finance/accounting/bank/reconciliation/reconciliation_models`. Since ``V10``, a new feature is available in the bank statement reconciliation widget: the bank operation model. This allows the user to pre-fill some accounting entries with a single click. diff --git a/content/services/support/where_can_i_get_support.rst b/content/services/support/where_can_i_get_support.rst index 1dee97c8f..010000dc2 100644 --- a/content/services/support/where_can_i_get_support.rst +++ b/content/services/support/where_can_i_get_support.rst @@ -28,5 +28,5 @@ Here are some resources that might help you: - Our `documentation pages `_. - Ask your question on the `community forum `_. -- `Buy Odoo Enterprise `_ to get the +- :doc:`Buy Odoo Enterprise ` to get the support and bugfix services. diff --git a/redirects.txt b/redirects.txt index ec6a66fb9..edce657c3 100644 --- a/redirects.txt +++ b/redirects.txt @@ -30,6 +30,7 @@ contributing/documentation/guidelines.rst contributing/documentation/rst_guideli # Redirections introduced in 12.0 : +administration/odoo_sh/documentation.rst administration/odoo_sh.rst # moved during doc-apocalypse (#945) support/user_doc.rst contributing/documentation/introduction_guide.rst # removed in forward-port of #544 (b109c3af) # Redirections introduced in 13.0 :