sphinx-build使用不同的index.rst输入文件

Question

我可以将sphinx不同index1.rst作为参数构建../build/html_1/和index2.rst来构建../build/html_2/：

我在sphinx-build文档中找到了如何定义目标文件夹但没有关于指定index.rst文件的信息

Answer 1

您可以根据环境变量设置master_doc。

在conf.py：

import os
master_doc = os.environ.get('INDEX')

在Makefile中，您可以传递所需的环境变量：

html1:
        INDEX=index1.rst $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html1

html2:
        INDEX=index2.rst $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html2