foodogsquared/asciidoctor-foodogsquared-extensions
1
0
Fork 0
mirror of https://github.com/foo-dogsquared/asciidoctor-foodogsquared-extensions.git synced 2025-01-31 10:58:11 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
94681a0450
asciidoctor-foodogsquared-e.../lib/asciidoctor/swhid-inline-macro
History
Gabriel Arazas e18383275e Add SWHID link inline macro
2023-03-05 09:47:44 +08:00
..
extension.rb Add SWHID link inline macro 2023-03-05 09:47:44 +08:00
README.adoc Add SWHID link inline macro 2023-03-05 09:47:44 +08:00

README.adoc

Table of Contents

An inline macro for easily linking SWHIDs.

swh:$SWHID[$CAPTION]

If no caption is given, the link text will be the core identifier of the SWHID.

Extra notes

You would use like in the following form swh:swh:1:snp:6ea7d28dfd4789609e0be2b64179fc9c12931beb[] but you could also cut off swh: from the SWHID if you want to (i.e., swh:1:snp:6ea7d28dfd4789609e0be2b64179fc9c12931beb[]) to make it aesthetically pleasing.

Whatever your preference is, the best practice for dealing with linking SWHIDs with this macro is setting attributes containing the SWHIDs.

= doctitle
:swhid-nixpkgs: swh:1:dir:2885ecf76632a83610d8e95f0eb3383109a7c90a

{swhid-nixpkgs}[this revision of nixpkgs]
or
swh:{swhid-nixpkgs}[that revision of nixpkgs]

Example usage

This should work with the following types of SWHIDs.

  • A SWHID with only the core identifier: swh:1:snp:6ea7d28dfd4789609e0be2b64179fc9c12931beb[].

  • A SWHID with only one qualifier: swh:1:cnt:ce4dd1988d2d5dfcec48252757a6fea94339ac38;lines=3-4[]

  • A SWHID with full contextual information. This is as depicted from the recommended practice for writings (i.e., blog posts, technical documentation, research papers) when referring to one of the objects in the archive.

    swh:1:dir:2885ecf76632a83610d8e95f0eb3383109a7c90a;origin=https://github.com/NixOS/nixpkgs;visit=swh:1:snp:6ea7d28dfd4789609e0be2b64179fc9c12931beb;anchor=swh:1:rev:b7ee21d0ced814d07b7d5aca334dfe018ceafaa5[]