利用get_html_theme_path()函数自动加载HTML主题路径

get_html_theme_path()函数是在Sphinx文档构建过程中用来获取当前正在使用的HTML主题路径的函数。

使用get_html_theme_path()函数可以方便地自动加载HTML主题路径，无需手动设置路径。

该函数的用法如下：

def get_html_theme_path():
    """Return the HTML theme paths defined in the configuration."""
    app = current_app()
    if app:
        # If the app exists, return the theme path from the configuration
        theme_path = app.builder.theme.dirs[-1]
        return [str(pathlib.Path(theme_path))]
    else:
        # If the app doesn't exist, return an empty list
        return []

该函数首先获取当前的应用程序对象app，然后检查是否存在该对象。如果存在，说明在Sphinx的配置文件中已经设置了HTML主题路径，获取该路径并返回。否则，返回一个空的列表。

以下是一个使用get_html_theme_path()函数的示例：

from sphinx.application import Sphinx

def build_docs():
    conf_dir = '/path/to/sphinx/conf'
    source_dir = '/path/to/sphinx/source'
    build_dir = '/path/to/sphinx/build'

    app = Sphinx(source_dir, conf_dir, build_dir, freshenv=True)
    theme_path = get_html_theme_path()
    print(theme_path)

build_docs()

在上述示例中，首先创建了一个Sphinx应用程序对象app，并传入了配置文件路径、源文件路径和构建目录路径。然后调用get_html_theme_path()函数获取HTML主题路径，并将结果打印输出。

需要注意的是，使用get_html_theme_path()函数前需要先导入Sphinx的Sphinx和current_app类。另外，这只是一个示例，实际使用时需要根据自己的具体情况进行相应的配置。

总结起来，get_html_theme_path()函数是一个非常实用的函数，可以方便地自动获取HTML主题路径，减少手动设置路径的工作量，提高效率。