Gerenciando Links

A maioria das extensões que entram nas páginas de boas-vindas principais oferecem links para abrir páginas adicionais contribuídas pelas próprias extensões. Recomenda-se criar essas páginas de forma a continuar com o design visual de boas-vindas compartilhadas. O requisito principal é mostrar o navegador apropriado no início da página.

É relativamente simples fazer isso utilizando o elemento 'include'. A idéia é incluir o conteúdo de navegação no começo da página contribuída. Ao contrário da implementação atual de boas-vindas, as páginas principais de boas-vindas compartilhadas têm seção de navegação diferente para cada página. Por essa razão, as páginas que se ramificam nessas páginas devem incluir a navegação da página pai. Exemplo:

   <introContent>
      <extensionContent id="extra" name="Extra" alt-style="css/swt.properties" style="css/overview.css" path="overview/@">
         <link
               label="Link de Visão Geral Extra"
               url="http://org.eclipse.ui.intro/showPage?id=extraOverview" 
               id="extra-overview">
            <text>Mostrando a página extra de terceiro nível para visão geral</text>
         </link>
      </extensionContent>
      <page id="extraOverview" style="$theme$/html/overview.css" style-id="page">
         <title style-id="intro-header">$introTitle$</title>
         <group id="extra-group1" filteredFrom="swt"/>
         <include path="overview/navigation-links"/>
         <group id="page-content">
            <group id="content-header" label="VISÃO GERAL EXTRA" filteredFrom="swt">
            </group>
            <text style-id="page-title" id="page-title" filteredFrom="html">VISÃO GERAL EXTRA</text>
            <text style-id="page-description" id="page-description">Descrição da página de visão geral extra.</text>
            <!-- Incluir conteúdo aqui -->
         </group>
      </page>
   </introContent>

A extensão anterior contribuída na página de visão geral contribui com um link que mostra outra página cuja definição faz parte da extensão. Observe como definimos o elemento de título utilizando variável de substituição (a variável será resolvida com base na propriedade do produto). Nós também incluímos o grupo 'navigation-links' que pertence à página 'overview' no começo da definição de conteúdo da página. Incluímos também a divisão 'extra-group1', pois ela pode ser utilizada por alguns temas para inclusão de decoração de página adicional (de fato, ela é utilizada no tema 'Malha Roxa' com esse exato propósito).