为什么需要转换？

因为本站的大纲是自己定义的格式。

而现在流行的文档例如mailliao 的python文档就是用mkdocs写的。那么如何转换呢？求助了AI编程，竟然简单搞定了。

看代码

python

# -*- coding: utf-8 -*-
import yaml
import json

import sys
filename = sys.argv[1]
print(filename)
# 你提供的 pages 配置
data = open(filename).read() 

parsed = yaml.safe_load(data)

pages = parsed["pages"]

result = []
id_counter = 1
current_folder = None

for item in pages:
    # 每一项是 {title: filename}
    for title, filename in item.items():
        # 检查是不是“部分”标题
        if "部分" in title:
            folder = {
                "id": id_counter,
                "title": title,
                "type": "folder",
                "expanded": True,
                "children": []
            }
            result.append(folder)
            current_folder = folder
            id_counter += 1
        else:
            node = {
                "id": id_counter,
                "title": title,
                "type": "chapter"
            }
            if current_folder:
                current_folder["children"].append(node)
            else:
                result.append(node)
            id_counter += 1

# 输出 JSON
print(json.dumps(result, ensure_ascii=False, indent=2))

转换后，再编辑书的页面粘贴

查看效果

可以说效果很好。细节可以自己再修修。

如何将mkdocs的大纲 转换成本站的大纲？

如何将mkdocs的大纲转换成本站的大纲？