Удалить предыдущий и следующий топи c из html, сфинкс

Question

Я хотел бы удалить Next topic и Previous topic со своих html страниц.

Я пробовал установить prev_next_buttons_location на False в html_theme_options из conf.py, но я получил WARNING , сообщающий мне, что эта опция недоступна для моей текущей темы (это nature ).

Другой способ удалить их - не объявлять другие источники rst из оглавления index (моя первая версия документа была только с index.rst, и у меня не было кнопок Next и Previous ): Я пробовал с флагом :hidden: из .. toctree::, но они у меня остались. Удаление .. toctree:: не является решением, потому что у меня есть ПРЕДУПРЕЖДЕНИЯ для каждого файла, который не объявлен.

Следует ли мне изменить свою тему на другую, поддерживающую prev_next_buttons_location? (Я действительно не хочу менять свою тему)

Есть ли способ удалить кнопки с моих сгенерированных страниц?

Answer 1

Другой способ решения express проблемы: как не включать некоторые файлы в toctree?

Сначала я попытался добавить файлы в exclude_patterns, но потом они не были сгенерированы до html . Я вернулся к do c и прочитал это

Используйте exclude_patterns, чтобы полностью исключить документы или каталоги из сборки. Используйте «сиротские» метаданные, чтобы позволить создать документ, но уведомите Sphinx о том, что он недоступен через токтри.

Затем я перешел по ссылке о «сиротских» метаданных: https://www.sphinx-doc.org/en/master/usage/restructuredtext/field-lists.html#metadata

И вот решение: просто добавьте :orphan: в начало файла. Как написано в do c:

Если установлено, предупреждения о том, что этот файл не включен ни в один из токтридов, будут подавлены.

Итак, проблема решена. .