92 lines
2.8 KiB
Python
92 lines
2.8 KiB
Python
# Configuration file for the Sphinx documentation builder.
|
|
#
|
|
# For the full list of built-in configuration values, see the documentation:
|
|
# https://www.sphinx-doc.org/en/master/usage/configuration.html
|
|
|
|
import os
|
|
|
|
# -- Project information -----------------------------------------------------
|
|
# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
|
|
|
|
project = 'two'
|
|
copyright = '2026, Nicolas Boufidjeline'
|
|
author = 'Nicolas Boufidjeline'
|
|
version = '0.1'
|
|
release = '0.1.0'
|
|
|
|
|
|
# -- General configuration ---------------------------------------------------
|
|
|
|
templates_path = ['_templates']
|
|
exclude_patterns = ['_build', 'README.md', 'requirements.txt', 'schemas']
|
|
|
|
language = 'fr'
|
|
|
|
extensions = [
|
|
'myst_parser',
|
|
'sphinxcontrib.mermaid',
|
|
'sphinxcontrib.openapi',
|
|
]
|
|
|
|
myst_enable_extensions = [
|
|
'colon_fence',
|
|
'deflist',
|
|
]
|
|
|
|
source_suffix = {
|
|
'.rst': 'restructuredtext',
|
|
'.md': 'markdown',
|
|
}
|
|
|
|
# -- Options for HTML output -------------------------------------------------
|
|
# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
|
|
|
|
html_theme = 'sphinx_book_theme'
|
|
html_static_path = []
|
|
html_show_sphinx = False
|
|
|
|
# Le thème publie le source de chaque page dans _sources/ et l'expose derrière
|
|
# un bouton de téléchargement. Les deux vont ensemble : couper la copie sans
|
|
# couper le bouton laisserait un lien mort vers un répertoire vide.
|
|
html_copy_source = False
|
|
html_show_sourcelink = False
|
|
|
|
# Le sélecteur de version est piloté par le workflow de publication : hors CI
|
|
# la variable est absente, le sélecteur n'apparaît pas, et le build ne dépend
|
|
# d'aucun réseau.
|
|
_docs_version = os.environ.get('DOCS_VERSION')
|
|
|
|
html_theme_options = {
|
|
'home_page_in_toc': True,
|
|
'use_download_button': False,
|
|
'icon_links': [
|
|
{
|
|
'name': 'Dépôt',
|
|
'url': 'https://git.g3e.fr/syonad/two',
|
|
'icon': 'fa-solid fa-code-branch',
|
|
'type': 'fontawesome',
|
|
},
|
|
],
|
|
}
|
|
|
|
if _docs_version:
|
|
html_theme_options['switcher'] = {
|
|
# Chemin relatif volontairement : le thème le résout contre la racine
|
|
# de la version courante, donc toujours dans la même origine que la
|
|
# page. Une URL absolue ferait échouer la requête en CORS dès que le
|
|
# site est consulté depuis un autre hôte — un serveur de test local,
|
|
# par exemple.
|
|
'json_url': '../switcher.json',
|
|
'version_match': _docs_version,
|
|
}
|
|
# Le thème book vide navbar_start et place tout dans la barre latérale : le
|
|
# sélecteur doit donc y être inséré explicitement, à côté du logo.
|
|
html_sidebars = {
|
|
'**': [
|
|
'navbar-logo.html',
|
|
'icon-links.html',
|
|
'version-switcher.html',
|
|
'search-button-field.html',
|
|
'sbt-sidebar-nav.html',
|
|
]
|
|
}
|