Merge pull request #92 from QuLogic/theme-updates

MNT: Update Matplotlib and pydata sphinx theme

Author: timhoffm

.circleci/config.yml

@@ -1,14 +1,17 @@
 version: 2.1
 
 orbs:
-  python: circleci/python@0.2.1
+  # https://circleci.com/developer/orbs/orb/circleci/python
+  python: circleci/python@2.1.1
 
 jobs:
   build_docs:
-    executor: python/default
+    executor:
+      name: python/default
+      tag: '3.10'
     steps:
       - checkout
-      - python/install-deps
+      - python/install-packages
       - run:
           name: Build docs
           command: cd docs/ && make html

.github/workflows/codeql.yml

@@ -24,18 +24,18 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Initialize CodeQL
-        uses: github/codeql-action/init@v2
+        uses: github/codeql-action/init@v3
         with:
           languages: ${{ matrix.language }}
           queries: +security-and-quality
 
       - name: Autobuild
-        uses: github/codeql-action/autobuild@v2
+        uses: github/codeql-action/autobuild@v3
 
       - name: Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@v2
+        uses: github/codeql-action/analyze@v3
         with:
           category: "/language:${{ matrix.language }}"

.github/workflows/main.yaml

@@ -4,9 +4,9 @@ on: [push, pull_request]
 
 jobs:
   build:
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - name: Install Python dependencies
         run: pip install -r requirements.txt
       - name: Build
@@ -15,7 +15,7 @@ jobs:
         run: rm ./docs/_build/html/objects.inv
       - name: Publish
         if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}
-        uses: peaceiris/actions-gh-pages@v3
+        uses: peaceiris/actions-gh-pages@v4
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           publish_dir: ./docs/_build/html

docs/_static/css/landing.css

@@ -166,12 +166,13 @@ a.link--offsite::after {
   flex-direction: column;
   align-items: center;
   flex: 1 1 100px;
+  font-size: var(--heading-4);
+  font-family: var(--heading-font);
 }
 
-.quicklinks a {
+.quicklinks a, .quicklinks a:visited,
+.quicklinks a:hover, .quicklinks a:visited:hover {
   color: var(--default-text);
-  font-size: var(--heading-4);
-  font-family: var(--heading-font);
 }
 
 .quicklinks__icon {
@@ -386,11 +387,29 @@ ul.mpl-links {
   font-weight: bold;
 }
 
+ul.mpl-links a, ul.mpl-links a:visited,
+ul.release-docs a, ul.release-docs a:visited
+{
+  color: var(--white);
+  text-decoration: none;
+}
+
+ul.mpl-links a:hover, ul.mpl-links a:visited:hover,
+ul.release-docs a:hover, ul.release-docs a:visited:hover
+{
+  color: var(--pst-color-link-hover);
+}
+
 .release dt {
   font-family: var(--heading-font);
   font-size: var(--heading-5);
   text-transform: uppercase;
   letter-spacing: 1px;
+  margin-top: 1em;
+}
+
+.release dt:first-child {
+  margin-top: 0;
 }
 
 .release dd {
@@ -657,6 +676,10 @@ a.button::after {
   transition: margin 0.2s ease-out;
 }
 
+a.button:hover {
+  color: var(--white);
+}
+
 .button:hover::after,
 a.button:hover::after {
   margin-left: 80px;
@@ -678,7 +701,8 @@ a.button--teal {
 }
 
 .button--green,
-a.button--green {
+a.button--green,
+a.button--green:hover {
   background: var(--viridis-green);
   color: var(--black);
 }

docs/_templates/landing_footer.html

@@ -63,9 +63,7 @@ <h1>Matplotlib</h1>
         <a href="https://matplotlib.org/stable/users/whats_new.html"
           >changelog</a>
       </dd>
-    </dl>
 
-    <dl class="release">
       <dt>Development version</dt>
       <dd>
         <a href="https://matplotlib.org/devdocs/index.html">docs</a>

docs/conf.py

@@ -40,6 +40,7 @@
     "navbar_links": ("absolute", "server-stable"),
     "footer_start": ["landing_footer"],
     "secondary_sidebar_items": [],
+    "back_to_top_button": False,
 }
 
 # Add any paths that contain custom static files (such as style sheets) here,

requirements.txt

@@ -1,6 +1,6 @@
 jinja2>3
-mpl-sphinx-theme~=3.8.0
-pydata-sphinx-theme~=0.13.0
+mpl-sphinx-theme~=3.9.0
+pydata-sphinx-theme~=0.15.0
 pygments>=2.7
 sphinx>=7.1
 sphinx-notfound-page