Actions & Tags for Zotero 插件安装与使用教程

1. 项目目录结构及介绍

在 windingwind/zotero-actions-tags 仓库中，主要的目录结构包括：

• src: 这是源代码的主要存放地，包含了插件的各种功能实现。

  • actions: 此目录下定义了各种可触发的动作（Actions）。
  • tags: 标签处理相关的代码在这里。
  • utils: 实用工具函数集中于此。

• dist: 发布时的构建产物会被放在这个目录下，通常包含 .xpi 文件，它是可以被Zotero直接安装的扩展。

• tests: 测试用例和测试数据位于此处，用于验证插件的功能。

• package.json: 包含项目的基本信息，如版本、依赖等。

• README.md: 项目的说明文档，提供快速入门和概述。

2. 项目启动文件介绍

在 src 目录下没有明确的单一入口文件，因为这是一个浏览器扩展，其加载和初始化过程由Zotero的扩展机制管理。然而，你可以看到 manifest.json 文件，它是Zotero或Firefox用来识别和加载扩展的关键文件。该文件定义了插件元数据，如扩展ID、版本号、权限以及执行上下文。

当Zotero启动并加载此扩展时，manifest.json 中声明的脚本会按需运行，例如事件监听器和自动操作逻辑。

3. 项目配置文件介绍

Actions & Tags 插件并没有一个单独的外部配置文件，而是通过Zotero的内部设置和用户定义的动作来配置行为。配置是在Zotero的用户界面中完成的，可能包括以下几个方面：

• Zotero Preferences: 用户可以在Zotero的偏好设置中启用或禁用插件，以及查看已定义的动作和触发条件。
• Actions Definition: 插件允许用户定义触发动作，比如当创建新条目、打开文件或关闭标签页时，自动应用特定的标签或修改元数据。
• User-defined Shortcuts: 可以分配快捷键以触发自定义的自动化操作。

为了配置这些设置，你需要在Zotero中直接操作，例如通过Tools -> Preferences进入偏好设置，然后找到Actions & Tags的相关部分进行调整。

请注意，具体配置界面和步骤可能会随着插件版本更新而有所变化，建议参考最新的官方文档或GitHub页面上的说明。