ชุดรูปแบบ

ชุดรูปแบบจะเปลี่ยนรูปลักษณ์ของ MDM โดยที่หน้าต่าง เมนู และปุ่มต่าง ๆ ยังคงอยู่ที่เดิม แต่จะแสดงผลด้วยสี รูปร่าง และไอคอนที่แตกต่างกัน ชุดรูปแบบแต่ละชุดมีทั้งแบบสว่างและแบบมืด

เลือกชุดรูปแบบ

เปิด มุมมอง → ชุดรูปแบบ แล้วคลิกชุดรูปแบบที่ต้องการ หน้าต่างทั้งหมดจะเปลี่ยนทันทีโดยไม่ต้องรีสตาร์ท จากนั้นใช้ มุมมอง → รองรับโหมดมืด และ มุมมอง → มืดตลอดเวลา เพื่อเลือกโหมดสว่างหรือมืด เช่นเดียวกับรูปลักษณ์แบบคลาสสิก (โหมดมืด)

ชุดรูปแบบในตัวประกอบด้วย คลาสสิก (รูปลักษณ์เฉพาะของ MDM ซึ่งเป็นค่าเริ่มต้น), ตามระบบ (ใช้สีเน้นและคอนทราสต์ของระบบ), ความคมชัดสูง และชุดรูปแบบสไตล์ เมโทร, Adwaita, Breeze, Luna, Aero และ Aqua ซึ่งแต่ละชุดมีรูปร่างการควบคุมและไอคอนเฉพาะตัว และบน Windows จะมีแถบชื่อเรื่องเป็นของตัวเอง เริ่มต้นใช้งาน อธิบายแต่ละชุด; หน้าชุดรูปแบบ ของเว็บไซต์แสดงทั้งหมด ทั้งแบบสว่างและมืด

ตำแหน่งไฟล์ชุดรูปแบบ

ไฟล์ชุดรูปแบบที่คุณสร้างหรือดาวน์โหลดจะอยู่ในโฟลเดอร์ชุดรูปแบบของ MDM การเลือก มุมมอง → ชุดรูปแบบ → เปิดโฟลเดอร์ชุดรูปแบบ จะเปิดโฟลเดอร์นี้ (และสร้างขึ้นหากยังไม่มี) โฟลเดอร์นี้อยู่ในโฟลเดอร์ข้อมูลของ MDM:

ภายในสองวินาที ไฟล์ใหม่จะปรากฏใน มุมมอง → ชุดรูปแบบ ใต้ชุดรูปแบบในตัว โดยมี name ที่กำหนดเอง หลังจากแก้ไขไฟล์ ให้เลือกอีกครั้งใน มุมมอง → ชุดรูปแบบ เพื่อดูการเปลี่ยนแปลง

ชุดรูปแบบสามารถเป็นไฟล์เดียว (harbour.toml) หรือเป็นโฟลเดอร์ของตัวเอง (harbour/theme.toml) เมื่อมีไอคอน

มุมมอง → ชุดรูปแบบ → เพิ่มไฟล์ธีม… จะจัดการให้คุณ: เลือกไฟล์ใดก็ได้ แล้ว MDM จะคัดลอกไฟล์นั้นไปยังโฟลเดอร์ชุดรูปแบบและใช้งานทันที ไฟล์ที่ไม่ใช่ชุดรูปแบบจะไม่ถูกเพิ่ม และ MDM จะแจ้งเหตุผล

ชุดสี Base16 และ pywal

ชุดสีที่สร้างขึ้นสำหรับโปรแกรมอื่นก็เป็นชุดรูปแบบได้เช่นกัน โดยไม่ต้องแปลงอะไรเลย:

• ชุดรูปแบบ Base16 ซึ่งเป็นไฟล์ .yaml ที่มาพร้อมกับ ชุดรูปแบบ Base16 และ Base24: ทั้งแบบคลาสสิก (scheme: และ base00 ถึง base0F ที่ด้านบน) และแบบใหม่กว่า (name: และบล็อก palette:) ชุดรูปแบบ Base24 จะอ่านเป็น 16 สีแรก
• ไฟล์ colors.json ของ pywal หรือไฟล์ของโปรแกรมใด ๆ ที่มีรูปแบบเหมือน pywal (เทมเพลต pywal ของ wallust)

เพิ่มด้วย มุมมอง → ชุดรูปแบบ → เพิ่มไฟล์ธีม… หรือใส่ในโฟลเดอร์ชุดรูปแบบด้วยตัวเอง จะแสดงใน มุมมอง → ชุดรูปแบบ ภายใต้ชื่อชุดรูปแบบ (name: หรือ scheme:; ของ pywal จะตั้งชื่อตามวอลเปเปอร์)

pywal เอง: เมื่อ wal ทำงานแล้ว มุมมอง → ชุดรูปแบบ จะแสดง pywal ซึ่งอ่านโดยตรงจากที่ pywal เขียนสีไว้: ~/.cache/wal/colors.json (บน Windows %USERPROFILE%\.cache\wal\colors.json ซึ่ง winwal และ pywal เขียนไว้; $PYWAL_CACHE_DIR หรือ $XDG_CACHE_HOME/wal เมื่อคุณตั้งค่า) เลือกแล้ว MDM จะตามวอลเปเปอร์ของคุณ: ทุกครั้งที่ wal เขียนสีใหม่ MDM จะนำไปใช้ภายในสองวินาที โดยจะดูเฉพาะวันที่และขนาดของไฟล์ทุกสองวินาที และเฉพาะเมื่อ pywal เป็นชุดรูปแบบเท่านั้น สำเนาที่เพิ่มด้วย เพิ่มไฟล์ธีม… จะเก็บสีเดิมไว้

ชุดรูปแบบจะเปลี่ยนเฉพาะสีในรูปลักษณ์คลาสสิกเท่านั้น: ทุกหน้าต่าง ปุ่ม และเมนูจะยังคงอยู่ที่เดิม ชุดรูปแบบสีเข้มจะทำให้ MDM เป็นสีเข้ม และชุดรูปแบบสีอ่อนจะทำให้เป็นสีอ่อน ไม่ว่า มุมมอง → มืดตลอดเวลา จะตั้งค่าไว้อย่างไร สีของชุดรูปแบบจะไปอยู่ในตำแหน่งที่ความหมายเดียวกัน:

ขอบและเฉดสีเมื่อวางเมาส์เหนือและกดจะผสมจากสีเหล่านี้ เช่นเดียวกับ [seeds] ของไฟล์ธีม ข้อความยังคงอ่านง่าย: ข้อความและข้อความรองมีอัตราส่วน 4.5:1 หรือมากกว่าเมื่อเทียบกับพื้นหลังทั้งหมดที่อยู่บนนั้น (WCAG AA) ส่วนเน้นมีอัตราส่วน 3:1 หากชุดรูปแบบไม่ถึงเกณฑ์ สีเหล่านั้นจะถูกปรับให้เข้มขึ้นเล็กน้อย (สว่างขึ้นในชุดรูปแบบสีเข้ม) จนกว่าจะผ่าน บันทึกของ MDM จะระบุว่าสีใด

หากต้องการเปลี่ยนมากกว่าสี ให้สร้างไฟล์ธีมที่สืบทอดชุดรูปแบบตามชื่อไฟล์และเพิ่มสิ่งที่คุณต้องการ:

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

[sizes]
radius = 6

inherits = "pywal"ทำงานในลักษณะเดียวกัน และตาม wal ด้วย

ไฟล์

ชุดรูปแบบคือไฟล์ข้อความขนาดเล็กหนึ่งไฟล์ในรูปแบบ TOML (หรือ JSON, .json; หรือ ชุดสี, .yaml) โดยจะระบุเฉพาะสิ่งที่เปลี่ยนแปลงเท่านั้น ส่วนที่เหลือทั้งหมดมาจากชุดรูปแบบที่ 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 — สิ่งที่ มุมมอง → ชุดรูปแบบ แสดงรายการ; ชื่อไฟล์เมื่อไม่มี
• inherits — ชุดรูปแบบที่ชุดรูปแบบของคุณเริ่มต้นจาก: classic (ค่าเริ่มต้นเมื่อเว้นว่าง), ID ของชุดรูปแบบในตัว (metro, adwaita, breeze, luna, aero, aqua, high-contrast) หรือไฟล์ชุดรูปแบบอื่นในโฟลเดอร์เดียวกัน โดยใช้ชื่อไฟล์ที่ไม่มี .toml ไฟล์ที่สืบทอดจากไฟล์อื่นสามารถถูกสืบทอดต่อได้; ชุดรูปแบบไม่สามารถสืบทอดจากตัวเองได้
• [seeds] — สีหลักจำนวนหนึ่ง (background, surface, header, text, accent, selection, error, warning, success) ที่ MDM ใช้กับส่วนควบคุมทั้งหมด [seeds.light] และ [seeds.dark] กำหนดสีเฉพาะสำหรับแต่ละด้าน
• [colors] — บทบาทสีเดียว (เช่น window, accent หรือ "segments.done") ทั้งสองด้าน; [light] และ [dark] เฉพาะด้านเดียว สีคือ #rrggbb หรือ #rrggbbaa ที่มีค่าความโปร่งใส บทบาทที่ไฟล์กำหนดจะมีผลเหนือสีหลัก
• [sizes] — รัศมีมุม, ความกว้างขอบ, ขนาดตัวอักษร และความสูงแถว ในหน่วยพิกเซล
• [controls] — รูปร่างของกล่องข้อความ, กล่องกาเครื่องหมาย, ปุ่ม, แถบความคืบหน้า, แถบเลื่อน, เครื่องหมายโฟกัส และแถบชื่อเรื่อง
• icons — color, mono (สีเดียว) หรือ accent
• contrast = "high" — เพิ่มความเข้มของขอบและสีข้อความทั้งหมดเหนือส่วนที่เหลือ

บทบาทสี, ขนาด และสไตล์การควบคุมทั้งหมด พร้อมสิ่งที่กำหนดไว้ มีอยู่ใน หน้าชุดรูปแบบ ของเว็บไซต์ (อ่านจากโค้ดของ MDM เอง จึงไม่คลาดเคลื่อน) ชุดรูปแบบในตัวก็เขียนในลักษณะเดียวกัน: อ่านได้บน GitHub

คีย์ที่ MDM ไม่รู้จัก หรือค่าที่อ่านไม่ได้ จะถูกข้ามและเขียนลงในบันทึกของ MDM (โฟลเดอร์ logs ที่อยู่ข้างโฟลเดอร์ชุดรูปแบบ) เพื่อให้ไฟล์ที่สร้างขึ้นสำหรับ MDM เวอร์ชันใหม่กว่ายังคงโหลดได้ ไฟล์ที่ไม่ใช่ TOML หรือ JSON ที่ถูกต้องจะไม่โหลด และบันทึกจะระบุเหตุผล ไฟล์ที่มีชื่อเหมือนชุดรูปแบบในตัว (metro.toml) จะถูกข้าม: โปรดตั้งชื่อไฟล์ของคุณเอง

ไอคอน

ชุดรูปแบบในโฟลเดอร์ของตัวเอง (harbour/theme.toml) สามารถนำไอคอนมาใน icons/16 และ icons/24 (และสำหรับรูปภาพ PNG, icons/32 และ icons/48 ซึ่งใช้บนหน้าจอที่ปรับขนาด 150% ขึ้นไป) โดยแต่ละไอคอนตั้งชื่อตามสิ่งที่แสดง (tb-add-url.svg, cat-music.png…) ไฟล์ SVG และ PNG จะคงสีเดิมไว้; ไฟล์ -symbolic.svg และ -symbolic.png ซึ่งเป็นชื่อที่ GNOME และ KDE ใช้ จะใช้สีข้อความของชุดรูปแบบ ไอคอนที่ชุดขาดไปจะถูกวาดเหมือนรูปลักษณ์คลาสสิก รายชื่อชื่อทั้งหมดอยู่ใน themeicons.rs (NEEDS)

สร้างชุดรูปแบบ

1. มุมมอง → ชุดรูปแบบ → เปิดโฟลเดอร์ชุดรูปแบบ แล้วสร้างไฟล์ .toml ใหม่ที่นั่น (ใช้โปรแกรมแก้ไขข้อความใดก็ได้)
2. เริ่มต้นจากตัวอย่างด้านบน: เปลี่ยนสีหลัก จากนั้นเพิ่มบทบาทและขนาดตามต้องการ
3. เลือกใน มุมมอง → ชุดรูปแบบ และดูทั้งสองด้าน: มุมมอง → มืดตลอดเวลา เปิดและปิด ตรวจสอบว่าข้อความอ่านง่ายและเครื่องหมายโฟกัสปรากฏให้เห็นทั้งสองด้าน

หน้าชุดรูปแบบ ของเว็บไซต์มีข้อความแจ้งที่คุณสามารถให้ผู้ช่วย AI พร้อมรูปแบบ คีย์ทั้งหมด และกฎ เพื่อเขียนชุดรูปแบบให้คุณจากคำอธิบาย

แบ่งปัน

สร้างสิ่งที่คนอื่นน่าจะชอบ? เปิด pull request ที่เพิ่มลงใน crates/app/assets/themes พร้อม:

• ไฟล์ .toml และโฟลเดอร์ไอคอนหากมี;
• ภาพหน้าจอของหน้าต่างหลักในด้านสว่างและด้านมืด;
• มี SOURCES.txt อยู่ข้างไอคอนทุกอัน ระบุว่าใครเป็นผู้วาดและภายใต้ใบอนุญาตใด ไอคอนต้องเป็นของคุณเองหรืออยู่ภายใต้ใบอนุญาตที่อนุญาตให้ MDM แชร์ได้ (GPL-3.0) ห้ามคัดลอกมาจากโปรแกรมอื่น

ยังไม่แน่ใจใช่ไหม? พูดคุย กันก่อน CONTRIBUTING.md อธิบายวิธีการทำงานของพูลรีเควสต์ที่นี่

ขั้นตอนถัดไป

• เริ่มต้นใช้งาน →
• ตัวเลือก →