这个站点采用 Hexo + Stellar + GitHub Pages。文章以 Markdown 保存,页面由 Hexo 构建,发布交给 GitHub Actions。
组成
| 组件 | 用途 |
|---|---|
| Hexo | 将文章、分类与标签生成静态页面 |
| Stellar | 提供导航、文章卡片、目录和明暗模式 |
| GitHub Actions | 在推送后构建、发布站点 |
| GitHub Pages | 托管生成后的 HTML、CSS 和 JavaScript |
本地写作
项目目录为 leng125172-code.github.io,需要 Node.js 22 或更高版本。
1 | |
文章保存在 source/_posts/。文件顶部的 Front Matter 用来配置标题、日期、分类与标签:
1 | |
本地预览默认地址为 http://localhost:4000。
发布
1 | |
推送到 main 后,Actions 使用锁文件安装依赖、构建 public/ 目录,再部署到 GitHub Pages。构建失败时保留上一次成功发布的站点,可以到仓库的 Actions 页面查看日志。
public/ 是构建产物,不需要手动提交。
维护入口
_config.yml:站点标题、域名、语言和文章路径。_config.stellar.yml:主题、导航、侧栏和搜索。source/_posts/:文章。source/about/、source/projects/:独立页面。.github/workflows/pages.yml:自动发布流程。