{#
================================================================================
PERFORMANCE OPTIMIZATION: Cache expensive lookups once per render
================================================================================
These cached variables eliminate repeated defensive checks (34+ instances of
"page is defined and page") and redundant function calls (get_menu_lang, etc.)
See: plan/active/rfc-template-performance-optimization.md
================================================================================
#}
{% set _page = page if page is defined else none %}
{% set _has_page = _page is not none %}
{% set _page_title = _page.title if (_has_page and _page.title is defined) else '' %}
{% set _page_url = _page._path if (_has_page and _page._path is defined) else '/' %}
{% set _current_lang = current_lang() %}
{% set _main_menu = get_menu_lang('main', _current_lang) %}
{% set _auto_nav = get_auto_nav() if _main_menu | length == 0 else [] %}
{% set _footer_menu = get_menu_lang('footer', _current_lang) %}
{% set _site_title = site.config.title %}
{% set _build_badge_cfg = site.config.get('build_badge') %}
{% set _build_badge_enabled = false %}
{% set _build_badge_dir_name = 'bengal' %}
{% set _build_badge_label = 'built in' %}
{% if _build_badge_cfg is boolean %}
{% set _build_badge_enabled = _build_badge_cfg %}
{% elif _build_badge_cfg is mapping %}
{% set _build_badge_enabled = _build_badge_cfg.get('enabled', true) %}
{% set _build_badge_dir_name = _build_badge_cfg.get('dir_name', 'bengal') %}
{% set _build_badge_label = _build_badge_cfg.get('label', 'built in') %}
{% endif %}
{# Title - uses cached variables #}
{% block title %}{{ _page_title if _page_title else _site_title }}{% if _page_title %} - {{ _site_title }}{%
endif %}{% endblock %}
{# Meta description - automatically pre-computed by renderer (page.meta_description cached_property) #}
{% set meta_desc = meta_desc | default(site.config.get('description'), '') %}
{# Meta Description - Auto-generate if not provided #}
{# Meta Keywords - use page.keywords or fallback to tags #}
{% if _has_page and _page.keywords is defined and _page.keywords %}
{% elif _has_page and _page.tags is defined and _page.tags %}
{% endif %}
{# Robots directive for hidden/unlisted pages #}
{% if _has_page and _page.robots_meta is defined and _page.robots_meta != 'index, follow' %}
{% endif %}
{# Open Graph / Facebook #}
{% if meta_desc %}
{% endif %}
{% if site.config.baseurl %}
{# Use relative_url for canonical URLs (canonical_url adds baseurl) #}
{% endif %}
{# Open Graph Image #}
{% if _has_page and _page.metadata is defined and _page.metadata.get('image') %}
{% elif site.config.get('og_image') %}
{% endif %}
{# Twitter Card #}
{% if meta_desc %}
{% endif %}
{% if _has_page and _page.metadata is defined and _page.metadata.get('image') %}
{% elif site.config.get('og_image') %}
{% endif %}
{# Bengal config meta for JS to read without template tags inside scripts #}
{# Pre-built Lunr index URL - only emit if lunr package is installed (pip install bengal[search]) #}
{% if bengal.capabilities.prebuilt_search %}
{% endif %}
{# Version meta tag for version-scoped search #}
{% if _has_page and _page.version is defined and _page.version %}
{% endif %}
{# Canonical URL #}
{% if site.config.baseurl %}
{# Use relative_url for canonical URLs (canonical_url adds baseurl) #}
{% endif %}
{# RSS Feed (locale-aware when i18n prefix strategy is enabled) #}
{% set _lang = _current_lang %}
{% set _i18n = site.config.get('i18n', {}) %}
{% set _rss_href = '/rss.xml' %}
{% if _i18n and _i18n.get('strategy') == 'prefix' %}
{% set _default_lang = _i18n.get('default_language', 'en') %}
{% set _default_in_subdir = _i18n.get('default_in_subdir', False) %}
{% if _lang and (_default_in_subdir or _lang != _default_lang) %}
{% set _rss_href = '/' ~ _lang ~ '/rss.xml' %}
{% endif %}
{% endif %}
{# hreflang alternates for translated pages #}
{% for alt in alternate_links(page) %}
{% endfor %}
{# Favicon #}
{% set favicon_path = site.config.get('site', {}).get('favicon') %}
{% if favicon_path %}
{% else %}
{% endif %}
{# Preconnect to CDN origins for faster resource loading #}
{# Fonts - Preload critical fonts, load CSS non-blocking #}
{% if site.config.get('fonts') %}
{# Preload the most critical font weight for faster LCP #}
{# Load font CSS with non-blocking pattern #}
{% endif %}
{# Stylesheets - main CSS (render-blocking, but cached) #}
{# Theme configuration defaults from bengal.toml #}
{# Theme & Palette initialization - INLINED to prevent FOUC (must be synchronous) #}
{% block extra_head %}{% endblock %}
{# Generator and build meta #}
{% include 'partials/meta-generator.html' %}
{# Optional JSON bootstrap for client-side scripts #}
{% if config.get('expose_metadata_json') %}
{% endif %}
{# Skip to main content for accessibility - Feature: accessibility.skip_link #}
{% if 'accessibility.skip_link' in site.theme_config.features %}
Skip to main content
{% endif %}
{# Search Modal (Cmd/Ctrl+K) #}
{% include 'partials/search-modal.html' %}
{# Header - App Shell Pattern: Full-width edge-to-edge #}
{# Mobile Navigation Backdrop #}
{# Mobile Navigation - uses cached _main_menu and _auto_nav from top of template #}
{# Main Content #}
{# Note: No .container wrapper here - templates define their own containment strategy #}
{# - docs-layout templates: full-width grid (no container needed) #}
{# - single-column templates: add .container in the block content #}
{% block content %}{% endblock %}
{# Footer #}
{# ============================================================== #}
{# JavaScript Loading Strategy (Render Performance Optimized) #}
{# ============================================================== #}
{# All scripts use defer to avoid render-blocking. #}
{# Heavy libraries (Mermaid, D3, Tabulator) are lazy-loaded only #}
{# when their features are present on the page. #}
{# #}
{# When bundle_js is enabled in config, all theme JS is bundled #}
{# into a single file to reduce HTTP requests on mobile. #}
{# ============================================================== #}
{% set _bundle_js = site.config.get('assets', {}).get('bundle_js', false) %}
{% if _bundle_js %}
{# Bundled JS - Single file containing all theme JavaScript #}
{# Reduces HTTP requests from ~20 to 3 for better mobile performance #}
{# Third-party libraries (not bundled - already optimized) #}
{% else %}
{# Individual Scripts - Better for development/debugging #}
{# Progressive Enhancement System - Load first so other scripts can register #}
{# Core modules - Always loaded #}
{% if _build_badge_enabled %}
{% endif %}
{# Main initialization #}
{# Core enhancements - Always loaded (provide essential interactivity) #}
{# Optional enhancements - Auto-loaded by bengal-enhance.js when data-bengal elements detected #}
{# Lightbox JS - Feature: content.lightbox (still manually loaded for feature gate) #}
{% if 'content.lightbox' in site.theme_config.features %}
{% endif %}
{# Search - Third-party library #}
{# Lazy-loaded Libraries - URLs injected here, logic in external file #}
{% endif %}
{% block extra_js %}{% endblock %}
{# Back to Top Button - Feature: navigation.back_to_top #}
{% if 'navigation.back_to_top' in site.theme_config.features %}
{% endif %}
{# Image Lightbox - Feature: content.lightbox #}
{% if 'content.lightbox' in site.theme_config.features %}
{% endif %}
{# Dev-only live reload is now injected by the server automatically via LiveReloadMixin #}