1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157 | #!/usr/bin/env python3
"""
自动构建文章页面：
- 扫描 posts/ 目录，找到所有包含 page.md 和 info.json 的文章/项目目录
- 将 page.md 转为 HTML，用 build/head.html + <article> + build/end.html 包裹
- 复制文章目录下的其他文件到 pages/ 对应位置
- 生成全局文章列表 pages/list.json
- 为 posts/docs/ 下的每个项目生成独立的 pages/docs/项目X/list.json
- 若项目目录本身包含 page.md 和 info.json，作为项目首页，在全局列表中标记 type: "project"
"""
import json
import os
import shutil
from collections import defaultdict
from datetime import datetime
from pathlib import Path
import markdown
# 路径配置（相对于仓库根目录）
POSTS_DIR = Path("posts")
OUTPUT_DIR = Path("pages") # 所有页面输出到此
HEAD_PATH = Path("build/head.html")
END_PATH = Path("build/end.html")
DOCS_LIST_DIR = OUTPUT_DIR / "docs" # 项目列表的根目录，即 pages/docs
# 读取模板
head_html = HEAD_PATH.read_text(encoding="utf-8")
end_html = END_PATH.read_text(encoding="utf-8")
# Markdown 转换器
md = markdown.Markdown()
# 收集所有文章信息
all_articles = [] # 元素: (article_dict, last_modified)
# 按项目分组的文章，key = 项目名，仅包含具体文章（不含项目首页）
project_articles = defaultdict(list) # value: [(article_dict, last_modified), ...]
def calculate_reading_time(md_text: str) -> int:
"""简单按字符数估算阅读时长（分钟），最低 1 分钟"""
chars = sum(1 for c in md_text if c.isalnum() or ord(c) > 127)
return max(1, round(chars / 500))
def process_article(article_dir: Path):
"""处理单个文章/项目首页目录"""
info_file = article_dir / "info.json"
page_file = article_dir / "page.md"
# 读取元数据
with info_file.open("r", encoding="utf-8") as f:
info = json.load(f)
# 确定最后修改时间
last_modified = info.get("updated") or info["date"]
# 计算阅读时间（如果未提供）
if "reading_time" not in info:
md_content = page_file.read_text(encoding="utf-8")
info["reading_time"] = calculate_reading_time(md_content)
else:
md_content = page_file.read_text(encoding="utf-8")
# Markdown → HTML
body_html = md.convert(md_content)
full_html = f"{head_html}<article>{body_html}</article>{end_html}"
# 计算相对于 posts/ 的路径
relative_path = article_dir.relative_to(POSTS_DIR) # 例如 "posts/技术/文章名" 或 "docs/项目X/大类/文章" 或 "docs/项目X"
dest_dir = OUTPUT_DIR / relative_path
dest_dir.mkdir(parents=True, exist_ok=True)
# 写入 index.html
(dest_dir / "index.html").write_text(full_html, encoding="utf-8")
# 复制其他文件
for item in article_dir.iterdir():
if item.name in ("page.md", "info.json"):
continue
if item.is_file():
shutil.copy2(item, dest_dir / item.name)
elif item.is_dir():
target = dest_dir / item.name
if target.exists():
shutil.rmtree(target)
shutil.copytree(item, target)
# 构建文章条目，添加网页路径
article_entry = {
**info,
"path": f"/pages/{relative_path.as_posix()}/"
}
# 判断是否为项目首页（即 docs/项目X 本身，只有两级）
parts = relative_path.parts
is_project_home = len(parts) == 2 and parts[0] == "docs"
if is_project_home:
# 项目首页，标记类型
article_entry["type"] = "project"
# 只加入全局列表，不加入项目文章分组
all_articles.append((article_entry, last_modified))
else:
# 普通文章，加入全局列表
all_articles.append((article_entry, last_modified))
# 如果属于 docs 下的某个项目，加入对应的项目分组
if len(parts) >= 3 and parts[0] == "docs":
project_name = parts[1] # docs/项目X
project_articles[project_name].append((article_entry, last_modified))
def main():
# 清空旧的输出目录（pages 完全由脚本生成）
if OUTPUT_DIR.exists():
shutil.rmtree(OUTPUT_DIR)
OUTPUT_DIR.mkdir(parents=True, exist_ok=True)
# 递归扫描 posts 目录
for root, dirs, files in os.walk(POSTS_DIR):
root_path = Path(root)
if "page.md" in files and "info.json" in files:
process_article(root_path)
dirs.clear() # 文章目录下不再深入
# 按最后修改时间降序排序
sort_key = lambda item: datetime.fromisoformat(item[1].replace("Z", "+00:00"))
all_articles.sort(key=sort_key, reverse=True)
for proj in project_articles:
project_articles[proj].sort(key=sort_key, reverse=True)
# 生成全局列表
global_list = [entry for entry, _ in all_articles]
(OUTPUT_DIR / "list.json").write_text(
json.dumps(global_list, ensure_ascii=False, indent=2),
encoding="utf-8"
)
# 生成各项目文章列表（不含项目首页）
DOCS_LIST_DIR.mkdir(parents=True, exist_ok=True) # 其实就是 pages/docs
for proj_name, articles in project_articles.items():
proj_list = [entry for entry, _ in articles]
list_dir = DOCS_LIST_DIR / proj_name
list_dir.mkdir(parents=True, exist_ok=True)
(list_dir / "list.json").write_text(
json.dumps(proj_list, ensure_ascii=False, indent=2),
encoding="utf-8"
)
print(f"构建完成！总文章/页面数：{len(global_list)}")
for proj_name, articles in project_articles.items():
print(f" - 项目 '{proj_name}'：{len(articles)} 篇文章")
if __name__ == "__main__":
main()
|