@@ -74,18 +74,22 @@ The @racket[_order] expression must evaluate to either @racket["ASC"] or @racket["DESC"] and the @racket[_limit] expressions must evaluate to a value suitable for use in the @tt{LIMIT} clause of @ext-link["https://sqlite.org/lang_select.html"]{a SQLite @tt{SELECT} statement}. An expression that evaluates to a negative integer (the default) is the same as having no limit. -@deftogether[(@defproc[(list-short/articles [#:series series (or/c string? boolean?) #t] +@deftogether[(@defproc[(listing<>-short/articles [#:series series (or/c string? boolean?) #t] [#:limit limit stringish? -1] [order string? "DESC"]) txexpr?] - @defproc[(list-full/articles [#:series series (or/c string? boolean?) #t] + @defproc[(listing<>-full/articles [#:series series (or/c string? boolean?) #t] [#:limit limit stringish? -1] [order string? "DESC"]) txexpr?])] -Fetches the HTML for all articles from the SQLite cache and returns the HTML strings inside +@margin-note{Notice how the functions that start with @tt{list/} return lists and the functions that +start with @tt{listing<>} return fenced HTML strings. Maybe this is ugly, but it helps me keep these +otherwise too-similar sets of functions straight in my head.} + +Fetches the HTML for all articles from the SQLite cache and returns the HTML strings fenced inside a @racket['style] tagged X-expression. The articles will be ordered by publish date according to @racket[_order] and optionally limited to the series specified in @racket[_series]. If @racket[_series] expression evaluates to @racket[#f], articles will not be filtered by series. If it evaluates to @racket[#t] (the default), articles will be filtered by those that specify the @@ -102,23 +106,24 @@ escaped by @racket[->html] in the template. This tag was picked for the job because there will generally never be a need to include any actual CSS information inside a @tt{"] removed. The contents of the style tags are left intact. Use this with strings returned from @racket[->html] when called on docs containing -@racket[list-full/articles] or its siblings. +@racket[listing<>-full/articles] or its siblings. @defproc[(article-plain-title [pagenode pagenode?]) non-empty-string?] Fetches the “plain” title (i.e., with no HTML markup) for the given article from the SQLite cache. If the article did not specify a title, a default title is supplied. If the article contained