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

我以前见过的Latex-to-html转换器非常糟糕。编辑原始的html并不好玩，似乎也不能很好地转换成打印页面。其他人如何解决这个问题？示例（包括pdf和html）的链接会很好。如何最好地编写针对HTML和PDF的文档？

补充：另外一个类似的问题，只是问：

What formatting language should I use for project documentation

2009-01-03 dreeves

你可以退后一步，并使用类似的DocBook并通过乳胶和HTML直接从DocBook的文件渲染成PDF。另外，Adobe技术交流套件（Framemaker）将允许您将文档单源化为PDF和HTML。请参阅this posting了解各种技术文档系统的情况。

来源

2009-01-03 20:08:26 ConcernedOfTunbridgeWells

+1 - 你也可以直接从docbook到pdf和html（以及一些其他格式，如帮助文件），而不使用LaTeX之间使用docbook-xsl – frankodwyer 2009-01-03 21:25:08

我敢打赌，PDF格式的排版不如你通过乳胶，但:)除非有很大的变化，我没有听说过... – 2009-03-03 02:15:06

是的，LaTeX到HTML转换器用来吸取（你可能试过LaTeX2HTML），但最近他们已经变得更好。 Tex4ht是高度可配置的，并且生成很好的XHTML + CSS。另请参阅other converters。

如果您可以耐心写入，您也可以使用Docbook。有从DocBook到HTML和LaTeX（或直接PDF）的转换器;后者的一个例子是dblatex。

看到这个职位：LaTeX vs Docbook。

来源

2009-01-03 20:09:58 ShreevatsaR

tex4ht也不是picknick，也不是hevea。不知何故，他们都吮吸。调试latex2html（0.96）是我整个编程生涯中最糟糕的经历。超过1MB的Perl脚本 tex4ht有时会完全链接链接，并且有一些不友好的初学者疑难杂症（例如连字） – 2009-06-03 22:02:07

他们都吸吮，但有些吸吮比其他人少。 :-)（你是否尝试过plasTeX，BTW？http://plastex.sourceforge.net/） – ShreevatsaR 2009-06-03 23:22:52

不，我会看看，但看到它在Python中并不让我高兴 – 2009-07-09 20:11:18

我不确定乳胶真的是最好的工具。你用通常的胶乳到html转换器遇到的麻烦是问题的表现：html很简单，不像乳胶那样富有表现力。

如果你坚持将latex转换为html，请注意使用可以合理转换的有限子集。

来源

2009-01-03 20:10:49 dmckee

PlasTeX看起来像一个很好的乳胶到html转换器，虽然我没有尝试过自己。

我的朋友罗布费尔蒂写了一篇博客文章颂扬它的优点： http://blog.robfelty.com/2008/03/19/finally-a-better-latex-to-html-converter/

来源

2009-01-03 20:31:43 dreeves

链接已损坏： - （ - 你有更新的链接吗？ – jastram 2014-01-03 10:46:38

AsciiDoc看起来像一个有趣的可能性。

来源

2009-01-03 20:32:45 dreeves

我以前用过TeXinfo，它做得很好。这里有一个例子：http://yootles.com/api。我宁愿坚持使用LaTeX，而不是使用其他语言。

来源

2009-01-03 20:35:33 dreeves

-16

LaTeX？真的吗？我不知道学术界以外的人仍然使用它。我会用HTML，它可以从网页浏览器保存为PDF格式。如果你确实需要一些高级版式的东西，那就用Word来代替 - 它可以保存为HTML格式（可能不像人们想象的那样干净），并且可以通过一个免费插件保存为PDF格式（可单独下载）。

哦，我不打扰使用InDesign之类的东西 - 它们是过度杀伤。另外，不要为Acrobat Professional付费 - 有一个免费的解决方案。

来源

2009-01-03 20:41:03

我敢说这个问题是由乳胶粉丝downvoted？ – 2009-01-03 22:02:40

这是个人选择，但理论上乳胶是完美的，但在实践中它是痛苦的屁股。我在需要时使用VS.NET HTML编辑器+原始HTML编辑。

所以我认为使用WSIWYG HTML编辑器是最佳选择。您可以随时使用简单的工具将其转换为PDF，并且您可以随时在需要某些先进功能时编辑HTML。在需要时也可以更容易地上网。

这就是我如何管理我的软件文档并为我工作的很好。

来源

2009-01-03 21:41:50

经过多年的痛苦和几个错误的开始，我要重温这一点，我想给Sphinx一试。它可以从ReStructured Text生成HTML或LaTeX。

我希望它会比全DocBook的一个更“轻”的选项，但有许多的优点。

来源

2009-01-03 22:01:04

对于记录代码，我也推荐狮身人面像。重构文本很好，因为它是可读的，并以明文形式标记，并且可以很好地转换为html和pdf。我仍然喜欢LaTeX的某些事情。我和妻子用LaTeX写我们的圣诞信，我们通过蜗牛邮件寄出。 pdf版本很漂亮，有两列，页眉和页脚。 html版本更简单。我用plastex转换。示例在这里： http://fedibblety.com/annualReports

我不认为任何二进制格式是一种很好的选择（Word）的任何类型的文件，你可能想阅读10年后的现在。这是LaTeX的好处之一。

来源

2009-01-04 04:31:48