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.
Support dark mode for builtin themes · sphinx-doc/sphinx#13742 | Good First Issue