{#
    Reusable post summary macro.

    Renders a single post summary article element.  Used on every page that
    lists posts: the home page index, tag pages, category pages and
    date-based archive pages.  Centralising the markup here means that a
    single edit to this file changes the way posts are presented in every
    listing context.

    Parameters:
        post: The Post object to render.
        include_category (bool): Whether to render the post's category link.
            Defaults to true.  Pass false on the category page, where the
            category is already implied by the page's own heading.

    Context variables used (passed via ``with context``):
        with_read_time (bool): Whether to show the estimated reading time.
        category_dir (str): URL path segment for category pages.
        tag_dir (str): URL path segment for tag pages.
#}
{% macro post_summary(post, include_category=true) %}
<article class="h-entry post-summary{% if post.draft %} draft-post{% endif %}">
    <h2 class="p-name"><a class="u-url" href="{{ post.url }}">{{ post.title }}{% if post.draft %} 🚧{% endif %}</a></h2>
    {% if post.date %}
    <time class="dt-published" datetime="{{ post.date.isoformat() }}">{{ post.date|format_date }}</time>{% if post.modified_date %}<span class="modified-date dt-updated"> (Modified: {{ post.modified_date|format_date_plain }})</span>{% endif %}
    {% endif %}
    {% set item_show_author = post.metadata.get('show_author') if post.metadata else none %}
    {% set effective_show_author = item_show_author if item_show_author is not none else show_author %}
    {% if effective_show_author %}
        {% set item_author = post.metadata.get('author') if post.metadata else none %}
        {% set effective_author = item_author if item_author else default_author %}
        {% if effective_author %}
            {% set item_author_url = post.metadata.get('author_url') if post.metadata else none %}
            {% set effective_author_url = item_author_url if item_author_url else default_author_url %}
            <div class="post-author">By {% if effective_author_url %}<a href="{{ effective_author_url }}" rel="me{% if effective_author_url|is_external_link %} noopener noreferrer{% endif %}"{% if effective_author_url|is_external_link %} target="_blank"{% endif %} class="u-author h-card">{{ effective_author }}</a>{% else %}<span class="u-author h-card">{{ effective_author }}</span>{% endif %}</div>
        {% endif %}
    {% endif %}
    {% if with_read_time %}
    <div class="reading-time">{{ post.reading_time }} min read</div>
    {% endif %}
    {% if include_category and post.category %}
    <div class="category">
        <a href="/{{ category_dir }}/{{ post.safe_category }}/{{ pagination_page1_suffix }}" class="p-category category-link">{{ post.category }}</a>
    </div>
    {% endif %}
    <div class="post-content e-content">
        {{ post.html_content|shift_headings(1)|safe }}
    </div>
    {% if post.tags %}
    <div class="tags">
        {% for tag, safe_tag in post.sorted_tag_pairs() %}
        <a href="/{{ tag_dir }}/{{ safe_tag }}/{{ pagination_page1_suffix }}" class="p-category tag">{{ tag }}</a>
        {% endfor %}
    </div>
    {% endif %}
</article>
{% endmacro %}