{"id":26860,"library":"crate-docs-theme","title":"CrateDB Documentation Theme","description":"A Sphinx documentation theme for CrateDB documentation projects. Version 0.50.3, released monthly with minor improvements and dependency updates. Supports Sphinx 9.x and Python >=3.9.","status":"active","version":"0.50.3","language":"python","source_language":"en","source_url":"https://github.com/crate/crate-docs-theme","tags":["sphinx","documentation","theme","cratedb"],"install":[{"cmd":"pip install crate-docs-theme","lang":"bash","label":"pip"}],"dependencies":[{"reason":"Required theme","package":"sphinx","optional":false},{"reason":"Base theme dependency","package":"sphinx-book-theme","optional":false}],"imports":[{"note":"Use underscore, not hyphen.","wrong":"html_theme = 'crate-docs-theme'","symbol":"html_theme","correct":"html_theme = 'crate_docs_theme'"}],"quickstart":{"code":"# conf.py\nimport os\n\n# Set the documentation theme\nhtml_theme = 'crate_docs_theme'\n\n# Optional: set project-specific config if needed\nhtml_theme_options = {\n    'repository_url': os.environ.get('REPO_URL', 'https://github.com/crate/crate'),\n    'use_repository_button': True,\n}\n","lang":"python","description":"Basic Sphinx config to use crate-docs-theme."},"warnings":[{"fix":"Update to 0.46.0 or later for re-added TOC navigation with state persistence.","message":"The theme's TOC navigation behavior changed significantly between 0.44.0 and 0.46.0. If you rely on expand/collapse state persistence or custom TOC templates, review the changelog.","severity":"breaking","affected_versions":"0.44.0 - 0.46.0"},{"fix":"In conf.py, use: html_theme = 'crate_docs_theme'","message":"The 'crate_docs_theme' import path is the only correct one. Older versions may have used a different name; always use underscore.","severity":"deprecated","affected_versions":"all"},{"fix":"Avoid overriding theme CSS unless you carefully inspect the stack.","message":"The theme is built on top of sphinx-book-theme, which itself depends on pydata-sphinx-theme. Conflicts can arise if you mix custom CSS from other themes.","severity":"gotcha","affected_versions":"all"},{"fix":"Use the simplified stepper syntax introduced in 0.48.0.","message":"When using the 'stepper' directive, the syntax changed in 0.48.0. Older documentation may reference the previous, more verbose syntax.","severity":"gotcha","affected_versions":"<0.48.0"}],"env_vars":null,"search_vec":"'0.50.3':13 '3.9':28 '9':24 'cratedb':1,9,32 'depend':20 'document':2,6,10,30 'improv':18 'minor':17 'month':15 'project':11 'python':27 'releas':14 'sphinx':5,23,29 'support':22 'theme':3,7,31 'updat':21 'version':12 'x':25","created_at":"2026-05-01T17:43:15.403421+00:00","updated_at":"2026-05-01T17:43:15.403421+00:00","problems":{"verify_error":"no import statement found"},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/crate/crate-docs-theme","docs":null,"changelog":null,"pypi":"https://pypi.org/project/crate-docs-theme/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["web-framework"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"skip","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-06","install_tag":null}}