From b5f3b36a1d86fe31784df9316a90b24730acdf48 Mon Sep 17 00:00:00 2001 From: "weiye.wang" Date: Thu, 8 Feb 2024 22:11:46 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BD=BF=E7=94=A8=E6=8C=87=E5=8D=97=E6=9B=B4?= =?UTF-8?q?=E6=96=B0=20=E5=AF=BC=E5=85=A5metadata=20=E7=9A=84=E8=AF=B4?= =?UTF-8?q?=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 文档/使用指南/使用指南2024.md | 56 ++++++++++++++++++++++++++++++++++- 1 file changed, 55 insertions(+), 1 deletion(-) diff --git a/文档/使用指南/使用指南2024.md b/文档/使用指南/使用指南2024.md index 1f1bf89e..b893574d 100644 --- a/文档/使用指南/使用指南2024.md +++ b/文档/使用指南/使用指南2024.md @@ -46,8 +46,62 @@ ## 添加关联题 -## 汇入metadata(各种数据与信息, 如答案, 解答, 备注, 使用记录, 标签等) +## 导入metadata(各种数据与信息, 如答案, 解答, 备注, 使用记录, 标签等) +在``工具v2/文本文件``目录中有一个名为``metadata.txt``的文件, 其一般结构如下: + +```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班级代号得分率``), 导入时将和之前的记录作比对, 如果确认是新的则**新增**项目 +- ``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``文件之后, 在工具面板上按``维护``-``批量添加字段数据`` + +![批量添加字段数据](http://wwylss.synology.me:48089/i/2024/02/08/65c4dfc8bf93e.png) + +在``vscode``界面会打开``文本文件/metadata.txt``, 编辑完成后**保存关闭**(重要, 不关闭的话面板会处于假死状态), 面板会生成一个绿色的``运行``按钮, 按动按钮, 系统会自动导入数据到``题库0.3/Problems.json``. + +![运行按钮](http://wwylss.synology.me:48089/i/2024/02/08/65c4e0ba11e72.png) + +随后如果有必要, 可保存``Problems.json``至暂存区, 之后可以commit到本地的repository, 乃至push到远程的服务器. ## 两种编辑题库中已有题目的方式