v0.6.0

What's Changed

Dependencies

• ⬆️ Python v3.9-3.12 by @chrisjsewell in #186
• ⬆️ Octicon icons to v19.8.0 by @ffvpor in #171

New

✨ Create custom directives

You can use the sd_custom_directives configuration option in your conf.py to add custom directives, with default option values:

sd_custom_directives = {
  "dropdown-syntax": {
    "inherit": "dropdown",
    "argument": "Syntax",
    "options": {
      "color": "primary",
      "icon": "code",
    },
  }
}

The key is the new directive name to add, and the value is a dictionary with the following keys:

• inherit: The directive to inherit from (e.g. dropdown)
• argument: The default argument (optional, only for directives that take a single argument)
• options: A dictionary of default options for the directive (optional)

by @chrisjsewell in #194

✨ sync tabs by URL query parameters

Synchronised tabs can now be selected by adding a query parameter to the URL, for that sync-group, such as ?code=python for

.. tab-set-code::

    .. literalinclude:: snippet.py
        :language: python

    .. literalinclude:: snippet.js
        :language: javascript

The last selected tab key, per group, is also persisted SessionStorage

by @mikemckiernan and @chrisjsewell in #196

Improve

• 👌 Use reference name by default for internal link cards by @gabalafou in #183
• 👌 Improve specificity of JS function name by @danirus in #153
• 👌 Remove duplicate CSS hashing for sphinx >= 7.1 by @chrisjsewell in #193

👌 Improve dropdown title bar

There are three visible changes:

1. The "default" behaviour of the right chevron is to go from right-facing (closed) to down-facing (open), instead of down-facing (closed) to up-facing (open). There is also a rotate transition on opening/closing.
   The old default behaviour can be retained by using the new :chevron: down-up directive option.
2. The prefix icon (optional), title text, and chevron state icon are now all better aligned
3. The top/bottom padding is now 0.5em instead of 1em

The PR also introduces three new CSS variables to control font sizes of the dropdown:

--sd-fontsize-tabs-label: 1rem;
--sd-fontsize-dropdown-title: 1rem;
--sd-fontweight-dropdown-title: 700;

Internally, the HTML / CSS is changed, such that the title is now an inline-flex box, with three columns arranged with justify-content: space-between:

icon (optional)	text (flex-grow: 1)	state chevron

Also, the state chevron was previously two distinct SVGs (with one hidden), but now is one that get rotated on open/close.

by @chrisjsewell in #192

Fix

• 🐛 Fix tab-item label with nested syntax by @Praecordi in #135
• 🐛 Fix do not close input tag by @chrisjsewell in #195

Internal

• 📚 Update theme versions by @chrisjsewell in #189

• 📚 Make octicon list a table by @chrisjsewell in #188

• 📚 Add sphinx-immaterial to doc theme builds by @chrisjsewell in #190

• 📚 Change syntax dropdown color by @chrisjsewell in #191

• 🔧 Add FIPS compliant flag to md5 call by @gabor-varga in #162

• 🔧 define build.os for RTD to fix build by @sciencewhiz in #176

• 🔧 Move to ruff by @chrisjsewell in #185

New Contributors

• @danirus made their first contribution in #153
• @sciencewhiz made their first contribution in #176
• @ffvpor made their first contribution in #171
• @Praecordi made their first contribution in #135
• @gabor-varga made their first contribution in #162
• @gabalafou made their first contribution in #183

Full Changelog: v0.5.0...v0.6.0