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