扩展简介配置的内容

插件可以将简介内容添加至在别处定义的页面。但是,定义页面必须定义一个充当新内容的位置占位符的 anchor 属性。SDK 概述页定义两个锚点,用于在概述页上添加与 JDT 和 PDE 相关的元素。

 <group id="page-content">
	<text style-id="page-title" id="page-title">OVERVIEW</text>
	<text style-id="page-description" id="page-description">Eclipse is a kind of universal tool platform - an open extensible IDE for anything and nothing in particular. It provides a feature-rich development environment that allows the developer to efficiently create tools that integrate seamlessly into the Eclipse Platform.</text>
	<group id="overview-links">
		<link label="Workbench basics" url="http://org.eclipse.ui.intro/showHelpTopic?id=/org.eclipse.platform.doc.user/concepts/concepts-2.htm" id="basics">
			<text>Learn about basic Eclipse workbench concepts</text>
        </link>
        <link label="Team support" url="http://org.eclipse.ui.intro/showHelpTopic?id=/org.eclipse.platform.doc.user/concepts/concepts-26.htm" id="team">
			<text>Find out how to collaborate with other developers</text>
        </link>
		<anchor id="jdtAnchor"/>
		<anchor id="pdeAnchor"/>
	</group>
</group>
向页面中添加内容的插件可以引用这些锚点。内容是使用 org.eclipse.ui.intro.configExtension 扩展添加的。除了扩展页面内容之外,此扩展点还允许用户添加备用内容部件和定制操作。

要扩展现有的简介配置,可以使用 configExtension 元素。在此元素中,您指定正在被扩展的简介配置的 configId 以及用来描述新内容的内容文件。

   <extension
	point="org.eclipse.ui.intro.configExtension">
	<configExtension
		configId="org.eclipse.platform.introConfig"
		content="$nl$/overviewExtensionContent.xml"/>
    ...
</extension>
内容文件的格式与简介配置内容的格式相似,只不过内容文件必须包含 extensionContent 元素,该元素定义指向应该插入扩展内容的锚点的路径。
<introContent>
	<extensionContent alt-style="css/swt.properties" style="css/overview.css" path="overview/page-content/overview-links/jdtAnchor">
		<link label="Java development" url="http://org.eclipse.ui.intro/showHelpTopic?id=/org.eclipse.jdt.doc.user/gettingStarted/qs-BasicTutorial.htm" id="java">
			<text>Get familiar with developing Java programs using Eclipse</text>
		</link>
	</extensionContent>
</introContent>
在将定制内容添加至简介的预定义锚点之后,给定的产品就可以使用以上讨论的 org.eclipse.ui.intro 来将它自己绑定至该简介。当产品运行时,扩展的简介将显示附加内容。这允许产品具有它自己的标记和其它特定于产品的信息,同时重用紧密相关的产品的简介以及它自己的键内容。

给定的简介还可以选择性地包括相关产品的一些简介。在此情况下,产品可以定义它自己的简介和简介配置,然后通过在内容文件中使用 include 来引用在另一个简介的配置中定义的重要元素。对于彼此在对方基础上构建的相关产品并且需要向用户介绍更高级别产品中的关键概念时,这种机制很有价值。