ref #376 add a test case on how to use Antora resource IDs

test/antora/docs/modules/ROOT/examples/barley.json

@@ -0,0 +1,120 @@
+[{"yield":27,"variety":"Manchuria","year":1931,"site":"University Farm"},
+  {"yield":48.86667,"variety":"Manchuria","year":1931,"site":"Waseca"},
+  {"yield":27.43334,"variety":"Manchuria","year":1931,"site":"Morris"},
+  {"yield":39.93333,"variety":"Manchuria","year":1931,"site":"Crookston"},
+  {"yield":32.96667,"variety":"Manchuria","year":1931,"site":"Grand Rapids"},
+  {"yield":28.96667,"variety":"Manchuria","year":1931,"site":"Duluth"},
+  {"yield":43.06666,"variety":"Glabron","year":1931,"site":"University Farm"},
+  {"yield":55.2,"variety":"Glabron","year":1931,"site":"Waseca"},
+  {"yield":28.76667,"variety":"Glabron","year":1931,"site":"Morris"},
+  {"yield":38.13333,"variety":"Glabron","year":1931,"site":"Crookston"},
+  {"yield":29.13333,"variety":"Glabron","year":1931,"site":"Grand Rapids"},
+  {"yield":29.66667,"variety":"Glabron","year":1931,"site":"Duluth"},
+  {"yield":35.13333,"variety":"Svansota","year":1931,"site":"University Farm"},
+  {"yield":47.33333,"variety":"Svansota","year":1931,"site":"Waseca"},
+  {"yield":25.76667,"variety":"Svansota","year":1931,"site":"Morris"},
+  {"yield":40.46667,"variety":"Svansota","year":1931,"site":"Crookston"},
+  {"yield":29.66667,"variety":"Svansota","year":1931,"site":"Grand Rapids"},
+  {"yield":25.7,"variety":"Svansota","year":1931,"site":"Duluth"},
+  {"yield":39.9,"variety":"Velvet","year":1931,"site":"University Farm"},
+  {"yield":50.23333,"variety":"Velvet","year":1931,"site":"Waseca"},
+  {"yield":26.13333,"variety":"Velvet","year":1931,"site":"Morris"},
+  {"yield":41.33333,"variety":"Velvet","year":1931,"site":"Crookston"},
+  {"yield":23.03333,"variety":"Velvet","year":1931,"site":"Grand Rapids"},
+  {"yield":26.3,"variety":"Velvet","year":1931,"site":"Duluth"},
+  {"yield":36.56666,"variety":"Trebi","year":1931,"site":"University Farm"},
+  {"yield":63.8333,"variety":"Trebi","year":1931,"site":"Waseca"},
+  {"yield":43.76667,"variety":"Trebi","year":1931,"site":"Morris"},
+  {"yield":46.93333,"variety":"Trebi","year":1931,"site":"Crookston"},
+  {"yield":29.76667,"variety":"Trebi","year":1931,"site":"Grand Rapids"},
+  {"yield":33.93333,"variety":"Trebi","year":1931,"site":"Duluth"},
+  {"yield":43.26667,"variety":"No. 457","year":1931,"site":"University Farm"},
+  {"yield":58.1,"variety":"No. 457","year":1931,"site":"Waseca"},
+  {"yield":28.7,"variety":"No. 457","year":1931,"site":"Morris"},
+  {"yield":45.66667,"variety":"No. 457","year":1931,"site":"Crookston"},
+  {"yield":32.16667,"variety":"No. 457","year":1931,"site":"Grand Rapids"},
+  {"yield":33.6,"variety":"No. 457","year":1931,"site":"Duluth"},
+  {"yield":36.6,"variety":"No. 462","year":1931,"site":"University Farm"},
+  {"yield":65.7667,"variety":"No. 462","year":1931,"site":"Waseca"},
+  {"yield":30.36667,"variety":"No. 462","year":1931,"site":"Morris"},
+  {"yield":48.56666,"variety":"No. 462","year":1931,"site":"Crookston"},
+  {"yield":24.93334,"variety":"No. 462","year":1931,"site":"Grand Rapids"},
+  {"yield":28.1,"variety":"No. 462","year":1931,"site":"Duluth"},
+  {"yield":32.76667,"variety":"Peatland","year":1931,"site":"University Farm"},
+  {"yield":48.56666,"variety":"Peatland","year":1931,"site":"Waseca"},
+  {"yield":29.86667,"variety":"Peatland","year":1931,"site":"Morris"},
+  {"yield":41.6,"variety":"Peatland","year":1931,"site":"Crookston"},
+  {"yield":34.7,"variety":"Peatland","year":1931,"site":"Grand Rapids"},
+  {"yield":32,"variety":"Peatland","year":1931,"site":"Duluth"},
+  {"yield":24.66667,"variety":"No. 475","year":1931,"site":"University Farm"},
+  {"yield":46.76667,"variety":"No. 475","year":1931,"site":"Waseca"},
+  {"yield":22.6,"variety":"No. 475","year":1931,"site":"Morris"},
+  {"yield":44.1,"variety":"No. 475","year":1931,"site":"Crookston"},
+  {"yield":19.7,"variety":"No. 475","year":1931,"site":"Grand Rapids"},
+  {"yield":33.06666,"variety":"No. 475","year":1931,"site":"Duluth"},
+  {"yield":39.3,"variety":"Wisconsin No. 38","year":1931,"site":"University Farm"},
+  {"yield":58.8,"variety":"Wisconsin No. 38","year":1931,"site":"Waseca"},
+  {"yield":29.46667,"variety":"Wisconsin No. 38","year":1931,"site":"Morris"},
+  {"yield":49.86667,"variety":"Wisconsin No. 38","year":1931,"site":"Crookston"},
+  {"yield":34.46667,"variety":"Wisconsin No. 38","year":1931,"site":"Grand Rapids"},
+  {"yield":31.6,"variety":"Wisconsin No. 38","year":1931,"site":"Duluth"},
+  {"yield":26.9,"variety":"Manchuria","year":1932,"site":"University Farm"},
+  {"yield":33.46667,"variety":"Manchuria","year":1932,"site":"Waseca"},
+  {"yield":34.36666,"variety":"Manchuria","year":1932,"site":"Morris"},
+  {"yield":32.96667,"variety":"Manchuria","year":1932,"site":"Crookston"},
+  {"yield":22.13333,"variety":"Manchuria","year":1932,"site":"Grand Rapids"},
+  {"yield":22.56667,"variety":"Manchuria","year":1932,"site":"Duluth"},
+  {"yield":36.8,"variety":"Glabron","year":1932,"site":"University Farm"},
+  {"yield":37.73333,"variety":"Glabron","year":1932,"site":"Waseca"},
+  {"yield":35.13333,"variety":"Glabron","year":1932,"site":"Morris"},
+  {"yield":26.16667,"variety":"Glabron","year":1932,"site":"Crookston"},
+  {"yield":14.43333,"variety":"Glabron","year":1932,"site":"Grand Rapids"},
+  {"yield":25.86667,"variety":"Glabron","year":1932,"site":"Duluth"},
+  {"yield":27.43334,"variety":"Svansota","year":1932,"site":"University Farm"},
+  {"yield":38.5,"variety":"Svansota","year":1932,"site":"Waseca"},
+  {"yield":35.03333,"variety":"Svansota","year":1932,"site":"Morris"},
+  {"yield":20.63333,"variety":"Svansota","year":1932,"site":"Crookston"},
+  {"yield":16.63333,"variety":"Svansota","year":1932,"site":"Grand Rapids"},
+  {"yield":22.23333,"variety":"Svansota","year":1932,"site":"Duluth"},
+  {"yield":26.8,"variety":"Velvet","year":1932,"site":"University Farm"},
+  {"yield":37.4,"variety":"Velvet","year":1932,"site":"Waseca"},
+  {"yield":38.83333,"variety":"Velvet","year":1932,"site":"Morris"},
+  {"yield":32.06666,"variety":"Velvet","year":1932,"site":"Crookston"},
+  {"yield":32.23333,"variety":"Velvet","year":1932,"site":"Grand Rapids"},
+  {"yield":22.46667,"variety":"Velvet","year":1932,"site":"Duluth"},
+  {"yield":29.06667,"variety":"Trebi","year":1932,"site":"University Farm"},
+  {"yield":49.2333,"variety":"Trebi","year":1932,"site":"Waseca"},
+  {"yield":46.63333,"variety":"Trebi","year":1932,"site":"Morris"},
+  {"yield":41.83333,"variety":"Trebi","year":1932,"site":"Crookston"},
+  {"yield":20.63333,"variety":"Trebi","year":1932,"site":"Grand Rapids"},
+  {"yield":30.6,"variety":"Trebi","year":1932,"site":"Duluth"},
+  {"yield":26.43334,"variety":"No. 457","year":1932,"site":"University Farm"},
+  {"yield":42.2,"variety":"No. 457","year":1932,"site":"Waseca"},
+  {"yield":43.53334,"variety":"No. 457","year":1932,"site":"Morris"},
+  {"yield":34.33333,"variety":"No. 457","year":1932,"site":"Crookston"},
+  {"yield":19.46667,"variety":"No. 457","year":1932,"site":"Grand Rapids"},
+  {"yield":22.7,"variety":"No. 457","year":1932,"site":"Duluth"},
+  {"yield":25.56667,"variety":"No. 462","year":1932,"site":"University Farm"},
+  {"yield":44.7,"variety":"No. 462","year":1932,"site":"Waseca"},
+  {"yield":47,"variety":"No. 462","year":1932,"site":"Morris"},
+  {"yield":30.53333,"variety":"No. 462","year":1932,"site":"Crookston"},
+  {"yield":19.9,"variety":"No. 462","year":1932,"site":"Grand Rapids"},
+  {"yield":22.5,"variety":"No. 462","year":1932,"site":"Duluth"},
+  {"yield":28.06667,"variety":"Peatland","year":1932,"site":"University Farm"},
+  {"yield":36.03333,"variety":"Peatland","year":1932,"site":"Waseca"},
+  {"yield":43.2,"variety":"Peatland","year":1932,"site":"Morris"},
+  {"yield":25.23333,"variety":"Peatland","year":1932,"site":"Crookston"},
+  {"yield":26.76667,"variety":"Peatland","year":1932,"site":"Grand Rapids"},
+  {"yield":31.36667,"variety":"Peatland","year":1932,"site":"Duluth"},
+  {"yield":30,"variety":"No. 475","year":1932,"site":"University Farm"},
+  {"yield":41.26667,"variety":"No. 475","year":1932,"site":"Waseca"},
+  {"yield":44.23333,"variety":"No. 475","year":1932,"site":"Morris"},
+  {"yield":32.13333,"variety":"No. 475","year":1932,"site":"Crookston"},
+  {"yield":15.23333,"variety":"No. 475","year":1932,"site":"Grand Rapids"},
+  {"yield":27.36667,"variety":"No. 475","year":1932,"site":"Duluth"},
+  {"yield":38,"variety":"Wisconsin No. 38","year":1932,"site":"University Farm"},
+  {"yield":58.16667,"variety":"Wisconsin No. 38","year":1932,"site":"Waseca"},
+  {"yield":47.16667,"variety":"Wisconsin No. 38","year":1932,"site":"Morris"},
+  {"yield":35.9,"variety":"Wisconsin No. 38","year":1932,"site":"Crookston"},
+  {"yield":20.66667,"variety":"Wisconsin No. 38","year":1932,"site":"Grand Rapids"},
+  {"yield":29.33333,"variety":"Wisconsin No. 38","year":1932,"site":"Duluth"}]

test/antora/docs/modules/ROOT/examples/styles.puml

@@ -0,0 +1 @@
+!theme spacelab

test/antora/docs/modules/ROOT/nav.adoc

@@ -3,4 +3,5 @@
 * xref:embedding.adoc[Choices for generated html]
 * xref:embeddingblockmacro.adoc[Choices for generated html, using the block macro]
 * xref:attributes.adoc[Choices for positional, named, and page/global attributes]
-* xref:topic/index.adoc[Similar diagrams on a topic page]
+* xref:topic/index.adoc[Similar diagrams on a topic page]
+* xref:resolve-antora-resource-ids.adoc[]

test/antora/docs/modules/ROOT/pages/resolve-antora-resource-ids.adoc

@@ -0,0 +1,23 @@
+= Resolve Antora Resource IDs
+
+[vegalite]
+....
+{
+  "$schema": "https://vega.github.io/schema/vega-lite/v5.json",
+  "data": {"url": "example$barley.json"},
+  "mark": "bar",
+  "encoding": {
+    "x": {"aggregate": "sum", "field": "yield"},
+    "y": {"field": "variety"},
+    "color": {"field": "site"}
+  }
+}
+....
+
+[plantuml]
+....
+!include example$styles.puml
+
+alice -> bob
+bob -> alice
+....