有哪些
OSS(或免费)工具可用于起草可用于生成手册的文档的单一来源？具体来说,采用以下格式：
> HTML网站
> PDF文件
>嵌入式(在应用程序中;可能是HTML)1
>文字(可选)
>手册页(可选)
其他要求：
>工具适用于技术作者(不必是WYSIWYG).
> XML / SGML源代码
>高质量PDF输出(与TeX相当)
>多平台
扩大要求1
相同的命令行应用程序用两种语言(C和Java)编写.使用XML来描述命令行选项(其中一些特定于一种语言或另一种语言),可以直接将XML转换为Java类或C函数,该函数将帮助写入标准输出.这确保了可以将帮助嵌入到二进制文件中,而不必依赖于外部文件.
看来AsciiDoc没有这种能力.还有其他选择吗？
解决方法
满足您大多数要求的,我之前使用的是
AsciiDoc.
但是,AsciiDoc不是XML源格式,而是选择简单的文本格式.它可以输出HTML和Docbook,可以呈现为PDF或其他格式.源文本也足以用于纯文本显示.
另一条流行的选择是reStructuredText.
