WHU-GPA-helperX 项目使用教程

WHU-GPA-helperX 项目使用教程

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

WHU-GPA-helperX/
├── docs/
│   └── README.md
├── images/
│   └── logo.png
├── js/
│   └── main.js
├── css/
│   └── style.css
├── LICENSE
├── README.md
├── manifest.json
└── popup.html

• docs/: 存放项目文档，如 README.md。
• images/: 存放项目相关的图片资源，如 logo.png。
• js/: 存放项目的 JavaScript 文件，如 main.js。
• css/: 存放项目的 CSS 样式文件，如 style.css。
• LICENSE: 项目的开源许可证文件。
• README.md: 项目的介绍和使用说明。
• manifest.json: Chrome 扩展的配置文件。
• popup.html: 扩展的弹出页面。

2. 项目的启动文件介绍

项目的启动文件主要是 popup.html，它是 Chrome 扩展的弹出页面。当用户点击扩展图标时，会弹出这个页面，展示 GPA 计算结果和其他相关信息。

3. 项目的配置文件介绍

项目的配置文件是 manifest.json，它是 Chrome 扩展的核心配置文件，包含了扩展的基本信息、权限、资源路径等。

{
  "manifest_version": 3,
  "name": "WHU-GPA-helperX",
  "version": "1.3.0",
  "description": "武汉大学新教务系统成绩助手 | a GPA calculator of WHU new education administration system",
  "permissions": [
    "activeTab",
    "storage"
  ],
  "action": {
    "default_popup": "popup.html",
    "default_icon": {
      "16": "images/icon16.png",
      "48": "images/icon48.png",
      "128": "images/icon128.png"
    }
  },
  "icons": {
    "16": "images/icon16.png",
    "48": "images/icon48.png",
    "128": "images/icon128.png"
  },
  "content_scripts": [
    {
      "matches": ["https://jwxt.whu.edu.cn/*"],
      "js": ["js/main.js"]
    }
  ]
}

• manifest_version: 指定 manifest 文件的版本，当前为 3。
• name: 扩展的名称。
• version: 扩展的版本号。
• description: 扩展的描述。
• permissions: 扩展所需的权限，如 activeTab 和 storage。
• action: 定义扩展的默认弹出页面和图标。
• icons: 扩展的图标，用于不同尺寸的显示。
• content_scripts: 定义在特定页面（如教务系统页面）加载的 JavaScript 文件。

通过以上配置，扩展能够在武汉大学新教务系统页面上自动加载并计算 GPA。