GitGud

吉特

介紹

Gitgud是一個開源存儲庫，旨在為初學者和經驗豐富的開發人員提供學習和增強其GIT技能的平台。該存儲庫的構建旨在為所有技能水平的開發人員提供交互式學習體驗。無論您是剛剛開始使用Git還是尋求提高現有技能，Gitgud都提供了一系列可以幫助您掌握Git的資源和工具。 Gitgud允許您在整個項目中輕鬆可視化和充分利用Git。它是使用墨水創建的，該墨水提供了反應提供的基於組件的UI構建體驗，但在命令行接口（CLI）中創建。

要求

• 至少已安裝了GIT版本2.24.3
• 安裝了NPM
• 由於渲染問題，我們不建議將ITERM2用於Gitgud。超級或默認終端是不錯的選擇。

---

安裝

 $ npm install --global gitgud

---

這將在全球安裝包裝

用法

 $ GitGud

• 導航到任何具有GIT目錄的項目並運行“ Gitgud”命令。這會將gitgud UI加載到您的終端窗口

• Gitgud UI包括：未分段的更改，分階段更改，git分支樹視圖和功能按鈕

• 使用“選項卡”按鈕或左/右箭頭鍵瀏覽UI

• 按“ Enter/返回”按鈕選擇/單擊選項

• 在整個應用程序中，您可以點擊“ ESC”（逃逸）按鈕以返回

• 您可以通過運行CTRL + C退出應用程序

---

功能

• 階段變化

  • 您可以選擇STAGE/UNSTAGE (all files)以在階段更改和脫離舞台更改之間移動所有文件。
  • 如果您單擊一次，它將將所有文件從UI的“未分段更改”部分移動到“階段更改”。如果再次單擊它，它將撤消“分期更改”，並將文件移回“未分段更改”，依此類推。
  • 您還可以選擇通過使用向上/下鍵通過它們進行導航來進行上演/拆卸單個文件。
  • 按“ ESC”退出舞台更改菜單。

• 提交更改

  • 它將提示您輸入“提交消息”，該消息不需要您將輸入包裝在引號。輸入並提交提交消息後，它運行該提交並將您帶回主菜單。
  • 按“ ESC”退出提交更改。

• 推動上演的變化

  • 這將把上演的更改推向您所在的當前分支。
  • 您可以看到GUI頂部的分支。

• 結帳分支

  • 它將顯示項目中所有分支的列表。分支是不可選擇的，它們可以幫助您查看哪些本地分支可以切換到哪些本地分支。
  • 提示您進入分支以結帳。如果您輸入不存在的分支，它將創建一個新的分支。
  • 如果您有未分段的更改，將顯示錯誤，並且將中止結帳操作，並告訴您您已經進行了尚未分佈的更改，並在切換分支之前提交或固定更改。您可以按“ ESC”回去藏匿/提交更改，然後再嘗試再次結帳

• 刪除分支

  • 它將顯示不可選擇的分支列表，它們可以在那裡幫助您查看哪些本地分支可用。
  • 提示您輸入分支名稱，如果存在分支，則將刪除/刪除它，並將您帶回主菜單。如果分支不存在，則會丟棄錯誤。
  • 按“ ESC”退出刪除分支

• 訪問完整的日誌樹

  • 它將渲染整個日誌樹覆蓋Gitgud GUI。
  • 按“ ESC”退出日誌樹

---

造型

Gitgud允許用戶通過編輯“ stylefile”來自定義應用程序的外觀和感覺。

要訪問全球安裝的Gitgud的“ stylefile”，您首先需要找出NPM保存全球安裝的文件的位置。為此，運行以下命令：

 npm root -g

這將返回您全球安裝的NPM軟件包的位置。

在Mac上，您應該看到類似的東西： /usr/local/lib/node_modules

在Windows上，您可能會得到以下內容： *C： USER You appData roaming npm node_modules

導航到存儲全局軟件包的位置，打開gitgud文件夾，然後在編輯器中打開stylefile（命令： nano styleFile.js將在大多數Mac/Linux系統中打開它）。

當您打開文件時，它看起來像這樣：

• showLogo ：

  • 默認情況下，這將設置為false ，但是如果您想在GUI頂部擁有Gitgud徽標，則可以將其更改為true 。

• defaultColor ：

  • 這是整個應用程序中主文本塊的顏色。

• accentColor ：

  • 這是應用程序邊界的顏色以及整個應用程序中的一些文本標頭。

• gitTreeColor ：

  • 這是整個應用程序中git樹字體的顏色。

• appResize ：

  • 這使該應用程序能夠響應迅速，從而使用戶可以調整其控制台窗口大小，而無需重新啟動應用程序。這可能會降低某些用戶的性能。

• showFlag ：

  • 允許用戶選擇是否通過上演/未分段的文件顯示Git輸出標籤。
  • 默認設置為false 。
  • 有關GIT輸出標籤的更多信息，請參見此處

---

常見問題解答

---

貢獻

Gitgud是一個完全開源的項目，歡迎捐款！

提交拉動請求時，請清楚說明您添加的功能或已修復的錯誤。

也歡迎首次貢獻者！有一些good first issue標籤標記了一些問題。這些可能是初學者開始的好地方！

感謝Joseph Garrone給我們的NPM包裝名稱。