Expand description
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 (
crate::post) - Converting the posts into output files on disk (
crate::write)
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.
Modules
Exports the build_site function which stitches together the high-level
steps of building the output static site: parsing the posts
(crate::post), rendering index and post pages (crate::write),
copying the static source directory into the static output directory, and
generating the Atom feed.
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_html to support footnotes in summaries.
pulldown_cmark::html::push_html assumes 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 Post, Parser, and Error types. Also defines the
logic for parsing posts from the file system into memory. See the
Post::to_value and Post::summarize for details on how posts are
converted into template values.
Defines the Tag type, which represents a crate::post::Post tag.
Takes Post objects created by the crate::post module and turns them
into index and post HTML files on the file system.