Zotero-SciPDF插件开发与使用指南

项目目录结构及介绍

Zotero-SciPDF 是一个专为Zotero 7设计的插件，旨在自动化从Sci-Hub下载PDF文献。以下是项目的主要目录结构及其简介：

├── doc                  # 文档目录，包含了本指南的原始Markdown文件（如 README-zhCN.md）
├── src                  # 源代码目录，包含了插件的核心逻辑
│   ├── main.js          # 主入口文件，初始化和注册插件功能
│   └── ...              # 其他JavaScript源文件，实现特定功能
├── locales               # 多语言资源文件夹，存储不同语言的本地化文本
│   └── zh-CN.properties # 中文本地化文件
├── package.json         # Node.js项目的配置文件，包括依赖和脚本命令
└── ...                   # 其余可能包括测试、构建或部署相关文件

项目的启动文件介绍

在 src/main.js 文件中，是插件的启动与核心逻辑所在。它负责集成到Zotero环境，通过扩展Zotero的功能来自动解析并寻找PDF。此文件通常包含以下关键操作：

• 注册扩展：实现对Zotero接口的监听和插件功能的激活。
• 自定义PDF解析器：向Zotero的findPDFs扩展点添加Sci-Hub的解决策略。
• 用户设置处理：读取或写入用户的偏好设置，比如自动下载PDF的开关。

启动时，插件会根据这个文件初始化，确保Zotero能够调用其提供的功能。

项目的配置文件介绍

尽管项目的主要行为被编码在源代码中，配置相关的细节往往分散在多个地方。对于开发者来说，主要关注的配置文件有：

• package.json: 定义了项目的元数据，包括名称、版本、依赖以及执行脚本等。这对于管理和构建项目至关重要。

• locales 目录下的文件提供了用户界面的多语言支持。例如，zh-CN.properties 中的键值对定义了中文界面中的文字内容，允许用户界面本地化。

• 如果涉及更复杂的配置，如自动构建流程或特定环境变量，配置可能存在于.gitignore忽略的文件中，如.env（虽然在此具体项目中并未明确提及）。

请注意，实际的配置文件和结构可能会随着项目更新而有所变化。因此，在进行深入开发或定制时，应参考最新的源码和官方说明。