Index: code-docs/main.scrbl ================================================================== --- code-docs/main.scrbl +++ code-docs/main.scrbl @@ -37,12 +37,11 @@ those on the lower rows. The bottom row are the @tt{.poly.pm} files that make up @tech{articles} and @tech{series}. Individual articles, while they are being rendered to HTML pages, save copies of their metadata and HTML to the SQLite cache. This is done by calling @racket[parse-and-cache-article!] from within -their template. Likewise, series pages cache themselves with a call to @racket[cache-series!] from -within their template. +their template. Any pages that gather content from multiple articles, such as Series pages and the RSS feed, pull this content directly from the SQLite cache. This is much faster than trawling through Pollen’s cached metas of every article looking for matching articles. Index: code-docs/tour.scrbl ================================================================== --- code-docs/tour.scrbl +++ code-docs/tour.scrbl @@ -47,11 +47,11 @@ @filebox["articles/my-new-post.poly.pm" @codeblock|{ #lang pollen ◊; Copyright 2020 by Joel Dueck. All Rights Reserved. -◊(define-meta draft #t) +◊(define-meta conceal "blog,rss") ◊(define-meta published "2020-01-18") ◊title{My New Post} Write here! @@ -59,14 +59,15 @@ At this point I might delete the @tt{◊title} line, since specifying a formal title is optional (other than the one needed to generate the filename). I might also add a @racket[define-meta] for @tt{series} or @tt{topics}. -As long as the @racket[define-meta] for @tt{draft} is @racket[#t], the new article will not appear -in the RSS feed, or in the blog or any series pages. +As long as the @racket[define-meta] for @tt{conceal} contains @racket{rss}, the new article will not +appear in the RSS feed; as long as it contains @racket{blog} it will not appear in the blog. This is +useful for when an article is in a draft state, or simply when you want to keep it semi-hidden. -When satisfied with the post I’ll remove the @racket[define-meta] for @tt{draft}, save it one last +When satisfied with the post I’ll remove the @racket[define-meta] for @tt{conceal}, save it one last time, then go back to the terminal: @terminal{ @cmd{> make web} [lots of output: rebuilds blog pages, keyword index, RSS feed]