title: How do Sphinx configurations setup "breadcrumbs"?
body: <p>How do Sphinx configurations setup "breadcrumbs" in the header? I have a Sphinx project and all I see is the project name; if I jump down into subpages I get lost and I don't see the path to the current page.</p>
  
  <p>Some examples in the wild:</p>
  
  <p><a href="https://docs.python.org/2.7/library/argparse.html" rel="nofollow noreferrer">https://docs.python.org/2.7/library/argparse.html</a></p>
  
  <p>See top line: Documentation >> The Python Standard Library >> 15. Generic Operating System Services</p>
  
  <p><a href="https://i.stack.imgur.com/fXdUk.png" rel="nofollow noreferrer"><img src="https://i.stack.imgur.com/fXdUk.png" alt="enter image description here"></a></p>
  
  <p><a href="http://docs.scipy.org/doc/numpy/reference/arrays.ndarray.html" rel="nofollow noreferrer">http://docs.scipy.org/doc/numpy/reference/arrays.ndarray.html</a></p>
  
  <p>See the rounded rectangles at the top</p>
  
  <p><a href="https://i.stack.imgur.com/BlSnW.png" rel="nofollow noreferrer"><img src="https://i.stack.imgur.com/BlSnW.png" alt="enter image description here"></a></p>
  
  <p>Source code for scipy appears to be here:</p>
  
  <ul>
  <li><a href="https://raw.githubusercontent.com/numpy/numpy/v1.11.1/doc/source/reference/index.rst" rel="nofollow noreferrer">https://raw.githubusercontent.com/numpy/numpy/v1.11.1/doc/source/reference/index.rst</a></li>
  <li><a href="https://raw.githubusercontent.com/numpy/numpy/v1.11.1/doc/source/reference/arrays.rst" rel="nofollow noreferrer">https://raw.githubusercontent.com/numpy/numpy/v1.11.1/doc/source/reference/arrays.rst</a></li>
  <li><a href="https://raw.githubusercontent.com/numpy/numpy/v1.11.1/doc/source/reference/arrays.ndarray.rst" rel="nofollow noreferrer">https://raw.githubusercontent.com/numpy/numpy/v1.11.1/doc/source/reference/arrays.ndarray.rst</a></li>
  </ul>
  
  <hr>
  
  <p>It looks like the Sphinx "basic" theme has this functionality built-in as the "relbar":</p>
  
  <p>From <a href="https://github.com/sphinx-doc/sphinx/blob/master/sphinx/themes/basic/layout.html" rel="nofollow noreferrer">https://github.com/sphinx-doc/sphinx/blob/master/sphinx/themes/basic/layout.html</a>:</p>
  
  <pre><code>{%- macro relbar() %}
      &lt;div class="related" role="navigation" aria-label="related navigation"&gt;
        &lt;h3&gt;{{ _('Navigation') }}&lt;/h3&gt;
        &lt;ul&gt;
          {%- for rellink in rellinks %}
          &lt;li class="right" {% if loop.first %}style="margin-right: 10px"{% endif %}&gt;
            &lt;a href="{{ pathto(rellink[0]) }}" title="{{ rellink[1]|striptags|e }}"
               {{ accesskey(rellink[2]) }}&gt;{{ rellink[3] }}&lt;/a&gt;
            {%- if not loop.first %}{{ reldelim2 }}{% endif %}&lt;/li&gt;
          {%- endfor %}
          {%- block rootrellink %}
          &lt;li class="nav-item nav-item-0"&gt;&lt;a href="{{ pathto(master_doc) }}"&gt;{{ shorttitle|e }}&lt;/a&gt;{{ reldelim1 }}&lt;/li&gt;
          {%- endblock %}
          {%- for parent in parents %}
            &lt;li class="nav-item nav-item-{{ loop.index }}"&gt;&lt;a href="{{ parent.link|e }}" {% if loop.last %}{{ accesskey("U") }}{% endif %}&gt;{{ parent.title }}&lt;/a&gt;{{ reldelim1 }}&lt;/li&gt;
          {%- endfor %}
          {%- block relbaritems %} {% endblock %}
        &lt;/ul&gt;
      &lt;/div&gt;
  {%- endmacro %}
  </code></pre>
  
  <p>see also <a href="http://www.sphinx-doc.org/en/stable/templating.html" rel="nofollow noreferrer">http://www.sphinx-doc.org/en/stable/templating.html</a></p>
  
  <p>But I can't figure out how to enable.</p>
  
  <hr>
  
  <p>OK, I am really confused here. I got something to appear but not the way I wanted.</p>
  
  <p>I have my index.rst for my project "MyDoc":</p>
  
  <pre><code>Top Level Page Title Is Here
  ============================
  
  content goes here
  
  .. toctree::
     :maxdepth: 2
  
     introduction
     (other files)
  </code></pre>
  
  <p>and then I have introduction.rst</p>
  
  <pre><code>Introduction
  ============
  
  content goes here
  
  .. toctree::
     :maxdepth: 2
  
     test1
  </code></pre>
  
  <p>and test1.rst</p>
  
  <pre><code>Test1
  ============
  
  blah blah
  </code></pre>
  
  <ul>
  <li>For index.html it shows MyDoc in the relbar.</li>
  <li>For introduction.html it shows MyDoc in the relbar. (I would have expected MyDoc >> Introduction)</li>
  <li>For test1.html it shows MyDoc >> Introduction in the relbar. (I would have expected MyDoc >> Introduction >> Test1)</li>
  </ul>
  
  <p>I guess what I am confused about is why it works this way.</p>