summaryrefslogtreecommitdiff
path: root/doc/haunt.texi
diff options
context:
space:
mode:
authorDavid Thompson <dthompson2@worcester.edu>2024-09-24 10:35:07 -0400
committerDavid Thompson <dthompson2@worcester.edu>2024-09-24 10:35:07 -0400
commitb4f7435aab4270ddb7adcb58a7baf75d70132782 (patch)
tree0f3045dfc2b0c77a7563f78c403821f13ae98527 /doc/haunt.texi
parent1f07b6076ae3e35177f481efdc9107b6d4d0611a (diff)
flat-pages: Add index metadata flag for pretty URLs.
Diffstat (limited to 'doc/haunt.texi')
-rw-r--r--doc/haunt.texi20
1 files changed, 20 insertions, 0 deletions
diff --git a/doc/haunt.texi b/doc/haunt.texi
index acc7257..0ac016f 100644
--- a/doc/haunt.texi
+++ b/doc/haunt.texi
@@ -908,6 +908,26 @@ of demonstrating Haunt's flat page functionality. I live here in this
manual with my two cats: Bob and Carol.
@end example
+If the above text were saved to @file{about.md} in the flat pages
+directory, the resulting HTML page would be @file{about.html}.
+
+For ``pretty'' URLS (@file{/about} rather than @file{/about.html}),
+the special metadata item @code{index: true} can be specified in the
+page header:
+
+@example
+title: About me
+index: true
+---
+
+# About me
+
+...
+@end example
+
+With the @code{index} metadata flag, Haunt will generate
+@file{about/index.html} rather than @file{about.html}.
+
The content of each flat page is inserted into a complete HTML
document by the @var{template} procedure. This procedure takes three
arguments: