Chủ đề

A theme changes how GDM looks and keeps everything where it was: the same windows, menus and buttons in the same places, drawn in other colours, shapes and icons. Each theme has a light and a dark side.

Chọn một chủ đề

Mở Xem → Chủ đề và nhấp vào một chủ đề: toàn bộ cửa sổ sẽ thay đổi ngay lập tức, không cần khởi động lại. Xem → Hỗ trợ Chế độ tối và Xem → Luôn tối sau đó chọn phiên bản sáng hoặc tối của chủ đề, tương tự như giao diện cổ điển (Chế độ tối).

The built-in themes are Classic (GDM's own look, the default), Native (your system's accent colour and contrast), High contrast, and the style themes Metro, Adwaita, Breeze, Luna, Aero and Aqua, each with its own control shapes and icons, and on Windows its own title bar. Getting started describes each one; the website's Themes page shows them all, light and dark.

Nơi lưu trữ tệp chủ đề

Theme files you make or download go in GDM's themes folder. View → Theme → Open themes folder opens it (and makes it the first time). It is in GDM's data folder:

Trong vòng hai giây, một tệp mới sẽ hiển thị trong Xem → Chủ đề, bên dưới các chủ đề tích hợp sẵn, với name mà nó tự đặt. Sau khi bạn chỉnh sửa một tệp, hãy chọn lại tệp đó trong Xem → Chủ đề để xem thay đổi.

Một chủ đề có thể là một tệp (harbour.toml) hoặc một thư mục riêng (harbour/theme.toml) khi nó chứa các biểu tượng.

View → Theme → Add a theme file… does it for you: pick a file anywhere, and GDM copies it into the themes folder and uses it at once. A file that isn't a theme stays out, and GDM says why.

Bảng màu Base16 và pywal

Các bảng màu được tạo cho các chương trình khác cũng là chủ đề, không cần chuyển đổi:

• Bảng màu Base16, tệp .yaml mà các bảng màu Base16 và Base24 sử dụng: cả bố cục cổ điển (scheme: và base00 đến base0F ở trên cùng) và bố cục mới hơn (name: và khối palette:). Bảng màu Base24 được đọc là 16 màu đầu tiên của nó.
• Tệp colors.json của pywal, hoặc tệp của bất kỳ chương trình nào có định dạng của pywal (mẫu pywal của wallust).

Thêm nó bằng Xem → Chủ đề → Thêm tệp chủ đề…, hoặc tự đặt vào thư mục chủ đề. Nó sẽ hiển thị trong Xem → Chủ đề dưới tên của bảng màu (name: hoặc scheme:; của pywal được đặt tên theo hình nền).

pywal itself: once wal has run, View → Theme lists pywal, read straight from where pywal writes its colours: ~/.cache/wal/colors.json (on Windows %USERPROFILE%\.cache\wal\colors.json, where winwal and pywal write it; $PYWAL_CACHE_DIR or $XDG_CACHE_HOME/wal when you set them). Pick it and GDM follows your wallpaper: each time wal writes new colours, GDM takes them within two seconds. It looks only at the file's date and size, every two seconds, and only while pywal is the theme. A copy added with Add a theme file… keeps the colours it had.

A scheme changes colours only, on the classic look: every window, button and menu stays where it was. A dark scheme makes GDM dark and a light one light, whatever View → Always dark says. The scheme's colours go where they mean the same:

Borders and the hover and pressed shades are mixed from these, as for a theme file's [seeds]. Text stays readable: text and secondary text at 4.5:1 or more against every background they sit on (WCAG AA), the accent at 3:1. A scheme short of that has those colours moved a little darker (lighter on a dark scheme) until they pass; GDM's log says which.

Để thay đổi nhiều hơn màu sắc, hãy tạo một tệp chủ đề kế thừa bảng màu theo tên tệp của nó và thêm những gì bạn muốn:

name = "Gruvbox, my way"
inherits = "gruvbox-dark-medium"   # gruvbox-dark-medium.yaml, beside it
icons = "accent"

[sizes]
radius = 6

inherits = "pywal"hoạt động tương tự và cũng theo wal.

Tệp

Một chủ đề là một tệp văn bản nhỏ ở định dạng TOML (hoặc JSON, .json; hoặc bảng màu, .yaml). Nó chỉ đặt tên những gì nó thay đổi; mọi thứ khác đến từ chủ đề mà nó inherits:

name = "Harbour"
inherits = "classic"
icons = "color"

[seeds.light]
background = "#eef3f6"
surface = "#ffffff"
text = "#11202b"
accent = "#0f6c8c"

[seeds.dark]
background = "#14212a"
surface = "#0e171d"
text = "#e8f0f4"
accent = "#5cc3e6"

[sizes]
radius = 6

[controls]
focus = "ring"

• name — tên hiển thị trong Xem → Chủ đề; tên tệp nếu không có.
• inherits — chủ đề mà chủ đề của bạn bắt đầu từ: classic (mặc định nếu bỏ trống), ID của một chủ đề tích hợp sẵn (metro, adwaita, breeze, luna, aero, aqua, high-contrast), hoặc một tệp chủ đề khác trong cùng thư mục, theo tên tệp của nó không có .toml. Một tệp kế thừa một tệp khác có thể được kế thừa lại; một chủ đề không thể kế thừa chính nó.
• [seeds] — a handful of colours (background, surface, header, text, accent, selection, error, warning, success) that GDM spreads over every control. [seeds.light] and [seeds.dark] give each side its own.
• [colors] — các vai trò màu đơn (như window, accent hoặc "segments.done") ở cả hai phiên bản; [light] và [dark] chỉ ở một phiên bản. Một màu là #rrggbb, hoặc #rrggbbaa có độ trong suốt. Các vai trò màu mà một tệp đặt sẽ thắng các màu gốc của nó.
• [sizes] — bán kính góc, độ rộng đường viền, cỡ chữ và chiều cao hàng, tính bằng pixel.
• [controls] — hình dạng của hộp văn bản, hộp kiểm, nút, thanh tiến trình, thanh cuộn, dấu tiêu điểm và thanh tiêu đề.
• icons — color, mono (một màu) hoặc accent.
• contrast = "high" — tăng cường mọi cạnh và màu văn bản trên phần còn lại.

Every colour role, size and control style, with what it sets, is listed on the website's Themes page (read from GDM's own code, so it never drifts). The built-in themes are written the same way: read them on GitHub.

A key GDM doesn't know, or a value it can't read, is skipped and written to GDM's log (the logs folder beside the themes folder), so a file made for a newer GDM still loads. A file that isn't valid TOML or JSON doesn't load, and the log says why. A file named like a built-in theme (metro.toml) is passed over: give yours a name of its own.

Biểu tượng

Một chủ đề trong thư mục riêng của nó (harbour/theme.toml) có thể mang các biểu tượng của nó trong icons/16 và icons/24 (và, đối với hình ảnh PNG, icons/32 và icons/48, được sử dụng trên màn hình có tỷ lệ 150% trở lên), mỗi biểu tượng được đặt tên theo những gì nó hiển thị (tb-add-url.svg, cat-music.png…). Các tệp SVG và PNG giữ nguyên màu sắc của chúng; các tệp -symbolic.svg và -symbolic.png, như GNOME và KDE đặt tên, sẽ lấy màu văn bản của chủ đề. Một biểu tượng mà bộ thiếu sẽ được vẽ như giao diện cổ điển vẽ nó. Danh sách đầy đủ các tên có trong themeicons.rs (NEEDS).

Tạo một chủ đề

1. Xem → Chủ đề → Mở thư mục chủ đề, và tạo một tệp .toml mới ở đó (bằng bất kỳ trình soạn thảo văn bản nào).
2. Bắt đầu từ ví dụ trên: thay đổi màu sắc gốc, sau đó thêm các vai trò và kích thước khi bạn thực hiện.
3. Chọn nó trong Xem → Chủ đề, và xem cả hai phiên bản: Xem → Luôn tối bật và tắt. Kiểm tra xem văn bản có dễ đọc và dấu tiêu điểm có hiển thị rõ ràng ở cả hai phiên bản không.

Trang Chủ đề của trang web có một lời nhắc mà bạn có thể cung cấp cho trợ lý AI, với định dạng, mọi khóa và các quy tắc, để viết một chủ đề cho bạn từ một mô tả.

Chia sẻ

Đã tạo một thứ mà người khác sẽ thích? Mở một yêu cầu kéo để thêm nó vào crates/app/assets/themes, với:

• tệp .toml, và thư mục biểu tượng của nó nếu có;
• ảnh chụp màn hình cửa sổ chính ở mặt sáng và mặt tối của nó;
• a SOURCES.txt beside any icons, saying who drew them and under which licence. Icons must be your own or under a licence that lets GDM share them (GPL-3.0), never copied from another program.

Chưa chắc chắn? Hãy hiển thị nó trong các cuộc thảo luận trước. CONTRIBUTING.md giải thích cách hoạt động của các yêu cầu kéo tại đây.

Các bước tiếp theo

• Bắt đầu →
• Tùy chọn →