CMS 集成指南

概述

本指南将帮助您为个人网站添加CMS（内容管理系统）支持，让内容管理更加便捷和现代化。

已实施的解决方案

1. Forestry CMS（推荐）

Forestry CMS是一个现代化的无头CMS，专为静态网站设计，与Jekyll完美集成。

设置步骤：

注册Forestry账户
- 访问 forestry.io
- 使用GitHub账户登录
连接GitHub仓库
- 在Forestry中点击”Add Site”
- 选择您的GitHub仓库：systembugtj/systembugtj.github.io
- 选择Jekyll作为静态站点生成器
配置内容模型
- 系统会自动检测您的Jekyll配置
- 已预配置文章和页面模板
- 可以自定义字段和验证规则
开始使用
- 在Forestry界面中编辑内容
- 更改会自动提交到GitHub
- GitHub Pages会自动重新构建网站

优势：

✅ 零学习成本，直接集成
✅ 保持静态网站特性
✅ 可视化内容编辑
✅ 版本控制集成
✅ 免费方案足够个人使用

2. Netlify CMS（备选方案）

Netlify CMS是一个开源的无头CMS，提供类似WordPress的编辑体验。

设置步骤：

启用GitHub身份验证
- 在GitHub设置中创建OAuth App
- 配置回调URL
访问CMS界面
- 访问 https://your-domain.com/admin
- 使用GitHub账户登录
编辑内容
- 在可视化界面中编辑文章
- 支持Markdown预览
- 自动保存到GitHub

优势：

✅ 完全开源
✅ 可自定义界面
✅ 支持多种内容类型
✅ 与Git工作流集成

内容管理流程

创建新文章

通过Forestry CMS：
- 登录Forestry控制台
- 点击”New Post”
- 填写标题、日期、描述等元数据
- 在编辑器中编写内容
- 点击”Save”自动发布
通过Netlify CMS：
- 访问 /admin 页面
- 点击”New Post”
- 使用可视化编辑器编写内容
- 点击”Save”提交到GitHub

编辑现有文章

在CMS界面中找到要编辑的文章
进行修改后保存
更改会自动同步到GitHub

管理媒体文件

图片上传到 assets/img/ 目录
支持拖拽上传
自动优化和压缩

技术配置

Jekyll配置优化

已更新 _config.yml 以支持CMS：

# 添加了SEO插件
plugins:
  - jekyll-sitemap
  - jekyll-paginate
  - jemoji
  - jekyll-feed
  - jekyll-seo-tag

# 配置内容集合
collections:
  posts:
    output: true
    permalink: /:title/

# 默认front matter
defaults:
  - scope:
      path: ""
      type: "posts"
    values:
      layout: "post"
      author: "ALBERT LI"

自动化部署

使用提供的部署脚本：

# 运行部署脚本
./scripts/deploy.sh

最佳实践

1. 内容组织

使用一致的标签系统
为每篇文章添加描述
定期更新和优化内容

2. 图片管理

使用描述性的文件名
优化图片大小和格式
添加alt文本提高可访问性

3. SEO优化

填写完整的meta描述
使用相关标签
保持URL结构简洁

4. 版本控制

定期提交更改
使用有意义的提交信息
保持主分支稳定

故障排除

常见问题

CMS无法访问
- 检查GitHub仓库权限
- 确认OAuth配置正确
内容不更新
- 检查GitHub Pages构建状态
- 确认Jekyll配置正确
图片无法显示
- 检查图片路径
- 确认文件已正确上传

获取帮助

Forestry CMS: docs.forestry.io
Netlify CMS: netlifycms.org
Jekyll: jekyllrb.com

下一步

选择并设置CMS（推荐Forestry）
迁移现有内容
培训内容编辑流程
设置定期备份策略
优化SEO和性能

最后更新：2024年12月