first contributions ja.github.io

通過完整的日本教程開始您的OSS活動

這是一個開源的日本項目，旨在使初學者易於參與。
關注教程，體驗您的第一個貢獻！

我們很樂意為您提供第一個拉動請求✌️

介紹

該項目是日本教程，可幫助您學習如何在實踐中使用git/github以及如何在開源中進行協作！

這是誰？

• 想學習使用git/github的實用方法的初學者
• 對開源感興趣但不知道如何做出貢獻的人
• 或者，您想通過更多的貢獻來提高自己的技能，同時享受合作

這個項目的目的是什麼？

• 使用GitHub體驗實際的聯合開發，這很難自己學習。
• 每個人都有信心，學習如何為開源項目做出貢獻
• 並幫助喜歡開源文化連接的開發人員

什麼是開源的？

什麼是開源？

當一個項目是開源的時，這意味著任何人都可以自己一時興起，學習，修改和分發您的項目。

在大多數情況下，開源項目可以免費參與開發！

對開源項目的貢獻是
這是通過與其他開發人員協作提高技能的好方法。

如果您對開源不感興趣，並且想知道您是否需要付出努力，
請參閱此處：為什麼要為開源做出貢獻？

如何參加

讓我們立即體驗開源項目的貢獻！

我應該怎麼辦？

作為該項目的參與者，我們將在貢獻者文件中添加以下信息！

 "name": "あなたのハンドルネーム",
"github": "あなたのGitHubアカウントのURL",
"favoriteColor": "あなたの好きなカラーコード",
"favoriteEmoji": "あなたの好きな絵文字"

輸入的信息將以表情符號圖標顯示在網站上。
因此，每當貢獻者的數量增加時，網站就會變得活躍！

表情射擊動物。 mp4

我們希望使JA的網站更加流行起來！
請嘗試移動您的手

• 實際移動您的手
  • 設定:
  • 步驟1：叉這個存儲庫
  • 步驟2：克隆到本地機器
  • 步驟3：創建一個工作分支
  • 步驟4：進行更改
  • 步驟5：提交您的更改
  • 步驟6：推動更改
  • 步驟7：創建拉動請求（PR）
  • 步驟8：回應評論和反饋
  • 結束： ？
• 更多步驟
• 其他貢獻

實際移動您的手

在8個簡單步驟中成為開源貢獻者？

• 如果您需要幫助，請在討論中詢問！
• 如果您發現該項目的任何改進，請通過問題告訴我們！

不管有多小，我們受到歡迎嗎？

---

設定:

• 如果您沒有GitHub帳戶，請通過註冊創建一個帳戶。
  • 如有必要，我們建議您首先為完整的初學者進行GitHub Hello World教程。
• 如果未設置替換密碼的訪問令牌，則可能在克隆時發生錯誤。
  • 在這種情況下，請參閱配置GitHub訪問令牌。

---

步驟1：叉這個存儲庫

• 通過單擊GitHub項目頁面（此頁面）右上角的“叉子”按鈕來叉。

• 然後單擊“創建叉”按鈕。
  • 所有項目，例如“存儲庫名”，“描述”和“僅複製main分支”，就像原始格式一樣！

提示

這將在您的GitHub帳戶中創建此存儲庫的副本？

---

步驟2：克隆到本地機器

您也可以在github上編輯文件，
將叉子存儲庫複製到您的本地計算機，以獲得更一般的工作流程體驗。

• 在GitHub上，轉到分叉的存儲庫頁面，單擊“綠色代碼”按鈕，然後復制HTTPS URL。
  • 您的URL應該像這樣： https://github.com/<あなたのアカウント名>/first-contributions-ja.github.io.git

• 打開一個終端並導航到要克隆存儲庫的目錄。
  • 例如，如果要在桌面上指定克隆目標，則可以使用以下命令：

   cd desktop
  

• 使用以下命令將叉子存儲庫克隆到您的本地計算機：

   git clone 先ほどコピーしたクローンURL
  

提示

這允許將存儲庫複製到您的本地機器並在本地環境中工作

---

步驟3：創建一個工作分支

• 使用以下命令導航到存儲庫目錄：

   cd first-contributions-ja.github.io
  

• 使用以下命令安裝此項目所需的軟件包：

   npm install
  

  
  
  注意：什麼是NPM安裝？ ❓❓

  
  

  安裝了Node.js，運行npm install命令以批量安裝該項目所需的庫。

  安裝npm install後可以做什麼

  • 啟動本地服務器並在瀏覽器中檢查視圖
    • 執行npm run dev命令後，單擊似乎確認的URL
  • 自動代碼檢查和塑形
    • 它是使用名為Husky的圖書館運行的
    • 它自動運行，因此無需執行任何命令或進行任何工作

  
  

  有關npm install命令的更多信息，請參閱此處！

  “注意”）如果NODE.JS未安裝在您的本地計算機上， npm install命令將導致錯誤。

  在這種情況下，有兩種處理方法。

  • 跳過npm install過程。
    • 沒有此過程，您可以擁有最低貢獻的經驗，因此，如果困難，您可以跳過它。
    • 我想知道參考，這裡有多少人會偶然發現，因此，如果您可以在拉動請求中報告，例如“ npm install不起作用”，這將非常有幫助。
  • 安裝node.js。
    • 有關安裝說明，請參閱以下網站：
    • node.js官方網站 /如何安裝node.js（macos）pregate /如何安裝node.js（windows）pregate
    • 如果您想進一步了解node.js，什麼是node.js？為什麼每個人都在使用它？請參考Qiita。
    • 如果您對Web/JavaScript開發感興趣，我建議使用此機會安裝它？

• 接下來，創建一個新的分支，將您的工作與項目的main分支區分開。
  • 您可以使用以下命令： git switch -c <ブランチ名>
  • 分支名稱是與您將要做的工作相關的有意義的名稱。看起來像這樣：

   git switch -c add-yourname
  

  • ？筆記）
  • 不要忘記用手柄替換yourname
  • 請在沒有Hiragana，漢字或白色空間的半寬字母數字字符中輸入分支名稱。
    • ：Ogino Chihiro，Ogino Chihiro
  • 例子：

   git switch -c add-oginochihiro

  

提示

這使您準備進行更改而不直接影響main項目存儲庫？

---

步驟4：進行更改

• 要開始，請在您喜歡的代碼編輯器（例如VSCODE）中打開克隆的文件夾。
  • 在進行任何更改之前，請確保您與上一步中創建的分支合作！
  • 您可以使用以下命令檢查當前分支：

   git status
  

• 現在，讓我們更改貢獻者。
  • 複製並將以下代碼粘貼到您的貢獻者中的“列表”。

   ,
  {
    "name": "あなたのハンドルネーム",
    "github": "あなたのGitHubアカウントのURL",
    "favoriteColor": "あなたの好きなカラーコード",
    "favoriteEmoji": "あなたの好きな絵文字"
  }
  

• 然後用自己的內容替換粘貼文本的內容。
  • ？請參閱以下網站：表情符號列表，原色詞典，日語傳統顏色
  • 例如，如果您全部替換，它看起來像這樣：

   <!-- 変更後 -->
    ~~
    },
    {
      "name": "oginochihiro",
      "github": "https://github.com/first-contributions-ja",
      "favoriteColor": "#ffffff",
      "favoriteEmoji": "?"
    }
  ]
  

---

步驟5：提交更改

• 返回終端並使用以下命令將更改提交到本地存儲庫：
  • 不要忘記用句柄名稱替換yourname 。

   git add .
  git commit -m "yournameをコントリビューターに追加"
  

提示

這將記錄您對貢獻者的任何更改。

---

步驟6：推動更改

• 將更改推向叉子遠程存儲庫：

   git push origin HEAD
  

提示

這將允許您在GitHub上提到的遠程存儲庫的前面提到的提交（本地更改）？

---

步驟7：創建拉動請求（PR）

• 轉到GitHub（ https://github.com/あなたのアカウント/first-contributions-ja.github.io ）上的分叉遠程存儲庫頁面。
• 單擊頂部的“比較和拉請求”按鈕。

• 然後，確認以下內容後，單擊“創建拉請請求”按鈕。
  • 為了安全起見，請確保您要從存儲庫的add-yourname分支到first-contributions-js的main分支！
  • 標題仍然是初始輸入，描述為空白！

提示

這將要求您通過分叉所做的任何更改反映在您分叉的存儲庫中？

---

步驟8：回應評論和反饋

您的公關將由項目維護者審查（確認）。

• 審閱者要求對PR進行更改是很正常的。如果發生這種情況，請進行更正，因為這是常見的情況。
  • 在這種情況下，您只需返回到以前的工作分支，然後進行所請求的修改，只需以相同的方式進行提交並推動更改。
  • PR將通過新的推動自動更新。

大多數評論將在24小時內進行，但可能會有幾天的時間。請耐心等待☕

---

結束：？

• 一旦批准了拉的請求，您進行的任何更改都將合併到主項目中。

謝謝您的辛勤工作！
並感謝您的時間和精力為JA做出貢獻！呢

更多步驟

重要的

如果您發現此項目有用，請按頁面頂部的星按鈕！
另外，與您的追隨者和熟人分享以傳播該項目！

您已經學會瞭如何為開源項目做出貢獻！

• 回顧您所做的工作，並保持知識。
  • 您剛剛完成了經常作為貢獻者體驗的標準工作流程：閱讀文檔→叉→更改→拉請求！
• 首先貢獻JA是一個開源項目，因此您可以與上面的教程不同。
  • 請讓我們知道您對討論的項目的看法？
  • 如果您有興趣，請查看其他貢獻。
• 請為其他開源項目做出貢獻！
  • 查看Github上的初學者主題（首先歸類和第一章）！
  • 如果您有要貢獻的存儲庫，請查找標有“好的第一期”的問題。
  • 對於特定項目或開源本身的初學者來說，這通常代表了一個問題！

其他貢獻

如果您想做出更多貢獻，請參考貢獻指南！
歡迎任何小的貢獻，例如添加代碼，修復錯誤，改進文檔嗎？

執照

該項目已根據MIT許可獲得許可。

致謝

該項目包括第一份貢獻，並對這項項目進行貢獻。
它受到專為初學者設計的偉大開源項目的影響。