如何用 PDFMathTranslate 的 -p 参数只翻译 PDF 的指定页码
【免费下载链接】PDFMathTranslate[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero项目地址: https://gitcode.com/GitHub_Trending/pd/PDFMathTranslate
用 PDFMathTranslate 翻译整篇论文之前，你可能只想先翻摘要和前几页，或者只翻译某几页表格所在的页面。此时不需要对全文执行翻译，用命令行参数-p指定页码范围即可。前提是在本地装好pdf2zh命令行工具：Python 版本要求为 3.11 <= 版本 <= 3.12。
安装命令行工具
两种安装方式任选其一，都以 README.md 的说明为准：
# 方式一：pip pip install pdf2zh# 方式二：uv pip install uv uv tool install --python 3.12 pdf2zh安装完成后，翻译直接在命令行执行，结果文件生成在当前工作目录。
-p 参数的写法
docs/ADVANCED.md 的 “Full / partial translation” 一节给出了两种对照用法：
# 翻译整个文档 pdf2zh example.pdf# 只翻译文档的一部分 pdf2zh example.pdf -p 1-3,5文档中出现的页码写法有两种形式：
- 单个页码：README 选项表中的示例是
pdf2zh example.pdf -p 1，即只处理第 1 页； - 范围加单页的组合格式：
-p 1-3,5，即第 1 到 3 页以及第 5 页。
文档未给出其他格式（如倒序、跨组范围等）的说明，建议按上面两种已验证的形式书写页码。
执行一次指定页码的翻译
最短主路径（把example.pdf替换为你的文件名）：
pdf2zh example.pdf -p 1-3,5不指定-s时默认使用 Google 翻译服务，无需设置环境变量。需要时可以在同一命令中追加其他高级选项，README.md 的选项表列出了可组合的参数，例如指定输出目录、源语言和目标语言：
pdf2zh example.pdf -p 1-3,5 -o output -li en -lo zh-o output表示把输出文件放到output目录；-li/-lo分别指定源语言和目标语言代码（语言代码可参照 docs/ADVANCED.md 给出的 Google 与 DeepL 语言代码表）。改用其他翻译服务时用-s指定，但对应服务所需的环境变量必须先设置，具体见 docs/ADVANCED.md 的服务表。
验证结果
运行完成后在当前工作目录（或-o指定的目录）检查生成的文件。以example.pdf为输入时，文档说明会生成两个文件：
- 译文文档
example-mono.pdf - 双语对照文档
example-dual.pdf
确认这两个文件已生成、并且打开后翻译内容覆盖你在-p中指定的页码，即说明本次部分翻译执行成功。文档没有为-p单独的成功日志或命令行校验方式，验证就以输出文件为准。
已知限制与排查
首次运行需要下载布局分析模型（
wybxc/DocLayout-YOLO-DocStructBench-onnx），网络不佳时可能失败。README 给出的解决办法是先设置环境变量再运行：# cmd 环境 set HF_ENDPOINT=https://hf-mirror.com# PowerShell $env:HF_ENDPOINT = https://hf-mirror.com重复翻译同一内容时会命中翻译缓存，如果想强制重新翻译，追加
--ignore-cache（见 docs/ADVANCED.md）。
如果只处理指定页码的需求到此为止，上面的主路径已经完整；其余选项（线程数-t、自定义字体保留-f/-c等）都属于针对全文翻译的调优项，按需查阅 docs/ADVANCED.md 即可。
【免费下载链接】PDFMathTranslate[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero项目地址: https://gitcode.com/GitHub_Trending/pd/PDFMathTranslate
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
