GitGud

Gitgud

導入

Gitgudは、初心者や経験豊富な開発者にGitスキルを学び、強化するプラットフォームを提供するように設計されたオープンソースリポジトリです。リポジトリは、あらゆるスキルレベルの開発者にインタラクティブな学習体験を提供することを目的として構築されています。 Gitを始めたばかりであろうと、既存のスキルを向上させようとしている場合でも、GitGudはGITをマスターするのに役立つ幅広いリソースとツールを提供します。 GitGudを使用すると、プロジェクト全体でGitを簡単に視覚化し、完全に活用できます。 Inkを使用して作成されます。インクは、対応する同じコンポーネントベースのUIビルディングエクスペリエンスを提供しますが、コマンドラインインターフェイス（CLI）で提供されます。

要件

• 少なくともgitバージョン2.24.3をインストールしてください
• NPMをインストールしてください
• レンダリングの問題により、GitGudにITERM2を使用することはお勧めしません。ハイパーまたはデフォルト端子は良い代替品です。

---

インストール

 $ npm install --global gitgud

---

これにより、パッケージがグローバルにインストールされます

使用法

 $ GitGud

• gitディレクトリが含まれているプロジェクトに移動し、「gitgud」コマンドを実行します。これにより、GitGud UIが端末ウィンドウにロードされます

• GitGud UIは、舞台化されていない変更、段階的な変更、Git枝のツリービュー、および機能ボタンで構成されています

• 「タブ」ボタンまたは左/右矢印キーのいずれかでUIをナビゲートします

• [Enter/return]ボタンを押して、オプションを選択/クリックします

• アプリ全体で「ESC」（エスケープ）ボタンを押して戻ることができます

• Ctrl + Cを実行してアプリを終了できます

---

機能

• ステージの変更

  • STAGE/UNSTAGE (all files)を選択して、すべてのファイルをステージの変更と段階的な変更の間に移動できます。
  • クリックすると、すべてのファイルがUIの「ステージングされていない変更」セクションから「ステージ変更」に移動します。もう一度クリックすると、「段階的な変更」を取り消し、ファイルを「舞台のない変更」などに戻します。
  • また、アップ/ダウンキーでそれらをナビゲートすることにより、個々のファイルをステージング/段階的にステージングするオプションもあります。
  • 「ESC」を押して、ステージ変更メニューを終了します。

• 変更をコミットします

  • 引用符で入力をラップする必要のない「コミットメッセージ」を入力するように促します。コミットメッセージを入力して送信した後、コミットを実行し、メインメニューに戻します。
  • 「ESC」を押して、コミットの変更を終了します。

• 段階的な変更をプッシュします

  • これにより、現在のブランチに段階的な変更がプッシュされます。
  • GUIの上部にあるブランチを確認できます。

• チェックアウトブランチ

  • プロジェクト内のすべてのブランチのリストが表示されます。枝は選択できません。彼らは、どのローカルブランチが切り替えられるかを確認するのに役立ちます。
  • チェックアウトするためにブランチに入るように求められます。存在しないブランチに入ると、新しいブランチが作成されます。
  • ステージングされていない変更がある場合、エラーが表示され、チェックアウト操作が中止され、舞台に変更されていない変更があり、ブランチを切り替える前に変更を犯したり留めたりすることがわかります。 「ESC」を押して戻って、再度チェックアウトしようとする前に変更/変更を加えることができます

• ブランチを削除します

  • 選択できないブランチのリストが表示され、どのローカルブランチが利用可能かを確認するのに役立ちます。
  • ブランチ名を入力するように求められます。ブランチが存在する場合は、それを削除/削除してメインメニューに戻します。ブランチが存在しない場合、エラーが発生します。
  • 「ESC」を押して、削除ブランチを終了します

• 完全なログツリーにアクセスします

  • GitGud GUIのオーバーレイを備えたログツリー全体がレンダリングされます。
  • 「ESC」を押して、ログツリーから出ます

---

スタイリング

GitGudを使用すると、ユーザーは「StyleFile」を編集して、アプリのルックアンドフィールの両方をカスタマイズできます。

グローバルにインストールされているGitGudの「スタイルファイル」にアクセスするには、最初にNPMがグローバルにインストールされているファイルを保存している場所を確認する必要があります。これを行うには、次のコマンドを実行します。

 npm root -g

これにより、グローバルにインストールされているNPMパッケージの場所が返されます。

Macでは、このようなものが表示されるはずです： /usr/local/lib/node_modules

Windowsでは、これを取得できます

グローバルパッケージが保存されている場所に移動し、GitGudフォルダーを開き、エディターでStyleFileを開きます（コマンド： nano styleFile.jsがほとんどのMac/Linuxシステムで開きます）。

ファイルを開くと、次のようになります。

• showLogo ：

  • デフォルトではこれはfalseに設定されていますが、GUIの上にGitGudのロゴを持ちたい場合は、これをtrueに変更できます。

• defaultColor ：

  • これは、アプリ全体のメインテキストブロックの色です。

• accentColor ：

  • これは、アプリの境界線とアプリ全体のテキストヘッダーの色です。

• gitTreeColor ：

  • これは、アプリ全体でgitツリーフォントの色です。

• appResize ：

  • これにより、アプリがレスポンシブになり、ユーザーがアプリを再起動することなくコンソールウィンドウを変更することができます。これにより、一部のユーザーのパフォーマンスが低下する場合があります。

• showFlag ：

  • ユーザーは、段階的/段階的なファイルによってGIT出力タグを表示するかどうかを選択できます。
  • デフォルトでfalseに設定します。
  • GIT出力タグの詳細については、こちらをご覧ください

---

FAQ

---

貢献

Gitgudは完全にオープンソースのプロジェクトであり、貢献を歓迎します！

プルリクエストを送信するときは、追加した機能または修正したバグを明確に説明してください。

初めての貢献者も大歓迎です！ good first issueタグがマークされたいくつかの問題があります。これらは初心者が始めるのに適した場所かもしれません！

NPMパッケージ名を教えてくれたJoseph Garroneに感謝します。