Sphinx (reStructuredText) 文档能处理 1000 页吗?
Will Sphinx (reStructuredText) document handle 1000 pages?
我在 MS Word 中有大约 200 个单独的文档,每个文档大约有 4-6 页长。
每个文档都定义了几个术语、少量图像以及少量表格和来源列表。
我正在考虑将文档转换为 rst 并使用 Sphinx 文档框架将它们全部集成到一个大文档中,因为它为交叉链接提供了很好的支持。
因此,我希望有两个人工制品:
- 多页 HTML(由
make html
构建)
- 单个 PDF 文档(由
make latexpdf
构建)
我的问题是:这么大的页数是否可行?
我预计会出现以下情况(有些很严重,有些则不然):
- 构建生成的文档(失败或花费相当长的时间运行)。
- 使用 HTML 版本的内置全文搜索。
这有点矫枉过正,但我生成了相当于 2100 页 pdf 的 .rst(在由 sphinx 翻译成 pdf 之后)
文档共 100 章,每章包含 100000 个来自英语词典的随机单词。
这是狮身人面像的行为方式:
% time make html
sphinx-build -b html -d _build/doctrees . _build/html
Running Sphinx v1.3.1
[...]
Build finished. The HTML pages are in _build/html.
make html 199.01s user 6.26s system 100% cpu 3:25.24 total
总构建时间约为 3 分钟。
最新版本的 firefox 可以正确显示生成的文档,并且 sphinx 生成的搜索框不会出现任何明显的减速。
所以我猜答案是:是的,可行。
我在 MS Word 中有大约 200 个单独的文档,每个文档大约有 4-6 页长。
每个文档都定义了几个术语、少量图像以及少量表格和来源列表。
我正在考虑将文档转换为 rst 并使用 Sphinx 文档框架将它们全部集成到一个大文档中,因为它为交叉链接提供了很好的支持。
因此,我希望有两个人工制品:
- 多页 HTML(由
make html
构建) - 单个 PDF 文档(由
make latexpdf
构建)
我的问题是:这么大的页数是否可行?
我预计会出现以下情况(有些很严重,有些则不然):
- 构建生成的文档(失败或花费相当长的时间运行)。
- 使用 HTML 版本的内置全文搜索。
这有点矫枉过正,但我生成了相当于 2100 页 pdf 的 .rst(在由 sphinx 翻译成 pdf 之后)
文档共 100 章,每章包含 100000 个来自英语词典的随机单词。
这是狮身人面像的行为方式:
% time make html
sphinx-build -b html -d _build/doctrees . _build/html
Running Sphinx v1.3.1
[...]
Build finished. The HTML pages are in _build/html.
make html 199.01s user 6.26s system 100% cpu 3:25.24 total
总构建时间约为 3 分钟。 最新版本的 firefox 可以正确显示生成的文档,并且 sphinx 生成的搜索框不会出现任何明显的减速。
所以我猜答案是:是的,可行。