书签
PDF 书签的使用方法与目录类似 - 提供了用于浏览 PDF 文档的简便方式。可通过设计脚本书签跳到 PDF 文档中的章节、视图或图纸，以及跳到 Web 链接、播放声音剪辑、提取设计文件中的信息并通过书签进行显示。
可创建以下类型的书签：
书签显示在 Adobe Reader/Acrobat 导航窗格中，通常采用分层树视图结构。某些书签条目（例如文本描述书签）可能没有与其关联的操作，而是用作占位符以形成书签层次结构。
软件始终会为文档中的每张图纸创建一个父书签。此书签条目设置为 sheet_name 关键字值。单击父书签条目时，浏览器将满屏显示整张图纸。此图纸的所有其他书签都创建为父书签的子项。
使用设计脚本关键字可以创建允许 Reader/Acrobat 浏览器缩放到文档中的特定章节或视图的书签。该章节或视图由匹配设计脚本标准的元素的累加矩形范围框定义。缩放因子或比例因子由元素累加范围框定义且可使用 zoom_percentage 关键字进一步调整。
可使用 action_spec 关键字指定书签在书签层次结构中的位置。有关详细信息，请参阅书签模板。
关注区域书签
可为文档中的特定章节或视图创建书签。该章节或视图由匹配设计脚本标准的元素的累加矩形范围框定义。
下表所示为创建关注区域书签时操作关键字的必需/缺省值。
| 关键字 | 值 | 默认值 |
|---|---|---|
| action_item | BOOKMARK | 必需 |
| action_name | 用于在书签选项卡中标识书签条目的唯一字符串。 | 必需 |
| action_type | AREA_OF_INTEREST | 缺省值 - 可选 |
| action_spec | 指定书签在书签层次结构中的位置。如果无指定值，则书签将放置在当前层次结构的最底部。 | 可选方法 |
| action_range | Element_range | cell_range | Element_range |
| action_instance | Single_instance | Multiple_instance | Single_instance |
以下设计脚本创建了数字签名字段的标签。
示例：
! Create a area of interest Digital Signature Field !The accumulated range box of the elements below ! defines the Digital Signature field in the PDF document. if ((level eq 1) and (color eq 9) and (type eq 3)) then action_item = field action_name = "Chief Engineer" action_type = digsig_field action_spec = "John Doe, P.E." ! Create a bookmark to the Digital Signature Field action_item = bookmark action_name = "Signature Field" !Bookmark name (unique) action_type = AREA_OF_INTEREST action_spec = "./digsig/engineer" endif
上面的设计脚本示例创建了以下书签。
文档书签
文档书签用于跳到 PDF 文档中的特定图纸。软件始终会为文档中的每张图纸创建一个父书签，但您也可以创建用于跳到文档中其他图纸的附加书签。
创建文档书签时，action_name 关键字指定单击该书签时书签将跳到的图纸名称。可以使用 sheet_name 关键字为每个图纸定义名称。
下表所示为创建文档书签时操作关键字的必需/缺省值。
| 关键字 | 值 | 默认值 |
|---|---|---|
| action_item | BOOKMARK | 必需 |
| action_name | sheet_name（定义目标图纸名称。） | 必需 |
| action_type | DOCUMENT | 必需 |
| action_spec | 指定书签在书签层次结构中的位置。 | 必需 |
| action_range | 不适用 | 不适用 |
| action_instance | 不适用 | 不适用 |
示例：
! Create a bookmark that jumps to a particular ! sheet in a document for all sheet names beginning with plan*. if (sheet_name eq "plan*") then action_item = BOOKMARK action_name = "details" ! Sheet to jump to action_type = DOCUMENT action_spec = "./Related pages/Details drawing" endif
上面的设计脚本示例创建了以下书签。
Web 链接书签
Web 链接书签用于跳到 Web 页面。对于所有书签类型，都应将 action_item 关键字设置为 bookmark。action_name 关键字用于指定 URL 地址而不是书签条目的名称。书签条目名称派生自 action_spec 关键字中的最后一个条目。例如，如果为 action_spec 关键字指定 action_spec="/Related Web Links/TDOT Standards Specifications"，则该书签条目名称将为 TDOT Standards Specifications。
action_spec 关键字还可指定书签在书签层次结构中的位置。action_type 必须设置为 web_url。
下表所示为创建 Web 链接书签时操作关键字的必需/缺省值。
| 关键字 | 值 | 默认值 |
|---|---|---|
| action_item | BOOKMARK | 必需 |
| action_name | URL HTTP 说明（该值定义 web 链接的 URL。） ) | 必需 |
| action_type | WEB_URL | 必需 |
| action_spec | 指定书签在书签层次结构中的位置并定义书签条目名称。 | 必需 |
| action_range | 不适用 | 不适用 |
| action_instance | 不适用 | 不适用 |
示例：
! Create a bookmark that jumps to a Web page.! action_item = BOOKMARK action_name = "http://www.dot.state.tx.us/cst/2003SpecProj/index.htm" action_type = WEB_URL action_spec = "./Related Web Links/TDOT Standards Specifications"
上面的设计脚本示例创建了以下 Web 链接书签。
声音剪辑书签
声音剪辑书签用于播放 PDF 文档中的音频声音剪辑。对于所有书签类型，都应将 action_item 关键字设置为 bookmark。
action_name 关键字标识声音文件的文件说明，而不是书签条目的名称。书签条目名称派生自 action_spec 关键字中的最后一个条目。
创建声音剪辑书签时，必须将 action_type 关键字设置为 play_sound。action_spec 关键字指定书签在书签层次结构中的位置。
下表所示为创建声音剪辑书签时操作关键字的必需/缺省值。
| 关键字 | 值 | 默认值 |
|---|---|---|
| action_item | BOOKMARK | 必需 |
| action_name | 指定声音文件的文件说明。 | 必需 |
| action_type | PLAY_SOUND | 必需 |
| action_spec | 指定书签在书签层次结构中的位置并定义书签条目名称。 | 必需 |
| action_range | 不适用 | 不适用 |
| action_instance | 不适用 | 不适用 |
示例：
! Create a bookmark that plays a sound clip.! action_item = BOOKMARK action_name = "c:\my audio files\instructions.wav" action_type = PLAY_SOUND action_spec = "./Audio Instructions/Listen Before Installing!"
文本描述书签
文本描述书签用于显示文本信息。使用文本描述书签可以从 DGN 文件提取文本信息并通过书签进行显示，还可对书签内的文本字符串进行硬编码或者在书签中显示任何字符关键字。
对于所有书签类型，都应将 action_item 关键字设置为 bookmark。对于文本描述书签，action_name 同时指定用于标识此书签条目的字符串和书签条目的值。action_type 关键字必须设置为 text_description。
action_spec 关键字指定书签在书签层次结构中的位置。
下表所示为创建文本描述书签时操作关键字的必需/缺省值。
| 关键字 | 值 | 默认值 |
|---|---|---|
| action_item | BOOKMARK | 必需 |
| action_name | 用于标识此特定书签项的唯一字符串。该值将用作新书签条目。 | 必需 |
| action_type | TEXT_DESCRIPTION | 缺省值 - 可选 |
| action_spec | 指定书签在书签层次结构中的位置。如果无指定值，则书签将放置在当前层次结构的最底部。 | 可选方法 |
| action_range | 不适用 | 不适用 |
| action_instance | 不适用 | 不适用 |
以下设计脚本将创建显示图纸标题块中的图纸描述的书签。
示例 1：
! Display the sheet description from the title block.! if (type .eq. text) then if ((level_name .eq."titleblock") and (weight .eq.1)) then !Create a text description bookmark action_item = BOOKMARK action_name = characters !Text string from the drawing. action_type = text_description action_spec = "./Description" endif endif
上面的设计脚本示例创建了以下文本描述书签。
以下设计脚本创建了显示文档中一系列图纸的书签。
示例 2：
! Use a bookmark to display the number of sheets ! in the document. if (sheet_name eq "index of sheets") then !Create a text description bookmark action_item = BOOKMARK action_name = total_pages action_type = TEXT_DESCRIPTION action_spec = "./Number of pages in document" endif
书签模板
可创建定义书签层次结构布局的 XML 文件。bookmark_template 关键字指定 XML 文件的文件说明。例如 bookmark_template = "d:\anystreet\book.xml"。
可使用 action_spec 关键字指定书签在书签层次结构中的位置。action_spec 值由书签分层分支名称组成，其中每个分支名称以正斜线字符 (/) 分隔。句点字符 (.) 表示书签层次结构 ("./branch name 1/branch name 2/branch name 3") 的根或顶部。
使用了书签模板后，action_spec 值中的每个分支名称（从左到右）将与每个书签模板标题比较，直到遇见模板中未定义的分支名称。在此情况下，将使用指定的分支名称创建新分支。使用书签模板示例（见下文），当 action_spec 设置为 ./StormWater/Pit15/MyBookmark 时，将创建以下书签。
Storm Water System 1.2 Kerb Opening (PIT15) MyBookmark
空层次分支将从书签树中移除。但是，如果在 XML 元素中将 XML 特性 KeepAlways 值设置为 1，则可以保留这些空层次分支。此功能用于定义稍后可使用 Acrobat Professional 填充或编辑的书签结构。
书签模板文件示例：
<?xml version="1.0" encoding="UTF-8" ?><bookmark-tree> <bookmark title="WasteWater">Waste Water Supply</bookmark> <bookmark title="WaterSupply">Water Supply System</bookmark> <bookmark title="StormWater">Storm Water System <bookmark title="PIT12">1.2 Kerb Opening (PIT12)</bookmark> <bookmark title="PIT13">1.2 Kerb Opening (PIT13)</bookmark> <bookmark title="PIT14">1.2 Kerb Opening (PIT14)</bookmark> <bookmark title="PIT15">1.2 Kerb Opening (PIT15)</bookmark> <bookmark title="PIT16">1.2 Kerb Opening (PIT16)</bookmark> <bookmark title="PIT17">1.2 Kerb Opening (PIT17)</bookmark> <bookmark title="PIT18">1.2 Kerb Opening (PIT18)</bookmark> <bookmark title="PIT19">1.2 Kerb Opening (PIT19)</bookmark> <bookmark title="PIT20" KeepAlways="1">1.2 Kerb Opening (PIT20)</bookmark> </bookmark> <bookmark title="digsig">Digital Signatures <bookmark title="engineer">Project Engineer</bookmark> <bookmark title="project">Project Manager</bookmark> </bookmark> </bookmark-tree>