1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76
|
# This file is part of Tryton. The COPYRIGHT file at the top level of
# this repository contains the full copyright notices and license terms.
import os
base_url = os.environ.get('DOC_BASE_URL')
if base_url:
modules_url = base_url + '/modules-{module}/'
tryton_url = base_url + '/client-desktop/'
proteus_url = base_url + '/client-library/'
else:
modules_url = 'https://docs.tryton.org/${series}/modules-{module}/'
tryton_url = 'https://docs.tryton.org/${series}/client-desktop/'
proteus_url = 'https://docs.tryton.org/${series}/client-library/'
def get_info():
import subprocess
import sys
module_dir = os.path.dirname(os.path.dirname(__file__))
info = dict()
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'
info['branch'] = 'branch/default'
else:
info['series'] = '.'.join(version.split('.', 2)[:2])
info['branch'] = 'branch/' + info['series']
return info
info = get_info()
html_theme = 'sphinx_book_theme'
html_theme_options = {
'repository_provider': 'gitlab',
'repository_url': 'https://code.tryton.org/tryton',
'repository_branch': info['branch'],
'use_source_button': True,
'use_edit_page_button': True,
'use_repository_button': True,
'use_download_button': False,
'path_to_docs': 'trytond/doc',
}
html_title = info['description']
master_doc = 'index'
project = info['name']
release = version = info['series']
default_role = 'ref'
highlight_language = 'none'
extensions = [
'sphinx_copybutton',
'sphinx.ext.intersphinx',
]
intersphinx_mapping = {
'python': ('https://docs.python.org/', None),
}
linkcheck_ignore = [r'/.*', r'https://demo.tryton.org/*']
del get_info, info, base_url, modules_url, tryton_url, proteus_url
|