📝 AWS-YZ 博客写作指南

📊 项目当前状态

博客统计

总文章数: 52篇
主要内容: AWS技术博客、成本优化、游戏开发
最新清理: 2025年7月4日删除了20篇重复文章
项目结构: 标准Jekyll博客，使用Hamilton主题

内容分布

AWS官方博客摘要: 50篇 (96%)
原创技术文章: 2篇 (4%)
- AWS成本优化公式
- 博客欢迎页面

🚀 快速发布流程

1. 创建新博客文章

# 进入项目目录
cd /Users/wyz/project/aws-yz.github.io

# 使用模板创建新文章
cp _templates/post-template.md _posts/2025-07-04-my-new-blog-post.md

# 或者创建n8n相关文章
cp _templates/n8n-post-template.md _posts/2025-07-04-n8n-automation-guide.md

2. 编写文章内容

使用你喜欢的编辑器打开文件，添加 front matter 和内容：

---
layout: post
title: "我的新博客文章"
date: 2025-07-04 16:00:00 +0000
categories: [aws, tutorial]
tags: [lambda, serverless, best-practices]
toc: true
math: false
author: "YZ Wang"
---

# 🚀 我的新博客文章

## 添加图片示例

### 内容配图
![AWS Lambda架构](/assets/images/posts/aws/lambda-architecture.png "Lambda架构图")

### 截图
![AWS控制台](/assets/images/screenshots/aws-console.png)

### 流程图
![工作流程](/assets/images/diagrams/workflow.png)

3. 本地预览

# 启动本地 Jekyll 服务器
bundle exec jekyll serve --port 4000

# 访问：http://localhost:4000
# 实时预览你的文章效果，修改文件后会自动重新生成

4. 发布到 GitHub

# 添加新文件
git add _posts/2025-07-04-my-new-blog-post.md

# 提交更改
git commit -m "Add new blog post: 我的新博客文章"

# 推送到 GitHub
git push origin main

📈 内容策略建议

当前内容分析

优势: AWS技术内容丰富，覆盖面广
机会: 增加原创深度技术文章
建议: 平衡官方摘要与原创内容

内容质量提升

# 建议的文章结构
## 🎯 问题背景
## 🔍 解决方案
## 💡 实施步骤
## 📊 效果评估
## 🚀 最佳实践
## 🔗 相关资源

🎨 简化设计理念

Emoji风格标题

博客采用简洁的emoji风格，无需复杂的banner图片：

# 🚀 技术教程类文章
# ☁️ AWS相关文章
# 💰 成本优化文章
# 📚 学习指南
# ✍️ 博客心得
# 🔗 n8n自动化
# 💾 存储相关
# 📰 新闻资讯

自动分类图标

系统会自动为不同分类添加图标：

aws → ☁️
n8n → 🔗
cost-optimization → 💰
tutorial → 📚
blog → ✍️
storage → 💾
news → 📰

🛠 高级写作流程

1. 使用草稿功能

# 创建草稿目录（如果不存在）
mkdir -p _drafts

# 创建草稿文件（不需要日期前缀）
touch _drafts/my-draft-post.md

# 预览包含草稿的站点
bundle exec jekyll serve --drafts

2. 批量操作和文件管理

# 同时添加多个文章
git add _posts/*.md

# 批量提交
git commit -m "Add multiple blog posts"

# 查找特定时间创建的文件
find _posts -type f -newermt "2025-07-04 17:26:00" ! -newermt "2025-07-04 17:27:00" -ls

# 批量删除特定时间的文件（谨慎使用）
find _posts -type f -newermt "2025-07-04 17:26:00" ! -newermt "2025-07-04 17:27:00" -delete

3. 使用模板快速创建

# 复制模板文件
cp _templates/post-template.md _posts/2025-07-04-new-post.md

# 编辑新文件
vim _posts/2025-07-04-new-post.md

🔧 项目维护工具

文件清理命令

# 检查重复文件
find _posts -name "*.md" -exec basename {} \; | sort | uniq -d

# 统计文章数量
find _posts -name "*.md" | wc -l

# 按日期查看最近的文章
ls -lt _posts/ | head -10

# 查看Git提交历史
git log --oneline -10

内容审查

# 检查文章的front matter格式
grep -l "^---$" _posts/*.md | head -5

# 统计不同类别的文章
grep -h "categories:" _posts/*.md | sort | uniq -c

# 查找缺少必要字段的文章
grep -L "title:" _posts/*.md

🤖 n8n 自动化发布系统

当前自动化能力

项目已集成完整的 n8n 自动化工作流，具备以下功能：

多源RSS监控

AWS 官方博客: https://aws.amazon.com/blogs/aws/feed/
AWS Insights: https://aws.amazon.com/blogs/aws-insights/feed/
AWS GameTech: https://aws.amazon.com/blogs/gametech/feed/
AWS ML博客: https://aws.amazon.com/blogs/machine-learning/feed/

智能内容处理

AI摘要生成: 使用 Claude 3.5 Sonnet V2 生成中文摘要
内容过滤: 自动筛选 “Featured”、”Launch”、”Week in Review” 标签
分类标记: 自动添加RSS源前缀标识
- [AWS Blog] - AWS官方博客
- [AWS Insights] - AWS Insights博客
- [AWS GameTech] - 游戏技术博客
- [ML] - 机器学习博客

自动发布流程

RSS监控 → 定期检查新文章
时间戳管理 → DynamoDB存储最后处理时间
AI处理 → 生成中文摘要和元数据
GitHub发布 → 自动创建Markdown文件并提交
通知推送 → 飞书机器人通知发布结果

n8n工作流配置要点

关键节点说明

AI Agent: 使用结构化输出解析器确保JSON格式正确
GitHub API: 自动提交到 _posts/ 目录
DynamoDB: 管理RSS时间戳，避免重复处理
飞书通知: 实时推送发布状态

文件命名规范

自动化系统生成的文件遵循以下格式：

YYYY-MM-DD-aws-blog-[title-slug].md

Front Matter模板

---
layout: post
title: "[RSS源] 文章标题"
date: YYYY-MM-DDTHH:MM:SS+00:00
categories: [aws, 自动分类]
tags: [自动提取的标签]
toc: true
math: false
author: "AWS Blog 摘要"
original_author: "原作者"
original_link: "原文链接"
---

手动干预场景

虽然大部分流程已自动化，但以下情况可能需要手动处理：

内容质量控制

检查AI生成的摘要质量
验证分类和标签的准确性
处理特殊格式或图片内容

重复内容管理

# 检查可能的重复文章
grep -r "original_link.*同一链接" _posts/

# 删除重复或低质量文章
git rm _posts/重复文件名.md
git commit -m "Remove duplicate content"

批量操作

# 查看自动化生成的文章
find _posts -name "*aws-blog*" -newer _posts/2025-07-01-welcome-to-aws-yz-blog.md

# 批量修改分类（如需要）
sed -i 's/categories: \[aws\]/categories: [aws, news]/' _posts/*aws-blog*.md

🖼️ 图片管理规范

图片目录结构

assets/images/
├── posts/           # 文章内容配图
│   ├── aws/         # AWS相关图片
│   ├── n8n/         # n8n相关图片
│   └── general/     # 通用技术图片
├── icons/           # 图标 (64x64px)
├── diagrams/        # 架构图和流程图
└── screenshots/     # 截图

图片使用规范

内容配图

# 基础语法
![图片描述](/assets/images/posts/category/image-name.png)

# 带标题
![图片描述](/assets/images/posts/category/image-name.png "图片标题")

# 架构图示例
![AWS Lambda架构](/assets/images/diagrams/aws-lambda-architecture.png "无服务器架构")

免费图片资源

Unsplash: https://unsplash.com (高质量免费图片)
AWS Icons: https://aws.amazon.com/architecture/icons/ (官方图标)
draw.io: https://draw.io (免费架构图工具)
Canva: https://canva.com (免费版，快速制作图片)

图片优化建议

内容图片最大宽度：800px
文件大小：< 300KB
格式：JPG (照片), PNG (图标/截图)
使用 TinyPNG 压缩图片

📋 文章写作规范

Front Matter 必填字段：

---
layout: post
title: "文章标题"
date: 2025-07-01 16:00:00 +0000
categories: [category1, category2]
tags: [tag1, tag2, tag3]
---

可选字段：

toc: true - 启用目录
math: true - 启用数学公式
author: "作者名" - 指定作者
original_author: "原作者" - 转载文章的原作者
original_link: "原文链接" - 转载文章的原文链接

文件命名规则：

格式：YYYY-MM-DD-title-slug.md
示例：2025-07-04-aws-lambda-best-practices.md
重要: 避免在同一时间创建多个文件，防止重复内容

标题格式规范：

# 🚀 技术教程：AWS Lambda最佳实践
# ☁️ AWS新功能：Amazon S3新特性解析
# 💰 成本优化：如何降低AWS账单
# 📚 学习指南：从零开始学习Docker
# ✍️ 博客心得：写技术博客的经验分享

内容质量检查清单：

标题清晰且包含关键词
Front matter完整且格式正确
内容结构清晰，有明确的章节
代码示例可执行且有注释
图片路径正确且文件存在
链接有效且指向正确资源
语法和拼写检查通过

🔧 常用命令速查

# 启动开发服务器
bundle exec jekyll serve

# 指定端口
bundle exec jekyll serve --port 4001

# 包含草稿
bundle exec jekyll serve --drafts

# 构建站点（不启动服务器）
bundle exec jekyll build

# 清理生成的文件
bundle exec jekyll clean

📁 推荐的工作流程

标准发布流程

规划 → 确定文章主题和目标读者
写作 → 在 _drafts/ 中创建草稿
预览 → 使用 --drafts 参数本地预览
完善 → 修改和优化内容，检查质量清单
发布 → 移动到 _posts/ 并添加正确的日期前缀
推送 → Git 提交并推送到 GitHub
验证 → 检查线上效果和链接有效性

内容管理最佳实践

避免批量创建: 不要在同一时间创建大量文件
定期清理: 删除重复或低质量内容
版本控制: 使用有意义的Git提交信息
备份重要: 重要文章保留本地备份

质量控制流程

# 发布前检查
bundle exec jekyll build --verbose  # 检查构建错误
bundle exec jekyll serve --drafts   # 本地预览
git status                          # 确认要提交的文件
git diff --cached                   # 检查更改内容

🎯 Hamilton 主题特色功能

数学公式支持

在 front matter 中添加 math: true，然后可以使用 LaTeX 语法：

$$E = mc^2$$

行内公式：$x = \frac{-b \pm \sqrt{b^2-4ac}}{2a}$

目录功能

在 front matter 中添加 toc: true，会自动生成文章目录。

代码高亮

支持语法高亮的代码块：

function hello() {
    console.log("Hello World!");
}

分类和标签样式

Categories：绿色背景标签，带emoji图标
Tags：蓝色圆角标签，悬停效果

📝 写作技巧

标题层次

# 🚀 主标题（带emoji）
## 二级标题
### 三级标题
#### 四级标题

代码块

```javascript
// 指定语言获得语法高亮
function example() {
    return "Hello World!";
}

### **链接和引用**
```markdown
# 链接
[链接文字](URL)
[链接文字](URL "悬停提示")

# 引用
> 这是一个引用块
> 可以多行显示

# 列表
- 无序列表项1
- 无序列表项2

1. 有序列表项1
2. 有序列表项2

表格

| 列1 | 列2 | 列3 |
|-----|-----|-----|
| 数据1 | 数据2 | 数据3 |
| 数据4 | 数据5 | 数据6 |

✨ 简化构建的优势

🚀 快速构建

无需处理复杂的图片资源
标准Jekyll构建流程
减少构建时间和错误

🎯 专注内容

Emoji提供视觉效果，不分散注意力
简洁设计突出文章内容
更好的阅读体验

📱 移动友好

响应式设计
快速加载
在所有设备上都表现良好

🔧 易维护

减少了构建复杂度
降低潜在问题
更容易调试和修改

🎉 开始写作

现在你可以专注于内容创作，享受简洁高效的写作体验！

快速开始命令

# 创建新文章
cp _templates/post-template.md _posts/2025-07-04-my-awesome-post.md

# 编辑内容
vim _posts/2025-07-04-my-awesome-post.md

# 本地预览
bundle exec jekyll serve

# 发布
git add . && git commit -m "Add new post: 我的精彩文章" && git push

项目健康检查

# 检查项目状态
echo "文章总数: $(find _posts -name '*.md' | wc -l)"
echo "最新文章: $(ls -t _posts/*.md | head -1 | xargs basename)"
echo "Git状态: $(git status --porcelain | wc -l) 个未提交更改"
echo "构建状态: $(bundle exec jekyll build 2>&1 | grep -c 'done')"

# 自动化内容统计
echo "自动化文章: $(find _posts -name '*aws-blog*' | wc -l)"
echo "原创文章: $(find _posts -not -name '*aws-blog*' -name '*.md' | wc -l)"
echo "最新自动化文章: $(find _posts -name '*aws-blog*' | sort | tail -1 | xargs basename)"

n8n工作流维护

# 检查DynamoDB时间戳（需要AWS CLI配置）
aws dynamodb get-item --table-name rss-timestamp --key '{"id":{"N":"1"}}' --query 'Item'

# 验证RSS源可访问性
curl -I https://aws.amazon.com/blogs/aws/feed/
curl -I https://aws.amazon.com/blogs/aws-insights/feed/
curl -I https://aws.amazon.com/blogs/gametech/feed/
curl -I https://aws.amazon.com/blogs/machine-learning/feed/

下一步建议

平衡自动化与原创: 当前96%为自动化内容，建议增加20%原创技术分享
内容深度优化: 在自动摘要基础上，添加个人见解和实践经验
质量控制流程: 定期审查自动化生成的内容质量
读者互动: 考虑添加评论系统或社交媒体链接
n8n工作流优化:
- 调整AI提示词以提高摘要质量
- 优化分类算法的准确性
- 增加内容去重机制

自动化监控

# 检查n8n自动化状态
echo "最近自动发布的文章:"
find _posts -name "*aws-blog*" -newer _posts/2025-07-01-welcome-to-aws-yz-blog.md | head -5

# 检查RSS源分布
echo "各RSS源文章数量:"
grep -h "original_link" _posts/*.md | grep -o 'blogs/[^/]*' | sort | uniq -c

# 验证自动化质量
echo "检查可能的问题文章:"
grep -l "summary.*解析失败\|类型错误" _posts/*.md

Happy writing! ✍️

最后更新: 2025年7月4日
项目状态: 72篇文章（52篇自动化 + 20篇恢复），已集成n8n自动化发布系统
自动化程度: 96% AWS博客摘要自动化，4% 原创内容
维护者: YZ Wang
n8n工作流: 支持4个RSS源的自动监控和发布