Learning Notes Blog

一个用于长期存放个人学习笔记、论文阅读、实验复盘和研究专题的 GitHub Pages 静态博客模板。

本地使用

npm install
npm run dev

默认本地地址是 http://localhost:8080。

内容结构

• src/index.njk：博客首页。
• src/notes.njk：学习笔记归档页。
• src/topics.njk：专题框架页。
• src/about.njk：关于页。
• src/notes/*.md：正式发布的学习笔记，每篇一个 Markdown 文件。
• templates/learning-note-template.md：普通学习笔记模板，不会被站点渲染。
• templates/paper-reading-template.md：论文阅读笔记模板，不会被站点渲染。
• src/maps/embodied-navigation-datasets.njk：预留的研究地图页面，后续需要时再填充。
• src/assets/css/styles.css：页面样式。

新增一篇学习笔记

复制模板到 src/notes/，改文件名、标题、日期和 permalink：

cp templates/learning-note-template.md src/notes/2026-06-24-my-note.md

笔记文件的基本格式：

---layout: layouts/post.njktitle: "学习笔记标题"date: 2026-06-24tags:
- 学习
- 主题标签permalink: /notes/my-note/---## 背景
这里开始写正文。

本地构建

npm run build

构建产物在 _site/。

发布到 GitHub Pages

1. 在 GitHub 新建仓库。个人主页仓库建议命名为 你的GitHub用户名.github.io；普通项目仓库也可以，部署脚本会自动处理路径前缀。
2. 把本目录提交并推送到仓库的 main 分支。
3. 在仓库 Settings → Pages 中选择 GitHub Actions。
4. 推送后等待 Actions 完成，站点会发布到 GitHub Pages。

后续从 Zotero 填充研究地图

如果之后想把 Zotero 中的论文写入研究地图，准备好导入报告后运行：

npm run import:zotero-report
npm run build