aedanbricker/sphinx_rtd_dark_mode

🌙 Thêm chế độ tối cho chủ đề Read the Docs

Một tiện ích mở rộng Sphinx nhỏ gọn, cho phép người dùng chuyển qua lại giữa giao diện sáng và tối chỉ bằng một cái nhấp chuột.

Đây là một tiện ích mở rộng Sphinx (Sphinx extension) bổ sung tính năng chế độ tối (dark mode) cho chủ đề Read the Docs (RTD theme). Khi được kích hoạt, một biểu tượng nhỏ sẽ xuất hiện ở góc dưới bên phải màn hình, cho phép người dùng dễ dàng chuyển đổi giữa giao diện sáng và tối. Lý tưởng cho các trang tài liệu dài, giúp giảm mỏi mắt khi đọc trong môi trường ánh sáng thấp.

✨ Điểm nổi bật

• Cài đặt đơn giản: Cài đặt qua pip và thêm vào danh sách extensions trong conf.py.
• Tự động áp dụng chủ đề RTD: Nếu chưa sử dụng chủ đề Read the Docs, tiện ích sẽ tự động thiết lập.
• Lưu tùy chọn người dùng: Tùy chọn chế độ tối hoặc sáng được lưu trong bộ nhớ cục bộ trình duyệt.
• Hỗ trợ Python 3.4+: Tương thích với các phiên bản Python hiện đại.
• Cấu hình mặc định: Cho phép chọn chế độ mặc định khi người dùng truy cập lần đầu.
• Hỗ trợ bản quyền MIT: Tự do sử dụng và điều chỉnh theo nhu cầu.

💡 Vì sao đáng chú ý

Không cần phức tạp chỉnh sửa CSS hay JavaScript — tiện ích này tích hợp nhanh chỉ với một vài dòng cấu hình. Phù hợp cho các dự án tài liệu dựa trên Sphinx sử dụng chủ đề Read the Docs, nơi mà trải nghiệm người dùng và khả năng tùy biến giao diện là yếu tố quan trọng. Đặc biệt hữu ích trong môi trường phát triển hay học tập dài ngày.

---

#Sphinx #DarkMode #Documentation #OpenSource #Python #TiniX