使用RationalSoftwareArchitect

本文提供给那些使用Rational Software Architect来建立模式库的Java 开发者。如果你对Eclipse 的在线帮助系统和帮助锚非常熟悉，它将对你有益。关于Rational Software Architect中的设计模式的信息，在产品中提供的在线帮助中可以查到。关于使用帮助系统开发在线帮助插件及使用锚，你可能从《Help -- Part 1: Contributing a Little Help (Revised for 2.0)》一文中找到有用的资料，它列于本文后面的 资源 一节中。

本文提及 Reusable Asset Specification （RAS），它为模式和模式程序库提供了一个标准的结构和组织。关于 RAS 和模式的更多信息，见Rational Software Architect在线帮助。

本文把重心集中在 PatternFiles 目录树中的文件。这些文件在模式设计期间，在包浏览器视图中是可见的。列表1显示，紧随项目的建立及模式添加之后的PatternFiles 目录结构：

				
			
PatternFiles/
	Pattern1/
		Pattern1.emx
		Pattern1.rmd
	Pattern2/
		Pattern2.emx
		Pattern2.rmd
	MyPatterns.rmd

在生成帮助之后，目录 2显示 MyPatterns 的 PatternFiles 部分的内容：

				
PatternFiles/
	Pattern1/
		Pattern1.em
		Pattern1.rmd
		PatternHelp/
			Pattern1Description.html			
            Pattern1Overview.html
            Pattern1Parameters.html
			Pattern1ToC.xml
	Pattern2/
		Pattern2.emx
		Pattern2.rmd
		PatternHelp/
			Pattern2Description.html			
            Pattern2Overview.html
            Pattern2Parameters.html
			Pattern2ToC.xml
	PatternHelp/
		MyPatterns.html
		MyPatternsToC.xml
	MyPatterns.rmd

正如你所见到的，生成帮助的过程建立了三个目录和多个文件。文章接下来的部分将详细解释每一个生成的文件。

模式库帮助内容文件包含有一些信息，例如简短说明，版本，程序库的ID及库中的模式列表。帮助内容文件存储于PatternFiles目录下的PatternHelp目录中，并与库具有相同的名字。在例子项目中，MyPatterns.html 是模式库帮助文件。

模式库内容文件表储存在 PatternHelp 目录中，而且它以模式的名字附加上 ToC.xml 作为名字。在你的例子项目中，模式库内容文件表是 MyPatternsToC.xml 。

因为目录表如此重要，让我们更深入地探讨。列表 3显示 MyPatternsToC.xml 文件的内容：

生成的模式库的内容文件表规定了一个为模式库命名的主题。模工库主题指向生成的模式库帮助内容文件。在模式库主题里面，目录表定义了它自己的锚点。