Skip to content

Latest commit

 

History

History
149 lines (92 loc) · 5.31 KB

README.md

File metadata and controls

149 lines (92 loc) · 5.31 KB

Zotero PDF2zh

Zotero PDF2zh

zotero target version Using Zotero Plugin Template Downloads release

在Zotero中使用PDF2zh

配置方法

第零步 安装PDF2zh

在本地安装最新的PDF2zh

pip install pdf2zh          # 安装pdf2zh
或
pip install --upgrade pdf2zh # 之前已经安装, 更新

本插件当前开发使用的 pdf2zh版本: v1.9.0

第一步 在Zotero中配置插件参数

image7

Step 1.1 设置翻译参数

  • Python Server IP 默认为http://localhost:8888, 其中8888为翻译端口号,可以自行修改;
  • 翻译引擎:默认为bing;
  • 线程数:PDF2zh在翻译时的执行线程数,默认为4;
  • 翻译文件输出路径:用于临时存储翻译得到的PDF文件,默认为空;
  • Pdf2zh配置文件路径:用于配置翻译引擎和字体,默认为空。

以上路径建议设置为绝对路径。

如果设置为相对路径,则根路径与接下来Python脚本执行的路径一致。

举例:如果python脚本在/home/xxx/server/下执行,翻译输出路径设置为临时路径./translated/,则实际的输出路径为/home/xxx/server/translated/

Step 1.2 选择默认生成的翻译文件

默认生成mono和dual文件。

通过勾选默认生成的文件来控制添加到Zotero中的文件。

(请注意,此时临时翻译文件路径里依然存在mono和dual两种文件,因为这是pdf2zh默认生成的)

第二步:添加PDF2zh配置文件 & 修改翻译中文字体(可选)(推荐)

新建config.json文件,将该配置文件的路径输入到第一步的Zotero翻译配置中。

推荐使用霞鹜文楷字体

config.json文件示例如下:

{
    "NOTO_FONT_PATH": "./LXGWWenKai-Regular.ttf",
    "translators": [
        {
            "name": "openai",
            "envs": {
                "OPENAI_BASE_URL": "https://api.openai.com/v1",
                "OPENAI_API_KEY": "sk-xxxxxxxxx-xxxxxxxxxx-xxxxxxxxxxxxx",
                "OPENAI_MODEL": "gpt-4o-mini"
            }
        }
    ]
}

NOTO_FONT_PATH为您的自定义字体路径。

translators中可以配置多个AI翻译引擎(如果使用默认的bing或者google则不需要配置)。

其他配置的修改同理: 具体参考: PDF2zh Config File

第三步 执行脚本

打开命令行工具,输入以下命令:

# 1. 下载脚本文件(自动)或手动访问链接下载
wget https://github.com/guaguastandup/zotero-pdf2zh/raw/refs/heads/main/server.py
# 2. 执行脚本文件, 命令行参数8888为端口号,可以自行修改
python server.py 8888

请注意,如果命令行修改了端口号,那么在第一步的Zotero配置中,也需要相应地修改端口号。

Zotero插件配置会覆盖Python脚本中的配置。如果不想在Zotero插件中进行配置,只想在Python脚本中配置,请将Zotero插件中的配置留空。

第四步 翻译文件

image8

打开Zotero,右键选择条目或者附件。 如果选择条目,将会自动选择该条目下创建时间最早的PDF。

选项一:PDF2zh:Translate PDF

本选项生成的文件由Zotero插件设置中的“默认生成文件”勾选项决定,默认生成mono和dual两个文件。

image

选项二:PDF2zh:Cut PDF

本选项仅将选中的pdf文件由双栏文件切割为单栏文件。

✨ 将双栏论文剪切拼接为单栏显示,适配手机阅读!

image4

得到后缀中包含cut的单栏PDF文件。

image5

选项三:PDF2zh:中英双栏对照

本选项仅将后缀包含dual的文件切割拼接为中英文对照文件。

image9

得到后缀中包含compare的中英双栏对照PDF文件。

image6

致谢

💗

欢迎提issue或者参与贡献

TODO LIST

  • 支持远程部署
  • 跨平台部署测试 (on-going)
  • 加入插件市场
  • 支持在zotero perference中设置pdf2zh参数