add relbar (breadcrumbs)

README.rst

@@ -129,6 +129,10 @@ your "conf.py" file::
         # Options are "nav" (default), "footer" or anything else to exclude.
         'source_link_position': "nav",
 
+        # If use relbar (breadcrumbs) or not.
+        # Values: "true" or "false" (default)
+        'relbar_enable': "false",
+
         # Bootswatch (http://bootswatch.com/) theme.
         #
         # Options are nothing with "" (default) or the name of a valid theme

demo/source/conf.py

@@ -134,6 +134,10 @@
     # Options are "nav" (default), "footer" or anything else to exclude.
     'source_link_position': "nav",
 
+    # If use relbar (breadcrumbs) or not.
+    # Values: "true" or "false" (default)
+    'relbar_enable': "true",
+
     # Bootswatch (http://bootswatch.com/) theme.
     #
     # Options are nothing with "" (default) or the name of a valid theme such

demo/source/subdir/index.rst

@@ -4,6 +4,10 @@ Subdirectory Page
 
 This page is in a subdirectory.
 
+.. toctree::
+
+   relbar_example
+
 Headings
 ========
 This is a first level heading (``h1``).

demo/source/subdir/relbar_example.rst

@@ -0,0 +1,9 @@
+=========================
+ Example Page for relbar
+=========================
+
+This page is an example for relbar (breadcrumbs).
+
+See the top nad the bottom of this page.
+
+

sphinx_bootstrap_theme/bootstrap/layout.html

@@ -93,10 +93,36 @@
 <meta name="apple-mobile-web-app-capable" content="yes">
 {% endblock %}
 
-{# Silence the sidebar's, relbar's #}
+{# Silence the sidebar's #}
 {% block header %}{% endblock %}
-{% block relbar1 %}{% endblock %}
-{% block relbar2 %}{% endblock %}
+
+{%- block relbar1 %}
+  {%- if theme_relbar_enable == "true" %}
+    {{ relbar_bootstrap() }}
+  {%- endif %}
+{% endblock %}
+
+{%- block relbar2 %}
+  {%- if theme_relbar_enable == "true" %}
+    {{ relbar_bootstrap() }}
+  {%- endif %}
+{% endblock %}
+
+{%- macro relbar_bootstrap() %}
+  <div class="container" role="navigation" aria-label="related navigation">
+    <ol class="breadcrumb">
+      {%- block rootrellink %}
+        <li><a href="{{ pathto(master_doc) }}">{{ shorttitle|e }}</a></li>
+      {%- endblock %}
+      {%- for parent in parents %}
+        <li><a href="{{ parent.link|e }}" {% if loop.last %}{{ accesskey("U") }}{% endif %}>{{ parent.title }}</a></li>
+      {%- endfor %}
+      <li class="active">{{ title }}</li>
+      {%- block relbaritems %} {% endblock %}
+    </ol>
+  </div>
+{%- endmacro %}
+
 {% block sidebarsourcelink %}{% endblock %}
 
 {%- block content %}

sphinx_bootstrap_theme/bootstrap/theme.conf

@@ -47,6 +47,10 @@ navbar_fixed_top = true
 # Options are "nav" (default), "footer" or anything else to exclude.
 source_link_position = nav
 
+# If use relbar (breadcrumbs) or not.
+# Values: "true" or "false" (default)
+relbar_enable = false
+
 # Bootswatch (http://bootswatch.com/) theme.
 #
 # Options are nothing with "" (default) or the name of a valid theme such as