orangon 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}} 占位符，使用时需要替换为实际内容。