Я пытаюсь настроить ./docs/conf.py, чтобы упростить управление документацией, поэтому я выполнил следующую команду:

sphinx-apidoc -F -o "./docs" --templatedir=./templates "."

Я разместил следующий файл conf.py_t в каталоге ./templates, но опция --templatedir не работает так, как ожидалось. (Я проверил сгенерированный файл ./docs/conf.py, и он отличается от шаблонного файла в ./templates/conf.py_t. Конечно, я каждый раз удаляю каталог ./docs перед выполнением этой команды).

Не могли бы вы помочь мне понять, как решить эту проблему?
Спасибо за сотрудничество.

Вот детали проблемы.
Спасибо за вашу помощь.

• ОС: Windows

• Оболочка: PowerShell

• Среда Python:

  • Miniconda: 24.1.2
  • Python: 3.12.2

• Версия Sphinx: 8.1.3

• результат выполнения

Создание файла C:\Users\username\Downloads\test\docs\conf.py.
Создание файла C:\Users\username\Downloads\test\docs\index.rst.
Создание файла C:\Users\username\Downloads\test\docs\Makefile.
Создание файла C:\Users\username\Downloads\test\docs\make.bat.

это означает, что каждый файл создается без сообщения об ошибке. (языковые настройки — японский)

Содержимое файла conf.py_t

#hogehoge
#hogehoge
#hogehoge
#hogehoge
#hogehoge
#hogehoge
#hogehoge
# Файл конфигурации для сборщика документации Sphinx.
# 
# Этот файл содержит только выбор самых распространенных опций. Полный
# список смотрите в документации:
# https://www.sphinx-doc.org/en/master/usage/configuration.html

import os
import sys
sys.path.insert(0, os.path.abspath('../'))

# -- Информация о проекте -----------------------------------------------------

project="{{ project_name }}"
copyright="{{ copyright_year }}, {{ author }}"
author="{{ author }}"

# Полная версия, включая тэги alpha/beta/rc
release="{{ version }}"

# -- Общая конфигурация ---------------------------------------------------

extensions = [
    'sphinx.ext.autodoc',
    'sphinx.ext.napoleon',
    'sphinx.ext.viewcode'
]

templates_path = ['_templates']
exclude_patterns = []

# -- Опции для HTML-вывода ---------------------------------------------------

html_theme="alabaster"
html_static_path = ['_static']

Содержимое сгенерированного файла ./docs/conf.py

# Файл конфигурации для сборщика документации Sphinx.
#
# Полный список встроенных значений конфигурации см. в документации:
# https://www.sphinx-doc.org/en/master/usage/configuration.html

# -- Информация о проекте -----------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information

project="test"
copyright="2024, Author"
author="Author"

# -- Общая конфигурация ---------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration

extensions = [
    'sphinx.ext.autodoc',
    'sphinx.ext.viewcode',
    'sphinx.ext.todo',
]

templates_path = ['_templates']
exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']

language="en"

# -- Опции для HTML-вывода -------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output

html_theme="alabaster"
html_static_path = ['_static']

# -- Опции для расширения todo ----------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/extensions/todo.html#configuration

todo_include_todos = True

Примечание: Сгенерированный файл conf.py отличается от шаблонного файла conf.py_t, и я не знаю, почему шаблон не применяется.