PDF 补丁丁简易书签文件格式介绍

简易书签文件主要用于快速制作 PDF 书签，格式介绍如下。

文件头

第一行：“#版本=0.2.1”，表示书签文件的版本。不使用这一行也可以，但在导入时会提示版本不符。“#版本=”后面的版本号是 PDF 补丁丁的程序版本号，可在程序窗口标题栏上看到。高版本的程序一般兼容低版本的书签文件。

书签

除了这一行之外，其他的就是书签内容了。每行正文表示一个书签。

书签由如下四部分组成：①缩进标记（默认为制表符）、②书签文本、③文本和页码之间的分隔符和④页码。

1. 当一个书签具有比前面一个书签多一个缩进标记时，表示这个书签是前面书签的子级书签。第一个书签的文本前必须没有任何缩进标记。
2. 书签文本。缩进标记字符串仅在起始位置有效，在书签文本中出现的缩进标记字符将被当成是书签文本。
3. 文本和页码之间的分隔符可以是一个以上的以下字符：制表符、半角或全角空格、点号“.”、省略号“…”、减号“-”、下划线“_”。
4. 页码：以阿拉伯数字编号的页码。页码后面除了可以有多余的空白之外，不能有任何其它内容。

例如，以下内容定义了六个多级书签，页码分别是1、2、3、4、7、56：

顶级书签........... 1
    次级书签 ______ 2
        三级书签    3
另一个顶级书签 ..... 4
    次级书签2 ----- 7
    次级书签3  ……   56

指定首页页码

很多场合下，我们看到的正文页码都不是在 PDF 文档中的第一页开始的。往往是前面若干页为前言、目录等，很多页之后才是正文。而我们在输入简易书签文本时，通常是对着目录页输入的（如上面的多级书签所示），因此，简易书签文本中的页码在输入时是目录页上的页码，而不是 PDF 文档中的页码。

在书签内容中，可以使用“#首页页码”指令指定下面出现的书签，对应首页页码的实际页码。例如，以下内容定义的“正文”对应的页码为1、“第一章”对应的页码为2，但由于前面出现了“#首页页码=39”指令，因此“正文”实际上对应 PDF 文档中第 39 页，“第一章”对应第 40 页。

#首页页码=39
正文 1
    第一章 2
        第一节 3
    第二章 14

一个简易书签文件可以具有多个“#首页页码”指令，每个指令仅影响后面出现的书签页码与实际页码的对应关系，不影响前面的书签页码。如以下示例出现了多个“#首页页码”指令。

#首页页码=1
封面 1
#首页页码=3
XX 序言 1
自序 5
#首页页码=11
目录 1
#首页页码=39
正文 1
    第一章 2
        第一节 3
    第二章 14

指定缩进标记

程序默认使用制表符作为缩进标记，这在使用支持Tab键缩进内容的编辑器（如AkelPad、EditPlus）中很方便。但有时候使用制表符不太方便（例如在 Excel 中输入书签文件，不好输入制表符）。这时可以使用“#缩进标记”指令指定缩进标记。例如，以下示例使用“。”作为缩进标记。

#首页页码=39
#缩进标记=。
正文 1
。第一章 2
。。第一节 3
。第二章 14

可以使用超过一个字符作为缩进标记，例如以下示例使用了“、、、”作为缩进标记。

#首页页码=39
#缩进标记=、、、
正文 1
、、、第一章 2
、、、、、、第一节 3
、、、第二章 14

与“#首页页码”指令类似，“#缩进标记”可以在简易书签文件中出现多次，也只对出现在其后面的书签文本有效。