Как я могу использовать разные master_docs в HTML и LaTeX? - PullRequest
Новая
       5

Как я могу использовать разные master_docs в HTML и LaTeX?

0 голосов
/ 17 мая 2018

Из-за расхождений в способах обработки индексов и toctree подписей сборщиками, я хотел бы использовать другой «основной» документ для сборок HTML и LaTeX моего документа Sphinx.

следующее почти работает: 

def set_master_doc(app):
    if app.tags.has("latex"):
        app.config.master_doc = "latex"
        app.config.exclude_patterns.append("html.rst")
    else:
        app.config.master_doc = "html"
        app.config.exclude_patterns.append("latex.rst")

def setup(app):
    app.connect('builder-inited', set_master_doc)

… но так как он изменяет конфигурацию, он вызывает полную перестройку каждый раз, когда я переключаюсь с HTML на LaTeX, и наоборот.

Я также пыталсяиметь индекс с only::: 

.. only:: html

   .. include:: html.rst

.. only:: latex

   .. include:: latex.rst

… но это вызывает много проблем, включая повторяющиеся записи в оглавлении, поскольку оба документа анализируются и индексируются.

Что правильноспособ использовать другой мастер-документ для моих сборок LaTeX и HTML?

...