foodogsquared/asciidoctor-foodogsquared-extensions
1
0
Fork 0
mirror of https://github.com/foo-dogsquared/asciidoctor-foodogsquared-extensions.git synced 2025-01-31 04:58:07 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
7ddcd9be70
asciidoctor-foodogsquared-e.../lib/asciidoctor/github-link-inline-macro
History
Gabriel Arazas d4e3e70e6f Add repo option for GitHub link inline macro
2023-05-06 15:22:53 +08:00
..
extension.rb Add repo option for GitHub link inline macro 2023-05-06 15:22:53 +08:00
README.adoc Add repo option for GitHub link inline macro 2023-05-06 15:22:53 +08:00

README.adoc

Table of Contents

An inline macro that easily links repositories from GitHub.

Synopsis

github:$OWNER/$REPO[$CAPTION]

If caption is missing, the link text will be the namespace (i.e., $OWNER/$REPO) of the repo.

Attributes

There are optional attributes for this macro.

  • rev is the commit/branch/tag of the repo to be linked. When given no caption, it will update the default caption with $OWNER/$REPO@$REV.

  • path is the filepath to be linked within the repo.

  • issue accepts the issue number to be linked in the GitHub repo. Take note issue is exclusive to other attributes and has more precedence. For example, if issue and rev are both present, the link for issue will be the result.

    When given no caption, it will update the default caption with $OWNER/$REPO#$ISSUE.

You can also change certain behaviors with the options attribute.

  • repo sets the default link text with only the repo. Pretty useful to quickly refer to the name of the software.

Example usage

  • github:foo-dogsquared/website[] will link to my website repository with the link text foo-dogsquared/website.

  • github:NixOS/nixpkgs[nixpkgs nixos-unstable branch, rev=nixos-unstable] should link to the NixOS unstable branch of nixpkgs with a caption of nixpkgs nixos-unstable branch.

  • github:errata-ai/vale[Vale v2.3.0 README, path=README.md, rev=v2.3.0] should link to the README of Vale v2.3.0.

  • github:neovim/neovim[Neovim cannot open large files properly, issue=614] should link to an issue of Neovim with Neovim cannot open large files properly as the link text.

  • github:neovim/neovim[Neovim cannot open large files properly, issue=614, rev=master] should still link to an issue of Neovim since issue has more precedence over rev.