Arbortext? Editor? 教程—关于本教程
Arbortext Editor 教程介绍了关于使用 Arbortext Editor 进行编辑和创作的基本概念。本教程包括常规示例和分步练习,可以在 Arbortext Editor 中尝试这些内容来进行练习。
这些练习涉及两种文档类型:DocBook 和 DITA (达尔文信息类型化体系结构)。对于这些文档类型,某些 Arbortext Editor 功能会有所不同。练习会对不同之处加以注释。 必备知识
以下知识是了解本文档内容的先决条件:
熟悉操作系统及计算机 ? 具有创作或编辑软件的经验
?
本指南的结构
本教程按以下顺序编排:
? ? ? ? ?
结构文档概述 – 结构文档概念的简介
Arbortext Editor 环境 - Arbortext Editor创作环境的概述。 使用 Arbortext Editor 创作 – 有关基本创作任务的练习 使用 DITA 主题 – 介绍 DITA 主题文档创作方法的练习 使用 DITA 映射 – 介绍 DITA 映射文档创作方法的练习
相关文档
有关详细信息,请参考 Arbortext Editor 帮助中心。
结构文档概述
结构化文档符合定义和控制文档结构的一组规则。XML 和 HTML 是结构化文档的实例。
定义文档结构的规则集合称为―文档类型‖。在 Arbortext Editor 中创作文档时,编辑器将持续检查在关联文档类型中定义的规则,并且仅允许将符合这些规则的内容插入到文档中。DocBook 和 DITA (达尔文信息类型化体系结构) 是文档类型的实例。 文档类型定义文档的以下组成部分:
?
可在文档中使用的标记集
标记是结构化文档的基本构建块。标记是一个容器,具有起始标记和结束标记。标记可包含其它标记、属性和文本。段落和列表是标记的实例。
?
与各标记关联的―属性‖
属性提供有关标记的附加信息,属性包含在标记内部。例如,标记可具有一个属性,用于定义标记中的信息适用于何种用户类型。
?
用于排列标记的结构
每个文档类型都有一个单独的标记,该标记包含在文档类型中定义的所有其它标记。文档类型定义该外部标记中包含的标记的层次结构。文档类型也定义标记是可选的还是必需的,及其是否可包含其它标记、文本或二者。
下面是用于写信的文档类型的一个示例:
Letter、Date、Greeting、Body、Paragraph、List、Table 或 Close Letter 文档类型包含以下主要标记:
?
Letter
Letter 标记是文档类型中的外部标记,包含另外七个标记。其中四个标记 (Date、Greeting、Body 和 Close) 是必需的,并且必须以该顺序出现在 Letter 文档中。
?
日期
Date 标记必须是插入到 Letter 文档中的第一个标记。它只能包含文本,并且用于包含日期。
?
问候语
Greeting 标记必须是插入到 Letter 文档中的第二个标记。它只能包含文本。
?
正文
Body 标记必须是插入到 Letter 文档中的第三个标记。它只能包含其它标记,而不能包含文本。Body 标记可包含一个或多个 Paragraph、List 或 Table 标记。Body 可以包含任意数量及任意顺序的这些标记。
?
关闭
Close 标记必须是插入到 Letter 文档中的最后一个标记。它只能包含文本。
样式表
结构化文档的格式并不存储在文档自身中。相反,各种文档类型都具有与其相关联的一个或多个样式表,用于通过一系列样式设置来控制文档的外观。样式设置可包含基本格式化信息,如字体大小、段落间距及页面布局,也可包含更多的高级格式化信息,如目录和索引的自动生成。 通过样式表控制 Arbortext Editor 窗口中文档的外观。
Arbortext Editor 环境
Arbortext Editor 用户界面符合标准窗口约定。下列主题提供了专用于 Arbortext Editor 的外观和功能的概述。 相关链接 打开示例文档
Arbortext Editor 窗口组件 查看光标更改
展开和折叠标记内容 使用拖放操作 删除标记和内容 查看生成的文本 获取帮助 打开示例文档
开始本练习之前,请先启动 Arbortext Editor。
Arbortext Editor 中的大多数文档类型均具有与其相关的模板和示例文档。模板是一组预定义的空标记,这些标记提供文档所需的所有基本标记。在本练习中,您将打开一个示例文档。
1. 选择文件 ? 新建可打开新建对话框。
2. 选择 Arbortext XML DocBook V4.0,然后选中示例复选框并单击确定。
示例文档会显示在 Arbortext Editor 窗口中。请注意,Arbortext Editor 窗口中显示的示例文档可能与以下示例中显示的文档有所不同。
Arbortext Editor 窗口组件
默认情况下,Arbortext Editor 窗口分为两个窗格。―文档结构图‖提供大纲视图,―编辑‖视图显示文档的完整内容。拆分条用于分开―文档结构图‖和―编辑‖视图。可以调整该拆分条来更改窗格尺寸。 下图显示了主要的 Arbortext Editor 窗口组件。
菜单和工具栏
菜单和工具栏会显示一组标准的命令。有关菜单、工具栏及其功能的详细说明,请参考帮助 ? Arbortext Editor 中提供的联机帮助主题。 ―编辑‖视图
―编辑‖视图显示文档及其内容以及控制文档结构的标记。可以使用视图菜单更改这些标记的显示。这些选项用于控制在将内容和新标记添加到文档中时希望看到多少标记结构。以下示例来自 Arbortext XML DocBook 文档类型 (文档中显示的标记可能会有所不同):
?
完整标记 - 显示标记图标和名称。
?
无标记 — 禁止标记显示。
如果您习惯于在―带标记的视图‖环境中工作 (例如,使用 HTML 文档),则可能要使用在 Arbortext Editor 中显示的标记。 文档结构图
利用―文档结构图‖可导航文档结构的图形轮廓。也可以折叠文档的较大部分并在―文档结构图‖中移动它们。―文档结构图‖和―编辑‖视图是完全交互的,因此一个窗格中所做的任何更改都会立即反映在另一窗格中。
下图显示了―文档结构图‖组件。
―文档结构图‖包含下列组件:
?
标记图标
元素 - 标识文档中的标记。与标记相关的内容会与图标一起显示。
?
展开和折叠图标
折叠 – 使您能够在文档中折叠标记的内容。 展开 – 使您能够在文档中展开标记的内容。
?
修改属性图标
展开修改属性 - 与某个元素关联的属性的值在映射中处于未打开状态时显示。单击此图标可查看属性名称和编辑其关联的值。
收缩修改属性 - 与某个元素关联的属性的值在映射中处于打开状态时显示。单击此图标可关闭属性值的显示。
?
图形图标
图形 - 标识文档中的图形。图形本身不会出现在―文档结构图‖中,但是可通过单击与图形关联的―修改属性‖图标来获取有关图形的信息。图形将显示在―编辑‖视图中。
?
表格图标
表格 - 标识文档中的表格。―文档结构图‖包含表格的标记,但未将表格显示为行和列。―编辑‖视图中将显示表格的图形表示。
状态栏
位于屏幕左下方区域的状态栏显示与 Arbortext Editor 的界面和操作有关的工具提示和其他消息。
查看光标更改
进行本练习之前,请先在 Arbortext Editor 中打开 Arbortext XML DocBook V4.0 示例文档。 Arbortext Editor 光标会根据其在文档结构图和编辑视图中的位置,来更改外观。按照以下步骤操作以查看某些光标更改:
1. 使用箭头键导航―文档结构图‖。
光标会根据其位置更改形状。 2. 将光标移动到 para 标记的左侧。
I 形光标
表示您可以输入文本和其它可能的标记。
3. 键入以下文本:Inserting text into my document using the Document Map.
在输入时,会自动添加新的 para 标记,以容纳新的文本。 4. 将光标移动到 chapter 标记的末尾。
光标显示为双箭头 5. 键入您的名称。
,这表示不允许在此位置插入任何文本。