first commit

modules/sale_don_confiao/doc/conf.py

@@ -0,0 +1,84 @@
+import os
+
+base_url = os.environ.get('DOC_BASE_URL')
+if base_url:
+    modules_url = base_url + '/modules-{module}/'
+    trytond_url = base_url + '/server/'
+else:
+    modules_url = (
+        'https://docs.tryton.org/${series}/modules-{module}/')
+    trytond_url = 'https://docs.tryton.org/${series}/server/'
+
+
+def get_info():
+    import configparser
+    import subprocess
+    import sys
+
+    module_dir = os.path.dirname(os.path.dirname(__file__))
+
+    config = configparser.ConfigParser()
+    config.read_file(open(os.path.join(module_dir, 'tryton.cfg')))
+    info = dict(config.items('tryton'))
+
+    result = subprocess.run(
+        [sys.executable, 'setup.py', '--name', '--description'],
+        stdout=subprocess.PIPE, check=True, cwd=module_dir)
+    info['name'], info['description'] = (
+        result.stdout.decode('utf-8').strip().splitlines())
+
+    result = subprocess.run(
+        [sys.executable, 'setup.py', '--version'],
+        stdout=subprocess.PIPE, check=True, cwd=module_dir)
+    version = result.stdout.decode('utf-8').strip()
+    major_version, minor_version, _ = version.split('.', 2)
+    major_version = int(major_version)
+    minor_version = int(minor_version)
+    if minor_version % 2:
+        info['series'] = 'latest'
+    else:
+        info['series'] = '.'.join(version.split('.', 2)[:2])
+
+    for key in {'depends', 'extras_depend'}:
+        info[key] = info.get(key, '').strip().splitlines()
+    info['modules'] = set(info['depends'] + info['extras_depend'])
+    info['modules'] -= {'ir', 'res'}
+
+    return info
+
+
+info = get_info()
+
+html_theme = 'sphinx_book_theme'
+html_title = info['description']
+master_doc = 'index'
+project = info['name']
+release = version = info['series']
+default_role = 'ref'
+highlight_language = 'none'
+exclude_patterns = ['**/*.inc.rst']
+extensions = [
+    'sphinx_copybutton',
+    'sphinx.ext.intersphinx',
+    ]
+intersphinx_mapping = {
+    'trytond': (trytond_url.format(series=version), None),
+    }
+intersphinx_mapping.update({
+        m: (modules_url.format(
+                module=m.replace('_', '-'), series=version), None)
+        for m in info['modules']
+        })
+linkcheck_ignore = [r'/.*', r'https://demo.tryton.org/*']
+
+try:
+    with open(os.path.join(
+                os.path.dirname(__file__),
+                'linkcheck_ignore.json'), 'r') as f:
+        import json
+        linkcheck_ignore.extend(json.load(f))
+        del json
+except FileNotFoundError:
+    pass
+
+del get_info, info, base_url, modules_url, trytond_url

modules/sale_don_confiao/doc/configuration.rst

@@ -0,0 +1,5 @@
+*************
+Configuration
+*************
+
+.. to remove, see https://www.tryton.org/develop/guidelines/documentation#configuration.rst

modules/sale_don_confiao/doc/design.rst

@@ -0,0 +1,5 @@
+******
+Design
+******
+
+.. to remove, see https://www.tryton.org/develop/guidelines/documentation#design.rst

modules/sale_don_confiao/doc/index.rst

@@ -0,0 +1,15 @@
+#######################
+Sale Don Confiao Module
+#######################
+
+.. to remove, see https://www.tryton.org/develop/guidelines/documentation#index.rst
+
+.. toctree::
+   :maxdepth: 2
+
+   setup
+   usage
+   configuration
+   design
+   reference
+   releases

modules/sale_don_confiao/doc/reference.rst

@@ -0,0 +1,5 @@
+*************
+API Reference
+*************
+
+.. to remove, see https://www.tryton.org/develop/guidelines/documentation#reference.rst

modules/sale_don_confiao/doc/releases.rst

@@ -0,0 +1,7 @@
+.. _releases-index:
+
+=============
+Release notes
+=============
+
+.. include:: ../CHANGELOG

modules/sale_don_confiao/doc/requirements-doc.txt

@@ -0,0 +1,2 @@
+sphinx_book_theme
+sphinx_copybutton

modules/sale_don_confiao/doc/setup.rst

@@ -0,0 +1,5 @@
+*****
+Setup
+*****
+
+.. to remove, see https://www.tryton.org/develop/guidelines/documentation#setup.rst

modules/sale_don_confiao/doc/usage.rst

@@ -0,0 +1,5 @@
+*****
+Usage
+*****
+
+.. to remove, see https://www.tryton.org/develop/guidelines/documentation#usage.rst