html - 狮身人面像复制html文件

Question

我使用 Sphinx 生成文档，其中一些文档是纯 html 文件。
我想 sphinx 复制这些文件以按原样将目录构建到相应的路径。
我可以做吗 ？

Answer 1

不知道我是否得到了你想要做的。

我需要的是:在用 sphinx 创建 html 内容之后

$ make html

我需要将这些 html 复制到 doc 文件夹，以便 github 页面可以看到它。

也就是说，我正在做的是:我创建了一个 python 脚本来调用 sphinx 然后复制文件。

脚本和文档位于文件夹 doc_src 中。结构是:

Project/
 doc/ (where I need my html)
 doc_src/ (where I build them)

doc_src 中的脚本类似于:

import os
import sys
import shutil

def make_doc():
    """Run Sphinx to build the doc."""
    try:
        # removing previous build
        print('removing previous build')
        cmd = 'make clean'
        os.system(cmd)
        shutil.rmtree('../doc/', ignore_errors=True)

        # new build
        cmd = 'make html'
        os.system(cmd)

        # copy files - windows cmd here
        print('copy files')
        cmd = r'xcopy _build\html\. ..\doc\ /e /Y'
        os.system(cmd)
    except Exception as error:
        print(error)


if __name__ == '__main__':
    make_doc()