片段
片段是一小段代码或文本。
有两种类型的代码片段——项目代码片段和个人代码片段。
评论
使用GitLab Snippets,您可以参与关于这段代码的对话,促进用户之间的协作。
注意:对片段的评论介绍了在GitLab社区版9.2.
项目代码片段
项目片段总是与特定的项目相关项目的特性获取更多信息。
个人的片段
个人代码片段与任何项目无关,可以完全独立地创建。有3个可见性级别可以设置(公共,内部,私有-见公共访问以获取更多信息)。
下载代码片段
您可以下载片段的原始内容。
默认情况下,代码段将以linux风格的行结束符下载(低频
).如果你想保留原来的行结束符,你需要添加一个参数line_ending =生
(如。https://gitlab.com/snippets/SNIPPET_ID/raw?line_ending=raw
).如果一个代码片段是使用GitLab web界面创建的,原始的行结尾是类似windows的(CRLF
).
嵌入代码片段
在GitLab 10.8中引入。
公开片段不仅可以共享,还可以嵌入到任何网站上。这允许在多个地方重用GitLab代码段,对源代码的任何更改都会自动反映在嵌入的代码段中。
要嵌入一个代码片段,首先要确保:
- 项目是公共的(如果它是项目片段)
- 代码片段是公开的
- 在项目>设置>权限,则片段权限设置为每个有权限的人
一旦满足上述条件,“嵌入”部分将出现在你的代码片段中,你可以简单地单击“复制到剪贴板”按钮。这将复制一行脚本,您可以添加到任何网站或博客文章。
下面是示例代码的样子:
<脚本src =“https://gitlab.com/namespace/project/snippets/SNIPPET_ID.js”> < /脚本>
下面是嵌入代码片段的样子:
嵌入的代码片段将显示一个头部,其中显示了定义的文件名、代码片段大小、到GitLab的链接以及实际的代码片段内容。头中的操作允许用户以原始格式查看代码片段并下载它。