如何向 GitHub Pull 请求添加屏幕截图和动画

GitHub 程序员经常将屏幕截图或动画 GIF 添加到他们的存储库拉取请求中。这些技术肯定比让人读几行纯文本更引人注目。如果您想插入视觉变化或内联照片,添加静态屏幕截图会很有帮助。要演示流程和鼠标光标运动,您可以使用 MP4 视频和 GIF 动画。以下教程向您展示如何在 GitHub Pull Request 中添加屏幕截图和 MP4/GIF 动画。

另请阅读: Git 初学者指南

1. 添加新的存储库和分支

即使您从未使用过GitHub在此之前,您可以使用以下步骤开始作为开发人员。目前,您只需要一封电子邮件即可创建 GitHub 帐户。这使得 GitHub 的入门比以前容易得多。

  1. 登录 GitHub 个人资料后,单击右上角的“+”号以创建新存储库。
  1. 为存储库指定一个您选择的名称,并选择将其公开或私有。请记住选中“初始化此存储库菜单并检查自述文件”选项。
  1. 您可以选择以 Apache 2.0 许可证、GNU 通用公共许可证、MIT 许可证、Eclipse、Mozilla 公共许可证等形式发布您的代码。如果您不希望其他人自由使用代码,请选择“无”。
  2. 单击“创建存储库”以确认在您的个人资料主分支下添加存储库。
  1. 在下一阶段,使用如下所示的下拉菜单将分支添加到您的存储库。在这里,分支“Guten-tag-1”已添加到“Guten-tag”存储库中,该存储库本身是主存储库“Hola-World”的分支。
  1. GitHub 中分支的目的是帮助开发人员独立于主生产分支来处理功能和错误修复。添加序列号,如 1、2、3 等,是更容易记住分支级别的方法。

要在GitHub中添加屏幕截图,你需要一个好的屏幕截图软件。在 Windows 11 中,截图工具是最适合此目的的 Microsoft 应用程序。如果您遇到一些问题,请遵循我们的故障排除指南.

然而,Windows 10 使用“Snip & Sketch”应用程序,其工作方式与 Windows 11 截图工具非常相似,但功能较少。它有一个 3 或 10 秒的计时器来延迟捕获屏幕。

另请阅读: Windows 11 截图工具不起作用:12 种可能的修复方法

3.为GitHub创建视频和GIF动画

要为 GitHub 添加视频或 GIF,您需要一个好的视频屏幕捕获工具。过去,您无法在 GitHub 中上传 MP4,但现在情况已经改变。

在 Windows 11 和 Windows 10 中,您可以使用名为的 Microsoft Store 应用程序。 Microsoft Store 是下载屏幕录制软件的最安全来源,因为每个应用程序都设计为与 Windows 良好配合。学习如何在 Mac 上免费录制屏幕,请遵循本指南.

屏幕截图取自 Windows 应用商店
  1. 启动屏幕录制应用程序并选择捕获模式:“完整”、“区域”、“相机”或“仅音频”。当您准备好开始在屏幕上录制时,请按“开始”。
  1. 这个软件的好处是你可以通过选择GIF模式来直接创建GIF。
  1. 或者,您可以使用以下命令轻松将 MP4 转换为 GIF:动态图或任何其他在线工具。首先,使用上传链接添加 MP4 视频。
截图取自EzGif
  1. 您将得到 GIF 文件大小、宽度和长度的粗略估计。您可以更改 GIF 文件的帧速率,使其变慢,以便于进行简单说明。

另请阅读: 如何在 Mac 上免费录制屏幕

4. 将屏幕截图或动画添加到 GitHub Pull 请求

创建屏幕截图或视频后,您可以轻松地将它们添加到 GitHub 拉取请求中。

  1. 要将屏幕截图或视频/动画添加到 GitHub,请返回到您之前创建的分支并导航到“Pull requests”。或者,只需单击分支即可直接到达它。
  1. 要添加新文件(例如 MP4 或 GIF),请在您希望文件可用的分支中选择“上传文件”。
  1. 进入编辑器模式后,您可以从“选择文件”选项附加屏幕截图图像和 MP4/GIF 文件。如果您是第一次在 GitHub 分支存储库中提交,请单击“提交更改”。如果没有,请选择“更新评论”。
  1. 等待几秒钟,屏幕截图或动画文件就会添加到您的存储库分支中。
  1. 创建的屏幕截图/视频/动画已成功添加到 GitHub 分支,进而添加到存储库。
  1. GitHub 致力于与其他开发人员协作。如果他们喜欢您提出的更改,他们可能会将其上游合并到他们自己的存储库中。如果您能够看到“能够合并”选项,则会自动完成此操作。
  1. 完成合并后,视频/屏幕截图将在主存储库中显示为“提交”。

另请阅读: 如何清除 Git 缓存

5. 在 GitHub 页面上显示屏幕截图和 GIF 图像

您还可以使它们在 GitHub 页面上可见,而不是在拉取请求存储库中单独上传屏幕截图和 GIF 文件。

  1. 诀窍是单击任何分支上可见的“ReadMe.md”文件。打开后,单击名为“显示源 blob”的图标。可以编辑此分支以显示图像、屏幕截图、GIF 等。
  1. 单击“编辑文件”图标将进入一个编码屏幕,您可以在其中添加屏幕截图或动画 GIF 代码。通过添加可以很容易地显示图像!并将替代文本包装在[ ],然后将图像的链接嵌入括号中().

如果您不想编码,有一种更简单的方法可以直接将屏幕截图/GIF 添加到存储库页面。

  1. 单击 Readme.md 页面上的“编辑文件”,这将打开一个新窗口,您可以在其中附加要在分支页面上显示的屏幕截图/GIF。
  1. 在将更改提交到 GitHub 分支之前,您可以轻松预览图像、屏幕截图或 GIF。

另请阅读: 如何在 Windows 中安装 Git 和 Git Bash

常见问题解答

如何在 GitHub 中对齐图像或屏幕截图或调整其大小?

要对齐 GitHub 页面上的图像或屏幕截图,请单击 ReadMe.md 文件上的“编辑此”,然后上传图像或屏幕截图并添加以下代码:

修改代码以决定图像是左对齐、右对齐还是居中。要调整图像大小,请修改宽度和高度尺寸。

GitHub 上的 GIF 和视频文件有大小限制吗?

是的。单个 GIF 或 MP4 文件的最大文件大小为 50 MB。使用名为“GitHub Blocks”的隐藏 GitHub 功能,您可以将每个文件的大小增加到 100 MB。 GitHub 存储库(您的主分支)应保持小于 5 GB。

如果您需要上传文件大小较大的图像或视频,请使用名为 GitHub Large File Storage (LFS) 的 GitHub 程序,该程序对于免费/专业用户来说每个文件的最大限制为 2 GB。

如何在 GitHub 上共享图像?

GitHub 目前没有任何工具可以使用聊天和相关工具直接共享图像,例如屏幕截图或 GIF。但是,您可以在 GitHub 页面中创建“问题”并提交以供审核。这些问题可能包括图像。要通知 GitHub 上的人员,请使用@在他们的用户名之前。

图片来源:格鲁特和章鱼在 Unsplash所有截图均由作者截取。