website

mirror of https://github.com/foo-dogsquared/website.git synced 2025-01-31 16:58:03 +00:00

History

Gabriel Arazas f7e2b3a2b7 Update Asciidoctor extension dependency Asciidoctor already handles the caching so we don't really need to. On the plus side, it gives some choice whether the pipeline should have a cache or not.		2023-05-28 17:49:15 +08:00
..
extension.rb	Update Asciidoctor extension dependency	2023-05-28 17:49:15 +08:00
README.adoc	Add MusicBrainz link inline macro	2023-05-27 19:37:24 +08:00

Table of Contents

An inline macro for easily linking objects from Musicbrainz database.

Synopsis

musicbrainz:$ID[$CAPTION, $TYPE]

$ID is the database identifier for that object (e.g., 9adcff14-7dba-4ccf-a6a6-298bcde3dd46).
$CAPTION is the link text. By default, it will be the name of the database object (if valid). Take note it will use the MusicBrainz API to query the title/name of the object. In other words, it costs an additional network request.
$TYPE is the database object type. It defaults to 'Release' object type.

The macro can also accept some attributes.

caption is the link text to be used. This can be used instead of the first positional attribute.
type is the database object type to be queried. This can be used instead of the second positional attribute.

musicbrainz:9adcff14-7dba-4ccf-a6a6-298bcde3dd46[] should have a link to the Musicbrainz page for The Bindings of Isaac Rebirth with 'The Bindings of Isaac: Rebirth' as the link caption.
musicbrainz:9adcff14-7dba-4ccf-a6a6-298bcde3dd46[Ridiculon’s Rebirth soundtrack] same as above but with the link text replaced with 'Ridiculon’s Rebirth Soundtrack'.
musicbrainz:b7c7f603-4c42-45a4-b364-3ddba82da412[type=release-group] links to the Musicbrainz page for The Bindings of Isaac Rebirth release group with 'The Bindings of Isaac: Rebirth' as the link text.
musicbrainz:f07c6afe-ee84-4cd5-9b11-5c541d1dff3b[type=artist] links to Musicbrainz page for Ridiculon with their name as the caption.