创建 Gist

关于 gists

Gist 提供了一种与他人共享代码片段的简单方法。 每个 gist 都是一个 Git 仓库，意即可以复刻和克隆。 如果您在创建 Gist 时登录了 GitHub Enterprise Server，则该 Gist 将与您的帐户相关联， 当您导航到 gist 主页、http(s)://[hostname]/gist 或 http(s)://gist.[hostname]（如果启用了子域） 时，您会在 Gist 列表中看到它。

Gist 可以是公开或机密。 公开 gist 在 发现、http(s)://[hostname]/gist/discover 或 http(s)://gist.[hostname]/discover（如果启用了子域） 中显示，其中人员可以在新 gist 创建时查看这些 gist。 它们也可供搜索，因此，如果您希望其他人查找和查看您的工作，便可使用公共 gists。

机密 Gist 不会显示在 发现、http(s)://[hostname]/gist/discover 或 http(s)://gist.[hostname]/discover（如果启用了子域） 中，并且不可搜索，除非你已登录并且是机密 Gist 的作者。 秘密 Gist 不是私有 Gist。 如果您将秘密 Gist 的 URL 发送给朋友，他们将能够看到它。 但是，如果您不认识的人发现了该 URL，他们也能够看到您的 Gist。 如果需要将代码保密，可能需要改为创建专用存储库。

创建 gist 后，无法将其从公共转换机密。。 但是，可以通过编辑 gist 并将可见性更新为“公开”来公开机密 gist。

如果您的站点管理员禁用了私有模式，您也可以使用匿名 gists，可以是公共 gists 或秘密 gists。

您在以下情况下会收到通知：

• 您是新 gist 的作者。
• 有人在 gist 中提及您。
• 通过单击任何 gist 顶部的“订阅”来订阅 gist。

您可以在个人资料中置顶 Gist，使其他人更容易看到它们。 有关详细信息，请参阅“在个人资料中嵌入项目”。

通过转到 gist 主页、http(s)://[hostname]/gist 或 http(s)://gist.[hostname]（如果启用了子域） 并单击“所有 Gist”，可以发现其他人创建的公共 gist。 将会显示所有 gists 存储的页面，gist 按创建或更新时间显示。 您也可以通过 Gist 搜索、http(s)://[hostname]/gist/search 或 http(s)://gist.[hostname]/search（如果启用了子域） 按语言搜索 gist。 Gist 搜索使用与代码搜索相同的搜索语法。

由于 gists 是 Git 仓库，因此您可以查看其整个提交历史记录，包括差异。 您也可以复刻或克隆 gists。 有关详细信息，请参阅“复刻和克隆 Gist”。

可以通过单击 gist 顶部的“下载 ZIP”按钮下载 gist 的 ZIP 文件。 您可以将 gist 嵌入到支持 Javascript 的任何文本字段中，如博文。 若要获取嵌入代码，请单击 gist 的“嵌入”URL 旁边的剪贴板图标。 若要嵌入特定的 gist 文件，请在“嵌入”URL 后追加 ?file=FILENAME。

创建 Gist

按照以下步骤创建 gist。

1. 登录 GitHub Enterprise Server。

2. 导航到 gist 主页、http(s)://[hostname]/gist 或 http(s)://gist.[hostname]（如果启用了子域）。

3. （可选）在“Gist 描述”字段中，键入 Gist 的描述。

4. 在“文件名(包括扩展名)”字段中，键入 Gist 的文件名，包括文件扩展名。

5. 在“文件内容”字段中，键入 Gist 的文本。

6. (可选)若要创建公开 gist，请单击 ，然后单击“创建公开 gist”。

   

7. 单击“创建机密 Gist”或“创建公开 gist” 。