{% extends '_layout/layout.twig' %}

{% import '_layout/icons.twig' as icons %}

{# Feed auto-discovery — only shows up on /blog/* pages, since only this
   layout overrides the root layout's empty head_extra block. See
   App/pages/blog/feed/index.php. #}
{% block head_extra %}
    <link rel="alternate" type="application/rss+xml" title="{{ site_name }} Blog" href="/blog/feed">
{% endblock %}

{% block content %}
    <div class="blog-layout">
        <aside>
            <p>This sidebar exists because <code>App/pages/blog/_layout/layout.twig</code> overrides the site-wide root layout for everything under <code>/blog</code> — the nearest <code>_layout/layout.twig</code> wins, so a subtree can look different without touching the pages themselves.</p>
            <p><a class="icon-link" href="/admin/docs/layouts">{{ icons.book() }}Layouts docs</a></p>
        </aside>
        <article>
            {% block blog_content %}{% endblock %}
            {# Only pages whose sidecar opts in by returning a 'comments'
               key get a thread — see /admin/docs/comments and
               App/pages/blog/hello-world/index.php. A sidecar-less post
               never has this key, so it's silently skipped. #}
            {% if comments is defined %}
                {% include '_partials/comments/thread.twig' %}
            {% endif %}
        </article>
    </div>
{% endblock %}