mirror of
https://github.com/godotengine/godot-contributing-docs.git
synced 2025-12-31 05:48:13 +03:00
98 lines
2.2 KiB
Python
98 lines
2.2 KiB
Python
# Configuration file for the Sphinx documentation builder.
|
|
|
|
# -- Project information
|
|
|
|
project = 'Contributing to Godot'
|
|
copyright = '2025, Godot Engine Contributors'
|
|
author = 'Godot Engine Contributors'
|
|
|
|
release = '0.1'
|
|
version = '0.1.0'
|
|
|
|
# -- General configuration
|
|
|
|
import sys
|
|
import os
|
|
sys.path.insert(0, os.path.abspath('./_extensions'))
|
|
|
|
extensions = [
|
|
"sphinx_tabs.tabs",
|
|
"notfound.extension",
|
|
"sphinxext.opengraph",
|
|
"sphinx_copybutton",
|
|
"sphinxcontrib.video",
|
|
"area_table",
|
|
]
|
|
|
|
intersphinx_mapping = {
|
|
'python': ('https://docs.python.org/3/', None),
|
|
'sphinx': ('https://www.sphinx-doc.org/en/master/', None),
|
|
}
|
|
intersphinx_disabled_domains = ['std']
|
|
|
|
templates_path = ['_templates']
|
|
|
|
# -- Options for HTML output
|
|
|
|
html_theme = 'sphinx_rtd_theme'
|
|
|
|
html_theme_options = {
|
|
# if we have a html_logo below, this shows /only/ the logo with no title text
|
|
"logo_only": True,
|
|
'flyout_display': 'hidden',
|
|
# Collapse navigation (False makes it tree-like)
|
|
"collapse_navigation": False,
|
|
# Remove version and language picker beneath the title
|
|
"version_selector": False,
|
|
"language_selector": False,
|
|
'display_version': False,
|
|
}
|
|
|
|
html_context = {
|
|
"display_github": True,
|
|
"github_user": "godotengine",
|
|
"github_repo": "godot-contributing-docs",
|
|
"github_version": "main",
|
|
"conf_py_path": "/",
|
|
}
|
|
|
|
html_logo = "img/docs_logo.svg"
|
|
# Set explicitly to avoid the standard title inserting a version.
|
|
html_title = 'Contributing to Godot'
|
|
|
|
# These folders are copied to the documentation's HTML output
|
|
html_static_path = ["_static"]
|
|
|
|
# These paths are either relative to html_static_path
|
|
# or fully qualified paths (e.g. https://...)
|
|
html_css_files = [
|
|
"css/custom.css",
|
|
]
|
|
|
|
html_js_files = [
|
|
"js/custom.js",
|
|
# ('https://plausible.godot.foundation/js/script.file-downloads.outbound-links.js',
|
|
# {'defer': 'defer', 'data-domain': 'godotengine.org'}),
|
|
]
|
|
|
|
# -- Options for EPUB output
|
|
epub_show_urls = 'footnote'
|
|
|
|
|
|
# -- Custom Sphinx roles for UI -------------------------------------------
|
|
|
|
rst_prolog = """
|
|
.. role:: button
|
|
:class: role-button role-ui
|
|
|
|
.. role:: menu
|
|
:class: role-menu role-ui
|
|
|
|
.. role:: inspector
|
|
:class: role-ui
|
|
|
|
.. role:: ui
|
|
:class: role-ui
|
|
|
|
"""
|