如何最好地编写针对HTML和PDF的文档？

Question

我过去见过的Latex-to-html转换器非常糟糕.编辑原始HTML并不好玩,似乎不能很好地转换为打印页面.别人怎么解决这个问题？示例链接(pdf和html)都很棒.

补充:刚问了另一个类似的问题:

我应该使用什么格式化语言来编写项目文档

Answer 1

为了记录代码,我还推荐Sphinx.ReStructured Text很好,因为它是可读的并且在明文中有点标记,并且可以很好地转换为html和pdf.对于某些事情,我仍然喜欢LaTeX.我的妻子和我用LaTeX写我们的圣诞信,我们通过蜗牛邮件寄出.pdf版本非常华丽,有两列,页眉和页脚.html版本更简单.我用plastex转换.这里的例子:http: //fedibblety.com/annualReports

我不认为任何二进制格式对于您可能希望在10年后阅读的任何类型的文档都是一个不错的选择(Word).这是LaTeX的好处之一.

Answer 2

是的,用来吸的LaTeX到HTML转换器(你可能已经试过LaTeX2HTML),但最近他们已经得到了更好的.Tex4ht具有高度可配置性,可生成出色的 XHTML + CSS.另见其他转换器.

您也可以使用Docbook,如果您愿意写入.有从DocBook到HTML和LaTeX(或直接到PDF)的转换器; 后者的一个例子是dblatex.

看这篇文章:LaTeX vs Docbook.

Answer 3

经过多年的痛苦和几次错误的开始,我即将重温这一点,我将尝试给狮身人面像.它可以从ReStructured Text生成HTML或LaTeX .

我希望它比完整的DocBook更加"轻松",但具有许多优点.

Answer 4

您可以退后一步，使用 DocBook 之类的东西，并通过 LaTeX 和 HTML 直接从 DocBook 文件渲染为 PDF。或者，Adobe Technical Communication Suite (Framemaker) 将允许您将文档单一来源为 PDF 和 HTML。有关各种技术文档系统的概要，请参阅此帖子。