From 8567ccde82c88fa5516b5f6363f1a4f06a8f745c Mon Sep 17 00:00:00 2001
From: Joe Mooring <joe.mooring@veriphor.com>
Date: Tue, 13 Aug 2024 13:25:58 -0700
Subject: [PATCH] Document Page.Markup

---
 content/en/functions/hugo/Context.md | 26 ++++++++++
 content/en/methods/page/Markup.md    | 72 ++++++++++++++++++++++++++++
 2 files changed, 98 insertions(+)
 create mode 100644 content/en/functions/hugo/Context.md
 create mode 100644 content/en/methods/page/Markup.md

diff --git a/content/en/functions/hugo/Context.md b/content/en/functions/hugo/Context.md
new file mode 100644
index 000000000..a7742a6f8
--- /dev/null
+++ b/content/en/functions/hugo/Context.md
@@ -0,0 +1,26 @@
+---
+title: hugo.Context
+description: # TODO
+categories: []
+keywords: []
+params:
+  functions_and_methods:
+    aliases: []
+    returnType: string
+    signatures: [hugo.Context]
+---
+
+<!-- TODO -->
+<!-- https://github.com/gohugoio/hugo/pull/12759 -->
+
+## Contexts
+
+<!-- TODO -->
+
+###### MarkupScope
+
+<!-- TODO -->
+
+```go-html-template
+{{ hugo.Context.MarkupScope }} → xxxxxx
+```
diff --git a/content/en/methods/page/Markup.md b/content/en/methods/page/Markup.md
new file mode 100644
index 000000000..f36574d32
--- /dev/null
+++ b/content/en/methods/page/Markup.md
@@ -0,0 +1,72 @@
+---
+title: Markup
+description: # TODO
+categories: []
+keywords: []
+params:
+  functions_and_methods:
+    returnType: # TODO
+    signatures: [PAGE.Markup]
+---
+
+<!-- TODO -->
+<!-- https://github.com/gohugoio/hugo/pull/12759 -->
+
+<!-- JMM It is unclear to me if things like .Page.WordCount will be deprecated in favor of .Page.Markup.CountWords. Three levels (Page, Markup, Countwords) is a bit of a pain to document with the current docs theme. Several of the Markup methods required their own page.
+
+So maybe make Markup a first-level method, noting that it's a method on Page. Then each method on Markup will have its own page.
+-->
+
+## Methods
+
+###### CountWords
+(`int`) <!-- TODO -->
+
+###### CountWordsFuzzy
+(`int`) <!-- TODO -->
+
+###### Fragments
+(`tableofcontents.Fragments`) <!-- TODO -->
+
+###### FragmentsHTML
+(`template.HTML`) <!-- TODO -->
+
+###### HasShortcode
+(`bool`) <!-- TODO -->
+
+###### Len
+(`int`) <!-- TODO -->
+
+###### Plain
+(`string`) <!-- TODO -->
+
+###### PlainWords
+(`string array`) <!-- TODO -->
+
+###### ReadingTime
+(`int`) <!-- TODO -->
+
+###### Render
+(`any`) <!-- TODO -->
+
+###### RenderShortcodes
+(`template.HTM`) <!-- TODO -->
+
+###### RenderString
+(`template.HTM`) <!-- TODO -->
+
+###### Summary
+(`template.HTML`) <!-- TODO -->
+
+## Example
+
+<!-- TODO -->
+
+```go-html-template
+{{ range .Pages }}
+  {{ with .Markup }}
+    {{ .Countwords }}
+    {{ .Render }}
+  {{ end }}
+{{ end }}
+```