@@ -46,10 +46,38 @@ specifies a @racket['series] meta, information about that series is fetched and used in the rendering of the article. If there are @racket[note]s in the doc, they are parsed and saved individually to the SQLite cache. If any of the notes use the @code{#:disposition} attribute, information about the disposition is parsed out and used in the rendering of the article. +@deftogether[(@defproc[(list/articles [type (or/c 'listing_full_html + 'listing_short_html + 'listing_excerpt_html)] + [#:series series (or/c string? boolean?) #t] + [#:limit limit stringish? -1] + [order string? "DESC"]) (listof string?)] + @defproc[(list/articles+notes [type (or/c 'listing_full_html + 'listing_short_html + 'listing_excerpt_html)] + [#:series series (or/c string? boolean?) #t] + [#:limit limit stringish? -1] + [order string? "DESC"]) (listof string?)])] + +Fetches the HTML for all articles from the SQLite cache and returns a list of strings containing the +HTML for each. 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 +current output of @racket[here-output-path] in their @tt{series_pagenode} column in the SQLite +cache. If a string is supplied, articles will be filtered by those containing that exact value in +their @tt{series_pagenode} column in the SQLite cache. + +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] [#:limit limit stringish? -1] [order string? "DESC"]) txexpr?] @defproc[(list-full/articles [#:series series (or/c string? boolean?) #t] [#:limit limit stringish? -1]