diff --git a/文档/使用指南/使用指南2024.md b/文档/使用指南/使用指南2024.md index 4f58c984..ab17f6c4 100644 --- a/文档/使用指南/使用指南2024.md +++ b/文档/使用指南/使用指南2024.md @@ -4,6 +4,12 @@ **本教程中的默认文件夹是题库根目录/工具v2** +## 注意事项 + +**原则上题库内容中不出现全角的句号(。)、逗号(，)、冒号(：)、问号(？)、感叹号(！)、小括号(（）)等** + +**半角的标点符号后面一般应该有半角的空格或是直接换行** + ## 打开面板的方式 在配置好python的math环境, 在题库根目录运行过``pip install -r requirements.txt``, 并且编写过``conda_initiate.bat``之后, 在终端的题库根目录运行``conda_initiate.bat``, 随后在终端依次输入``cd 工具v2``回车, ``python 工具面板.py``回车, 会跳出一个``tkinter``做的GUI面板. @@ -232,18 +238,55 @@ usages ![运行按钮](http://wwylss.synology.me:48089/i/2024/02/08/65c4e0ba11e72.png) -随后如果有必要, 可保存``Problems.json``至暂存区, 之后可以commit到本地的repository, 乃至push到远程的服务器. +随后如果有必要, 可添加``Problems.json``至暂存区, 之后可以commit到本地的repository, 乃至push到远程的服务器. ## 两种编辑题库中已有题目的方式 -###
$\LaTeX$方式(可编辑题目, 答案, 解答)
+###
LaTeX方式(可编辑题目, 答案, 解答, 备注)
+ + +使用过程中, 往往会发现题库中已有的题目, 答案, 解答, 备注有错误或瑕疵, 需要修改. 这些修改不应该仅停留在讲义上(否则下次使用同一道题目还会有同样的错误), 而是应该在题库中被永久保留下来. 如果仅仅是对[题目/答案/解答/备注]的修改, 可以按LaTeX代码的方式进行操作(比直接编辑json直观), 具体方法如下: + +1. 在面板上选择``维护``-``LaTeX编辑题目答案及提示`` +![LaTeX编辑](http://wwylss.synology.me:48089/i/2024/02/09/65c59794438eb.png) +2. 在打开的``latex编辑题目答案及提示.py``文件中修改一些信息 +![设置题号和编辑者](http://wwylss.synology.me:48089/i/2024/02/09/65c597ec21af6.png) + 1. 要被编辑的题号(可用``:``和``,``进行分隔) + 2. 编辑者 +3. 信息修改完成后保存, 关闭``latex编辑题目答案及提示.py``, 在面板上点击``运行`` +4. 以LaTeX的方式对``vscode``中新展示的``problem_edit.tex``进行对应的编辑, 主要的编辑在四个红色方框处, 分别是题目内容, 答案, 解答与提示, 备注. 注意在编辑时[答案/解答与提示/备注]后面**冒号之后的空格和空行都不要删除**. +![编辑内容](http://wwylss.synology.me:48089/i/2024/02/09/65c59905c1f16.png) +5. 编辑完成后保存, 关闭, 程序会试编译编辑以后的信息. 如果试编译失败, 则刚才的所有编辑将全部失效(所以每次建议少编辑几个信息), 题库文件将退回原状; 如果试编译成功, 则``Problems.json``中的相应位置会添加对应的关联题目 + +随后如果有必要, 可添加``Problems.json``至暂存区, 之后可以commit到本地的repository, 乃至push到远程的服务器. ###
json方式(可编辑任何信息)
+使用过程中, 有时会发现题库中已有的题目的其他信息也有错误或瑕疵(例如题目类型指定错误等), 需要修改. 这些修改同样应该在题库中被永久保留下来. 它们都可以按json代码的方式进行修改, 具体方法如下: + +1. 在面板上选择``维护``-``json编辑题目综合信息`` +![json编辑题目综合信息](http://wwylss.synology.me:48089/i/2024/02/09/65c59b5a3d124.png) +2. 在打开的``json编辑题目综合信息.py``文件中修改一些信息 +![设置题号和编辑者](http://wwylss.synology.me:48089/i/2024/02/09/65c59ba946f3b.png) + 1. 要被编辑的题号(可用``:``和``,``进行分隔) + 2. 编辑者 +3. 信息修改完成后保存, 关闭``json编辑题目综合信息.py``, 在面板上点击``运行`` +4. 在``vscode``对新展示的``problem_edit.json``进行对应的编辑(例如下图中的全角分号改为``; ``[半角分号空格]). 编辑时字段名, 含义, 类型参考``导入metadata``部分的说明 +![json文件内容](http://wwylss.synology.me:48089/i/2024/02/09/65c59c72f3cb0.png) +5. 编辑完成后保存, 关闭, 程序会试编译编辑以后的信息. 如果试编译失败, 则刚才的所有编辑将全部失效(所以每次建议少编辑几个信息), 题库文件将退回原状; 如果试编译成功, 则``Problems.json``中的相应位置会添加对应的关联题目 + +随后如果有必要, 可添加``Problems.json``至暂存区, 之后可以commit到本地的repository, 乃至push到远程的服务器. -## 从$\LaTeX$源文件中提取答案 +## 根据特定特征筛选题号 + +## 根据题号表达式(可含:或,的字符串)生成讲义 + +## 系列讲义生成 + + +## 从LaTeX源文件中提取答案 ## 题目和单元挂钩 @@ -256,13 +299,11 @@ usages ## 小闲平台使用数据导入 -## 根据特定特征筛选题号 -## 根据题号表达式(可含:或,的字符串)生成讲义 ## 录入讲义结构与内容 -###
讲义首字母的通用规则
+###
讲义首字母的通用规则(2026学年第2学期起实施)
- E: 正式测验卷与考试卷 - I: 非正式的小测验 @@ -280,7 +321,7 @@ usages ***对应的目的是能更方便地收录使用信息*** -## 系列讲义生成 + ## 添加基础知识梳理