sphinx-doc/sphinx

Support dark mode for builtin themes

Open

#13,742 创建于 2025年7月23日

在 GitHub 查看
 (5 评论) (2 反应) (0 负责人)Python (5,625 star) (1,985 fork)batch import
good first issuehelp wantedhtml themetype:proposal

描述

It doesn't look like any/most of the provided themes support dark mode. That's a real bummer since many similar generator themes like the default MkDocs theme does support dark mode.

贡献者指南

技术栈
pythoncsshtml
领域
frontenddocumentation
议题类型
feature
难度面向新贡献者的预计实现难度，1 表示很小改动，5 表示专家级工作。
3
预计时间有经验贡献者完成调查、实现、测试并准备 pull request 的粗略时间范围。
1-2 days
活动状态议题当前的可参与程度：新鲜、活跃、陈旧、阻塞或等待维护者输入。
fresh
清晰度议题是否清楚说明期望改动、验收标准和下一步。
mostly clear
前置要求
CSS knowledgeSphinx theming basics
新手友好度1-100 的估计分数，表示该议题对首次贡献者的友好程度。
70
研究方向
Implement dark mode for built in Sphinx themes by adding CSS custom properties or media queries. Look at existing themes in sphinx/themes/ for structure, and consider user configuration via conf.py. Check if MkDocs approach can be adapted. No linked PRs or comments specifying exact approach.