16

年初时只有少数人推荐使用 Sphinx。

狮身人面像最近发展得相当快。我今天注意到 Sage 已经从使用 LaTex 直接编辑更改为 Sphinx。这在William Stein 4 月 2 日关于 Sage 教程的回答中很明显

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

这表明我认为 Sphinx 可能处于适合我的水平。

在编写手册/书籍方面，Sphinx 比 LaTex 更好吗？

4

5 回答 5

13

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

看看这个线程，在书籍构建工具部分

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

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

我们还对book.cls和sphinx.sty做了一些小改动

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

于 2009-04-08T11:00:21.180 回答
4

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

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

http://freedrive.com/folder/236385

和这里：

http://freedrive.com/folder/236380

专门查看python库参考和django书。

这是开发分支的输出，并且存在正在修复的错误（例如，目录通常位于页面的错误一侧）。

于 2009-09-10T16:42:17.343 回答
3

我更喜欢 Sphinx 而不是 Latex 来编写手册，原因有两个：

  1. 您可以轻松构建漂亮的 HTML、PDF、htmlhelp 和 qthelp 版本的手册。
  2. reST 语法写起来更快，我发现更容易记住（更简单）

然而，一本书可能是一个不同的故事。如果我想写一本只有印刷版和 pdf 版本并且包含方程式和引文的书，我会选择 Latex，因为我认为它比 reST 成熟得多，而且我发现它很容易定制。

顺便提一句。我在使用 Latex 方面有更多的经验。

于 2010-03-12T08:05:54.347 回答
1

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

于 2009-04-07T13:52:50.463 回答
1

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

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

  1. 对你更好吗？也许。

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

  3. 对普通人来说更好吗？定义“平均”，然后转到第 1 点。

于 2009-04-08T11:24:15.600 回答