Introduce a convenience shortcode to link to keywords

content/2020-12/applicator/allOf.markdown

@@ -28,7 +28,7 @@ related:
     keyword: not
 ---
 
-The `allOf` keyword is used to specify that a given instance must validate against all of the subschemas provided within an array. It's essentially a logical "AND" operation where all conditions must be met for validation to pass.
+The {{<link keyword="allOf" vocabulary="applicator">}} keyword is used to specify that a given instance must validate against all of the subschemas provided within an array. It's essentially a logical "AND" operation where all conditions must be met for validation to pass.
 
 ## Examples
 
@@ -129,7 +129,7 @@ The `allOf` keyword is used to specify that a given instance must validate again
 {{<instance-fail `An instance conforming to the second subschema of 'allOf' is also invalid`>}}
 { "foo": "foo" }
 {{</instance-fail>}}
-* _Remember, if any subschema within the `allOf` keyword fails validation or has a boolean `false` value, the entire validation will always fail._
+* _Remember, if any subschema within the {{<link keyword="allOf" vocabulary="applicator">}} keyword fails validation or has a boolean `false` value, the entire validation will always fail._
 
 {{<schema `Schema with nested 'allOf'`>}}
 {

layouts/shortcodes/link.html

@@ -0,0 +1,12 @@
+{{- $dialect := .Get "dialect" | default .Page.Section -}}
+{{- $vocabulary := .Get "vocabulary" | default .Page.Parent.Params.title -}}
+{{- $keyword := .Get "keyword" -}}
+
+{{- if (not $keyword) -}}
+{{- errorf "keyword parameter is required for this shortcode." -}}
+{{- end -}}
+
+{{ $vocabularyURL := $vocabulary | lower | printf "%s/%s" $dialect }}
+{{ $keywordURL := (replace $keyword "$" "") | lower | printf "/%s/%s" $vocabularyURL }}
+
+<a class="font-monospace" href="{{ ref $ $keywordURL }}" data-bs-toggle="tooltip" data-bs-title="Vocabulary: {{ title $vocabulary }}">{{ $keyword }}</a>