在编写手册/书籍时，Sphinx是否比LaTex更好？

Question

只有a few people recommended才能在年初使用Sphinx。

狮身人面像最近发展得相当快。我今天指出，Sage已经从使用LaTex直接编辑改为Sphinx。这在4月2日William Stein's answer关于Sage的教程

中很明显

  

本教程不再是乳胶文档。这完全是一个   可以输出pdf的不同Sphinx文档。

它告诉我，狮身人面像的水平可能适合我。

在编写手册/书籍时，Sphinx是否优于LaTex？

Answer 1

我们用 sphinx 写了一本书但我们不得不调整用Python脚本生成的 tex 文件。

在图书构建工具部分中查看此thread

这是我们对原始LaTeX文件所做的一些更改：

• documentclass ='book'
• 添加 frontmatter ， mainmatter 和 backmatter
• 为 fncychap.sty
添加了新样式
• 两列索引而不是一列
• 页面标题中的一些更改
• 一切都是黑色的＆amp;白色
  • 链接
  • 标题
  • 图像（使用imagemagick转换灰度图像）
• 提示和备注显示在带有图标的更好框中
• 在页面上更好地浮动放置以优化使用的空间

我们还对 book.cls 和 sphinx.sty 进行了细微更改

通过所有这些调整，我们对结果非常满意。

Answer 2

好吧，至少有一本书使用sphinx和rst2pdf打印

通过sphinx和rst2pdf生成的一些示例文档：

http://freedrive.com/folder/236385

在这里：

http://freedrive.com/folder/236380

特别检查python库引用和django书。

这是从开发分支输出的，并且有修复的错误（例如，TOC通常位于页面的错误一侧）。

Answer 3

我更喜欢Sphinx和Latex编写手册，原因有两个：

1. 您可以轻松地构建手册的HTML，PDF，htmlhelp和qthelp版本。
2. reST语法写得更快，我觉得更容易记住（更简单）
然而，一本书可能是另一回事。如果我想写一本只有印刷版和pdf版并包含方程式和引文的书，我会选择Latex，因为我觉得它比reST要成熟得多，我觉得它很容易定制。

顺便说一下。我在使用Latex方面有更多经验。

Answer 4

最好是创建参考文档，而不是编写书籍。

Answer 5

Word是一个更好的文档制作工具吗？

LaTeX（和TeX）已经存在的时间比我们大多数人都意识到有些程序可以做这种事情而且我们对它们感兴趣。 LaTeX几乎肯定比Sphinx（或Word）更好。

1. 对你有好处吗？也许。

2. 对我来说好吗？不太可能。

3. 一般人更好吗？定义'average'然后转到第1点。