diff --git a/README.md b/README.md new file mode 100644 index 000000000..0718a6344 --- /dev/null +++ b/README.md @@ -0,0 +1,50 @@ +# Odoo documentation + +## Build the documentation locally + +### Requirements + +- [Git](https://www.odoo.com/documentation/13.0/contributing/documentation/introduction_guide.html#install-git) +- [Python 3.6, 3.7, or 3.8](https://www.odoo.com/documentation/13.0/contributing/documentation/introduction_guide.html#python) +- Python dependencies listed in the file [`requirements.txt`](https://github.com/odoo/documentation/tree/13.0/requirements.txt). +- [Make](https://www.odoo.com/documentation/13.0/contributing/documentation/introduction_guide.html#make) +- A local copy of the [odoo/odoo repository in 13.0](https://github.com/odoo/odoo/tree/13.0) (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/13.0/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/13.0/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/contributing/documentation/introduction_guide.rst b/content/contributing/documentation/introduction_guide.rst index 68db8c0bd..857401493 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 13.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 13.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 16a835eda..8a9c8af02 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/13.0/sales/products_prices/prices.html`` - - ``https://odoo.com/documentation/user/13.0/sales/products_prices/products/variants.html`` + - ``https://odoo.com/documentation/13.0/applications/sales/sales/products_prices/prices.html`` + - ``https://odoo.com/documentation/13.0/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 #} -