As páginas de Bem-vindo são utilizadas para familiarizar o usuário com um determinado aspecto do workbench.
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
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:
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.
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)
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>