Definir el contenido de la introducción
Ahora podemos preocuparnos del contenido propiamente dicho. El contenido se describe en términos de páginas. Todas las páginas tienen un atributo id.
Se trata del ID utilizado al definir las páginas de presentación y espera y en otras ubicaciones en las que exista una referencia a una página. De lo contrario, los atributos relevantes dependerán del tipo de página que se defina.
Existen dos tipos básicos de páginas:
- Las páginas estáticas son archivos HTML planos. Estas páginas utilizan los
mecanismos HTML habituales para enlazar con otras páginas. Las páginas estáticas no necesitan definirse en el archivo de contenido de configuración, excepto en el caso de la página de presentación. Dado que la página de presentación se especifica por ID
(id-página-presentaciónen el elemento presentation, debe haber una definición de página que utilice ese ID en el archivo de contenido. Esta página sólo necesita definir un url. Todos los demás subelementos se pasarán por alto, ya que la propia página HTML describirá el contenido de la página. Todas las demás páginas de introducción HTML añadidas por el conector deben incluirse en el conector, pero no es necesario especificarlas en el archivo de contenido. También puede hacerse referencia a los archivos HTML ubicados en otros conectores o en la Web.
- Las páginas dinámicas se describen en el archivo de contenido XML mediante subelementos que describen el contenido de la página. Los subelementos son elementos de UI que se encuentran a menudo en páginas de tipo HTML. Dependiendo de la implementación, estas
páginas se convertirán dinámicamente a HTML (cuando el tipo de implementación sea
html) o se crearán dinámicamente como formularios de UI basados en SWT (cuando el tipo
de implementación sea swt). En una página pueden definirse los siguientes subelementos:
- Un elemento group se utiliza para agrupar otros subelementos y definir un estilo coherente en el grupo.
- Un elemento link define un enlace que puede visualizarse mediante una imagen y un texto. El enlace puede navegar a otra página y, opcionalmente, ejecutar una acción de introducción. Las acciones se especifican como mandatos en el URL.
- Los elementos text e img muestran contenido de texto e imágenes.
- El elemento include incluye un subelemento definido anteriormente. Se hace referencia al elemento por su ID.
- El elemento head define código HTML adicional que debe incluirse en la sección de cabecera de la página cuando se utiliza la implementación html.
- El elemento html define código HTML adicional que debe incluirse en el cuerpo de
la página cuando se utiliza la implementación html.
También puede definirse un título para una página. Una página también puede especificar que su contenido se defina en un archivo de contenido independiente. El hecho de dividir las páginas en archivos independientes puede ser útil cuando el rendimiento es importante, ya que el contenido de una página de introducción no se inicializará hasta que sea necesario.
La mejor manera de hacerse una idea del formato de la definición de contenido es examinar las implementaciones del SDK. El siguiente fragmento de código muestra sólo la primera parte del contenido de la página raíz del SDK, que es la primera página de introducción que se muestra.
<introContent>
<page alt-style="css/root_swt.properties" style="css/root.css" id="root" style-id="page">
<title style-id="intro-header">Bienvenido a Eclipse Platform 3.0</title>
<group id="links-background">
<group id="page-links">
<link label="Visión general" url="http://org.eclipse.ui.intro/showPage?id=overview" id="overview" style-id="left">
<text>Información introductoria acerca de Eclipse</text>
</link>
<link label="Guías de aprendizaje" url="http://org.eclipse.ui.intro/showPage?id=tutorials" id="tutorials" style-id="left">
<text>Permítanos guiarle por medio de guías de aprendizaje completas de Eclipse</text>
</link>
<link label="Ejemplos" url="http://org.eclipse.ui.intro/showPage?id=samples" id="samples" style-id="right">
<text>Explore el desarrollo de Eclipse por medio de ejemplos de código</text>
</link>
<link label="Novedades" url="http://org.eclipse.ui.intro/showPage?id=news" id="news" style-id="right">
<text>Conozca las novedades de este release</text>
</link>
</group>
</group>
Los elementos de una página también pueden filtrarse (filteredFrom) de una implementación determinada. Esto permite a los diseñadores de páginas realizar el diseño pensando en plataformas determinadas. Al describir una página y su contenido pueden utilizarse muchos otros
atributos que tienen muchas posibilidades. Consulte la documentación del punto de extensión org.eclipse.ui.intro.config
y su especificación de formato de archivo de contenido de introducción asociada para obtener la lista completa de elementos válidos, subelementos y sus atributos.