# HG changeset patch
# User Vincent Hatakeyama <vincent.hatakeyama@xcg-consulting.fr>
# Date 1582909710 -3600
#      Fri Feb 28 18:08:30 2020 +0100
# Node ID cd784cd0d7b81028888703106120da4f4c3b550d
# Parent  371233d121a38a41005b437cca6b695db1713c5f
📚 add more documentation, its translation, build and publish it

diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -1,6 +1,7 @@
 stages:
 - test
 - build
+- push
 
 flake8:
   stage: test
@@ -22,3 +23,25 @@
   script:
   - export DOCKER_IMAGE=xcgd/odoo_scripts CUSTOM_TAG=latest
   - docker-build
+
+build-documentation:
+  stage: build
+  image: python:3
+  artifacts:
+    paths:
+    - doc/_build
+    expire_in: 10m
+  script:
+  - pip3 install -r requirements
+  - cd doc
+  - pip3 install -r requirements
+  - for language in en fr ; do LANGUAGE=$language BUILDDIRSUFFIX=/$(hg identify --debug --branch) make html ; done
+
+push:
+  stage: push
+  image:
+    name: minio/mc:RELEASE.2020-01-13T22-49-03Z
+    entrypoint: ["/bin/busybox"]
+  script:
+    - mc config host add s3 $S3_ENDPOINT_URL $S3_KEY $S3_SECRET --api S3v2
+    - mc cp --recursive doc/_build/html/ s3/xcg-io-doc/odoo_scripts
diff --git a/.hgignore b/.hgignore
--- a/.hgignore
+++ b/.hgignore
@@ -3,3 +3,5 @@
 *~
 *.pyc
 *.egg-info
+*.mo
+doc/_build
diff --git a/HISTORY.rst b/NEWS.rst
rename from HISTORY.rst
rename to NEWS.rst
diff --git a/TODO.rst b/TODO.rst
--- a/TODO.rst
+++ b/TODO.rst
@@ -1,5 +1,9 @@
 To Do
 =====
 
+.. todolist::
+
+.. include:: autotodo
+
 - script to launch test, but from docker, with option to use local modules (as `docker_dev_start.py`)
 
diff --git a/doc/Makefile b/doc/Makefile
new file mode 100644
--- /dev/null
+++ b/doc/Makefile
@@ -0,0 +1,25 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+LANGUAGE ?= en
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)/$(LANGUAGE)$(BUILDDIRSUFFIX)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile gettext
+
+gettext: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)$(BUILDDIRSUFFIX)" $(SPHINXOPTS) $(O)
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -b $@ "$(SOURCEDIR)" "$(BUILDDIR)/$@/$(LANGUAGE)$(BUILDDIRSUFFIX)" -d "$(BUILDDIR)$(BUILDDIRSUFFIX)/doctrees/$(LANGUAGE)" $(SPHINXOPTS) -D language=$(LANGUAGE) $(O)
diff --git a/doc/NEWS.rst b/doc/NEWS.rst
new file mode 120000
--- /dev/null
+++ b/doc/NEWS.rst
@@ -0,0 +1,1 @@
+../NEWS.rst
\ No newline at end of file
diff --git a/doc/README.rst b/doc/README.rst
new file mode 120000
--- /dev/null
+++ b/doc/README.rst
@@ -0,0 +1,1 @@
+../README.rst
\ No newline at end of file
diff --git a/doc/TODO.rst b/doc/TODO.rst
new file mode 120000
--- /dev/null
+++ b/doc/TODO.rst
@@ -0,0 +1,1 @@
+../TODO.rst
\ No newline at end of file
diff --git a/doc/conf.py b/doc/conf.py
new file mode 100644
--- /dev/null
+++ b/doc/conf.py
@@ -0,0 +1,58 @@
+# Configuration file for the Sphinx documentation builder.
+#
+# This file only contains a selection of the most common options. For a full
+# list see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Path setup --------------------------------------------------------------
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#
+# import os
+# import sys
+# sys.path.insert(0, os.path.abspath('.'))
+
+
+# -- Project information -----------------------------------------------------
+
+project = "Odoo Scripts"
+copyright = "2020, XCG Consulting"
+author = "Vincent Hatakeyama"
+
+# The full version, including alpha/beta/rc tags
+release = "3.0"
+
+
+# -- General configuration ---------------------------------------------------
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = ["sphinx.ext.autodoc", "sphinx.ext.todo", "sphinx.ext.viewcode"]
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+locale_dirs = ["locale"]
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This pattern also affects html_static_path and html_extra_path.
+exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+# -- Options for HTML output -------------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+#
+html_theme = "alabaster"
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ["_static"]
diff --git a/doc/index.rst b/doc/index.rst
new file mode 100644
--- /dev/null
+++ b/doc/index.rst
@@ -0,0 +1,19 @@
+Welcome to Odoo Scripts's documentation!
+========================================
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
+   README
+   NEWS
+   TODO
+
+
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`
diff --git a/doc/locale/fr/LC_MESSAGES/NEWS.po b/doc/locale/fr/LC_MESSAGES/NEWS.po
new file mode 100644
--- /dev/null
+++ b/doc/locale/fr/LC_MESSAGES/NEWS.po
@@ -0,0 +1,125 @@
+# Copyright (C) 2020, XCG Consulting
+# This file is distributed under the same license as the Odoo Scripts
+# package.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: Odoo Scripts 3.0\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2020-02-28 16:44+0100\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Generated-By: Babel 2.7.0\n"
+
+#: ../../NEWS.rst:3
+msgid "History"
+msgstr ""
+
+#: ../../NEWS.rst:6
+msgid "3.0"
+msgstr ""
+
+#: ../../NEWS.rst:8
+msgid "Script uses python 3."
+msgstr ""
+
+#: ../../NEWS.rst:11
+msgid "2.20"
+msgstr ""
+
+#: ../../NEWS.rst:13
+msgid ""
+"start locale py3o stack with ``docker_dev_start.py`` (when "
+"report_py3o_fusion_server is in module list)."
+msgstr ""
+
+#: ../../NEWS.rst:17
+msgid "2.19"
+msgstr ""
+
+#: ../../NEWS.rst:19
+msgid "remove references to ``addon_dirs``, use ``module`` instead."
+msgstr ""
+
+#: ../../NEWS.rst:22
+msgid "2.11"
+msgstr ""
+
+#: ../../NEWS.rst:24
+msgid "create_documentation: Fix paths of per-module documentation."
+msgstr ""
+
+#: ../../NEWS.rst:26
+msgid "Support Odoo 10 (\"odoo-bin\" instead of \"openerp-server\")."
+msgstr ""
+
+#: ../../NEWS.rst:29
+msgid "2.10"
+msgstr ""
+
+#: ../../NEWS.rst:31
+msgid "Add script to duplicate code on another repository."
+msgstr ""
+
+#: ../../NEWS.rst:34
+msgid "2.9"
+msgstr ""
+
+#: ../../NEWS.rst:36
+msgid ""
+"conf2reST.py: Prefer anonymous links to avoid conflicts when the same "
+"version is shared by 2 repos (as the \"link target\" system would then be"
+" in use)."
+msgstr ""
+
+#: ../../NEWS.rst:40
+msgid "2.8"
+msgstr ""
+
+#: ../../NEWS.rst:42
+msgid "add script to create archive of source"
+msgstr ""
+
+#: ../../NEWS.rst:43
+msgid ""
+"create_documentation: only create documentation for used modules, reusing"
+" the setup.cfg key defined for create_archive if it is present"
+msgstr ""
+
+#: ../../NEWS.rst:44
+msgid ""
+"docker_build: copy modules (defined in setup.cfg in superproject to a new"
+" directory for docker to do)"
+msgstr ""
+
+#: ../../NEWS.rst:47
+msgid "2.7"
+msgstr ""
+
+#: ../../NEWS.rst:49
+msgid "Add conf2reST.py script."
+msgstr ""
+
+#: ../../NEWS.rst:52
+msgid "2.0"
+msgstr ""
+
+#: ../../NEWS.rst:54
+msgid ""
+"Read module_list, module_list_test, addon_dirs and odoo_type from "
+"setup.cfg instead of directories"
+msgstr ""
+
+#: ../../NEWS.rst:57
+msgid "1.0"
+msgstr ""
+
+#: ../../NEWS.rst:59
+msgid "Initial version"
+msgstr ""
+
diff --git a/doc/locale/fr/LC_MESSAGES/README.po b/doc/locale/fr/LC_MESSAGES/README.po
new file mode 100644
--- /dev/null
+++ b/doc/locale/fr/LC_MESSAGES/README.po
@@ -0,0 +1,413 @@
+# Copyright (C) 2020, XCG Consulting
+# This file is distributed under the same license as the Odoo Scripts
+# package.
+# Vincent Hatakeyama <vincent.hatakeyama@xcg-consulting.fr>, 2020.
+msgid ""
+msgstr ""
+"Project-Id-Version: Odoo Scripts 3.0\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2020-02-28 16:44+0100\n"
+"PO-Revision-Date: 2020-02-28 17:21+0200\n"
+"Last-Translator: Vincent Hatakeyama <vincent.hatakeyama@xcg-consulting.fr>\n"
+"Language-Team: XCG Consulting\n"
+"Language: fr\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n > 1);\n"
+"X-Generator: Virtaal 0.7.1\n"
+"Generated-By: Babel 2.7.0\n"
+
+#: ../../README.rst:3
+msgid "Odoo Scripts"
+msgstr "Scripts Odoo"
+
+#: ../../README.rst:6
+msgid "Shell scripts"
+msgstr ""
+
+#: ../../README.rst:8
+msgid "Those scripts are not installed when installing this python module."
+msgstr ""
+
+#: ../../README.rst:11
+msgid "start"
+msgstr "start"
+
+#: ../../README.rst:13
+msgid "This script can be used to start odoo."
+msgstr ""
+
+#: ../../README.rst:15
+msgid ""
+"It need to be run on a machine with all the odoo requirements installed, "
+"either system-wide or in a virtual environment (which need to be "
+"activated)."
+msgstr ""
+
+#: ../../README.rst:17
+msgid ""
+"Its arguments are forwarded to the Odoo executable (``odoo-bin`` / "
+"``openerp-server``)."
+msgstr ""
+
+#: ../../README.rst:19 ../../README.rst:46 ../../README.rst:63
+#: ../../README.rst:103 ../../README.rst:124
+msgid ""
+"It expect the configuration file (`setup.cfg`_) to have the following "
+"keys:"
+msgstr ""
+
+#: ../../README.rst:21 ../../README.rst:66
+msgid ""
+"``odoo_type``: type of odoo (bzr, odoo7, odoo8 or odoo10) [default to "
+"odoo8]"
+msgstr ""
+
+#: ../../README.rst:22 ../../README.rst:105
+msgid ""
+"``modules``: list of directories and files to include (also used by "
+"another script)"
+msgstr ""
+
+#: ../../README.rst:26
+msgid "do_tests"
+msgstr "do_tests"
+
+#: ../../README.rst:28
+msgid ""
+"This script create a database, install modules and run the tests on those"
+" modules and print the result."
+msgstr ""
+
+#: ../../README.rst:30 ../../README.rst:56
+msgid ""
+"It need to be run on a machine with all the odoo requirements installed, "
+"either system-wide or in a virtual environment (which need to be "
+"activated). A postgresql server is also needed."
+msgstr ""
+
+#: ../../README.rst:33
+msgid "It takes three optional arguments (those are positional arguments):"
+msgstr ""
+
+#: ../../README.rst:35
+msgid "the host of the postgresql server,"
+msgstr ""
+
+#: ../../README.rst:36
+msgid ""
+"the user for this base (which need database creation rights). If a user "
+"is provided, you will need to have a .pgpass with the password if it is "
+"not the one in ``conf/dev/odoo.conf``."
+msgstr ""
+
+#: ../../README.rst:37
+msgid "the name of the database to use"
+msgstr ""
+
+#: ../../README.rst:39
+msgid "Those environment variables are used:"
+msgstr ""
+
+#: ../../README.rst:42
+msgid "ODOO_NO_DROP"
+msgstr ""
+
+#: ../../README.rst:42
+msgid "set to reuse an existing database."
+msgstr ""
+
+#: ../../README.rst:44
+msgid "The script call `run_tests`_."
+msgstr ""
+
+#: ../../README.rst:48
+msgid ""
+"``module_list``: list (separated by white space) of odoo modules to "
+"install on the database (default to empty list)"
+msgstr ""
+
+#: ../../README.rst:49
+msgid ""
+"``unaccent``: boolean to indicate if unaccent is to be installed on the "
+"database (default to True)"
+msgstr ""
+
+#: ../../README.rst:52
+msgid "run_tests"
+msgstr ""
+
+#: ../../README.rst:54
+msgid "This script run the tests on a database."
+msgstr ""
+
+#: ../../README.rst:59
+msgid "The name of the database is the same as do_tests or can be provided."
+msgstr ""
+
+#: ../../README.rst:61
+msgid "The script call `start`_."
+msgstr ""
+
+#: ../../README.rst:65
+msgid ""
+"``module_list_tests``: list (separated by white space) of odoo modules to"
+" run tests for on the database (default to empty list)"
+msgstr ""
+
+#: ../../README.rst:69
+msgid "create_archive"
+msgstr ""
+
+#: ../../README.rst:71
+msgid "zsh script to create a tar.xz file containing all sources."
+msgstr ""
+
+#: ../../README.rst:74
+msgid "isort"
+msgstr ""
+
+#: ../../README.rst:76
+msgid ""
+"Run dockerized isort on current directory. This uses a configuration file"
+" that is adapted to OCA guidelines for imports."
+msgstr ""
+
+#: ../../README.rst:78
+msgid "For help:"
+msgstr ""
+
+#: ../../README.rst:85
+msgid "Scripts"
+msgstr ""
+
+#: ../../README.rst:87
+msgid ""
+"Those scripts are available when installing the package, and can also be "
+"run directly."
+msgstr ""
+
+#: ../../README.rst:89
+msgid "The recommend way to install this module is to run ``pip3 install -e .``."
+msgstr ""
+
+#: ../../README.rst:92
+msgid "conf2reST.py"
+msgstr ""
+
+#: ../../README.rst:94
+msgid ""
+"This script is used to produce a reST file from setup.cfg, the Dockerfile"
+" and the ``.hgconf``/``nest.yaml`` file."
+msgstr ""
+
+#: ../../README.rst:96
+msgid ""
+"When the package is installed, the executable for this script is "
+"``conf2reST``."
+msgstr ""
+
+#: ../../README.rst:99
+msgid "update_duplicate_sources"
+msgstr ""
+
+#: ../../README.rst:101
+msgid ""
+"This script will update a metaproject that only contain the sources of "
+"the one it is launched from."
+msgstr ""
+
+#: ../../README.rst:106
+msgid ""
+"``dependencies``: list of directories and files to include (also used by "
+"another script)"
+msgstr ""
+
+#: ../../README.rst:107
+msgid ""
+"``other_sources``: list of directories and files to include (only used by"
+" this script, used for README, ReleaseNotes, script directories, etc.)"
+msgstr ""
+
+#: ../../README.rst:109
+msgid "No change are made to the name of the directories/files included."
+msgstr ""
+
+#: ../../README.rst:112
+msgid "docker_dev_start.py"
+msgstr ""
+
+#: ../../README.rst:114
+msgid ""
+"This script can be used to start an odoo from a docker but with the local"
+" addons modules mounted."
+msgstr ""
+
+#: ../../README.rst:116
+msgid "Using it avoids having to create a virtual env for every project."
+msgstr ""
+
+#: ../../README.rst:118
+msgid "Before you use this script, you need to install these packages:"
+msgstr ""
+
+#: ../../README.rst:126
+msgid "``modules``: list of directories and files to include"
+msgstr ""
+
+#: ../../README.rst:127
+msgid "…"
+msgstr ""
+
+#: ../../README.rst:129
+msgid ""
+"When the package is installed, the executable for this script is "
+"``docker_dev_start``."
+msgstr ""
+
+#: ../../README.rst:132
+msgid "docker_build.py"
+msgstr ""
+
+#: ../../README.rst:134
+msgid "This script builds a docker image of the project."
+msgstr ""
+
+#: ../../README.rst:136
+msgid "It uses the super project’s `setup.cfg`_ and ``Dockerfile``."
+msgstr ""
+
+#: ../../README.rst:138
+msgid ""
+"When the package is installed, the executable for this script is "
+"``docker_build``."
+msgstr ""
+
+#: ../../README.rst:141
+msgid "do_tests.py"
+msgstr ""
+
+#: ../../README.rst:143
+msgid ""
+"This scripts launches the tests, but with more options than `do_tests`_. "
+"It uses docker by default, similar to `docker_dev_start.py`_."
+msgstr ""
+
+#: ../../README.rst:145
+msgid ""
+"When the package is installed, the executable for this script is "
+"``do_tests``."
+msgstr ""
+
+#: ../../README.rst:149
+msgid "import_base_import and import_jsonrpc"
+msgstr "import_base_import et import_jsonrpc"
+
+#: ../../README.rst:151
+msgid ""
+"Import CSV files into an odoo. Can be run directly or with the image "
+"build from ``Dockerfile`` (xcgd/odoo_scripts)."
+msgstr ""
+
+#: ../../README.rst:153
+msgid "import_base_import uses odoo base_import module to import the CSV file."
+msgstr ""
+
+#: ../../README.rst:155
+msgid ""
+"import_jsonrpc uses jsonrpc calls to import the files. The format is the "
+"same as the one used with the import module, with a couple more "
+"restrictions:"
+msgstr ""
+
+#: ../../README.rst:158
+msgid ""
+"selection fields must use the technical value, not the displayed value or"
+" one of its translation."
+msgstr ""
+
+#: ../../README.rst:159
+msgid ""
+"many2one and many2many fields must use the xmlid of the field they are "
+"referencing, with the column name in the form field_name/id or "
+"field_name:id."
+msgstr ""
+
+#: ../../README.rst:162
+msgid "setup.cfg"
+msgstr ""
+
+#: ../../README.rst:164
+msgid ""
+"The scripts expects configuration in the odoo_scripts section of "
+"``setup.cfg``. This file is in the super project, not the one in "
+"``odoo_scripts``."
+msgstr ""
+
+#: ../../README.rst:166
+msgid "Configuration keys:"
+msgstr ""
+
+#: ../../README.rst:168
+msgid "modules"
+msgstr ""
+
+#: ../../README.rst:169
+msgid ""
+"list of modules to install (relative to project directory), those modules"
+" are the ones copied in the Dockerfile"
+msgstr ""
+
+#: ../../README.rst:170
+msgid "odoo_type"
+msgstr ""
+
+#: ../../README.rst:171
+msgid "type of odoo (odoo7, odoo8, odoo10, odoo11)"
+msgstr ""
+
+#: ../../README.rst:172
+msgid "pg.extensions"
+msgstr ""
+
+#: ../../README.rst:173
+msgid ""
+"postgresql extensions to install (unaccent is added automatically "
+"depending on odoo configuration)"
+msgstr ""
+
+#: ../../README.rst:175
+msgid "load-language"
+msgstr ""
+
+#: ../../README.rst:175
+msgid "languages to install into a newly created database"
+msgstr ""
+
+#: ../../README.rst:178
+msgid "Completion files for zsh"
+msgstr ""
+
+#: ../../README.rst:180
+msgid "Your ``.zshrc`` should contain a line like this::"
+msgstr ""
+
+#: ../../README.rst:184
+msgid "Create completion directory::"
+msgstr ""
+
+#: ../../README.rst:188
+msgid "Clone::"
+msgstr ""
+
+#: ../../README.rst:195
+msgid ""
+"Generate completion file for python scripts (from the superproject for "
+"the scripts that need to be run from there, and with the required "
+"requirements too)::"
+msgstr ""
+
+#: ../../README.rst:204
+msgid "Alternatives: genzshcomp"
+msgstr "Alternatives : genzshcomp"
diff --git a/doc/locale/fr/LC_MESSAGES/TODO.po b/doc/locale/fr/LC_MESSAGES/TODO.po
new file mode 100644
--- /dev/null
+++ b/doc/locale/fr/LC_MESSAGES/TODO.po
@@ -0,0 +1,29 @@
+# Copyright (C) 2020, XCG Consulting
+# This file is distributed under the same license as the Odoo Scripts
+# package.
+# Vincent Hatakeyama <vincent.hatakeyama@xcg-consulting.fr>, 2020.
+msgid ""
+msgstr ""
+"Project-Id-Version: Odoo Scripts 3.0\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2020-02-28 16:44+0100\n"
+"PO-Revision-Date: 2020-02-28 16:46+0200\n"
+"Last-Translator: Vincent Hatakeyama <vincent.hatakeyama@xcg-consulting.fr>\n"
+"Language-Team: XCG Consulting\n"
+"Language: fr\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n > 1);\n"
+"X-Generator: Virtaal 0.7.1\n"
+"Generated-By: Babel 2.7.0\n"
+
+#: ../../TODO.rst:2
+msgid "To Do"
+msgstr "À faire"
+
+#: ../../TODO.rst:8
+msgid ""
+"script to launch test, but from docker, with option to use local modules "
+"(as `docker_dev_start.py`)"
+msgstr ""
diff --git a/doc/locale/fr/LC_MESSAGES/index.po b/doc/locale/fr/LC_MESSAGES/index.po
new file mode 100644
--- /dev/null
+++ b/doc/locale/fr/LC_MESSAGES/index.po
@@ -0,0 +1,43 @@
+# Copyright (C) 2020, XCG Consulting
+# This file is distributed under the same license as the Odoo Scripts
+# package.
+# Vincent Hatakeyama <vincent.hatakeyama@xcg-consulting.fr>, 2020.
+msgid ""
+msgstr ""
+"Project-Id-Version: Odoo Scripts 3.0\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2020-02-28 16:44+0100\n"
+"PO-Revision-Date: 2020-02-28 16:46+0200\n"
+"Last-Translator: Vincent Hatakeyama <vincent.hatakeyama@xcg-consulting.fr>\n"
+"Language-Team: XCG Consulting\n"
+"Language: fr\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n > 1);\n"
+"X-Generator: Virtaal 0.7.1\n"
+"Generated-By: Babel 2.7.0\n"
+
+#: ../../index.rst:7
+msgid "Welcome to Odoo Scripts's documentation!"
+msgstr "Bienvenue dans la documentation des scripts Odoo !"
+
+#: ../../index.rst:9
+msgid "Contents:"
+msgstr "Contenus :"
+
+#: ../../index.rst:20
+msgid "Indices and tables"
+msgstr "Indices et tables"
+
+#: ../../index.rst:22
+msgid ":ref:`genindex`"
+msgstr ""
+
+#: ../../index.rst:23
+msgid ":ref:`modindex`"
+msgstr ""
+
+#: ../../index.rst:24
+msgid ":ref:`search`"
+msgstr ""
diff --git a/doc/requirements b/doc/requirements
new file mode 100644
--- /dev/null
+++ b/doc/requirements
@@ -0,0 +1,3 @@
+sphinx
+# used when updating translation files
+sphinx-intl