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包装名称。