Páginas de Bem-vindo

As páginas de Bem-vindo são utilizadas para familiarizar o usuário com um determinado aspecto do workbench.

Página de Bem-vindo Padrão

Cada recurso pode contribuir com uma página de bem-vindo. Isso é feito incluindo um atributo  welcomePage no arquivo about.ini no subdiretório do plug-in de recurso.

welcomePage = $nl$/welcome.xml

O valor do atributo welcomePage é um arquivo tipo XML que define a página de bem-vindo.
O arquivo tem o seguinte formato:

<welcomePage> marcação com 

  1. um atributo de título opcional
  2. um atributo de formato opcional
  3. uma marcação de <intro> opcional
  4. 0 ou mais marcações de <item>

A marcação format pode ter os valores "wrap" ou "nowrap". Se o atributo format for "wrap", o texto no Editor Bem-vindo será agrupado para se ajustar ao tamanho da janela. Observe que as quebras de linhas no texto serão preservadas durante o agrupamento a menos que marcações de parágrafo (<p>) sejam utilizadas. Se o atributo format não for especificado, o valor padrão "nowrap" será utilizado.

As marcações de intro e item podem conter o seguinte:

  1. Texto (com quebras de linhas preservadas)
  2. Marcações de parágrafo (<p>) para indicar qual texto deve ser agrupado.

    O texto entre marcações <p> será tratado como uma linha contínua (isto é, as quebras de linhas dentro do texto em <p> serão "suaves"). A marcação <p> é aplicada somente quando format = "wrap". Se format = "nowrap", as marcações de parágrafos serão ignoradas.

  3. Marcações em negrito (<b>)
  4. Marcações de ação (<ação>) contendo os seguintes atributos

    plug-inId (o id do plug-in contendo a ação)

    class (o nome qualificado da classe de ação para iniciar a execução)

  5. Marcações do tópico da ajuda (<tópico>) contendo os seguintes atributos

    id (o id do infoset para mostrar no visualizador da ajuda)

    href (opcional - um URL de tópico de ajuda válida contido no infoSet específico e com o seguinte formato:  
    /pluginID/path_to_document
    )

Note que o texto entre o início e o fim das marcações para ações e tópicos de ajuda aparecerão como um link em destaque.

A seguir é apresentado uma página de boas-vindas de exemplo. O texto do segundo item será agrupado.

<?xml version="1.0" encoding="UTF-8" ?>
<welcomePage 
    title="Plataforma Eclipse"
    format = "wrap">

<intro>Essa página o ajudará a familiarizar-se com o Workbench do Eclipse.
Para iniciar, leia as seções abaixo e clique nos links relacionados. </intro>

<item><b>Recursos Instalados </b>
Para saber mais sobre os recursos instalados em seu workbench, escolha
<action pluginId="org.eclipse.ui"
   class="org.eclipse.ui.internal.QuickStartAction">Help > Welcome...</action>
e selecione o recurso em que você está interessado.</item>

<item><b>Perspectivas, exibições e editores </b>
<p>Uma janela contém uma ou mais perspectivas. Uma perspectiva consiste em exibições (por exemplo Navegador)
e editores para trabalhar com seus recursos.
A barra de atalho na extremidade esquerda permite abrir perspectivas novas e movimentar-se
entre as perspectivas que já estão abertas. A perspectiva com que você está atualmente trabalhando
é mostrada no título da janela e na barra de atalho como um ícone embutido.</p></item>

<item><b>Configurando suas perspectivas</b>
Você pode mover exibições e editores no workbench arrastando suas barras de título. Você pode
também incluir mais exibições em sua perspectiva atual utilizando Janela > Mostrar Exibição.
Para redefinir a perspectiva para seu estado original, escolha
<action pluginId="org.eclipse.ui"
   class="org.eclipse.ui.internal.ResetPerspectiveAction">Janela > Redefinir Perspectiva</action>.
Quando você tiver organizado sua perspectiva, poderá salvá-la utilizando a Janela > Salvar Perspectiva Como....
Você pode personalizar as exibições, perspectivas e operações de menu Novo que surgirem para
sua perspectiva. Para fazer isso, escolha
<action pluginId="org.eclipse.ui"
   class="org.eclipse.ui.internal.EditActionSetsAction">Janela > Personalizar Perspectiva...</action> .
Uma exibição pode, adicionalmente, ser convertida em uma Exibição Rápida, arrastando-a para a barra de atalho (à
esquerda da janela). </item>

<item><b>Aprender mais </b>
Para aprender mais, você pode procurar o
<topic id="/org.eclipse.platform.doc.user/toc.xml">Guia do Usuário do Workbench</topic>.</item>

</welcomePage>

Copyright IBM Corporation e outros 2000, 2002.