使用 Eclipse 帮助系统为项目编制文档

　2009-12-13 00:00:00　来源：WEB开发网　　　

核心提示： bar-toc.xml 文件正是另一个目录，格式应该和任何其他的 toc.xml 文件完全相同，使用 Eclipse 帮助系统为项目编制文档(4)，当文档被浏览时，使用这种方法和简单地直接包含另外的 topic 元素没什么不同，如果您不需要独立的文档集，那么您甚至不需要理会 XSLT；您只需要编

bar-toc.xml 文件正是另一个目录，格式应该和任何其他的 toc.xml 文件完全相同。当文档被浏览时，使用这种方法和简单地直接包含另外的 topic 元素没什么不同。

生成独立的文档集

当然，如果您不介意需要发布 20 MB 额外的代码，使用 Eclipse 帮助系统当然好，但是这对小些的项目来说是不现实的。在中心服务器上安装一个 InfoCenter，让人们可以远程访问。人们可以充分利用 Eclipse 帮助系统的所有功能（比如搜索），但是那些不能连接的人还是束手无策。所以，除了使用在主机上的 InfoCenter 以外，有必要将普通的 HTML 包含在一个可下载的包中。只要您没有使用任何服务器端技术，比如 JSP，那么您可以方便地生成一个 HTML 目录来取代 Eclipse 所用的 XML 目录。这就是为什么我们要用 XSLT。

XSLT (eXtensible Stylesheet Language Transformations) 是一种将 XML 格式转化为其他格式的技术，例如 XHTML（一个更为严格的 XML 版本的 HTML）。XSLT 提供了丰富而强大的语言来完成转换，其本身就是很多书和文章的主题，所以我们在这里不再细述。清单 4 给出了一个 toc.xml 文件简单转换的例子，将条目呈现为嵌套的 HTML 列表。注意，这个特定的转换为全部文档集的内容创建了一个单独的 HTML 文件，文件量较大时这可能不实用。所以，如果您已经将您的目录拆分为多个文件，这个 XSLT 将失效。

清单 4. 生成 HTML 目录的示例 XSLT
<?xml　version="1.0"?>　 <xsl:stylesheet　　　version="1.1"　　　xmlns:xsl="http://www.w3.org/1999/XSL/Transform">　 <xsl:output　method="html"　indent="no"　encoding="ISO-8859-1"　/>　 <xsl:template　match="toc">　　　<html>　　　　<head　/>　　　　<body>　　　　　　<h1><xsl:value-of　select="@label"　/></h1>　　　　　　<ul>　　　　　　　<xsl:apply-templates　/>　　　　　　</ul>　　　　</body>　　　</html>　 </xsl:template>　 <xsl:template　match="topic">　　　<li>　　　　<xsl:choose>　　　　　　<xsl:when　test="@href">　　　　　　　<!--　Only　add　a　hyperlink　when　there　is　something　to　link　to　->　　　　　　　<xsl:element　name="a">　　　　　　　　　<xsl:attribute　name="href">　　　　　　　　　　<xsl:value-of　select="@href"　/>　　　　　　　　　　</xsl:attribute>　　　　　　　　　<xsl:value-of　select="@label"　/>　　　　　　　</xsl:element>　　　　　　</xsl:when>　　　　　　<xsl:otherwise>　　　　　　　<xsl:value-of　select="@label"　/>　　　　　　</xsl:otherwise>　　　　</xsl:choose>　　　　<!--　If　there　are　any　nested　topics,　then　start　a　new　sub-list　->　　　　<xsl:if　test="descendant::topic">　　　　　　<ul>　　　　　　　<xsl:apply-templates/>　　　　　　</ul>　　　　</xsl:if>　　　</li>　 </xsl:template>　 </xsl:stylesheet>