Sphinx(reStructuredText)文档会处理1000页吗?

时间:2015-08-30 11:44:11

标签: html documentation python-sphinx restructuredtext

我在MS Word中有大约200个单独的文档,每个文档大约有4-6页。

每个文档都定义了几个术语,几个图像以及几个表和源列表。

我正在考虑将文档转换为第一个并使用Sphinx文档框架将所有文档集成到一个大文档中,因为它为交叉链接提供了非常好的支持。

结果,我期待两件文物:

  • 多页HTML(由make html构建)
  • 单个PDF文档(由make latexpdf构建)

我的问题是:如此大量的网页是否可行?

我希望在以下情况下出现问题(有些是关键的,有些则不是):

  • 构建生成的文档(失败或花费相当长的时间来运行)。
  • 使用HTML版本的内置全文搜索。

1 个答案:

答案 0 :(得分:2)

这有点矫枉过正,但我​​生成的第一个相当于2100页的pdf(经过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

总建造~3min。 最新版本的firefox正确显示生成的文档,sphinx生成的搜索框不会出现任何明显的减速。

所以我猜答案是:是的,这是可行的。