{# gq: #}
{# 1. 模板继承：复用网站基础布局（包含头部导航、底部信息、全局样式等公共组件）#}
{# 确保友情链接页与其他页面风格统一，提升网站整体一致性 #}
{% extends 'share_layout/base.html' %}

{# 2. 加载自定义标签库与缓存工具 #}
{% load blog_tags %}    {# 加载博客专属标签库，用于侧边栏等组件渲染 #}
{% load cache %}        {# 加载缓存标签库，可优化页面加载性能（预留扩展）#}

{# 3. 重写header块：定义友情链接页的标题和SEO元标签 #}
{% block header %}
    {# 页面标题：固定显示“友情链接” + 网站描述，明确页面主题 #}
    <title>友情链接 | {{ SITE_DESCRIPTION }}</title>

    {# SEO优化标签：提升页面在搜索引擎中的可见性 #}
    <meta name="description" content="{{ SITE_SEO_DESCRIPTION }}"/>  {# 网站SEO描述 #}
    <meta name="keywords" content="{{ SITE_KEYWORDS }}"/>            {# 网站关键词 #}
    {# Open Graph协议标签：优化社交平台分享效果，保持品牌一致性 #}
    <meta property="og:type" content="blog"/>                        {# 内容类型为博客 #}
    <meta property="og:title" content="{{ SITE_NAME }}"/>            {# 社交分享标题 #}
    <meta property="og:description" content="{{ SITE_DESCRIPTION }}"/> {# 社交分享描述 #}
    <meta property="og:url" content="{{ SITE_BASE_URL }}"/>          {# 网站基础URL #}
    <meta property="og:site_name" content="{{ SITE_NAME }}"/>        {# 网站名称 #}
{% endblock %}

{# 4. 重写content块：展示友情链接列表 #}
{% block content %}
    <div id="primary" class="site-content">  {# 主内容区容器，应用网站全局样式 #}
        <div id="content" role="main">       {# 核心内容容器，提升无障碍访问性 #}

            {# 页面标题区域：明确当前页面为“友情链接” #}
            <header class="archive-header">
                <p class="archive-title">友情链接</p>  {# 固定标题，直接展示页面主题 #}
            </header><!-- .archive-header -->

            {# 友情链接内容区域：以列表形式展示所有链接 #}
            <div class="entry-content">  {# 应用文章内容样式，保持与其他页面的排版一致 #}
                <ul>  {# 无序列表：简洁展示链接列表 #}
                    {# 遍历友情链接对象列表：object_list由视图传递，包含所有友情链接数据 #}
                    {% for obj in object_list %}
                        <li>  {# 列表项：每个项对应一个友情链接 #}
                            {# 链接标签：href为友情链接地址，链接文本为网站名称 #}
                            <a href="{{ obj.link }}">{{ obj.name }}</a>
                        </li>
                    {% endfor %}
                </ul>
            </div>
        </div><!-- #content -->
    </div><!-- #primary -->
{% endblock %}

{# 5. 重写sidebar块：加载网站侧边栏 #}
{% block sidebar %}
    {# 调用自定义标签load_sidebar加载侧边栏，参数'i'可能指定侧边栏样式（如包含网站公告、热门文章等）#}
    {# 即使在友情链接页也显示侧边栏，丰富页面内容并引导用户访问其他板块 #}
    {% load_sidebar user 'i' %}
{% endblock %}