ノート一覧へ

Krasjet/pdf.tocgen

AI 要約 · Qwen 要約は中国語 収録日
原文を読む

pdf.tocgen 是一套用于自动提取和生成 PDF 目录的 Python 命令行工具,适合处理软件生成的 PDF 文件。

项目定位

  • pdf.tocgen 是一个 Python 3 命令行工具集
  • 用于自动提取并生成 PDF 文件的目录(ToC)
  • 通过标题的字体属性和位置推断 PDF 大纲

适用范围

  • 最适合由 pdftex、pdflatex、pdfxetex 等 TeX 工具生成的 PDF
  • 也可用于其他软件生成的 PDF,如 troff/groff、InDesign、Word
  • 不适用于扫描版 PDF

安装方式

  • 可用 pip install -U pdf.tocgen 安装
  • 也可用 pipx 或 pip install -U --user pdf.tocgen 安装
  • 已知支持 Python 3.7 到 3.11,覆盖 Linux、Windows 和 macOS

核心工作流

  • pdfxmeta 提取标题元数据并生成 recipe 文件
  • pdftocgen 根据 recipe 生成目录
  • pdftocio 将目录导入 PDF 文档

命令能力

  • pdftocio 可显示、写入、导入目录,并支持复制目录
  • pdftocgen 可输出目录,并用 -v 保留标题垂直位置
  • pdfxmeta 可搜索关键词、按页搜索、dump 页面或整个文档

开发与许可

  • 开发依赖使用 poetry 管理,测试命令为 make test
  • Emacs 的 toc-mode 可作为 GUI 前端
  • 源码采用 GNU GPLv3,recipes 目录采用 CC BY-NC-SA 4.0