# 题库使用指南2024版
## 在overleaf上协作编辑
我们**自己部署的本地overleaf服务器**的地址是[overleaf kongjiang](http://kjwangweiye.top:40388)(``kjwangweiye.top:40388``)或[overleaf kongjiang mirror](http://wwylss.synology.me:40388)(``wwylss.synology.me:40388``)
如果还未注册过, 请联系管理员, 提供一个邮箱(可以是真实的邮箱, 也可以不是)以新建账号(之后首次登录会要求设置密码, 请**不要忘记邮箱和密码**)
万一忘记了邮箱和密码就只能删除账号重新再开了, 服务器上属于该账号的所有工作就一并被删除了.
知道对方的邮箱的话, 可以在overleaf上邀请对方参加协作, 一起编辑同一个项目.
## 在gitlab上提交issue
我们**自己部署的本地gitlab服务器**的地址是[gitlab](http://wwylss.synology.me:30000)(``wwylss.synology.me:30000``)
如果还未注册过, 请在上述界面中注册, 并联系管理员以通过注册.
一个较大的项目的协作者之间的工作联系通常**不是**通过微信、电话这种*追溯历史不太方便的方式*实现的. gitlab提供了一个比较有效的方式: 提交issue(问题/事件)
上图就是提交issue的按钮, 点击后选择``新建议题``, 会显示下面的界面
1. 用简略的文字描述issue
2. 详细描述issue的内容(可以使用markdown语法, 如果会markdown的话)
3. 按这个按钮可以添加附件(在提供一些文件例如metadata.txt等的时候十分有用)
4. **指派哪些人来跟进这个议题**, 一般有同备课组的负责人和管理员等
5. 前四项全填完之后, 点击``Create议题``以生成这个新的issue
之后就可以在这个issue中进行对话沟通, 完成后(或者完不成但是也不想留置)有权限的成员(提出者, 指派人, 管理员等)可以关闭议题.
## 收录新题
***对于需要合并到主题库的题目, 在收录之前请务必和管理员协商确定起始题号, 避免不同使用者的题号出现冲突***
***测试的时候请先拉取远程的tutorial分支, 在此基础上新建分支, 之后进行收录新题操作***
## 添加关联题
## 汇入metadata(各种数据与信息, 如答案, 解答, 备注, 使用记录, 标签等)
## 两种编辑题库中已有题目的方式
### $\LaTeX$方式(可编辑题目, 答案, 解答)
### json方式(可编辑任何信息)
## 从$\LaTeX$源文件中提取答案
## 题目和单元挂钩
### 生成"未挂钩单元题目"的LaTeX源文件、pdf文件与数据文件(临时文件/单元对应.txt)
### 根据数据文件(临时文件/单元对应.txt)生成metadata.txt
## 小闲平台使用数据导入
## 根据特定特征筛选题号
## 根据题号表达式(可含:或,的字符串)生成讲义
## 录入讲义结构与内容
### 讲义首字母的通用规则
- E: 正式测验卷与考试卷
- I: 非正式的小测验
- W: 周末卷
- G: 高一高二的学案
- J: 高三的复习讲义
- F: 高三的赋能卷
- V: 假期作业
### 录入新的讲义种类的结构(备课组之前未使用过的首字母)
### 录入新的讲义的题号ID等内容
## 对小闲平台的答题纸与数据库进行对应
***对应的目的是能更方便地收录使用信息***
## 系列讲义生成
## 添加基础知识梳理
***因可能有冲突, 故建议该项工作完全由管理员进行, 备课组负责人整理完成后在gitlab上提issue***