探索Eclipse帮助系统与本地CVS服务器搭建

### 探索Eclipse帮助系统与本地CVS服务器搭建 #### 1. Eclipse帮助系统简介 Eclipse帮助系统包含的帮助文档数量取决于插件作者编写的内容。对于Eclipse自带的插件，文档通常很丰富，完成特定任务所需的额外说明较少。Eclipse中有三种类型的帮助： - **普通帮助**：在帮助窗口中显示，可直接选择主题、搜索文档中的术语或使用之前设置的书签。 - **信息弹出框（上下文相关帮助）**：当按下F1时，根据光标位置显示帮助内容和零个或多个指向额外帮助的链接。 - **活动链接**：嵌入在帮助文件中的可执行链接，用于在Eclipse内执行一些Java代码以扩展帮助信息。 此外，还可以通过选择主题，点击右上角工具栏的打印机按钮或右键点击主题并选择“打印目标”来打印帮助文件。 #### 2. 帮助窗口 通过主菜单选择“帮助” -> “帮助内容”可打开帮助窗口，该窗口分为左右两个区域： - **导航框架（左侧）**：可显示四种视图。 - **查看器框架（右侧）**：始终显示所选的文档。 双击任一框架的标题，框架会填满窗口，再次双击则恢复到原始大小并重新显示隐藏的框架。 ##### 2.1 书架内容视图 导航框架的默认视图是书架标签（最左侧的第一个标签），使用书籍图标。视图标题为“内容”，除非之前设置了工作集，否则会显示所有可用文档。单击书籍标题会显示书籍内容的树状视图，若链接处有信息，其内容会显示在内容窗口中。 ##### 2.2 搜索视图 在使用帮助系统一段时间后，才会熟悉各个主题的位置。在此之前，可以使用搜索结果视图（导航框架的第二个标签，使用手电筒图标）。搜索字段始终位于帮助窗口顶部，无需手动选择该标签。输入搜索条件后，搜索结果将显示在搜索结果视图中。 搜索文档的规则如下： - **大小写不敏感**：例如，“ECLIPSE”、“eclipse”和“EcLiPsE”被视为相同。 - **支持搜索表达式运算符**：支持“AND”、“OR”和“NOT”，若未明确指定运算符，则默认使用“AND”。 - “J2EE email”：返回同时使用这两个词的页面。 - “J2EE OR email”：返回使用其中一个或两个词的页面。 - “J2EE NOT email”：返回包含“J2EE”但不包含“email”的页面。 - **双引号用于指定词组**：例如，“Hello world”会按给定顺序查找这两个词同时出现的页面。 - **支持单字符和多字符通配符**：“?”表示单字符通配符，“*”表示多字符通配符。 - “app?”：返回匹配“MyApp”等单词的页面。 - “app*”：返回匹配“AppletArgumentsTab”和“appropriate”等单词的大量页面。 - **使用标点符号分隔搜索词**：“Hello world”和“hello.world”的搜索结果相同。若需要在搜索中考虑标点符号，需将搜索项用双引号括起来。 - **某些单词会被搜索引擎忽略**：如“and”、“at”、“the”等。尽量避免使用这些单词，因为它们对搜索结果没有影响，但即使使用了也无需担心，系统会自动忽略。 - **使用词干提取**：搜索引擎会对搜索词进行词干提取，匹配其变体。例如，搜索“write”时，结果中的“Active help”文档可能没有高亮显示“write”，因为搜索引擎匹配的是“writing”。 为了减少搜索范围，可以创建自定义的帮助文档子集。具体操作如下： 1. 点击搜索字段“Go”按钮右侧的“Search Scope”链接，打开第一个帮助对话框。 2. 默认选择“Search All Topics”单选按钮，选择“Search Only the Following Topics”单选按钮，然后点击“New”。 3. 在“Help - Eclipse Platform”对话框的“List Name”字段中输入“Eclipse core search”，并选择前五个文档。 4. 点击“OK”完成帮助对话框，再次点击“OK”关闭“Select Search Scope”对话框。 ##### 2.3 链接视图 与上下文相关帮助直接相关的是链接视图。在使用Eclipse时按下F1，帮助系统会根据当前窗口焦点猜测合适的帮助主题，并弹出信息弹出框，提供一系列链接供选择。点击链接会打开帮助窗口，在链接视图中显示相关链接。 例如，关闭帮助窗口，打开Eclipse的Java透视图，点击一次大纲视图，按下F1，会弹出信息弹出框，显示“View to show the outline (if applicable) of a resource being edited”以及“Views”和“Outline View”链接。点击任一链接，帮助窗口会重新出现，链接视图显示这两个链接，内容窗口显示所选链接的帮助信息。 ##### 2.4 书签 帮助系统中的书签与浏览器中的书签类似。在Eclipse帮助窗口中，右侧第二个按钮是书签按钮，点击可创建指向书签页面的链接。 创建书签的步骤如下： 1. 打开帮助窗口，选择书架标签。 2. 选择“Java Development User Guide”，然后选择“Tips and Tricks”。 3. 点击书签按钮，选择导航器视图底部的“Bookmark”标签，书签视图会显示指向“JDT Tips and Tricks”页面的书签。 若要删除书签，可选择不需要的书签并按Delete键，或右键点击链接并从弹出菜单中选择“Delete”。 ##### 2.5 工作集 工作集类似于前面创建的搜索范围子集。创建新的帮助工作集的步骤如下： 1. 进入Java透视图的包资源管理器视图或插件透视图，点击视图工具栏的最后一个