Welcome pages are used to familiarize the user with a given aspect of the workbench.
Each feature can contribute a welcome page. This is done by including a welcomePage attribute in the about.ini file in the subdirectory of the feature's plug-in.
welcomePage = $nl$/welcome.xml
The value of the welcomePage attribute is an XML-like file defining the welcome page.
The file has the following format:
<welcomePage> tag with
The intro and item tags can contain the following
pluginId (the id of the plug-in containing the action)
class (the qualified name of the action class to instantiate and run)
id (the id of the infoset to show in the help viewer)
href (optional - a valid help topic URL
contained in the specified infoSet and having the following
format:
/pluginID/path_to_document)
Note that text between the start and end tags for actions and help topics will appear as a highlighted link.
Example welcome page:
<?xml version="1.0" encoding="UTF-8" ?> <welcomePage title="Eclipse Platform"> <intro>This page will help familiarize you with the Eclipse Workbench. To get started, read the sections below and click on the related links. </intro> <item><b>Installed Features </b> To find out more about the features installed in your workbench, choose <action pluginId="org.eclipse.ui" class="org.eclipse.ui.internal.QuickStartAction">Help > Welcome...</action> and select the feature you are interested in.</item> <item><b>Perspectives, views and editors </b> A window contains one or more perspectives. A perspective consists of views (e.g. Navigator) and editors for working with your resources. The shortcut bar at the far left of the window allows you to open new perspectives and move between perspectives that are already open. The perspective you are currently working with is shown in the title of the window and in the shortcut bar as a pushed-in icon.</item> <item><b>Configuring your perspectives</b> You can move views and editors around the workbench by dragging their titlebars. You can also add more views to your current perspective by using Window > Show View. To reset the perspective to its original state, choose <action pluginId="org.eclipse.ui" class="org.eclipse.ui.internal.ResetPerspectiveAction">Window > Reset Perspective</action>. Once you have arranged your perspective, you can save it using Window > Save Perspective As.... You can customize the views, perspectives and New menu operations that show up for your perspective. To do this choose <action pluginId="org.eclipse.ui" class="org.eclipse.ui.internal.EditActionSetsAction">Window > Customize Perspective...</action> . A view can additionally be converted into a Fast View by dragging it to the shortcut bar (at the far left of the window). </item> <item><b>Learn more </b> To learn more you can browse the <topic id="/org.eclipse.platform.doc.user/toc.xml">Workbench User Guide</topic>.</item> </welcomePage>