🦀 dagtoc 📖

用于添加、获取和删除 PDF 内容的命令行工具

简介

dagtoc 使用 MuPdf 作为底层的 PDF 操作器。

安装

语言包管理器

• 通过 cargo 安装

  $ cargo install dagtoc
  

Archlinux

• 从源代码安装

  $ paru -S dagtoc
  

• 或安装二进制文件

  $ paru -S dagtoc-bin
  

用法

我将展示如何使用 dagtoc 处理 demo 目录中的文件。

目录

目录的载体格式是 KDL，它是一种优秀的森林结构文档语言。

大纲看起来像

- <title> <page>

如果有子大纲，它们被写成节点的子节点

- <title> <page> {
    - <title1> <page>
    - <title2> <page>
    ...
}

你可以肯定地嵌套它们！请参阅 Makefile.kdl 以获取实际的目录。

添加目录

$ dagtoc -a Makefile.kdl Makefile-NOTOC.pdf -o Makefile.pdf

此外，您可以使用 -x 来指定添加目录的页面编号偏移（±）。这可以帮助您修正所有页面编号都偏移了相同常数的目录。 如果任何页面的编号减少到非正数，则会出现页面出界错误。

删除目录

$ dagtoc -d Makefile.pdf -o Makefile-NOTOC.pdf

获取目录

$ dagtoc -g Makefile.pdf > Makefile.kdl

此外，您可以使用 -x 来指定获取目录的页面编号偏移（±）。这可以帮助您修正所有页面编号都偏移了相同常数的 PDF 目录。 如果编号减少到非正数，则页面编号将为空。

检查目录

$ dagtoc -c Makefile.pdf

检查 PDF 中的页面编号是否递增且不为空。

记住 dagtoc

dagtoc = 删除-添加-获取目录