This repository has been archived on 2024-06-23. You can view files and clone it, but cannot push or open issues or pull requests.

25 KiB

Raw Blame History

题库使用指南2024版

本教程中的默认文件夹是题库根目录/工具v2

注意事项

原则上题库内容中不出现全角的句号(。)、逗号(，)、冒号(：)、问号(？)、感叹号(！)、小括号(（）)等

半角的标点符号后面一般应该有半角的空格或是直接换行

打开面板的方式

在配置好python的math环境, 在题库根目录运行过pip install -r requirements.txt, 并且编写过conda_initiate.bat之后, 在cmd终端的题库根目录运行conda_initiate.bat, 随后在终端依次输入cd 工具v2回车, python 工具面板.py回车, 会跳出一个tkinter做的GUI面板.

在overleaf上协作编辑

我们自己部署的本地overleaf服务器的地址是overleaf kongjiang(kjwangweiye.top:40388)或overleaf kongjiang mirror(wwylss.synology.me:40388)

如果还未注册过, 请联系管理员, 提供一个邮箱(可以是真实的邮箱, 也可以不是)以新建账号(之后首次登录会要求设置密码, 请不要忘记邮箱和密码)

万一忘记了邮箱和密码就只能删除账号重新再开了, 服务器上属于该账号的所有工作就一并被删除了.

知道对方的邮箱的话, 可以在overleaf上邀请对方参加协作, 一起编辑同一个项目.

在gitlab上提交issue

我们自己部署的本地gitlab服务器的地址是gitlab(wwylss.synology.me:30000)

如果还未注册过, 请在上述界面中注册, 并联系管理员以通过注册.

一个较大的项目的协作者之间的工作联系通常不是通过微信、电话这种追溯历史不太方便的方式实现的. gitlab提供了一个比较有效的方式: 提交issue(问题/事件)

上图就是提交issue的按钮, 点击后选择新建议题, 会显示下面的界面

用简略的文字描述issue
详细描述issue的内容(可以使用markdown语法, 如果会markdown的话)
按这个按钮可以添加附件(在提供一些文件例如metadata.txt等的时候十分有用)
指派哪些人来跟进这个议题, 一般有同备课组的负责人和管理员等
前四项全填完之后, 点击Create议题以生成这个新的issue

之后就可以在这个issue中进行对话沟通, 完成后(或者完不成但是也不想留置)有权限的成员(提出者, 指派人, 管理员等)可以关闭议题.

收录新题

对于需要合并到主题库的题目, 在收录之前请务必和管理员协商确定起始题号, 避免不同使用者的题号出现冲突

测试的时候请先拉取远程的tutorial分支, 在此基础上新建分支, 之后进行收录新题操作

收录新题前, 需要准备一个能够编译通过的LaTeX文件, 正文部分是一个enumerate环境, 其中每一个\item表示一道题目. 例如:

\begin{enumerate}
\item 设$x=1$, 则$x^2$的值为\blank{50}.
\item $x=1$是$x>0$的\bracket{20}条件.
\fourch{充分非必要}{必要非充分}{充要}{既非充分又非必要}
\item 已知$f(x)=x^2+1$, 求$f(3)+f(5)$的值.
\end{enumerate}

这是一个由三道题目组成的enumerate环境(文件的其他部分可以在模板文件/讲义模板.txt中获取), 手动输入后, 可以通过面板收录到题库. 但是更多时候这样一个LaTeX文件的来源是通过mathpix识别得到的.

使用mathpix自动识别题目

mathpix是一个非常好用的数学文字和公式转换工具, 唯一的缺点是大量转换要花钱, 目前新账号的处理限额是每月10次(基本上不够用). 如果还没有注册过的话, 建议用一个邮箱注册一下. mathpix的网址是mathpix(https://mathpix.com).

下载mathpix的桌面客户端:

如果不想注册或者限额用完了, 以下几个账号可能可以用(限额应该会每月更新):

Nelly.Eugen@alumni.stanford.edu 密码: 321aA@mathpix
fchavez46@student.mtsac.edu 密码: Ab@789789
fwhitsett@student.mtsac.edu 密码: Ab@789789
4552933337@student.cumtb.edu.cn 密码: Ab@789789
515625773@student.cumtb.edu.cn 密码: Ab@789789

以下以识别tutorial分支上的../文档/教学材料/待收录.png为例:

在资源管理器中打开这个文件(肉眼可见其中的内容).
启动mathpix客户端(一般会隐藏在右下角)
右键点击图标, 在弹出的菜单中选GET LATEX(后面跟着的是快捷键)
屏幕会变成灰黑色, 并且有一个十字表示鼠标当前位置, 拖一个红色的矩形框圈住所有想要识别的文字(表会被识别, 图不会), 等待一会儿
在mathpix窗口中按图示方式点击, 将LaTeX代码复制到剪贴板

识别的内容复制到剪贴板之后的操作

作一些预处理, 使风格和题库中的题目的风格一致, 并确保LaTeX代码没有语法错误

在面板上点击其他-mathpix识别文字预处理, 点击绿色的运行, 这会预处理识别的结果, 预处理后的结果仍然在剪贴板中
在vscode中打开模板文件/讲义模板.txt, 另存为临时文件中任意一个以.tex结尾的文件, 例如test01.tex
在该.tex文件中将图中的<<待替换2>>替换为如下代码(粘贴后如果有代码缩进, 全选按-可取消缩进)

\begin{enumerate}
<剪贴板中的代码>
\end{enumerate}

4. 按ctrl-alt-b编译, 如果下方状态栏的圈转了之后显示勾, 说明编译成功, 这时可按ctrl-alt-v查看编译结果; 如果显示红色的叉, 说明文件有问题, 需要自己或有经验的同伴帮忙检查一下 5. 题目中或多或少会有一些问题, 这一步先不用修改. 6. 全选.tex文件的内容, 并复制到剪贴板.

和题库中已有的题目作比对并手动作一些标记

在导入新题到题库时, 我们一般关心每一道新题目是否和题库中已有的题目完全相同(可能描述会有细微的差别, 但不需要作较为精细的理解就能发现两道题目的含义一致, 并且题目类型[填空/选择/解答]也完全一致, 如果是选择题的话, 选项也一致), 或者明显相关联(未达到上述标准, 但是求解时所用的方法一致, 计算难度相当; 或者某一题是另一题的一部分等).

对于完全相同的题, 如果它不出现在一张规范的整卷(如一模二模卷, 高考卷等), 那事实上没有必要收录, 使用之前的题目即可; 如果它出现在一张规范的整卷中, 为了整卷的题号连续起见, 还是希望再收录一遍该题, 收录的同时作好相同的标记(same).

对于相关的题, 也希望能在收录时做好相关的标记(related).

在上一步的.tex源代码全部被复制到剪贴板之后, 紧接着用面板进行新题比对, 在面板的录入菜单中选择新题比对, 立即点击运行按钮
在vscode中会呈现一个名为新题比对.tex的LaTeX源文件, 在该窗口内按ctrl-alt-b进行编译, 如果编译通过的话按ctrl-alt-v在右侧预览
右侧pdf中的每一道题之后可能会有几个色块, 每一个色块表示一道字符串意义下和原题比较接近的题目(Levenshtein jaro算法), 源代码的\item后面有一个中括号, 中括号内是色块中题目的题号. 色块越红越表示越接近.
如果在色块中的题目和打算导入的新题是相同的, 可以用原有的题目替代, 那么在中括号中的题号前加上rep字样(同时本题其他色块题号的标注都作为无效).
如果在色块中的题目和打算导入的新题是相同的, 但依然打算导入为新题, 那么在中括号中的题号前加上s字样(同时本题其他色块题号的s,r标注依然有效), 如下图
如果在色块中的题目和打算导入的新题是相关的, 那么在中括号中的题号前加上r字样(同时本题其他色块题号的s,r标注依然有效), 如上图
在做标记时, 仔细检查欲导入的题目内容是否有明显问题, 图不会画的话在题目后方打上缺图字样, 后续管理员会跟进处理
标记期间随时可以保存或编译(编译时会自动保存), 标记完成后记得ctrl-alt-b编译, 确定没有语法错误

将标记完成的题目及相关信息一并收录到题库

在面板上选录入-批量收录题目
在vscode的批量收录题目.py窗口中修改以下信息:
1. starting_id表示起始题号(int类型), 如果起始题号被占用, 则会自动寻找之后的第一个空闲题号作为起始
2. raworigin表示题目来源, 如果没有明确的出处建议使用自拟题目字符串
3. editor表示收录者, 改为自己的名字
4. IndexDescription是字符串, 默认留空; 如果新试题来自一张试卷, 将其改为"试题", 效果是收录题目时会对题目的题号做标注, 类似2023年上海秋季高考试题3
编辑完成后保存, 关闭, 随后在面板上点击运行按钮
终端会显示收录的进度, 收录完成后vscode会打开一个名为新题收录列表.txt的窗口, 最后两行就是本次收录的信息(日期, 题号等)

随后如果有必要, 可添加Problems.json及新题收录列表.txt至暂存区, 之后可以commit到本地的repository, 乃至push到远程的服务器.

添加关联题

在题库中选择需要添加关联题的旧题目的题号(可用:和,进行分隔)
在面板上选择录入-添加关联题目
对vscode中打开的添加关联题目.py进行编辑, 一般需要修改以下三处
1. 修改被关联的题号(可用:和,进行分隔)
2. 新题目的起始题号(int类型), 如果起始题号被占用, 则会自动寻找之后的第一个空闲题号作为起始
3. 编辑者姓名
保存后关闭添加关联题目.py, 在面板上点击运行
在vscode中会打开一个problems.json的文件, 目前它将旧题目的信息复制了过来, 在related字段(黄色框)中自动建立了关联.
在编辑时(见上图), id字段一定不要改动, content字段中保存的是raw格式的字符串, 和LaTeX代码主要的区别如下:

raw格式	LaTeX格式
`\\`	`\`
`\n`	`<换行>`
`\t`	`<tab>`

genre字段可能有变化(类型[填空题/选择题/解答题]可能变化了), ans和solution字段中如果有内容可能需要修改或删去(题目改变了解答和答案可能有变化) 7. 编辑完成后保存, 关闭problem_edit.json文件后, 程序会自动添加新的题目, 添加完成后会对新题目进行试编译. 如果试编译失败, 则刚才的所有编辑将全部失效(所以每次建议少添加几个关联题), 题库文件将退回原状; 如果试编译成功, 则Problems.json中的相应位置会添加对应的关联题目

随后如果有必要, 可添加Problems.json至暂存区, 之后可以commit到本地的repository, 乃至push到远程的服务器.

导入metadata(各种数据与信息, 如答案, 解答, 备注, 使用记录, 标签等)

在工具v2/文本文件目录中有一个名为metadata.txt的文件, 其一般结构如下:

ans

10235
$1$

2235
真命题

usages

021146
20231222	2025届高二11班	1.000

021147
20231222	2025届高二11班	0.952

其中ans表示答案, usages表示使用记录.

这个metadata.txt文件如果导入题库, 会

把第10235题的答案用 $1$ 覆盖,
把第2235题的答案用真命题覆盖,
在21146的usages字段中添加20231222 2025届高二11班 1.000,
在021147的usages字段中添加20231222 2025届高二11班 0.952.

每一个字段(如ans或usages等)及每一条记录之间都用多于一个换行符分隔(很多情况下换行之类的格式都是自动生成的), 其他metadata.txt可以接受的字段有:

content: 题目内容(str类型), 导入时将覆盖原内容
objs: 课时目标(目标代码, list类型), 导入时将新增项目
tags: 题目标签(list类型), 导入时将新增项目
genre: 题目类型(填空题/选择题/解答题), 导入时将覆盖原内容
ans: 答案(str类型), 导入时将覆盖原内容
solution: 解答或提示(str类型), 导入时将覆盖原内容
duration: 所需时间(单位为分钟, 暂时均赋值-1, int类型), 导入时将覆盖原内容
usages: 使用记录(yyyymmdd<tab>班级代号<tab>得分率), 导入时将和之前的记录作比对, 如果确认是新的则新增项目
edit: 编辑记录(list类型), 导入时将新增项目
same: 相同题号(指内容和类型均相同的题目, list类型), 导入时将双向新增项目(a与b相同当且仅当b与a相同, 导入时会在两道题的记录中同时添加题号)
related: 相关题号(指题目和做法都基本一致或者某一题是另一题的一部分, list类型), 导入时将双向新增项目(a与b相关当且仅当b与a相关, 导入时会在两道题的记录中同时添加题号)
unrelated: 无关题号(指字符串意义上相近, 容易被自动找出, 但实际上无关的题目, list类型), 导入时将双向新增项目(a与b无关当且仅当b与a无关, 导入时会在两道题的记录中同时添加题号)
remark: 备注(str类型), 导入时将新增字符串
space: 题后的空间(单位一般为em, 大部分解答题默认为4em, str类型), 导入时将覆盖原内容

准备好metadata.txt文件之后, 在工具面板上按维护-批量添加字段数据

在vscode界面会打开文本文件/metadata.txt, 编辑完成后保存关闭(重要, 不关闭的话面板会处于假死状态), 面板会生成一个绿色的运行按钮, 按动按钮, 系统会自动导入数据到题库0.3/Problems.json.

随后如果有必要, 可添加Problems.json至暂存区, 之后可以commit到本地的repository, 乃至push到远程的服务器.

两种编辑题库中已有题目的方式

LaTeX方式(可编辑题目, 答案, 解答, 备注)

使用过程中, 往往会发现题库中已有的题目, 答案, 解答, 备注有错误或瑕疵, 需要修改. 这些修改不应该仅停留在讲义上(否则下次使用同一道题目还会有同样的错误), 而是应该在题库中被永久保留下来. 如果仅仅是对[题目/答案/解答/备注]的修改, 可以按LaTeX代码的方式进行操作(比直接编辑json直观), 具体方法如下:

在面板上选择维护-LaTeX编辑题目答案及提示
在打开的latex编辑题目答案及提示.py文件中修改一些信息
1. 要被编辑的题号(可用:和,进行分隔)
2. 编辑者
信息修改完成后保存, 关闭latex编辑题目答案及提示.py, 在面板上点击运行
以LaTeX的方式对vscode中新展示的problem_edit.tex进行对应的编辑, 主要的编辑在四个红色方框处, 分别是题目内容, 答案, 解答与提示, 备注. 注意在编辑时[答案/解答与提示/备注]后面冒号之后的空格和空行都不要删除.
编辑完成后保存, 关闭, 程序会试编译编辑以后的信息. 如果试编译失败, 则刚才的所有编辑将全部失效(所以每次建议少编辑几个信息), 题库文件将退回原状; 如果试编译成功, 则Problems.json中的相应位置会添加对应的关联题目

随后如果有必要, 可添加Problems.json至暂存区, 之后可以commit到本地的repository, 乃至push到远程的服务器.

json方式(可编辑任何信息)

使用过程中, 有时会发现题库中已有的题目的其他信息也有错误或瑕疵(例如题目类型指定错误等), 需要修改. 这些修改同样应该在题库中被永久保留下来. 它们都可以按json代码的方式进行修改, 具体方法如下:

在面板上选择维护-json编辑题目综合信息
在打开的json编辑题目综合信息.py文件中修改一些信息
1. 要被编辑的题号(可用:和,进行分隔)
2. 编辑者
信息修改完成后保存, 关闭json编辑题目综合信息.py, 在面板上点击运行
在vscode对新展示的problem_edit.json进行对应的编辑(例如下图中的全角分号改为; [半角分号空格]). 编辑时字段名, 含义, 类型参考导入metadata部分的说明
编辑完成后保存, 关闭, 程序会试编译编辑以后的信息. 如果试编译失败, 则刚才的所有编辑将全部失效(所以每次建议少编辑几个信息), 题库文件将退回原状; 如果试编译成功, 则Problems.json中的相应位置会添加对应的关联题目

随后如果有必要, 可添加Problems.json至暂存区, 之后可以commit到本地的repository, 乃至push到远程的服务器.

根据特定特征筛选题号

案例1 筛选内容中同时含有`最小值`(或`最大值`) `函数` `^3`(3次方)字样的题目

在面板上选择使用-关键字筛选题号
将vscode窗口中的关键字筛选题号.py文件的开头部分修改为如图
保存修改后关闭关键字筛选题号.py, 在面板上点击运行, 一小段时间之后vscode就会显示选中的题号字符串了, 需要的话可以复制下来

案例2 筛选2026届有使用记录, 题目中没有大于等于号, 也没有小于等于号, 并且标签含`第一单元`(预备知识)的题目

在面板上选择使用-关键字筛选题号
将vscode窗口中的关键字筛选题号.py文件的开头部分修改为如图
保存修改后关闭关键字筛选题号.py, 在面板上点击运行, 一小段时间之后vscode就会显示选中的题号字符串了, 需要的话可以复制下来

案例3 筛选2024届的使用记录中出现过`0.1??`或`0.2??`的所有题目

在面板上选择使用-关键字筛选题号
将vscode窗口中的关键字筛选题号.py文件的开头部分修改为如图
保存修改后关闭关键字筛选题号.py, 在面板上点击运行, 一小段时间之后vscode就会显示选中的题号字符串了, 需要的话可以复制下来

案例3 筛选答案中含有 $2$ (LaTeX公式环境下的2)的所有题目

在面板上选择使用-关键字筛选题号
将vscode窗口中的关键字筛选题号.py文件的开头部分修改为如图
保存修改后关闭关键字筛选题号.py, 在面板上点击运行, 一小段时间之后vscode就会显示选中的题号字符串了, 需要的话可以复制下来

根据题号表达式(可含:或,的字符串)生成讲义

一个很常见的需求是根据题号字符串(常来自于关键字筛选题号功能)生成一个包含题目以及相关信息的pdf文件. 方法如下:

准备好一个题号字符串(例如来自于关键字筛选题号或者直接手搓一个比如12300:12305,20100:20103)
在面板上选择使用-多种题目生成
在vscode自动打开的config.json文件的"多种题目生成.py"部分进行编辑, 一个案例如图:
编辑完成后保存, 关闭config.json, 点击运行, 稍等一会儿之后, 就能在临时文件文件夹中根据文件名或者修改时间找到按照要求编译的pdf文件了

系列讲义生成

除了根据自己的需求生成讲义之外, 用题库生成讲义的另一个主要方式是根据题库中现有的讲义结构生成一张或多张讲义. 从2023学年第2学期开始(部分年级从第1学期开始), 讲义的题号数据都被规范地保存在了我们的题库项目中. 以下是生成讲义的方法:

在面板上选择备课-系列讲义生成
在vscode自动打开的config.json文件的"系列讲义生成.py"部分进行编辑, 一个案例如图:
编辑完成后保存, 关闭config.json, 点击运行, 稍等一会儿之后, 就能在指定的文件夹中根据文件名或者修改时间找到.tex文件(有单个的, 也有合集)和按照要求编译的.pdf文件了(根据设定, 合集文件命名为合集<yyyymmdd>.pdf), 我们的案例将编译出一个715页的pdf文件,
其中单个的.tex文件都是可以打开编译或编辑的

从LaTeX源文件中提取答案

TBD

题目和单元挂钩

生成"未挂钩单元题目"的LaTeX源文件、pdf文件与数据文件(临时文件/单元对应.txt)

TBD

根据数据文件(临时文件/单元对应.txt)生成metadata.txt

TBD

小闲平台使用数据导入

TBD

录入讲义结构与内容

讲义首字母的通用规则(2023学年第2学期起实施)

E: 正式测验卷与考试卷
I: 非正式的小测验
W: 周末卷
G: 高一高二的学案
J: 高三的复习讲义
F: 高三的赋能卷
V: 假期作业

录入新的讲义种类的结构(备课组之前未使用过的首字母)

TBD(先看视频)

录入新的讲义的题号ID等内容

TBD(先看视频)

对小闲平台的答题纸与数据库进行对应

对应的目的是能更方便地收录使用信息

TBD(先看视频)

添加基础知识梳理

因可能有冲突, 故建议该项工作完全由管理员进行, 备课组负责人整理完成后在gitlab上提issue

TBD

25 KiB Raw Blame History Unescape Escape

题库使用指南2024版

注意事项

打开面板的方式

在overleaf上协作编辑

在gitlab上提交issue

收录新题

使用mathpix自动识别题目

识别的内容复制到剪贴板之后的操作

作一些预处理, 使风格和题库中的题目的风格一致, 并确保LaTeX代码没有语法错误

和题库中已有的题目作比对并手动作一些标记

将标记完成的题目及相关信息一并收录到题库

添加关联题

导入metadata(各种数据与信息, 如答案, 解答, 备注, 使用记录, 标签等)

两种编辑题库中已有题目的方式

LaTeX方式(可编辑题目, 答案, 解答, 备注)

json方式(可编辑任何信息)

根据特定特征筛选题号

案例1 筛选内容中同时含有最小值(或最大值) 函数 ^3(3次方)字样的题目

案例2 筛选2026届有使用记录, 题目中没有大于等于号, 也没有小于等于号, 并且标签含第一单元(预备知识)的题目

案例3 筛选2024届的使用记录中出现过0.1??或0.2??的所有题目

案例3 筛选答案中含有$2$(LaTeX公式环境下的2)的所有题目

根据题号表达式(可含:或,的字符串)生成讲义

系列讲义生成

从LaTeX源文件中提取答案

题目和单元挂钩

生成"未挂钩单元题目"的LaTeX源文件、pdf文件与数据文件(临时文件/单元对应.txt)

根据数据文件(临时文件/单元对应.txt)生成metadata.txt

小闲平台使用数据导入

录入讲义结构与内容

讲义首字母的通用规则(2023学年第2学期起实施)

录入新的讲义种类的结构(备课组之前未使用过的首字母)

录入新的讲义的题号ID等内容

对小闲平台的答题纸与数据库进行对应

添加基础知识梳理

25 KiB

Raw Blame History

案例1 筛选内容中同时含有`最小值`(或`最大值`) `函数` `^3`(3次方)字样的题目

案例2 筛选2026届有使用记录, 题目中没有大于等于号, 也没有小于等于号, 并且标签含`第一单元`(预备知识)的题目

案例3 筛选2024届的使用记录中出现过`0.1??`或`0.2??`的所有题目

案例3 筛选答案中含有 $2$ (LaTeX公式环境下的2)的所有题目