Zotero pdf2zh配置教程

前提条件:安装了Docker desktop

  1. 在自己电脑上找一个喜欢的位置,创建主文件夹命名为zotero_pdf2zh,后面称其为root目录
  2. 进入 zotero_pdf2zh 文件夹，在内部再创建一个同名的子文件夹 zotero-pdf2zh。
  3. 进入这个子文件夹,在里面创建一个名为 translated 的空文件夹。
  4. 在root目录中,新建docker-compose.yaml,内容如下:
services:
    zotero-pdf2zh:
        build:
            context: .
            dockerfile: Dockerfile
            args:
                # 使用更新、更稳定的 pdf2zh_next 引擎
                - ZOTERO_PDF2ZH_FROM_IMAGE=awwaawwa/pdfmathtranslate-next:latest
                - ZOTERO_PDF2ZH_SERVER_FILE_DOWNLOAD_URL=https://raw.githubusercontent.com/guaguastandup/zotero-pdf2zh/refs/heads/main/server.py
        container_name: zotero-pdf2zh
        restart: unless-stopped
        ports:
            - 8888:8888
        environment:
            - TZ=Asia/Shanghai
            - HF_ENDPOINT=https://hf-mirror.com
        volumes:
            # 将本地文件夹映射到容器内部
            - ./zotero-pdf2zh/translated:/app/translated
            - ./zotero-pdf2zh/config.toml:/app/config.toml
            - ./zotero-pdf2zh/LXGWWenKai-Regular.ttf:/app/LXGWWenKai-Regular.ttf
  1. 在root目录下创建Dockerfile
ARG ZOTERO_PDF2ZH_FROM_IMAGE
FROM ${ZOTERO_PDF2ZH_FROM_IMAGE}

ARG ZOTERO_PDF2ZH_SERVER_FILE_DOWNLOAD_URL

WORKDIR /app

RUN apt-get update && \
    uv pip install --system -U flask waitress pypdf

ADD "${ZOTERO_PDF2ZH_SERVER_FILE_DOWNLOAD_URL}" /app/
RUN sed -i '/path = path\.replace/ s/ #//' /app/server.py

EXPOSE 8888
CMD ["python", "server.py", "8888"]
  1. 在zotero_pdf2zh\zotero-pdf2zh目录下,创建config.toml
[translate_engine]
# 默认翻译服务
default_translator = "zhipu"

[translate_engine.zhipu]
# 您的智谱AI API Key
api_key = "在这里粘贴您自己的API Key"
# 使用的模型
model = "glm-4-flash"
# API基地址
base_url = "https://open.bigmodel.cn/api/paas/v4"

[pdf_handler]
# 指定翻译后PDF使用的中文字体
default_font_path = "./LXGWWenKai-Regular.ttf"
  1. (可选)配置pdf翻译使用的中文字体

至此,文件夹结构如下

~\zotero_pdf2zh\
    │  Docker-compose.yaml
    │  Dockerfile
    └─zotero-pdf2zh
        │  config.toml
        │  LXGWWenKai-Regular.ttf
        └─translated
  1. 构建docker镜像

在~\zotero_pdf2zh\ 文件夹中,通过终端打开,执行:

# 构建镜像
docker compose build
# 运行以下命令启动服务
docker compose up
# 若成功,则显示服务正在 http://127.0.0.1:8888 上运行。请保持这个终端窗口不要关闭。

  1. 打开zotero,安装zotero-pdf2zh插件,并参考以下设置:

右击zotero中的pdf文件即可翻译

后续使用，开机后打开docker desktop运行对应容器即可

参考