{#
================================================================================
TEMPLATE VARIABLES
================================================================================
Bengal provides: page, site, config, params (page.metadata alias), meta, section
Cache expensive function calls once per render. Page properties like title,
_path, kind, tags are always defined - no defensive checks needed.
================================================================================
#}
{# Template-wide variables using {% let %} for explicit scope #}
{% let params = params ?? {} %}
{% let _page_title = page?.title ?? none %}
{% let _page_url = page?._path ?? page?.href ?? "/" %}
{# Navigation - cache function calls #}
{% let _current_lang = current_lang() %}
{% let _direction = direction() %}
{% let _site_title = site.title %}
{# Normalized config objects (pre-processed by Site with defaults applied) #}
{% let _build_badge = site.build_badge %}
{% let _doc_app = site.document_application %}
{% let _link_previews = site.link_previews %}
{% let _per_page_json = 'json' in (config.output_formats.per_page ?? []) %}
{% let _per_page_md = 'markdown' in (config.output_formats.per_page ?? []) %}
{# Derived values #}
{% let _main_menu = get_menu_lang("main", _current_lang) %}
{% let _footer_menu = get_menu_lang("footer", _current_lang) %}
{% let _doc_app_nav = _doc_app?.navigation %}
{% let _view_transitions = _doc_app.enabled and _doc_app_nav?.view_transitions %}
{% let _transition_style = _doc_app_nav?.transition_style %}
{# Auto navigation if main menu is empty #}
{% let _auto_nav = get_auto_nav() if _main_menu | length == 0 else [] %}
{# =============================================================================
HELPER: Render a menu item (desktop/mobile)
============================================================================= #}
{% def render_menu_item(item, is_mobile=false) %}
{% let item_children = item?.children ?? [] %}
{% let item_href = item?.href ?? item?.url ?? '#' %}
{% let item_name = item?.name ?? item?.title ?? 'Untitled' %}
{% let has_children = item_children | length > 0 %}
{% let is_current = _page_url == item_href %}
{% set active_children = [] %}
{% for child in item_children %}
{% let child_href = child?.href ?? child?.url ?? '#' %}
{% if child_href != '#' and (_page_url == child_href or (child_href != '/' and _page_url.startswith(child_href))) %}
{% set _ = active_children.append(true) %}
{% end %}
{% end %}
{% let is_active = (item?.active ?? false) or (_page_url == item_href) or (item_href != '/' and item_href != '#' and _page_url.startswith(item_href)) or (active_children | length > 0) %}
{% let is_trail = item?.active_trail ?? false %}
{% if is_mobile and has_children %}
{# Mobile: Split button pattern - link + chevron toggle #}
{% if item_href == '#' %}
{{ item_name }}
{% else %}
{{ item_name }}
{% end %}
{% elif has_children and item_href == '#' %}
{# Desktop: Non-navigable dropdown trigger #}
{{ item_name }}
{% else %}
{# Regular navigation link #}
{{ item_name }}
{% end %}
{% if has_children %}
{% for child in item_children %}
{% let child_href = child?.href ?? child?.url ?? '#' %}
{% let child_current = _page_url == child_href %}
{% let child_active = child_href != '#' and (child_current or (child_href != '/' and _page_url.startswith(child_href))) %}
{% enddef %}
{# AI/Agent discovery — early in for fast detection #}
{% let _href_for_markdown = page?.href ?? '' %}
{% if _per_page_md and _href_for_markdown is string and _href_for_markdown %}
{% let _href_early = _href_for_markdown %}
{% let _md_url_early = _href_early | replace('.html', '.md') if _href_early.endswith('.html') else (_href_early ~ 'index.md' if _href_early.endswith('/') else _href_early ~ '/index.md') %}
{% end %}
{% if 'llms_txt' in (config.output_formats.site_wide ?? []) %}
{% end %}
{# Document Application: View Transitions meta tag #}
{% if _view_transitions %}
{% end %}
{# Title - captured for reuse in Open Graph and Twitter Card #}
{% capture page_title %}
{% block title %}
{% match _page_title %}
{% case title if title and _site_title %}{{ title }} - {{ _site_title }}
{% case title if title %}{{ title }}
{% case _ %}{{ _site_title }}
{% end %}
{% end %}
{% endcapture %}
{{ page_title | trim }}
{# Meta description - captured for reuse in Open Graph and Twitter Card #}
{% capture meta_desc %}
{{ meta_desc ?? site.description }}
{% endcapture %}
{# Meta Keywords - use page.keywords or fallback to tags #}
{% let _page_keywords = page?.keywords ?? [] %}
{% let _page_tags = page?.tags ?? [] %}
{% if _page_keywords %}
{% elif _page_tags %}
{% end %}
{# Robots directive for hidden/unlisted pages #}
{% let _robots_meta = page?.robots_meta ?? '' %}
{% if _robots_meta and _robots_meta != 'index, follow' %}
{% end %}
{# Content Signals — per-page AI directives (only when restricted) #}
{% let _in_ai_train = page?.in_ai_train ?? true %}
{% let _in_ai_input = page?.in_ai_input ?? true %}
{% if not _in_ai_train or not _in_ai_input %}
{% end %}
{# Open Graph / Facebook #}
{% if meta_desc %}
{% end %}
{% if site.baseurl %}
{% end %}
{# Open Graph Image #}
{% let _og_image_path = og_image(params?.image ?? config?.og_image ?? '', page) %}
{% if _og_image_path %}
{% end %}
{# Twitter Card #}
{% if meta_desc %}
{% end %}
{% if _og_image_path %}
{% end %}
{# Bengal config meta #}
{% if bengal.capabilities.prebuilt_search %}
{% end %}
{% let _page_version = page?.version ?? none %}
{% if _page_version %}
{% end %}
{# Canonical URL #}
{% if site.baseurl %}
{% end %}
{# RSS Feed #}
{% with config.i18n as i18n %}
{% let rss_href = '/rss.xml' %}
{% if i18n and i18n.strategy == 'prefix' %}
{% let default_lang = i18n.default_language ?? 'en' %}
{% if _current_lang and (i18n.default_in_subdir or _current_lang != default_lang) %}
{% let rss_href = '/' ~ _current_lang ~ '/rss.xml' %}
{% end %}
{% end %}
{% end %}
{# hreflang alternates #}
{% for alt in alternate_links(page) %}
{% end %}
{# Favicon, preconnect, fonts, stylesheets #}
{# asset_url() is manifest-sensitive; keep this outside fragment caches. #}
{# Favicon - use let for safer nil handling #}
{% let favicon_path = site.favicon ?? none %}
{% if favicon_path %}
{% else %}
{% end %}
{# Preconnect #}
{# Stylesheets #}
{% if 'content.math' in (theme.features ?? []) %}
{% end %}
{# Theme init scripts — site-stable, same for every page in a build #}
{% cache 'base-theme-init-' ~ (bengal.build.timestamp ?? '') %}
{# Theme configuration JS #}
{% let _enhance_debug = config.enhancements?.debug ?? false %}
{# Inline theme init #}
{% end %}{# /cache base-theme-init #}
{% block extra_head %}{% end %}
{% cache 'base-meta-generator-' ~ (bengal?.build?.timestamp ?? '') %}
{% include 'partials/meta-generator.html' %}
{% end %}{# /cache base-meta-generator #}
{% include 'partials/article-jsonld.html' %}
{% include 'partials/product-jsonld.html' %}
{% let _page_type = page?.type ?? 'page' %}
{% let _page_variant = page?.variant ?? '' %}
{% let _page_kind = page?.kind ?? 'page' %}
{% let _page_is_draft = page?.is_draft ?? false %}
{% let _page_hidden = page?.hidden ?? false %}
{% let _page_is_featured = page?.is_featured ?? false %}
{% if 'accessibility.skip_link' in (theme.features ?? []) %}
Skip to main content
{% end %}
{# Header #}
{% let _header_sticky = theme.header_sticky ?? true %}
{% let _header_nav_position = theme.header_nav_position ?? 'left' %}
{% block content %}{% end %}
{# Search Modal Block — placed after so content starts early in DOM #}
{% block site_search_modal %}
{% cache 'base-search-modal-' ~ _current_lang ~ '-' ~ (bengal.build.timestamp ?? '') %}
{% include 'partials/search-modal.html' %}
{% end %}{# /cache base-search-modal #}
{% end %}
{# Mobile Navigation — placed after so content starts early in DOM #}
{# Footer #}
{% block site_footer %}
{% cache 'base-footer-' ~ _current_lang ~ '-' ~ (bengal?.build?.timestamp ?? '') %}
{% let footer_links = _footer_menu if _footer_menu | length > 0 else _main_menu %}
{% let repo_url = site.params?.repo_url ?? '' %}
{% let site_desc = site.description ?? '' %}
{% end %}{# /cache base-footer #}
{% end %}
{# Scripts #}
{% block site_scripts %}
{# asset_url() is manifest-sensitive; keep this outside fragment caches. #}
{% let _page_template = page?.template ?? '' %}
{% if (config.search.ui.modal ?? false) or _page_template == 'search.html' %}
{% end %}
{% if site.build_badge.enabled %}
{% end %}
{% if 'content.lightbox' in theme.features %}
{% end %}
{% if 'content.math' in (theme.features ?? []) %}
{% end %}
{% end %}
{% block extra_js %}{% end %}
{# Speculation Rules — moved after content for faster content-start position #}
{% cache 'base-speculation-' ~ (bengal.build.timestamp ?? '') %}
{% with _doc_app.speculation as speculation %}
{% if _doc_app.enabled and speculation.enabled and (_doc_app.features?.speculation_rules ?? true) %}
{% end %}
{% end %}
{% end %}{# /cache base-speculation #}
{# Bootstrap metadata — moved after content for faster content-start position #}
{% if config.expose_metadata_json %}
{% end %}
{% block site_dialogs %}
{% if 'navigation.back_to_top' in theme.features %}{% end %}
{% if 'content.lightbox' in theme.features %}
{% end %}
{% end %}