# skill_tree_web ## 初始化 ``` pip install -r requirement.txt ``` ## 目录结构说明 * 技能树`骨架文件`: * 位置:`data/tree.json` * 说明:该文件是执行 `python main.py` 生成的,请勿人工编辑 * 技能树`根节点`配置文件: * 位置:`data/config.json` * 说明:可编辑配置关键词等字段,其中 `node_id` 字段是生成的,请勿编辑 * 技能树`难度节点`: * 位置:`data/xxx`,例如: `data/1.web初阶` * 说明: * 每个技能树有 3 个等级,目录前的序号是必要的,用来保持文件夹目录的顺序 * 每个目录下有一个 `config.json` 可配置关键词信息,其中 `node_id` 字段是生成的,请勿编辑 * 技能树`章节点`: * 位置:`data/xxx/xxx`,例如:`data/1.web初阶/1.前端基础` * 说明: * 每个技能树的每个难度等级有 n 个章节,目录前的序号是必要的,用来保持文件夹目录的顺序 * 每个目录下有一个 `config.json` 可配置关键词信息,其中 `node_id` 字段是生成的,请勿编辑 * 技能树`知识节点`: * 位置:`data/xxx/xxx/xxx`,例如:`data/1.web初阶/1.前端基础/1.客户端` * 说明: * 每个技能树的每章有 `n` 个知识节点,目录前的序号是必要的,用来保持文件夹目录的顺序 * 每个目录下有一个 `config.json` * 其中 `node_id` 字段是生成的,请勿编辑 * 其中 `keywords` 可配置关键字字段 * 其中 `children` 可配置该`知识节点`下的子树结构信息,参考后面描述 * 其中 `export` 可配置该`知识节点`下的导出习题信息,参考后面描述 ## `知识节点` 子树信息结构 例如 `data/1.web初阶/1.前端基础/1.客户端/config.json` 里配置对该知识节点子树信息结构: ```json { // ... "children": [ // TODO ... ], } ``` ## `知识节点` 的导出习题编辑 例如 `data/1.web初阶/1.前端基础/1.客户端/config.json` 里配置对该知识节点导出的习题 ```json { // ... "export": [ // TODO ... ] } ``` 格式说明: * `file`: 指定该目录下的习题源文件 * `variants`: 指定习题同名的json选项配置文件,参考下一节 * `depends`: 如果习题依赖同目录下的其他习题源代码,则在此字段里配置依赖的其他习题源文件名 ## `知识节点` 的导出习题选项配置编辑 首先,在知识节点下增加一个习题代码,例如在 `data/1.web初阶/1.前端基础/1.客户端` 下增加一个`HelloWorld.html`代码: ```web
这是一个测试段落。
``` 其次,增加一个同名的选项配置文件`HelloWorld.json`,目前有三种配置规则 **单行替换规则**: * 配置由`one_line`字段指定的单行替换字典 * 格式是:`"<源字符串>"`: [`"<替换字符串A>"`, `<替换字符串B>`,...], * 其中每个 `"<源字符串>"` `/` `"<替换字符串A>"` 被生成为是一个替换选项 * 指定的配置应该能至少生成 `3+` 个替换选项 ```json { "one_line": { "document.write": ["document.print", "document.out", "document.printf"] } } ``` 上面的替换规则会将代码替换成 3 个变种的代码: ```html // 变种代码1这是一个测试段落。
``` ```html // 变种代码2这是一个测试段落。
``` ```html // 变种代码3这是一个测试段落。
``` 这些变种代码将会作为技能树该知识点该代码选择题的选项。 **多行替换规则**: * 配置由`multiline`字段指定的多行替换数组 * 数组的每个元素是一组替换规则,会整组被替换 例如: ```json { "mulitiline": [{ "