doc: BIT-乐学-修改侧边栏课程

Relates-to: #4

TamperMonkey/BIT-乐学-修改侧边栏课程.md

@@ -0,0 +1,42 @@
+# BIT-乐学-修改侧边栏课程
+
+[Moodle](https://lexue.bit.edu.cn/) 好像是按某种规则挑选出最多 10 个课程。然而它并不能完全猜中，还不时更新，导致每次更新都要改。
+
+这段脚本可以自主定义侧边栏课程。如下图，右侧 InPrivate 窗口是原版，左侧是此脚本修改后的。
+
+![乐学-课程页](https://s2.loli.net/2023/07/14/IfU9DRX8nqO41V5.png)
+
+> 您也可考虑替代方案——在“[个人主页](https://lexue.bit.edu.cn/my/) → 课程概览”可以筛选“进行中”“尚未开始的”或“过去的”课程。
+
+## 配置
+
+您需要自己配置哪些课程要隐藏，哪些要显示。
+
+1. **改为高级配置模式**：前往 TamperMonkey → 设置 → 通用 → 配置模式，选为“高级”。
+
+2. **找到“存储”**：到这个脚本的编辑页，在上边栏切换到“存储”（位置与“编辑器”“设置”并排）。
+
+3. **写入配置**：在“存储”一栏写入 JSON，一般照猫画虎即可。
+
+    例如——
+
+    ```json
+    {
+        "show": [
+            { "name": "信号与系统-实验", "id": "10664", "icon": "signal" },
+            { "name": "电磁场与电磁波", "id": "10713", "icon": "globe" }
+        ],
+        "hide": [
+            { "name": "物理实验B-绪论", "id": "7661", "icon": "flask" },
+            "更多",
+            { "name": "学术用途英语12021-2022-1许子艳", "id": "8751", "comment": "错误课程" },
+            "乐学使用简明教程"
+        ]
+    }
+    ```
+
+    - `name`——想显示的课程名。
+    - `id`——课程链接最后的id，例如`https://lexue.bit.edu.cn/course/view.php?id=8819`就是`'8819'`。
+    - `icon`——FontAwesome v4 的图标名称，默认为`'graduation-cap'`。请参考 [Font Awesome Icons](https://fontawesome.com/v4/icons/) 或 [Font Awesome 中文网](https://fontawesome.com.cn/v4/icons)。
+
+    详情见源代码注释里的`Config`及`CourseDescription`。

TamperMonkey/BIT-乐学-修改侧边栏课程.user.js

@@ -1,7 +1,7 @@
 // ==UserScript==
 // @name         BIT-乐学-修改侧边栏课程
 // @namespace    http://tampermonkey.net/
-// @version      1.3.0-beta
+// @version      1.3.1
 // @description  在侧边栏添加并重新排列课程
 // @supportURL   https://github.com/YDX-2147483647/BIT-enhanced/issues
 // @author       Y.D.X.
@@ -21,7 +21,7 @@
    * @typedef {Object} CourseDescription
    * @property {string} name - 想显示的课程名
    * @property {string} id - 课程链接最后的id，例如`https://lexue.bit.edu.cn/course/view.php?id=8819`就是`'8819'`
-   * @property {?string} icon - FontAwesome 的图标名称，默认为`'graduation-cap'`。→ http://www.fontawesome.com.cn/faicons/
+   * @property {?string} icon - FontAwesome v4 的图标名称，默认为`'graduation-cap'`。
    * @property {?string} comment - 给自己看的注释，比如为什么要屏蔽这门课
    */