Versión 3.0
Este documento describe la estructura del archivo de contenido de introducción como una serie de fragmentos DTD (esquema XML legible por máquina).
introContent
<!ELEMENT introContent (page+ , group* , extensionContent*)>
El elemento introContent define el cuerpo del archivo de contenido de introducción. El archivo de contenido está formado por páginas, grupos compartidos que pueden incluirse en varias páginas y extensiones para puntos de anclaje definidos en otras configuraciones.
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 se utiliza para describir una página que debe visualizarse. La introducción puede visualizar páginas tanto estáticas como dinámicas.
El contenido de las páginas dinámicas se genera desde los subelementos de la página, descritos más adelante. Se aplicará el estilo o estilo alternativo dependiendo de la presentación. Los estilos pueden mejorarse haciendo referencia al ID o ID de clase.
Las páginas estáticas permiten la reutilización de documentos HTML existentes en la introducción del usuario, y éste puede enlazarse a ellas desde cualquier página estática o dinámica. Las páginas estáticas no se definen en un elemento page, sino que son
simplemente archivos html a los que otras páginas pueden enlazarse.
La página inicial, cuyo ID se especifica en el elemento presentation del punto de extensión intro config, puede tener un URL que indique que se trata de una página estática. Si no se especifica ningún URL, se presupone que la página inicial es dinámica. Todas las demás páginas descritas mediante el elemento page son dinámicas.
Tenga en cuanta también que, si se utiliza la presentación SWT y debe visualizarse una página estática, se lanza un navegador externo y la página actual permanece visible.
Los subelementos utilizados en una página dinámica son los siguientes: un subelemento
group se utiliza para agrupar contenido relacionado y aplicar el estilo a todo el contenido agrupado. Un subelemento link define un enlace que puede utilizarse para enlazarse a una página estática o dinámica y ejecutar una acción/mandato de introducción. Un enlace se define generalmente a nivel de página para navegar entre páginas principales, al contrario que los enlaces situados dentro de una página. Un subelemento text define contenido textual a nivel de página. Un subelemento head sólo es aplicable a la presentación basada en la Web y permite añadir html adicional a la sección HTML head. Esto resulta de utilidad para añadir scripts Java u hojas de estilo adicionales. Un subelemento imgdefine contenido de imagen a nivel de página. Un subelemento
include permite reutilizar cualquier elemento que no sea una página. Un subelemento html sólo es aplicable a la presentación basada en la Web y permite incluir o intercalar html en el contenido de la página. La intercalación permite intercalar un archivo html totalmente definido dentro de un objeto HTML haciendo referencia al archivo html. La inclusión permite incluir un fragmento de código html directamente desde un archivo html. Un subelemento title define el título de la página. Un subelemento
anchor define un punto en el que pueden efectuarse contribuciones externas mediante un 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 contenido relacionado, contenido al que debe aplicarse un estilo similar o contenido que se incluirá en otras 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) >
Puede enlazarse a un archivo HTML estático, a un sitio Web externo o puede ejecutar una acción de URL de introducción.
nombre acción - descripción de acción
parámetro1 de acción - descripción de parámetro
parámetro2 de acción (opcional) - descripción de parámetro
parámetro3 de acción (opcional) = ("true" | "false") "false" - descripción de parámetro, opción de elegir true o false; el valor por omisión es "false"
close - cierra el componente intro
no se requieren parámetros
navigate - navega por las páginas de introducción en un sentido dado o vuelve a la página inicial
direction = ("backward" | "forward" | "home") - especifica el sentido de la navegación
openBrowser - abrir el URL en un navegador externo
url - un URL válido a un sitio Web externo o a un archivo HTML estático
pluginId (opcional) - sólo es necesario si se especifica un archivo HTML estático. Se trata del ID del conector que contiene el archivo.
runAction - ejecuta la acción especificada
class - nombre de clase totalmente calificado de la clase que implementa
org.eclipse.ui.intro.config.IIntroAction
,
org.eclipse.jface.actino.IAction
o
org.eclipse.ui.IActionDelegate
pluginId - ID del conector que contiene la clase.
standby (opcional) = ("true" | "false") "false" - indica si debe establecerse la introducción en modalidad de espera después de ejecutar la acción
parámetros adicionales - los parámetros adicionales se pasan a las acciones que implementan
org.eclipse.ui.intro.config.IIntroAction
setStandbyMode - establece el estado del componente intro
standby = ("true" | "false") - true para situar el componente intro en su modalidad de espera parcialmente visible, y false para hacerlo totalmente visible
showHelp - abrir el sistema de ayuda.
no se requieren parámetros
showHelpTopic - abrir un tema de la ayuda.
id - URL del recurso de ayuda. (Consulte el Javadoc de org.eclipse.ui.help.WorkbenchHelp.displayHelpResource
)
showMessage - muestra al usuario un mensaje mediante un diálogo de información estándar.
message - el mensaje que debe mostrarse al usuario.
showStandby - establece el componente intro en modalidad de espera y muestra el
standbyContentPart con la entrada dada
partId - ID del standbyContentPart que debe mostrarse
input - entrada que debe establecerse en el standbyContentPart
showPage - mostrar la página de introducción con el ID dado
id - ID de la página de introducción que debe mostrarse
standby (opcional) = ("true" | "false") "false" - indica si debe establecerse la introducción en modalidad de espera después de mostrar la página
html
<!ATTLIST html
id CDATA #REQUIRED
src CDATA #REQUIRED
type (inline|embed)
style-id CDATA #IMPLIED
filteredFrom (swt|html) >
HTML directo que debe incluirse en la página incorporando todo el documento o un fragmento de HTML in situ. debe definirse una imagen o texto de urgencia para la visualización de presentación SWT alternativa.
La intercalación permite intercalar un archivo html totalmente definido dentro del contenido de una página dinámica. Se crea un elemento HTML object que hace referencia al archivo html.
La inclusión permite incluir un fragmento de código html directamente desde un archivo html en la página html dinámica.
title
<!ELEMENT title EMPTY>
<!ATTLIST title
id CDATA #IMPLIED
style-id CDATA #IMPLIED
filteredFrom (swt|html) >
fragmento de texto que puede contener opcionalmente códigos de escape HTML. Sólo se utiliza como título de página, y por tanto una página determinada puede tener un máximo de un elemento title.
text
<!ELEMENT text EMPTY>
<!ATTLIST text
id CDATA #IMPLIED
style-id CDATA #IMPLIED
filteredFrom (swt|html) >
fragmento de texto que puede contener opcionalmente códigos de escape HTML. Puede incluir códigos b y li. También puede contener anclas para los URL. Si son necesarios varios párrafos, el texto puede dividirse en varias secciones, cada una de las cuales empieza y termina con el código p.
include
<!ELEMENT include EMPTY>
<!ATTLIST include
configId CDATA #IMPLIED
path CDATA #REQUIRED
merge-style (true | false) >
expande un elemento dirigido por la vía de acceso especificada y atributos configId opcionales. La vía de acceso debe dirigir exclusivamente un elemento dentro de la configuración especificada. Puede señalar a un grupo compartido definido a nivel de configuración o a cualquier elemento de una página.
true
, el estilo que pertenece a la página propietaria del elemento incluido se añadirá a la lista de estilos de la página incluyente. Si es false
(valor por omisión), la página incluyente será responsable de controlar las propiedades del elemento incluido. head
<!ELEMENT head EMPTY>
<!ATTLIST head
src CDATA #REQUIRED>
HTML directo que debe incluirse en el área de contenido HEAD de una página. Permite añadir html adicional a la sección HTML HEAD. Esto resulta de utilidad para añadir scripts Java u hojas de estilo adicionales. Este código sólo debe utilizarse con una implementación de componente intro basada en HTML. En el caso de una implementación de formularios de UI, simplemente se pasa por alto. Una página puede tener más de un elemento head. Una implementación sólo puede tener un elemento head (ya que lo comparten todas las páginas).
img
<!ELEMENT img EMPTY>
<!ATTLIST img
id CDATA #REQUIRED
src CDATA #REQUIRED
alt CDATA #IMPLIED
style-id CDATA #IMPLIED
filteredFrom (swt|html) >
Imagen que representa contenido de introducción y no de presentación (al contrario de las imágenes de decoración definidas en los estilos).
extensionContent
<!ELEMENT extensionContent (text | group | link | html | include)>
<!ATTLIST extensionContent
style CDATA #IMPLIED
alt-style CDATA #IMPLIED
path CDATA #REQUIRED>
Contenido que debe añadirse al ancla destino. Sólo se permite un extensionContent en una configExtension dada, ya que, si esta extensión no puede resolverse (si no puede encontrarse la configuración o el elemento anchor destino), las páginas y/o grupos de la extensión deben pasarse por alto.
anchor
<!ELEMENT anchor EMPTY>
<!ATTLIST anchor
id CDATA #IMPLIED>
un ancla es el elemento utilizado para declarar la ampliabilidad. Es una ubicación de la configuración que permite contribuciones externas. Sólo las anclas son valores destino válidos para el atributo path de un extensionContent
Copyright (c) 2004 IBM Corporation y otros.
Reservados todos los derechos. Este programa y sus materiales adjuntos están disponibles
bajo los términos de la licencia pública común (Common Public License) v1.0 que acompaña a
esta distribución, y está disponible en
http://www.eclipse.org/legal/cpl-v10.html