Struct Templates 

pub struct Templates { /* private fields */ }

Implementations

impl Templates

pub fn new( root_path: &Path, template_folder: Option<&Path>, ) -> Result<Self, TemplateError>

Creates a new Templates instance.

Template loading priority:

1. If template_folder is provided, load from {template_folder}/**/*.html
2. Otherwise, load from {root_path}/.mbr/**/*.html
3. Fall back to compiled defaults for any missing templates

pub fn reload(&self) -> Result<(), TemplateError>

Reload all templates from disk. Call this when template files change.

pub fn tera_clone(&self) -> Tera

Returns a clone of the Tera engine for lock-free rendering.

Acquires the read lock once to clone the Tera instance (~KB of template AST). Use this before entering a rayon thread pool to avoid per-file lock contention.

pub fn render_markdown( &self, html: &str, frontmatter: SimpleMetadata, extra_context: HashMap<String, Value>, ) -> Result<String, TemplateError>

pub fn render_markdown_with_tera( tera: &Tera, html: &str, frontmatter: SimpleMetadata, extra_context: HashMap<String, Value>, ) -> Result<String, TemplateError>

Lock-free variant of render_markdown that takes a &Tera directly.

Use with tera_clone() to avoid Arc<RwLock<Tera>> contention when rendering many files in parallel (e.g., from a rayon thread pool).

pub fn render_template_with_tera( tera: &Tera, template_name: &str, context_data: HashMap<String, Value>, ) -> Result<String, TemplateError>

Lock-free generic template render that takes a &Tera directly.

Use with tera_clone() to avoid Arc<RwLock<Tera>> contention when rendering many pages in parallel (e.g., from a rayon thread pool).

pub fn render_section( &self, context_data: HashMap<String, Value>, ) -> Result<String, TemplateError>

pub fn render_home( &self, context_data: HashMap<String, Value>, ) -> Result<String, TemplateError>

Renders the home page (root directory) using home.html template. This allows users to customize their home page differently from section pages.

pub fn render_error( &self, context_data: HashMap<String, Value>, ) -> Result<String, TemplateError>

Renders an error page using error.html template.

Context variables:

• error_code: HTTP status code (e.g., 404, 500)
• error_title: Short error title (e.g., “Not Found”)
• error_message: Optional detailed message
• requested_url: The URL that was requested (useful in GUI mode without URL bar)
• server_mode: Boolean indicating server vs static mode
• relative_base: Path prefix to .mbr assets (e.g., “.mbr/”, “../.mbr/”)
• relative_root: Path prefix to root (e.g., “”, “../”)

pub fn render_tag( &self, context_data: HashMap<String, Value>, ) -> Result<String, TemplateError>

Renders a tag page showing all pages with a specific tag.

Context variables:

• tag_source: URL identifier for the tag source (e.g., “tags”, “performers”)
• tag_display_value: Original display value of the tag (e.g., “Rust”, “Joshua Jay”)
• tag_label: Singular label for the tag source (e.g., “Tag”, “Performer”)
• tag_label_plural: Plural label for the tag source (e.g., “Tags”, “Performers”)
• pages: Array of page objects with url_path, title, description
• page_count: Number of pages with this tag
• server_mode: Boolean indicating server vs static mode
• relative_base: Path prefix to .mbr assets

pub fn render_tag_index( &self, context_data: HashMap<String, Value>, ) -> Result<String, TemplateError>

Renders a tag source index showing all tags from a source.

Context variables:

• tag_source: URL identifier for the tag source (e.g., “tags”, “performers”)
• tag_label: Singular label for the tag source (e.g., “Tag”, “Performer”)
• tag_label_plural: Plural label for the tag source (e.g., “Tags”, “Performers”)
• tags: Array of tag objects with url_value, display_value, page_count
• tag_count: Total number of unique tags
• server_mode: Boolean indicating server vs static mode
• relative_base: Path prefix to .mbr assets

pub fn render_media_viewer( &self, context_data: HashMap<String, Value>, ) -> Result<String, TemplateError>

Renders a media viewer page for video, PDF, or audio content.

Context variables:

• media_type: Type of media (“video”, “pdf”, “audio”)
• title: Page title (defaults to filename)
• media_path: Path to the media file
• breadcrumbs: Navigation breadcrumbs
• parent_path: URL to parent directory for back navigation
• server_mode: Boolean indicating server vs static mode
• relative_base: Path prefix to .mbr assets
• sidebar_style: Sidebar navigation style
• sidebar_max_items: Maximum items per section in sidebar

Trait Implementations

impl Clone for Templates

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.