summaryrefslogtreecommitdiff
path: root/doc/haunt.texi
diff options
context:
space:
mode:
authorDavid Thompson <dthompson2@worcester.edu>2023-12-27 17:43:09 -0500
committerDavid Thompson <dthompson2@worcester.edu>2023-12-28 08:25:23 -0500
commit6e0a1f08635178ef90671865579d444666bda598 (patch)
tree0dd29c474bfcc049555efb2c5c576cc68f015425 /doc/haunt.texi
parent6607891d785d59c4cafbcbd85f7a59ed45865e54 (diff)
post: Add post-slug-v2 procedure.
Diffstat (limited to 'doc/haunt.texi')
-rw-r--r--doc/haunt.texi13
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/haunt.texi b/doc/haunt.texi
index a612f35..cfeff16 100644
--- a/doc/haunt.texi
+++ b/doc/haunt.texi
@@ -560,6 +560,19 @@ Transform the title of @var{post} into a URL slug suitable for the
file name of a web page.
@end deffn
+The original @code{post-slug} procedure above has some less than ideal
+behavior. One issue is that version numbers like ``1.2.3'' get
+transformed to ``123'' rather than something more sensible like
+``1-2-3''. Unfortunately, changing this behavior would mean breaking
+the URLs for existing Haunt sites. Instead, users may opt-in to using
+@code{post-slug-v2} by passing it as the @code{#:make-slug} argument
+to @code{make-site}. @xref{Sites} for more information.
+
+@deffn {Procedure} post-slug-v2 post
+Transform the title of @var{post} into a URL slug. This second
+revision does a better job than the original.
+@end deffn
+
@defvr {Variable} %default-date
The default date of a post when no other date is specified in the
metadata association list.