Formato XML do Arquivo de Conteúdo de Introdução

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.




As ações predefinidas serão descritas utilizando este formato:

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


As seguintes ações predefinidas são incluídas na estrutura da introduçã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


  • style-id - Um meio de classificar este link em uma determinada categoria para que um estilo comum possa ser aplicado.
  • filteredFrom - um atributo opcional que permite filtrar um determinado elemento fora de uma implementação específica. Por exemplo, se um grupo tem filteredFrom = swt, significa que este grupo não aparecerá como conteúdo na implementação swt.
  • html


    <!ELEMENT html (img | text)>

    <!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.


    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