summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/haunt.texi36
1 files changed, 36 insertions, 0 deletions
diff --git a/doc/haunt.texi b/doc/haunt.texi
index 9ba21ed..6f9d226 100644
--- a/doc/haunt.texi
+++ b/doc/haunt.texi
@@ -820,6 +820,7 @@ specification of Markdown, learn more about CommomMark
* Static Assets:: Images, CSS, JavaScript, etc.
* Blog:: Dear diary...
* Atom:: Atom feeds.
+* RSS:: RSS feeds.
@end menu
Builders are procedures that return one or more artifacts
@@ -982,6 +983,41 @@ prefix and post prefix. @xref{Blog} for more information.
@end deffn
+@node RSS
+@subsection RSS
+
+@example
+(use-modules (haunt builder rss))
+@end example
+
+@deffn {Procedure} rss-feed [#:file-name "rss-feed.xml"] [#:subtitle "Recent Posts"] @
+ [#:filter posts/reverse-chronological] @
+ [#:max-entries 20] [#:blog-prefix ""]
+Return a builder procedure that renders a list of posts as an RSS
+feed. All arguments are optional:
+
+@table @var
+
+@item file-name
+The page file name.
+
+@item subtitle
+The feed subtitle.
+
+@item filter
+The procedure called to manipulate the posts list before rendering.
+
+@item max-entries
+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
+
@node Publishers
@section Publishers