不谈太多无关的细节,目前我们的产品手册是使用一些专有的所见即所得编辑器制作的,这有很多限制。我正在考虑使用其他编辑器来制作手册pdfLaTeX
。主要的这样做的动机是,我们可以将副本放入源代码管理中。(当您的文档只是二进制 blob 时,您无法这样做。)
完成这项工作需要做大量的工作,因此在开始之前我必须问自己:LaTeX 是完成这项工作的正确工具吗?或者我最好使用其他文档技术?(例如,DocBook ⇒ XSLT ⇒ XML-FO ⇒ PDF 等。)
我们希望我们的产品手册看起来就像时尚杂志上的一篇时尚文章,我们的图形部门在实现这一外观方面做得非常出色。显然,管理层不会接受任何比我们现有的更糟糕的内容。
LaTeX 当然是出色的制作看起来非常专业的学术出版物。但对于我们的目标受众来说,这看起来只是“吓人”。我们不希望客户认为您需要博士学位才能理解我们的软件。因此,当前的手册采用巨大的无衬线字体、丰富的色彩和不同的页面布局,使其看起来不像“文字墙”。而且,作为一本软件手册,它具有很多屏幕截图(通常带有带箭头的复杂标注)。
我毫不怀疑,如果你把足够多的专家聚集在一个房间里,用足够多的力气敲打,你很可能可以让 TeX 渲染任何事物.但有些事情可能的并不等同于简单的. 并且说 TeX能做某事并不等同于说这是最好的这项工作的工具 &mdash 甚至正确的适合该工作的工具。
那么大家觉得如何呢?TeX 是否是适合此目的的好工具,或者是否有其他更适合的工具?
答案1
就我这个稍微模糊的问题是否可以得到“答案”而言……
我花了几天时间尝试使用 LaTeX 重新创建现有文档。这大体上是成功的。经过长时间的研究,我发现:
有一种名为 XeTeX 的东西,它允许我使用现有文档中相同的昂贵商业字体。(遗憾的是,这也使得编译时间延长了 200 倍,但没关系……)
我发现了一种东西
tikz
,可以让我比较轻松地绘制漂亮的多色边框、圆角、标注等。使用该
geometry
软件包,我能够将宽大的 LaTeX 页边距缩小到光面文档所呈现的微弱边距。使用
fancyhdr
它可以编辑页眉和页脚,使之看起来像我想要的那样(而不是 LaTeX 默认设置)。我还设法给外部页边距上色。(我特别担心 TeX 无法做到这一点,但 TikZ 再次设法解决了这个问题。)使用后,
tocloft
我能够匹配原始文档中的目录。(特别是,将章节标题设置为与其他内容不同的颜色,以使其脱颖而出。)使用后,
titlesec
我能够将那些看起来非常学术的章节标题替换为一些看起来更加光鲜亮丽的东西。我不得不手动调整 TeX 的长度,以使段落具有垂直空格而不是水平缩进。但这并不太难。
到目前为止,最终的(未完成的)文档看起来与原始文档非常相似。然而,我还没有尝试插入任何截图,也没有给它们贴上标签。插入图片应该不成问题,但画箭头指向正确的部分可能很有趣。然而,现在知道 TikZ 存在,它应该只需找出正确的坐标(只需做一次)。简而言之,我相当有信心可以做到,而且相当容易控制。(不过,我实际上还没有完毕它还没有,所以……)
总结:是的,你绝对可以用 LaTeX 做出一些很棒的作品。也许不像我们的图形部门制作的那样完美,但已经相当不错了。(而且不需要精细管理分页符,手动保持字体/边距/页面标题一致等等。)
编辑:
有些人想看看实际的文档。不幸的是,我不得不把所有的文字都遮住,这让人有点难以分辨出它到底是什么样子!但这里有一张手册开篇的模糊图像:
以下是我的新版本:
它看起来有点丑,因为 Lorem Ipsum 段落都是这么久!但实际文档文本看起来确实非常相似。当我在工作电脑上访问实际的商业字体时,它看起来应该几乎完全相同。