Contribute To This Project -為該Contribute To This Project

Contribute To This Project

其他源碼

1.0.0

下載

為這個項目做出貢獻

圖像信息

創建的徽標？由候選人

公告：
您想成為該項目的維護者並幫助它繼續前進嗎？如果您有興趣，請閱讀《維護者指南》，加入我們的Discord服務器，並請求從項目維護人員那裡加入團隊。

快速訪問索引

介紹
目標
這是誰？
我為什麼需要這樣做？
我要貢獻什麼？
翻譯
設定! :)
貢獻
- 步驟1：叉這個存儲庫
- 步驟2：克隆存儲庫
- 步驟3：創建一個新的分支
- 步驟4：打開index.html文件
- 步驟5：複製卡模板
- 步驟6：應用您的更改
- 步驟7：提交您的更改
- 步驟8：將您的更改推向GitHub
- 步驟9：提交公關（拉請求）
- 步驟10：慶祝
下一步
致謝
執照
前100名貢獻者

介紹

這是一個教程，可幫助首次貢獻者參加一個簡單簡便的項目。

目標

為開源項目做出貢獻。
使用GitHub更舒服。

這是誰？

這是針對絕對初學者的。如果您知道如何編寫和編輯錨定標籤<a href="" target=""></a> ，那麼您應該能夠做到這一點。
這也是對於那些有更多經驗但想做出第一個開源貢獻的人，或獲得更多貢獻的人，以獲得更多的經驗和信心。

我為什麼需要這樣做？

任何Web開發人員，有抱負或經驗豐富的都需要使用GIT版本控制，而GitHub是每個人使用的最受歡迎的GIT託管服務。它也是開源社區的核心。使用github感到舒適是一項重要技能。為項目做出貢獻會增強您的信心，並為您提供一些在GitHub個人資料上顯示的東西。

如果您是新開發人員，並且想知道您是否需要學習git和github，那麼這就是答案：昨天您應該學會了git。

我要貢獻什麼？

Contributor Card

您將在此項目的網頁上貢獻一張卡。它將包括您的姓名，您的Twitter句柄，簡短描述以及您推薦的Web開發人員有用資源的3個鏈接。

您將在HTML文件中製作卡模板的副本，並使用自己的信息自定義。

翻譯

本教程也有其他語言可用

阿拉伯語（Elter）	孟加拉國（বাংলা）	中文（傳統）（繁體中文）	荷蘭	英語（英語）
法語（Français）	德國（德意志）	印地語（हिंदी）	意大利語（意大利語）	日語（日本語）
韓語（한국어）	波蘭（波爾斯基）	葡萄牙（葡萄牙）	俄羅斯（сLoouLй）	塞爾維亞人（照汽車）
西班牙語（Español）	土耳其語（türkçe）	烏克蘭（ouisianian）	挪威（Norsk）	馬利拉姆

歡迎項目文檔的翻譯。閱讀貢獻Translation Guide 。

設定! :)

筆記

本教程基於GitHub PC。如果您對終端感到滿意，請訪問本教程（單擊此處）

首先，讓我們設置工作

登錄到您的GitHub帳戶。如果您還沒有帳戶，請加入GitHub。我建議您在繼續之前進行GitHub Hello World教程。
下載GitHub桌面應用程序。
- 另外，如果您可以在命令行上使用git，則可以這樣做，這是指向CLI教程的鏈接。
- 如果使用VS代碼，則它帶有集成的Git，並允許您直接從編輯器中完成我們需要的事情。
- 但是，遵循本教程的最簡單和最簡單的方法是使用GitHub桌面。

現在，您都已經進行了設置，讓我們繼續為項目做出貢獻。

↑轉到頂部↑

貢獻

在10個簡單的步驟中成為開源貢獻者。

估計時間：少於30分鐘。

步驟1：叉這個存儲庫

這裡的目的是製作該項目的副本並將其放入您的帳戶中。
存儲庫（存儲庫）是在Github上調用項目的方式，而叉子是其副本。
確保您在此存儲庫的主頁上。


單擊叉按鈕

現在，您在您自己的帳戶中擁有該項目的完整副本。

↑轉到頂部↑

步驟2：克隆存儲庫

現在，我們想製作該項目的本地副本。那是保存在您自己的機器上的副本。
打開GitHub桌面應用程序。在應用程序中：


單擊文件，然後克隆存儲庫

您將在GitHub上看到您的項目和分叉的列表。
選擇<your-github-username>/Contribute-To-This-Project 。
單擊克隆

↪️一個分叉的項目將在左側具有叉子符號。您的叉子將擁有您自己的github用戶

這將花費一些時間，因為該項目被複製到您的硬盤。我建議您保留通常的默認路徑..DocumentsGitHub 。
現在您有了該項目的本地副本。

↑轉到頂部↑

步驟3：創建一個新的分支

一旦將存儲庫克隆到Github桌面上，就該創建一個新的分支了。
分支是使您的更改與項目主要部分Master的一種方式。例如，如果出現問題，您對更改不滿意，您可以簡單地刪除分支機構，而主項目不會受到影響。

↪️單擊`Current branch` ，然後單擊`New`
↪️給您的分支一個名字，然後單擊`Create branch`
↪️將您的新分支發佈到GitHub

您可以隨心所欲地將其命名，但是由於這是一個分支機構，可以將帶有您名稱的卡添加到項目中，因此稱其為your-name-card是一個很好的做法，因為它可以保持該分支的意圖。
現在，您已經創建了一個與主人分開的新分支。
對於下一步，請確保您在此分支機構工作。您將在Github桌面應用程序的頂部中心看到分支的名稱，其中說明了當前分支。

不要在master分支上工作

↑轉到頂部↑

步驟4：打開index.html文件

現在，我們需要打開要使用您喜歡的代碼編輯器編輯的文件。
在計算機上找到項目文件夾。如果您保留了默認值，則應該是your-computer > Documents > GitHub > Contribute-To-This-Project
index.html文件直接在Contribute-To-This-Project文件夾中。
打開您的代碼編輯器（Sublime，VS Code，Atom..Etc）並使用Open file命令並在項目的主要目錄中找到index.html文件


↪️或者，您可以在硬盤驅動器上找到文件，右鍵單擊並與編輯器打開

現在，您已經有了要在編輯器中編輯打開的文件，並且可以開始對其進行更改。

↑轉到頂部↑

步驟5：複製卡模板

我們將製作卡模板的副本以開始處理它
就在<body>內部，您會找到一個<div class="container">部分。這包含許多其他部分。
前兩個部分完全像： <div class="row"> 。如下圖所示，通過單擊箭頭在VS代碼編輯器上的箭頭來折疊它們。（如果使用另一個編輯器，則可能無法使用該功能。您只需要向下滾動）即可。崩潰使您可以輕鬆隱藏您不需要更改的代碼組件。
現在，您應該看到包含所有貢獻卡的部分： <div class="grid" id="contributions">

在本節內，您將找到標記為== TEMPLATE ==部分
從圖像中的紅色正方形中復制所有內容，從Contributor card START評論到Contributor card END評論

將整個內容粘貼在註釋下方，指示它；就在最新貢獻者的卡上。
確保您的卡端和最後一張卡的開始之間有一條空間。另外，在卡的啟動和評論之間添加一條空間=== Paste YOUR CARD directly BELOW this line === 。最好保持我們的代碼盡可能清楚
切勿使用襯里或樣式格式。該項目的設置更漂亮

現在，這是您的卡供您自定義和編輯。

↑轉到頂部↑

步驟6：應用您的更改

現在，我們將開始編輯HTML，更改卡中的可自定義字段。

↪️將“名稱”替換為您的名字

注意：不要更改class="name"

↪️插入您的Twitter帳戶的URL `href="Insert URL here"` ，在文本字段中輸入句柄

如果您希望使用除Twitter以外的其他聯繫人，則需要替換Twitter圖標<i class="fa fa-x-twitter"></i>通過訪問字體很棒的圖標來搜索正確的圖標，並僅用新圖標替換fa-x-twitter部分，例如fa-facebook 。然後遵循上面的相同步驟。


↪️告訴我們一些關於您的事情。保持簡短而甜美。想想它更像是一條推文，而不是博客文章

↪️與社區分享3鏈接到對Web開發有用的資源的鏈接。這可以是任何東西，視頻，談話，播客，文章，參考或工具。如果您是初學者，請不要對此感到恐懼，即使您認為這是基本的，也可以分享您所知道的一切。您會驚訝於多少人會受益。

鏈接：插入鏈接href="here"替換# 。請避免使用未從您發布的網站中使用URL縮短器或URL！
標題：寫一個簡短的描述title="here" 。
名稱：在文本字段中寫入資源的名稱>here</a> 。
確保您保存了所有更改。
測試您的更改。這很重要！打開瀏覽器中的HTML文件（例如，雙擊它），然後查看您的卡片在網站上的外觀。看到整個頁面看起來仍然相同，什麼也沒有破裂。單擊您的鏈接並確保它們正在工作。打開控制台（Ctrl + Shift + J（Windows / Linux）或CMD + OPT + J（MAC）），並檢查沒有錯誤消息。
太好了，您已經完成了編輯代碼！下一步將使您的更改發送到GitHub，然後提交將其與主要項目合併。

↑轉到頂部↑

步驟7：提交您的更改

返回到GitHub桌面應用程序。
您的更改將自動添加到登台區域。
這意味著Git已記錄所有保存的更改。
您可以在應用程序中看到此反映。您添加到文件中的所有內容都將以綠色為綠色，並且刪除將顯示為紅色。


↪️下一步稱為`Commit` 。這大致意味著`confirm the changes`

↪️這是您的GitHub桌面標頭的外觀。請注意`Current repository`中項目名稱旁邊的叉符號，您`Current branch`將在步驟3中給它命名

↪️要`Commit`您必須填寫`Summary`字段。這是說明您已更改的提交消息。在這種情況下`"Add my card information"`將是一個合理的消息。您可以選擇添加更詳細的`Description` 。單擊`Commit`按鈕。您的按鈕會說諸如`Commit to "your-branch-name"`類的東西

↑轉到頂部↑

步驟8：將您的更改推向GitHub

您的更改現在已保存或承諾。但是它們僅在本地保存，這是在您的計算機上。
將本地更改與您在github上的存儲庫同步稱為推動。您正在“推動”從本地存儲庫到GitHub上遠程存儲庫的更改。

↪️單擊`Push`

幾秒鐘後，操作完成了，現在您在計算機以及Github上的該分支的副本完全相同。

↑轉到頂部↑

步驟9：提交公關（拉請求）

這是您一直在等待的那一刻。提交拉動請求（PR）。
到目前為止，您所做的所有工作都屬於該項目的分叉，如您所記得的那樣，該項目居住在您自己的Github帳戶上。
現在是時候將您的更改發送到與之合併的主要項目了。
這就是稱為拉的請求，因為您要求原始項目維護者將更改“將”“拉”到他們的項目中。
轉到GitHub上的叉子的主頁（它將在頂部具有叉子圖標和您自己的用戶名）。
在存儲庫的頂部，您將看到帶有綠色按鈕的突出顯示的拉請請求消息。


↪️單擊`Compare and pull request`

↪️這是`Open a pull request`頁面的樣子。

請記住，您正在嘗試將分支與原始項目合併，而不是與叉子上的Master分支合併。
下圖為您提供了有關拉的請求的標題的想法。
左側是原始項目，其次是主分支。右邊是您的叉子和您創建的分支。


↪️創建拉動請求：編寫標題，在描述中添加可選信息，然後單擊`Create pull request`

不要被所有選項所困擾。您現在只需要執行這三個步驟即可。
離開該選項Allow edits from maintainers 。
現在，將發送拉動請求給項目維護者。一旦審查並接受，您的更改就會出現在項目網頁上。

↑轉到頂部↑

步驟10：慶祝

就是這樣。你做到了！您現在已經為Github上的開源做出了貢獻。

您已經在實時網頁上添加了代碼：https：//syknapse.github.io/contribute-to-project

您的更改將不會立即可見；首先，必須對項目維護者進行審查，接受和合併。合併後，您的卡應可見並在頁面上生活。

審閱者要求對PR進行更改是很正常的。如果您發生在您身上，將其視為好習慣。密切關注評論並要求更改。一旦您進行了要求的更改（返回分支機構），您要做的就是提交和推動更改。 PR將隨著新更改自動更新。

我保證我會盡快審查和合併，但我在業餘時間進行此操作，因此延遲幾天是不可避免的。

↑轉到頂部↑

下一步

一會兒回來檢查您合併的拉請請求。
批准更改或要求其他更改時，您應該從GitHub收到一封電子郵件。當PR最終與主人合併後，您的卡已被添加。
您還可以學習如何從此免費系列中貢獻：如何為GitHub上的開源項目做出貢獻
如果您發現此項目有用
您可以加入我們的Discord服務器
您可以關注我並取得聯繫嗎？（Twitter）或使用這些其他任何選項
這是一個開源項目，因此除了貢獻您的卡外，歡迎您幫助修復錯誤，改進或新功能。打開問題或發送新的拉請請求
為了幫助改善我們的社區，請查看位於拉請求旁邊的GitHub討論選項卡。該領域是介紹自己，對開源進行更深入的討論並與項目維護人員進行溝通的地方。您會幫助我們構建此功能並增強我們的社區嗎？
感謝您為這個項目做出貢獻。現在，您可以繼續嘗試為其他項目做出貢獻；尋找標籤初學者友好的貢獻選項。
我還在尋找合作者，可以幫助我審查和合併PR。如果您想獲得更高級的GIT練習，請閱讀《維護者指南》，加入我們的Discord服務器，並請求從項目維護人員那裡加入團隊。