Building requirements:
Python 2.7
recent Sphinx (at least Sphinx 1.2)
you can check if Sphinx is installed by trying to launch
$ sphinx-build --version
See the sphinx documentation for local installation instructions.
clone this repository using git, then at the root of the repository, in a 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.
Two custom directives are provided for integration with Odoo's demo system:
demo:fields:: {external_id}
lists all the fields with a tooltip (help
) of the action whoseexternal_id
is provided.- Uses the
form
view by default, can be customized by specifying:view:
. - 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 ahelp
.
.. demo:fields:: account_asset.action_account_asset_asset_list_normal_sale :only: name
will display a table of just the
name
field and itshelp
(or nothing if thename
field does not have ahelp
)- Uses the
< 69B6 div class="highlight highlight-text-restructuredtext notranslate position-relative overflow-auto" dir="auto" data-snippet-clipboard-copy-content=".. demo:action:: account_asset.action_account_asset_asset_list_normal_sale View *Asset Types*">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:.. demo:action:: account_asset.action_account_asset_asset_list_normal_sale View *Asset Types*