Versão 3.0
Este documento descreve a estrutura do arquivo de conteúdo de introdução como uma série de fragmentos DTD (esquema XML legível por máquina).
introContent
<!ELEMENT introContent (page+ , group* , extensionContent*)>
O elemento introContent define o corpo do arquivo de conteúdo da introdução. O arquivo de conteúdo é feito de páginas, grupos compartilhados que podem ser incluídos em várias páginas e extensões para pontos de âncora definidos em outras configurações.
page
<!ELEMENT page (group* | link* | text* | head* | img* | include* | html* | title? | anchor*)>
<!ATTLIST page
url CDATA #IMPLIED
id CDATA #REQUIRED
style CDATA #IMPLIED
alt-style CDATA #IMPLIED
filteredFrom (swt|html)
content CDATA #IMPLIED
style-id CDATA #IMPLIED>
Este elemento é utilizado para descrever uma página a ser exibida. A introdução pode exibir páginas dinâmicas e estáticas.
O conteúdo para as páginas dinâmicas é gerado a partir de subelementos da página, descritos a seguir. O estilo ou estilo alt será aplicado, dependendo da apresentação. Os estilos podem ser mais aprimorados, utilizando como referência o id ou o id de classe.
As páginas estáticas permitem a reutilização dos documentos HTML existentes dentro da introdução e podem ser vinculados a partir de qualquer página estática ou dinâmica. As páginas estáticas não estão definidas em um elemento de página, elas são simplesmente arquivos html que podem estar vinculados a outras páginas.
A home page, cujo id está especificado no elemento de apresentação do ponto de extensão da configuração de introdução, pode ter uma url indicando que é uma página estática. Se nenhuma url estiver especificada, presume-se que a home page seja dinâmica. Todas as outras páginas descritas utilizando o elemento de página são dinâmicas.
Observe também que quando a apresentação SWT é utilizada e uma página estática deve ser exibida, um navegador externo é ativado e a página atual permanece visível.
Os subelementos utilizados em uma página dinâmica são os seguintes: Um subelemento group é utilizado para agrupar o conteúdo relacionado e aplicar o estilo no conteúdo agrupado. Um subelemento link define um link que pode ser utilizado para vincular uma página estática ou dinâmica e executar uma ação/comando de introdução. Normalmente, um link é definido no nível de página para navegar entre as páginas principais e os links em uma página. Um subelemento text define o conteúdo textual no nível de página. Um subelemento head só é aplicável para a apresentação baseada na Web e
permite que html adicional seja incluído na seção head de HTML. Isso é útil para incluir scripts java ou folhas de estilo extras. Um subelemento img
define conteúdo de imagem para o nível de página. Um subelemento include permite a reutilização de qualquer elemento diferente de uma página. Um subelemento html
só é aplicável para a apresentação baseada na Web e permite a incorporação ou inclusão de
html no conteúdo da página.A incorporação permite que um arquivo html totalmente
definido seja incorporado em um object HTML, definindo o arquivo html como
referência. A inclusão permite incluir um snippet html diretamente de um arquivo html. Um subelemento title define o título da página. Um subelemento anchor define um ponto em que as contribuições externas podem ser feitas por um elemento <extensionContent>.
group
<!ELEMENT group (group* | link* | text* | img* | include* | html* | anchor*)>
<!ATTLIST group
id CDATA #REQUIRED
label CDATA #IMPLIED
style-id CDATA #IMPLIED
filteredFrom (swt|html) >
Utilizado para agrupar o conteúdo relacionado, o conteúdo deve ter um estilo semelhante aplicado ou o conteúdo que será incluído em outras páginas.
link
<!ELEMENT link (text? , img?)>
<!ATTLIST link
id CDATA #IMPLIED
label CDATA #IMPLIED
url CDATA #REQUIRED
style-id CDATA #IMPLIED
filteredFrom (swt|html) >
Pode vincular um arquivo HTML estático, um web site externo ou pode executar um a ação Intro URL.
nome da ação - descrição da ação
parâmetro de ação1 - descrição do parâmetro
parâmetro de ação2 (opcional) - descrição do parâmetro
parâmetro de ação3 (opcional) = ("true" | "false") "false" - descrição do parâmetro, opção de true ou false e "false" é o padrão
close - fecha a parte da introdução
nenhum parâmetro necessário
navigate - navega pelas páginas de introdução em uma determinada direção ou retornar para a home page
direction = ("backward" | "forward" | "home") - especifica a direção da navegação
openBrowser - abre a url em um navegador externo
url - uma URL válida para um web site externo ou um arquivo HTML estático
pluginId (opcional) - somente necessário se um arquivo HTML estático estiver especificado. Este é o id do plug-in contendo o arquivo.
runAction - executa a ação especificada
class - o nome completo da classe que implementa uma dasorg.eclipse.ui.intro.config.IIntroAction
,
org.eclipse.jface.actino.IAction
ou org.eclipse.ui.IActionDelegate
pluginId - A id do plug-in que contém a classe.
standby (opcional) = ("true" | "false") "false" - indica se o modo de espera deve ser configurado para a introdução depois de executar a ação
parâmetros adicionais - quaisquer parâmetros adicionais são transmitidos para ações que implementamorg.eclipse.ui.intro.config.IIntroAction
setStandbyMode - define o estado da parte da introdução
standby = ("true" | "false") - true para colocar a parte da introdução em seu modo de espera parcialmente visível e false para torná-lo completamente visível
showHelp - Abre o sistema de ajuda.
nenhum parâmetro necessário
showHelpTopic - Abre um tópico da ajuda.
id - a URL do recurso de ajuda. (Consulte Javadoc para org.eclipse.ui.help.WorkbenchHelp.displayHelpResource
showMessage - Exibe uma mensagem para o usuário, utilizando um diálogo de informações padrão.
message - a mensagem a ser mostrada para o usuário
showStandby - Configura a parte da introdução para o modo de espera e mostra o standbyContentPart com a entrada fornecida
partId - o id de standbyContentPart a ser mostrado
input - a entrada a ser configurada em standbyContentPart
showPage - mostra a página da introdução com o id fornecido
id - o id da página de introdução a ser mostrada
standby (opcional) = ("true" | "false") "false" - indica se a introdução deve ser configurada no modo de espera depois de mostrar a página
html
<!ATTLIST html
id CDATA #REQUIRED
src CDATA #REQUIRED
type (inline|embed)
style-id CDATA #IMPLIED
filteredFrom (swt|html) >
HTML direto a ser incluído na página por incorporação de todo o documento ou inserção de um snippet do HTML no local. Uma imagem de fallback ou de texto deve ser definida para processamento da apresentação swt alternativa.
A incorporação permite que um arquivo html completamente definido seja incorporado ao conteúdo da página dinâmica. Um elemento do objeto HTML é criado e faz referência ao arquivo html.
A inclusão permite incluir um snippet de html diretamente de um arquivo para uma página html dinâmica.
title
<!ELEMENT title EMPTY>
<!ATTLIST title
id CDATA #IMPLIED
style-id CDATA #IMPLIED
filteredFrom (swt|html) >
um snippet do texto que pode opcionalmente conter marcações HTML de escape. É utilizado somente como Título da Página e assim uma determinada página pode ter no máximo um elemento de título.
text
<!ELEMENT text EMPTY>
<!ATTLIST text
id CDATA #IMPLIED
style-id CDATA #IMPLIED
filteredFrom (swt|html) >
um snippet do texto que pode opcionalmente conter marcações HTML de escape. Pode incluir as marcações b e li. Pode conter também as âncoras para urls. Se vários parágrafos são necessários, o texto pode ser dividido em várias seções, começando e terminando com a marcação p.
include
<!ELEMENT include EMPTY>
<!ATTLIST include
configId CDATA #IMPLIED
path CDATA #REQUIRED
merge-style (true | false) >
expande um elemento destinado pelo caminho determinado e os atributos configId opcionais. O caminho deve exclusivamente direcionar um elemento dentro da configuração especificada. Poderia apontar para um grupo compartilhado no nível de configuração ou qualquer elemento em uma página.
true
, estilo pertencente à página que possui o elemento incluído será incluído na lista de estilos da página de inclusão. Se false
(o padrão), a página de inclusão será responsável pelo controle das propriedades do elemento incluído.head
<!ELEMENT head EMPTY>
<!ATTLIST head
src CDATA #REQUIRED>
HTML direto a ser incluído em uma área de conteúdo HEAD da página. Permite que html adicional seja incluído na seção HEAD de HTML. Isso é útil para a inclusão de scripts java ou folhas de estilo extras. Esta marcação deve ser utilizada somente com um HTML com base na implementação da parte da introdução. Ela é simplesmente ignorada no caso de uma implementação dos Formulários da UI. Uma página pode ter mais de um elemento de título.Uma implementação pode ter um e somente um elemento de título (desde que seja compartilhado em todas as páginas).
img
<!ELEMENT img EMPTY>
<!ATTLIST img
id CDATA #REQUIRED
src CDATA #REQUIRED
alt CDATA #IMPLIED
style-id CDATA #IMPLIED
filteredFrom (swt|html) >
Uma imagem que representa o conteúdo da introdução e não a apresentação (conforme o oposto das imagens de decoração definidas nos estilos).
extensionContent
<!ELEMENT extensionContent (text | group | link | html | include)>
<!ATTLIST extensionContent
style CDATA #IMPLIED
alt-style CDATA #IMPLIED
path CDATA #REQUIRED>
O conteúdo a ser incluído na âncora de destino. Somente um extensionContent é permitido em uma determinada configExtension porque se essa extensão não puder ser resolvida (se a configuração não foi localizada ou o elemento de âncora de destino não foi localizado), as páginas e/ou grupos na extensão precisarão ser ignorados.
anchor
<!ELEMENT anchor EMPTY>
<!ATTLIST anchor
id CDATA #IMPLIED>
uma âncora é o elemento utilizado para declarar extensibilidade. É um local na configuração que permite contribuições externas. Somente as âncoras são valores de destino válidos para o atributo de caminho em um extensionContent
Copyright (c) 2004 IBM Corporation e outros.
Todos os direitos reservados.
Este programa e os materiais que o acompanham são disponibilizados sob os termos da Common Public License v1.0 que acompanha esta distribuição e estão disponíveis no endereço http://www.eclipse.org/legal/cpl-v10.html