这是本节的多页打印视图。 .

博客

文章、设计记录与版本公告。

1: 文章
- 1.1: 极客日常写作与 GitOps 自动化发布工作流
- 1.2: 欢迎来到项目博客
2: 设计
- 2.1: 一套可以自然生长的精简内容模型
3: 发布
- 3.1: Project 0.1.0

通过文章、设计决策与版本说明了解项目进展。

1 - 文章

项目新闻、观点与实践故事。

1.1 - 极客日常写作与 GitOps 自动化发布工作流

基于 Hugo + OINK + GitHub Actions + FTPS + Cloudflare 边缘缓存的自动化知识库发布指南。

本站点采用 GitOps 现代自动化发布架构：你只需要在本地使用纯 Markdown 写作，执行 git push，云端流水线将全自动完成静态编译、加密传输与全球 CDN 边缘分发。

1. 核心架构与部署链路

[ 本地 Markdown 写作 ]
          │
          ▼  (git push origin main)
[ GitHub 仓库 ] ──► [ GitHub Actions 自动化流水线 ]
                            │
                            ├──► 1. Hugo Extended 极速编译 (静态 HTML/CSS/JS)
                            └──► 2. 8 线程并发 FTPS 加密同步
                                          │
                                          ▼
                             [ MatrixIDC 虚拟主机源站 ]
                                          │
                                          ▼ (回源自动接管)
                             [ Cloudflare 边缘 Anycast CDN ]
                                          │
                                          ▼
                               [ 全球读者 20ms 秒开 ]

2. 本地写作与预览指令

在本地项目目录 /Users/steven/Projects/yaping-docs 下操作：

2.1 启动本地实时预览（可选）

如果你安装了 hugo，可在本地启动热重载开发服务器：

cd /Users/steven/Projects/yaping-docs
hugo server -D
# 浏览器访问 http://localhost:1313/ 即可实时查看改动

2.2 新建文章与文档

博客文章：在 content/blog/post/ 下新建 .zh.md（中文）或 .md（英文）文件。
技术文档：在 content/docs/ 对应的子分类目录（如 introduction/、tutorial/）下新建或修改文件。
完整书籍/小册：在 content/book/ 下按章节编号命名文件（如 05-advanced.zh.md）。

3. 一键发布到线上（Git 三部曲）

写作完成后，在终端运行以下三行标准 Git 命令即可完成全自动上线：

# 1. 进入项目根目录
cd /Users/steven/Projects/yaping-docs

# 2. 暂存所有更改并编写提交信息
git add .
git commit -m "docs: 发布新文章或更新文档内容"

# 3. 推送到 GitHub 远程仓库（触发云端自动化构建）
git push origin main

4. 查看云端发布状态

查看构建进度：推送后，访问 GitHub Actions 控制台查看实时流水线。
线上验收：构建完成后（通常约 40~50 秒），直接刷新 https://docs.yaping.dpdns.org/ 查看最新内容。

1.2 - 欢迎来到项目博客

Yaping 知识库的第一篇文章——我们构建什么，为什么构建。

Post 栏目适合放置新闻、解读，以及不属于参考文档的项目故事。

这里适合发布什么

为希望了解背景的读者写作：项目为什么存在、团队学到了什么、接下来要做什么。

Yaping 从这里开始

我们记录家庭服务器工程、AI 原生工具链与注重隐私的基础设施。本博客承载设计笔记、版本故事和公开构建过程中的经验。

2 - 设计

塑造项目的架构记录与设计决策。

2.1 - 一套可以自然生长的精简内容模型

为什么这个模板要分开动态、参考资料与教程。

这个模板为每种写作提供一个明显的归宿。这样的分工既让导航可预测，也不会过早锁死项目的分类体系。

三种阅读方式

博客说明项目如何随时间变化。
文档回答聚焦的问题。
书籍按顺序教授完整工作流。

只在需要时增加结构

先使用现有栏目。只有当读者确实需要另一条内容路径时，再增加新的分支。

3 - 发布

版本公告与简洁的升级说明。

3.1 - Project 0.1.0

项目的第一个公开里程碑。

0.1.0 版本建立了项目第一个可用的公开基线。

主要内容

一条写清楚的安装路径。
一个小而稳定的公开接口。
一个明确的问题反馈入口。

升级说明

这是第一次发布，因此没有旧版本需要迁移。