docs/layout/page.html

<!--
Copyright 2024 The Pigweed Authors

Licensed under the Apache License, Version 2.0 (the "License"); you may not
use this file except in compliance with the License. You may obtain a copy of
the License at

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
License for the specific language governing permissions and limitations under
the License.
-->
{% extends "furo/page.html" %}


{# Extend the "content" block that's found in "furo/page.html". #}
{% block content %}
  {% if pagename == 'index' %}
    {# Don't render breadcrumbs on the homepage. #}
  {% else %}
    {# The marker used between breadcrumbs. #}
    {%- set delimiter = ' /' %}
    {# Add breadcrumbs as the first thing in the "content" block. #}
    <ul class="breadcrumbs">
      {# Hardcode the homepage to ensure it's always the first breadcrumb. #}
      <li class="breadcrumb">
        <a href="{{ pathto('index.html', 1) }}">Home</a>
      </li>
      {{ delimiter }}
      {# Add a breadcrumb for each true "parent" of the current doc. #}
      {%- for parent in parents %}
        <li class="breadcrumb">
          <a href="{{ parent.link|e }}">{{ parent.title }}</a>
          {{ delimiter }}
        </li>
      {%- endfor %}
      {# Hardcode the current page as the last breadcrumb. #}
      <li class="breadcrumb">{{ title }}</li>
    </ul>
  {% endif %}
  {# Let Furo proceed with it's usual rendering of the "content" block. #}
  {{ super() }}
{% endblock content %}