just-the-docs 0.10.2 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6af67b1731acefa0c5c649b333b15d0e570c8e7e369d0b211a9be581a4669316
-  data.tar.gz: '08ca00287ee526bcd6dc974dba9bd645964d52188f9bb90929774a7c6e7c2e0a'
+  metadata.gz: 147f77407afd5dfb821b06e557e7cde686b1069a73c6b84d641e175630e71ac4
+  data.tar.gz: 03db96ba647f58169f56dfafe2e1794e6b2ae83080acc4ecd75fd1a192f60bb6
 SHA512:
-  metadata.gz: b94be55dc8646ee840ff09a72ff8fc46f4f8f3a66f405d959dd13523356237ba5b382a38710f7831ccc7dab9f1637da914db9a4799743ff9764ed9ee506a2d2b
-  data.tar.gz: 875b2a10bba410a7157e4cc74d2a4f9613cd1c34510f87504d4b8464f5eaf6a41c62ace4f18c1c0ff6326e79adb6fbf1e7f1581be94a94b805a69076d109e4f6
+  metadata.gz: 369f9472d750b4aaf81adbac120338a55afe344ad46241fa81b5c187e9208ee9ee1243caf379b09bd7de896b0090d4162168cf44616e0e766539985984b78cb9
+  data.tar.gz: fff61dc85ca000f11019610ef9735b95dc9f9380e2445c5b141e3991349cc4ae418995035318f0034e148751831960d14db6f2c616c650dd0d296b902536c2d1

data/CHANGELOG.md

@@ -24,6 +24,24 @@ Docs changes made since the latest release:
 
 - N/A
 
+## v0.11.0 - 2026-01-01
+
+### Theme
+
+- Fixed: low-contrast syntax highlighting via `accessible-pygments` and harsher backgrounds by [@mattxwang](https://github.com/mattxwang) in [#1749](https://github.com/just-the-docs/just-the-docs/pull/1749)
+- Fixed: callout body text color contrast by [@mattxwang](https://github.com/mattxwang) in [#1748](https://github.com/just-the-docs/just-the-docs/pull/1748)
+- Fixed: button and label color contrast by [@mattxwang](https://github.com/mattxwang) in [#1750](https://github.com/just-the-docs/just-the-docs/pull/1750)
+- Fixed: inability to focus on scrollable code blocks via keyboard navigation by [@mattxwang](https://github.com/mattxwang) in [#1533](https://github.com/just-the-docs/just-the-docs/pull/1533)
+- Fixed: `.site-footer` focus order on `sm` (mobile) viewport by [@mattxwang](https://github.com/mattxwang) in [#1751](https://github.com/just-the-docs/just-the-docs/pull/1751)
+- Fixed: color contrast between dark mode background and `$link-color` by [@mattxwang](https://github.com/mattxwang) in [#1752](https://github.com/just-the-docs/just-the-docs/pull/1752)
+- Fixed: color contrast for selected `.nav-list-link` in light mode by [@mattxwang](https://github.com/mattxwang) in [#1753](https://github.com/just-the-docs/just-the-docs/pull/1753)
+- Fixed: sidebar ARIA role (by including navigation) by [@mattxwang](https://github.com/mattxwang) in [#1754](https://github.com/just-the-docs/just-the-docs/pull/1754)
+- Fixed: `footer_content`/`footer_custom` color contrast by [@mattxwang](https://github.com/mattxwang) in [#1755](https://github.com/just-the-docs/just-the-docs/pull/1755)
+
+### Documentation
+
+- Added: aXe accessibility tests by [@cycomachead](https://github.com/cycomachead) in [#1756](https://github.com/just-the-docs/just-the-docs/pull/1756)
+
 ## v0.10.2 - 2025-12-31
 
 ### Theme

data/_includes/components/footer.html

@@ -1,34 +1,49 @@
 {% capture footer_custom %}
   {%- include footer_custom.html -%}
 {% endcapture %}
-{% if footer_custom != "" or site.last_edit_timestamp or site.gh_edit_link or site.back_to_top %}
-  <hr>
-  <footer>
-    {% if site.back_to_top %}
-      <p><a href="#top" id="back-to-top">{{ site.back_to_top_text }}</a></p>
-    {% endif %}
+<hr>
+<footer>
+  {% if site.back_to_top %}
+    <p><a href="#top" id="back-to-top">{{ site.back_to_top_text }}</a></p>
+  {% endif %}
+
+  {{ footer_custom }}
+
+  {% if site.last_edit_timestamp or site.gh_edit_link %}
+    <div class="d-flex mt-2">
+      {% if site.last_edit_timestamp and site.last_edit_time_format and page.last_modified_date %}
+        <p class="text-small mb-0 mr-2">
+          Page last modified: <span class="d-inline-block">{{ page.last_modified_date | date: site.last_edit_time_format }}</span>.
+        </p>
+      {% endif %}
+      {% if
+        site.gh_edit_link and
+        site.gh_edit_link_text and
+        site.gh_edit_repository and
+        site.gh_edit_branch and
+        site.gh_edit_view_mode
+      %}
+        <p class="text-small mb-0">
+          <a href="{{ site.gh_edit_repository }}/{{ site.gh_edit_view_mode }}/{{ site.gh_edit_branch }}{% if site.gh_edit_source %}/{{ site.gh_edit_source }}{% endif %}{% if page.collection and site.collections_dir %}/{{ site.collections_dir }}{% endif %}/{{ page.path }}" id="edit-this-page">{{ site.gh_edit_link_text }}</a>
+        </p>
+      {% endif %}
+    </div>
+  {% endif %}
 
-    {{ footer_custom }}
+  {%- comment -%}
+    note: nav_footer_custom and/or this "site footer" appear in components/sidebar.html for the desktop view.
+  {%- endcomment -%}
 
-    {% if site.last_edit_timestamp or site.gh_edit_link %}
-      <div class="d-flex mt-2">
-        {% if site.last_edit_timestamp and site.last_edit_time_format and page.last_modified_date %}
-          <p class="text-small text-grey-dk-000 mb-0 mr-2">
-            Page last modified: <span class="d-inline-block">{{ page.last_modified_date | date: site.last_edit_time_format }}</span>.
-          </p>
-        {% endif %}
-        {% if
-          site.gh_edit_link and
-          site.gh_edit_link_text and
-          site.gh_edit_repository and
-          site.gh_edit_branch and
-          site.gh_edit_view_mode
-        %}
-          <p class="text-small text-grey-dk-000 mb-0">
-            <a href="{{ site.gh_edit_repository }}/{{ site.gh_edit_view_mode }}/{{ site.gh_edit_branch }}{% if site.gh_edit_source %}/{{ site.gh_edit_source }}{% endif %}{% if page.collection and site.collections_dir %}/{{ site.collections_dir }}{% endif %}/{{ page.path }}" id="edit-this-page">{{ site.gh_edit_link_text }}</a>
-          </p>
-        {% endif %}
+  <div class="d-sm-block d-md-none">
+    {% capture nav_footer_custom %}
+      {%- include nav_footer_custom.html -%}
+    {% endcapture %}
+    {% if nav_footer_custom != "" %}
+      {{ nav_footer_custom }}
+    {% else %}
+      <div class="mt-4 fs-2">
+        This site uses <a href="https://github.com/just-the-docs/just-the-docs">Just the Docs</a>, a documentation theme for Jekyll.
       </div>
     {% endif %}
-  </footer>
-{% endif %}
+  </div>
+</footer>

data/_includes/components/sidebar.html

@@ -9,8 +9,8 @@
   Should not be cached, because nav_footer_custom.html might depend on page.
 {%- endcomment -%}
 
-<div class="side-bar">
-  <div class="site-header" role="banner">
+<header class="side-bar">
+  <div class="site-header">
     <a href="{{ '/' | relative_url }}" class="site-title lh-tight">{% include title.html %}</a>
     <button id="menu-button" class="site-button btn-reset" aria-label="Menu" aria-expanded="false">
       <svg viewBox="0 0 24 24" class="icon" aria-hidden="true"><use xlink:href="#svg-menu"></use></svg>
@@ -19,14 +19,20 @@
 
   {% include_cached components/site_nav.html %}
 
+  {%- comment -%}
+    note: nav_footer_custom and/or this "site footer" appear in components/footer.html for the mobile view.
+  {%- endcomment -%}
+
+  <div class="d-md-block d-sm-none">
   {% capture nav_footer_custom %}
     {%- include nav_footer_custom.html -%}
   {% endcapture %}
   {% if nav_footer_custom != "" %}
     {{ nav_footer_custom }}
   {% else %}
-    <footer class="site-footer">
+    <div class="site-footer">
       This site uses <a href="https://github.com/just-the-docs/just-the-docs">Just the Docs</a>, a documentation theme for Jekyll.
-    </footer>
+    </div>
   {% endif %}
-</div>
+  </div>
+</header>

data/_includes/css/callouts.scss.liquid

@@ -8,7 +8,7 @@
 {%- assign callout_color_hue = "300" -%}
 {%- if site.callouts_level == "loud" or include.color_scheme == "dark" and site.callouts_level != "quiet" -%}
   {%- assign callout_background_hue = "300" -%}
-  {%- assign callout_color_hue = "000" -%}
+  {%- assign callout_color_hue = "300" -%}
 {%- endif -%}
 
 div.opaque {
@@ -17,10 +17,8 @@ div.opaque {
 
 {%- for callout in site.callouts %}
 
-{%- assign callout_opacity = callout[1].opacity | default: site.callouts_opacity | default: 0.2 -%}
-
 p.{{ callout[0] }}, blockquote.{{ callout[0] }} {
-    background: rgba(${{ callout[1].color }}-{{ callout_background_hue }}, {{ callout_opacity }});
+    border: 1px ${{ callout[1].color }}-{{ callout_background_hue }} solid;
     border-left: $border-radius solid ${{ callout[1].color }}-{{ callout_color_hue }};
     border-radius: $border-radius;
     box-shadow: 0 1px 2px rgba(0, 0, 0, 0.12), 0 3px 10px rgba(0, 0, 0, 0.08);
@@ -47,7 +45,7 @@ p.{{ callout[0] }}, blockquote.{{ callout[0] }} {
 }
 
 p.{{ callout[0] }}-title, blockquote.{{ callout[0] }}-title {
-    background: rgba(${{ callout[1].color }}-{{ callout_background_hue }}, {{ callout_opacity }});
+    border: 1px ${{ callout[1].color }}-{{ callout_background_hue }} solid;
     border-left: $border-radius solid ${{ callout[1].color }}-{{ callout_color_hue }};
     border-radius: $border-radius;
     box-shadow: 0 1px 2px rgba(0, 0, 0, 0.12), 0 3px 10px rgba(0, 0, 0, 0.08);
@@ -67,11 +65,11 @@ p.{{ callout[0] }}-title, blockquote.{{ callout[0] }}-title {
 blockquote.{{ callout[0] }} {
   margin-left: 0;
   margin-right: 0;
-  
+
   > p:first-child {
     margin-top: 0;
   }
-    
+
   > p:last-child {
     margin-bottom: 0;
   }
@@ -80,11 +78,11 @@ blockquote.{{ callout[0] }} {
 blockquote.{{ callout[0] }}-title {
   margin-left: 0;
   margin-right: 0;
-  
+
   > p:nth-child(2) {
     margin-top: 0;
   }
-    
+
   > p:last-child {
     margin-bottom: 0;
   }

data/_includes/footer_custom.html

@@ -1,3 +1,3 @@
 {%- if site.footer_content -%}
-  <p class="text-small text-grey-dk-100 mb-0">{{ site.footer_content }}</p>
+  <p class="text-small mb-0">{{ site.footer_content }}</p>
 {%- endif -%}

data/_sass/buttons.scss

@@ -109,11 +109,11 @@
 }
 
 .btn-blue {
-  @include btn-color($white, $blue-000);
+  @include btn-color($white, $blue-200);
 }
 
 .btn-green {
-  @include btn-color($white, $green-100);
+  @include btn-color($white, $green-300);
 }
 
 .btn-reset {

data/_sass/code.scss

@@ -87,8 +87,9 @@ figure.highlight {
     position: absolute;
     top: 0;
     right: 0;
-    border: $sp-3 solid $code-background-color;
-    background-color: $code-background-color;
+    padding: $sp-3;
+    border: none;
+    background: none;
     color: $body-text-color;
     box-sizing: content-box;
 
@@ -104,6 +105,7 @@ figure.highlight {
 
     &:focus {
       opacity: 1;
+      outline: 2px solid $link-color;
     }
   }
 
@@ -124,7 +126,8 @@ figure.highlight {
     overflow-x: auto;
     padding: $sp-3;
     margin: 0;
-    border: 0;
+    border: 1px solid $body-text-color;
+    border-radius: $border-radius;
   }
 
   #{$pre-select},
@@ -160,7 +163,8 @@ figure.highlight {
     overflow-x: auto;
     padding: $sp-3;
     margin: 0;
-    border: 0;
+    border: 1px solid $body-text-color;
+    border-radius: $border-radius;
   }
 }
 

data/_sass/color_schemes/dark.scss

@@ -2,17 +2,17 @@ $color-scheme: dark;
 $body-background-color: $grey-dk-300;
 $body-heading-color: $grey-lt-000;
 $body-text-color: $grey-lt-300;
-$link-color: $blue-000;
+$link-color: lighten($blue-000, 10%);
 $nav-child-link-color: $grey-dk-000;
 $sidebar-color: $grey-dk-300;
 $base-button-color: $grey-dk-250;
 $btn-primary-color: $blue-200;
-$code-background-color: #31343f; // OneDarkJekyll default for syntax-one-dark-vivid
-$code-linenumber-color: #dee2f7; // OneDarkJekyll .nf for syntax-one-dark-vivid
+$code-background-color: #0d1117; // github-dark bg color
+$code-linenumber-color: #e6edf3; // github-dark line number color
 $feedback-color: darken($sidebar-color, 3%);
 $table-background-color: $grey-dk-250;
 $search-background-color: $grey-dk-250;
 $search-result-preview-color: $grey-lt-300;
 $border-color: $grey-dk-200;
 
-@import "./vendor/OneDarkJekyll/syntax"; // this is the one-dark-vivid atom syntax theme
+@import "./vendor/accessible-pygments/github-dark";

data/_sass/color_schemes/light.scss

@@ -7,10 +7,10 @@ $nav-child-link-color: $grey-dk-100 !default;
 $sidebar-color: $grey-lt-000 !default;
 $base-button-color: #f7f7f7 !default;
 $btn-primary-color: $purple-100 !default;
-$code-background-color: $grey-lt-000 !default;
+$code-background-color: $white !default;
 $feedback-color: darken($sidebar-color, 3%) !default;
 $table-background-color: $white !default;
 $search-background-color: $white !default;
 $search-result-preview-color: $grey-dk-100 !default;
 
-@import "./vendor/OneLightJekyll/syntax";
+@import "./vendor/accessible-pygments/github-light";

data/_sass/labels.scss

@@ -20,7 +20,7 @@
 }
 
 .label-green:not(g) {
-  background-color: $green-200;
+  background-color: $green-300;
 }
 
 .label-purple:not(g) {
@@ -28,7 +28,7 @@
 }
 
 .label-red:not(g) {
-  background-color: $red-200;
+  background-color: $red-300;
 }
 
 .label-yellow:not(g) {

data/_sass/layout.scss

@@ -185,21 +185,6 @@
   );
 }
 
-// stylelint-disable selector-max-type
-
-body {
-  position: relative;
-  padding-bottom: $sp-10;
-  overflow-y: scroll;
-
-  @include mq(md) {
-    position: static;
-    padding-bottom: 0;
-  }
-}
-
-// stylelint-enable selector-max-type
-
 .site-footer {
   position: absolute;
   bottom: 0;

data/_sass/navigation.scss

@@ -56,6 +56,7 @@
 
       &:hover,
       &.active {
+        color: darken($link-color, 5%);
         background-image: linear-gradient(
           -90deg,
           rgba($feedback-color, 1) 0%,

data/_sass/vendor/accessible-pygments/LICENSE

@@ -0,0 +1,59 @@
+# accessible-pygments
+
+BSD 3-Clause License
+
+Copyright (c) 2022, Quansight Labs
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+# pygments
+
+Copyright (c) 2006-2022 by the respective authors (see AUTHORS file).
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+* Redistributions of source code must retain the above copyright
+  notice, this list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer in the
+  documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/_sass/vendor/accessible-pygments/README.md

@@ -0,0 +1,7 @@
+# accessible-pygments
+
+[`accessible-pygments`](https://github.com/Quansight-Labs/accessible-pygments/tree/main) is a project that implements accessible syntax highlighting themes for pygments. Just the Docs packages two (S)CSS versions of their themes: github-light and github-dark.
+
+The project is released under the BSD 3-Clause, which is both enclosed in this directory and available in [the original accessible-pygments repository](https://github.com/Quansight-Labs/accessible-pygments/blob/main/LICENSE).
+
+Note that accessible-pygments is generated with [pygments](https://github.com/pygments/pygments), which is licensed under the BSD 2-Clause License. That license is also enclosed in this directory and available in [the original pygments repository](https://github.com/pygments/pygments/blob/master/LICENSE).

data/_sass/vendor/accessible-pygments/github-dark.scss

@@ -0,0 +1,91 @@
+/*
+generated by accessible-pygments <https://github.com/Quansight-Labs/accessible-pygments>
+Copyright (c) 2022, Quansight Labs
+Licensed under the BSD license, see LICENSE for details.
+--
+generated by Pygments <https://pygments.org/>
+Copyright 2006-2025 by the Pygments team.
+Licensed under the BSD license, see LICENSE for details.
+*/
+
+.highlight .hll { background-color: #6e7681 }
+.highlight { background: #0d1117; color: #E6EDF3 }
+.highlight .c { color: #8B949E; font-style: italic } /* Comment */
+.highlight .err { color: #F85149 } /* Error */
+.highlight .esc { color: #E6EDF3 } /* Escape */
+.highlight .g { color: #E6EDF3 } /* Generic */
+.highlight .k { color: #FF7B72 } /* Keyword */
+.highlight .l { color: #A5D6FF } /* Literal */
+.highlight .n { color: #E6EDF3 } /* Name */
+.highlight .o { color: #FF7B72; font-weight: bold } /* Operator */
+.highlight .x { color: #E6EDF3 } /* Other */
+.highlight .p { color: #E6EDF3 } /* Punctuation */
+.highlight .ch { color: #8B949E; font-style: italic } /* Comment.Hashbang */
+.highlight .cm { color: #8B949E; font-style: italic } /* Comment.Multiline */
+.highlight .cp { color: #8B949E; font-weight: bold; font-style: italic } /* Comment.Preproc */
+.highlight .cpf { color: #8B949E; font-style: italic } /* Comment.PreprocFile */
+.highlight .c1 { color: #8B949E; font-style: italic } /* Comment.Single */
+.highlight .cs { color: #8B949E; font-weight: bold; font-style: italic } /* Comment.Special */
+.highlight .gd { color: #FFA198; background-color: #490202 } /* Generic.Deleted */
+.highlight .ge { color: #E6EDF3; font-style: italic } /* Generic.Emph */
+.highlight .ges { color: #E6EDF3; font-weight: bold; font-style: italic } /* Generic.EmphStrong */
+.highlight .gr { color: #FFA198 } /* Generic.Error */
+.highlight .gh { color: #79C0FF; font-weight: bold } /* Generic.Heading */
+.highlight .gi { color: #56D364; background-color: #0F5323 } /* Generic.Inserted */
+.highlight .go { color: #8B949E } /* Generic.Output */
+.highlight .gp { color: #8B949E } /* Generic.Prompt */
+.highlight .gs { color: #E6EDF3; font-weight: bold } /* Generic.Strong */
+.highlight .gu { color: #79C0FF } /* Generic.Subheading */
+.highlight .gt { color: #FF7B72 } /* Generic.Traceback */
+.highlight .g-Underline { color: #E6EDF3; text-decoration: underline } /* Generic.Underline */
+.highlight .kc { color: #79C0FF } /* Keyword.Constant */
+.highlight .kd { color: #FF7B72 } /* Keyword.Declaration */
+.highlight .kn { color: #FF7B72 } /* Keyword.Namespace */
+.highlight .kp { color: #79C0FF } /* Keyword.Pseudo */
+.highlight .kr { color: #FF7B72 } /* Keyword.Reserved */
+.highlight .kt { color: #FF7B72 } /* Keyword.Type */
+.highlight .ld { color: #79C0FF } /* Literal.Date */
+.highlight .m { color: #A5D6FF } /* Literal.Number */
+.highlight .s { color: #A5D6FF } /* Literal.String */
+.highlight .na { color: #E6EDF3 } /* Name.Attribute */
+.highlight .nb { color: #E6EDF3 } /* Name.Builtin */
+.highlight .nc { color: #F0883E; font-weight: bold } /* Name.Class */
+.highlight .no { color: #79C0FF; font-weight: bold } /* Name.Constant */
+.highlight .nd { color: #D2A8FF; font-weight: bold } /* Name.Decorator */
+.highlight .ni { color: #FFA657 } /* Name.Entity */
+.highlight .ne { color: #F0883E; font-weight: bold } /* Name.Exception */
+.highlight .nf { color: #D2A8FF; font-weight: bold } /* Name.Function */
+.highlight .nl { color: #79C0FF; font-weight: bold } /* Name.Label */
+.highlight .nn { color: #FF7B72 } /* Name.Namespace */
+.highlight .nx { color: #E6EDF3 } /* Name.Other */
+.highlight .py { color: #79C0FF } /* Name.Property */
+.highlight .nt { color: #7EE787 } /* Name.Tag */
+.highlight .nv { color: #79C0FF } /* Name.Variable */
+.highlight .ow { color: #FF7B72; font-weight: bold } /* Operator.Word */
+.highlight .pm { color: #E6EDF3 } /* Punctuation.Marker */
+.highlight .w { color: #6E7681 } /* Text.Whitespace */
+.highlight .mb { color: #A5D6FF } /* Literal.Number.Bin */
+.highlight .mf { color: #A5D6FF } /* Literal.Number.Float */
+.highlight .mh { color: #A5D6FF } /* Literal.Number.Hex */
+.highlight .mi { color: #A5D6FF } /* Literal.Number.Integer */
+.highlight .mo { color: #A5D6FF } /* Literal.Number.Oct */
+.highlight .sa { color: #79C0FF } /* Literal.String.Affix */
+.highlight .sb { color: #A5D6FF } /* Literal.String.Backtick */
+.highlight .sc { color: #A5D6FF } /* Literal.String.Char */
+.highlight .dl { color: #79C0FF } /* Literal.String.Delimiter */
+.highlight .sd { color: #A5D6FF } /* Literal.String.Doc */
+.highlight .s2 { color: #A5D6FF } /* Literal.String.Double */
+.highlight .se { color: #79C0FF } /* Literal.String.Escape */
+.highlight .sh { color: #79C0FF } /* Literal.String.Heredoc */
+.highlight .si { color: #A5D6FF } /* Literal.String.Interpol */
+.highlight .sx { color: #A5D6FF } /* Literal.String.Other */
+.highlight .sr { color: #79C0FF } /* Literal.String.Regex */
+.highlight .s1 { color: #A5D6FF } /* Literal.String.Single */
+.highlight .ss { color: #A5D6FF } /* Literal.String.Symbol */
+.highlight .bp { color: #E6EDF3 } /* Name.Builtin.Pseudo */
+.highlight .fm { color: #D2A8FF; font-weight: bold } /* Name.Function.Magic */
+.highlight .vc { color: #79C0FF } /* Name.Variable.Class */
+.highlight .vg { color: #79C0FF } /* Name.Variable.Global */
+.highlight .vi { color: #79C0FF } /* Name.Variable.Instance */
+.highlight .vm { color: #79C0FF } /* Name.Variable.Magic */
+.highlight .il { color: #A5D6FF } /* Literal.Number.Integer.Long */

data/_sass/vendor/accessible-pygments/github-light.scss

@@ -0,0 +1,81 @@
+/*
+generated by accessible-pygments <https://github.com/Quansight-Labs/accessible-pygments>
+Copyright (c) 2022, Quansight Labs
+Licensed under the BSD license, see LICENSE for details.
+--
+generated by Pygments <https://pygments.org/>
+Copyright 2006-2025 by the Pygments team.
+Licensed under the BSD license, see LICENSE for details.
+*/
+
+.highlight .hll { background-color: #0969da4a }
+.highlight .c { color: #6E7781 } /* Comment */
+.highlight .err { color: #CF222E } /* Error */
+.highlight .k { color: #CF222E } /* Keyword */
+.highlight .l { color: #953800 } /* Literal */
+.highlight .n { color: #8250DF } /* Name */
+.highlight .o { color: #116329 } /* Operator */
+.highlight .p { color: #24292F } /* Punctuation */
+.highlight .ch { color: #6E7781 } /* Comment.Hashbang */
+.highlight .cm { color: #6E7781 } /* Comment.Multiline */
+.highlight .cp { color: #6E7781 } /* Comment.Preproc */
+.highlight .cpf { color: #6E7781 } /* Comment.PreprocFile */
+.highlight .c1 { color: #6E7781 } /* Comment.Single */
+.highlight .cs { color: #6E7781 } /* Comment.Special */
+.highlight .gd { color: #0550AE } /* Generic.Deleted */
+.highlight .ge { font-style: italic } /* Generic.Emph */
+.highlight .gr { color: #CF222E } /* Generic.Error */
+.highlight .gh { color: #0550AE } /* Generic.Heading */
+.highlight .gs { font-weight: bold } /* Generic.Strong */
+.highlight .gu { color: #0550AE } /* Generic.Subheading */
+.highlight .kc { color: #0550AE } /* Keyword.Constant */
+.highlight .kd { color: #CF222E } /* Keyword.Declaration */
+.highlight .kn { color: #CF222E } /* Keyword.Namespace */
+.highlight .kp { color: #CF222E } /* Keyword.Pseudo */
+.highlight .kr { color: #CF222E } /* Keyword.Reserved */
+.highlight .kt { color: #CF222E } /* Keyword.Type */
+.highlight .ld { color: #953800 } /* Literal.Date */
+.highlight .m { color: #953800 } /* Literal.Number */
+.highlight .s { color: #0550AE } /* Literal.String */
+.highlight .na { color: #953800 } /* Name.Attribute */
+.highlight .nb { color: #953800 } /* Name.Builtin */
+.highlight .nc { color: #0550AE } /* Name.Class */
+.highlight .no { color: #0550AE } /* Name.Constant */
+.highlight .nd { color: #953800 } /* Name.Decorator */
+.highlight .ni { color: #116329 } /* Name.Entity */
+.highlight .ne { color: #8250DF } /* Name.Exception */
+.highlight .nf { color: #0550AE } /* Name.Function */
+.highlight .nl { color: #953800 } /* Name.Label */
+.highlight .nn { color: #24292F } /* Name.Namespace */
+.highlight .nx { color: #8250DF } /* Name.Other */
+.highlight .py { color: #0550AE } /* Name.Property */
+.highlight .nt { color: #116329 } /* Name.Tag */
+.highlight .nv { color: #953800 } /* Name.Variable */
+.highlight .ow { color: #8250DF } /* Operator.Word */
+.highlight .pm { color: #24292F } /* Punctuation.Marker */
+.highlight .w { color: #24292F } /* Text.Whitespace */
+.highlight .mb { color: #953800 } /* Literal.Number.Bin */
+.highlight .mf { color: #953800 } /* Literal.Number.Float */
+.highlight .mh { color: #953800 } /* Literal.Number.Hex */
+.highlight .mi { color: #953800 } /* Literal.Number.Integer */
+.highlight .mo { color: #953800 } /* Literal.Number.Oct */
+.highlight .sa { color: #0550AE } /* Literal.String.Affix */
+.highlight .sb { color: #0550AE } /* Literal.String.Backtick */
+.highlight .sc { color: #0550AE } /* Literal.String.Char */
+.highlight .dl { color: #0550AE } /* Literal.String.Delimiter */
+.highlight .sd { color: #0550AE } /* Literal.String.Doc */
+.highlight .s2 { color: #0550AE } /* Literal.String.Double */
+.highlight .se { color: #0550AE } /* Literal.String.Escape */
+.highlight .sh { color: #0550AE } /* Literal.String.Heredoc */
+.highlight .si { color: #0550AE } /* Literal.String.Interpol */
+.highlight .sx { color: #0550AE } /* Literal.String.Other */
+.highlight .sr { color: #0550AE } /* Literal.String.Regex */
+.highlight .s1 { color: #0550AE } /* Literal.String.Single */
+.highlight .ss { color: #0550AE } /* Literal.String.Symbol */
+.highlight .bp { color: #953800 } /* Name.Builtin.Pseudo */
+.highlight .fm { color: #0550AE } /* Name.Function.Magic */
+.highlight .vc { color: #953800 } /* Name.Variable.Class */
+.highlight .vg { color: #953800 } /* Name.Variable.Global */
+.highlight .vi { color: #953800 } /* Name.Variable.Instance */
+.highlight .vm { color: #953800 } /* Name.Variable.Magic */
+.highlight .il { color: #953800 } /* Literal.Number.Integer.Long */

data/assets/js/just-the-docs.js

@@ -566,8 +566,17 @@ jtd.onReady(function(){
   {%- endif %}
 });
 
-// Copy button on code
+// Accessibility: set tabindex=0 on each code highlight block, so screenreaders
+// can focus over (particularly important if there's horizontal scroll)
+// see: https://dequeuniversity.com/rules/axe/4.9/scrollable-region-focusable?application=axeAPI
+
+jtd.onReady(() => {
+  document
+    .querySelectorAll("div.highlight")
+    .forEach(codeBlock => codeBlock.setAttribute("tabindex", "0"));
+});
 
+// Copy button on code
 
 {%- if site.enable_copy_code_button != false %}
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: just-the-docs
 version: !ruby/object:Gem::Version
-  version: 0.10.2
+  version: 0.11.0
 platform: ruby
 authors:
 - Patrick Marsceill
@@ -147,7 +147,6 @@ files:
 - _sass/buttons.scss
 - _sass/code.scss
 - _sass/color_schemes/dark.scss
-- _sass/color_schemes/legacy_light.scss
 - _sass/color_schemes/light.scss
 - _sass/content.scss
 - _sass/custom/custom.scss
@@ -173,10 +172,10 @@ files:
 - _sass/utilities/_spacing.scss
 - _sass/utilities/_typography.scss
 - _sass/utilities/utilities.scss
-- _sass/vendor/OneDarkJekyll/LICENSE
-- _sass/vendor/OneDarkJekyll/syntax.scss
-- _sass/vendor/OneLightJekyll/LICENSE
-- _sass/vendor/OneLightJekyll/syntax.scss
+- _sass/vendor/accessible-pygments/LICENSE
+- _sass/vendor/accessible-pygments/README.md
+- _sass/vendor/accessible-pygments/github-dark.scss
+- _sass/vendor/accessible-pygments/github-light.scss
 - _sass/vendor/normalize.scss/README.md
 - _sass/vendor/normalize.scss/normalize.scss
 - assets/css/just-the-docs-dark.scss