欢迎使用ClassIsland-SimpleConfig的使用文档!

使用方式

在本程序的Release页面 https://github.com/ImcalLxx/ClassIsland-SimpleConfig/releases 下载最新版本

将压缩包解压后即可使用

初始化引导

在程序初次启动时，程序会自动进入初始化引导操作，包括：

  1. 询问ClassIsland的可执行文件路径
  2. 显示主界面

接下来，你应该看到类似下图的主界面：

Alt

左侧的滚动区域可以显示一些基本信息，并进行调课操作

重点在右侧操作区，初始化步骤如下：

  1. 点击”课表操作“的”导入“按钮，选择格式正确的txt或xlsx文件，进行课表导入操作
  2. 点击”时间表操作“中的”导入“按钮，选择格式正确的txt或xlsx文件，进行时间表导入操作
  3. 点击“输出课表文件”，输出路径选择班级ClassIsland目录下的Profiles文件夹中，文件名填写“Default.json”（如果本班ClassIsland的配置文件不是这个名字，请自行修改），如果询问是否覆盖文件，选择“是”
  4. 基本初始化完成。如果发现课表不正确，可以修改配置选项中的：单双周偏移“或“三周轮换偏移”项，再次按照上一步输出课表文件。“课表加载顺序”保持默认即可（其实是我还没有做这个功能）（划掉）

注：如果在修改课表后，ClassIsland显示的课表没有变化，请先关闭ClassIsland，再向其目录下写入课表文件

当初始化完毕后，下次启动程序时，程序便会自动向ClassIsland目录下写入文件，更新课表（当然假设你动了ClassIsland的位置，那就会报错啦）

注：推荐将本程序设为开机自启动项，将快捷方式放到“C:\Users\班级希沃的用户名\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup”下即可

课表文件格式（txt）

如下是课表文件的一个示例：

周一:数学,外语,生物,体育,化学,物理,地理,政治,自习
周二:数学,语文,外语,物理,化学,信息技术,历史,自习,自习
周三:数学,物理,生物,外语,化学,自习,体育,政治,自习
周四:数学,外语,化学,体育,生物,物理,音乐,政治,自习
周五:数学,外语,心理,外语,化学,物理,自习,历史,自习

周六1:语文,外语,生物,物理
周六2:化学,外语,数学,生物
周六3:数学,外语,生物,物理

晚课1:语文,化学,物理,外语,数学
晚课2:语文,生物,物理,外语,数学
晚课3:语文,生物,化学,外语,数学

在一个课表文件中，一行内容由如下几部分构成：

  1. 开头（前缀）：如“周一”，“周六1”等。

    （1）：当你要声明本行为周六课表时，务必在前缀内包括“周六”二字，其余不限，例如“周六1111”，“123周六”，“这是周六课表”均为合法。周六课表三周轮换，从上到下分别为第1周，第2周，第3周，与行内标识无关（即使你从上到下的顺序是“周六3”，“周六2”，“周六1”，程序也依然会认为“周六3”为第一周课表）

    （2）： 同上，当你要声明本行为晚课课表时，在前缀内包含”晚课“二字即可，读取顺序同上

    （3）：若前缀内同时不含有”周六“”晚课“时，程序便会认为这是平日课表，读取顺序也是自上而下

  2. 课程：如第一行

    周一:数学,外语,生物,体育,化学,物理,地理,政治,自习

    每个课程以英文逗号分隔，逗号前后有无空格不影响

    另外，建议使用课程规范名称，如写”信息技术“而不是”信息“，写”外语“而不是”英语“，不支持缩写（如用”数“代替”数学“）

  3. 行尾：回车换行（这没啥注意的吧）

  4. 行间：可以留有空行作为分割，但不必要，程序会忽略空行

时间表文件格式（txt）

如下是时间表文件的一个示例：

平日时间:
第一节课:07:30-08:10
课间:08:10-08:20
**省略**
第五节课:11:15-11:55/12:05
午休:11:55/12:05-13:35
分割线:13:35-13:35
第六节课:13:35-14:15
课间:14:15-14:25
**省略**
晚课:17:55-19:30
课间:19:30-19:40
晚自习:19:40-21:20

周六课表:
第一节课:08:00-09:10
**省略**
第三节课:10:40-11:50/12:00
午休:11:50/12:00-13:30
分割线:13:30-13:30
第四节课:13:30-14:40
课间:14:40-14:50
自习:14:50-16:20

  1. 开头（前缀）：如”第一节课“，”午休“，”课间“等

    （1）：如果前缀中含有”休“”操“”课间“”午饭“”晚饭“等关键字，该行便会被解析为课间休息，即使前缀内含有”课“等字样，也是没有用滴。所以不要闲得没事在正课前加这几个字

    （2）：如果前缀中含有”分割“两字，该行便会被解析为分隔线。不知道什么是分割线？自己去看ClassIsland的文档吧（

    （3）：其余情况，该行便会被解析为上课时间

  2. 时间：如

    第一节课:07:30-08:10

    在前缀后紧跟英文冒号或者英文逗号，之后的内容便会被解析为时间段信息

    对于一个时间段，应使用“mm:hh-mm:hh”的格式书写（用英文标点），其中数字必须写两位，如写”09“而不写”9“

    注：时间表内时间前后不要加空格

    下面引入双重时间点的概念：

    对于育明而言，吃饭时间是分单双周的，为了避免输入课表时的重复劳动，可以用如下的形式快速表示两个时间点：

    第五节课:11:15-11:55/12:05
午休:11:55/12:05-13:35

    即将上面”mm:hh“的单个时间点换成”mm:hh/mm:hh“的双重时间点，中间用”/“隔开，程序会根据位置自动解析哪个时间点属于单周，哪个时间点属于双周

    双重时间点不止可用于午休，还可用于其他地方

    不过注意：在写双重时间点时，务必确认上下时间衔接，下面给出了一个错误示例：

    第五节课:11:15-11:55/12:05
午休:11:55/12:00-13:30
           ^^^^   这里的时间与上面的"12:05"未衔接上

    这样做本程序不会报错，也不会执行检查，会将这个时间数据写入到ClassIsland的文件中，但是ClassIsland会出什么问题我就不清楚啦（

  3. 分割 在一个时间表内，既需要写平日时间，又需要写周六时间，于是我们需要分割：

    平日课表:
*省略*

周六课表:
*省略*

    本程序会默认把第一个读取到的视为平日时间，在读取到标识符后才会开始读周六课表，你可能没有听懂什么意思，只需要记住：

    在周六课表之前，添加“周六课表”这几个字（其实只要含有“周六”二字即可）。同上，空行不是必须的，但可以添加作为分割，程序会忽略的

其他常见问题：

  1. 为什么我写入了课表，ClassIsland显示的课表却没变化呢？

    如果在修改课表后，ClassIsland显示的课表没有变化，请先关闭ClassIsland，再向其目录下写入课表文件

  2. 程序没有静默写入课表怎么办？

    您可以尝试打开主界面，重新导入课表和时间表，导出课表，看看能否写入

  3. 程序写入的课表缺课/少分割线怎么办？

    这个问题在开发时就偶有遇见，您可以尝试关闭ClassIsland，删除ClassIsland目录下Profiles文件夹中的所有文件，再写入课表。若仍无法解决，您可以尝试使用ClassIsland中的档案编辑功能，手动补全缺失的课程，这样第二次写入的大概率就好用（原理未知）

    当然，您得确保您导入的课程表没有格式问题（

  4. 程序遇到了一些问题怎么办呢？

    牢记！先重启试试（

    如果您一个人无法解决问题，请将您在github仓库提交Issue，或者您也可以考虑线下真人交流（前提是得能找到我

注意：

本程序还处于测试阶段，尚有一些功能没有完成

如果您有编程经验，想支持本程序的开发，请看看本程序的github仓库！

https://github.com/ImcalLxx/ClassIsland-SimpleConfig

如果您想支持开发者的工作，请star一下本程序的github仓库，或者请我一顿饭也不是不行呢~（划掉）

希望这个小程序可以帮到您！