OrbbecSDK_ROS2/docs/en/conf.py

# Configuration file for the Sphinx documentation builder.
#
# This file only contains a selection of the most common options. For a full
# list see the documentation:
# https://www.sphinx-doc.org/en/master/usage/configuration.html

# -- Path setup --------------------------------------------------------------

# If extensions (or modules to document with autodoc) are in another directory,
# add these directories to sys.path here. If the directory is relative to the
# documentation root, use os.path.abspath to make it absolute, like shown here.
#
# import os
# import sys
# sys.path.insert(0, os.path.abspath('.'))

import os
import shutil
import sphinx

# Add extension path
import sys
sys.path.append(os.path.join(os.path.dirname(__file__), '..', '_ext'))

import recommonmark
from recommonmark.transform import AutoStructify
from versioning import (
    build_version_context,
    get_asset_path,
    get_conf_root,
    get_content_root,
    get_extra_paths,
    get_static_paths,
    get_templates_paths,
)

# import sphinx_book_theme
# import sphinx_rtd_theme
# import furo


#choice theme default
# html_theme = 'sphinx_book_theme'
html_theme = 'sphinx_rtd_theme'
# html_theme = "furo"

content_root = get_content_root(__file__)
conf_root = get_conf_root(__file__)

# -- Project information -----------------------------------------------------

project = 'OrbbecSDK V2 ROS2 Wrapper'
# project = """
# OrbbecSDK ROS2 documentation
# """
copyright = '2025, ORBBEC INC. www.orbbec.com.'
author = 'ORBBEC INC. www.orbbec.com.'


# -- General configuration ---------------------------------------------------
# The master toctree document.
master_doc = 'index'

# Add any Sphinx extension module names here, as strings. They can be
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
# ones.
extensions = ['recommonmark',
  'sphinx_markdown_tables',
  'sphinx_copybutton',
  'sphinx.ext.autosectionlabel',
  'language_switch',
  'version_switch',
  'section_search',
#   'myst_parser',
]

# The suffix(es) of source filenames.
# You can specify multiple suffix as a list of string:
source_suffix = ['.rst', 'rest', '.md', '.MD']


# Add any paths that contain templates here, relative to this directory.
templates_path = get_templates_paths(conf_root)

# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
#
# This is also used if you do content translation via gettext catalogs.
# Usually you set "language" from the command line for these cases.
# language = 'zh_CN'
language = 'en'

# List of patterns, relative to source directory, that match files and
# directories to ignore when looking for source files.
# This pattern also affects html_static_path and html_extra_path.
exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']


# -- Options for HTML output -------------------------------------------------

# html_logo = "source/_static/orbbec_logo2.png"
# html_favicon = "source/_static/orbbec_logo2.png"

#html_logo = "source/_static/orbbec-light_no_colour.svg"
html_favicon = get_asset_path(conf_root, "source/_static/orbbec_footerlogo_3d_world.svg", "source/_static/orbbec_footerlogo_3d_world.svg")
# html_logo = "source/_static/orbbec_footerlogo_3d_world.svg"
# html_favicon = "source/_static/orbbec_footerlogo_3d_world.svg"

# Add any paths that contain custom static files (such as style sheets) here,
# relative to this directory. They are copied after the builtin static files,
# so a file named "default.css" will overwrite the builtin "default.css".
html_static_path = get_static_paths(conf_root, content_root)

html_extra_path = get_extra_paths(content_root)

html_theme_options = {
    # 'analytics_id': 'G-EVD5Z6G6NH',
    'collapse_navigation': False,
    # 启用导航栏的“粘性”头部，这样导航栏会固定在页面顶部
    'sticky_navigation': True,
    # 配置导航栏的深度，-1 表示显示所有层级的标题
    'navigation_depth': 5,
    # 'show_navbar_depth': 4,
    # 导航栏显示+号
    'collapse_navigation': False,

    # 'analytics_anonymize_ip': False,
    # 'logo_only': False,
    # 'display_version': True,
    # 'prev_next_buttons_location': 'bottom',
    # 'style_external_links': False,
    # 'vcs_pageview_mode': '',
    # 'style_nav_header_background': 'white',
    # # Toc options
    # 'collapse_navigation': True,
    # 'sticky_navigation': True,
    # 'navigation_depth': 5,
    # 'includehidden': True,
    # 'titles_only': False
}






# # 添加自定义的 JavaScript 文件
# html_js_files = ["theme.js"]


# #不需要添加_static目录，加了会不起作用
html_css_files = ["custom.css"]
html_context = {
    "docs_versioning": build_version_context(language),
}

# 与文档无关的其他资源的路径，由于无需构建此文件夹的文件，会自动忽略
# 默认情况下，此路径下的文件会输出到生成的html的根目录
# html_extra_path = ["_extra"]

# 在页面底部显示上一次更新于某某时间
html_last_updated_fmt = "%Y-%m-%d %H:%M:%S"

# 以下为 sphinx_book_theme 的主题配置/定制（sphinx_book_theme）
# html_theme_options = {
#    # ----------------主题内容中导航栏的功能按钮配置--------
#    # 添加存储库链接
#    "repository_url": "https://github.com/Eugene-Forest/NoteBook",
#    # 添加按钮以链接到存储库
#    "use_repository_button": True,
#    # 要添加按钮以打开有关当前页面的问题
#    "use_issues_button": True,
#    # 添加一个按钮来建议编辑
#    "use_edit_page_button": True,
#    # 默认情况下，编辑按钮将指向master分支，但如果您想更改此设置，请使用以下配置
#    "repository_branch": "main",
#    # 默认情况下，编辑按钮将指向存储库的根目录；而我们 sphinx项目的 doc文件其实是在 source 文件夹下的，包括 conf.py 和 index(.rst) 主目录
#    "path_to_docs": "source",
#    # 您可以添加 use_download_button 按钮，允许用户以多种格式下载当前查看的页面
#    "use_download_button": True,

#    # --------------------------右侧辅助栏配置---------
#    # 重命名右侧边栏页内目录名，标题的默认值为Contents。
#    "toc_title": "页内目录",
#    # 通常，右侧边栏页内目录中仅显示页面的第 2 级标题，只有当它们是活动部分的一部分时（在屏幕上滚动时），才会显示更深的级别。可以使用以下配置显示更深的级别，指示应显示多少级别
#    "show_toc_level": 2,

#    # --------------------------左侧边栏配置--------------
#    # logo 配置
#    "logo_only": True,
#    # 控制左侧边栏列表的深度展开,默认值为1，它仅显示文档的顶级部分
#    "show_navbar_depth": 1,
#    # 自定义侧边栏页脚,默认为 Theme by the Executable Book Project
#    # "extra_navbar": "<p>Your HTML</p>",
#    "home_page_in_toc": True,
#    # ------------------------- 单页模式 -----------------
#    # 如果您的文档只有一个页面，并且您不需要左侧导航栏，那么您可以 使用以下配置将其配置sphinx-book-theme 为以单页模式运行
#    # "single_page": True,
# }

# 是否显示页面下方的由sphinx创建, 默认为True
html_show_sphinx = False

copybutton_exclude = '.linenos, .gp, .go'
copybutton_prompt_text = r'>>> |\.\.\. |\$ |# '
copybutton_prompt_is_regexp = True

# Function to copy video files to output directory
def setup(app):
    app.connect('build-finished', copy_videos)

def copy_videos(app, exception):
    if exception is None:  # Only copy if build succeeded
        src_dir = os.path.join(app.srcdir, '_static/videos')
        dest_dir = os.path.join(app.outdir, '_static/videos')
        if os.path.exists(src_dir):
            shutil.copytree(src_dir, dest_dir)

# 20201030
# github_doc_root = 'https://github.com/yourusername/yourrepo/blob/main/'
# def setup(app):
#     app.add_config_value('recommonmark_config', {
#             'url_resolver': lambda url: github_doc_root + url,
#             'auto_toc_tree_section': 'Contents',
#             }, True)
#     app.add_transform(AutoStructify)