GitSite Content Manager

Overview

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

Quick Start

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

• 创建新的博客文章

• 创建新的书籍

• 创建新的书籍章节

• 创建新的静态页面

Content Creation Workflow

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

目录结构：

source/blogs/tech/ └── YYYY-MM-DD-post-slug/ └── README.md

使用 Python 脚本创建：

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"

手动创建步骤：

• 在 source/blogs/tech/ 下创建日期目录，格式：YYYY-MM-DD-title-slug/

• 创建 README.md 文件，包含以下 frontmatter：

title: "Blog Post Title" date: 2025-01-15 description: "Blog post description" tags:

• tech
• tutorial author: Orangon

Blog Post Title

<!-- Write your blog post content here -->

Introduction

<!-- Add your introduction -->

Main Content

<!-- Add your main content -->

Conclusion

<!-- Add your conclusion -->

2. 创建书籍 (Book)

目录结构：

source/books/ └── book-name/ ├── book.yml ├── index.md └── 01-Chapter-One/ └── README.md

使用 Python 脚本创建：

python3 .claude/skills/gitsite-content-manager/scripts/manage_content.py book
--name "My-Book"
--title "My Book Title"
--description "Book description"
--author "Orangon"

手动创建步骤：

• 在 source/books/ 下创建书籍目录

• 创建 book.yml 配置文件：

title: My Book Title description: Book description author: Orangon

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

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

使用 Python 脚本创建：

python3 .claude/skills/gitsite-content-manager/scripts/manage_content.py chapter
--book "My-Book"
--number "01"
--title "Chapter One"
--description "Chapter description"

手动创建步骤：

• 在书籍目录下创建章节目录，格式：XX-Chapter-Title/

• 创建 README.md 文件：

title: "Chapter One" description: "Chapter description"

01. Chapter One

<!-- Write your chapter content here -->

Overview

<!-- Add chapter overview -->

Main Content

<!-- Add your main content -->

Summary

<!-- Add chapter summary -->

References

<!-- Add references if needed -->

4. 创建静态页面 (Page)

目录结构：

source/pages/ └── page-name/ └── README.md

使用 Python 脚本创建：

python3 .claude/skills/gitsite-content-manager/scripts/manage_content.py page
--name "about"
--title "About Us"
--description "About page description"

手动创建步骤：

• 在 source/pages/ 下创建页面目录

• 创建 README.md 文件：

title: "About Us" description: "About page description"

About Us

<!-- Write your page content here -->

Templates

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

• blog_post.md

• 博客文章模板

• book_chapter.md

• 书籍章节模板

• page.md

• 静态页面模板

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

Important Notes

目录命名规范

• 博客文章：使用日期格式 YYYY-MM-DD-title-slug/

• 书籍章节：使用编号前缀 XX-Chapter-Title/ (如 01-Introduction/ )

• 书籍目录：使用 kebab-case 命名 (如 AI-Coding/ )

• 页面目录：使用 kebab-case 命名 (如 about-me/ )

Frontmatter 格式

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

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

Verification

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

构建网站

gitsite-cli build -o _site -v

或启动开发服务器预览

gitsite-cli serve

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

Common Pitfalls

• 忘记创建 book.yml：书籍目录必须有 book.yml 配置文件

• 目录命名错误：使用空格或特殊字符会导致构建失败

• 缺少 README.md：每个内容目录必须有 README.md 文件

• Frontmatter 格式错误：YAML 格式必须正确，注意引号和缩进

• 日期格式错误：博客日期必须使用 YYYY-MM-DD 格式

Resources

scripts/manage_content.py

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

• blog

• 创建博客文章

• book

• 创建书籍

• chapter

• 创建书籍章节

• page

• 创建静态页面

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

assets/templates/

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

• blog_post.md

• 完整的博客文章模板

• book_chapter.md

• 完整的书籍章节模板

• page.md

• 完整的静态页面模板

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