从 Jekyll 切换到 GitBook 配置

.gitbook.yaml

@@ -0,0 +1,26 @@
+root: ./
+
+structure:
+  readme: README.md
+  summary: SUMMARY.md
+
+plugins:
+  - search
+  - lunr
+  - fontsettings
+  - theme-comscore
+  - github
+  - edit-link
+  - page-toc
+  - back-to-top-button
+
+pluginsConfig:
+  github:
+    url: https://github.com/CodingGirlsClub/ai-clacky-workshop-tutorial
+  edit-link:
+    base: https://github.com/CodingGirlsClub/ai-clacky-workshop-tutorial/edit/main
+    label: 编辑此页
+  page-toc:
+    selector: ".markdown-section h1, .markdown-section h2, .markdown-section h3, .markdown-section h4"
+    position: "top"
+    showByDefault: true

.gitignore

@@ -1,2 +1,12 @@
 # IDE files
 .idea/
+
+# GitBook generated files
+_book/
+node_modules/
+*.epub
+*.mobi
+*.pdf
+
+# GitBook plugins
+.grunt/

README.md

@@ -18,13 +18,13 @@
 
 ### 📖 主要内容
 
-| 文件名                                                                    | 内容描述                   | 预计学习时间 |
-| ------------------------------------------------------------------------- | -------------------------- | ------------ |
-| [Clacky-AI-编程入门教程.md](tutorial/Clacky-AI-编程入门教程.md)           | 教程总览和学习路线图       | 20 分钟      |
-| [第一部分-Clacky-AI-基础概念.md](tutorial/第一部分-Clacky-AI-基础概念.md) | 核心概念详解，编程基础知识 | 20 分钟      |
-| [第二部分-快速入门指南.md](tutorial/第二部分-快速入门指南.md)             | 注册、登录、基本操作指南   | 30 分钟      |
-| [第三部分-第一个项目实践.md](tutorial/第三部分-第一个项目实践.md)         | 完整项目开发实战教程       | 80 分钟      |
-| [第四部分-进阶功能和最佳实践.md](tutorial/第四部分-进阶功能和最佳实践.md) | 高级功能和专业开发技巧     | 50 分钟      |
+| 章节                      | 内容描述                   | 预计学习时间 |
+| ------------------------- | -------------------------- | ------------ |
+| [第一章：开始之前](chapter1/README.md)     | 编程基础概念和AI辅助编程介绍 | 20 分钟      |
+| [第二章：环境准备](chapter2/README.md)     | 注册账户、连接GitHub、环境设置 | 30 分钟      |
+| [第三章：基础概念](chapter3/README.md)     | 编程语言基础、数据类型、控制结构 | 30 分钟      |
+| [第四章：第一个程序](chapter4/README.md)   | Hello World项目实践 | 40 分钟      |
+| [第五章：进阶技巧](chapter5/README.md)     | 面向对象、错误处理、文件操作 | 50 分钟      |
 
 ### 🛠️ 实践练习
 
@@ -36,8 +36,8 @@
 
 | 文件名                                      | 内容描述           | 用途     |
 | ------------------------------------------- | ------------------ | -------- |
-| [教程使用指南.md](tutorial/教程使用指南.md) | 学习方法和进度跟踪 | 学习指导 |
-| [常见问题解答.md](tutorial/常见问题解答.md) | FAQ 和故障排除     | 问题解决 |
+| [常见问题](appendix/faq.md) | FAQ 和故障排除     | 问题解决 |
+| [资源链接](appendix/resources.md) | 学习资源和工具推荐 | 学习指导 |
 
 ---
 
@@ -56,21 +56,12 @@
 - 访问 [GitHub 官网](https://github.com/) 并注册账号。
 - 完成邮箱验证和基础设置。
 
-### 步骤 3：选择并 Fork 官方仓库
-
-你可以选择以下任意一个官方博客仓库，点击进入后，点击右上角的 **Fork** 按钮，将仓库复制到你的账号下：
-
-- [Girls-Coding-Day-Jekyll-blog-1](https://github.com/CodingGirlsClub/Girls-Coding-Day-Jekyll-blog-1)
-- [Girls-Coding-Day-Jekyll-blog-2](https://github.com/CodingGirlsClub/Girls-Coding-Day-Jekyll-blog-2)
-- [Girls-Coding-Day-Jekyll-blog-3](https://github.com/CodingGirlsClub/Girls-Coding-Day-Jekyll-blog-3)
-- [Girls-Coding-Day-Jekyll-blog-4](https://github.com/CodingGirlsClub/Girls-Coding-Day-Jekyll-blog-4)
-
-### 步骤 4：Fork 本教程仓库
+### 步骤 3：Fork 本教程仓库
 
 - 访问 [本教程仓库](https://github.com/CodingGirlsClub/ai-clacky-workshop-tutorial)，点击右上角 **Fork** 按钮，将教程仓库复制到你的账号下。
 - 这样你就有了完整的教程副本，后续可以提交你的学习作品。
 
-### 步骤 5：通过 Clacky AI 导入 GitHub 项目
+### 步骤 4：通过 Clacky AI 导入 GitHub 项目
 
 - 在 Clacky AI 平台选择"导入 GitHub 项目"，登录你的 GitHub 账号，选择刚刚 Fork 的仓库进行导入。
 - 导入后即可在 Clacky AI 云端环境中体验真实项目开发、协作与部署。
@@ -80,7 +71,7 @@
 #### 💡 为什么要用 GitHub 和 GitHub Pages？
 
 - **GitHub** 是全球最大的开源代码托管平台，支持版本管理、协作开发。
-- **GitHub Pages** 可以免费托管静态网站，让你的博客一键上线，拥有自己的公开网址。
+- **GitBook** 可以创建精美的在线文档和电子书，让你的内容一键发布。
 - **Fork** 本教程仓库，完成学习后可以提交你的作品，参与开源社区贡献。
 - 通过 Fork、导入、修改和发布，你可以完整体验现代开发和开源协作流程。
 
@@ -262,15 +253,15 @@
 
 ## 🚀 开始你的编程之旅
 
-**准备好了吗？让我们从 [教程总览](tutorial/Clacky-AI-编程入门教程.md) 开始，踏上 AI 辅助编程的学习之旅！**
+**准备好了吗？让我们从 [第一章：开始之前](chapter1/README.md) 开始，踏上 AI 辅助编程的学习之旅！**
 
 记住：每个专业的程序员都是从第一行代码开始的。有了 Clacky AI 的帮助，你的编程之路将更加顺畅和有趣！
 
 ## 🌐 在线阅读
 
-本教程已部署为 GitHub Pages 网站，你可以通过以下方式阅读：
+本教程已配置为 GitBook 电子书，你可以通过以下方式阅读：
 
-- **📖 在线网站**：[https://codinggirlsclub.github.io/ai-clacky-workshop-tutorial](https://codinggirlsclub.github.io/ai-clacky-workshop-tutorial)
+- **📖 GitBook 电子书**：[https://codinggirlsclub.github.io/ai-clacky-workshop-tutorial](https://codinggirlsclub.github.io/ai-clacky-workshop-tutorial)
 - **📱 移动端友好**：支持手机、平板等设备访问
 - **🔍 搜索功能**：方便查找特定内容
 - **📑 目录导航**：清晰的章节导航

SUMMARY.md

@@ -0,0 +1,16 @@
+# 目录
+
+* [介绍](README.md)
+
+## 基础入门
+* [第一章：开始之前](chapter1/README.md)
+* [第二章：环境准备](chapter2/README.md)
+* [第三章：基础概念](chapter3/README.md)
+
+## 实践教程
+* [第四章：第一个程序](chapter4/README.md)
+* [第五章：进阶技巧](chapter5/README.md)
+
+## 附录
+* [常见问题](appendix/faq.md)
+* [资源链接](appendix/resources.md)

appendix/faq.md

@@ -0,0 +1,81 @@
+# 常见问题
+
+在学习过程中遇到问题？这里收集了最常见的问题和解决方案。
+
+## 账户和登录问题
+
+### Q: 忘记了 Clacky AI 账户密码怎么办？
+A: 在登录页面点击"忘记密码"，使用注册邮箱重置密码。
+
+### Q: 无法连接 GitHub 账户？
+A: 请检查：
+- GitHub 账户是否已验证邮箱
+- 是否授权了必要的权限
+- 网络连接是否正常
+
+## 编程相关问题
+
+### Q: 代码运行出错怎么办？
+A: 按以下步骤排查：
+1. 仔细阅读错误信息
+2. 检查语法是否正确
+3. 验证变量名拼写
+4. 确认缩进是否正确
+5. 向 Clacky AI 寻求帮助
+
+### Q: 如何提高编程技能？
+A: 建议：
+- 多练习，每天写一点代码
+- 阅读他人的优秀代码
+- 参与开源项目
+- 持续学习新技术
+
+### Q: 遇到复杂问题时如何求助？
+A: 有效求助方式：
+- 详细描述问题
+- 提供错误信息
+- 分享相关代码
+- 说明已尝试的解决方法
+
+## 项目管理问题
+
+### Q: 如何组织项目文件？
+A: 推荐结构：
+```
+project/
+├── src/          # 源代码
+├── docs/         # 文档
+├── tests/        # 测试文件
+├── README.md     # 项目说明
+└── .gitignore    # 忽略文件
+```
+
+### Q: 如何备份项目？
+A: 使用 Git 版本控制：
+- 定期提交代码
+- 推送到远程仓库
+- 创建分支保护重要版本
+
+## 学习建议
+
+### Q: 零基础学编程需要多长时间？
+A: 因人而异，一般：
+- 基础语法：1-2 周
+- 简单项目：1-2 个月
+- 独立开发：3-6 个月
+- 持续提升：终身学习
+
+### Q: 如何保持学习动力？
+A: 建议：
+- 设定明确目标
+- 制作有趣项目
+- 加入学习社区
+- 记录学习进度
+- 庆祝小成就
+
+## 技术支持
+
+如果以上方案都无法解决你的问题，请：
+- 联系 Clacky AI 客服
+- 在社区论坛发帖
+- 发送邮件到 support@clacky.ai

appendix/resources.md

@@ -0,0 +1,95 @@
+# 资源链接
+
+这里汇总了学习编程和使用 Clacky AI 的有用资源链接。
+
+## 官方资源
+
+### Clacky AI 官方
+- [Clacky AI 官网](https://clacky.ai) - 主要平台
+- [Clacky AI 文档](https://docs.clacky.ai) - 官方文档
+- [Clacky AI 博客](https://blog.clacky.ai) - 最新动态和教程
+- [用户社区](https://community.clacky.ai) - 交流讨论
+
+### GitHub 相关
+- [GitHub 官网](https://github.com) - 代码托管平台
+- [GitHub 文档](https://docs.github.com) - GitHub 使用指南
+- [GitHub Pages](https://pages.github.com) - 免费网站托管
+
+## 编程学习资源
+
+### 在线教程
+- [Python 官方教程](https://docs.python.org/zh-cn/3/tutorial/) - Python 入门
+- [MDN Web 文档](https://developer.mozilla.org/zh-CN/) - Web 开发权威指南
+- [菜鸟教程](https://www.runoob.com/) - 中文编程教程
+- [廖雪峰的官方网站](https://www.liaoxuefeng.com/) - 优质中文教程
+
+### 练习平台
+- [LeetCode](https://leetcode-cn.com/) - 算法练习
+- [HackerRank](https://www.hackerrank.com/) - 编程挑战
+- [Codewars](https://www.codewars.com/) - 代码练习
+- [FreeCodeCamp](https://www.freecodecamp.org/) - 免费编程课程
+
+## 开发工具
+
+### 代码编辑器
+- [Visual Studio Code](https://code.visualstudio.com/) - 轻量级编辑器
+- [Sublime Text](https://www.sublimetext.com/) - 快速编辑器
+- [Atom](https://atom.io/) - 可定制编辑器
+
+### 版本控制
+- [Git 官方文档](https://git-scm.com/doc) - Git 学习
+- [Git 教程](https://www.atlassian.com/git/tutorials) - 详细 Git 教程
+- [GitHub Desktop](https://desktop.github.com/) - Git 图形界面
+
+## 设计资源
+
+### 图标和图片
+- [Unsplash](https://unsplash.com/) - 免费高质量图片
+- [Pexels](https://www.pexels.com/) - 免费图片和视频
+- [Iconify](https://iconify.design/) - 海量免费图标
+- [Font Awesome](https://fontawesome.com/) - 经典图标库
+
+### 字体
+- [Google Fonts](https://fonts.google.com/) - 免费网页字体
+- [Font Squirrel](https://www.fontsquirrel.com/) - 免费商用字体
+
+## 社区和论坛
+
+### 中文社区
+- [掘金](https://juejin.cn/) - 技术分享社区
+- [CSDN](https://www.csdn.net/) - 技术博客平台
+- [知乎](https://www.zhihu.com/) - 知识分享平台
+- [Stack Overflow 中文](https://stackoverflow.com/questions/tagged/chinese)
+
+### 国际社区
+- [Stack Overflow](https://stackoverflow.com/) - 程序员问答社区
+- [Reddit Programming](https://www.reddit.com/r/programming/) - 编程讨论
+- [Dev.to](https://dev.to/) - 开发者社区
+
+## 新闻和博客
+
+### 技术新闻
+- [Hacker News](https://news.ycombinator.com/) - 技术资讯聚合
+- [TechCrunch](https://techcrunch.com/) - 科技新闻
+- [InfoQ](https://www.infoq.cn/) - 技术资讯中文站
+
+### 开发博客
+- [阮一峰的网络日志](http://www.ruanyifeng.com/blog/) - 技术随笔
+- [张鑫旭的博客](https://www.zhangxinxu.com/) - 前端技术
+- [刘未鹏的博客](http://mindhacks.cn/) - 思维与技术
+
+## 书籍推荐
+
+### 编程入门
+- 《Python编程：从入门到实践》
+- 《JavaScript权威指南》
+- 《HTML5与CSS3权威指南》
+
+### 进阶学习
+- 《代码大全》
+- 《重构：改善既有代码的设计》
+- 《设计模式：可复用面向对象软件的基础》
+
+## 持续学习
+
+记住，编程是一门需要持续学习的技能。保持好奇心，多实践，多交流，你一定能成为优秀的程序员！