GH-59 Fix external links on sidetoc.

CHANGES

@@ -2,6 +2,12 @@
 Changes
 =======
 
+0.8.0 (*unreleased*)
+====================
+
+- GH-59 Fix external links on sidetoc
+
+
 0.7.3 (*2021-05-16*)
 ====================
 

docs/source/conf.py

@@ -24,9 +24,9 @@
 author = 'Eduardo Naufel Schettino'
 
 # The short X.Y version
-version = '0.7'
+version = '0.8'
 # The full version, including alpha/beta/rc tags
-release = '0.7.3'
+release = '0.8.0'
 
 
 # -- General configuration ---------------------------------------------------

setup.py

@@ -5,7 +5,7 @@
 
 setup(
     name="sphinx_press_theme",
-    version="0.7.3",
+    version="0.8.0",
     url="https://schettino72.github.io/sphinx_press_site/",
     license="MIT",
     author="Eduardo Naufel Schettino <schetino72>",

sphinx_press_theme/__init__.py

@@ -5,7 +5,7 @@
 from sphinx import addnodes
 from sphinx.util.osutil import relative_uri
 
-__version__ = (0, 7, 3)
+__version__ = (0, 8, 0)
 
 
 class SimpleTocTreeCollector(EnvironmentCollector):
@@ -107,10 +107,15 @@ def add_toctree_data(app, pagename, templatename, context, doctree):
 
         # add toc tree items, expand one more level if toctree is current page
         entries = []
+        # entries contain a pair (title, name|external url)
+        # if name of document is given and not title, title is taken from document
         for title, name in tree['entries']:
             if not title:
                 title = app.env.titles[name].astext()
 
+            # check if entry is an external resource
+            ext_resource = '://' in name
+
             current1 = (pagename == name)
             children = []
             if current1:
@@ -123,6 +128,7 @@ def add_toctree_data(app, pagename, templatename, context, doctree):
                 'title': title,
                 'current': current1,
                 'children': children,
+                'ext_resource': ext_resource,
             })
 
         toc_docname = tree['parent'] # docname where this toc appears

sphinx_press_theme/theme.conf

@@ -7,4 +7,4 @@ sidebars = util/searchbox.html, util/sidetoc.html
 [options]
 analytics_id =
 external_links =
-press_version = 0.7.3
+press_version = 0.8.0

sphinx_press_theme/util/sidetoc.html

@@ -6,7 +6,12 @@
       </p>
       <ul class="{% if toc.current %}current{% endif %}">
         {% for entry in toc.entries %}
-          <li class="toctree-l1 {% if entry.current %}current{% endif %}"><a href="{{ pathto(entry.name) }}" class="reference internal {% if entry.current %}current{% endif %}">{{entry.title}}</a>
+          <li class="toctree-l1 {% if entry.current %}current{% endif %}">
+            {% if entry.ext_resource %}
+              <a href="{{ pathto(entry.name, 1) }}" class="reference">{{entry.title}} <outboundlink></outboundlink></a>
+            {% else %}
+              <a href="{{ pathto(entry.name) }}" class="reference internal {% if entry.current %}current{% endif %}">{{entry.title}}</a>
+            {% endif %}
 
             {% if entry.children %}
               <ul>