Las páginas de bienvenida permiten que el usuario se familiarice con un aspecto concreto del entorno de trabajo.
Cada característica puede contribuir con una página de bienvenida. Para ello se incluye un atributo welcomePage en el archivo about.ini situado en el subdirectorio del conector de la característica.
welcomePage = $nl$/welcome.xml
El valor del atributo welcomePage es un archivo al estilo XML que define
la página de bienvenida.
El archivo tiene el siguiente formato:
Código <welcomePage> con
El atributo format puede tener el valor "wrap" o "nowrap". Si el valor del atributo format es "wrap", el texto del editor de bienvenida se acomodará para que se ajuste al tamaño de la ventana. Tenga en cuenta que los saltos de línea del texto se conservarán durante la acomodación a menos que se utilicen códigos de párrafo (<p>). Si no se especifica el atributo format, se utilizará el valor por omisión "nowrap".
Los códigos intro e item pueden contener lo siguiente
El texto situado entre códigos <p> se tratará como si fuera una línea continua (es decir, los saltos de línea situados dentro del texto <p> serán "temporales" (soft)). El código <p> sólo se aplica cuando format = "wrap". Si format = "nowrap", los códigos de párrafo se pasarán por alto.
pluginId (identificador del conector que contiene la acción)
class (nombre calificado de la clase de acción de la que hay que crear una instancia y que debe ejecutarse)
id (ID del conjunto informativo que debe mostrarse en el visor de la ayuda)
href (opcional: URL válido del tema de ayuda contenido en el
conjunto informativo especificado y que presenta el siguiente formato:
/idConector/vía_de_acceso_al_documento)
Observe que el texto situado entre los códigos de inicio y fin de las acciones y los temas de ayuda aparecerá en forma de enlace resaltado.
A continuación figura un ejemplo de página de bienvenida. El texto del segundo elemento se acomodará.
<?xml version="1.0" encoding="UTF-8" ?> <welcomePage title="Plataforma Eclipse" format = "wrap"> <intro>Esta página le ayudará a familiarizarse con el entorno de trabajo de Eclipse. Para empezar, lea las secciones que figuran más abajo y pulse los enlaces relacionados. </intro> <item><b>Características instaladas </b> Para obtener más información sobre las características instaladas en el entorno de trabajo, elija <action pluginId="org.eclipse.ui" class="org.eclipse.ui.internal.QuickStartAction">Ayuda > Bienvenido...</action> y seleccione la característica que le interesa.</item> <item><b>Perspectivas, vistas y editores </b> <p>Una ventana contiene una o varias perspectivas. Cada perspectiva consta de vistas (como la vista Navegador) y editores que le permiten trabajar con los recursos. La barra de accesos directos situada en la parte más a la izquierda de la ventana le permite abrir perspectivas nuevas y moverse entre las que ya estén abiertas. La perspectiva en la que está trabajando en este momento se muestra en el título de la ventana y en la barra de accesos directos, en forma de icono que se ha pulsado.</p></item> <item><b>Configurar las perspectivas</b> Puede mover las vistas y los editores de un sitio a otro del entorno de trabajo tan solo con arrastrar las barras de título. También puede añadir más vistas a la perspectiva actual con las opciones Ventana > Mostrar vista. Para restablecer la perspectiva a su estado original, elija <action pluginId="org.eclipse.ui" class="org.eclipse.ui.internal.ResetPerspectiveAction">Ventana > Restablecer perspectiva</action>. Una vez organizada su perspectiva, puede guardarla con las opciones Ventana > Guardar perspectiva como... Puede personalizar las vistas, las perspectivas y las operaciones del menú Nuevo que se muestran en su perspectiva. Para ello, elija <action pluginId="org.eclipse.ui" class="org.eclipse.ui.internal.EditActionSetsAction">Ventana > Personalizar perspectiva...</action>. Además, podrá convertir una vista en vista rápida tan solo con arrastrarla a la barra de accesos directos (situada en el extremo izquierdo de la ventana). </item> <item><b>Más información </b> Para obtener más información, puede examinar el <topic id="/org.eclipse.platform.doc.user/toc.xml">Manual del usuario del entorno de trabajo</topic>.</item> </welcomePage>