Zotero-cita 项目使用教程

1. 项目目录结构及介绍

Zotero-cita 是一个为 Zotero 提供 Wikidata 引用元数据支持的开源插件。以下是项目的目录结构及其介绍：

• src/: 源代码目录，包含插件的主要 JavaScript 文件。
• static/: 静态资源目录，通常包含 CSS 和图片等静态文件。
• translators/: Zotero 翻译器目录，用于处理引用信息的导入和导出。
• .github/: GitHub 相关的配置文件和文档。
• dist/: 编译后的文件目录，包含可以直接在 Zotero 中使用的插件文件。
• README.md: 项目说明文件，包含项目的描述、安装和使用说明。
• LICENSE.md: 许可证文件，本项目使用 GPL-3.0 许可。
• package.json: Node.js 项目配置文件，包含项目的依赖和脚本。
• package-lock.json: 与 package.json 配套使用，锁定依赖版本。
• webpack.config.js: Webpack 配置文件，用于定义如何打包 JavaScript 文件。
• 其他配置和脚本文件。

2. 项目的启动文件介绍

在 Zotero-cita 项目中，并没有一个传统的“启动文件”。这是因为它是一个 Zotero 插件，需要通过 Zotero 的插件系统进行加载。

• install.rdf: 插件的安装描述文件，用于 Zotero 识别和安装插件。
• chrome.manifest: 插件的 manifest 文件，定义了插件的各种组件和权限。

要安装插件，通常需要将 dist/ 目录下的文件打包为一个 .xpi 文件，然后通过 Zotero 的插件安装向导进行安装。

3. 项目的配置文件介绍

Zotero-cita 插件的配置主要通过以下文件进行：

• package.json: 此文件包含项目的元数据，包括项目名称、版本、描述、依赖等。它还包含了用于构建和打包插件的脚本。
• webpack.config.js: 此文件用于配置 Webpack 打包过程，可以定义入口文件、输出文件、加载器（loader）和插件（plugin）等。
• .babelrc: Babel 配置文件，用于定义如何将 JavaScript 代码转换成兼容老版本浏览器的代码。

在开发过程中，可能还需要对以下文件进行配置：

• .gitignore: 定义哪些文件和目录应该被 Git 忽略，不包括在版本控制中。
• .eslintrc.json: ESLint 配置文件，用于定义代码风格规则和代码质量检查。

通过正确配置这些文件，可以确保插件的开发、构建和打包过程顺利进行。