{"id":24632,"library":"sphinx-press-theme","title":"Sphinx Press Theme","description":"A Sphinx-doc theme based on Vuepress. Version 0.9.1 provides a clean, modern theme for Sphinx documentation with a sidebar navigation similar to Vuepress. The library is in maintenance mode with infrequent releases.","status":"active","version":"0.9.1","language":"python","source_language":"en","source_url":"https://github.com/schettino72/sphinx_press_theme","tags":["sphinx","theme","vuepress","documentation"],"install":[{"cmd":"pip install sphinx-press-theme","lang":"bash","label":"Latest release"}],"dependencies":[{"reason":"Required; the theme is a Sphinx extension","package":"sphinx","optional":false}],"imports":[{"note":"The theme is not imported directly; it is configured in conf.py as 'sphinx_press_theme' via html_theme","wrong":"press","symbol":"press","correct":"import sphinx_press_theme"},{"note":"In Sphinx conf.py, set html_theme = 'sphinx_press_theme' (underscores, not hyphens)","wrong":"html_theme = 'press' or 'sphinx-press-theme'","symbol":"sphinx_press_theme","correct":"html_theme = 'sphinx_press_theme'"}],"quickstart":{"code":"# conf.py\nimport sphinx_press_theme\n\nhtml_theme = 'sphinx_press_theme'\nhtml_theme_options = {\n    'repository_url': 'https://github.com/your/repo',\n    'repository_branch': 'main',\n    'home_page_title': 'My Docs',\n    'show_prev_next': False\n}","lang":"python","description":"Minimal setup: add the import and theme options to your Sphinx conf.py."},"warnings":[{"fix":"Consider using the official Furo or PyData Sphinx Theme as a modern replacement.","message":"The repository is in maintenance mode with no active development; future Sphinx versions may break compatibility.","severity":"deprecated","affected_versions":">=0.9.1"},{"fix":"Pin Sphinx to <7.0 or test with your Sphinx version.","message":"The theme does not support Sphinx 7.x fully; some features like 'canonical_url' may not work.","severity":"gotcha","affected_versions":"0.9.1"},{"fix":"Set html_theme = 'sphinx_press_theme' instead of 'press'.","message":"In version 0.8.0, the theme name changed from 'press' to 'sphinx_press_theme'. Old configs break.","severity":"breaking","affected_versions":">=0.8.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run 'pip install sphinx-press-theme' and ensure html_theme = 'sphinx_press_theme' (underscores).","cause":"The theme package is not installed or the name is misspelled in conf.py.","error":"WARNING: html_theme 'sphinx_press_theme' not found"},{"fix":"Remove the import statement; Sphinx will load the theme automatically if html_theme is set correctly.","cause":"The import is incorrect when using autodoc or similar; no need to import in conf.py for theme only.","error":"ModuleNotFoundError: No module named 'sphinx_press_theme'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}