diff options
author | Achilleas Pipinellis <axil@gitlab.com> | 2018-05-25 13:30:29 +0000 |
---|---|---|
committer | Filipa Lacerda <filipa@gitlab.com> | 2018-05-30 10:57:06 +0100 |
commit | 5e39c6d75d277920c02c4ad28e4f22be2aaa1458 (patch) | |
tree | 381fff7a26a377a6ca8ea9c84a5e4f3db46b1549 | |
parent | d0a319c97f11ff86e60b2ebf37522c0801fb32d7 (diff) | |
download | gitlab-ce-5e39c6d75d277920c02c4ad28e4f22be2aaa1458.tar.gz |
Merge branch 'add-embedded-snippets-docs' into 'master'
Init documentation for embedded snippets
See merge request gitlab-org/gitlab-ce!19120
-rw-r--r-- | doc/user/snippets.md | 33 |
1 files changed, 33 insertions, 0 deletions
diff --git a/doc/user/snippets.md b/doc/user/snippets.md index 2170b079f62..8397c0b00ef 100644 --- a/doc/user/snippets.md +++ b/doc/user/snippets.md @@ -27,3 +27,36 @@ Personal snippets are not related to any project and can be created completely i You can download the raw content of a snippet. By default snippets will be downloaded with Linux-style line endings (`LF`). If you want to preserve the original line endings you need to add a parameter `line_ending=raw` (eg. `https://gitlab.com/snippets/SNIPPET_ID/raw?line_ending=raw`). In case a snippet was created using the GitLab web interface the original line ending is Windows-like (`CRLF`). + +## Embedded Snippets + +> Introduced in GitLab 10.8. + +Public snippets can not only be shared, but also embedded on any website. This +allows to reuse a GitLab snippet in multiple places and any change to the source +is automatically reflected in the embedded snippet. + +To embed a snippet, first make sure that: + +- The project is public (if it's a project snippet) +- The snippet is public +- In **Project > Settings > Permissions**, the snippets permissions are + set to **Everyone with access** + +Once the above conditions are met, the "Embed" section will appear in your snippet +where you can simply click on the "Copy to clipboard" button. This copies a one-line +script that you can add to any website or blog post. + +Here's how an example code looks like: + +```html +<script src="https://gitlab.com/namespace/project/snippets/SNIPPET_ID.js"></script> +``` + +Here's how an embedded snippet looks like: + +<script src="https://gitlab.com/gitlab-org/gitlab-ce/snippets/1717978.js"></script> + +Embedded snippets are displayed with a header that shows the file name if defined, +the snippet size, a link to GitLab, and the actual snippet content. Actions in +the header allow users to see the snippet in raw format and download it. |