The library code for the
futhorc static site generator. The architecture
can be generally broken down into two distinct steps:
- Parsing posts from source files on disk (
- Converting the posts into output files on disk (
Of the two, the second step is the more involved. It is itself composed of three distinct sub-steps:
- Building post pages
- Building index pages
- Rendering all pages to disk
Again here the second sub-step is the more involved, because we need to create groups of index pages for each tag and another group for the empty tag which corresponds to all posts. A group of index pages is referred to as an “index”, and each index is paginated–converted into groups of pages based on a configurable number of posts per index page.
The third substep is pretty straight-forward: for each page, apply the template (either the post template or the index template) and write the result to disk.
- Contains the logic for collecting and consolidating the program’s configuration.
- Support for creating Atom feeds from a list of posts.
- Implements a custom
push_htmlto support footnotes in summaries.
pulldown_cmark::html::push_htmlassumes that the footnote definition is on the same page as the footnote reference, which is true for post pages, but not for the index pages (in cases where the footnote reference appears above the fold in the post summary, but the footnote definition is at the bottom of the post page).
- Defines the