mirror of
https://github.com/foo-dogsquared/asciidoctor-foodogsquared-extensions.git
synced 2025-01-31 10:58:11 +00:00
38 lines
1.3 KiB
Plaintext
38 lines
1.3 KiB
Plaintext
= GitLab link inline macro
|
|
:toc:
|
|
|
|
|
|
An inline macro for easily linking objects from GitLab instances.
|
|
|
|
|
|
== Synopsis
|
|
|
|
[source, asciidoc]
|
|
----
|
|
gitlab:$OWNER/$REPO[$CAPTION]
|
|
----
|
|
|
|
|
|
== Attributes
|
|
|
|
- `domain` is the base domain of the GitLab instance.
|
|
By default, it points to the official instance of `gitlab.com`.
|
|
|
|
- `rev` is the commit of the repo.
|
|
By default. it doesn't point to anything which should be in the default branch of the repository.
|
|
|
|
- `path` is the filepath to be linked.
|
|
|
|
There are settings that is enabled with the link:https://docs.asciidoctor.org/asciidoc/latest/attributes/options/[options attribute].
|
|
|
|
- `repo` sets the default caption to be the repo part.
|
|
|
|
|
|
== Example usage
|
|
|
|
- `gitlab:gitlab-org/gitlab[]` will link to link:https://gitlab.com/gitlab-org/gitlab[the GitLab's source code with the default domain].
|
|
|
|
- `gitlab:gitlab-org/gitlab[rev=0c9f77389424b6c5fd8e96b227e9125a13a07cb3, path=README.md]` should link to the link:https://gitlab.com/gitlab-org/gitlab/-/blob/0c9f77389424b6c5fd8e96b227e9125a13a07cb3/README.md[GitLab's README from 3 years ago].
|
|
|
|
- `gitlab:GNOME/mutter[domain=gitlab.gnome.org, rev=df653b95adf6462fc731998eb53b0860baa7253c, path=meson.build]` should link to link:https://gitlab.gnome.org/GNOME/mutter/-/blob/df653b95adf6462fc731998eb53b0860baa7253c/meson.build[Mutter v44.beta `meson.build` from GNOME GitLab instance].
|