Chủ đề

Chủ đề thay đổi giao diện của MDM và giữ mọi thứ ở nguyên vị trí: các cửa sổ, menu và nút vẫn ở cùng một chỗ, nhưng được vẽ bằng màu sắc, hình dạng và biểu tượng khác. Mỗi chủ đề có một phiên bản sáng và tối.

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).

Các chủ đề tích hợp sẵn bao gồm Cổ điển (giao diện riêng của MDM, mặc định), Theo hệ thống (màu nhấn và độ tương phản của hệ thống), Độ tương phản cao, và các chủ đề kiểu Metro, Adwaita, Breeze, Luna, Aero và Aqua, mỗi chủ đề có hình dạng điều khiển và biểu tượng riêng, và trên Windows là thanh tiêu đề riêng. Bắt đầu mô tả từng chủ đề; trang Chủ đề của trang web hiển thị tất cả, cả phiên bản sáng và tối.

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

Các tệp chủ đề bạn tạo hoặc tải xuống sẽ được lưu trong thư mục chủ đề của MDM. Xem → Chủ đề → Mở thư mục chủ đề sẽ mở thư mục này (và tạo nó nếu chưa có). Thư mục này nằm trong thư mục dữ liệu của MDM:

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.

Xem → Chủ đề → Thêm tệp chủ đề… sẽ giúp bạn: chọn một tệp bất kỳ, MDM sẽ sao chép tệp đó vào thư mục chủ đề và áp dụng ngay lập tức. Tệp không phải chủ đề sẽ không được thêm vào và MDM sẽ cho biết lý do.

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).

Bản thân pywal: sau khi wal đã chạy, Xem → Chủ đề sẽ liệt kê pywal, được đọc trực tiếp từ nơi pywal ghi màu của nó: ~/.cache/wal/colors.json (trên Windows %USERPROFILE%\.cache\wal\colors.json, nơi winwal và pywal ghi; $PYWAL_CACHE_DIR hoặc $XDG_CACHE_HOME/wal khi bạn đặt chúng). Chọn nó và MDM sẽ theo hình nền của bạn: mỗi khi wal ghi màu mới, MDM sẽ nhận chúng trong vòng hai giây. Nó chỉ xem xét ngày và kích thước của tệp, cứ hai giây một lần, và chỉ khi pywal là chủ đề. Một bản sao được thêm bằng Thêm tệp chủ đề… sẽ giữ nguyên màu sắc mà nó đã có.

Một bảng màu chỉ thay đổi màu sắc, trên giao diện cổ điển: mọi cửa sổ, nút và menu vẫn ở vị trí cũ. Một bảng màu tối làm cho MDM tối và một bảng màu sáng làm cho MDM sáng, bất kể Xem → Luôn tối nói gì. Màu sắc của bảng màu sẽ được áp dụng vào những nơi có ý nghĩa tương tự:

Viền và các sắc thái khi di chuột và nhấn được pha trộn từ những màu này, giống như [seeds] của tệp chủ đề. Văn bản vẫn dễ đọc: văn bản và văn bản phụ có tỷ lệ tương phản 4.5:1 trở lên so với mọi nền mà chúng nằm trên (WCAG AA), màu nhấn là 3:1. Một bảng màu không đạt được điều đó sẽ có những màu đó được di chuyển một chút tối hơn (sáng hơn trên bảng màu tối) cho đến khi chúng đạt yêu cầu; nhật ký của MDM sẽ cho biết màu nào.

Để 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] — một vài màu sắc (background, surface, header, text, accent, selection, error, warning, success) mà MDM trải rộng trên mọi điều khiển. [seeds.light] và [seeds.dark] cung cấp cho mỗi phiên bản màu sắc riêng.
• [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.

Mọi vai trò màu, kích thước và kiểu điều khiển, cùng với những gì nó đặt, được liệt kê trên trang Chủ đề của trang web (được đọc từ mã của MDM, vì vậy nó không bao giờ bị lệch). Các chủ đề tích hợp sẵn được viết theo cùng một cách: đọc chúng trên GitHub.

Một khóa mà MDM không biết, hoặc một giá trị mà nó không thể đọc, sẽ bị bỏ qua và ghi vào nhật ký của MDM (thư mục logs bên cạnh thư mục chủ đề), để một tệp được tạo cho MDM mới hơn vẫn tải. Một tệp không phải là TOML hoặc JSON hợp lệ sẽ không tải, và nhật ký sẽ cho biết lý do. Một tệp có tên giống như một chủ đề tích hợp sẵn (metro.toml) sẽ bị bỏ qua: hãy đặt cho tệp của bạn một tên riêng.

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ó;
• một SOURCES.txt bên cạnh bất kỳ biểu tượng nào, ghi rõ ai đã vẽ chúng và theo giấy phép nào. Các biểu tượng phải là của riêng bạn hoặc theo giấy phép cho phép MDM chia sẻ chúng (GPL-3.0), không bao giờ được sao chép từ chương trình khác.

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 →