From 0517bc566058a2667b32871a17f647c34fed18ff Mon Sep 17 00:00:00 2001 From: David Thompson Date: Wed, 27 Dec 2023 17:42:40 -0500 Subject: builder: atom: Clarify #:blog-prefix parameter. --- doc/haunt.texi | 33 ++++++++++++++++++++------------- 1 file changed, 20 insertions(+), 13 deletions(-) (limited to 'doc') diff --git a/doc/haunt.texi b/doc/haunt.texi index 178565a..9ba21ed 100644 --- a/doc/haunt.texi +++ b/doc/haunt.texi @@ -929,47 +929,54 @@ The default theme is intended only for testing purposes. (use-modules (haunt builder atom)) @end example -@deffn {Procedure} atom-feed [#:file-name #:subtitle #:filter #:max-entries #:blog-prefix] +@deffn {Procedure} atom-feed [#:file-name "feed.xml"] [#:subtitle "Recent Posts"] @ + [#:filter posts/reverse-chronological] @ + [#:max-entries 20] [#:blog-prefix ""] Return a builder procedure that renders a site's posts as an Atom feed. All arguments are optional: @table @var @item file-name: -The page file name. The default is @file{feed.xml}. +The page file name. @item subtitle -The feed subtitle. The default is ``Recent Posts''. +The feed subtitle. @item filter The procedure called to manipulate the posts list before rendering. -The default is to keep all posts and sort them in reverse -chronological order. @item max-entries -The maximum number of posts to render in the feed. The default is 20. +The maximum number of posts to render in the feed. + +@item blog-prefix +The prefix for all post URLs, which is the combination of the blog's +prefix and post prefix. @xref{Blog} for more information. + @end table @end deffn -@deffn {Procedure} atom-feeds-by-tag [#:prefix #:filter #:max-entries #:blog-prefix] +@deffn {Procedure} atom-feeds-by-tag [#:prefix "feeds/tags"] @ + [#:filter posts/reverse-chronological] @ + [#:max-entries 20] [#:blog-prefix ""] Return a builder procedure that renders an atom feed for every tag used in a post. All arguments are optional: @table @var @item prefix -The directory in which to write the feeds. The default is -@file{feeds/tags}. +The directory in which to write the feeds. @item filter The procedure called to manipulate the posts list before rendering. -The default is to keep all posts and sort them in reverse -chronological order. @item max-entries -The maximum number of posts to render in each feed. The default is -20. +The maximum number of posts to render in each feed. + +@item blog-prefix +The prefix for all post URLs, which is the combination of the blog's +prefix and post prefix. @xref{Blog} for more information. @end table -- cgit v1.2.3