wahyd4.github.com/README.md

大染志博客源码（toozhao.com）

Hexo 6.3.0 + NexT 8.25 博客工程，部署在 GitHub Pages。

• master 分支 = 构建产物（纯静态 HTML），由 CI 自动更新，不要手动改
• hexo-source 分支 = 源码（本仓库默认分支），文章都写在这里
• 发布规则：push 到 hexo-source 即自动构建并上线（GitHub Actions，1-2 分钟）

✍️ 用 VSCode 写新博客

# 1. 第一次：拉取源码（含全部历史文章 + 主题配置）
git clone -b hexo-source https://github.com/wahyd4/wahyd4.github.com.git toozhao-blog
cd toozhao-blog
code .

# 2. 在 source/_posts/ 目录新建文件，如 hello-world.md：
---
title: "文章标题"
date: 2026-08-04 12:00:00
tags: [科技, 生活]
---
正文直接写 Markdown……支持代码块、表格、图片、引用。

# 3. 写完推送（不需要装 Node/Hexo，纯写 md 即可）
git add .
git commit -m "新文章：标题"
git push origin hexo-source

推送后等 1-2 分钟，访问 https://toozhao.com 即可看到新文章。

注意事项

• 图片：放到 source/images/ 下，md 里写 /images/文件名.jpg
• 日期格式：YYYY-MM-DD HH:MM:SS，决定文章归档位置和 URL
• 标签：tags: [a, b]，不写也可以
• URL 规则：/年份/月/日/文件名/（文件名即 URL 的一部分，尽量用英文/拼音）
• 每次 push 前先 git pull 一次，避免冲突

🗣️ 用 Discord 写新博客

在频道 @小黑：「写博客：标题 + 内容」→ 小黑生成 markdown 并提交，同样走 push 即上线流程。

🧰 常用命令（可选，本地调试用）

npm install          # 首次
npx hexo server -p 4000   # 本地预览 http://127.0.0.1:4000
npx hexo generate    # 手动构建到 public/
npx hexo new "标题"   # 生成新文章模板

📁 目录结构

source/
├── _posts/          # 全部文章（Markdown）
├── _data/
│   ├── head.njk     # 自定义 CSS（阅读排版/暗色模式）
│   └── body-end.njk # 自定义 JS（字号调节）
├── images/          # 图片资源
├── about/ gallery/ recommend/ my-career/   # 静态页面
└── tags/ categories/  # 标签/分类页
_config.yml          # 站点配置
_config.next.yml     # NexT 主题配置
tools/publish-post.sh # 小黑发布脚本
.github/workflows/deploy.yml  # CI：push 即构建部署

🔧 更新维护（小黑专用）

• 逆向提取工具：tools/extract_posts.py（HTML 产物 → markdown）
• 子路径预览构建：npx hexo generate --config _config.yml,_config.preview.yml
• 线上验证：gh api repos/wahyd4/wahyd4.github.com/pages/builds/latest（status=built）
• 详细坑位记录见 Hermes 技能 hexo-blog-pipeline