Added external_links theme option

docs/source/configuration.rst

@@ -37,17 +37,30 @@ See docs on `html_sidebars <http://www.sphinx-doc.org/en/master/usage/configurat
   html_sidebars = {'**': ['util/searchbox.html', 'util/sidetoc.html']}
 
 
-html_css_files
-^^^^^^^^^^^^^^
+``html_css_files``
+^^^^^^^^^^^^^^^^^^
 
 Adds custom CSS files to the theme:
 
 .. code-block:: python
 
     html_css_files = ["css/custom.css"]
 
+``html_external_links``
+^^^^^^^^^^^^^^^^^^^^^^^
+
+If provided, creates external links (e.g. Github) in the top right corner:
+
+.. code-block:: python
+
+    html_theme_options = {
+      "external_links": [
+          ("Github", "https://github.com/username/repo"),
+          ("Other", "https://bla.com")
+      ]
+    }
 
-templates
+Templates
 =========
 
 

sphinx_press_theme/theme.conf

@@ -6,3 +6,4 @@ sidebars = util/searchbox.html, util/sidetoc.html
 
 [options]
 analytics_id =
+external_links =

sphinx_press_theme/util/extlinks.html

@@ -1,9 +1,11 @@
 {# external links, i.e. #}
-{#
-<div class="nav-item">
-  <a href="https://github.com/schettino72/sphinx_press_theme"
-     class="nav-link external">
-       Github <outboundlink/>
-  </a>
-</div>
-#}
+{% if theme_external_links %}
+  {% for (label, url) in theme_external_links %}
+    <div class="nav-item">
+      <a href="{{ url }}"
+        class="nav-link external">
+          {{ label }} <outboundlink/>
+      </a>
+    </div>
+  {% endfor %}
+{% endif %}