的格式是适合印刷我们的一些客户要求的最终用户文档。 目前,我使用Microsoft Word 2002写文档和非免费的PDF打印机生成可搜索书签的PDF文件。 然后,我存储在Subversion repositoryT这两个文件。 虽然它的工作,它有几个缺点:
- 这不是版本控制友好。 更具体地讲,我不能分支,它是非常困难之间的端口更改处理品牌的东西,如标识或截屏。
- 我有时会忘记一些来生成输出和表的内容从PDF文件中缺少所需的手动步骤。
我需要在Windows上运行的一个工具,允许保持同一文档的并行分支 ,提供了一种简单的方法来处理图像 (外部文件将是一个加号),并生成可搜索书签高品质的PDF文件。 我也很想知道它是免费或开源的,并且具有合理的学习曲线。
我们的目标是生产用于PHP供电Intranet站点打印最终用户手册,我不是在寻找在线文档或API文档工具。 你有什么建议?
这可能是一个有点矫枉过正,但我建议LyX的。 这是一个跨平台的,开放源码软件,用户友好的前端到胶乳。
对于文档中的“源”文件是文本和版本控制和合并友好。 并使用LyX的,而不是直接的LaTeX是学习曲线的一个伟大的加项。
我们用它已经为小团体和文件的能力,在合并版本控制是一个真正的好处。
我喜欢这种类型的工作的DocBook +您的首选SCM工具(颠覆)。 这是可能的(使用XSL转换+ FOP一些处理器)来产生从单个源HTML和PDF输出。 DocBook是不是简单的开始,但它真的很强大。
我会建议使用乳胶和良好的工作流程脚本或生成文件(例如,在谷歌代码乳胶生成文件项目)为您办理DVI / PS一代与汇编权数。 也为处理本地的修订十分简单,Mercurial是更加简单安装/使用比SVN,就这么简单汞的init,添加汞,汞承诺 ! 你的训练在这里完成了:-)。 这让我想起我是如何利用当地RCS为我自己对乳胶和源文件需要我。 这也是很容易的创建分支或简单地克隆库时,文档的并行版本是必要的。
如果你宁愿留在所见即所得的世界,一个更好的版本控制的其他解决办法是用开放式办公室和OOoSVN扩展 ,它允许存储(大)未压缩的XML文件,但差异文件,真正处理的修订,相反对发生的事情存储二进制文件时。 不干净的第一个解决方案恕我直言,但是这种解决方案将避免遗留文档的翻译和LaTeX的学习曲线(其中,说实话,是不是陡峭的话)。
希望能对大家有所帮助。
我们使用乳胶生成文档。 您可以生成所有文件存储在一个额外的SVN的文档... PDF等任意类型。 所以很容易通知客户在文档的变化。
Additionly你的团队可以在文档上的所有一起工作,你的几个分支的需求得到满足。
我们的文档是由哈德森建regulary。
你有没有考虑胶乳。 由于它是基于源的性质,它是非常友好的SCM和有非常强大的功能和PDF导出包,维护词汇表,缩略语,汽车TOC生成,嵌入源代码等。
看到一个巨大的文档在这里的工具列表:
http://www.doxygen.nl/links.html
我以前用的文件-O-Matic的我德尔福项目,真的很喜欢它了不少-但相当几年前。 #2在我们的评测当时是帮助和手册的得分是差不多高督-O-MATIC。
无论是商业工具,但长远来看,他们是值得每它们的价格您面前一分钱。