---
layout: default
route: documentation
---

{% include navbar.html id="Documentation" %}

{% assign current_category = page.doc-tab %}
{% assign current_link_id = page.breadcrumb | last %}
{% assign current_link = site.data.links.by_id[current_link_id] %}
{% assign category_links = site.data.links.categories[current_category] %}

{% for link_id in category_links %}
  {% if link_id == current_link_id %}
    {% unless forloop.first %}
      {% assign previous_index = forloop.index0 | minus: 1 %}
      {% assign previous_link_id = category_links[previous_index] %}
      {% assign previous_link = site.data.links.by_id[previous_link_id] %}
    {% endunless %}

    {% unless forloop.last %}
      {% assign next_index = forloop.index0 | plus: 1 %}
      {% assign next_link_id = category_links[next_index] %}
      {% assign next_link = site.data.links.by_id[next_link_id] %}
    {% endunless %}
  {% endif %}
{% endfor %}

<main class="bd-main">
  <div class="bd-side-background"></div>
  <div class="bd-main-container container">
    <div class="bd-duo">
      <div class="bd-lead">
        <div class="bd-breadcrumb">
          <nav class="breadcrumb" aria-label="breadcrumbs">
            <ul>
              {% for key in page.breadcrumb %}
                {% assign link = site.data.links.by_id[key] %}
                <li{% if forloop.last %} class="is-active"{% endif %}>
                  <a href="{{ site.url }}{{ link.path }}">{{ link.name }}</a>
                </li>
              {% endfor %}
            </ul>
          </nav>

          {% if previous_link or next_link %}
            <nav class="bd-prev-next">
              {% if previous_link %}
                <a href="{{ site.url }}{{ previous_link.path }}" title="{{ previous_link.name }}">
                  ←
                </a>
              {% else %}
                <span>
                  ←
                </span>
              {% endif %}

              {% if next_link %}
                <a href="{{ site.url }}{{ next_link.path }}" title="{{ next_link.name }}">
                  →
                </a>
              {% else %}
                <span>
                  →
                </span>
              {% endif %}
            </nav>
          {% endif %}
        </div>

        <header class="bd-header">
          <div class="bd-header-titles">
            <h1 class="title">
              {{ page.title }}
            </h1>
            <p class="subtitle is-4">
              {% if current_link.subtitle %}
                {{ current_link.subtitle }}
              {% else %}
                {{ page.subtitle }}
              {% endif %}
            </p>
            {% if page.meta %}
              {%
                include meta.html
                colors=page.meta.colors
                sizes=page.meta.sizes
                variables=page.meta.variables
                experimental=page.meta.experimental
              %}
            {% endif %}
          </div>

          <div class="bd-header-carbon">
            {% include carbon.html %}
          </div>
        </header>

        <div class="bd-content">
          {{ content }}
        </div>

        <nav class="bd-prev-next-bis">
          {% if previous_link %}
            <a class="bd-prev-next-bis-previous" href="{{ site.url }}{{ previous_link.path }}" title="{{ previous_link.name }}">
              ← {{ previous_link.name }}
            </a>
          {% endif %}

          {% if next_link %}
            <a class="bd-prev-next-bis-next" href="{{ site.url }}{{ next_link.path }}" title="{{ next_link.name }}">
              {{ next_link.name }} →
            </a>
          {% endif %}
        </nav>

        {% include elements/improve-page.html %}
      </div>

      <aside class="bd-side">
        {% unless page.hide_categories %}
          {% include elements/categories-nav.html %}
        {% endunless %}
      </aside>
    </div>
  </div>
</main>