Expandir o conteúdo de uma configuração de introdução

Os plug-ins podem contribuir com conteúdo de introdução para uma página definida noutro lugar. Todavia, a página definidora deve definir um atributo anchor que sirva de marcador de lugar para novo conteúdo. A página de descrição geral do SDK define duas âncoras para adicionar elementos relacionados com JDT e PDE na página de descrição geral.

   <group id="page-content">
	<text style-id="page-title" id="page-title">DESCRIÇÃO GERAL</text>
	<text style-id="page-description" id="page-description">O Eclipse é uma espécie de plataforma de ferramentas universal - um IDE extensível e aberto para tudo em geral e nada em particular. Constitui um ambiente de desenvolvimento rico em funções que permtie ao programador criar eficientemente ferramentas para se integrarem imperceptivelmente na plataforma Eclipse.</text>
	<group id="overview-links">
		<link label="Iniciação à área de trabalho" url="http://org.eclipse.ui.intro/showHelpTopic?id=/org.eclipse.platform.doc.user/concepts/concepts-2.htm" id="iniciação">
            <text>Learn about basic Eclipse workbench
concepts</text>
        </link>
        <link label="Suporte a equipas" url="http://org.eclipse.ui.intro/showHelpTopic?id=/org.eclipse.platform.doc.user/concepts/concepts-26.htm" id="equipa">
			<text>Saiba como colaborar com outros programadores</text>
        </link>
         <anchor id="jdtAnchor"/>
         <anchor id="pdeAnchor"/>
    </group>
    </group>

Estas âncoras podem ser referenciadas por plug-ins que adicionem conteúdo à página. O conteúdo é adicionado com a extensão org.eclipse.ui.intro.configExtension. Além de estender conteúdo de páginas, este ponto de extensão também permite contributos de partes de conteúdo em espera e acções personalizadas.

Para estender uma configuração de introdução existente, poderá utilizar o elemento configExtension. Neste elemento, especifica-se o configId da configuração de introdução a ser estendida e o ficheiro content 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 ficheiro de conteúdo é semelhante ao do conteúdo da configuração de introdução, salvo em que deve conter um elemento extensionContent que defina o caminho até à âncora onde deve ser inserido o conteúdo da extensão.

   <introContent>
      <extensionContent
            alt-style="css/swt.properties"
            style="css/overview.css"
            path="overview/page-content/overview-links/jdtAnchor">
		<link label="Programação Java" url="http://org.eclipse.ui.intro/showHelpTopic?id=/org.eclipse.jdt.doc.user/gettingStarted/qs-BasicTutorial.htm" id="java">
			<text>Conheça como desenvolver programas Java com o Eclipse</text>
        </link>
	</extensionContent>
</introContent>
Depois de contribuir com conteúdo para pontos de âncora predeterminados de uma introdução, dado produto pode associar-se a essa introdução através do org.eclipse.ui.intro debatido supra. Quando o produto é executado, a introdução que foi estendida será mostrada com o conteúdo adicional. Isto permite ao produto ter a sua própria marca e outras informações inerentes a produtos, enquanto reutiliza a introdução de um produto intimamente relacionado junto com conteúdo crucial muito próprio.

Uma dada introdução também pode incluir selectivamente pedaços da introdução de um produto relacionado. Neste caso, o produto poderia definir a sua própria introdução e configuração de introdução e depois referenciar elementos importantes definidos noutra configuração de introdução, através de include no ficheiro de conteúdo. Este mecanismo é valioso em situações em que sejam construídos produtos relacionados em cima um do outro e seja necessário apresentar conceitos essenciais aos utilizadores em produtos de nível superior.