WPS-Zotero 项目安装与使用教程

1. 项目的目录结构及介绍

WPS-Zotero 项目的目录结构如下：

WPS-Zotero/
├── images/
├── js/
├── .gitignore
├── LICENSE.txt
├── index.html
├── install.py
├── main.js
├── proxy.py
├── readme.md
├── ribbon.xml
├── version.js
└── windows安装与卸载.bat

目录结构介绍

• images/: 存放项目所需的图片资源。
• js/: 存放 JavaScript 文件，用于实现项目的功能。
• .gitignore: Git 忽略文件，指定哪些文件或目录不需要被 Git 管理。
• LICENSE.txt: 项目的开源许可证文件，采用 GPL-3.0 许可证。
• index.html: 项目的主页面文件。
• install.py: 项目的安装脚本，用于安装和卸载插件。
• main.js: 项目的主要 JavaScript 文件，实现核心功能。
• proxy.py: 用于解决 Zotero 的 CORS 问题的 HTTP 代理。
• readme.md: 项目的说明文档，包含项目的介绍、安装方法和使用说明。
• ribbon.xml: 项目的 Ribbon 界面配置文件，定义了插件的界面布局。
• version.js: 项目的版本管理文件，记录当前版本信息。
• windows安装与卸载.bat: Windows 系统下的安装与卸载脚本。

2. 项目的启动文件介绍

index.html

index.html 是项目的主页面文件，用于加载和初始化插件。该文件包含了插件的基本结构和样式，并通过 JavaScript 文件 main.js 实现插件的核心功能。

main.js

main.js 是项目的主要 JavaScript 文件，负责实现插件的核心功能。它通过 WPS 的 JSAPI 控制 WPS Writer，并与 Zotero 通过 HTTP 引用协议进行交互。

3. 项目的配置文件介绍

ribbon.xml

ribbon.xml 是项目的 Ribbon 界面配置文件，定义了插件的界面布局。该文件指定了插件在 WPS Writer 中的按钮和菜单项，用户可以通过这些按钮和菜单项来使用插件的功能。

version.js

version.js 是项目的版本管理文件，记录当前版本信息。该文件用于管理和更新插件的版本号，确保用户使用的是最新版本的插件。

install.py

install.py 是项目的安装脚本，用于安装和卸载插件。用户可以通过运行该脚本来安装或卸载插件，脚本会自动处理相关的依赖和配置。

proxy.py

proxy.py 是一个简单的 HTTP 代理，用于解决 Zotero 的 CORS 问题。由于 Zotero 的主机权限限制，直接从客户端发起的 HTTP 请求会被 CORS 阻止，因此需要通过该代理来绕过这一限制。

windows安装与卸载.bat

windows安装与卸载.bat 是 Windows 系统下的安装与卸载脚本。用户可以通过双击该脚本来安装或卸载插件，脚本会自动处理相关的依赖和配置。

---

以上是 WPS-Zotero 项目的安装与使用教程，希望对您有所帮助。