From 70fbebcedad2d62b4e8ae48dcc963b2ed650433d Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 7 Jul 2025 02:08:41 +0000 Subject: [PATCH 1/2] Initial plan From 74d601da9b9965ee9bf5ea1d0735b8c69c1d291d Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 7 Jul 2025 02:16:02 +0000 Subject: [PATCH 2/2] Complete Jekyll to GitBook migration Co-authored-by: sundevilyang <1499214+sundevilyang@users.noreply.github.com> --- .gitbook.yaml | 26 ++++++++++++ .gitignore | 10 +++++ Gemfile | 23 ---------- README.md | 39 +++++++---------- SUMMARY.md | 16 +++++++ _config.yml | 48 --------------------- appendix/faq.md | 81 +++++++++++++++++++++++++++++++++++ appendix/resources.md | 95 +++++++++++++++++++++++++++++++++++++++++ book.json | 40 ++++++++++++++++++ chapter1/README.md | 25 +++++++++++ chapter2/README.md | 37 ++++++++++++++++ chapter3/README.md | 47 +++++++++++++++++++++ chapter4/README.md | 52 +++++++++++++++++++++++ chapter5/README.md | 70 +++++++++++++++++++++++++++++++ index.md | 98 ------------------------------------------- 15 files changed, 514 insertions(+), 193 deletions(-) create mode 100644 .gitbook.yaml delete mode 100644 Gemfile create mode 100644 SUMMARY.md delete mode 100644 _config.yml create mode 100644 appendix/faq.md create mode 100644 appendix/resources.md create mode 100644 book.json create mode 100644 chapter1/README.md create mode 100644 chapter2/README.md create mode 100644 chapter3/README.md create mode 100644 chapter4/README.md create mode 100644 chapter5/README.md delete mode 100644 index.md diff --git a/.gitbook.yaml b/.gitbook.yaml new file mode 100644 index 0000000..ac8c810 --- /dev/null +++ b/.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 \ No newline at end of file diff --git a/.gitignore b/.gitignore index 6fcf43c..fe49e21 100644 --- a/.gitignore +++ b/.gitignore @@ -1,2 +1,12 @@ # IDE files .idea/ + +# GitBook generated files +_book/ +node_modules/ +*.epub +*.mobi +*.pdf + +# GitBook plugins +.grunt/ diff --git a/Gemfile b/Gemfile deleted file mode 100644 index 603b4d6..0000000 --- a/Gemfile +++ /dev/null @@ -1,23 +0,0 @@ -source "https://rubygems.org" - -gem "github-pages", group: :jekyll_plugins - -group :jekyll_plugins do - gem "jekyll-feed" - gem "jekyll-sitemap" - gem "jekyll-seo-tag" -end - -# Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem -# and associated library. -platforms :mingw, :x64_mingw, :mswin, :jruby do - gem "tzinfo", ">= 1", "< 3" - gem "tzinfo-data" -end - -# Performance-booster for watching directories on Windows -gem "wdm", "~> 0.1.1", :platforms => [:mingw, :x64_mingw, :mswin] - -# Lock `http_parser.rb` gem to `v0.6.x` on JRuby builds since newer versions of the gem -# do not have a Java counterpart. -gem "http_parser.rb", "~> 0.6.0", :platforms => [:jruby] diff --git a/README.md b/README.md index 7261800..2e86e2b 100644 --- a/README.md +++ b/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) - **📱 移动端友好**：支持手机、平板等设备访问 - **🔍 搜索功能**：方便查找特定内容 - **📑 目录导航**：清晰的章节导航 diff --git a/SUMMARY.md b/SUMMARY.md new file mode 100644 index 0000000..81cb9ae --- /dev/null +++ b/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) \ No newline at end of file diff --git a/_config.yml b/_config.yml deleted file mode 100644 index 78d70de..0000000 --- a/_config.yml +++ /dev/null @@ -1,48 +0,0 @@ -# Site settings -title: "Clacky AI 编程入门教程" -description: "专为零基础学习者设计的 AI 辅助编程教程" -baseurl: "/ai-clacky-workshop-tutorial" -url: "https://codinggirlsclub.github.io" - -# Theme -remote_theme: pmarsceill/just-the-docs - -# Search -search_enabled: true - -# Back to top link -back_to_top: true -back_to_top_text: "回到顶部" - -# Footer -footer_content: "Copyright © 2025 Coding Girls Club. 本教程采用 MIT 许可证。" - -# GitHub Pages settings -markdown: kramdown -highlighter: rouge -kramdown: - input: GFM - syntax_highlighter: rouge - -plugins: - - jekyll-remote-theme - - jekyll-feed - - jekyll-sitemap - - jekyll-seo-tag - -# Exclude files from build -exclude: - - docs/ - - .github/ - - Gemfile - - Gemfile.lock - - vendor/ - - README.md - -# Site author -author: - name: "Coding Girls Club" - email: "support@clacky.ai" - -# Social links -github_username: CodingGirlsClub diff --git a/appendix/faq.md b/appendix/faq.md new file mode 100644 index 0000000..e1ee396 --- /dev/null +++ b/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 \ No newline at end of file diff --git a/appendix/resources.md b/appendix/resources.md new file mode 100644 index 0000000..591852c --- /dev/null +++ b/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权威指南》 + +### 进阶学习 +- 《代码大全》 +- 《重构：改善既有代码的设计》 +- 《设计模式：可复用面向对象软件的基础》 + +## 持续学习 + +记住，编程是一门需要持续学习的技能。保持好奇心，多实践，多交流，你一定能成为优秀的程序员！ \ No newline at end of file diff --git a/book.json b/book.json new file mode 100644 index 0000000..d5ebd85 --- /dev/null +++ b/book.json @@ -0,0 +1,40 @@ +{ + "title": "Clacky AI 编程入门教程", + "description": "专为零基础学习者设计的 AI 辅助编程教程", + "author": "Coding Girls Club", + "language": "zh-hans", + "gitbook": ">=3.0.0", + "structure": { + "readme": "README.md", + "summary": "SUMMARY.md" + }, + "plugins": [ + "theme-default", + "search", + "lunr", + "fontsettings", + "theme-comscore", + "-sharing", + "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 + } + }, + "variables": { + "host": "https://codinggirlsclub.github.io/ai-clacky-workshop-tutorial/" + } +} \ No newline at end of file diff --git a/chapter1/README.md b/chapter1/README.md new file mode 100644 index 0000000..46916c3 --- /dev/null +++ b/chapter1/README.md @@ -0,0 +1,25 @@ +# 第一章：开始之前 + +欢迎来到 Clacky AI 编程入门教程！在开始编程之旅之前，我们需要了解一些基础知识。 + +## 本章内容 + +- 什么是编程 +- 为什么选择 AI 辅助编程 +- Clacky AI 平台介绍 +- 学习目标和预期成果 + +## 什么是编程 + +编程是用计算机语言告诉计算机如何完成特定任务的过程。就像我们用自然语言与人交流一样，我们用编程语言与计算机交流。 + +## 为什么选择 AI 辅助编程 + +- **降低学习门槛**：AI 可以帮助解释复杂概念 +- **提供实时帮助**：遇到问题时立即获得指导 +- **加快开发速度**：自动化常见任务 +- **最佳实践指导**：学习行业标准的编码方式 + +## 准备开始 + +在下一章中，我们将设置开发环境，为实际编程做准备。 \ No newline at end of file diff --git a/chapter2/README.md b/chapter2/README.md new file mode 100644 index 0000000..3f34d27 --- /dev/null +++ b/chapter2/README.md @@ -0,0 +1,37 @@ +# 第二章：环境准备 + +在开始编程之前，我们需要准备好开发环境。这一章将指导你完成所有必要的设置。 + +## 本章内容 + +- 注册 Clacky AI 账户 +- 连接 GitHub 账户 +- 设置开发环境 +- 熟悉 Clacky AI 界面 + +## 注册 Clacky AI 账户 + +1. 访问 [Clacky AI 官网](https://clacky.ai) +2. 点击注册按钮 +3. 填写基本信息 +4. 验证邮箱 + +## 连接 GitHub 账户 + +GitHub 是全球最大的代码托管平台，我们将用它来： +- 存储你的代码 +- 版本控制 +- 分享你的项目 + +### 步骤： +1. 注册 GitHub 账户（如果还没有） +2. 在 Clacky AI 中连接 GitHub +3. 授权必要的权限 + +## 开发环境设置 + +Clacky AI 为你提供了云端开发环境，无需本地安装任何软件。 + +## 下一步 + +环境准备完成后，我们将在下一章学习编程的基础概念。 \ No newline at end of file diff --git a/chapter3/README.md b/chapter3/README.md new file mode 100644 index 0000000..6ba69c0 --- /dev/null +++ b/chapter3/README.md @@ -0,0 +1,47 @@ +# 第三章：基础概念 + +在这一章中，我们将学习编程的基础概念，为实际开发做好理论准备。 + +## 本章内容 + +- 编程语言简介 +- 基本数据类型 +- 变量和常量 +- 控制结构 +- 函数和方法 + +## 编程语言简介 + +编程语言是人与计算机沟通的桥梁。常见的编程语言包括： + +- **Python**：简单易学，适合初学者 +- **JavaScript**：网页开发必备 +- **HTML/CSS**：网页结构和样式 +- **SQL**：数据库查询语言 + +## 基本数据类型 + +- **数字**：整数和小数 +- **字符串**：文本内容 +- **布尔值**：真或假 +- **列表/数组**：数据集合 + +## 变量和常量 + +变量是存储数据的容器，就像给数据贴上标签： + +```python +name = "小明" # 字符串变量 +age = 25 # 数字变量 +is_student = True # 布尔变量 +``` + +## 控制结构 + +- **条件语句**：if/else +- **循环语句**：for/while +- **函数**：可重复使用的代码块 + +## 实践准备 + +理解了这些基础概念后，我们就可以开始编写第一个程序了！ \ No newline at end of file diff --git a/chapter4/README.md b/chapter4/README.md new file mode 100644 index 0000000..9709a42 --- /dev/null +++ b/chapter4/README.md @@ -0,0 +1,52 @@ +# 第四章：第一个程序 + +恭喜你来到实践阶段！在这一章中，我们将创建你的第一个程序。 + +## 本章内容 + +- 创建第一个项目 +- 编写 "Hello World" 程序 +- 理解代码结构 +- 运行和测试程序 +- 调试基础 + +## 创建第一个项目 + +1. 在 Clacky AI 中创建新项目 +2. 选择合适的编程语言（推荐 Python） +3. 设置项目名称和描述 + +## Hello World 程序 + +这是编程界的传统第一个程序： + +```python +print("Hello, World!") +print("你好，世界！") +``` + +## 代码解析 + +- `print()` 是一个函数，用于显示文本 +- 引号内的内容是字符串 +- 每行代码执行一个操作 + +## 运行程序 + +1. 点击运行按钮 +2. 查看输出结果 +3. 尝试修改文本内容 + +## 常见错误 + +- 忘记引号 +- 拼写错误 +- 缩进问题 + +## 练习 + +尝试修改程序，让它显示你的名字和年龄。 + +## 下一步 + +掌握了基本程序后，我们将学习更多进阶技巧！ \ No newline at end of file diff --git a/chapter5/README.md b/chapter5/README.md new file mode 100644 index 0000000..c20bc05 --- /dev/null +++ b/chapter5/README.md @@ -0,0 +1,70 @@ +# 第五章：进阶技巧 + +在掌握了基础编程知识后，让我们学习一些进阶技巧，提升你的编程能力。 + +## 本章内容 + +- 面向对象编程 +- 错误处理 +- 文件操作 +- 网络编程基础 +- 项目组织和管理 + +## 面向对象编程 + +面向对象编程（OOP）是一种重要的编程范式： + +```python +class Student: + def __init__(self, name, age): + self.name = name + self.age = age + + def introduce(self): + print(f"我是{self.name}，今年{self.age}岁") + +# 创建学生对象 +student = Student("小明", 20) +student.introduce() +``` + +## 错误处理 + +学会处理程序中的错误： + +```python +try: + number = int(input("请输入一个数字：")) + result = 10 / number + print(f"结果是：{result}") +except ValueError: + print("输入的不是有效数字！") +except ZeroDivisionError: + print("不能除以零！") +``` + +## 文件操作 + +读写文件是常见需求： + +```python +# 写文件 +with open("data.txt", "w", encoding="utf-8") as file: + file.write("这是我的第一个文件！") + +# 读文件 +with open("data.txt", "r", encoding="utf-8") as file: + content = file.read() + print(content) +``` + +## 最佳实践 + +- 编写清晰的注释 +- 使用有意义的变量名 +- 保持代码简洁 +- 定期备份代码 + +## 项目实战 + +完成一个完整的小项目，综合运用所学知识。 \ No newline at end of file diff --git a/index.md b/index.md deleted file mode 100644 index 0617ac8..0000000 --- a/index.md +++ /dev/null @@ -1,98 +0,0 @@ ---- -layout: default -title: 首页 -nav_order: 1 -description: "Clacky AI 编程入门教程 - 专为零基础学习者设计的 AI 辅助编程教程" -permalink: / ---- - -# Clacky AI 编程入门教程 - -## 🌟 项目简介 - -这是一套专门为**完全编程初学者**设计的 Clacky AI 工作坊教程。通过这套教程，零基础的学习者可以学会使用 Clacky AI 这个强大的 AI 编程助手来创建自己的第一个应用程序。 - -### 🎯 教程特色 - -- **零基础友好**：专为完全没有编程经验的初学者设计 -- **中文教学**：全中文内容，理解无障碍 -- **实践导向**：通过实际项目学习，看得见成果 -- **循序渐进**：从基础概念到高级应用，步步深入 -- **完整体系**：包含理论学习、实践练习、问题解答 - ---- - -## 🚀 快速开始 - -### 🎯 注册 Clacky AI - -在开始学习之前，你需要先注册 Clacky AI 账户： - -**🔗 [立即申请 Clacky AI](https://clacky.ai/beta?source=source_coding_girls_club-medium_community-campaign_beta_launch)** - -> 💡 **特别说明**：这是 Clacky AI 专门为 **Coding Girls Club 程序媛汇** 提供的专属申请链接。活动期间使用此链接申请，将获得优先审批，且审批通过率更高。 - -### 📚 选择你的学习路径 - -- **📖 [开始教程]({{ site.baseurl }}/tutorial/)** - 系统性学习完整教程 -- **🎨 [查看作品]({{ site.baseurl }}/student-works/)** - 浏览其他学员的优秀作品 -- **🚀 [提交作品]({{ site.baseurl }}/student-works/submit-prompt/)** - 完成学习后分享你的项目 - ---- - -## 🎯 学习目标 - -完成这套教程后，你将能够： - -- ✅ 熟练使用 Clacky AI 进行项目开发 -- ✅ 理解现代 Web 开发的基本概念 -- ✅ 独立创建响应式网页应用 -- ✅ 掌握项目部署和发布流程 -- ✅ 具备需求分析和项目规划能力 -- ✅ 掌握与 AI 高效协作的技巧 - ---- - -## 🏆 成功案例 - -### 👨‍💻 学习者反馈 - -> "作为一个完全的编程小白，这套教程让我在两周内就创建了自己的第一个网站。AI 辅助编程真的降低了学习门槛！" - 张同学 - -> "教程内容很系统，从基础概念到实际项目，循序渐进。现在我已经可以独立开发简单的 Web 应用了。" - 李同学 - ---- - -## 🎨 精选学员作品 - -### 🏔️ [大理站]({{ site.baseurl }}/student-works/dali/) - 首发站点 - -来自苍山洱海边的学员精彩作品展示 - -### 🌟 更多城市作品 - -- 🏙️ **北京站** | 🏢 **上海站** | 🌸 **成都站** - 即将开放 - -> 💡 **想要展示你的作品？** 使用我们的 [一键提交工具]({{ site.baseurl }}/student-works/submit-prompt/) 让 Clacky AI 帮你自动提交！ - ---- - -## 🚀 开始你的编程之旅 - -**准备好了吗？** 让我们从 [教程目录]({{ site.baseurl }}/tutorial/) 开始，踏上 AI 辅助编程的学习之旅！ - -记住：每个专业的程序员都是从第一行代码开始的。有了 Clacky AI 的帮助，你的编程之路将更加顺畅和有趣！ - -**🌟 祝你学习愉快，编程成功！** 🎉 - ---- - -## 🤝 获取帮助 - -- 📖 [Clacky AI 官方文档](https://docs.clacky.ai) -- 📧 官方邮箱：support@clacky.ai -- 📄 [MIT 许可证](https://github.com/CodingGirlsClub/ai-clacky-workshop-tutorial/blob/main/LICENSE) - ---- - -_最后更新：2025 年 7 月 6 日_