初始化

.gitignore

+.vscode
+.idea
+.DS_Store
+__pycache__
+*.pyc
+*.zip
+*.out
+bin/
+debug/
+release/
\ No newline at end of file

README.md

 # skill_tree_scala
 
-Scala 技能树
+`Scala技能树`是[技能森林](https://gitcode.net/csdn/skill_tree)的一部分。
\ No newline at end of file
+
+## 编辑环境初始化
+
+```
+pip install -r requirements.txt
+```
+
+## 目录结构说明
+技能树编辑仓库的 data 目录是主要的编辑目录，目录的结构是固定的
+
+* 技能树`骨架文件`：
+    * 位置：`data/tree.json`
+    * 说明：该文件是执行 `python main.py` 生成的，请勿人工编辑
+* 技能树`根节点`配置文件：
+    * 位置：`data/config.json`
+    * 说明：可编辑配置关键词等字段，其中 `node_id` 字段是生成的，请勿编辑
+* 技能树`难度节点`：
+    * 位置：`data/xxx`，例如: `data/1.Scala初阶`
+    * 说明：
+        * 每个技能树有 3 个等级，目录前的序号是必要的，用来保持文件夹目录的顺序
+        * 每个目录下有一个 `config.json` 可配置关键词信息，其中 `node_id` 字段是生成的，请勿编辑
+* 技能树`章节点`：
+    * 位置：`data/xxx/xxx`，例如：`data/1.Scala初阶/1.Scala简介`
+    * 说明：
+        * 每个技能树的每个难度等级有 n 个章节，目录前的序号是必要的，用来保持文件夹目录的顺序
+        * 每个目录下有一个 `config.json` 可配置关键词信息，其中 `node_id` 字段是生成的，请勿编辑
+* 技能树`知识节点`：
+    * 位置：`data/xxx/xxx`，例如：`data/1.Scala初阶/1.Scala简介`
+    * 说明：
+        * 每个技能树的每章有 n 个知识节点，目录前的序号是必要的，用来保持文件夹目录的顺序
+        * 每个目录下有一个 `config.json`
+            * 其中 `node_id` 字段是生成的，请勿编辑
+            * 其中 `keywords` 可配置关键字字段
+            * 其中 `children` 可配置该`知识节点`下的子树结构信息，参考后面描述
+            * 其中 `export` 可配置该`知识节点`下的导出习题信息，参考后面描述
+
+## `知识节点` 子树信息结构
+
+例如 `data/1.Scala初阶/1.Scala简介/1.HelloWorld/config.json` 里配置对该知识节点子树信息结构，这个配置是可选的：
+```json
+{
+    // ...
+
+    "children": [
+    {
+        "XX开发入门": {
+          "keywords": [
+            "XX开发",
+          ],
+          "children": [],
+          "keywords_must": [
+            "XX"
+          ],
+          "keywords_forbid": []
+        }
+    }
+  ],
+}
+```
+
+## `知识节点` 的导出习题编辑
+
+例如 `data/1.Scala初阶/1.Scala简介/1.HelloWorld/config.json` 里配置对该知识节点导出的习题
+
+```json
+{
+    // ...
+    "export": [
+        "helloworld.json"
+    ]
+}
+```
+
+helloworld.json 的格式如下：
+```bash
+{
+  "type": "code_options",
+  "author": "xxx",
+  "source": "helloworld.md",
+  "notebook_enable": false,
+  "exercise_id": "xxx"
+}
+```
+
+其中 
+* "type": "code_options" 表示是一个选择题
+* "author" 可以放作者的 CSDN id，
+* "source" 指向了习题 MarkDown文件
+* "notebook_enable" 目前都是false
+* "exercise_id" 是工具生成的，不填
+
+
+习题格式模版如下：
+
+````mardown
+# {标题}
+
+{习题描述}
+
+以下关于上述游戏代码说法[正确/错误]的是？
+
+## 答案
+
+{目标选项}
+
+## 选项
+
+### A
+
+{混淆选项1}
+
+### B
+
+{混淆选项2}
+
+### C
+
+{混淆选项3}
+
+````
+
+## 技能树合成
+
+在根目录下执行 `python main.py` 会合成技能树文件，合成的技能树文件: `data/tree.json`
+* 合成过程中，会自动检查每个目录下 `config.json` 里的 `node_id` 是否存在，不存在则生成
+* 合成过程中，会自动检查每个知识点目录下 `config.json` 里的 `export` 里导出的习题配置，检查是否存在`exercise_id` 字段，如果不存在则生成
+* 在 节 目录下根据需要，可以添加一些子目录用来测试代码。
+* 开始游戏入门技能树构建之旅，GoodLuck! 
\ No newline at end of file

data/1.Scala初阶/1.Scala入门/1.HelloWorld/config.json

+{
+  "node_id": "scala-516119dd8bba44ceba1611cf5d1defd3",
+  "keywords": [],
+  "children": [],
+  "export": [
+    "helloworld.json"
+  ],
+  "keywords_must": [],
+  "keywords_forbid": []
+}
\ No newline at end of file

data/1.Scala初阶/1.Scala入门/1.HelloWorld/helloworld.json

+{
+  "type": "code_options",
+  "author": null,
+  "source": "helloworld.md",
+  "notebook_enable": false,
+  "exercise_id": "072932e67956477c8d79af7461c0e7cb"
+}
\ No newline at end of file

data/1.Scala初阶/1.Scala入门/1.HelloWorld/helloworld.md

+# {在此填写标题}
+
+{在此填写题目描述}
+
+## 答案
+
+{在此填写答案}
+
+## 选项
+
+### A
+
+{在此填写选项A}
+
+### B
+
+{在此填写选项B}
+
+### C
+
+{在此填写选项C}

data/1.Scala初阶/1.Scala入门/config.json

+{
+  "node_id": "scala-9419db4dfc424fa1bf5ba0ea75c0d577",
+  "keywords": [],
+  "keywords_must": [],
+  "keywords_forbid": []
+}
\ No newline at end of file

data/1.Scala初阶/config.json

+{
+  "node_id": "scala-dd47fbf8bdd8423dae0dde90df085297",
+  "keywords": [],
+  "keywords_must": [],
+  "keywords_forbid": []
+}
\ No newline at end of file

data/2.Scala中阶/config.json

+{
+  "node_id": "scala-4a40203fae57490385df4e00c6d8b97f",
+  "keywords": [],
+  "keywords_must": [],
+  "keywords_forbid": []
+}
\ No newline at end of file

data/3.Scala高阶/config.json

+{
+  "node_id": "scala-fee5b174d91e4772a2756838a008c0e4",
+  "keywords": [],
+  "keywords_must": [],
+  "keywords_forbid": []
+}
\ No newline at end of file

data/config.json

+{
+  "tree_name": "scala",
+  "keywords": [],
+  "node_id": "scala-11704d529cf246cda33668aed3dc38c2",
+  "keywords_must": [],
+  "keywords_forbid": []
+}
\ No newline at end of file

data/tree.json

+{
+  "scala": {
+    "node_id": "scala-11704d529cf246cda33668aed3dc38c2",
+    "keywords": [],
+    "children": [
+      {
+        "Scala初阶": {
+          "node_id": "scala-dd47fbf8bdd8423dae0dde90df085297",
+          "keywords": [],
+          "children": [
+            {
+              "Scala入门": {
+                "node_id": "scala-9419db4dfc424fa1bf5ba0ea75c0d577",
+                "keywords": [],
+                "children": [
+                  {
+                    "HelloWorld": {
+                      "node_id": "scala-516119dd8bba44ceba1611cf5d1defd3",
+                      "keywords": [],
+                      "children": [],
+                      "keywords_must": [],
+                      "keywords_forbid": []
+                    }
+                  }
+                ],
+                "keywords_must": [],
+                "keywords_forbid": []
+              }
+            }
+          ],
+          "keywords_must": [],
+          "keywords_forbid": []
+        }
+      },
+      {
+        "Scala中阶": {
+          "node_id": "scala-4a40203fae57490385df4e00c6d8b97f",
+          "keywords": [],
+          "children": [],
+          "keywords_must": [],
+          "keywords_forbid": []
+        }
+      },
+      {
+        "Scala高阶": {
+          "node_id": "scala-fee5b174d91e4772a2756838a008c0e4",
+          "keywords": [],
+          "children": [],
+          "keywords_must": [],
+          "keywords_forbid": []
+        }
+      }
+    ],
+    "keywords_must": [],
+    "keywords_forbid": []
+  }
+}
\ No newline at end of file

main.py

+from skill_tree.tree import TreeWalker
+
+if __name__ == '__main__':
+    walker = TreeWalker("data", "scala", "Scala", ignore_keywords=True)
+    walker.init()

requirements.txt

+.pre_commit
+skill-tree-parser
\ No newline at end of file