| name | blog |
| description | 同步开发信息到 Hugo 博客。当用户请求发布博客、同步开发记录、创建技术文章或发布到 GitHub Pages 时使用此技能。 |
博客同步技能
将开发信息同步到 Hugo 博客 (blog.jaxiu.cn)。
博客目录
/Volumes/M20/code/docs/axfinn_blogs/
├── content/
│ ├── blog/ # 技术博客文章
│ ├── moment/ # 动态/短更新
│ └── about/ # 关于页面
├── publish.sh # 发布脚本
└── config.toml # Hugo 配置
文章格式
博客文章 (content/blog/)
---
title: "文章标题"
date: 2025-01-17T10:00:00+08:00
draft: false
slug: "english-slug-name"
tags: ["标签1", "标签2"]
categories: ["技术", "项目分析"]
series: ["系列名称"] # 可选
---
文章正文内容...
Frontmatter 字段说明
| 字段 | 必填 | 说明 |
|---|
| title | 是 | 文章标题(中文或英文) |
| date | 是 | 发布时间,格式 2025-01-17T10:00:00+08:00 |
| draft | 是 | false 表示发布,true 表示草稿 |
| slug | 是 | URL 友好标识(必须用英文,避免中文编码问题) |
| tags | 是 | 标签数组,用于分类 |
| categories | 是 | 分类数组,通常 1-2 个 |
| series | 否 | 系列名称,用于关联多篇文章 |
常用标签
- 技术栈: Go语言, Vue, Python, Rust, TypeScript
- 项目: NPS, DeepChat, Qwen Code, TodoIng
- 领域: AI, 源码分析, 架构设计, DevOps
常用分类
- 技术 + 项目分析
- 技术 + 架构设计
- 技术 + AI工具
- 技术 + 教程
- 技术 + 源码解析
动态更新 (Moments)
动态内容在 content/moment/_index.md 中追加,格式:
## 2025-01
### 2025-01-17
简短的动态内容,支持 emoji 和链接。
支持的 Markdown 功能
Mermaid 图表
{{< mermaid >}}
graph TD
A[开始] --> B[处理] --> C[结束]
{{< /mermaid >}}
代码高亮
```go
func main() {
fmt.Println("Hello")
}
```
数学公式 (KaTeX)
行内公式: $E = mc^2$
块级公式:
$$
\sum_{i=1}^{n} x_i
$$
发布流程
1. 创建/编辑文章
/Volumes/M20/code/docs/axfinn_blogs/content/blog/{slug}.md
2. 本地预览
cd /Volumes/M20/code/docs/axfinn_blogs
hugo server -D
3. 发布到 GitHub Pages
cd /Volumes/M20/code/docs/axfinn_blogs
bash publish.sh
发布脚本会自动:
- 构建站点 (
hugo -D)
- 复制到
axfinn.github.io 仓库
- 提交并推送到 GitHub
工作流程
同步开发记录到博客
- 收集信息: 从对话/项目中提取关键开发内容
- 确定类型:
- 完整技术文章 →
content/blog/
- 简短动态 →
content/moment/_index.md
- 生成内容:
- 使用正确的 frontmatter
- slug 必须是英文
- 包含适当的标签和分类
- 写入文件: 创建或更新 markdown 文件
- 发布: 运行
publish.sh
项目系列文章
对于项目源码分析等系列文章:
- 使用
series 字段关联文章
- 保持一致的命名规范:
{project}-{topic}.md
- 文章编号或主题清晰
示例系列结构:
nps-overview.md # NPS项目概览
nps-server-core.md # 服务端核心分析
nps-client.md # 客户端分析
nps-proxy-tcp.md # TCP代理实现
检查清单
发布前确认: