Arbortext editor详细教程.docx
《Arbortext editor详细教程.docx》由会员分享,可在线阅读,更多相关《Arbortext editor详细教程.docx(224页珍藏版)》请在冰豆网上搜索。
Arbortexteditor详细教程
Arbortext®Editor™教程—关于本教程
ArbortextEditor教程介绍了关于使用ArbortextEditor进行编辑和创作的基本概念。
本教程包括常规示例和分步练习,可以在ArbortextEditor中尝试这些内容来进行练习。
这些练习涉及两种文档类型:
DocBook和DITA(达尔文信息类型化体系结构)。
对于这些文档类型,某些ArbortextEditor功能会有所不同。
练习会对不同之处加以注释。
必备知识
以下知识是了解本文档内容的先决条件:
∙熟悉操作系统及计算机
∙具有创作或编辑软件的经验
本指南的结构
本教程按以下顺序编排:
∙结构文档概述–结构文档概念的简介
∙ArbortextEditor环境-ArbortextEditor创作环境的概述。
∙使用ArbortextEditor创作–有关基本创作任务的练习
∙使用DITA主题–介绍DITA主题文档创作方法的练习
∙使用DITA映射–介绍DITA映射文档创作方法的练习
相关文档
有关详细信息,请参考ArbortextEditor帮助中心。
结构文档概述
结构化文档符合定义和控制文档结构的一组规则。
XML和HTML是结构化文档的实例。
定义文档结构的规则集合称为“文档类型”。
在ArbortextEditor中创作文档时,编辑器将持续检查在关联文档类型中定义的规则,并且仅允许将符合这些规则的内容插入到文档中。
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文档中的最后一个标记。
它只能包含文本。
样式表
结构化文档的格式并不存储在文档自身中。
相反,各种文档类型都具有与其相关联的一个或多个样式表,用于通过一系列样式设置来控制文档的外观。
样式设置可包含基本格式化信息,如字体大小、段落间距及页面布局,也可包含更多的高级格式化信息,如目录和索引的自动生成。
通过样式表控制ArbortextEditor窗口中文档的外观。
ArbortextEditor环境
ArbortextEditor用户界面符合标准窗口约定。
下列主题提供了专用于ArbortextEditor的外观和功能的概述。
相关链接
打开示例文档
ArbortextEditor窗口组件
查看光标更改
展开和折叠标记内容
使用拖放操作
删除标记和内容
查看生成的文本
获取帮助
打开示例文档
开始本练习之前,请先启动ArbortextEditor。
ArbortextEditor中的大多数文档类型均具有与其相关的模板和示例文档。
模板是一组预定义的空标记,这些标记提供文档所需的所有基本标记。
在本练习中,您将打开一个示例文档。
1.选择文件 ▶新建可打开新建对话框。
2.选择ArbortextXMLDocBookV4.0,然后选中示例复选框并单击确定。
示例文档会显示在ArbortextEditor窗口中。
请注意,ArbortextEditor窗口中显示的示例文档可能与以下示例中显示的文档有所不同。
ArbortextEditor窗口组件
默认情况下,ArbortextEditor窗口分为两个窗格。
“文档结构图”提供大纲视图,“编辑”视图显示文档的完整内容。
拆分条用于分开“文档结构图”和“编辑”视图。
可以调整该拆分条来更改窗格尺寸。
下图显示了主要的ArbortextEditor窗口组件。
菜单和工具栏
菜单和工具栏会显示一组标准的命令。
有关菜单、工具栏及其功能的详细说明,请参考帮助 ▶ArbortextEditor中提供的联机帮助主题。
“编辑”视图
“编辑”视图显示文档及其内容以及控制文档结构的标记。
可以使用视图菜单更改这些标记的显示。
这些选项用于控制在将内容和新标记添加到文档中时希望看到多少标记结构。
以下示例来自ArbortextXMLDocBook文档类型(文档中显示的标记可能会有所不同):
∙完整标记-显示标记图标和名称。
∙无标记—禁止标记显示。
如果您习惯于在“带标记的视图”环境中工作(例如,使用HTML文档),则可能要使用在ArbortextEditor中显示的标记。
文档结构图
利用“文档结构图”可导航文档结构的图形轮廓。
也可以折叠文档的较大部分并在“文档结构图”中移动它们。
“文档结构图”和“编辑”视图是完全交互的,因此一个窗格中所做的任何更改都会立即反映在另一窗格中。
下图显示了“文档结构图”组件。
“文档结构图”包含下列组件:
∙标记图标
元素
-标识文档中的标记。
与标记相关的内容会与图标一起显示。
∙展开和折叠图标
折叠
–使您能够在文档中折叠标记的内容。
展开
–使您能够在文档中展开标记的内容。
∙修改属性图标
展开修改属性
-与某个元素关联的属性的值在映射中处于未打开状态时显示。
单击此图标可查看属性名称和编辑其关联的值。
收缩修改属性
-与某个元素关联的属性的值在映射中处于打开状态时显示。
单击此图标可关闭属性值的显示。
∙图形图标
图形
-标识文档中的图形。
图形本身不会出现在“文档结构图”中,但是可通过单击与图形关联的“修改属性”图标来获取有关图形的信息。
图形将显示在“编辑”视图中。
∙表格图标
表格
-标识文档中的表格。
“文档结构图”包含表格的标记,但未将表格显示为行和列。
“编辑”视图中将显示表格的图形表示。
状态栏
位于屏幕左下方区域的状态栏显示与ArbortextEditor的界面和操作有关的工具提示和其他消息。
查看光标更改
进行本练习之前,请先在ArbortextEditor中打开ArbortextXMLDocBookV4.0示例文档。
ArbortextEditor光标会根据其在文档结构图和编辑视图中的位置,来更改外观。
按照以下步骤操作以查看某些光标更改:
1.使用箭头键导航“文档结构图”。
光标会根据其位置更改形状。
2.将光标移动到para标记的左侧。
I形光标
表示您可以输入文本和其它可能的标记。
3.键入以下文本:
InsertingtextintomydocumentusingtheDocumentMap.
在输入时,会自动添加新的para标记,以容纳新的文本。
4.将光标移动到chapter标记的末尾。
光标显示为双箭头
,这表示不允许在此位置插入任何文本。
5.键入您的名称。
一条消息将显示在状态栏上,警告您不允许插入文本。
6.在ArbortextEditor窗口外单击。
光标更改为不活动光标
,这表示窗口未处于活动状态。
有关详细信息,请参考ArbortextEditor帮助中的光标主题。
展开和折叠标记内容
进行本练习之前,请先在ArbortextEditor中打开ArbortextXMLDocBookV4.0示例文档。
通过“文档结构图”,可查看或隐藏标记内容,以便更容易浏览文档。
按照以下步骤操作来折叠和展开标记内容:
1.找到“文档结构图”顶部的book标记。
下图所示为完全展开的book标记的层次结构。
2.单击book元素左侧的折叠图标
。
注意,整本书的内容会折叠,但标题会保留,因此您可以识别折叠的内容。
折叠图标被展开图标
所代替,如下图所示。
3.单击展开图标以展开book标记。
相关链接
使用拖放操作
进行本练习之前,请先在ArbortextEditor中打开ArbortextXMLDocBookV4.0示例文档。
您可以仅拖放内容,或拖放标记及其内容、空标记,或内容和标记的混合体。
可以在以下位置使用拖放操作:
∙在文档中
∙同一编辑器窗口中文档的不同视图间
∙在单独文档之间
∙在应用程序之间
按照以下步骤使用拖放操作:
1.在“文档结构图”中,查找para标记。
2.单击与para标记相关的para标记
图标,可选择该标记及其相关内容,如下例所示。
3.单击文本,然后按住鼠标键,沿“文档结构图”分层结构向下拖动所选文本。
注意光标的变化方式:
o如果移动所选区域导致文档结构冲突,系统将显示此符号:
o当所选内容定位在有效粘贴位置时,系统显示此符号:
o如果释放位置定位在有效粘贴位置,但为了保持正确的文档结构而导致已粘贴内容中添加了一个元素,系统将显示此符号:
4.在文档中移动光标,直到光标形状如下所示:
5.释放鼠标按钮,完成拖放操作。
还可以选择para标记内的一些文本,然后将该文本拖动到文档中的其它位置。
对于此操作,显示的符号与移动标记及其内容时相同。
有关详细信息,请参考ArbortextEditor帮助中的拖放操作主题。
相关链接
删除标记和内容
进行本练习之前,请先在ArbortextEditor中打开ArbortextXMLDocBookV4.0示例文档。
可以只删除文本,或删除标记及其内容。
按照以下步骤删除标记:
1.在文档结构图中,单击para元素左侧的标记
图标。
2.按DELETE键。
删除元素及其内容随即删除。
3.单击Undo
工具栏按钮可撤消删除操作。
您还可以选择para标记内的一些文本并仅删除该文本。
有关详细信息,请参考ArbortextEditor帮助中的删除标记对主题。
相关链接
查看生成的文本
进行本练习之前,请先在ArbortextEditor中打开ArbortextXMLDocBookV4.0示例文档。
生成的文本根据文档类型的样式表定义并自动插入到文档中。
举例来说,目录、索引和列表编号便是生成的文本。
生成的文本以不同的字体颜色(默认为蓝色)显示,并且不能在ArbortextEditor中直接对其进行编辑。
按照以下步骤操作以更改生成文本的显示:
1.选择工具 ▶首选项,并选择窗口类别。
2.如果未复选完整菜单,请单击该复选框。
单击“确定”。
3.选择视图 ▶生成的文本 ▶显示可清除所选的内容,并隐藏生成的文本的显示。
4.上下滚动您的文档,并记下缺少的项目符号、章节号和列表编号。
5.再次选择视图 ▶生成的文本 ▶显示可恢复生成的文本的显示。
6.选择视图 ▶生成的文本并记下更新生成的文本可用的选项。
验证是否选择了部分自动更新选项。
7.按ESC键可退出该菜单。
有关详细信息,请参考ArbortextEditor帮助中的生成的文本概述主题。
相关链接
获取帮助
进行本练习之前,请先在ArbortextEditor中打开ArbortextXMLDocBookV4.0示例文档。
ArbortextEditor通过“Arbortext帮助中心”提供联机帮助。
Arbortext帮助中心包含ArbortextEditor的所有文档及其关联产品选件。
帮助中心还包含其它Arbortext产品的文档。
但是,调用帮助中心作为特定产品的联机帮助时,帮助中心仅显示与该产品关联的文档。
按照以下步骤获取帮助:
1.选择帮助 ▶ArbortextEditor。
Arbortext帮助中心出现并显示ArbortextEditor联机帮助。
2.在搜索字段中输入keyboardshortcuts并单击搜索按钮。
帮助中心在搜索
选项卡中显示搜索结果。
请注意,搜索项在标题中突出显示并在搜索结果中显示摘录。
3.在搜索结果列表中选择键盘快捷方式概述主题。
帮助中心显示该主题。
请注意,搜索项在主题中也会突出显示。
默认情况下,搜索项在通过搜索结果显示的主题中突出显示并链接在一起。
可使用TAB键或单击突出显示的搜索项来浏览出现在主题中的各个搜索项。
4.单击在目录中显示
工具栏按钮。
帮助中心打开目录选项卡,并在目录中突出显示键盘快捷方式概述主题。
5.选择键盘快捷方式概述主题下的键盘快捷方式主题。
帮助中心显示键盘快捷方式主题。
6.关闭Arbortext帮助中心。
有关详细信息,请参考“Arbortext帮助中心”帮助。
通过选择帮助
工具栏按钮可访问“帮助中心”帮助。
相关链接
使用ArbortextEditor创作
由于您已比较熟悉ArbortextEditor用户界面,以下主题将提供一些练习,向您介绍如何使用ArbortextEditor创作文档。
相关链接
创建新文档
插入标记和内容
将结构添加到内容
创建并插入文本实体
插入链接
修改属性
插入图形
插入符号
搜索内容
搜索标记
使用表格
检查拼写
将文档另存为HTML
使用更改跟踪
比较文档
创建新文档
按照以下步骤创建新文档:
1.选择文件 ▶新建。
新建对话框打开。
2.在新建对话框中,选择ArbortextXMLDocBookV4.0,然后单击确定。
将ArbortextXMLDocBook模板载入ArbortextEditor窗口。
该模板包括在文档中预填充的标记。
您的模板可能与本书中使用的模板稍有不同。
3.通过选择文件 ▶保存保存您的文档。
另存为对话框将打开。
4.在文件名字段中,输入mydocument。
5.导航到要保存文档的文件夹,并单击保存。
默认情况下,ArbortextEditor将新文档保存到上次使用的目录中。
ArbortextEditor在所选目录中保存新文档。
相关链接
插入标记和内容
在本练习中,将使用您在上次练习中创建的ArbortextXMLDocBook文档。
ArbortextEditor使您能够以多种方式将标记插入文档中,其中包括使用插入标注对话框和工具栏按钮
。
在本练习中,您将使用“快速标记”功能将标记插入文档中。
按照以下步骤将标记和内容插入新文档:
1.在“文档结构图”中,将光标放在现有段落的开头。
2.按ENTER键可显示“快速标记”菜单。
只能使用文档类型允许在该位置出现的标记。
3.使用鼠标单击para可插入新的para标记。
光标针对插入文本自动定位。
4.键入Insertingtextinanewparagraph.
5.将光标放在“编辑”视图中并选择视图 ▶完整标记。
6.在“编辑”视图中,将光标放置在文档顶部的title标记间并键入CreatingStructuredDocuments。
7.将光标放在下一组title标记间(在chapter标记下),然后键入InsertingNewElements。
8.在第二组para标记间,键入Authorswereonceresponsibleformaintainingboththecontentandtheformatoftheirdocuments.Structureddocumentsallowauthorstofocusentirelyoncontent.
9.按ENTER键可从“快速标记”列表选择标记。
10.单击note可插入note元素
11.键入Thisdocumentwaswrittentodemonstrateenteringcontentintoastructureddocument.
12.选择文件 ▶保存可保存您的更改。
有关详细信息,请参考ArbortextEditor帮助中的插入标注和使用快速标记插入标记主题。
相关链接
将结构添加到内容
在本练习中,将使用您在上次练习中修改的ArbortextXMLDocBook文档。
ArbortextEditor允许您将段落块转换为项目符号列表或编号列表。
按照以下步骤创建编号列表:
1.将光标置于最后一个para标记的右侧。
2.将新的para标记插入您的文档,方法是:
按ENTER键并从快速标记列表中选择para标记。
3.输入下列文本,在前三行每一行的结尾处插入新的para标记,从而生成四个para元素及其内容:
编号列表可提供逐步指导。
每个项目前有一个编号,该编号由ArbortextEditor自动生成。
还将自动确定并应用适当的缩进。
利用结构化内容可减少为保持表示形式一致而手动应用格式的工作量。
4.选择所有四个段落(包括para标记),并单击应用程序工具栏上的数字列表工具栏按钮
。
这四个段落随即显示为数字列表。
还可以通过将数字或项目符号列表标记插入到文档并将列表项添加到列表来生成列表。
有关详细信息,请参考ArbortextEditor帮助中的创建列表主题。
创建并插入文本实体
在本练习中,将使用您在上次练习中修改的ArbortextXMLDocBook文档。
实体是您希望能够重复使用的内容块。
当实体的内容更改时,包含实体的文档会自动更新。
可以根据要重复使用的内容量创建文件实体或文本实体。
实体在文档中可以显示为带实体名称的图标或带展开实体内容的图标。
有一些菜单和选项(如实体菜单),只有在已选择显示完整菜单时才可用。
要显示完整菜单,请选择工具 ▶首选项,选择窗口选项卡,并单击完整菜单旁的复选框。
单击确定退出首选项对话框。
注意
DITA文档以不同方式重复使用内容。
有关DITA引用的信息,请参考使用DITA主题。
按照以下步骤创建并插入文本实体:
1.选择某一范围的文本。
2.选择实体 ▶从所选内容创建文本实体。
从所选内容创建文本实体对话框打开。
3.在名称字段中键入mytext,然后单击确定关闭对话框。
4.将光标置于para标记内,并选择实体 ▶文本。
文本实体对话框打开。
5.选择mytext文本实体。
6.单击插入,然后单击关闭关闭对话框。
文本实体随即以图标的形式插入。
7.选择查看 ▶文本实体可查看已展开的实体内容。
有关详细信息,请参考ArbortextEditor帮助中的文本实体概述和文件实体概述主题。
相关链接
插入链接
在本练习中,将使用您在上次练习中修改的ArbortextXMLDocBook文档。
可以使用Link标记从文档中的一个位置链接到另一位置,或链接到URL。
注意
DITA文档支持以不同方式链接。
有关DITA引用的信息,请参考使用DITA主题。
按照以下步骤插入指向URL的链接:
1.插入新的para标记。
2.键入有关结构化文档的详细信息,请参考PTC网站。
3.选择单词PTCwebsite,然后选择插入 ▶链接。
插入链接对话框打开。
4.选择Web选项卡,在URL字段中键入:
//ptc/,然后单击插入以插入链接并关闭对话框。
5.双击突出显示的链接以打开Web浏览器并显示PTCWeb站点。
有关详细信息,请参考ArbortextEditor帮助中的插入链接对话框和插入链接目标对话框主题。
相关链接
修改属性
在本练习中,将使用您在上次练习中修改的ArbortextXMLDocBook文档。
节、标题、段落和列表等标记组成了文档的基本结构。
属性定义标记的特定方面。
添加属性可指定特定属性,如文件引用、放大和字体样式。
注意
DITA文档允许以不同方式修改某些属性。
有关修改DITA引用的信息,请参考使用DITA主题。
按照以下步骤修改属性以更改字体样式:
1.选择段落中的任意1个词,并按Enter键激活快速标记菜单。
2.选择emphasis标记。
单词格式更改为斜体。
emphasis应用到此文档类型中的文本时,斜体是默认字体样式。
3.选择编辑 ▶修改属性。
修改属性对话框打开。
4.在角色字段中键入bold,然后单击确定关闭对话框。
注意,在“编辑”视图和“文档结构图”中单词的格式从斜体更改为粗体。
5.在“文档结构图”中,单击相应的修改属性
图标以查看为此标记定义的属性列表。
6.再次单击修改属性
图标可关闭属性列表。
有关详细信息,请参考帮助中的属性-概述ArbortextEditor主题。
相关链接
插入图形
在本练习中,将使用您在上次练习中修改的ArbortextXMLDocBook文档。
在ArbortextEditor中,通过引用将图形包括在文档中。
文档包含对外部图形文件(不是图形自身)的引用。
注意
DITA文档允许以不同方式插入图形。
有关DITA引用的信息,请参考使用DITA主题。
按照以下步骤插入图形并修改图形尺寸:
1.插入新的para标记。
2.选择插入 ▶图形。
插入图形对话框打开。
3.选择inlinegraphic标记以使图形与文档中的文本走向相一致,然后单击确定。
定位引用图形文件对话框打开