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
|
use std::collections::BTreeMap;
use std::path::Path;
const PAGES_ROOT: &str = "./docs/pages";
const SIDEBAR_PATH: &str = "./docs/_sidebar.md";
const SIDEBAR_HEAD: &str = "- [Welcome!](README)\n";
fn main() {
println!("Refreshing _sidebar.md");
gen_sidebar();
}
fn gen_sidebar() {
let repo_root = find_git_repo().unwrap();
let pages_root = repo_root.join(PAGES_ROOT);
let mut lines = String::from(SIDEBAR_HEAD);
// Collect and sort entries at root level first
let mut root_files: Vec<SidebarEntry> = Vec::new();
// Subdirectory name -> its files
let mut sub_dirs: BTreeMap<String, Vec<SidebarEntry>> = BTreeMap::new();
if let Ok(read_dir) = std::fs::read_dir(&pages_root) {
for entry in read_dir.flatten() {
let path = entry.path();
if path.is_dir() {
let dir_name = entry.file_name().to_string_lossy().to_string();
let entries = collect_markdown_files(&path);
if !entries.is_empty() {
sub_dirs.insert(dir_name, entries);
}
} else if path.extension().map_or(false, |ext| ext == "md") {
let title = extract_title(&path);
let relative = path
.strip_prefix(&repo_root.join("docs"))
.unwrap()
.to_string_lossy()
.replace('\\', "/");
let link = relative
.strip_suffix(".md")
.unwrap_or(&relative)
.to_string();
root_files.push(SidebarEntry { title, link });
}
}
}
// Sort root files by link for stable order
root_files.sort_by(|a, b| a.link.cmp(&b.link));
// Append root-level files
for f in &root_files {
lines.push_str(&format!("* [{}]({})\n", f.title, f.link));
}
// Append subdirectory groups
for (dir_name, entries) in &sub_dirs {
let mut sorted_entries = entries.clone();
sorted_entries.sort_by(|a, b| a.link.cmp(&b.link));
// Directory header with 2-space indent
lines.push_str(&format!("* {}\n", dir_name));
for f in &sorted_entries {
lines.push_str(&format!(" * [{}]({})\n", f.title, f.link));
}
}
let sidebar_path = repo_root.join(SIDEBAR_PATH);
std::fs::write(&sidebar_path, lines).unwrap();
println!(" Generated: {}", sidebar_path.display());
}
#[derive(Clone)]
struct SidebarEntry {
title: String,
link: String,
}
/// Collect all `.md` files directly under `dir` (non-recursive).
fn collect_markdown_files(dir: &Path) -> Vec<SidebarEntry> {
let mut entries = Vec::new();
let repo_root = find_git_repo().unwrap();
let docs_root = repo_root.join("docs");
if let Ok(read_dir) = std::fs::read_dir(dir) {
for entry in read_dir.flatten() {
let path = entry.path();
if path.extension().map_or(false, |ext| ext == "md") {
let title = extract_title(&path);
let relative = path
.strip_prefix(&docs_root)
.unwrap()
.to_string_lossy()
.replace('\\', "/");
let link = relative
.strip_suffix(".md")
.unwrap_or(&relative)
.to_string();
entries.push(SidebarEntry { title, link });
}
}
}
entries
}
/// Extract title from the first line `<h1 align="center">TITLE</h1>`.
/// Fallback to filename stem.
fn extract_title(path: &Path) -> String {
let content = std::fs::read_to_string(path).unwrap_or_default();
if let Some(first_line) = content.lines().next() {
let trimmed = first_line.trim();
// Find `>TITLE<` between `<h1 align="center">` and `</h1>`
if let Some(start) = trimmed.find('>') {
let after_start = &trimmed[start + 1..];
if let Some(end) = after_start.find('<') {
return after_start[..end].to_string();
}
}
}
// Fallback: use file stem
path.file_stem()
.map(|s| s.to_string_lossy().to_string())
.unwrap_or_else(|| "Untitled".to_string())
}
fn find_git_repo() -> Option<std::path::PathBuf> {
let mut current_dir = std::env::current_dir().ok()?;
loop {
let git_dir = current_dir.join(".git");
if git_dir.exists() && git_dir.is_dir() {
return Some(current_dir);
}
if !current_dir.pop() {
break;
}
}
None
}
|
