diff --git a/README.md b/README.md new file mode 100644 index 000000000..2d872c815 --- /dev/null +++ b/README.md @@ -0,0 +1,50 @@ +# Odoo documentation + +## Build the documentation locally + +### Requirements + +- [Git](https://www.odoo.com/documentation/master/contributing/documentation/introduction_guide.html#install-git) +- [Python 3.6, 3.7, or 3.8](https://www.odoo.com/documentation/master/contributing/documentation/introduction_guide.html#python) +- Python dependencies listed in the file [`requirements.txt`](https://github.com/odoo/documentation/tree/master/requirements.txt). +- [Make](https://www.odoo.com/documentation/master/contributing/documentation/introduction_guide.html#make) +- A local copy of the [odoo/odoo repository in master](https://github.com/odoo/odoo/tree/master) (Optional) + +### Instructions + +1. In a terminal, navigate to the root directory and compile the documentation to HTML with the + following command: + + ```sh + make + ``` + + Additional commands are available with `make help`. + +2. Open the file `documentation/_build/html/index.html` in your web browser to display the render. + +3. See [this guide](https://www.odoo.com/documentation/master/contributing/documentation/introduction_guide.html#preview-your-changes) + for more detailed instructions. + +Optional: to fully build the developer documentation with inline docstrings for documented Python +functions, place your local copy of the `odoo/odoo` repository in the root directory. Alternatively, +create a symbolic link with `odoo` as link name. If the Odoo sources are not found, a warning will +be shown. + +## Contribute to the documentation + +For contributions to the content of the documentation, please refer to the +[Introduction Guide](https://www.odoo.com/documentation/master/contributing/documentation/introduction_guide.html). + +To **report a content issue**, **request new content** or **ask a question**, use the +[repository's issue tracker](https://github.com/odoo/documentation-user/issues) as usual. + +If you have a pull request that is ready for review, request one from the +[odoo/doc-review](https://github.com/orgs/odoo/teams/doc-review) team. + + +## Learn More + +To learn more about Odoo, in addition to the documentation, have a look at +[the official eLearning](https://odoo.com/slides) and +[Scale-up, The Business Game](https://www.odoo.com/page/scale-up-business-game). \ No newline at end of file diff --git a/README.rst b/README.rst deleted file mode 100644 index b77a87c64..000000000 --- a/README.rst +++ /dev/null @@ -1,54 +0,0 @@ -=========================== -End-user Odoo documentation -=========================== - -Build the documentation -======================= - -Requirements ------------- - -- `Git `_ - -- | `Python 3 `_ - | If you don't know which subversion to choose, pick the last one. - | Python dependencies are listed in the file ``requirements.txt`` located in the root - directory. - - - Sphinx 2.4.0 or above. - - Werkzeug 0.14.1 - -- `Make `_ - -Instructions ------------- - -In a terminal, navigate to the root directory and execute the following command: - -.. code-block:: console - - $ make html - -This compiles the documentation to HTML. - -Open ``documentation-user/_build/html/index.html`` in your web browser to display the render. - -See `this guide -`_ -for more detailed instructions. - -Contribute to the documentation -=============================== - -For contributions to the content of the documentation, please refer to the `Introduction Guide -`_. - -To **report a content issue**, **request new content** or **ask a question**, use the `repository's -issue tracker `_ as usual. - -Learn More -========== - -To learn more about Odoo, in addition to the documentation, have a look at `the official eLearning -`_ and `Scale-up, The Business Game -`_ \ No newline at end of file diff --git a/content/applications/finance/accounting/fiscal_localizations/localizations/chile.rst b/content/applications/finance/accounting/fiscal_localizations/localizations/chile.rst index d43761aa9..4bcf3eb75 100644 --- a/content/applications/finance/accounting/fiscal_localizations/localizations/chile.rst +++ b/content/applications/finance/accounting/fiscal_localizations/localizations/chile.rst @@ -7,7 +7,8 @@ Webinars Below you can find videos with a general description of the localization, and how to configure it. -- `VIDEO WEBINAR OF A COMPLETE DEMO `_. +- `VIDEO WEBINAR OF CHILEAN LOCALIZATION: INTRO AND DEMO `_. +- `VIDEO WEBINAR OF DELIVERY GUIDE `_. Introduction ============ @@ -51,6 +52,16 @@ to the basic information, you need to add all the data and elements required for Invoice, the easiest way to configure it is in :menuselection:`Accounting --> Settings --> Chilean Localization`. +.. important:: + All the following configuration and functionality is only available in Odoo if your + company already passed the `Certification process `_ + in the SII - Sistema de Facturación de Mercado, this certification enables you to + generate electronic invoices from your ERP and send them automatically to the SII. + If your company has not passed this certification yet, make sure you communicate this + to your Account Manager as a special process outside Odoo is required in order to complete + this certification. + Fiscal Information ~~~~~~~~~~~~~~~~~~ @@ -102,7 +113,12 @@ is required, proceed to this section and load your file and password. A certificate can be shared between several users. If this is the case leave the user field empty, so all your billing users can use the same one. On the other hand, if you need to restrict the -certificate for a particular user, just define the users in the certificate. +certificate for a particular user, just define the users in the certificate. + +.. note:: + In some cases, depending on the certificate format, it is possible that the field Subject Serial + Number is not loaded automatically. If this is the case, you can manually edit this field by + filling it with the Certificate’s legal representative RUT. Financial Reports ~~~~~~~~~~~~~~~~~ @@ -117,22 +133,13 @@ configuration: Multicurrency ~~~~~~~~~~~~~ -The official currency rate in Chile is provided by the SBIF, you can find the SBIF -synchronization service in the currency rate configuration and you can set a predefined interval -for the rate updates. +The official currency rate in Chile is provided by the Chilean service `mindicador.cl +`_. You can find this service in the currency rate configuration, and you can +set a predefined interval for the rate updates. .. image:: media/Chile05_2.png :align: center - :scale: 25 :alt: Currency reate service for Chile. - -In order to configure your token, you need to enable developer mode and access to -:menuselection:`Settings --> Technical --> System parameters` and search the parameter -``sbif_api_key`` and in the field Value introduce your token provided by the SBIF: - -.. image:: media/Chile05_3.png - :align: center - :alt: Token configuration for currency rate service. Chart of accounts ~~~~~~~~~~~~~~~~~ @@ -161,7 +168,6 @@ are now available on the Partner form. This information is essential for most tr .. image:: media/Chile06.png :align: center - :scale: 25 :alt: Chilean identification types for partners. TaxpayerType @@ -299,7 +305,7 @@ use documents. :alt: Document type configuration on Journal. .. important:: - For the Chilean localization it’s important to define the default Debt and Credit accounts + For the Chilean localization, it is important to define the default Debit and Credit accounts as they are required for one of the debit notes use cases. CAF @@ -316,6 +322,10 @@ that you only need one active CAF per document type and it will be applied on al Please refer to the SII documentation to check the detail on how to acquire the CAF: `SII Timbraje `_. +.. important:: + The CAFs required by the SII are different from Production to Test (Certification mode). Make + sure you have the correct CAF set depending on your environment. + Configuration ~~~~~~~~~~~~~ @@ -499,22 +509,36 @@ Common Errors There are multiple reasons behind a rejection from the SII, but these are some of the common errors you might have and which is the related solution. -- Error: RECHAZO- DTE Sin Comuna Origen. +- Error: ``RECHAZO- DTE Sin Comuna Origen.`` *Hint:* Make sure the Company Address is properly filled including the State and City. -- Error en Monto : - IVA debe declararse. +- Error en Monto: ``- IVA debe declararse.`` *Hint:* The invoice lines should include one VAT tax, make sure you add one on each invoice line. -- Error: Rut No Autorizado a Firmar. +- Error: ``Rut No Autorizado a Firmar.`` *Hint:* The invoice lines should include one VAT tax, make sure you add one on each invoice line. -- Error: Fecha/Número Resolucion Invalido RECHAZO- CAF Vencido : (Firma_DTE[AAAA-MM-DD] - - CAF[AAAA-MM-DD]) > 6 meses. +- Error: ``Fecha/Número Resolucion Invalido RECHAZO- CAF Vencido : (Firma_DTE[AAAA-MM-DD] - + CAF[AAAA-MM-DD]) > 6 meses.`` *Hint:* Try to add a new CAF related to this document as the one you’re using is expired. + +- Error: ``Element '{http://www.sii.cl/SiiDte%7DRutReceptor': This element is not expected. Expected + is ( {http://www.sii.cl/SiiDte%7DRutEnvia ).`` + + *Hint:* Make sure the field Document Type and VAT are set either in the Customer and in the main + company. + +- GLOSA: ``Usuario sin permiso de envio.`` + + *Hint:* This error indicates that most likely, your company has not passed the `Certification + process `_ in + the SII - Sistema de Facturación de Mercado. If this is the case, please contact your Account + Manager or Customer Support as this certification is not part of the the Odoo services, + but we can give you some alternatives. diff --git a/content/applications/finance/accounting/fiscal_localizations/localizations/media/Chile05_3.png b/content/applications/finance/accounting/fiscal_localizations/localizations/media/Chile05_3.png deleted file mode 100644 index e36880671..000000000 Binary files a/content/applications/finance/accounting/fiscal_localizations/localizations/media/Chile05_3.png and /dev/null differ diff --git a/content/contributing/documentation/introduction_guide.rst b/content/contributing/documentation/introduction_guide.rst index 661a4d614..21ec3360b 100644 --- a/content/contributing/documentation/introduction_guide.rst +++ b/content/contributing/documentation/introduction_guide.rst @@ -9,12 +9,6 @@ This introductory guide will help you acquire the tools and knowledge you need t documentation, whether you plan to make a minor content change or document an application from scratch. -.. note:: - This tutorial only concerns the `user documentation - `_ of Odoo. The documentation for `developing - in Odoo `_ is maintained alongside the - source code of Odoo at `github.com/odoo/odoo `_. - .. _contributing/rst-intro: reStructuredText @@ -75,10 +69,10 @@ Use the GitHub interface .. image:: media/edit-on-github.png -#. If you do not have edit rights on the repository (`odoo/documentation-user - `_), you need to fork it by clicking on the - appropriate button. In other terms, you create a copy of the entire repository on your own - account. If you do have the edit rights, skip this step. +#. If you do not have edit rights on the repository (`odoo/documentation + `_), you need to fork it by clicking on the appropriate + button. In other terms, you create a copy of the entire repository on your own account. If you do + have the edit rights, skip this step. .. image:: media/fork-repository.png @@ -111,7 +105,7 @@ Use the GitHub interface .. image:: media/select-branches-base.png #. Double-check your :abbr:`PR (Pull Request)` and, when ready, click again on the **Create pull - request** button to submit your changes for review by a redactor at Odoo. + request** button to submit your changes for review by a content writer at Odoo. .. image:: media/create-pull-request.png @@ -158,15 +152,15 @@ Fetch the sources ~~~~~~~~~~~~~~~~~ As stated earlier, our documentation (in all its versions) is maintained on GitHub at -`github.com/odoo/documentation-user `_. A modification -is made by the mean of a :abbr:`PR (Pull Request)` (:dfn:`proposal of content changes`) to allow for -a review of the changes before updating the sources of the documentation. +`github.com/odoo/documentation `_. A modification is made by +the mean of a :abbr:`PR (Pull Request)` (:dfn:`proposal of content changes`) to allow for a review +of the changes before updating the sources of the documentation. Prior to submitting a modification, you need to make a copy of the sources and download that copy on your machine. -#. Go to `github.com/odoo/documentation-user `_ and - click on the **Fork** button in the top right corner. +#. Go to `github.com/odoo/documentation `_ and click on the + **Fork** button in the top right corner. .. image:: media/fork-button.png @@ -174,8 +168,8 @@ your machine. .. code-block:: console - $ git clone https://github.com/odoo/documentation-user - $ cd documentation-user/ + $ git clone https://github.com/odoo/documentation + $ cd documentation/ .. important:: If you do not have edit rights on the repository owned by Odoo, replace "odoo" with your @@ -190,7 +184,7 @@ your machine. .. code-block:: doscon - $ cd documentation-user/ + $ cd documentation/ $ git config --global core.autocrlf true $ git config commit.template %CD%\commit_template.txt @@ -198,7 +192,7 @@ your machine. .. code-block:: console - $ cd documentation-user/ + $ cd documentation/ $ git config --global core.autocrlf input $ git config commit.template `pwd`/commit_template.txt @@ -221,7 +215,8 @@ Python comes with its own package manager: `pip `_. It allows installing Python dependencies in a single command. -#. Download and install the latest release of **Python 3** on your machine. +#. Download and install the recommended release (`see README file + `_) of **Python 3** on your machine. #. Make sure to have **pip** installed on your machine (on Windows, you can install pip alongside Python). #. Execute the following commands in a terminal to verify that both installations finished @@ -237,7 +232,7 @@ a single command. .. code-block:: console - $ cd documentation-user/ + $ cd documentation/ $ pip3 install -r requirements.txt .. note:: @@ -288,7 +283,7 @@ Execute the following commands in a terminal to... .. code-block:: console - $ cd documentation-user/ + $ cd documentation/ #. Switch to the version 14.0: @@ -337,7 +332,7 @@ To preview your changes in a generated documentation, proceed as follows: .. code-block:: console - $ cd documentation-user/ + $ cd documentation/ $ make clean $ make html @@ -346,7 +341,7 @@ To preview your changes in a generated documentation, proceed as follows: hierarchy of documentation files. #. Fix any error or warning shown in the logs of the build. -#. Open the file :file:`documentation-user/_build/html/index.html` with your default web browser. +#. Open the file :file:`documentation/_build/html/index.html` with your default web browser. .. note:: These steps have for only purpose to show you the final results of your changes. They have no @@ -372,9 +367,8 @@ Submit your changes $ git commit $ git push -u origin 14.0-my_contribution -#. Go to `github.com/odoo/documentation-user/pulls - `_ and click on the **New pull request** - button. +#. Go to `github.com/odoo/documentation/pulls + `_ and click on the **New pull request** button. .. image:: media/new-pull-request.png diff --git a/content/contributing/documentation/rst_guidelines.rst b/content/contributing/documentation/rst_guidelines.rst index 001d8f571..ca55f5d17 100644 --- a/content/contributing/documentation/rst_guidelines.rst +++ b/content/contributing/documentation/rst_guidelines.rst @@ -21,21 +21,24 @@ Given the following source file tree: :: - documentation-user - ├── sales - │ └── products_prices - │ │ └── products - │ │ │ └── import.rst - │ │ │ └── variants.rst - │ │ └── prices.rst + documentation + ├── content + │ └── applications + │ │ └── sales + │ │ │ └── sales + │ │ │ │ └── products_prices + │ │ │ │ │ └── products + │ │ │ │ │ │ └── import.rst + │ │ │ │ │ │ └── variants.rst + │ │ │ │ │ └── prices.rst A reference to the rendered :file:`prices.html` and :file:`variants.html` could be made from :file:`import.rst` as follows: #. Absolute: - - ``https://odoo.com/documentation/user/14.0/sales/products_prices/prices.html`` - - ``https://odoo.com/documentation/user/14.0/sales/products_prices/products/variants.html`` + - ``https://odoo.com/documentation/master/applications/sales/sales/products_prices/prices.html`` + - ``https://odoo.com/documentation/master/applications/sales/sales/products_prices/products/variants.html`` #. Relative: diff --git a/extensions/odoo_theme/layout.html b/extensions/odoo_theme/layout.html index a4cd60526..0c1a31f44 100644 --- a/extensions/odoo_theme/layout.html +++ b/extensions/odoo_theme/layout.html @@ -91,10 +91,6 @@ {%- set main_classes = main_classes + ['o_fullwidth_page'] %} {%- endif %} -
- - {%- include "layout_templates/searchbox.html" %} -
{%- if pagename == master_doc %} {# Custom landing page on the root of the documentation #} diff --git a/extensions/odoo_theme/layout_templates/searchbox.html b/extensions/odoo_theme/layout_templates/searchbox.html index 103b3b8b2..22c7b5f90 100644 --- a/extensions/odoo_theme/layout_templates/searchbox.html +++ b/extensions/odoo_theme/layout_templates/searchbox.html @@ -1,6 +1,5 @@ {# NOTE: the 'searchbox' id is used to hook the "Hide Search Matches" button #} -{# NOTE: currently renamed to '_searchbox' to hide the button until it receives proper styling #} -