asciidoctor-foodogsquared-extensions/README.adoc at a95b09a81f623554e4e747063befcf5a14fd060e

Gabriel Arazas ca82f674af 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.