wangweiye
/
mathdeptv2
Archived
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

使用指南更新 两种方式修改题目信息 部分

This commit is contained in:
weiye.wang 2024-02-09 11:35:42 +08:00
parent 223a177c9c
commit 494efafa5c
1 changed files with 48 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

55
文档/使用指南/使用指南2024.md
View File

@ -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到远程的服务器.
## 两种编辑题库中已有题目的方式
### <center>$\LaTeX$方式(可编辑题目, 答案, 解答)</center>
### <center>LaTeX方式(可编辑题目, 答案, 解答, 备注)</center>
使用过程中, 往往会发现题库中已有的题目, 答案, 解答, 备注有错误或瑕疵, 需要修改. 这些修改不应该仅停留在讲义上(否则下次使用同一道题目还会有同样的错误), 而是应该在题库中被永久保留下来. 如果仅仅是对[题目/答案/解答/备注]的修改, 可以按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到远程的服务器.
### <center>json方式(可编辑任何信息)</center>
使用过程中, 有时会发现题库中已有的题目的其他信息也有错误或瑕疵(例如题目类型指定错误等), 需要修改. 这些修改同样应该在题库中被永久保留下来. 它们都可以按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
## 小闲平台使用数据导入
## 根据特定特征筛选题号
## 根据题号表达式(可含:或,的字符串)生成讲义
## 录入讲义结构与内容
### <center>讲义首字母的通用规则</center>
### <center>讲义首字母的通用规则(2026学年第2学期起实施)</center>
- E: 正式测验卷与考试卷
- I: 非正式的小测验
@ -280,7 +321,7 @@ usages
***对应的目的是能更方便地收录使用信息***
## 系列讲义生成
## 添加基础知识梳理