手把手探索中国独立开发者项目

本章我们要一起揭开 chinese-independent-developer 这个项目的神秘面纱，通过了解它的背景、结构以及如何参与其中，让你对这个平台有一个全面的认识。读完这章后，你会知道这个项目的目的、它的主要组成部分是什么，并且明白怎么提交自己的作品。

首先，你需要确保自己已经访问到了 chinese-independent-developer 项目的主页。你可以通过浏览器打开项目的 GitHub 页面来实现这一点。

我们先来看看这个项目存在的意义。作为一个开发者，你可能经常会想看看别人在做些什么有趣的业余项目。无论是为了学习新技能、寻找灵感还是仅仅出于好奇心，了解这些项目都能带来不少乐趣。因此，有人专门创建了这个项目库，鼓励大家将自己的作品分享出来。

接着，我们来看一下项目的整体结构。整个项目可以分为几个不同的部分：

• 主版面：这里收录的产品是可以直接使用的。
• 程序员版面：这部分的内容需要一定的技术知识才能理解和使用。
• 游戏版面：顾名思义，这里是各种游戏相关的项目。
• 历史项目列表：由于 GitHub 对渲染有一些限制，一些较早的项目被单独存档在这里。

如果你遇到... 比如不知道某个术语的意思或者不明白某些分类的具体内容怎么办？别担心，我们可以随时查找文档或者提问社区里的其他成员来获得帮助。

举个例子来说，假设你想找到一些适合初学者的游戏项目来进行参考学习。你就可以先去游戏版面浏览一下现有的游戏列表，并根据描述选择一个看起来感兴趣的项目进行深入研究。

最后，在加入这个社区之前还有一点非常重要需要注意：当你想要提交自己的项目时，请确保它是符合要求的网站或应用程序形式，并且最好能提供一个简洁明了的产品介绍语。

本章小结

• 我们了解了 chinese-independent-developer 项目的起源及其存在的价值。
• 学习了该项目的主要组成部分及其各自的用途。
• 注意到在提交个人作品时应该遵循的一些基本规则和建议。

本章我们要一起探索 chinese-independent-developer 项目中的不同类型，看看有哪些有趣的作品可以参考和学习。通过本章的学习，你会知道如何在各个版面中找到合适的内容。

首先，我们需要确保你已经访问了项目的主页，并且对项目的整体结构有所了解。如果你还没有看过上一章的内容，没关系，我们先快速回顾一下主要版面：

• 主版面：收录可以直接使用的项目。
• 程序员版面：包含需要一定技术知识的项目。
• 游戏版面：汇集各种游戏相关的项目。
• 历史项目列表：存放较早的项目。

我们先从主版面开始浏览。打开浏览器，输入以下地址进入项目主页：

https://github.com/1c7/chinese-independent-developer

你会看到一个目录结构，其中包含了不同的子页面链接。我们先点击“程序员版面”，看看有哪些技术性的项目。这个页面的 URL 是：

https://github.com/1c7/chinese-independent-developer/blob/main/pages/README-Programmer-Edition.md

在这个页面上，你可以看到很多需要编程知识才能理解或使用的项目。例如：

* :clock8: [AutoGit](https://autogit.dev)：自动化的 Git 版本控制工具 - [更多信息](https://github.com/user/AutoGit)

这里的 :clock8: 符号表示这个项目还在开发中。

接着，我们切换到“游戏版面”，看看有哪些好玩的游戏项目。这个页面的 URL 是：

https://github.com/1c7/chinese-independent-developer/blob/main/pages/README-Game.md

在这个页面上，你可以找到许多不同类型的游戏。比如：

* :white_check_mark: [SpacePilot](http://spacepilot.game)：一款太空冒险游戏 - [查看源码](https://github.com/user/spacepilot)

这里的 :white_check_mark: 符号表示这个游戏已经上线并且可以玩了。

如果你对早期的项目感兴趣，可以访问“2018 ~ 2020 年项目列表”。这个页面的 URL 是：

https://github.com/1c7/chinese-independent-developer/blob/main/pages/README-2018-2020.md

在这个页面上，你会发现一些因为 GitHub 渲染限制而单独存档的老项目。比如：

* :x: [OldProject](http://oldproject.example)：一个已经停止维护的老项目 - [旧仓库](https://github.com/user/OldProject)

这里的 :x: 符号表示这个项目不再活跃或已经被关闭。

你可能会好奇为什么会有这么多符号标记项目的状态？这是因为每个项目的进度和状态都不一样，这样的标记可以帮助我们快速了解哪些是可以立即使用的、哪些还在开发中、哪些可能已经废弃了。

举个例子来说，如果你想找一个适合初学者的游戏来学习编程，你可以在“游戏版面”里寻找带有 :white_check_mark: 标记的游戏，并尝试下载或在线体验它们的代码库。

希望通过这章的学习，你能更好地熟悉 chinese-independent-developer 项目的各个部分，并能找到对你有帮助的内容。

本章小结

• 我们学会了如何在主版面、程序员版面、游戏版面和历史项目列表之间导航。
• 理解了不同状态下项目的标记含义。
• 找到了一些具体实例来练习浏览和筛选信息的能力。

本章我们要学会怎么写出吸引人的项目介绍，这样别人一看就知道你的项目是什么、有什么特别之处。通过这章的学习，你会能够自信地提交自己的项目介绍给 chinese-independent-developer 项目。

在开始之前，请确保你已经在 GitHub 上注册了一个账号，并且对基本的 Git 操作有所了解，比如克隆仓库、创建分支和提交更改。

我们先从理解一个好的项目介绍应该包含哪些元素开始。一个好的项目介绍通常包括以下几个部分：

1. 项目名称：简洁明了。
2. 项目描述：简单概括项目的功能和用途。
3. 技术栈：使用的技术和工具。
4. 安装指南：如果有人想运行你的项目，他们需要知道怎么做。
5. 使用方法：详细说明如何使用你的项目。
6. 贡献指南：鼓励他人参与贡献的方法。
7. 联系信息：方便其他人找到你或者向你提问。

接着，我们来看一个具体的例子。假设你要添加一个名为 "MyCoolApp" 的应用到 chinese-independent-developer 项目中。以下是你可以参考的一个模板：

# MyCoolApp

## 项目描述
MyCoolApp 是一款可以让用户轻松管理日常任务的应用程序。无论你是学生、上班族还是自由职业者，都可以通过这款应用高效地安排时间、记录待办事项和跟踪进度。

## 技术栈
- 前端: React.js, Redux
- 后端: Node.js, Express
- 数据库: MongoDB

## 安装指南
1. 克隆仓库:
   ```bash
   git clone https://github.com/yourusername/mycoolapp.git
   cd mycoolapp

2. 安装依赖:

   npm install

3. 启动应用:

   npm start

使用方法

1. 打开浏览器访问 http://localhost:3000.
2. 注册或登录账户。
3. 创建新的任务列表或选择现有列表进行编辑。
4. 添加任务项并设置截止日期。

贡献指南

欢迎任何形式的贡献！如果你想报告问题、提出建议或修复 bug，请按照以下步骤操作：

1. Fork 这个仓库。
2. 创建一个新的分支 (git checkout -b feature/AmazingFeature)。
3. 提交你的更改 (git commit -m 'Add some AmazingFeature')。
4. 推送到分支 (git push origin feature/AmazingFeature)。
5. 打开一个 Pull Request.

联系信息

如果你有任何问题或想要合作，请通过电子邮件联系我们: contact@mycoolapp.com 或者访问我们的 GitHub 页面.

如果你遇到任何困难，比如不知道如何编写某些部分或者格式有问题，可以参考 `chinese-independent-developer` 项目的 [CONTRIBUTING.md](https://github.com/1c7/chinese-independent-developer/blob/main/CONTRIBUTING.md)，里面有很多有用的指导信息。

举个例子来说，假设你想为 `chinese-independent-developer` 添加一个名为 "SimpleNote" 的笔记应用。根据上面的模板，你可以这样写：

```markdown
# SimpleNote

## 项目描述
SimpleNote 是一款轻量级的笔记应用程序，支持富文本编辑、标签分类以及云同步功能。适用于个人知识管理和团队协作。

## 技术栈
- 前端: Vue.js, Vuex
- 后端: Django REST Framework
- 数据库: PostgreSQL

## 安装指南
1. 克隆仓库:
   ```bash
   git clone https://github.com/yourusername/simplenote.git
   cd simplenote

2. 安装依赖:

   pip install -r requirements.txt && npm install --legacy-peer-deps # 解决一些包冲突的问题 

3. 配置数据库: 编辑 .env 文件中的数据库连接字符串。
4. 启动后端服务:

   python manage.py migrate && python manage.py runserver 

5. 启动前端服务:

   npm run serve 

使用方法

1. 打开浏览器访问 http://localhost:8080.
2. 注册或登录账户。
3. 创建新笔记或编辑已有笔记内容。
4. 使用标签系统组织笔记以便查找。

贡献指南

详见 CONTRIBUTING.md.

联系信息

如有疑问，请发送邮件至 support@simplenote.com 或访问 GitHub 页面.

本章小结：
- 学会了如何撰写全面而吸引人的项目介绍。
- 理解了每个部分的重要性及其作用。
- 参考了实际的例子来练习写作技能。

本章我们要学习如何将自己的项目添加到「chinese-independent-developer」项目列表中，这样可以让更多的人看到你的作品。通过这章的学习，你不仅能够成功提交项目，还能确保你的介绍清晰明了，吸引潜在用户或合作者。

前置条件

在开始之前，请确保你已经完成了以下几步：

1. 完成了项目的开发，并且有一个可以展示的成果（比如网站或 App）。
2. 在本地安装并配置好了 chinese-independent-developer 项目所需的依赖和服务（如数据库和前后端服务）。
3. 拥有一个 GitHub 账号，并熟悉基本的操作流程。

第一步：准备项目介绍

首先，我们需要编写一个吸引人的项目介绍。一个好的介绍应该简洁明了，同时包含足够的信息让用户明白项目的用途和亮点。

例如：

# KinMate
本地优先的家庭健康档案库，把全家人（含宠物）的化验单、病历、体检报告集中安全地存在自己设备上；AI 用大白话帮你读懂每项指标是什么、是否正常，全部数据不出本机、不上传云端。

这里我们用了简单易懂的语言描述了 KinMate 的主要功能和优势。

第二步：选择合适的子版面

根据你的项目的特性选择合适的子版面提交。以下是可供选择的几个选项：

子版面	描述
程序员版面	使用需要命令行或写代码
游戏版面	都是游戏
2018 ~ 2020 年项目列表	因 GitHub 渲染限制单独存档

假设我们的 KinMate 是一个家庭健康管理应用，更适合放在主版面而不是程序员版面或者游戏版面。

第三步：创建一个新的 Issue 或 Pull Request

你可以通过两种方式提交项目：

1. Issue: 如果只是想提出建议或者讨论某个想法，可以创建一个新的 Issue。
2. Pull Request (PR): 如果已经有了具体的修改内容（如新增了一个项目），则应创建 PR。

在这里我们选择使用 Pull Request 来提交我们的项目。

具体操作步骤如下：

1. 打开 chinese-independent-developer 项目的主页。
2. 点击页面右上的 "Fork" 按钮，在你的 GitHub 上创建一个副本。
3. 进入你 Fork 出来的仓库页面，点击 "Code" -> "Open with GitHub Desktop" 或者下载 ZIP 文件手动解压到本地。
4. 在本地克隆仓库后进入文件夹 projects 中找到相应的子目录（这里是主目录），然后新建一个 Markdown 文件命名格式为 [用户名]-[项目名].md （例如 EloLin-KinMate.md）。
5. 编辑刚才新建的 Markdown 文件，在里面按照上面提供的模板填写你的项目介绍和其他相关信息。
6. 提交更改到你的 Fork 库：

   git add projects/EloLin-KinMate.md
   git commit -m "Add project EloLin/KinMate"
   git push origin main

7. 最后回到你在 GitHub 上的 Fork 页面，点击 "Compare & pull request" 按钮发起合并请求。在 PR 描述框中简要说明你做了哪些改动，并等待原项目的维护者审核批准。

注意事项

• 确保你的项目符合入选标准：必须是网站或 App 类型的内容。
• 写作时注意语法规范和排版整洁性，尽量减少拼写错误和语法问题。
• 对于图片资源等媒体文件，请上传至项目的 assets/images 目录下，并正确引用路径地址。

通过以上步骤你应该已经能够顺利地向「chinese-independent-developer」提交自己的独立开发作品啦！

本章小结：

• 学习了如何准备详细的项目介绍文本。
• 掌握了如何根据项目的特性和目的选择适合的提交渠道（Issue 或 PR）。
• 实践了整个从 fork 到 pull request 的完整工作流过程。

本章我们要聊聊项目的状态，这样你就能更好地理解自己提交的项目会被如何分类展示给其他人。读完这一章后，你会知道如何为你的项目选择合适的状态标签。

在开始之前，确保你已经完成了上一章的所有步骤，包括编辑并提交了你的项目介绍文件，并且成功发起了一个 pull request。

首先，我们需要了解一下为什么会有不同的项目状态。就像你在学校里会有作业未完成、已完成和被老师批改的情况一样，这里的项目也有三种状态：开发中、已上线和已关闭或缺乏维护。这些状态帮助访问者快速了解项目的进展程度。

项目状态详解

状态	符号	含义
开发中	:clock8:	项目还在建设中
已上线	:white_check_mark:	项目已经可以正常使用
已关闭或缺乏维护	:x:	项目不再更新或者停止运营

开发中 (:clock8:)

这个状态表示你的项目还没有完全完成，可能还处于原型阶段或者是功能还不完善。就像是你正在制作一道菜，但是还没做好就可以贴上这个标签。

已上线 (:white_check_mark:)

当你觉得你的项目已经足够稳定并且用户可以正常使用的时候，你可以把这个状态改为已上线。这就好比你做了一道菜，并且确认味道不错了，就可以端出去给大家吃了。

已关闭或缺乏维护 (:x:)

有时候因为各种原因（比如失去了兴趣、找到了更好的替代品等），你可能决定不再继续开发某个项目。这时候就需要把它的状态改成已关闭或缺乏维护。就像是一盘你喜欢的游戏突然宣布停服了。

如何设置项目的状态？

在 projects 文件夹下的 Markdown 文件中，你需要找到一行类似于下面这样的内容：

status:

然后根据你的项目的实际情况，在冒号后面填入对应的状态符号：

• 如果你的项目还在开发中，请填写 :clock8:。
• 如果你的项目已经上线并且正常运行，请填写 :white_check_mark:。
• 如果你的项目不再维护或者已经关闭，请填写 :x:。

例如：

status: :white_check_mark:

这意味着你的项目的当前状态是“已上线”。

小例子

假设你现在有一个名为 “My Awesome App”的应用正在开发中，并且你希望把它添加到这个列表里。那么你应该这么写：

---
name: My Awesome App
link: https://myawesomeapp.com/
description: 这是一个非常棒的应用程序！它可以帮你轻松管理日常任务。
status: :clock8:
tags:
  - 生产力工具
  - 日程管理
---

在这个例子中，“status” 被设置成了 :clock8:，表明这是一个仍在开发中的项目。

常见问题及解决方案

如果你不小心选择了错误的状态怎么办？别担心！你可以随时修改这个字段并再次提交更改。记得每次修改之后都要重新发起一个新的 pull request 来更新信息哦。

另外，在选择状态时一定要诚实反映项目的实际状况。如果一个明明没有完成的项目被标记为“已上线”，那可能会误导别人对项目的期望值。

本章小结：

• 学习了什么是项目的三种不同状态及其含义。
• 知道了如何在 Markdown 文件中标记项目的当前状态。
• 明白了为什么准确标注项目的进度非常重要，并学会了如何进行相应的操作。

本章我们要探索的是“程序员版面”。通过这一部分，你会了解到哪些项目更适合喜欢编程和技术的开发者，并学习如何在这个版面找到感兴趣的内容。读完这章后，你就能更好地利用这个资源来发现和参与有趣的项目了。

在开始之前，请确保你已经完成了上一章的操作，并且你的项目已经在主版面上有了初步的信息展示。

我们先来看看程序员版面到底是什么。程序员版面专门收集那些需要使用命令行或者编写代码的项目。这里有很多有趣的想法和技术实践等待着热爱编程的人去发掘和贡献。

第一步：访问程序员版面

首先，我们需要进入程序员版面的具体页面。打开浏览器，输入以下地址：

https://github.com/1c7/chinese-independent-developer/blob/main/pages/README-Programmer-Edition.md

点击回车键后，你应该能看到一个包含多个项目的列表页。

第二步：浏览项目列表

在程序员版面上，你会看到许多不同的项目。这些项目通常包括以下几个部分：

• 名称 (Name)：项目的简称。
• 链接 (Link)：通向该项目主页或仓库的链接。
• 描述 (Description)：关于项目的简单介绍。
• 状态 (Status)：项目的当前阶段（开发中、已上线、已关闭）。
• 标签 (Tags)：帮助分类和查找项目的关键词。

举个例子，假设有一个名为 "AutoScript" 的自动化脚本工具，它的条目可能看起来像这样：

---
name: AutoScript
link: https://github.com/example/AutoScript
description: 自动化执行常见的电脑任务，提高工作效率。
status: :white_check_mark:
tags:
  - 自动化工具
  - 效率提升
---

第三步：筛选感兴趣的项目

既然已经有了这么多项目信息摆在面前，我们可以根据自己的兴趣来进行筛选。比如你喜欢数据分析相关的项目，就可以寻找带有 数据处理 或 分析工具 标签的条目。

如果你想参与某个项目的开发工作，可以查看其状态是否为 开发中 (:clock8:)。如果是的话，就有可能有机会成为其中的一员！

第四步：进一步了解具体项目

当你找到了几个感兴趣的目标后，不妨深入了解一下它们的工作原理和技术栈。点击每个项目的链接，跳转到其主页或仓库页面。在那里你可以找到更多详细信息以及如何参与到这个项目中的方法。

如果你遇到不懂的技术名词或术语别担心！可以通过搜索引擎查询相关知识或者询问社区内的其他成员来获取帮助。

实用技巧

• 使用 GitHub 的搜索功能可以帮助你更快地定位到自己感兴趣的领域。尝试在搜索框内输入关键字加上 in:readme 来缩小范围。

  比如你想找一些 Python 相关的自动化脚本工具：

  python automation in:readme

• 关注活跃度高的仓库也是一个不错的选择。可以通过查看最近的 commit 和 issue 数量来判断一个项目的热度。

小例子

想象一下你现在是一名前端开发者，并且对 React 技术特别感兴趣。你来到程序员版面后决定筛选所有与 React 相关的开源项目：

1. 打开程序员版面页面。
2. 浏览整个列表并留意带有 React 标签的条目。
3. 点击其中一个名为 "ReactGallery" 的图片库项目的链接。
4. 查看该仓库的 README 文件和其他文档以了解更多细节。
5. 如果觉得这个项目很吸引人并且想参与进来，则可以继续查阅贡献指南并按照指示操作。

本章小结：

• 学会了如何访问和浏览程序员版面中的各种技术类项目。
• 掌握了一些基本的方法来筛选符合个人兴趣爱好的开源作品。
• 理解了进一步研究和加入这些项目的途径及注意事项。

本章我们要一起探索游戏版面，看看有哪些有趣的游戏项目是由中国的独立开发者创作的。通过学习如何浏览和筛选游戏项目，你可以找到自己感兴趣的作品甚至参与到其中。

首先，确保你已经打开了 chinese-independent-developer 项目的主页，并且熟悉了如何在 GitHub 上浏览文件和仓库的基本操作。

第一步：进入游戏版面

我们先点击主页上的“游戏版面”链接。这一步很简单，就像你在图书馆找到了一本新书一样。

点击页面上的“游戏版面”链接。

预期结果：你会看到一个新的页面，专门列出了一系列的游戏项目。

第二步：浏览游戏项目列表

接着，在游戏版面上浏览所有的项目。这里列出了很多由独立开发者制作的游戏，包括他们的名字、状态以及简短的描述。就像是在一个玩具店里看各种各样的玩具一样。

查看页面上列出的所有游戏项目。

预期结果：你会看到多个游戏项目的名称、状态图标（比如开发中、已上线等）以及它们的简短介绍。

第三步：选择一个感兴趣的项目

如果你遇到不懂的技术名词或术语别担心！可以通过搜索引擎查询相关知识或者询问社区内的其他成员来获取帮助。假设你对一款叫做 "Pixel Quest" 的像素风冒险游戏很感兴趣，我们可以进一步了解一下它。

点击 "Pixel Quest" 项目的链接。

预期结果：你会被带到该项目的具体页面，可以看到更多关于这个游戏的信息，例如玩法介绍、下载地址等。

第四步：查看项目的详细信息

在这个页面上，你可以看到项目的详细介绍、截图、视频演示以及其他相关信息。这些都是了解一个游戏的好方法，就像在书店里翻阅一本书的内容提要一样。

仔细阅读 README 文件和其他文档。

预期结果：你应该能够了解到这款游戏的主要特点、开发背景以及如何体验它。

小例子

想象一下你现在是一名喜欢玩游戏的人，并且对像素风格的游戏特别感兴趣。你来到了 game 版面后决定筛选所有与像素风格相关的游戏：

1. 打开 game 版面页面。
2. 浏览整个列表并留意带有 pixel 或 retro 标签的条目。
3. 点击其中一个名为 "Pixel Quest" 的冒险游戏项目的链接。
4. 查看该仓库的 README 文件和其他文档以了解更多细节。
5. 如果你觉得这个游戏很吸引人并且想玩一玩，则可以按照提供的下载地址安装体验。
6. 如果你还想了解更多的开发细节或者想要参与进来，则可以继续查阅贡献指南并按照指示操作。

本章小结：

• 学会了如何访问和浏览 game 版面中的各种游戏项目。
• 掌握了一些基本的方法来筛选符合个人兴趣爱好的游戏作品。
• 理解了进一步研究和体验这些项目的途径及注意事项。

如何提交我的项目到列表？

要将您的项目添加到“中国独立开发者项目列表”，您可以按照以下步骤操作：

1. Fork 本仓库。
2. 在相应的子版面或主版面添加您的项目信息。
3. 提交 Pull Request 或创建一个 Issue。

项目的入选标准是什么？

入选标准包括：

• 必须是网站或App，不能是开发者工具或论坛型网站。
• 提供清晰的一句话产品介绍，帮助他人快速理解项目的价值。

如果我有一个正在开发中的项目可以加入吗？

当然可以。请在提交时选择“开发中”状态，并确保您的项目符合入选标准。

如何写好一句话产品介绍？

编写好的一句话产品介绍应该能够清楚地传达项目的用途和核心价值。例如，“无需剪辑经验，3 步生成竖屏短视频”相比“AI 视频生成工具”更具有吸引力和实用性。

我的项目已经上线了，但最近没有更新，会影响入选吗？

不会影响。只要您的项目曾经上线并且符合其他入选标准，就可以被收录。不过建议保持项目的活跃度以吸引更多的关注和支持。

这个项目列表与其他类似的聚合平台有何区别？

与其他聚合平台相比，“中国独立开发者项目列表”专注于中国的独立开发者作品，并且细分了不同的子版面（如程序员版面、游戏版面等），方便用户根据兴趣查找相关项目。

有哪些常见的错误需要注意避免？

在提交项目时，请注意以下几点：

• 不要遗漏必要的信息，如项目名称、链接、简介等。
• 确保提供的链接是有效的，并指向正确的资源。
• 遵循 Markdown 格式的书写规范，使内容更加整齐易读。