Hwaro::Services::Scaffolds::Book
Inherits Hwaro::Services::Scaffolds::Base / Reference / Object
Instance methods
book scaffolds intentionally omit [[taxonomies]] from the
default config — chapter-ordered books don't use tags, and
leaving the config empty keeps the generated taxonomy.html
template from being emitted as dead chrome (it's also dropped
from template_files). Users who want taxonomies can copy from
the simple/blog scaffolds.
Returns sample content files as a hash of path => content
Returns static files as a hash of path => content. Every
scaffold inherits a tiny SVG favicon so a freshly-generated
site doesn't show a blank tab icon. Scaffolds that override
static_files (blog/docs/book) merge super to keep it.
Book templates share the same chrome (top header, search
overlay, side arrows, sidebar) across page/section/taxonomy/404
— extracting them into partials/ makes "edit the nav" a
one-file change and keeps 404/taxonomy inside the
book-container so footer.html's closing tags match the
body's open tags.
Taxonomy templates are not shipped by default because the book
config no longer enables [[taxonomies]] (book scaffolds are
ordered chapter-style and don't use tags). They're still emitted
if the user opts in via --include-taxonomies (skip_taxonomies
= false is the default; the flag flips this to true).