gch3n/val-blog
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(val-blog): scaffold containerized Hugo dev flow with compose and starter content

Browse Source
This commit is contained in:
Chen Gu
2026-08-13 17:00:21 +08:00
parent 95f2c06955
commit 2c9f4cbf67
15 changed files with 1272 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
org/cases/val_blog/docs/03-content-pipeline.md
+390
View File
@@ -0,0 +1,390 @@
# 每日梦幻旅程记录 - 内容流水线设计
## 1. 内容流水线概览
```
┌─────────────────────────────────────────────────────────────────────┐
│ 内容创作流水线 │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ 灵感捕捉 │ → │ 草稿创作 │ → │ 审核润色 │ → │ 发布归档 │ │
│ │ Capture │ │ Draft │ │ Review │ │ Publish │ │
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
│ ↓ ↓ ↓ ↓ │
│ Obsidian/ VS Code + Self/Peer Hugo Build + │
│ 备忘录 Markdown Review Git Push │
│ │
└─────────────────────────────────────────────────────────────────────┘
```
---
## 2. 内容类型与发布节奏
### 2.1 发布节奏表
| 内容类型 | 频率 | 最佳发布时间 | 字数范围 | 准备周期 |
|---------|------|-------------|---------|---------|
| **速记 (Sketch)** | 每周 2-3 篇 | 晚间 21:00-23:00 | 300-800 | 即时-1天 |
| **旅程记录 (Journey)** | 每周 1-2 篇 | 周末上午 10:00 | 1500-3000 | 2-3天 |
| **图志 (Gallery)** | 每两周 1 篇 | 周末下午 15:00 | 图文为主 | 3-5天 |
| **深度文 (Essay)** | 每月 1-2 篇 | 月初/月中 20:00 | 3000-5000 | 1-2周 |
### 2.2 内容日历模板
```yaml
# content-calendar.yaml
weekly_quota:
minimum: 2 # 每周最少发布
target: 4 # 每周目标发布
maximum: 6 # 每周最多发布（避免过度）
publishing_windows:
weekday_evening:
time: "21:00-23:00"
types: [sketch]
description: "适合轻松的速记、灵感片段"
weekend_morning:
time: "10:00-12:00"
types: [journey]
description: "适合完整的旅程叙事"
weekend_afternoon:
time: "15:00-17:00"
types: [gallery]
description: "适合视觉为主的内容"
special_slot:
time: "每月第一个周日 20:00"
types: [essay]
description: "深度长文的专属时段"
content_buffer:
target: 4 # 保持4篇待发缓冲
minimum: 2 # 低于此数量时预警
```
---
## 3. 内容模板库
### 3.1 速记模板 (Sketch)
```markdown
---
title: "标题 - 简短有力，捕捉瞬间"
date: 2026-03-09T21:00:00+08:00
categories: ["sketch"]
tags: ["标签1", "标签2"]
mood: "平静|兴奋| melancholic | 神秘"
weather: "雾|雨|晴|雪|未知"
time_of_day: "黎明|正午|黄昏|深夜"
location: "地点名称"
world: "世界观名称"
description: "一句话描述"
---
<!--
速记写作指南：
- 首句必须是感官描写或场景建立
- 控制在3-5个段落
- 不要解释，只呈现
- 结尾留白，让读者自行想象
-->
首句建立场景...
中间段落展开...
结尾留白...
```
### 3.2 旅程记录模板 (Journey)
```markdown
---
title: "旅程标题"
date: 2026-03-09T10:00:00+08:00
categories: ["journey"]
tags: ["标签1", "标签2", "标签3"]
series: "系列名称（如适用）"
series_order: 1
location: "具体地点"
world: "世界观名称"
cover:
image: "/images/covers/xxx.jpg"
alt: "图片替代文字"
caption: "图片说明"
description: "旅程简介，用于列表展示"
toc: true
reading_time: true
---
## 旅程起点
描述出发的地点、时间、初始状态。建立读者对旅程的期待。
## 路线与见闻
### 第一段路程
详细记录沿途的发现。使用感官描写：
- **视觉**：颜色、形状、光影
- **听觉**：声音、寂静、回声
- **触觉**：温度、质地、湿度
- **嗅觉/味觉**：如有
### 关键地点名称
深入描写重要地点...
## 关键发现
旅程中的重要发现、遇见的人或事物、特殊事件。
## 感悟与反思
旅程带来的思考、情绪变化、对未来的影响。
## 实用信息
- **位置坐标**:
- **建议路线**:
- **注意事项**:
- **最佳时间**:
```
### 3.3 图志模板 (Gallery)
```markdown
---
title: "图志标题"
date: 2026-03-09T15:00:00+08:00
categories: ["gallery"]
tags: ["标签1", "标签2"]
location: "拍摄地点"
world: "世界观"
description: "图志简介"
---
图志的开篇文字，交代背景、氛围、拍摄动机。
{{< gallery >}}
{{< image
src="/images/gallery/xxx-01.jpg"
alt="图片描述"
caption="详细说明，可包含地点、时间、感受"
>}}
{{< image
src="/images/gallery/xxx-02.jpg"
alt="图片描述"
caption="说明文字"
>}}
{{< /gallery >}}
图志结尾，总结或留下思考。
```
### 3.4 深度文模板 (Essay)
```markdown
---
title: "文章标题"
date: 2026-03-09T20:00:00+08:00
categories: ["essay"]
tags: ["标签1", "标签2", "标签3", "标签4"]
series: "系列名称（如适用）"
series_order: 1
abstract: "摘要，200字以内概括核心观点"
description: "文章简介"
toc: true
reading_time: true
---
## 引言
引人入胜的开篇。可以是一个场景、一个问题、一个观察。
## 正文第一部分
展开论述...
### 子主题
深入分析...
## 正文第二部分
继续展开...
## 案例/故事
具体的例子来支撑观点...
## 结论
总结核心观点，留下余韵。
## 参考与延伸
- 相关阅读链接
- 推荐资源
- 延伸阅读
```
---
## 4. 灵感收集系统
### 4.1 灵感来源矩阵
| 来源类型 | 示例 | 收集方式 | 转化周期 |
|---------|------|---------|---------|
| **真实旅行** | 城市漫步、自然风光、建筑 | 手机速记+照片 | 1-3天 |
| **阅读观影** | 小说、纪录片、独立游戏 | 摘录+感想 | 即时记录 |
| **梦境** | 夜间梦境片段 | 醒来立即记录 | 当天整理 |
| **随机联想** | 两个概念的意外连接 | 闪念笔记 | 适时扩展 |
| **他人对话** | 有趣的谈话、观点 | 简要记录 | 评估后使用 |
### 4.2 灵感收集工具链
```
灵感捕捉流程：
1. 移动端 (随时)
└── Apple Notes / Obsidian Mobile
├── 语音速记
├── 拍照+备注
└── 链接收藏
2. 桌面端 (整理)
└── Obsidian Vault
├── Daily Notes (每日灵感)
├── Maps of Content (主题索引)
└── Literature Notes (阅读笔记)
3. 转化 (创作)
└── VS Code + Markdown
├── 从灵感笔记扩展
├── 套用内容模板
└── 使用 hugo new 命令创建
```
---
## 5. 发布流程
### 5.1 发布检查清单
```markdown
## 发布前检查
### 内容检查
- [ ] 标题简洁有力，无错别字
- [ ] 摘要/description 已填写
- [ ] 标签选择恰当（2-5个）
- [ ] 分类正确
- [ ] 日期时间正确
### 格式检查
- [ ] Markdown 语法正确
- [ ] 图片已压缩优化
- [ ] 图片 alt 文字已填写
- [ ] 链接可正常访问
### 元数据检查
- [ ] location 字段（如适用）
- [ ] world 字段（如适用）
- [ ] series 信息完整（如适用）
### 技术检查
- [ ] hugo server 本地预览正常
- [ ] 暗色模式显示正常
- [ ] 移动端显示正常
- [ ] 无控制台报错
```
### 5.2 自动化发布脚本
```bash
#!/bin/bash
# scripts/publish.sh
set -e
echo "🚀 开始发布流程..."
# 1. 拉取最新更改
echo "📥 同步远程仓库..."
git pull origin main
# 2. 构建站点
echo "🔨 构建站点..."
hugo --minify
# 3. 本地预览检查（可选）
if [ "$1" = "preview" ]; then
echo "👁️ 启动预览服务器..."
hugo server -D
exit 0
fi
# 4. 提交更改
echo "💾 提交更改..."
git add .
git commit -m "publish: $(date '+%Y-%m-%d %H:%M') 发布新内容"
# 5. 推送到远程
echo "📤 推送到远程仓库..."
git push origin main
echo "✅ 发布完成！GitHub Actions 将自动部署。"
```
---
## 6. 内容存档与版本控制
### 6.1 Git工作流
```
main 分支 (受保护)
│
├── 所有已发布内容
├── 触发 GitHub Actions 自动部署
└── 仅通过 PR 或本地合并更新
content/drafts 分支 (可选)
│
├── 未完成草稿
├── 待审核内容
└── 完成后合并到 main
```
### 6.2 提交信息规范
```
格式: <type>: <subject>
类型:
- content: 新内容发布
- edit: 内容修改
- fix: 错误修复
- style: 样式调整
- chore: 配置/工具更新
示例:
content: 2026-03-09 水晶洞穴探险记
edit: 修正旅程记录中的日期错误
style: 调整暗色模式下代码块颜色
```
---
## 7. 变更记录
| 版本 | 日期 | 变更内容 | 作者 |
|------|------|---------|------|
| v0.1.0 | 2026-03-09 | 初稿创建 | Val |