Sun Xml doclet仍然可用吗?

时间:2011-02-15 10:14:23

标签: java xml doclet

我正在寻找一个可以生成xml格式的javadoc而不是默认html的doclet。 经过一些搜索,我发现有一个Sun XML doclet,以前位于http://www.sun.com/xml/developers/doclet/

但是此链接不再有效,是否有人拥有Sun xml doclet的副本?或任何其他替代xml doclet?

3 个答案:

答案 0 :(得分:1)

最后从http://jeldoclet.sourceforge.net/

找到了另一个xml doclet

它非常轻巧,功能强大:)

答案 1 :(得分:0)

我不确定这是不是你所追求的,但是有一个project on SF called XHTML Doclet。它应该生成XHTML javadoc输出而不是传统的HTML输出。无论如何,我怀疑它与Sun的实施有什么关系。

你没有在你的问题中提到XHTML,所以我不相信XHTML是你正在寻找的XML。

答案 2 :(得分:0)

虽然这个问题看起来很模糊,但我相信这一点非常重要。 (但问题是问题本身有些不正确。)

所以,你正在(或者正在)寻找XML doclet ......但是你在谈论什么XML?

例如,XHTML实际上是" XML"并且生成XHTML的doclet与标准doclet大致相同(不确定标准Doclet是否已生成XHTML)。 生成DITA输出(DITA-doclet)的doclet也是一个" XML doclet"同时,因为DITA也是XML!

同样可以说很多其他可能的doclet生成这样的格式,如: XSL-FO,SVG,Microsoft Office XML,Office Open XML等。

事实上,可以为任何事物创建某种XML词汇表。这就是为什么" XML"是可扩展标记语言

所有这些" XML doclets"因为如果将XHTML-doclet(又称标准Doclet)视为一项工作,那么为什么其他XML-doclet(例如DITA-doclet)会更简单?

所以,你可能会猜到为什么没有很多纯粹的" XML doclets"现在(以及那些最初在很久以前就被停止的那些)。我认为,这仅仅是因为人们最终意识到不可能为任何事情创建单个doclet(或文档生成器)。就像你不能开发一个可以做任何事情的程序一样(任何你的愿望)。

那么,为什么我认为整个问题(关于XML doclet)是没有意义的呢?

因为您正在寻找的不是通用的" XML doclet"因为它 - 那东西不存在!相反,您需要一个工具来轻松开发特定XML词汇表的自定义XML文档。在这种形式中,我相信,这个问题非常合理!

那是什么工具?一般的编程语言(Java本身)将是"工具"当然。但这项任务实际上并不广泛。可以存在一个更集中的事情,它已经自动化了一般文档生成常见的大量操作(特别是Javadoc)。

这样的工具确实存在! (很久以前就是那个)

它被称为 DocFlex / Javadoc http://www.filigris.com/products/docflex_javadoc/

在DocFlex / Javadoc中,实际的doclet使用图形模板设计器以特殊模板的形式编程。更进一步,这些模板由包含为Javadoc doclet的Template Interpreter解释。模板本身与XSLT脚本有一些类比(尽管它们不基于XSLT)。 该模板系统有助于自动执行大量常规任务,并使您能够更专注于数据处理本身和结果输出的设计。

虽然目前DocFlex / Javadoc更专注于HTML和RTF的生成,但也可以使用它生成任何XML标记。简单地说,DocFlex / Javadoc支持的第三种输出格式只是纯文本(TXT),XML文件是纯文本文件。 可以在模板中指定任何XML标记,以作为TXT输出的一部分发出。 因此,您将获得XML作为结果 - 任何XML,就像您编写它一样。

基本上,它与XSLT脚本的工作方式相同,后者将一些XML文件转换为另一个XML输出。区别在于这里的数据源不是XML文件,而是Doclet API!

事实上,DocFlex / Javadoc本身就是一个更大项目的分支。另一个分支是XML Schema文档生成器,它似乎在这里变得非常流行,例如见:How to convert xsd to human readable documentation?