# 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 # -- Project information ----------------------------------------------------- # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information import os import sys from pathlib import Path from typing import Any, Dict import pydata_sphinx_theme from sphinx.application import Sphinx sys.path.append(str(Path(".").resolve())) project = 'gsoc.beagleboard.io' copyright = '2024, BeagleBoard.org' author = 'BeagleBoard.org' # -- General configuration --------------------------------------------------- # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration extensions = [ "sphinx_design", "sphinxcontrib.youtube", ] templates_path = ['_templates'] exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store', 'env', ".venv"] pages_url = "https://gsoc.beagleboard.io" pages_slug = "latest" gitlab_user = "gsoc" gitlab_version = "main" gitlab_url = "https://openbeagle.org" gitlab_repo = "gsoc.beagleboard.io" docs_url = "https://gsoc.beagleboard.io/latest/" # -- Options for HTML output ------------------------------------------------- # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output html_theme = 'pydata_sphinx_theme' html_static_path = ['_static'] html_logo = "_static/images/logo.svg" html_favicon = "_static/images/boris.svg" html_sourcelink_suffix = "" html_last_updated_fmt = "" html_theme_path = [pydata_sphinx_theme.Path()] html_baseurl = "gsoc.beagleboard.io" html_css_files = [ 'css/custom.css', ] html_theme_options = { "header_links_before_dropdown": 4, "icon_links": [ { "name": "OpenBeagle", "url": "https://openbeagle.org/", "icon": "fa-brands fa-gitlab", "attributes": {"target": "_blank"}, }, { "name": "Docs", "url": "https://docs.beagleboard.org/", "icon": "fa-solid fa-book", "attributes": {"target": "_blank"}, }, { "name": "Discord", "url": "https://discord.com/invite/e58xECGWfR", "icon": "fa-brands fa-discord", "attributes": {"target": "_blank"}, }, { "name": "Fourm", "url": "https://forum.beagleboard.org/", "icon": "fa-brands fa-discourse", "attributes": {"target": "_blank"}, }, { "name": "BeagleBoard.org", "url": "https://beagleboard.org", "icon": "_static/images/boris.svg", "type": "local", "attributes": {"target": "_blank"}, }, { "name": "GSoC", "url": "https://summerofcode.withgoogle.com/", "icon": "_static/images/gsoc.svg", "type": "local", "attributes": {"target": "_blank"}, }, ], "use_edit_page_button": True, "show_toc_level": 1, "navbar_align": "right", "show_nav_level": 2, "announcement": "Welcome to new site for BeagleBoard.org GSoC 2024 projects!", # "show_version_warning_banner": True, "navbar_center": ["navbar-nav"], "navbar_start": ["navbar-logo"], "navbar_end": ["theme-switcher", "navbar-icon-links"], # "navbar_persistent": ["search-button"], "footer_start": ["copyright"], "footer_end": ["last-updated"], # "content_footer_items": ["last-updated"], } html_context = { "display_gitlab": True, "gitlab_url": gitlab_url, "gitlab_user": gitlab_user, "gitlab_repo": gitlab_repo, "gitlab_version": "main", "doc_path": "", "conf_py_path": "", "show_license": True, "pages_url": pages_url, "pages_slug": pages_slug, "docs_url": docs_url, }