# 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, sys if sys.version_info >= (3, 11): import tomllib else: import tomli as tomllib DATA = None PYPROJECT = os.path.join("..", "..", "Cargo.toml") with open(PYPROJECT, "r", encoding="utf8") as f: pyproject = f.read() DATA = tomllib.loads(pyproject) PROJECT_VERSION = DATA["package"]["version"] PROJECT_NAME = DATA["package"]["name"] AUTHOR_TABLE = DATA["package"]["authors"] AUTHORS = ",".join([f"{aut}" for aut in AUTHOR_TABLE]) # -- Project information ----------------------------------------------------- # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information project = "HydroRoll" # PROJECT_NAME release = PROJECT_VERSION # "latest" copyright = "2023-PRESENT, HydroRoll-Team." author = AUTHORS # "Hsiang Nianian" # html_title = "HydroRoll Docs" # -- General configuration --------------------------------------------------- # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration extensions = [ "sphinx.ext.autodoc", "sphinx.ext.viewcode", "sphinx.ext.todo", "sphinx.ext.napoleon", "sphinx.ext.autosummary", "sphinx.ext.extlinks", "myst_parser", ] templates_path = ["_templates"] exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"] extlinks = { "issue": ("https://github.com/HydroRoll-Team/HydroRoll/%s", "issue %s"), "doc": ("https://docs.hydroroll.team/zh_CN/latest/%s", "pages/%s"), } source_suffix = { ".rst": "restructuredtext", ".txt": "markdown", ".md": "markdown", } locale_dirs = ["../locales/"] # path is example but recommended. gettext_compact = False # optional. gettext_uuid = True # optional. # -- Options for HTML output ------------------------------------------------- # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output html_theme = "furo" html_static_path = ["../_static"] _html_logo = ( "https://cdn.jsdelivr.net/gh/HydroRoll-Team/HydroRoll@main/docs/_static/logo.png" ) # html_logo = _html_logo html_favicon = _html_logo html_css_files = [ "https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/fontawesome.min.css", "https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/brands.min.css", ] html_copy_source = True html_show_sourcelink = True html_theme_options = { "announcement": "documentation is still under construction now, welcome any contribution!", "source_repository": "https://github.com/HydroRoll-Team/HydroRoll/", "source_branch": "main", "source_directory": "docs/source/", # Toc options # "collapse_navigation": True, # "sticky_navigation": False, # "navigation_depth": 1, # "includehidden": False, # "titles_only": True, "footer_icons": [ { "name": "GitHub", "url": "https://github.com/HydroRoll-Team/HydroRoll/", "html": "", "class": "fa-brands fa-github", }, { "name": "Pypi", "url": "https://pypi.org/project/hydro_roll/", "html": "", "class": "fa-brands fa-python", }, ], } # html_sidebars = { # "**": [ # "sidebar/scroll-start.html", # "sidebar/brand.html", # "sidebar/search.html", # "sidebar/navigation.html", # "sidebar/ethical-ads.html", # "sidebar/scroll-end.html", # ] # }