Merge pull request #8 from jklymak/make-logo-default

ENH: remove the need to specify the icon links

Author: jklymak

docs/Makefile

@@ -3,7 +3,7 @@
 
 # You can set these variables from the command line, and also
 # from the environment for the first two.
-SPHINXOPTS    ?= "-vv"
+SPHINXOPTS    ?= "-vvv"
 SPHINXBUILD   ?= sphinx-build
 SOURCEDIR     = .
 BUILDDIR      = _build

docs/conf.py

@@ -1,3 +1,5 @@
+import datetime
+
 # Configuration file for the Sphinx documentation builder for
 # matplotlib projects.
 
@@ -7,8 +9,10 @@
 # -- Project information -----------------------------------------------------
 
 project = "Matplotlib Sphinx Theme"
-copyright = "2021, Matplotlib Contributors"
-author = "Matplotlib Contributors"
+copyright = (
+     f"2012 - {datetime.datetime.now().year} The Matplotlib development team"
+ )
+author = "Matplotlib Developers"
 
 
 # -- General configuration ---------------------------------------------------
@@ -28,37 +32,13 @@
 # -- Options for HTML output -------------------------------------------------
 
 html_theme = "mpl_sphinx_theme"
-html_logo = "_static/logo2.svg"
 html_favicon = "_static/favicon.ico"
 html_theme_options = {
     "logo_link": "https://matplotlib.org/stable/",
     # collapse_navigation in pydata-sphinx-theme is slow, so skipped for local
     # and CI builds https://github.com/pydata/pydata-sphinx-theme/pull/386
     "collapse_navigation": not is_release_build,
-    "icon_links": [
-        {
-            "name": "gitter",
-            "url": "https://gitter.im/matplotlib",
-            "icon": "fab fa-gitter",
-        },
-        {
-            "name": "discourse",
-            "url": "https://discourse.matplotlib.org",
-            "icon": "fab fa-discourse",
-        },
-        {
-            "name": "GitHub",
-            "url": "https://github.com/matplotlib/matplotlib",
-            "icon": "fab fa-github-square",
-        },
-        {
-            "name": "twitter",
-            "url": "https://twitter.com/matplotlib/",
-            "icon": "fab fa-twitter-square",
-        },
-    ],
     "show_prev_next": False,
-    "navbar_center": ["mpl_nav_bar.html"],
     "native_site": False
 }
 

docs/index.rst

@@ -19,9 +19,10 @@ line in your conf.py file
 And by including ``mpl_sphinx_theme`` as a requirement in your documentation
 installation.
 
-Note that the theme does not currently install the `logo2.svg` or 
-the `favicon.ico`.  You shoudl copy those from `docs/_static` to 
-the local project `docs/_static`. 
+Note that the option ``html_logo`` need not be specified as it is for 
+``pydata-sphinx-theme``.
+
+To change the top navbar, edit ``mpl_sphinx_theme/mpl_nav_bar.html``
 
 The full ``conf.py`` is 
 

mpl_sphinx_theme/mpl_icon_links.html

@@ -0,0 +1,52 @@
+{%- block icon_links -%}
+{%- macro icon_link_nav_item(url, icon, name) -%}
+  {%- if url | length > 2 %}
+        <li class="nav-item">
+          <a class="nav-link" href="{{ url }}" rel="noopener" target="_blank" title="{{ _(name) }}">
+            <span><i class="{{ icon }}"></i></span>
+            <label class="sr-only">{{ _(name) }}</label>
+          </a>
+        </li>
+  {%- endif -%}
+{%- endmacro -%}
+{%- if theme_icon_links %}  
+      <ul id="navbar-icon-links" class="navbar-nav" aria-label="{{ _(theme_icon_links_label) }}">
+        {%- block icon_link_shortcuts -%}
+        {{ icon_link_nav_item(theme_github_url, "fab fa-github-square", "GitHub") -}}
+        {{ icon_link_nav_item(theme_gitlab_url, "fab fa-gitlab", "GitLab") -}}
+        {{ icon_link_nav_item(theme_bitbucket_url, "fab fa-bitbucket", "Bitbucket") -}}
+        {{ icon_link_nav_item(theme_twitter_url, "fab fa-twitter-square", "Twitter") -}}
+        {% endblock -%}
+        {%- for icon_link in theme_icon_links -%}
+        {{ icon_link_nav_item(icon_link["url"], icon_link["icon"], icon_link["name"]) -}}
+        {%- endfor %}
+      </ul>
+{%- else %}
+      <ul id="navbar-icon-links" class="navbar-nav" aria-label="{{ _(theme_icon_links_label) }}">
+        <li class="nav-item">
+          <a class="nav-link" href="https://gitter.im/matplotlib" rel="noopener" target="_blank" title="gitter">
+            <span><i class="fab fa-gitter"></i></span>
+            <label class="sr-only">gitter</label>
+          </a>
+        </li>
+        <li class="nav-item">
+          <a class="nav-link" href="https://discourse.matplotlib.org" rel="noopener" target="_blank" title="discourse">
+            <span><i class="fab fa-discourse"></i></span>
+            <label class="sr-only">discourse</label>
+          </a>
+        </li>
+        <li class="nav-item">
+          <a class="nav-link" href="https://github.com/matplotlib/matplotlib" rel="noopener" target="_blank" title="GitHub">
+            <span><i class="fab fa-github-square"></i></span>
+            <label class="sr-only">GitHub</label>
+          </a>
+        </li>
+        <li class="nav-item">
+          <a class="nav-link" href="https://twitter.com/matplotlib/" rel="noopener" target="_blank" title="twitter">
+            <span><i class="fab fa-twitter-square"></i></span>
+            <label class="sr-only">twitter</label>
+          </a>
+        </li>
+      </ul>
+{%- endif %}  
+{%- endblock %}

mpl_sphinx_theme/static/images/background.png

@@ -3,4 +3,8 @@ inherit = pydata_sphinx_theme
 stylesheet = css/style.css
 
 [options]
-native_site = False
+native_site = False
+navbar_start = mpl_navbar_logo.html
+navbar_center = mpl_nav_bar.html
+navbar_end = mpl_icon_links.html
+logo_link =