单源文档工具

Question

有哪些OSS(或免费)工具可用于起草可用于生成手册的文档的单一来源？具体来说,采用以下格式:

• HTML网站
• PDF文件
• 嵌入式(在应用程序中;可能是HTML)¹
• 文字(可选)
• 手册页(可选)

其他要求:

• 工具适用于技术作者(不必是WYSIWYG).
• XML/SGML源代码
• 高质量PDF输出(与TeX相当)
• 多平台

扩大要求¹

相同的命令行应用程序用两种语言(C和Java)编写.使用XML来描述命令行选项(其中一些是特定于一个语言或其他),它是简单的XML转换成一个Java类,或C功能,写入帮助标准输出.这确保了可以将帮助嵌入到二进制文件中,而不必依赖于外部文件.

看来AsciiDoc没有这种能力.还有其他选择吗？

Answer 1

满足您大多数需求的是AsciiDoc.

但是,AsciiDoc不是XML源格式,而是选择简单的文本格式.它可以输出HTML和Docbook,可以呈现为PDF或其他格式.源文本也足以用于纯文本显示.

另一个流行的选择是reStructuredText.