远程 GoToR 注释 XFDF 交换

映射注释编解码器经原生 headless、普通已加载文档以及既有 Windows/Linux 回调注释导入导出路径,保留远程 GoToR action

交换只序列化 PDF action 数据;不执行 action、不解析路径、不读取远程文档,也不打开阅读器

结构

<xfdf xmlns="http://ns.adobe.com/xfdf/">
  <annots>
    <link page="0" rect="10,10,30,30">
      <OnActivation><Action>
        <GoToR NewWindow="yes">
          <File OriginalName="../manuals/remote.pdf"/>
          <Dest><Fit Page="42"/></Dest>
        </GoToR>
      </Action></OnActivation>
    </link>
  </annots>
</xfdf>

GoToR 恰好要求一个 File 和一个 Dest 子元素,顺序不限,File 要求 OriginalName

远程显式目标使用远程文档中从零开始的整数页码,范围 0 到 2147483647,与当前文档页数无关

保存的远程目标以该整数开头,而不是指向本地页的间接引用

具名目标保留其 Unicode 名称,不解析本地目标名称树

八种显式目标模式保留既有的坐标、可空值和精确十进制行为

NewWindow 分别保留「省略」「false」「true」三种情形;设界的兼容 profile 接受 yes/no、true/false 和 1/0

文件规格与 Unicode

导入创建带 F 和 UF 值的外部 Filespec 字典;UF 是权威的 Unicode 目标,用 PDFDocEncoding 或带 BOM 的 UTF-16BE 表示

F 在可表示时使用 PDFDocEncoding,否则保留 UTF-8 兼容字节;忽略 UF 的旧阅读器可能把这些回退字节解释成别的样子

路径保持不透明的拼写,不做操作系统转换,也没有文件系统访问

导出接受外部文件规格字符串或字典,UF 优先于 F

校验与事务

整个远程 action 子树遵循既有的 Adobe 命名空间 profile,包括正确绑定的前缀;普通编解码器保留其显式的 legacy 无命名空间兼容 profile

外来命名空间、重复或缺失的必需子元素、意外属性、非法目标类型、畸形数值或窗口值,都会在原生事务发布之前被拒绝

原生快照准备保留既有的字节、对象、深度、工作存储和取消限制

既有 JSON 操作记录、公开回调布局和符号保持不变

Windows 普通导入还执行经认证的当前图、加密与签名修订版策略

格式引用与边界

File、GoToR、OriginalName 和 NewWindow 的映射遵循 Adobe 的 XML Forms Data Format Specification 3.0 印刷页 59、63 和 87-88

远程 PDF action 与文件规格语义遵循 ISO 32000-1:2008 7.11.2、7.11.3 和 12.6.4.3 节

这个仅路径 profile 不传输内嵌 GoToE 文档、平台专属文件替代表、文件系统选择器、描述、任意 action 链、AP 流或 FDF action 交换