mirror of
https://github.com/wahyd4/wahyd4.github.com.git
synced 2026-08-09 13:26:14 +10:00
81 lines
2.8 KiB
Markdown
81 lines
2.8 KiB
Markdown
# 大染志博客源码（toozhao.com）
|
||
|
||
Hexo 6.3.0 + NexT 8.25 博客工程，部署在 GitHub Pages。
|
||
|
||
- **`master` 分支** = 构建产物（纯静态 HTML），由 CI 自动更新，**不要手动改**
|
||
- **`hexo-source` 分支** = 源码（本仓库默认分支），文章都写在这里
|
||
- 发布规则：**push 到 hexo-source 即自动构建并上线**（GitHub Actions，1-2 分钟）
|
||
|
||
## ✍️ 用 VSCode 写新博客
|
||
|
||
```bash
|
||
# 1. 第一次：拉取源码（含全部历史文章 + 主题配置）
|
||
git clone -b hexo-source https://github.com/wahyd4/wahyd4.github.com.git toozhao-blog
|
||
cd toozhao-blog
|
||
code .
|
||
```
|
||
|
||
```markdown
|
||
# 2. 在 source/_posts/ 目录新建文件，如 hello-world.md：
|
||
---
|
||
title: "文章标题"
|
||
date: 2026-08-04 12:00:00
|
||
tags: [科技, 生活]
|
||
---
|
||
正文直接写 Markdown……支持代码块、表格、图片、引用。
|
||
```
|
||
|
||
```bash
|
||
# 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 即上线流程。
|
||
|
||
## 🧰 常用命令（可选，本地调试用）
|
||
|
||
```bash
|
||
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`
|