feat: hierarchical note sections mirroring Notion structure

Author: Kingpython123

…ic/files/cs336-assignment-1/train-bpe.py …ic/files/cs336/assignment-1/train-bpe.pypublic/files/cs336-assignment-1/train-bpe.py renamed to public/files/cs336/assignment-1/train-bpe.py public/files/cs336-assignment-1/train-bpe.py renamed to public/files/cs336/assignment-1/train-bpe.py

@@ -70,8 +70,13 @@ function yamlString(value) {
 
 const notes = keptNotes(exportDir);
 
-// 原始相对路径（去 id 后） -> slug，用于把 Notion 站内链接改写成本站链接
-const slugByCleanRel = new Map(Object.entries(mapping).map(([rel, cfg]) => [rel, cfg.slug]));
+// 原始相对路径（去 id 后） -> 本站笔记 id，用于把 Notion 站内链接改写成本站链接
+const noteIdByCleanRel = new Map(
+	Object.entries(mapping).map(([rel, cfg]) => [
+		rel,
+		cfg.section ? `${cfg.section}/${cfg.slug}` : cfg.slug,
+	]),
+);
 
 const summary = [];
 const problems = [];
@@ -90,6 +95,11 @@ for (const note of notes) {
 	}
 
 	const { slug, tags } = config;
+	const section = config.section?.trim() ?? '';
+	// 目录结构即层级：<section>/<slug>.md → /notes/<section>/<slug>/
+	// section 为空则是顶层笔记
+	const noteId = section ? `${section}/${slug}` : slug;
+	const outDir = section ? path.join(NOTES_DIR, section) : NOTES_DIR;
 	const title = config.title?.trim() || note.title;
 	const mdDir = path.dirname(note.abs);
 
@@ -114,7 +124,8 @@ for (const note of notes) {
 		}
 
 		const target = normalizeAssetName(path.basename(decoded));
-		copiedAssets.push({ source, target: path.join(NOTES_DIR, slug, target) });
+		// 图片放在 md 同级的 <slug>/ 子目录里，相对引用，Astro 才会接管处理
+		copiedAssets.push({ source, target: path.join(outDir, slug, target) });
 		return `![${alt}](./${slug}/${target})`;
 	});
 
@@ -127,8 +138,8 @@ for (const note of notes) {
 
 		if (decoded.toLowerCase().endsWith('.md')) {
 			const targetRel = stripNotionId(path.normalize(path.join(path.dirname(note.rel), decoded)));
-			const targetSlug = slugByCleanRel.get(targetRel);
-			if (targetSlug) return `[${text}](/notes/${targetSlug}/)`;
+			const targetId = noteIdByCleanRel.get(targetRel);
+			if (targetId) return `[${text}](/notes/${targetId}/)`;
 			return text; // 目标未发布，降级成纯文字
 		}
 
@@ -140,8 +151,8 @@ for (const note of notes) {
 		}
 
 		const target = normalizeAssetName(path.basename(decoded));
-		copiedAssets.push({ source, target: path.join(FILES_DIR, slug, target) });
-		return `[${text}](/files/${slug}/${target})`;
+		copiedAssets.push({ source, target: path.join(FILES_DIR, noteId, target) });
+		return `[${text}](/files/${noteId}/${target})`;
 	});
 
 	body = body.replace(/\n{3,}/g, '\n\n').trim();
@@ -159,21 +170,21 @@ for (const note of notes) {
 	].join('\n');
 
 	if (!dryRun) {
-		fs.mkdirSync(NOTES_DIR, { recursive: true });
-		fs.writeFileSync(path.join(NOTES_DIR, `${slug}.md`), `${frontmatter}${body}\n`, 'utf8');
+		fs.mkdirSync(outDir, { recursive: true });
+		fs.writeFileSync(path.join(outDir, `${slug}.md`), `${frontmatter}${body}\n`, 'utf8');
 
 		for (const asset of copiedAssets) {
 			fs.mkdirSync(path.dirname(asset.target), { recursive: true });
 			fs.copyFileSync(asset.source, asset.target);
 		}
 	}
 
-	summary.push({ slug, title, date: dateInfo.created, assets: copiedAssets.length });
+	summary.push({ id: noteId, title, date: dateInfo.created, assets: copiedAssets.length });
 }
 
 summary.sort((a, b) => a.date.localeCompare(b.date));
 for (const s of summary) {
-	console.log(`${s.date}  ${s.slug.padEnd(36)} ${String(s.assets).padStart(3)} 个资源  ${s.title}`);
+	console.log(`${s.date}  ${s.id.padEnd(44)} ${String(s.assets).padStart(3)} 个资源  ${s.title}`);
 }
 
 console.log(`\n${dryRun ? '[试运行] ' : ''}共 ${summary.length} 篇`);

scripts/notion-import.mjs

@@ -1,46 +1,48 @@
 {
   "_说明": [
-    "Notion 原路径 → 目标文件名（slug）、标题、标签 的映射表。",
-    "slug 决定最终 URL：/notes/<slug>/，必须是 ASCII kebab-case。",
+    "Notion 原路径 → 章节（section）、目标文件名（slug）、标题、标签 的映射表。",
+    "section 对应 Notion 里的父页面，决定目录结构和 URL：/notes/<section>/<slug>/。",
+    "section 留空表示顶层笔记，URL 为 /notes/<slug>/。",
+    "章节的中文显示名和排序在 src/lib/sections.ts 里定义。",
     "title 留空表示沿用 Notion 原标题；填了则覆盖（用于原标题过于笼统的情况）。",
     "这份表由人工审核，导入脚本只按表执行，不自己猜。"
   ],
 
   "notes": {
-    "deeplearning 2 limu\\预备知识.md": { "slug": "preliminaries", "title": "", "tags": ["深度学习", "李沐课程"] },
-    "deeplearning 2 limu\\线性神经网络.md": { "slug": "linear-neural-network", "title": "", "tags": ["深度学习", "李沐课程"] },
-    "deeplearning 2 limu\\softmax回归.md": { "slug": "softmax-regression", "title": "", "tags": ["深度学习", "李沐课程"] },
-    "deeplearning 2 limu\\感知机+激活函数.md": { "slug": "perceptron-and-activation", "title": "", "tags": ["深度学习", "李沐课程"] },
-    "deeplearning 2 limu\\模型选择+过拟合欠拟合+权重衰退.md": { "slug": "model-selection-and-regularization", "title": "", "tags": ["深度学习", "李沐课程"] },
-    "deeplearning 2 limu\\数值的稳定性+模型初始化和激活函数.md": { "slug": "numerical-stability-and-init", "title": "", "tags": ["深度学习", "李沐课程"] },
-    "deeplearning 2 limu\\dropout.md": { "slug": "dropout", "title": "Dropout", "tags": ["深度学习", "李沐课程"] },
-    "deeplearning 2 limu\\卷积神经网络.md": { "slug": "convolutional-neural-network", "title": "", "tags": ["深度学习", "李沐课程"] },
-    "deeplearning 2 limu\\CV.md": { "slug": "computer-vision", "title": "计算机视觉", "tags": ["深度学习", "李沐课程", "CV"] },
-    "deeplearning 2 limu\\数据集\\图像分类.md": { "slug": "image-classification-datasets", "title": "图像分类数据集", "tags": ["深度学习", "李沐课程"] },
-    "deeplearning 2 limu\\环境安装.md": { "slug": "dl-environment-setup", "title": "深度学习环境安装", "tags": ["深度学习", "工具"] },
+    "deeplearning 2 limu\\预备知识.md": { "section": "deep-learning", "slug": "preliminaries", "title": "", "tags": ["深度学习", "李沐课程"] },
+    "deeplearning 2 limu\\线性神经网络.md": { "section": "deep-learning", "slug": "linear-neural-network", "title": "", "tags": ["深度学习", "李沐课程"] },
+    "deeplearning 2 limu\\softmax回归.md": { "section": "deep-learning", "slug": "softmax-regression", "title": "", "tags": ["深度学习", "李沐课程"] },
+    "deeplearning 2 limu\\感知机+激活函数.md": { "section": "deep-learning", "slug": "perceptron-and-activation", "title": "", "tags": ["深度学习", "李沐课程"] },
+    "deeplearning 2 limu\\模型选择+过拟合欠拟合+权重衰退.md": { "section": "deep-learning", "slug": "model-selection-and-regularization", "title": "", "tags": ["深度学习", "李沐课程"] },
+    "deeplearning 2 limu\\数值的稳定性+模型初始化和激活函数.md": { "section": "deep-learning", "slug": "numerical-stability-and-init", "title": "", "tags": ["深度学习", "李沐课程"] },
+    "deeplearning 2 limu\\dropout.md": { "section": "deep-learning", "slug": "dropout", "title": "Dropout", "tags": ["深度学习", "李沐课程"] },
+    "deeplearning 2 limu\\卷积神经网络.md": { "section": "deep-learning", "slug": "convolutional-neural-network", "title": "", "tags": ["深度学习", "李沐课程"] },
+    "deeplearning 2 limu\\CV.md": { "section": "deep-learning", "slug": "computer-vision", "title": "计算机视觉", "tags": ["深度学习", "李沐课程", "CV"] },
+    "deeplearning 2 limu\\数据集\\图像分类.md": { "section": "deep-learning", "slug": "image-classification-datasets", "title": "图像分类数据集", "tags": ["深度学习", "李沐课程"] },
+    "deeplearning 2 limu\\环境安装.md": { "section": "deep-learning", "slug": "environment-setup", "title": "深度学习环境安装", "tags": ["深度学习", "工具"] },
 
-    "about paper\\how to read paper\\NLP-Transformer\\Transformer.md": { "slug": "transformer", "title": "Transformer", "tags": ["论文精读", "NLP"] },
-    "about paper\\how to read paper\\NLP-Transformer\\BERT.md": { "slug": "bert", "title": "BERT", "tags": ["论文精读", "NLP"] },
-    "about paper\\how to read paper\\CV-Transformer\\VIT.md": { "slug": "vit", "title": "ViT", "tags": ["论文精读", "CV"] },
-    "about paper\\how to read paper\\CV-Transformer\\MAE.md": { "slug": "mae", "title": "MAE", "tags": ["论文精读", "CV"] },
-    "about paper\\how to read paper\\CV-对比学习\\MOCO（没太看懂对比学习）.md": { "slug": "moco", "title": "", "tags": ["论文精读", "CV", "对比学习"] },
-    "about paper\\how to read paper\\CV-CNN\\ResNet论文精读.md": { "slug": "resnet", "title": "ResNet 论文精读", "tags": ["论文精读", "CV"] },
-    "ai infra\\Scaling Laws for Neural Language Models.md": { "slug": "scaling-laws", "title": "", "tags": ["论文精读", "AI Infra"] },
-    "about paper\\how to read paper.md": { "slug": "how-to-read-paper", "title": "如何读论文", "tags": ["方法论"] },
-    "about paper\\邪修.md": { "slug": "research-shortcuts", "title": "", "tags": ["方法论"] },
-    "about paper\\科研工具合集.md": { "slug": "research-tools", "title": "", "tags": ["工具"] },
+    "about paper\\how to read paper.md": { "section": "paper-reading", "slug": "how-to-read-paper", "title": "如何读论文", "tags": ["方法论"] },
+    "about paper\\邪修.md": { "section": "paper-reading", "slug": "research-shortcuts", "title": "", "tags": ["方法论"] },
+    "about paper\\科研工具合集.md": { "section": "paper-reading", "slug": "research-tools", "title": "", "tags": ["工具"] },
+    "about paper\\how to read paper\\NLP-Transformer\\Transformer.md": { "section": "paper-reading", "slug": "transformer", "title": "Transformer", "tags": ["论文精读", "NLP"] },
+    "about paper\\how to read paper\\NLP-Transformer\\BERT.md": { "section": "paper-reading", "slug": "bert", "title": "BERT", "tags": ["论文精读", "NLP"] },
+    "about paper\\how to read paper\\CV-Transformer\\VIT.md": { "section": "paper-reading", "slug": "vit", "title": "ViT", "tags": ["论文精读", "CV"] },
+    "about paper\\how to read paper\\CV-Transformer\\MAE.md": { "section": "paper-reading", "slug": "mae", "title": "MAE", "tags": ["论文精读", "CV"] },
+    "about paper\\how to read paper\\CV-对比学习\\MOCO（没太看懂对比学习）.md": { "section": "paper-reading", "slug": "moco", "title": "", "tags": ["论文精读", "CV", "对比学习"] },
+    "about paper\\how to read paper\\CV-CNN\\ResNet论文精读.md": { "section": "paper-reading", "slug": "resnet", "title": "ResNet 论文精读", "tags": ["论文精读", "CV"] },
 
-    "CS336\\assignment-1.md": { "slug": "cs336-assignment-1", "title": "CS336 Assignment 1", "tags": ["CS336"] },
-    "CS336\\git.md": { "slug": "git-basics", "title": "Git 常用操作", "tags": ["工具"] },
-    "CS336\\python\\uv.md": { "slug": "uv", "title": "uv 包管理器", "tags": ["工具", "Python"] },
-    "CS336\\python\\基础.md": { "slug": "python-basics", "title": "Python 基础", "tags": ["Python", "CS336"] },
+    "CS336\\assignment-1.md": { "section": "cs336", "slug": "assignment-1", "title": "Assignment 1", "tags": ["CS336"] },
+    "CS336\\git.md": { "section": "cs336", "slug": "git", "title": "Git 常用操作", "tags": ["工具"] },
+    "CS336\\python\\uv.md": { "section": "cs336", "slug": "uv", "title": "uv 包管理器", "tags": ["工具", "Python"] },
+    "CS336\\python\\基础.md": { "section": "cs336", "slug": "python-basics", "title": "Python 基础", "tags": ["Python", "CS336"] },
 
-    "kaggle\\autonomous-agent-prediction-beta.md": { "slug": "autonomous-agent-prediction", "title": "Autonomous Agent Prediction", "tags": ["Kaggle"] },
-    "kaggle\\autonomous-agent-prediction-beta\\环境准备.md": { "slug": "kaggle-env-setup", "title": "Kaggle 环境准备", "tags": ["Kaggle", "工具"] },
+    "kaggle\\autonomous-agent-prediction-beta.md": { "section": "kaggle", "slug": "autonomous-agent-prediction", "title": "Autonomous Agent Prediction", "tags": ["Kaggle"] },
+    "kaggle\\autonomous-agent-prediction-beta\\环境准备.md": { "section": "kaggle", "slug": "environment-setup", "title": "比赛环境准备", "tags": ["Kaggle", "工具"] },
 
-    "ai infra.md": { "slug": "ai-infra", "title": "AI Infra", "tags": ["AI Infra"] },
-    "ai infra\\aicluster.md": { "slug": "ai-cluster", "title": "AI Cluster", "tags": ["AI Infra"] },
+    "ai infra.md": { "section": "ai-infra", "slug": "overview", "title": "AI Infra 概览", "tags": ["AI Infra"] },
+    "ai infra\\aicluster.md": { "section": "ai-infra", "slug": "ai-cluster", "title": "AI Cluster", "tags": ["AI Infra"] },
+    "ai infra\\Scaling Laws for Neural Language Models.md": { "section": "ai-infra", "slug": "scaling-laws", "title": "", "tags": ["论文精读", "AI Infra"] },
 
-    "各种问题汇总.md": { "slug": "troubleshooting", "title": "", "tags": ["踩坑"] }
+    "各种问题汇总.md": { "section": "", "slug": "troubleshooting", "title": "", "tags": ["踩坑"] }
   }
 }

scripts/notion-mapping.json

@@ -0,0 +1,33 @@
+---
+import type { Note } from '../lib/posts';
+import FormattedDate from './FormattedDate.astro';
+
+interface Props {
+	notes: Note[];
+	/** 是否显示每篇的 description 摘要 */
+	showDescription?: boolean;
+}
+
+const { notes, showDescription = true } = Astro.props;
+---
+
+<ul>
+	{
+		notes.map((note) => (
+			<li class="border-b border-rule py-3">
+				<div class="flex flex-wrap items-baseline justify-between gap-x-6">
+					<a href={`/notes/${note.id}/`} class="no-underline hover:underline">
+						{note.data.title}
+						{note.data.draft && <span class="ml-2 text-sm text-muted">[草稿]</span>}
+					</a>
+					<span class="text-sm text-muted tabular-nums">
+						<FormattedDate date={note.data.date} />
+					</span>
+				</div>
+				{showDescription && note.data.description && (
+					<p class="mt-1 text-sm text-muted">{note.data.description}</p>
+				)}
+			</li>
+		))
+	}
+</ul>