asciidoctor-foodogsquared-extensions

History

Gabriel Arazas 6f3ee231f2 Add `repo` option for GitLab link inline macro		2023-05-06 15:22:42 +08:00
..
extension.rb	Add `repo` option for GitLab link inline macro	2023-05-06 15:22:42 +08:00
README.adoc	Add `repo` option for GitLab link inline macro	2023-05-06 15:22:42 +08:00

Table of Contents

An inline macro for easily linking objects from GitLab instances.

Synopsis

gitlab:$OWNER/$REPO[$CAPTION]

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 options attribute.

gitlab:gitlab-org/gitlab[] will link to the GitLab’s source code with the default domain.
gitlab:gitlab-org/gitlab[rev=0c9f77389424b6c5fd8e96b227e9125a13a07cb3, path=README.md] should link to the GitLab’s README from 3 years ago.
gitlab:GNOME/mutter[domain=gitlab.gnome.org, rev=df653b95adf6462fc731998eb53b0860baa7253c, path=meson.build] should link to Mutter v44.beta meson.build from GNOME GitLab instance.