mirror of
https://github.com/wahyd4/wahyd4.github.com.git
synced 2026-08-09 05:15:56 +10:00
Add README: VSCode writing workflow + publish rules
This commit is contained in:
@@ -0,0 +1,80 @@
|
||||
# 大染志博客源码(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`
|
||||
Reference in New Issue
Block a user