Zotero PDF Translate 安装与使用指南

1. 项目目录结构及介绍

.
├── addon           # 扩展插件相关代码
│   └── chrome      # 针对Chrome浏览器的特定代码
│       ├── locale  # 多语言资源文件
│       └── ...      # 其他相关文件
├── src              # 主要源代码
│   ├── modules      # 模块代码
│   │   └── services # 翻译服务处理模块
│   ├── utils        # 工具函数
│   ├── typings     # 类型定义
│   └── ...          # 其他源码文件
├── .gitattributes   # Git属性文件
├── .gitignore       # 忽略文件列表
├── .prettierrc.json  # 格式化配置
├── AGPL-3.0-license.txt  # 许可证文件
├── README.md        # 项目说明文档
└── package*json       # 包管理文件
    ├── package.json  # 项目主包文件
    └── package-lock.json  # 包锁定文件

这个项目的主要组成部分包括 addon 目录下的扩展插件代码以及 src 目录中的核心源代码。addon 存放的是针对不同浏览器或平台的适配代码，而 src 目录包含了翻译插件的核心功能，如 modules/services 对应各种翻译服务的实现。

2. 项目启动文件介绍

由于这是一个Zotero的插件，它的启动过程是由Zotero完成的，而不是通过传统的命令行执行。在安装完成后，当你在Zotero中打开PDF时，该插件会被自动加载并运行。

启动流程涉及到的关键文件是：

• addon/chrome/content.js: 这个文件通常是浏览器扩展中的入口点，它负责初始化插件并在Zotero环境中运行。
• src/main.ts: 虽然不是直接作为启动文件，但它是源代码中的主要模块，可能包含了插件的核心逻辑和事件监听器。

3. 项目的配置文件介绍

• src/utils/config.ts: 此文件中包含了服务配置，比如SERVICES变量可能会列出支持的翻译服务及其相关的设置。
• addon/chrome/locale: 这个目录包含了不同语言的本地化字符串，如 en-US/addon.properties 或 zh-CN/addon.properties，用于提供多语言支持。

在实际使用过程中，用户不需要直接编辑这些配置文件，因为它们通常会在开发期间由开发者维护。不过，如果你想自定义或者扩展插件的功能，这些配置文件可以作为一个起点来了解其工作原理。

请确保遵循项目的官方文档和许可协议，以正确地使用和贡献到该项目。如果你遇到任何问题，可以参考GitHub仓库中的Issue或直接向社区提问。