https://github.com/zotero-chinese/zotero-plugins
Zotero Plugins Collection | Zotero 插件合集 | Awesome Zotero Plugins
https://github.com/zotero-chinese/zotero-plugins
awesome plugins zotero zotero-addon zotero-plugin
Last synced: 7 days ago
JSON representation
Zotero Plugins Collection | Zotero 插件合集 | Awesome Zotero Plugins
- Host: GitHub
- URL: https://github.com/zotero-chinese/zotero-plugins
- Owner: zotero-chinese
- License: mit
- Created: 2023-09-03T15:44:59.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-24T22:41:56.000Z (7 days ago)
- Last Synced: 2025-04-24T23:35:46.554Z (7 days ago)
- Topics: awesome, plugins, zotero, zotero-addon, zotero-plugin
- Language: TypeScript
- Homepage: https://zotero-chinese.com/plugins/
- Size: 81.8 MB
- Stars: 503
- Watchers: 6
- Forks: 29
- Open Issues: 6
-
Metadata Files:
- Readme: README-zh.md
- License: LICENSE
Awesome Lists containing this project
README
# Zotero 插件合集
[](https://app.netlify.com/sites/zotero-plugins/deploys)
_This README is also available in: :cn: 简体中文 | [:gb: English](./README-zh.md)。_
本仓库提供了若干 Zotero 插件的信息及其 XPI 包，尝试在 Zotero 官方插件商店建立前，提供集中的插件商店服务。
## 访问
**Zotero 中文社区主域名：**
## 提交插件
[](https://codespaces.new/zotero-chinese/zotero-plugins?quickstart=1)
> [!NOTE]
>
> 如何添加未收录的插件？
>
> 编辑 [`src/plugins.ts`](./src/plugins.ts)，在 `plugins` 列表中添加一个对象，内容格式如下所示，已有的内容亦可作为参考。
>
> 添加时请按 `repo` 排序。
>
> 编辑完成后提交，发起 Pull Request，仓库成员将尽快处理。
```ts
interface PluginInfo {
/**
* 插件仓库
*
* 例如：northword/zotero-format-metadata
*
* 注意前后均无 `/`
*/
repo: string
/**
* 插件的发布地址信息
*/
releases: Array<{
/**
* 当前发布版对应的 Zotero 版本，"7" 或 "6"
*/
targetZoteroVersion: string
/**
* 当前发布版对应的下载通道
*
* `latest`：最新正式发布；
* `pre`：最新预发布；
* `string`：发布对应的 `git.tag_name`；
* 注意 `git.tag_name` 有的有 `v` 而有的没有，可以通过发布链接来判断
*/
tagName: 'latest' | 'pre' | string
}>
}
```
## 开发指南
开发前，需要根据 [GitHub 文档](https://docs.github.com/zh/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens) 创建 GitHub 个人访问令牌，将其存入本地环境变量 `GITHUB_TOKEN`。
```bash
# 克隆仓库
git clone https://github.com/northword/zotero-plugins.git zotero-plugins
cd zotero-plugins
# 安装依赖
corepack enable
pnpm install
# 获取插件信息
pnpm data:info
# 获取图表信息
pnpm data:chart
```
[`src/index.ts`](./src/index.ts) 为主要逻辑脚本，它执行如下操作：
- 遍历上述插件信息列表，从 GitHub 获取每一个插件的基本信息和发行版，将获取到的信息保存在 [`dist/plugins.json`](https://github.com/northword/zotero-plugins/blob/gh-pages/dist/plugins.json)
- 同时将 XPI 包保存在 [`dist/xpi/${github.release.asset.id}.xpi`](https://github.com/northword/zotero-plugins/blob/gh-pages/dist/xpi)
GitHub Action Bot 定时运行 `src/index.ts` 脚本，执行上述步骤，并将 `dist/` 部署到 [`gh-page`](https://github.com/northword/zotero-plugins/blob/gh-pages/) 分支。
> [!NOTE]
>
> 如何将本项目作为依赖项进行二次开发？
>
> 开发者可以使用 [`gh-pages` 分支中 `dist/plugins.json`](https://github.com/northword/zotero-plugins/blob/gh-pages/dist/plugins.json) 等构建文件。
## 致谢
感谢 Zotero 社区及开发者们的付出！
本项目使用了如下代理或公共 CDN 服务完成 XPI 分发：
- GitHub 代理：
- JsDeliver：
- KGitHub:
本项目是对 [l0o0/ZoteroPlugins](https://github.com/l0o0/ZoteroPlugins) 的 Typescript 重新实现。
本项目部署在 GitHub Pages 和 Netlify.
[](https://www.netlify.com)
## 贡献者
[](https://github.com/zotero-chinese/zotero-plugins/graphs/contributors)
## 协议
MIT License
## Star History
[](https://star-history.com/#zotero-chinese/zotero-plugins&Date)