“小胖笔记”的网站代码与 Markdown 内容。网站使用 Next.js 静态导出,并通过 GitHub Actions 发布到 GitHub Pages。
首次使用需要安装 Node.js 22 或更高版本,然后在项目根目录运行:
./scripts/dev.sh脚本会自动选择 pnpm、corepack 或 npm,并在首次运行时安装依赖。
启动后访问:
修改 Markdown、配置文件或图片后,开发服务器会自动更新页面。按 Control + C 停止服务。
发布前可以生成并检查最终静态网站:
./scripts/publish.sh
./scripts/preview.sh预览地址为 http://localhost:3001。生成的静态网站位于 out/,无需手工修改其中的文件。
确认本地预览无误后运行:
git status
git add .
git commit -m "更新网站内容"
git push推送到 main 分支后,GitHub Actions 会自动构建并发布网站。可在仓库的 Actions 页面查看部署状态。
线上地址:https://gentang.github.io/
日常内容都在 content/ 目录中。
- 中文博客:
content/zh/blog/ - 英文博客:
content/en/blog/
每篇博客使用一个 Markdown 文件。
已发布的博客在文件顶部维护日期,统一使用 YYYY-MM-DD:
---
published: 2026-08-12
updated: 2026-08-12
---首次发布后保留 published 不变;正文有实质修改时再更新 updated。草稿可以暂不填写日期。
- 中文书稿:
content/zh/books/deconstructing_LLM/ - 英文书稿:
content/en/books/deconstructing_LLM/ - 全书总览:书籍目录下的
overview.md - 书名、简介、章节信息和外部链接:书籍目录下的
book.json - 章节总览:
chapter_N/overview.md - 章节小节:
chapter_N/N_M.md - 章节图片:
chapter_N/images/
全书的发布日期、完成日期和最近修订日期维护在 book.json 的 dates 中。每章的 published、updated 维护在该章 overview.md 顶部,小节默认继承本章日期;只有某个小节单独修订时,才在该小节 Markdown 顶部用相同格式覆盖日期。
发布日期会自动用于页面显示、SEO、sitemap.xml、RSS 和 Atom;不要直接修改生成的 .generated/ 或 out/ 文件。
新增章节或小节后,网站会根据目录和 Markdown 文件自动更新书籍导航。
- 中文首页:
content/zh/site.json - 英文首页:
content/en/site.json - 中文作者介绍:
content/zh/about.md - 英文作者介绍:
content/en/about.md