Use .Page.GetPage in examples of an include shortcode

gohugoio · Dec 17, 2024 · 2f1843d · 2f1843d
1 parent 9e1c85b
commit 2f1843d
Show file tree

Hide file tree

Showing 2 changed files with 16 additions and 4 deletions.
diff --git a/content/en/methods/page/RenderShortcodes.md b/content/en/methods/page/RenderShortcodes.md
@@ -24,8 +24,14 @@ Use this method in shortcode templates to compose a page from multiple content f
 For example:
 
 {{< code file=layouts/shortcodes/include.html >}}
-{{ with site.GetPage (.Get 0) }}
-  {{ .RenderShortcodes }}
+{{ with .Get 0 }}
+  {{ with $.Page.GetPage . }}
+    {{ .RenderShortcodes }}
+  {{ else }}
+    {{ errorf "The %q shortcode was unable to find %q. See %s" $.Name . $.Position }}
+  {{ end }}
+{{ else }}
+  {{ errorf "The %q shortcode requires a positional parameter indicating the logical path of the file to include. See %s" .Name .Position }}
 {{ end }}
 {{< /code >}}
 

diff --git a/content/en/render-hooks/_common/pageinner.md b/content/en/render-hooks/_common/pageinner.md
@@ -9,8 +9,14 @@ _comment: Do not remove front matter.
 The primary use case for `PageInner` is to resolve links and [page resources] relative to an included `Page`. For example, create an "include" shortcode to compose a page from multiple content files, while preserving a global context for footnotes and the table of contents:
 
 {{< code file=layouts/shortcodes/include.html >}}
-{{ with site.GetPage (.Get 0) }}
-  {{ .RenderShortcodes }}
+{{ with .Get 0 }}
+  {{ with $.Page.GetPage . }}
+    {{ .RenderShortcodes }}
+  {{ else }}
+    {{ errorf "The %q shortcode was unable to find %q. See %s" $.Name . $.Position }}
+  {{ end }}
+{{ else }}
+  {{ errorf "The %q shortcode requires a positional parameter indicating the logical path of the file to include. See %s" .Name .Position }}
 {{ end }}
 {{< /code >}}