🚀 快速开始指南

🚀 快速开始指南

立即体验统一配置系统

第一步:启动管理界面

ruby scripts/manage-content.rb

你会看到这样的菜单:

🎯 网站内容管理系统
==================================================

📋 请选择操作:
1. 编辑基本信息
2. 编辑作者信息
3. 编辑导航菜单
4. 编辑界面文本
5. 编辑社交媒体链接
6. 编辑About页面内容
7. 备份当前配置
8. 恢复配置
9. 预览当前配置
10. 重新构建网站
0. 退出

第二步:修改网站内容

选择相应的选项来修改内容:

  • 选择 1 → 修改网站标题、描述等基本信息
  • 选择 2 → 修改你的姓名、简介、位置等
  • 选择 3 → 添加、删除或修改导航菜单
  • 选择 4 → 修改界面上的各种文本
  • 选择 5 → 更新社交媒体链接
  • 选择 6 → 编辑About页面的所有内容

第三步:查看效果

修改完成后,网站会自动重新构建。访问 http://localhost:4000 查看效果。

常用操作示例

修改网站标题

  1. 运行管理脚本
  2. 选择 1 (编辑基本信息)
  3. 输入新的网站标题
  4. 保存并查看效果

添加新的导航菜单

  1. 运行管理脚本
  2. 选择 3 (编辑导航菜单)
  3. 选择 a (添加新菜单项)
  4. 输入菜单标题和链接
  5. 保存并查看效果

修改个人简介

  1. 运行管理脚本
  2. 选择 2 (编辑作者信息)
  3. 修改个人简介
  4. 保存并查看效果

编辑About页面内容

  1. 运行管理脚本
  2. 选择 6 (编辑About页面内容)
  3. 选择要编辑的部分:
    • 1 - 页面标题
    • 2 - 介绍文本
    • 3 - 数据驱动网站部分
    • 4 - 开始使用部分
    • 5 - 站点配置部分
    • 6 - 创建内容部分
    • 7 - 编辑仓库部分
    • 8 - 更多信息部分
  4. 输入新内容(支持多行输入)
  5. 保存并查看效果

高级功能

备份配置

选择 7 来备份当前配置,防止意外丢失。

恢复配置

选择 8 来恢复之前的备份。

预览配置

选择 9 来查看当前的完整配置。

直接编辑配置文件

如果你更喜欢直接编辑文件,可以修改 _data/site-content.yml

# 修改网站标题
site_info:
  title: "你的新标题"
  
# 修改个人简介
author:
  bio: "你的新简介"
  
# 添加导航菜单
navigation:
  main:
    - title: "新页面"
      url: "/new-page/"

# 修改About页面内容
about_page:
  title: "新的About标题"
  introduction: "新的介绍文本"
  sections:
    data_driven:
      title: "新的章节标题"
      content: "新的章节内容"

在模板中使用

在你的Jekyll模板中,可以这样使用配置:

<!-- 获取网站标题 -->
<h1></h1>

<!-- 获取作者姓名 -->
<p>作者:</p>

<!-- 获取导航菜单 -->
<nav>
  
</nav>

<!-- 获取About页面内容 -->

<h1></h1>
<p></p>

故障排除

如果管理脚本不工作

# 确保脚本有执行权限
chmod +x scripts/manage-content.rb

# 检查Ruby是否安装
ruby --version

如果配置不生效

# 重新启动Jekyll服务器
pkill -f jekyll
bundle exec jekyll serve --livereload

如果出现错误

  1. 检查YAML语法是否正确
  2. 确保所有必需的字段都存在
  3. 查看Jekyll的错误日志

下一步

  • 阅读 CONTENT_MANAGEMENT.md 了解详细功能
  • 查看 _includes/site-content-example.html 了解模板用法
  • 根据需要自定义配置结构

支持

如果遇到问题,可以:

  1. 检查配置文件语法
  2. 查看Jekyll错误日志
  3. 使用备份功能恢复配置

🎉 恭喜!你现在拥有了一个强大的统一内容管理系统!