跳到內容
Chapters
  1. 歡迎使用 Omarchy!
  2. 開始使用
  3. 從 Mac 或 Windows 轉過來
  4. 導覽
  5. 頂部列
  6. 主題
  7. 快捷鍵
  8. 統一剪貼簿與歷史紀錄
  9. 提醒
  10. 通知
  11. 文字擷取與聽寫
  12. 截圖與螢幕錄影
  13. 切換開關、閒置與螢幕保護程式
  14. Omarchy CLI
  15. 終端機
  16. Neovim
  17. AI
  18. 開發工具
  19. Shell 工具
  20. Shell 函式
  21. TUIs
  22. GUI 應用程式
  23. 瀏覽器
  24. 商業應用程式/服務
  25. 網頁應用程式
  26. 遊戲
  27. 填寫 PDF
  28. Windows VM
  29. 其他套件
  30. 更新
  31. Dotfiles
  32. Shell 外掛程式
  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 shell(頂部列、選單、通知、OSD 和鎖定畫面)的設定。

你也可以使用內附的 Aether 應用程式,透過精美的 GUI 介面來建立新主題,盡情玩弄色彩並搜尋背景。只要從 Super + Alt + Space 的應用程式格狀清單中啟動它即可。

已安裝的主題可以包含什麼

你在 ~/.config/omarchy/themes 裡自己寫的主題可以包含任何你想要的東西 - - 這是你的機器、你的檔案,Omarchy 會全部套用。

你用 omarchy theme install 從別人的 repo 安裝的主題,會保留所有與色彩有關的內容,並捨棄少數幾種會在你機器上執行程式碼的檔案:任何 .lua 檔案、終端機設定(alacritty.toml、foot.ini、ghostty.conf、kitty.conf),以及 vscode.json。主題的 hyprland.lua 是你的 compositor 在登入時會執行的 Lua,終端機設定會指定你的終端機要啟動的程式,而 vscode.json 會指定要安裝的 VSCode 擴充功能。安裝別人的主題應該改變的是你桌面的外觀,絕不是它會執行的東西。

其他一切仍然完全按照主題作者寫的那樣運作 - - btop.theme、chromium.theme、helix.toml、icons.theme、shell.toml、背景和預覽全都會保留。只有被捨棄的部分會在你的機器上從 colors.toml 重新產生。

Omarchy 區分這兩者的方法,是看主題裡面是否有它自己的 git repo,而這正是 omarchy theme install 在 clone 時會留下的東西。所以你自己寫的主題依然是你的,從網路上抓來的主題就只管色彩。

淺色模式

如果你要製作淺色模式主題,請在 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 都能順利安裝。

記住,一旦它是從 repo 安裝的,它隨附的任何 .lua、終端機設定或 vscode.json 都會被捨棄,所以不要把主題建立在那些東西上面。

你可以將你的主題加入額外主題頁面,方法是向 omarchy-site repo 送出 pull request。