更新图床为新服务器上的
This commit is contained in:
parent
8ed57eb28a
commit
8cc23e496f
|
|
@ -1,4 +1,4 @@
|
|||
|
||||
|
||||
|
||||
# <center>题库使用指南2024年5月版</center>
|
||||
|
||||
|
|
@ -35,17 +35,17 @@
|
|||
|
||||
## 打开面板的方式
|
||||
|
||||
|
||||
|
||||
|
||||
在配置好python的math环境, 在题库根目录运行过``pip install -r requirements.txt``, 并且编写过``conda_initiate.bat``之后(编写``conda_initiate.bat``的工作请联系管理员), 在``cmd终端``的题库根目录运行``conda_initiate.bat``, 会跳出一个``PySide6``做的GUI面板.
|
||||
|
||||
如果面板还没有跳出来, 随后在终端依次输入``cd 工具v3``回车, ``python 工具面板.py``回车, 就会跳出一个``tkinter``做的GUI面板.
|
||||
|
||||
|
||||
|
||||
|
||||
## 在overleaf上协作编辑
|
||||
|
||||
|
||||
|
||||
|
||||
我们**自己部署的本地overleaf服务器**的地址是[overleaf kongjiang](http://kjwangweiye.top:40388)(``kjwangweiye.top:40388``)或[overleaf kongjiang mirror](http://wwylss.synology.me:40388)(``wwylss.synology.me:40388``)
|
||||
|
||||
|
|
@ -55,23 +55,23 @@
|
|||
|
||||
知道对方的邮箱的话, 可以在overleaf上邀请对方参加协作, 一起编辑同一个项目.
|
||||
|
||||
|
||||
|
||||
|
||||
## 在gitlab上提交issue
|
||||
|
||||
我们**自己部署的本地gitlab服务器**的地址是[gitlab](http://wwylss.synology.me:30000)(``wwylss.synology.me:30000``)
|
||||
|
||||
|
||||
|
||||
|
||||
如果还未注册过, 请在上述界面中注册, 并联系管理员以通过注册.
|
||||
|
||||
一个较大的项目的协作者之间的工作联系通常**不是**通过微信、电话这种*追溯历史不太方便的方式*实现的. gitlab提供了一个比较有效的方式: 提交issue(问题/事件)
|
||||
|
||||
|
||||
|
||||
|
||||
上图就是提交issue的按钮, 点击后选择``新建议题``, 会显示下面的界面
|
||||
|
||||
|
||||
|
||||
|
||||
1. 用简略的文字描述issue
|
||||
2. 详细描述issue的内容(可以使用markdown语法, 如果会markdown的话)
|
||||
|
|
@ -106,9 +106,9 @@ mathpix是一个非常好用的数学文字和公式转换工具, 唯一的缺
|
|||
|
||||
下载mathpix的桌面客户端:
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
如果不想注册或者限额用完了, 以下几个账号可能可以用(限额应该会每月更新):
|
||||
|
||||
|
|
@ -125,16 +125,16 @@ mathpix是一个非常好用的数学文字和公式转换工具, 唯一的缺
|
|||
1. 在资源管理器中打开这个文件(肉眼可见其中的内容).
|
||||
2. 启动mathpix客户端(一般会隐藏在右下角)
|
||||
|
||||
|
||||
|
||||
|
||||
3. 右键点击图标, 在弹出的菜单中选``GET LATEX``(后面跟着的是快捷键)
|
||||
4. 屏幕会变成灰黑色, 并且有一个十字表示鼠标当前位置, 拖一个红色的矩形框圈住所有想要识别的文字(表会被识别, 图不会), 等待一会儿
|
||||
|
||||
|
||||
|
||||
|
||||
5. 在mathpix窗口中按图示方式点击, 将LaTeX代码复制到剪贴板
|
||||
|
||||
|
||||
|
||||
|
||||
### 识别的内容复制到剪贴板之后的操作
|
||||
|
||||
|
|
@ -142,11 +142,11 @@ mathpix是一个非常好用的数学文字和公式转换工具, 唯一的缺
|
|||
|
||||
1. 在面板上点击``LaTeX代码相关``-``文本转换处理``, 选中``Mathpix``, 将Mathpix识别产生的代码粘贴到左侧的框中, 按``运行``, 右侧框中就会生成与处理之后的代码
|
||||
|
||||
|
||||
|
||||
|
||||
2. 在``vscode``中打开``模板文件/讲义模板.txt``, 另存为``临时文件``中任意一个以``.tex``结尾的文件, 例如``test01.tex``
|
||||
|
||||
|
||||
|
||||
|
||||
3. 在该``.tex``文件中将图中的``<<待替换2>>``替换为如下代码(粘贴后如果有代码缩进, 全选按<shift>-<tab>可取消缩进)
|
||||
```latex
|
||||
|
|
@ -155,9 +155,9 @@ mathpix是一个非常好用的数学文字和公式转换工具, 唯一的缺
|
|||
\end{enumerate}
|
||||
```
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
4. 按``ctrl-alt-b``编译, 如果下方状态栏的圈转了之后显示勾, 说明编译成功, 这时可按``ctrl-alt-v``查看编译结果; 如果显示红色的叉, 说明文件有问题, 需要自己或有经验的同伴帮忙检查一下
|
||||
5. 题目中或多或少会有一些问题, 这一步先不用修改.
|
||||
|
|
@ -173,20 +173,20 @@ mathpix是一个非常好用的数学文字和公式转换工具, 唯一的缺
|
|||
|
||||
1. **在上一步的``.tex``源代码全部被复制到剪贴板之后**, 紧接着用面板进行新题比对, 在面板的``录入``菜单中选择``新题比对``, 立即点击``运行``按钮
|
||||
|
||||
|
||||
|
||||
|
||||
2. 在``vscode``中会呈现一个名为``新题比对.tex``的LaTeX源文件, 在该窗口内按``ctrl-alt-b``进行编译, 如果编译通过的话按``ctrl-alt-v``在右侧预览
|
||||
|
||||
|
||||
|
||||
|
||||
3. 右侧pdf中的每一道题之后可能会有几个色块, 每一个色块表示一道*字符串意义下*和原题比较接近的题目(Levenshtein jaro算法), 源代码的``\item``后面有一个中括号, 中括号内是色块中题目的题号. 色块越红越表示越接近.
|
||||
4. 如果在色块中的题目和打算导入的新题是相同的, 可以用原有的题目替代, 那么在中括号中的题号前加上``rep``字样(同时本题其他色块题号的标注都作为无效).
|
||||
|
||||
|
||||
|
||||
|
||||
5. 如果在色块中的题目和打算导入的新题是相同的, 但依然打算导入为新题, 那么在中括号中的题号前加上``s``字样(同时本题其他色块题号的``s``,``r``标注依然有效), 如下图
|
||||
|
||||
|
||||
|
||||
|
||||
6. 如果在色块中的题目和打算导入的新题是相关的, 那么在中括号中的题号前加上``r``字样(同时本题其他色块题号的``s``,``r``标注依然有效), 如上图
|
||||
7. 在做标记时, 仔细检查欲导入的题目内容是否有明显问题, 图不会画的话在题目后方打上``缺图``字样, 后续管理员会跟进处理
|
||||
|
|
@ -196,11 +196,11 @@ mathpix是一个非常好用的数学文字和公式转换工具, 唯一的缺
|
|||
|
||||
1. 在面板上选``录入``-``批量收录题目``
|
||||
|
||||
|
||||
|
||||
|
||||
2. 在``vscode``的``批量收录题目.py``窗口中修改以下信息:
|
||||
|
||||
|
||||
|
||||
|
||||
1. ``starting_id``表示起始题号(``int``类型), 如果起始题号被占用, 则会自动寻找之后的第一个空闲题号作为起始
|
||||
2. ``raworigin``表示题目来源, 如果没有明确的出处建议使用``自拟题目``字符串
|
||||
|
|
@ -209,7 +209,7 @@ mathpix是一个非常好用的数学文字和公式转换工具, 唯一的缺
|
|||
3. 编辑完成后保存, 关闭, 随后在面板上点击``运行``按钮
|
||||
4. 终端会显示收录的进度, 收录完成后``vscode``会打开一个名为``新题收录列表.txt``的窗口, 最后两行就是本次收录的信息(日期, 题号等)
|
||||
|
||||
|
||||
|
||||
|
||||
随后如果有必要, 可添加``Problems.json``及``新题收录列表.txt``至暂存区, 之后可以commit到本地的repository, 乃至push到远程的服务器.
|
||||
|
||||
|
|
@ -218,11 +218,11 @@ mathpix是一个非常好用的数学文字和公式转换工具, 唯一的缺
|
|||
1. 在题库中选择需要添加关联题的旧题目的题号(可用``:``和``,``进行分隔)
|
||||
2. 在面板上选择``录入``-``添加关联题目``
|
||||
|
||||
|
||||
|
||||
|
||||
3. 对``vscode``中打开的``添加关联题目.py``进行编辑, 一般需要修改以下三处
|
||||
|
||||
|
||||
|
||||
|
||||
1. 修改被关联的题号(可用``:``和``,``进行分隔)
|
||||
2. 新题目的起始题号(``int``类型), 如果起始题号被占用, 则会自动寻找之后的第一个空闲题号作为起始
|
||||
|
|
@ -230,7 +230,7 @@ mathpix是一个非常好用的数学文字和公式转换工具, 唯一的缺
|
|||
4. 保存后关闭``添加关联题目.py``, 在面板上点击``运行``
|
||||
5. 在``vscode``中会打开一个``Problems.json``的文件, 目前它将旧题目的信息复制了过来, 在``related``字段(黄色框)中自动建立了关联.
|
||||
|
||||
|
||||
|
||||
|
||||
6. 在编辑时(见上图), ``id``字段**一定不要改动**, ``content``字段中保存的是raw格式的字符串, 和LaTeX代码主要的区别如下:
|
||||
|
||||
|
|
@ -294,11 +294,11 @@ usages
|
|||
|
||||
准备好``metadata.txt``文件之后, 在工具面板上按``维护``-``批量添加字段数据``
|
||||
|
||||
|
||||
|
||||
|
||||
在``vscode``界面会打开``文本文件/metadata.txt``, 编辑完成后**保存关闭**(重要, 不关闭的话面板会处于假死状态), 面板会生成一个绿色的``运行``按钮, 按动按钮, 系统会自动导入数据到``题库0.3/Problems.json``.
|
||||
|
||||
|
||||
|
||||
|
||||
随后如果有必要, 可添加``Problems.json``至暂存区, 之后可以commit到本地的repository, 乃至push到远程的服务器.
|
||||
|
||||
|
|
@ -311,11 +311,11 @@ usages
|
|||
|
||||
1. 在面板上选择``维护``-``LaTeX编辑题目答案及提示``
|
||||
|
||||
|
||||
|
||||
|
||||
2. 在打开的``latex编辑题目答案及提示.py``文件中修改一些信息
|
||||
|
||||
|
||||
|
||||
|
||||
1. 要被编辑的题号(可用``:``和``,``进行分隔)
|
||||
2. 编辑者
|
||||
|
|
@ -323,7 +323,7 @@ usages
|
|||
|
||||
4. 以LaTeX的方式对``vscode``中新展示的``problem_edit.tex``进行对应的编辑, 主要的编辑在四个红色方框处, 分别是题目内容, 答案, 解答与提示, 备注. 注意在编辑时[答案/解答与提示/备注]后面**冒号之后的空格和空行都不要删除**.
|
||||
|
||||
|
||||
|
||||
|
||||
5. 编辑完成后保存, 关闭, 程序会试编译编辑以后的信息. 如果试编译失败, 则刚才的所有编辑将全部失效(所以每次建议少编辑几个信息), 题库文件将退回原状; 如果试编译成功, 则``Problems.json``中的相应位置会添加对应的关联题目
|
||||
|
||||
|
|
@ -335,18 +335,18 @@ usages
|
|||
|
||||
1. 在面板上选择``维护``-``json编辑题目综合信息``
|
||||
|
||||
|
||||
|
||||
|
||||
2. 在打开的``json编辑题目综合信息.py``文件中修改一些信息
|
||||
|
||||
|
||||
|
||||
|
||||
1. 要被编辑的题号(可用``:``和``,``进行分隔)
|
||||
2. 编辑者
|
||||
3. 信息修改完成后保存, 关闭``json编辑题目综合信息.py``, 在面板上点击``运行``
|
||||
4. 在``vscode``对新展示的``problem_edit.json``进行对应的编辑(例如下图中的全角分号改为``; ``[半角分号空格]). 编辑时字段名, 含义, 类型参考``导入metadata``部分的说明
|
||||
|
||||
|
||||
|
||||
|
||||
5. 编辑完成后保存, 关闭, 程序会试编译编辑以后的信息. 如果试编译失败, 则刚才的所有编辑将全部失效(所以每次建议少编辑几个信息), 题库文件将退回原状; 如果试编译成功, 则``Problems.json``中的相应位置会添加对应的关联题目
|
||||
|
||||
|
|
@ -358,19 +358,19 @@ usages
|
|||
|
||||
1. 在面板上选择``使用``-``关键字筛选题号``, 点击绿色的``运行``按钮.
|
||||
|
||||
|
||||
|
||||
|
||||
2. 在弹出的面板上右上方的文本框中输入``最大值, 最小值``(``,``表示``至少有一个``)后点击``内容``, 随后点击左下方的``运行``, 液晶数字会急剧减小, 表示符合要求的题目数量减少了.
|
||||
|
||||
|
||||
|
||||
|
||||
3. 删去文本框的内容, 在文本框中输入``函数``, 点击``内容``, 随后点击左下方的``运行``, 题目数量继续减少.
|
||||
|
||||
|
||||
|
||||
|
||||
4. 删去文本框的内容, 在文本框中输入``\^3``, 点击``内容``, 随后点击左下方的``运行``, 题目数量继续减少.
|
||||
|
||||
|
||||
|
||||
|
||||
5. 点击``运行``按钮, 再点击``保存和编译``按钮(vscode的终端已经开始有动静了), 一小段时间之后, 可以在``临时文件``目录找到``筛选题目编译.pdf``文件, 这就是符合要求的所有题目. 题号在``临时文件``目录下的``题目筛选.txt``中.
|
||||
|
||||
|
|
@ -380,7 +380,7 @@ usages
|
|||
|
||||
2. 在选中``选中表示不包含``左侧的方框的同时, 在文本框中输入``le``, 点击``内容``, 再输入``ge``, 点击``内容``.
|
||||
|
||||
|
||||
|
||||
|
||||
3. 在未选中``选中表示不包含``左侧的方框的同时, 在文本框中输入``第一单元``, 点击``标签``, 在文本框总输入``2026届``, 点击``使用记录``
|
||||
|
||||
|
|
@ -417,11 +417,11 @@ usages
|
|||
1. 准备好一个题号字符串(例如来自于``关键字筛选题号``或者直接手搓一个比如``12300:12305,20100:20103``)
|
||||
2. 在面板上选择``使用``-``多种题目生成``
|
||||
|
||||
|
||||
|
||||
|
||||
3. 在``vscode``自动打开的``config.json``文件的``"多种题目生成.py"``部分进行编辑, 一个案例如图:
|
||||
|
||||
|
||||
|
||||
|
||||
4. 编辑完成后保存, 关闭``config.json``, 点击``运行``, 稍等一会儿之后, 就能在``临时文件``文件夹中根据文件名或者修改时间找到按照要求编译的pdf文件了
|
||||
|
||||
|
|
@ -431,11 +431,11 @@ usages
|
|||
|
||||
1. 在面板上选择``备课``-``系列讲义生成``
|
||||
|
||||
|
||||
|
||||
|
||||
2. 在``vscode``自动打开的``config.json``文件的``"系列讲义生成.py"``部分进行编辑, 一个案例如图:
|
||||
|
||||
|
||||
|
||||
|
||||
3. 编辑完成后保存, 关闭``config.json``, 点击``运行``, 稍等一会儿之后, 就能在指定的文件夹中根据文件名或者修改时间找到.tex文件(有单个的, 也有合集)和按照要求编译的.pdf文件了(根据设定, 合集文件命名为``合集<yyyymmdd>.pdf``), 我们的案例将编译出一个715页的pdf文件
|
||||
|
||||
|
|
@ -453,31 +453,31 @@ usages
|
|||
|
||||
1. 用题号为1-100的题目生成一个.tex文件(``使用``-``多种题目生成``), ``config.json``文件中的重要改变如图, 点``运行``, 稍候一会儿
|
||||
|
||||
|
||||
|
||||
|
||||
2. 在``临时文件``中找到刚生成的``.tex``文件, 双击后在vscode中打开, ``ctrl-alt-b``编译, ``ctrl-alt-v``查看编译结果
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
3. 修订蓝色的答案, 如果有红色的答案想要修订, 也把前面的red改为blue
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
4. 完成修订后全选LaTeX代码, 复制到剪贴板. 在面板上选``维护``--``文件或剪贴板提取答案``
|
||||
|
||||
|
||||
|
||||
|
||||
5. 在随后``vscode``窗口的``config.json``中``文件或剪贴板提取答案.py``部分的``来自剪贴板:``后填入``true``(如果填入``false``的话, 需要修改下一行的``文件地址``为录入过答案的LaTeX文件的地址). ``前缀``一行不改动.
|
||||
|
||||
|
||||
|
||||
|
||||
6. 保存``config.json``并关闭, 在面板上点击``运行``. 题号与答案的对应就已经在``文本文件/metadata.txt``中了
|
||||
|
||||
|
||||
|
||||
|
||||
随后可以使用面板上的``维护``-``批量添加字段数据``功能将答案正式导入数据库. 之后如果有必要, 可添加``Problems.json``至暂存区, 之后可以commit到本地的repository, 乃至push到远程的服务器.
|
||||
|
||||
|
|
@ -506,17 +506,17 @@ usages
|
|||
|
||||
1. 在面板上选择``维护``-``单元挂钩``选项
|
||||
|
||||
|
||||
|
||||
|
||||
2. 在``vscode``中对自动打开的``config.json``文件的``单元挂钩.py``部分进行编辑. 第一个红色框处输入1, 第二个红色框留空(表示仅对新题进行处理)
|
||||
|
||||
|
||||
|
||||
|
||||
3. 编辑完成后保存并关闭``config.json``文件, 在面板上点击``运行``按钮. 会在``临时文件``目录中生成一个``待检查单元.pdf``文件, 同时在相同的目录下生成一个``单元对应.txt``文件. 这两个文件都会自动打开, 而且其中的信息是对应的.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
4. 逐一检查自动对应的单元是否正确(如果不正确的话, 只需在.txt文件中修改), 并将未自动对应的题号的单元在.txt文件中录入. **单元号支持``253``这种对应多个单元的语法**.
|
||||
|
||||
|
|
@ -530,11 +530,11 @@ usages
|
|||
|
||||
2. 在面板上选择``维护``-``单元挂钩``选项
|
||||
|
||||
|
||||
|
||||
|
||||
3. 在``vscode``中对自动打开的``config.json``文件的``单元挂钩.py``部分进行编辑. 红色框处输入2.
|
||||
|
||||
|
||||
|
||||
|
||||
4. 编辑完成后保存并关闭``config.json``文件, 在面板上点击``运行``按钮. 程序会将``单元对应.txt``中已经对应单元的题号(单元号后面没有数字的会自动放弃)中的单元信息保存到``文本文件/metadata.txt``中并打开该文件. **建议将该文件用提交issue的方式发给管理员**, 管理员可以用``维护``-``批量添加字段数据``功能将信息导入到``题库0.3/Problems.json``数据库, 如果仅仅是为了测试, 可以自行操作后在git面板中观察``Problems.json``文件在导入前后的变化
|
||||
|
||||
|
|
@ -573,19 +573,19 @@ TBD(先看视频)
|
|||
|
||||
1. 在小闲平台``ls.xiaoxianzi.cn``用浏览器登录(注意不要用客户端), 在想要处理的作业或考试处点击``下载报表``按钮, 同时记下扫描的日期(``yyyymmdd``格式, 如``20240118``)
|
||||
|
||||
|
||||
|
||||
|
||||
2. 稍后找到下载文件的路径, 在windows的资源管理器中选中该文件, 点菜单栏上的``主页``-``复制路径``(win11可直接右键后在菜单中选择)
|
||||
|
||||
|
||||
|
||||
|
||||
3. 在面板上选择``维护``-``小闲平台使用数据导入``
|
||||
|
||||
|
||||
|
||||
|
||||
4. 在``vscode``打开的``config.json``文件的``收集使用记录.py``部分进行编辑, 方式见下图
|
||||
|
||||
|
||||
|
||||
|
||||
5. 编辑完成后保存并关闭``config.json``, 点击面板上的``运行``按钮, 将生成``文本文件/metadata.txt``并在``vscode``中打开. **建议将该文件用提交issue的方式发给管理员**, 管理员可以用``维护``-``批量添加字段数据``功能将信息导入到``题库0.3/Problems.json``数据库, 如果仅仅是为了测试, 可以自行操作后在git面板中观察``Problems.json``文件在导入前后的变化
|
||||
|
||||
|
|
|
|||
Reference in New Issue