Estendendo o Conteúdo de uma Configuração de Introdução

Os plug-ins podem contribuir com o conteúdo da introdução para uma página definida em algum outro lugar. No entanto, a página de definição deve definir um atributo de âncora que age como um marcador de local para o novo conteúdo. A página da visão geral de SDK define duas âncoras para incluir os elementos relacionados ao JDT e ao PDE na página da visão geral.

 <group id="page-content">
	<text style-id="page-title" id="page-title">OVERVIEW</text>
	<text style-id="page-description" id="page-description">O Eclipse é um tipo de plataforma de ferramentas universal - um IDE extensível aberto para qualquer coisa e para nada em específico. Fornece um ambiente de desenvolvimento rico em recursos que permite que o desenvolvedor crie, de modo eficiente, as ferramentas que se integram facilmente à Plataforma Eclipse.</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>Aprenda sobre os conceitos básicos do workbench do Eclipse</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>Descubra como colaborar com outros desenvolvedores</text>
        </link>
		<anchor id="jdtAnchor"/>
		<anchor id="pdeAnchor"/>
	</group>
</group>
Essas âncoras podem ser utilizadas como referência pelos plug-ins que incluem conteúdo na página. O conteúdo é incluído utilizando a extensão de org.eclipse.ui.intro.configExtension. Além de estender o conteúdo da página, esse ponto de extensão também permite a contribuição das partes de conteúdo em espera e ações personalizadas.

Para estender uma configuração de introdução existente, é possível utilizar o elemento configExtension. Neste elemento, você especifica o configId da configuração de introdução sendo estendida e o arquivo de conteúdo que descreve o novo conteúdo.

   <extension
	point="org.eclipse.ui.intro.configExtension">
	<configExtension
		configId="org.eclipse.platform.introConfig"
		content="$nl$/overviewExtensionContent.xml"/>  
    ...
 </extension>
O formato do arquivo de conteúdo é semelhante ao do conteúdo da configuração de introdução, exceto de que deve conter um elemento extensionContent, que define o caminho para a âncora em que o conteúdo da extensão deve ser inserido.
<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>Familiarize-se com os programas de desenvolvimento Java utilizando o Eclipse</text>
		</link>
	</extensionContent>
</introContent>
Depois de contribuir com o conteúdo personalizado para os pontos de âncora predefinidos, um determinado produto pode ligar-se a essa introdução, utilizando o org.eclipse.ui.intro discutido anteriormente. Quando o produto é executado, a introdução que foi estendida será mostrada com o conteúdo adicional. Isso permite que o produto tenha sua própria marca e outras informações específicas do produto, enquanto reutiliza uma introdução do produto relacionado com atenção junto com o próprio conteúdo principal.

Uma determinada introdução também poderia seletivamente incluir trechos de uma introdução do produto relacionado. Neste caso, o produto poderia definir sua própria introdução e configuração de introdução e, em seguida, fazer referência aos elementos importantes definidos em outra configuração de introdução, utilizando um include no arquivo de conteúdo. Esse mecanismo é valioso em situações em que os produtos relacionados são construídos na parte superior de outro e é necessário apresentar usuários aos conceitos principais nos produtos de nível mais alto.