欢迎页面用来使用户熟悉工作台的给定方面。
每个功能部件都可添加一个欢迎页面。这是通过将 welcomePage 属性包括在功能部件的插件的子目录中的 about.ini 文件中来完成的。
welcomePage = $nl$/welcome.xml
welcomePage 属性的值类似于定义欢迎页面的 XML 文件。
该文件具有下列格式:
具有下列内容的 <welcomePage> 标记
format 标记可具有值 "wrap" 或 "nowrap"。如果格式属性是 "wrap",将对“欢迎编辑器”内的文本自动换行以适合其窗口的大小范围。注意,当自动换行时将保留文本内的换行符(除非使用了段落(<p>)标记)。如果不指定格式属性,则将使用缺省值 "nowrap"。
intro 和 item 标记可包含下列内容:
<p> 标记之间的文本将被视为一个连续行(即,<p> 文本内的换行符将为“软”换行符)。仅当 format = "wrap" 时,<p> 标记才适用。如果 format = "nowrap",则将忽略段落标记。
pluginId(包含操作的插件的标识)
class(要实例化和运行的操作类的限定名)
id(要显示在帮助查看器中的信息集的标识)
href(可选 — 一个包含在指定信息集中并具有下列格式的有效帮助主题 URL:
/pluginID/path_to_document)
注意,操作和帮助主题的开始和结束标记之间的文本将作为突出显示的链接出现。
以下是示例欢迎页面。将自动换行第二项的文本。
<?xml version="1.0" encoding="UTF-8" ?> <welcomePage title="Eclipse Platform" format = "wrap"> <intro> 此页面将帮助您熟悉“Eclipse 工作台”。要开始入门,请阅读下面各节并单击相关链接。</intro> <item><b>安装功能部件</b> 要了解有关工作台中已安装的功能部件的更多信息,选择 <action pluginId="org.eclipse.ui" class="org.eclipse.ui.internal.QuickStartAction">帮助 > 欢迎使用...</action> 并选择感兴趣的功能部件。</item> <item><b>透视图、视图和编辑器</b> <p>窗口包含一个或多个透视图。一个透视图由用于使用资源的一些视图(例如,导航器)和编辑器组成。窗口最左边的快捷方式栏允许您打开新的透视图并在已经打开的各透视图之间移动。当前正在使用的透视图显示在窗口的标题中并且在快捷方式栏中显示为已显示的图标。</p></item> <item><b>配置透视图</b> 可以通过拖动视图和编辑器的标题栏在工作台中移动它们。还可以通过使用“窗口 > 显示视图”来将其它视图添加至当前透视图。要将透视图复位为其原始状态,选择 <action pluginId="org.eclipse.ui" class="org.eclipse.ui.internal.ResetPerspectiveAction">窗口 > 重新设置透视图</action> 。 一旦安排好透视图,就可以使用“窗口 > 将透视图另存为...”来保存它。可以定制视图、透视图以及透视图中显示的“新建”菜单操作。为此,选择 <action pluginId="org.eclipse.ui" class="org.eclipse.ui.internal.EditActionSetsAction">窗口 > 定制透视图...</action>。 还可以通过将视图拖至快捷方式栏(在窗口的最左边)将视图转换成“快速视图”。</item> <item><b>Learn more </b> 要了解更多信息,可浏览 <topic id="/org.eclipse.platform.doc.user/toc.xml">工作台用户使用指南</topic>。</item> </welcomePage>