verto

Verto.Sh

您通往開源協作的門戶。

---

使用Verto.sh進入開源世界！我們仔細挑選出易於捕撈問題的受歡迎的項目，使開發人員可以簡單地找到一個新的或第一個項目可以做出貢獻。 Verto.SH不僅僅是列表，它是一個平台。在這裡，初學者可以做出第一個貢獻，創始人可以建立一個堅實的團隊，並且維護者可以找到新的貢獻者。

開源社區總是歡迎新的人才，但是入門會感到艱難。 Verto.SH使其更容易。通過向新移民展示繩索並將它們與需要手的項目聯繫起來，我們不僅可以幫助個人，而且還幫助整個開源運動。

借助Verto.SH ，邁出第一步進行協作編碼，並成為更大的一部分。您今天的代碼可能是開源社區中令人驚奇的事情的開始。

添加一個新項目

歡迎您在Verto.sh中添加一個新項目，只需按照以下步驟：

• 為了維持Verto.SH項目的質量，請確保要添加的存儲庫滿足以下標準：

  • 對於GitHub存儲庫：它至少有三個問題，其中包含good first issue標籤或config.json中定義的其他標籤（請參閱labels和GitHub提供商的末尾）。

  • 對於GitLab存儲庫：它至少在Config.json中定義的quick win標籤或其他標籤（請參閱labels和GitLab提供商的末尾）。

  • 它至少有10個貢獻者。

  • 它至少有1000星。

  • 它包含一個readme.md，其中包含針對該項目的詳細設置說明，以及一個貢獻者，並帶有新貢獻者的指南。

  • 它是積極維護的（不到1個月前的最後更新）。

• 對於GitHub存儲庫：將存儲庫的路徑（按格式owner/name和詞典訂單）添加到GitHub提供商內的config.json。

• 對於GitLab存儲庫：將存儲庫的ID（以<project path>|<project id> ）添加到GitLab提供商內的config.json中。

• 創建一個新的拉值。請在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）。注意：存儲庫不算上上面列出的標準（請參閱數據中的規則。
3. 啟動開發服務器並在瀏覽器中打開應用程序。

 # install the dependencies
$ npm install
# start the development server
$ npm run dev

很高興知道您何時提交：該項目包含一個pre-commit鉤子，該掛鉤自動運行襯里以確保代碼質量！