Pdf 用于生成用户手册的应用程序(不是标记语言)

Pdf 用于生成用户手册的应用程序(不是标记语言),pdf,documentation,publishing,manuals,Pdf,Documentation,Publishing,Manuals,有人能推荐一个程序来创建用户手册吗?不是一种标记语言(如LaTeX或DocBook),而是一种更具交互性的语言,如Scribus。因为我不是唯一一个会更新手册的人,所以软件应该是新手容易学会的,但仍然有一些高级功能(比如从外部源/表链接文本,处理母版页/主题等) 问候,, Oscar如果您想要协作,那么基于语言的方法(虽然基于XML的方法也很好,但LaTeX将是我的首选——Docbook是这里的旗舰)确实有意义,特别是如果您使用版本控制系统跟踪文件 任何使事情复杂化的东西,比如任何二进制或专有格

有人能推荐一个程序来创建用户手册吗?不是一种标记语言(如LaTeX或DocBook),而是一种更具交互性的语言,如Scribus。因为我不是唯一一个会更新手册的人,所以软件应该是新手容易学会的,但仍然有一些高级功能(比如从外部源/表链接文本,处理母版页/主题等)

问候,,
Oscar

如果您想要协作,那么基于语言的方法(虽然基于XML的方法也很好,但LaTeX将是我的首选——Docbook是这里的旗舰)确实有意义,特别是如果您使用版本控制系统跟踪文件

任何使事情复杂化的东西,比如任何二进制或专有格式的软件,在这里都帮不了你

对不起,如果这不是你想要的答案

Word(或您最喜欢的文字处理器)


我用Word制作所有的用户手册(不要与用户帮助文件混淆)。然后我可以确定它们是否需要以PDF、RTF、DOC甚至转换为HTML格式。为了解决多用户更新问题,我将文件存储在源代码管理中,以处理所有有趣的事情。

我同意Ollivier的观点,即使用DocBook(或LaTEX)是实现轻松转换、合理格式化和良好版本控制的最明智的方法

幸运的是,你可以试着用DocBook编辑器吃蛋糕


试穿一下,看看有没有能满足你的需要的(我没有用过)。

我听说了一些好消息。我自己并没有使用过它,但有人向我推荐了它用于这样一个应用程序。

请参阅博客,深入讨论使用DocBook等的利弊。Scott Meyer尝试了许多可能性,并分享了他的想法。

Adobe Framemaker确实是编写用户手册的经典工具。我已经将它用于所有类型的长文档,并且它工作得非常好。可惜的是,Adobe在发现用户不愿意切换之前让它腐烂了好几年

MSWord直到2003年才解决了项目符号/编号错误,我不知道他们是否最终使主文档正常工作


乳胶仍然是一种合理的替代品。该格式易于处理,您可以从wiki生成该格式。

技术发布软件-查看及其替代方案

我使用LaTeX和Framemaker完成了规范文档,并设计了Framemaker工作流,以支持由5名分析师组成的团队为保险承保系统生成规范文档。这份文件预计有2000页左右。许多年前(大约1992-1993年),我也曾短暂地做过排字工

Framemaker是为技术文档而设计的,它确实做得很好。
它还具有一些功能,可以支持有多个作者的非常大的文档-人们使用此系统来制作超过100000页的文档。对于熟悉文字处理软件的用户来说,它也比LaTeX更容易访问

Framemaker的主要功能:

  • 由多个 文件:您可以将 在中包含多个小节的“Book” 不同的文件。文件可以 也可以保存在源代码管理中

  • 的文本MIF格式 导入/导出:导入者是 有点挑剔(我发现 工作更容易)但你可以 生成数据等项 并将它们导入到 文件。该文件具有文本格式 锚定(见下文),以便您可以 创建交叉引用链接 在所有进口产品中都将保持稳定。我 发现这是的一个关键特性 规范,因为它允许交叉引用 直接链接到生成的项目

  • 强大的标签、索引和交叉引用系统:一切 基于Framemaker中的标记和 快速应用标记很容易。 这意味着相互参照, 索引、条件文本和 整体应用样式既简单又方便 只是工作而已。您可以根据标记生成索引和TOC,因此 有多个专门的索引 (例如数据字段名称列表) 从屏幕或数据字典) 这很容易做到。文件一 如上所述,有4个单独的 索引

  • 稳定:Framemaker专为 专业人士,所以它不是第二个 用这个词的方式猜你。 它在大范围内也更稳定 文件。任何试图 写一份超过50-100的文件 Word上的页面应该有一个漂亮的 这意味着什么

  • 可编写脚本:FM有一个C API,并且 有各种各样的脚本插件 (及 可能是使用最广泛的) 它可以用来自动化作业 用调频。增加支持 用于基于Javascript的脚本工具 大概是吧 移植到脚本工具的另一端 在设计中

  • 单一来源:来自单一FM 您可以生成PDF的文档, Windows帮助(CHM)、HTML和打印 文档相当容易。这个 交叉引用也解决了以下问题: 超链接

  • 全局样式控件:您可以 轻松设置文档的样式 并将其应用于整个系统 文件。它也有助于 使用 有很大的灵活性 它们跟踪区段、版本, 章节等

Framemaker的替代方案

  • 乳胶/Lout:您已经指出 您不需要标记 语言,但是 系统用于大型应用程序 结构化文档并执行此操作 嗯

  • 可能是 Framemaker的唯一真正替代品 如果你想要那种用户界面 而不支付身体部位的费用 特权 它对结构化的 文档和基于XML的文档 交换格式。它现在是自己的了 由科雷尔,谁似乎仍然是活跃的