PDF2zh插件在zotero中安装并使用

1、首先根据PDF2zh说明文档，安装PDF2zh

https://github.com/guaguastandup/zotero-pdf2zh/tree/v2.4.0

我没有使用conda，直接使用pip安装pdf2zh
（Python版本要求3.10 <= version <=3.12）

pip install pdf2zh==1.9.6 flask pypdf       # 安装需要的包
pip install pdfminer.six==20250416          # 修正pdfminer安装版本

安装完成之后，测试PDF2zh的安装是否成功

pdf2zh document.pdf # document.pdf是待翻译的文件

成功的情况下会在待翻译文件的同目录下生成相应的翻译文件

2、在zotero中安装pdf2zh插件

https://zotero-chinese.com/plugins/#search=pdf2

这是zotero的插件商店，搜索pdf2zh查找pdf2zh插件，点击下载，将.xpi文件下载到本地

打开zotero，点击工具 -> 插件，右上角 Install Plugin From File…,选择刚刚下载的文件安装插件

3、配置相关文件

新建并配置 config.json 文件
在电脑任意位置新建一个名为 config.json 的文件，并填入以下模板：

{
    "USE_MODELSCOPE": "0",
    "NOTO_FONT_PATH": "/app/SourceHanSerifCN-Regular.ttf",
    "translators": [
        {
            "name": "deeplx",
            "envs": {
                "DEEPLX_ENDPOINT": "http://localhost:1188/translate/",
                "DEEPLX_ACCESS_TOKEN": null
            }
        },
        {
            "name": "ollama",
            "envs": {
                "OLLAMA_HOST": "http://127.0.0.1:11434",
                "OLLAMA_MODEL": "gemma2"
            }
        }
    ]
}

新建并配置 server.py 文件
复制server.py的全部代码，新建文件命名为 server.py 并将内容粘贴进去

需要修改的是脚本中的默认配置：

设置翻译后文件的输出路径（临时路径，用完可删）

translated_dir = "./translated/"  

设置配置文件 config.json 的路径

config_path = './config.json'  

建议使用绝对路径，例如：(ctrl + shift +c复制路径)

4、zotero插件相关配置

点击编辑 -> 设置

我的配置基本不变，安装插件安装后的默认设置
下面是说明文档中对于插件设置中各个值得基本说明：

5、在zotero中使用插件翻译pdf

首先运行 server.py 脚本：

python server.py

然后在Zotero中找到需要翻译的文献PDF，右键点击想要得到得结果即可生成相应的文件

参考文章：

https://rosetears.cn/index.php/archives/42/
https://github.com/guaguastandup/zotero-pdf2zh/tree/v2.4.0