No Description
Odoo Translation Bot 7f776367d6 [I18N] Update translation terms from Transifex 4 days ago
.tx [I18N] export 11.0 source terms 7 months ago
_extensions [FIX] _extension: build with sphinx 1.8 7 months ago
_static [IMP] accounting: Updated certificate files 6 months ago
accounting [FIX] accounting: rST markup in mx localisation documentation 3 weeks ago
crm [FIX] crm: Fix typo in acquire_leads.rst 1 year ago
db_management [IMP] db_management: update screenshot to v11 uninstall wizard 7 months ago
discuss [FIX] discuss : typos + wording and wrong link email_servers 9 months ago
ecommerce [ADD] ecommerce: How to get paid with Authorize.Net 1 year ago
expense [IMP] expense: Update doc flow to v11 1 year ago
general [IMP] crm: Whole documentation overhaul 1 year ago
getting_started [IMP] getting_started: Replace old doc 7 months ago
helpdesk [ADD] helpdesk: Record and invoice time for tickets 1 year ago
inventory [FIX] inventory: remove reference to removed page 11 months ago
legal [FIX] most warnings 7 months ago
livechat [FIX] livechat: Display options in bold 1 year ago
locale [I18N] Update translation terms from Transifex 4 days ago
manufacturing [FIX] manufacturing : bill of material fix wrong direction 8 months ago
mobile [ADD] mobile: Setup your Firebase Cloud Messaging 7 months ago
odoo_sh [IMP] odoo_sh: add v12.0 to the list of supported versions 1 month ago
point_of_sale [FIX] point_of_sale: update posbox version 7 months ago
portal [ADD]Documentation: added new section eplaining My Account 11 months ago
project [FIX] project: update link to non-existant section 7 months ago
purchase [Remove] Purchase : Partial Purchase 3 months ago
sales [IMP] sale: Rewrite the 'Invoicing Method' subsection 7 months ago
website [IMP] website: removes obsolete documentation 11 months ago
.gitignore [FIX] a pair of leftover warnings 7 months ago
Makefile [IMP] latex: copy PDF files next to HTML output 2 years ago
README.rst [IMP] README bits 3 years ago
accounting.rst [ADD] accounting: Switzerland Accounting Localization 2 years ago
applications.rst [ADD] mobile: Setup your Firebase Cloud Messaging 7 months ago
business.rst [FIX] mementoes: Fix some terms/computation/links 1 year ago [MERGE] forwardport of 10.0 to 11.0 5 months ago
crm.rst [IMP] crm: Whole documentation overhaul 1 year ago
discuss.rst [ADD] discuss: Get organized by planning activities 1 year ago
ecommerce.rst [ADD] ecommerce: New app section 2 years ago
general.rst [ADD] general: How to allow users to sign in with their Google account 2 years ago
helpdesk.rst [ADD] helpdesk: Record and invoice time for tickets 1 year ago
index.rst [ADD] link to business memento 1 year ago
inventory.rst [IMP] inventory: make the structure consistent with the 'Odoo 9 Documentation' spreadsheet 3 years ago
legal.rst [ADD] legal/terms: add NL translation of enterprise contract 10 months ago
manufacturing.rst [IMP] manufacturing: Restructure pages 1 year ago
point_of_sale.rst [ADD] point_of_sale: belgian fiscal data module documentation 3 years ago
practical.rst [ADD]Documentation: added new section eplaining My Account 11 months ago
project.rst [IMP] Remove empty pages from TOCs 3 years ago
purchase.rst [ADD] purchase: How to setup a minimum stock rule? 3 years ago
sales.rst [ADD] sales: Use quotation templates 11 months ago
website.rst [ADD] website: How to track your traffic through Google Analytics 2 years ago


End-user Odoo documentation

Building requirements:

* Python 2.7
* recent `Sphinx <>`_ (at least Sphinx 1.2)

you can check if Sphinx is installed by trying to launch

.. code-block:: console

$ sphinx-build --version

See `the sphinx documentation <>`_
for local installation instructions.
* `git <>`_
* clone this repository using git, then at the root of the repository,
in a console,

.. code-block:: console

$ make html

this should compile the documentation to HTML, and put the generated
HTML in ``_build/html/index.html``.


For simple edition (typo, just add paragraphs of text without markup),
the Github web interface can be used directly.

For more complex edition, to add images or advanced directives, edit
locally. **Do not commit if there are warnings or errors when building
the documentation** fix them first. rST is fairly sensitive to
whitespace and newlines (especially the lack of newlines). It's a bit
annoying but it's not hard to learn.

Issues can be reported on the repository's bug tracker as usual.

Custom features


Two custom directives are provided for integration with Odoo's demo

* ``demo:fields:: {external_id}`` lists all the fields with a
tooltip (``help``) of the action whose ``external_id`` is provided.

- Uses the ``form`` view by default, can be customized by specifying
- The list of fields displayed can be filtered with ``:only:`` which
should be a list of space-separated fields to display. Note that
this will further reduce the number of fields displayed, it will
not force fields to be listed when they don't have a ``help``.

.. code-block:: restructuredtext

.. demo:fields:: account_asset.action_account_asset_asset_list_normal_sale
:only: name

will display a table of just the ``name`` field and its ``help`` (or
nothing if the ``name`` field does not have a ``help``)

* ``demo:action:: {external_id}`` will create a link button to the
action (specified by external id) on the demo site. The text of the
button should be provided as the directive's content:

.. code-block:: restructuredtext

.. demo:action:: account_asset.action_account_asset_asset_list_normal_sale

View *Asset Types*

Theme Customisations

* The Odoo theme supports *Banner Images* at the top of
documents. These banners are configured by setting a ``:banner:``
field at the top of the document (before the page title), the banner
images will be looked up in the ``_static`` folder at the root of
the project

.. code-block:: restructuredtext

:banner: banners/accounting.png



.. warning::

because banners are wide images and each page may have one, it is
strongly recommended to compress them well. For PNG, use
`pngquant <>`_ (or a UI to it) to reduce the
number of colors in the image followed by regular PNG
recompression tools like `pngcrush
<>`_ and `pngout

Importing existing documents

For documents which already exist in an other format or in Google
docs, it's possible to get a head-start by converting the existing
document using `Pandoc <>`_. The main issue is that
anything but trivial original documents will need fixing up (possibly
lots of it) to get *good* rST (or possibly working rST at all).


pandoc -f docx -t rst path/to/document.docx -o new_doc.rst --extract-media=.

will convert ``path/to/document.docx`` to ``new_doc.rst`` and export
all images to ``./media`` (and link them from the document). While
there are issues with the exported document, it's much more convenient
than manually re-typing the original.