verto.sh

您的开源协作之门。

<p align="center"> <img src="https://yellow-cdn.veclightyear.com/0a4dffa0/22930910-4bb2-4c47-be32-0b95a68c45fd.png" width="100%"/> </p>

---

通过verto.sh步入开源世界！我们精心挑选出具有易于处理问题的热门项目，让开发者能轻松找到新的或首个可贡献的项目。verto.sh不仅仅是一个列表——它是一个平台。这里是新手可以做出首次贡献的地方，创始人可以建立坚实的团队，维护者可以找到新的贡献者。

开源社区始终欢迎新人才，但入门可能会感到困难。verto.sh让这一过程变得更加简单。通过向新人展示入门之路并将他们与需要帮助的项目连接起来，我们不仅帮助个人，也在帮助整个开源运动。

借助verto.sh，迈出协作编码的第一步，成为更伟大事业的一部分。您今天的代码可能成为开源社区中令人惊叹事物的开端。

添加新项目

欢迎您在verto.sh中添加新项目，只需遵循以下步骤：

• 为了保持verto.sh中项目的质量，请确保您要添加的仓库满足以下标准：

  • 对于GitHub仓库：至少有三个带有good first issue标签或config.json中定义的其他标签的问题（参见GitHub提供者末尾的labels）。

  • 对于GitLab仓库：至少有三个带有quick win标签或config.json中定义的其他标签的问题（参见GitLab提供者末尾的labels）。

  • 至少有10个贡献者。

  • 至少有1000个星标。

  • 包含详细的项目设置说明的README.md文件，以及针对新贡献者的指南CONTRIBUTING.md文件。

  • 处于积极维护状态（最后更新时间不超过1个月）。

• 对于GitHub仓库：将您的仓库路径（格式为owner/name并按字典顺序排列）添加到config.json中的GitHub提供者内。

• 对于GitLab仓库：将您的仓库ID（格式为<project path>|<project id>）添加到config.json中的GitLab提供者内。

• 创建一个新的拉取请求。请在PR描述中添加仓库问题页面的链接。一旦拉取请求被合并，更改将在verto.sh上生效。

它是如何工作的？

verto.sh使用Next.js、React和Typescript。网站上显示的数据从data.json文件加载，该文件由data/utils.ts中的函数生成。它查询GitHub和GitLab API，从config.json中列出的仓库获取问题。config.json中定义的标签用于筛选仓库的问题。

如何在本地设置项目

要为网站贡献新功能和更改，您需要在本地运行应用程序。请按照以下步骤操作：

1. 分叉仓库，在本地克隆它，创建一个新分支以处理特定功能或错误修复，而不影响仓库的主分支。确保您的计算机上安装了最新版本的Node.js。
2. 您可以使用包含的data.json作为虚拟数据，或者运行npm run prebuild自行从GitHub获取最新数据：为此，您需要将GH_PAT环境变量设置为有效的GitHub个人访问令牌（PAT）。注意：当data.json脚本运行时，不符合上述标准的仓库（参见data.json中的规则）会自动从config.json中删除。
3. 启动开发服务器并在浏览器中打开应用程序。

# 安装依赖
$ npm install
# "安装"您的配置文件（默认）
./scripts/init.sh default
# "安装"您的配置文件（cncf）
./scripts/init.sh cncf
# 启动开发服务器
$ npm run dev

提交时需要注意：项目包含一个pre-commit钩子，会自动运行代码检查工具以确保代码质量！