summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDavid Thompson <dthompson2@worcester.edu>2023-12-27 17:43:28 -0500
committerDavid Thompson <dthompson2@worcester.edu>2023-12-28 08:49:08 -0500
commite6d60cdcb62e9e3fefa6be56124cc81c9072324c (patch)
tree0912252eabc991a5da1ef146195ab961693edd8c /doc
parent6e0a1f08635178ef90671865579d444666bda598 (diff)
builder: blog: Add #:post-prefix parameter.
This allows for posts to be nested deeper than the collections.
Diffstat (limited to 'doc')
-rw-r--r--doc/haunt.texi12
1 files changed, 8 insertions, 4 deletions
diff --git a/doc/haunt.texi b/doc/haunt.texi
index cfeff16..178565a 100644
--- a/doc/haunt.texi
+++ b/doc/haunt.texi
@@ -851,8 +851,8 @@ output directory. By default, @var{dest} is @var{directory}.
(use-modules (haunt builder blog))
@end example
-@deffn {Procedure} theme [#:name #:layout #:post-template #:collection-template @
- #:pagination-template]
+@deffn {Procedure} theme [#:name "Untitled"] [#:layout] [#:post-template] @
+ [#:collection-template] [#:pagination-template]
Create a new theme named @var{name}.
The procedure @var{layout} accepts three arguments: a site, a page
@@ -880,10 +880,14 @@ links.
Return @code{#t} if @var{object} is a theme object.
@end deffn
-@deffn {Procedure} blog [#:theme #:prefix #:collections #:posts-per-page]
+@deffn {Procedure} blog [#:theme] [#:prefix] [#:post-prefix] @
+ [#:collections `(("Recent Posts" "index.html" ,posts/reverse-chronological))] @
+ [#:posts-per-page]
+
Create a builder procedure that transforms a list of posts into pages
decorated by @var{theme}, a theme object, whose URLs start with
-@var{prefix}.
+@var{prefix}. Post pages may be nested deeper in the file hierarchy
+than collection pages by specifying the @var{post-prefix} argument.
Additionally, this builder creates pages that aggregate previews of
many posts corresponding to what is specified in the list