Struct BlogConfig 

pub struct BlogConfig { /* private fields */ }

Builder for constructing a BlogRegistry.

Example

let registry = BlogConfig::new(include_str!("../blog/_blog.json"), blog_content_map())
    .with_posts_per_page(9)
    .with_theme_toggle("light", "dark", "dark")
    .build();

Implementations

impl BlogConfig

pub fn new( manifest_json: &str, content_map: HashMap<&'static str, &'static str>, ) -> Self

Create a new builder from a _blog.json string and a content map.

pub fn with_posts_per_page(self, n: usize) -> Self

Set the number of posts per page for pagination (default: 9).

pub fn with_category_base_path(self, path: &str) -> Self

Enable linkable tag categories under a root-relative path.

Register routes for {base}/:slug and {base}/:slug/page/:page rendering crate::BlogCategoryPage (page numbers start at one). With this unset, existing tag buttons retain their local filtering behavior and no category URLs are emitted into the sitemap.

pub fn with_date_format(self, fmt: &str) -> Self

Set the date display format (default: “%B %d, %Y”).

pub fn with_theme(self, theme: &str) -> Self

Set a single theme (no toggle button).

pub fn with_theme_toggle(self, light: &str, dark: &str, default: &str) -> Self

Enable a light/dark theme toggle.

pub fn build(self) -> BlogRegistry

Build the BlogRegistry.

Panics

Panics with a descriptive message if _blog.json fails to parse. Use Self::try_build to handle the error yourself.

pub fn try_build(self) -> Result<BlogRegistry, DocsKitError>

Build the BlogRegistry, returning an error instead of panicking when _blog.json fails to parse.