gitsite-content-manager

此 skill 专为使用 GitSite 静态网站生成器的项目设计，用于自动化管理网站内容（blogs、books 和 pages）。GitSite 使用特定的目录结构和 YAML 配置文件，每次手动创建内容时容易忘记正确的配置格式和文件位置。此 skill 确保内容创建的一致性和正确性。

当用户请求创建以下任何内容时，使用此 skill：

• 创建新的博客文章
• 创建新的书籍
• 创建新的书籍章节
• 创建新的静态页面

1. 创建博客文章 (Blog Post)

目录结构：

```

source/blogs/tech/

└── YYYY-MM-DD-post-slug/

└── README.md

```

使用 Python 脚本创建：

```bash

python3 .claude/skills/gitsite-content-manager/scripts/manage_content.py blog \

--title "My Blog Post Title" \

--date "2025-01-15" \

--description "A description of the post" \

--tags tech tutorial \

--author "Orangon"

```

手动创建步骤：

1. 在 source/blogs/tech/ 下创建日期目录，格式：YYYY-MM-DD-title-slug/
2. 创建 README.md 文件，包含以下 frontmatter：

```yaml

---

title: "Blog Post Title"

date: 2025-01-15

description: "Blog post description"

tags:

- tech

- tutorial

author: Orangon

---

# Blog Post Title

```

2. 创建书籍 (Book)

目录结构：

```

source/books/

└── book-name/

├── book.yml

├── index.md

└── 01-Chapter-One/

└── README.md

```

使用 Python 脚本创建：

```bash

python3 .claude/skills/gitsite-content-manager/scripts/manage_content.py book \

--name "My-Book" \

--title "My Book Title" \

--description "Book description" \

--author "Orangon"

```

手动创建步骤：

1. 在 source/books/ 下创建书籍目录
2. 创建 book.yml 配置文件：

```yaml

title: My Book Title

description: Book description

author: Orangon

```

1. 创建 index.md 作为书籍索引页面

3. 创建书籍章节 (Book Chapter)

使用 Python 脚本创建：

```bash

python3 .claude/skills/gitsite-content-manager/scripts/manage_content.py chapter \

--book "My-Book" \

--number "01" \

--title "Chapter One" \

--description "Chapter description"

```

手动创建步骤：

1. 在书籍目录下创建章节目录，格式：XX-Chapter-Title/
2. 创建 README.md 文件：

```yaml

---

title: "Chapter One"

description: "Chapter description"

---

# 01. Chapter One

```

4. 创建静态页面 (Page)

目录结构：

```

source/pages/

└── page-name/

└── README.md

```

使用 Python 脚本创建：

```bash

python3 .claude/skills/gitsite-content-manager/scripts/manage_content.py page \

--name "about" \

--title "About Us" \

--description "About page description"

```

手动创建步骤：

1. 在 source/pages/ 下创建页面目录
2. 创建 README.md 文件：

```yaml

---

title: "About Us"

description: "About page description"

---

# About Us

```

使用 assets/templates/ 中的模板文件作为内容创建的基础：

• blog_post.md - 博客文章模板
• book_chapter.md - 书籍章节模板
• page.md - 静态页面模板

这些模板包含完整的 frontmatter 结构和内容大纲。

目录命名规范

1. 博客文章：使用日期格式 YYYY-MM-DD-title-slug/
2. 书籍章节：使用编号前缀 XX-Chapter-Title/ (如 01-Introduction/)
3. 书籍目录：使用 kebab-case 命名 (如 AI-Coding/)
4. 页面目录：使用 kebab-case 命名 (如 about-me/)

Frontmatter 格式

所有内容文件必须包含 YAML frontmatter，基本格式：

```yaml

---

title: "Content Title"

description: "Content description"

---

```

博客文章额外需要：

• date: 发布日期
• tags: 标签列表
• author: 作者名称

配置文件位置

• 网站配置：source/site.yml (主配置)
• 博客配置：source/blogs/tech/blog.yml
• 书籍配置：source/books/[book-name]/book.yml
• 页面配置：无需单独配置文件

URL 生成规则

GitSite 自动根据目录结构生成 URL：

• 博客：/blogs/tech/YYYY-MM-DD-title-slug/index.html
• 书籍：/books/book-name/XX-Chapter-Title/index.html
• 页面：/pages/page-name/index.html

创建内容后，验证构建是否成功：

```bash

# 构建网站

gitsite-cli build -o _site -v

# 或启动开发服务器预览

gitsite-cli serve

```

检查生成的 HTML 文件是否存在于 _site/ 目录中。

1. 忘记创建 book.yml：书籍目录必须有 book.yml 配置文件
2. 目录命名错误：使用空格或特殊字符会导致构建失败
3. 缺少 README.md：每个内容目录必须有 README.md 文件
4. Frontmatter 格式错误：YAML 格式必须正确，注意引号和缩进
5. 日期格式错误：博客日期必须使用 YYYY-MM-DD 格式

scripts/manage_content.py

Python 脚本提供命令行接口用于创建各种类型的内容。支持以下命令：

• blog - 创建博客文章
• book - 创建书籍
• chapter - 创建书籍章节
• page - 创建静态页面

使用 --help 查看完整参数说明。

assets/templates/

包含各类内容模板文件，可直接复制使用或作为参考：

• blog_post.md - 完整的博客文章模板
• book_chapter.md - 完整的书籍章节模板
• page.md - 完整的静态页面模板

模板文件使用 {{variable}} 占位符，使用时需要替换为实际内容。