Changelog#

Shibuya uses date based release segments. For pre-releases, it follows PEP 440.

2026.7.12#

  • Fix: Fix social icons display.

  • Fix: Use underline for links.

2026.7.11#

  • Fix: Normalize navbar and footer social links.

  • Fix: Allow empty navbar and footer social icons.

  • Fix: Allow codespan in TOC.

2026.7.8#

  • Fix: Use flex wrap for landing page buttons.

  • Fix: Show anchor links for glossary directives.

  • Update: Use x_url instead of twitter_url.

  • New: Add bluesky_url configuration.

  • New: Add nav_socials and foot_socials configuration.

  • Deprecated: twitter_url, twitter_site, twitter_creator.

2026.5.19#

  • Fix: Highlight nested local TOC.

  • Fix: Fix local TOC highlight for API references.

  • Fix: Update style for lists.

2026.1.9#

  • Fix: Add translation for “Discussion” text.

  • Fix: Using sun-moon icon for “auto” color mode.

2025.12.19#

  • Fix: Fix “Copy page” button when there is no source URL.

2025.12.17#

  • Fix: Generate absolute source URL for “Copy page” button, via issue #103.

  • New: Add hide_ai_links meta tag to disable “Copy page” button on current page.

2025.12.16#

  • Fix: Add z-index for “Copy page” dropdown, via issue #102.

2025.12.14#

  • Fix: Support “Copy page” button on Safari.

  • Fix: Update style for Algolia docsearch extension.

  • New: Add “Copy page” button on compact layout.

2025.12.13#

  • New: Add a “Copy page” button with dropdown of open in AI links.

2025.11.10#

  • Fix: Follow system theme changes on auto color mode, via issue #98.

2025.11.4#

  • New: Support extension sphinxext-opengraph, via issue #97.

  • Update: Remove python 3.9, add python 3.14.

2025.10.21#

  • New: Add :content_max_width meta configuration, via issue #94.

  • Fix: Enhanced pygments.css to work better in both light and dark modes.

2025.10.20#

2025.9.25#

  • Fix: Add dark theme support for sphinxcontrib-mermaid extension.

  • Fix: Fix building error when toc is empty, via issue #91.

  • Fix: Improve shibuya.sponsors extension.

2025.9.24#

  • New: add a shibuya.sponsors extension.

  • Fix: remove useless pygments css files.

  • Fix: hide username when repository name is too long.

  • Fix: update head backrop blur style.

  • Fix: update base template’s block theme_scripts to themescripts.

2025.9.23#

  • Fix: fix pageurl context when it is None, via issue #90.

2025.9.22#

  • Refactor: Update python code structure.

  • Fix: Support for Pygments extension, via issue #89.

  • Fix: Build pygments styles dynamically.

  • Fix: Fix text overflow for math block and pre.

  • Fix: Fix style for buysellads.

2025.8.16#

  • Update: Use tailwindcss v4.

  • Fix: Improve copybutton’s position in code blocks.

  • Fix: Improve style for sphinx-contributors.

  • Fix: Fix JS errors when scrolling on landing page.

2025.7.24#

  • Fix: Improve accessibility for nav links, you can now using keyboard to open sub nav links.

  • Fix: Update sphinx-design’s style for iconify-icon.

2025.7.14#

  • New: Add data-accent-color style for sphinx-iconify.

  • New: Add outline variant style for sphinx-design’s tab-set.

2025.4.25#

  • New: Add resource parameter to nav_links, via issue #83.

2025.3.24#

  • Fix: Remove margin-top for dl.field-list, via issue #81.

2025.2.28#

  • Fix: Fix style for sphinx-contributors.

2025.2.20#

  • Breaking: Set default source_version config from master to main.

  • Fix: Skip prompt when selecting code, via pull request #80.

  • Fix: Add bottom margin for admonition content, via issue #77.

  • Fix: Add bottom margin for images.

2025.2.14#

  • Fix: Use correct icon for gitlab in foot, via issue #78.

2025.2.11#

2025.1.29#

2024.12.21#

  • Fix: Rename css variables from {name}t-contrast to {name}-contrast, via pull request #71.

2024.12.20#

2024.12.15#

  • Fix: Add min-height for main element, via issue #68.

  • Fix: Set admonition block to be flex box, via issue #69.

  • Fix: Update icons for version related directives.

2024.12.13#

  • New: Add style for versionremoved directive.

2024.10.15#

  • Fix: Update integration with Read the Docs Addons.

2024.10.14#

  • Fix: Set max-height for the sidebar scroller.

  • Fix: Update background color for jupyter-sphinx code blocks, via issue #66.

2024.8.30#

  • Fix: Update translation files.

  • Fix: Add min-height for RTD other versions.

2024.8.27#

  • Fix: Update style for admonition, use block instead of flex.

  • Fix: Use <iconify-icon> web component for social icons.

2024.8.26#

2024.8.21#

  • Fix: Fix sphinx-design grid css conflict with admonition.

2024.7.13#

  • New: Add slack_url theme option.

  • New: Add partials/nav-socials.html template.

  • Fix: Word break for right sidebar’s repository stats component.

2024.6.23#

  • Fix: Improve style for sphinx togglebutton.

  • Fix: Remove prefix in local TOC for API references.

  • Fix: Fix table style, avoid extra padding for tables.

2024.6.1#

  • New: Allow customize social network with partial template.

  • New: Add nav_links_align theme option.

  • Fix: Improve sidebar style for mobile view.

  • Fix: Use localStorage for theme mode state.

  • Fix: Hide rtd injected widget on landing page.

  • Fix: Lazy load logo to improve page speed.

  • Fix: Improve admonition style.

2024.5.15#

  • Fix: Update style for floatting image with admonition.

2024.5.14#

  • New: Added integration with sphinx-click.

  • New: Added style for menuselection.

  • New: Added style for sidebar.

  • New: Added style for align images.

  • Fix: Updated CSS for h5, h6, and .rubric.

2024.5.10#

  • New: Added linkedin_url theme option

  • New: Make theme switch a component

  • Fix: Cleanup html_context to prevent sphinx 7.3 warnings

2024.4.27#

  • New: Added integration with sphinx-sqlalchemy.

  • Fix: Improve accessibility with aria-label.

  • Fix: Improve style for nav links and docsearch.

  • Breaking: Fix typo of Lucide icons.

2024.4.15#

  • Breaking: Lucide and Simple Icons are splitted

  • New: Added 404 layout template

  • New: Added readthedocs_url theme option

  • Fix: Improve style for API autosummary tables

2024.4.8#

  • New: Added integration with sphinx-docsearch

  • New: Added reddit_url theme option

  • New: Added discussion_url theme option

  • Fix: Improve style for tables

  • Fix: Added external key for nav links

2024.4.4#

  • New: Auto highlight local TOC links

  • New: Added back to top button

  • Fix: Improve style for code blocks in tabs

  • Fix: Improve accent color definition

  • Fix: Improve style for copybutton

2024.3.1#

  • New: Added page_layout theme option

  • New: Added color_mode theme option

  • New: Added compact page layout

  • Fix: Improve style for nbsphinx tables

2024.2.21#

  • New: Added source_version html context

  • New: Added source_docs_path html context

  • Fix: Improve code block caption background color

2024.1.17#

  • New: Added “ghost” style tables.

  • New: Improve SEO with BreadcrumbList schema.

  • Fix: Change <img> style to inline.

2024.1.2#

  • Fix: Add opengraph information for landing and simple layouts.

  • Fix: Move .buttons container into global css.

2024.1.1#

  • Breaking: --sy-rc-theme CSS variable has been removed in favor of Accent colors.

  • Breaking: Several CSS variable names are changed.

  • Breaking: light_css_variables and dark_css_variables theme option has been removed.

  • New: Added many pre-defined Accent colors.

  • New: Added style for sphinx-gallery and xarray, via issue #20.

  • New: Added simple and landing layout templates.

  • New: Added two image containers.

  • Fix: Improve style for sphinx-design, jupyter-sphinx, and etc.

  • Fix: Improve style for search page.

2023.10.26#

  • Add gitlab_url and bitbucket_url

  • Update Twitter icon to X icon

  • Integrate with numpydoc extension

  • Improve CSS for sphinx.ext.autosummary extension

  • Add light-only and dark-only class

2023.10.5#

  • Fix deprecated links in relations.html and searchbox.html

2023.9.3#

  • Improve sidebar CSS for compatibility

  • Add an alias template of localtoc.html

  • Add deprecated warning templates of relations.html and searchbox.html

  • Improve CSS for nbsphinx extension

  • New feature for global TOC configuration

  • Improve CSS for global TOC

2023.7.28#

  • Remove current hreflang link

  • Fix nested TOC links, via issue #7

  • Use theme color for code blocks, via issue #5

  • Remove version parameter on assets URLs

2023.7.16#

  • Fix multiple languages links for index pages

  • Add hreflang links for SEO

  • Add locale data of theme templates

2023.7.15#

  • Change multiple languages configuration

2023.7.14#

  • Add YouTube link

  • Improve style for versions and languages

  • Improve breadcrumbs style

  • Add expand and collapse global TOC

2023.7.11#

  • Fix style for genindex

  • Add breadcrumbs for small screen

  • Move TOC controllers to breadcrumbs block

  • Move RTD versions to left sidebar

  • Add multiple languages switcher

2023.6.30#

  • Fix normalize toc with xml.etree

  • Fix local toc style

  • Fix style of main part for large screen

2023.6.27#

  • Fix style of copybutton for dark code mode

  • Fix style for modindex page

2023.6.25#

  • Apply dark_css_variables in templates

  • Fix code block style in dark code mode for sphinx design

  • Fix colors for API docs in dark code mode

  • Fix stderr background for nbsphinx

2023.6.21#

  • Add support for sphinx-togglebutton extension

  • Add support for nbsphinx extension

  • Rename template partials/sidebar-links to partials/globaltoc-above

  • Add template extensions/buysellads

2023.6.18#

  • Fix edit this page link

  • Fix nav links style

  • Update style for jupyter-sphinx

2023.6.8#

  • Add external-link icon for external nav links

  • Add highlight background color for search results

  • Fix search results page nav links for mobile devices

  • Add native built-in carbon ads

2023.6.7#

  • Fix scroll-margin-top for sections

  • Change “edit this page” link

  • Add an option to use your own Ethical Ads publisher ID

  • Update navbar links style

  • Add navbar children links

2023.3.19#

  • Enable repo-stats sidebar by default

  • Improve colors for dark mode

2023.3.11#

  • Auto resize announcement banner

  • Fix context for readthedocs

2023.3.7#

  • Add “edit this page” in sidebar

  • Add GitHub / Gitlab repository stats

  • Fix versions on css files

2023.3.5#

  • Add dark code mode

  • Improve style for print media

  • Improve style for sphinx-design

2023.3.2#

  • Improve style for quotes

  • Add github link on nav bar

2023.3.1#

  • Fix margins for “kbd”

  • Add style for sphinx-tabs

  • Improve style for code blocks

2023.2.25a2#

  • Fix templates when pageurl is None

  • Improve opengraph with more theme options

  • Tweak style, fix for a11y

  • Move theme switch to site head

  • Add logos and colors

2023.2.23a1#

Initial release.