پرش به محتوا
Chapters
  1. به Omarchy خوش آمدید!
  2. شروع به کار
  3. آمدن از Mac یا Windows
  4. ناوبری
  5. نوار بالایی
  6. تم‌ها
  7. کلیدهای میانبر
  8. کلیپ‌بورد یکپارچه و تاریخچه
  9. یادآورها
  10. اعلان‌ها
  11. استخراج متن و دیکته
  12. اسکرین‌شات‌ها و ضبط
  13. تغییر وضعیت‌ها، بیکاری و محافظ صفحه
  14. Omarchy CLI
  15. ترمینال
  16. Neovim
  17. هوش مصنوعی
  18. ابزارهای توسعه
  19. ابزارهای شل
  20. توابع شل
  21. TUIs
  22. رابط‌های گرافیکی
  23. مرورگرها
  24. برنامه‌ها/خدمات تجاری
  25. برنامه‌های وب
  26. بازی
  27. پر کردن PDFها
  28. ماشین مجازی Windows
  29. بسته‌های دیگر
  30. به‌روزرسانی‌ها
  31. دات‌فایل‌ها
  32. افزونه‌های شل
  33. نمایشگرها
  34. صفحه‌کلید، ماوس، ترک‌پد
  35. شبکه
  36. خواب سیستم
  37. احراز هویت سخت‌افزاری
  38. قلم‌ها
  39. پس‌زمینه‌ها
  40. اعلان
  41. برندینگ
  42. تغییرات رایج
  43. ساختن تم خودتان
  44. پشتیبانی از Mac
  45. عیب‌یابی
  46. پرسش‌های متداول
  47. اسنپ‌شات‌های سیستم
  48. امنیت
  49. Omarchy روی...
  50. نصب دوگانه
  51. نصب‌های بدون ناظر

راهنما

ساختن تم خودتان

می‌توانید تم‌های خودتان را به ~/.config/omarchy/themes اضافه کنید. کافی است یکی از تم‌های موجود را به‌عنوان پایه کپی کنید (در /usr/share/omarchy/themes نگاه کنید)، بعد هرقدر دلتان خواست دست‌کاری‌اش کنید. تا وقتی تم شما داخل آن پوشه باشد، در منوی انتخاب تم گنجانده خواهد شد.

فایل اصلی‌ای که باید دست‌کاری کنید colors.toml است. این فایل مجموعه‌ی رنگی را تعریف می‌کند که بعد برای تولید پیکربندی‌های ترمینال (Foot/Alacritty/Ghostty/Kitty)، btop، Chromium، Hyprland، Neovim، Helix، VSCode، Obsidian و کل پوسته‌ی Omarchy (نوار بالا، منو، اعلان‌ها، OSD و صفحه‌ی قفل) به کار می‌رود.

همچنین می‌توانید از برنامه‌ی Aether که همراه Omarchy آمده است برای ساختن یک تم جدید استفاده کنید؛ با یک رابط گرافیکی دوست‌داشتنی که با آن با رنگ‌ها بازی می‌کنید و دنبال پس‌زمینه می‌گردید. کافی است آن را از شبکه‌ی برنامه‌ها با Super + Alt + Space اجرا کنید.

یک تم نصب‌شده چه چیزهایی می‌تواند داشته باشد

تمی که خودتان در ~/.config/omarchy/themes می‌نویسید می‌تواند هر چیزی که دلتان می‌خواهد داشته باشد - این دستگاه شماست و این فایل شماست، و Omarchy همه‌ی آن را اعمال می‌کند.

تمی که از مخزن کس دیگری با omarchy theme install نصب می‌کنید هر چیزی را که رنگ است نگه می‌دارد، و آن مشت فایل‌هایی را که روی دستگاه شما کد اجرا می‌کنند از دست می‌دهد: هر فایل .lua، پیکربندی‌های ترمینال (alacritty.toml، foot.ini، ghostty.conf، kitty.conf) و vscode.json. hyprland.lua یک تم، Lua است که کامپوزیتور شما هنگام ورود اجرا می‌کند، یک پیکربندی ترمینال برنامه‌ای را نام می‌برد که ترمینال شما اجرا می‌کند، و vscode.json یک افزونه‌ی VSCode را برای نصب نام می‌برد. نصب تم یک نفر دیگر باید ظاهر دسکتاپ شما را عوض کند، هرگز چیزی را که اجرا می‌کند عوض نکند.

هر چیز دیگری دقیقاً همان‌طور که نویسنده‌ی تم نوشته است کار می‌کند - btop.theme، chromium.theme، helix.toml، icons.theme، shell.toml، پس‌زمینه‌ها و پیش‌نمایش‌ها همه نگه داشته می‌شوند. فقط چیزهایی که حذف شده‌اند روی دستگاه شما از colors.toml دوباره تولید می‌شوند.

Omarchy این دو را از روی این از هم تشخیص می‌دهد که آیا تم داخل خودش یک مخزن git دارد یا نه؛ همان چیزی که omarchy theme install وقتی کلون می‌کند از خودش به جا می‌گذارد. پس تمی که خودتان نوشته‌اید مال شما می‌ماند، و تمی که از اینترنت کشیده‌اید در حد رنگ‌ها می‌ماند.

حالت روشن

اگر دارید یک تم با حالت روشن می‌سازید، در بالای colors.toml خودتان mode = "light" را تنظیم کنید. آن‌وقت به‌طور خودکار برای همه‌ی برنامه‌ها با حالت روشن جفت می‌شود. (روش قدیمیِ انداختن یک فایل خالی به نام light.mode در ریشه‌ی تم شما هم هنوز کار می‌کند.)

رنگ‌های آیکون

اگر دوست دارید آیکون‌های مدیر فایل از نظر رنگ با تم شما جور دربیایند، فایلی به نام icons.theme اضافه کنید با نام مجموعه آیکونی که می‌خواهید استفاده کنید. به‌طور پیش‌فرض، گزینه‌ها این‌ها هستند: Yaru Yaru-blue Yaru-dark Yaru-magenta Yaru-olive Yaru-prussiangreen Yaru-purple Yaru-red Yaru-sage Yaru-wartybrown Yaru-yellow.

تصویر قفل‌گشایی

تم‌هایی که با تصاویر unlock.png و preview-unlock.png عرضه شوند زیر ظاهر > قفل‌گشایی فهرست خواهند شد. unlock.png شما ترجیحاً باید یک png شفاف باشد. و می‌توانید تصویر پیش‌نمایش را با استفاده از omarchy plymouth preview بسازید.

تم‌دادن به برنامه‌هایی که Omarchy پوشش نمی‌دهد

اگر از برنامه‌ای استفاده می‌کنید که در آن فهرست نیست، می‌توانید خودتان با یک قالب به Omarchy یاد بدهید که به آن تم بدهد. فایلی در ~/.config/omarchy/themed/ بیندازید که نامش نام پیکربندی‌ای باشد که تولید می‌کند به‌علاوه‌ی پسوند .tpl، و پیکربندی را با {{ background }}، {{ foreground }}، {{ accent }}، {{ red }}، {{ color0 }} تا {{ color15 }} و بقیه‌ی پالت به‌عنوان جای‌گزین بنویسید. هر بار که تم‌ها را عوض می‌کنید، فایل با رنگ‌های آن تم دوباره تولید می‌شود.

در آن پوشه یک alacritty.toml.tpl.sample با توضیحات کامل هست که از روی آن کپی کنید - همه‌ی متغیرهایی را که می‌توانید استفاده کنید فهرست می‌کند، به‌علاوه‌ی اصلاح‌گرهای _strip و _rgb برای برنامه‌هایی که رنگ‌هایشان را بدون # یا به‌صورت RGB ده‌دهی می‌خواهند. قالب‌های شما بر قالب‌های خود Omarchy اولویت دارند، پس می‌توانید از این روش برای لغو نحوه‌ی تم‌دادن به یک برنامه‌ی داخلی هم استفاده کنید.

توزیع تم خودتان

اگر می‌خواهید تم خودتان را توزیع کنید تا دیگران هم بتوانند از آن استفاده کنند، باید آن را روی یک سرور git عمومی، مثل GitHub، بگذارید. آن‌وقت مردم می‌توانند آن را با استفاده از نصب > سبک > تم در منوی Omarchy و با استفاده از آن URL نصب کنند. توصیه می‌شود از قرارداد نام‌گذاری omarchy-[themename]-theme پیروی کنید، چون تم بعد از نصب به‌درستی و فقط به‌صورت [themename] در منوی انتخاب تم نمایش داده خواهد شد.

آن [themename] باقی‌مانده تبدیل به نام پوشه‌ی تم می‌شود، پس باید چیزی باشد که Omarchy بتواند با خیال راحت دست‌به‌دستش کند: باید با یک حرف، یک رقم یا یک زیرخط شروع شود، و بقیه‌اش می‌تواند حرف، رقم، .، _، + و - داشته باشد. حروف بزرگ برایتان به حروف کوچک تبدیل می‌شوند، اما هر چیز دیگری - یک فاصله، یک گیومه، یک نویسه‌ی غیرانگلیسی - در زمان نصب رد می‌شود، نه این‌که تبدیل به یک نام پوشه شود. پس omarchy-tokyo-night-theme، omarchy-flexoki_light-theme و omarchy-c++-theme همه به‌خوبی نصب می‌شوند.

یادتان باشد که وقتی از یک مخزن نصب شد، هر .lua، پیکربندی ترمینال یا vscode.json که همراهش باشد حذف می‌شود، پس تم را دور آن‌ها نسازید.

می‌توانید تم خودتان را با فرستادن یک pull request به مخزن omarchy-site به صفحه‌ی تم‌های اضافی اضافه کنید.