{"id":22361,"library":"shibuya","title":"Shibuya Sphinx Theme","description":"A clean, responsive, and customizable Sphinx documentation theme with light/dark mode. Current version 2026.1.9, requires Python >=3.10. Active development with frequent releases.","status":"active","version":"2026.1.9","language":"python","source_language":"en","source_url":"https://github.com/lepture/shibuya","tags":["sphinx","documentation","theme","dark-mode","responsive","customizable"],"install":[{"cmd":"pip install shibuya","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"Set html_theme in Sphinx conf.py, not an import statement. There is no Python module to import.","wrong":"","symbol":"html_theme","correct":"html_theme = 'shibuya'  # in conf.py"}],"quickstart":{"code":"# In your Sphinx conf.py\nimport os\n\nhtml_theme = 'shibuya'\nhtml_theme_options = {\n    'accent_color': 'blue',\n    'light_logo': 'logo-light.png',\n    'dark_logo': 'logo-dark.png',\n}\n","lang":"python","description":"Configure Shibuya as your Sphinx documentation theme."},"warnings":[{"fix":"Set `html_theme = 'shibuya'` in your Sphinx conf.py file.","message":"The theme is configured via `html_theme = 'shibuya'` in conf.py, not by importing a package. Users new to Sphinx often try `import shibuya` which does nothing.","severity":"gotcha","affected_versions":"all"},{"fix":"To disable, add `'copy_button': False` and/or `'open_in_ai': False` to html_theme_options.","message":"From version 2025.12.13, a 'Copy Page' button and 'Open in AI' dropdown are added by default. If you have custom CSS or JavaScript, these may overlap.","severity":"breaking","affected_versions":">=2025.12.13"},{"fix":"Replace `'source_url': ...` with `'edit_page_url': ...` in theme options.","message":"The 'source_url' option for edit button is deprecated. Use 'edit_page_url' or 'raw_source_url' instead.","severity":"deprecated","affected_versions":">=2025.12.17"},{"fix":"Ensure `raw_source_url` starts with `https://` or is a full URL.","message":"When using `raw_source_url`, the path must be absolute URL. Relative paths cause errors in the copy page button.","severity":"gotcha","affected_versions":">=2025.12.19"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run `pip install shibuya` and ensure you are using the correct theme name (all lowercase).","cause":"Shibuya is not installed or the package name is misspelled.","error":"html_theme = 'shibuya'\nTheme 'shibuya' not found"},{"fix":"Install shibuya via pip in your Sphinx environment: `pip install shibuya`.","cause":"Sphinx cannot find the theme; it may not be installed in the same environment.","error":"sphinx.errors.ThemeError: unknown theme 'shibuya'"},{"fix":"Ensure all theme options are defined with proper string values, or remove the option to use defaults.","cause":"Missing required configuration, e.g., 'logo' or 'accent_color' options set to None.","error":"TypeError: 'NoneType' object is not subscriptable in shibuya theme"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}