Pereiti prie turinio
Chapters
  1. Sveiki atvykę į Omarchy!
  2. Darbo pradžia
  3. Atkeliavus iš „Mac“ ar „Windows“
  4. Navigacija
  5. Viršutinė juosta
  6. Temos
  7. Spartieji klavišai
  8. Suvienodinta iškarpinė ir istorija
  9. Priminimai
  10. Pranešimai
  11. Teksto išgavimas ir diktavimas
  12. Ekrano kopijos ir įrašymas
  13. Perjungikliai, neveikla ir ekrano užsklanda
  14. Omarchy CLI
  15. Terminalas
  16. Neovim
  17. AI
  18. Programavimo įrankiai
  19. Shell įrankiai
  20. Shell funkcijos
  21. TUIs
  22. Grafinės programos
  23. Naršyklės
  24. Komercinės programos/paslaugos
  25. Žiniatinklio programos
  26. Žaidimai
  27. PDF pildymas
  28. Windows VM
  29. Kiti paketai
  30. Atnaujinimai
  31. Dotfiles
  32. Shell įskiepiai
  33. Monitoriai
  34. Klaviatūra, pelė, jutiklinis kilimėlis
  35. Tinklas
  36. Sistemos miegas
  37. Aparatinės įrangos autentifikavimas
  38. Šriftai
  39. Fonai
  40. Raginimas
  41. Prekės ženklas
  42. Dažni patobulinimai
  43. Savo temos kūrimas
  44. Mac palaikymas
  45. Trikčių šalinimas
  46. DUK
  47. Sistemos momentinės kopijos
  48. Saugumas
  49. Omarchy ant...
  50. Diegimas su dviguba įkrova
  51. Diegimas be priežiūros

Vadovas

Shell įskiepiai

Omarchy darbalaukis veikia kaip vienas ilgai gyvuojantis Quickshell procesas pavadinimu omarchy-shell, ir beveik viskas, ką matai ekrane, yra įskiepis jame. Juosta yra įskiepis. Taip pat skydeliai, krentantys iš jos, viso ekrano perteikliai, pavyzdžiui, emoji rinkiklis ir iškarpinės tvarkyklė, pats Omarchy meniu, užrakinimo ekranas, polkit dialogas ir nematomas paslaugos, kurios stebiavo akumuliatorių ir šildo ekraną nakčiai.

Tai ne vien įgyvendinimo detalė. Tai reiškia, kad gali išjungti darbalaukio dalis, jas pakeisti ar parašyti savo, neliesdamas nė vienos Omarchy šaltinio eilutės.

Pirmosios šalies įskiepiai pristatomi su Omarchy ir gyvena $OMARCHY_PATH/shell/plugins/. Viskas, ką pridedi pats - savo eksperimentai ar kažkas rasta GitHub - gyvena ~/.config/omarchy/plugins/. Abu atrandami tuo pačiu būdu paleidimo metu, bet įtaisyti gauna patikimas shell sąsajas, o trečiųjų šalių įskiepiai gauna ribotą sąsają, apribotą jų pačių paslauga ir gyvavimo ciklu. Įtaisytųjų klonai išlaiko tik su šaltiniu susijusią konfigūraciją ir UI iškvietimus, reikalingus originaliam veikimui.

Pamatyti, ką turi

omarchy plugin list

Tai išspausdina kiekvieną atrastą įskiepį su jo id, ar jis įjungtas, ar pirmosios, ar trečiosios šalies, jo tipus ir rodomą pavadinimą. Pridėk --json, jei tai perduodi kam nors kitam.

Įskiepių id yra pavadintiniai (namespaced). Įtaisyti visi prasideda omarchy. - omarchy.clock, omarchy.network, omarchy.notifications - ir tas pavadinimų erdve yra rezervuota, tad trečiosios šalies įskiepis niekada negali jos pretenduoti.

Įjungti ir išjungti

omarchy plugin enable omarchy.tailscale
omarchy plugin disable omarchy.weather

Arba naudok meniu: Nuostatos > Plugins turi Enable, Disable, Add, Clone ir Remove, kiekvienas su rinkikliu, kuris siūlo tik tuos įskiepius, kurie turi prasmę tam veiksmui.

Įjungta būsena saugoma ~/.config/omarchy/shell.json, ir taisyklė šiek tiek skiriasi dviem įskiepių tipams. Trečiosios šalies įskiepis įjungtas būtent tada, kai jo id pasirodo kur nors tame faile - kaip juostos išdėstymo įrašas, kaip įrašas plugins[] arba kaip bar.id. Pirmosios šalies įskiepiai, kurie nėra juostos valdikliai, yra atvirkščiai: jie įjungti pagal nutylėjimą ir išsijungia tik būdami išvardyti disabledPlugins[].

Pilnas juostos įskiepis iš viso neturi išjungtos būsenos. Visada yra būtent viena juosta, tad ją pakeiti įjungdamas kitą. Juostos valdiklių išdėstymas aptariamas meniu juostoje.

Įskiepio pridėjimas iš git

Trečiosios šalies įskiepis yra tiesiog git saugykla su manifest.json jo šaknyje.

omarchy plugin add https://github.com/acme/omarchy-weather.git --enable

Prieš ką nors darant, jis paprastai tau pasako, kad įskiepiai veikia kaip savavališkas, nesmėliadėžytas kodas tavo ilgai gyvuojančiame shell procese, parodo tau URL ir paprašo patvirtinti. Priimk tai rimtai. Trečiųjų šalių įskiepių sąsaja tiesiogiai neatskleidžia autentifikavimo paslaugų, o pakaitinė juosta gauna tik ribotas galimybes sukonfigūruotiems neautentifikavimo UI. Vaizdinio įskiepiai vis dar dalijasi shell QML scena ir gali vaikščioti įprastais tėviniais objektais, o visas įskiepių kodas veikia su viskuo, ką tavo naudotojo paskyra gali pasiekti. Autentifikavimo būsena saugoma atskirai, laikant tas paslaugas už pasiekiamo šeimininko objektų grafo ribų. Pridėk tik tas saugyklas, kurias esi pasiruošęs paleisti, ir perskaityk jas prieš įjungdamas.

Pakaitinė juosta gali atvaizduoti įdiegtus valdiklius, bet paslaugomis paremti trečiųjų šalių valdikliai ten gali turėti sumažintą funkcionalumą, nes juostai neleidžiama prašyti kito įskiepio gyvos paslaugos objekto. Grįžk prie įtaisytos omarchy.bar, jei toks valdiklis reikia jo papildančios paslaugos.

Tada jis klonuoja saugyklą į pakopos katalogą, patvirtina manifestą, atsisako diegimo, jei kitas įskiepis jau pretenduoja į tą id, ir perkelia jį į ~/.config/omarchy/plugins/<id>/. Be --enable jis paklausia, ar nori jį įjungti dabar, ir gali pasakyti ne ir pirmiausia eiti perskaityti kodą. Jis niekada nieko nepaleidžia iš įskiepio, niekada nevykdo diegimo kablio ir niekada neprašo sudo - jis klonuoja failus, patikrina manifestą ir perjungia bitą per IPC.

Atnaujinimas yra tos pačios kopijos spartusis persiuntimas (fast-forward pull):

omarchy plugin update acme.weather
omarchy plugin update

Be id jis atnaujina kiekvieną tavo turimą git valdomą įskiepį. Jis parodo tau diff prieš pritaikydamas, atsisako atnaujinti, jei turi vietinių pakeitimų, kurių jis negali greitai persiųsti, ir atšaukia, jei nauja versija nepavyksta patvirtinti.

omarchy plugin remove acme.weather

Pašalinimas pirmiausia išjungia įskiepį, tada jį ištrina, jei tai git kopija (saugykla vis dar prieš srovę), arba atsieja, jei tai simbolinė nuoroda. Rankų darbo įskiepio aplankas be git saugyklos perkeliamas į atsarginę kopiją su laiko antspaudu įskiepių kataloge, užuot ištrynęs jį visiškai.

Įtaisyto klonavimas, kad jį pakeistum

Tai mano mėgstamiausia dalis. Jei nori pakeisti, kaip elgiasi įtaisytas valdiklis, neredaguok failų pagal $OMARCHY_PATH - jie priklauso paketui ir kitas atnaujinimas juos perrašys. Vietoj to jį klonuok:

omarchy plugin clone omarchy.clock

Tai nukopijuoją visą įskiepį į ~/.config/omarchy/plugins/dhh.clock (tavo naudotojo vardas, ne mano), pervadina jį į “My Clock”, įjungia jį ir perjungia shell nuo įtaisyto prie tavo kopijos - išlaikydamas esamo juostos valdiklio padėtį ir nuostatas. Pridėk --edit, kad naują katalogą iškart atvertum savo $EDITOR, ką meniu Nuostatos > Plugins > Clone Plugin daro už tave.

Naudotojo vardo priešdėlis išlaiko tavo klono id tavuoju, tad juo dalintis nesusiduria su niekieno kito. Iškvietimai originaliam įtaisytam id nukreipiami į tavo kloną, tad nieko, kas nurodžiau į omarchy.clock, nereikia atnaujinti. O jei jį sujauksi, omarchy plugin remove dhh.clock grąžina įtaisytą atgal.

Failo išsaugojimas bet kur ~/.config/omarchy/plugins/ automatiškai perkrauna įskiepio kodą, tad gali palikti redaktorių atvirą ir stebėti, kaip atsiunčia tavo pakeitimai.

Savo rašymas

Įskiepis yra katalogas su manifest.json ir šiek tiek QML. Manifestas deklaruoja schemaVersion: 1, id, name, version, vieną ar kelis kinds ir entryPoints objektą, nurodantį į QML failą kiekvienam tipui:

Tipas Kas tai
bar-widget Komponentas, kurį aktyvi juosta gali įmesti į skiltį
panel Nuolatinis arba iškviestas plūduriuojantis langas
overlay Viso ekrano perteiklis
menu Iškviečiamas meniu paviršius
service Nematomas singleton be UI
bar Pilna juosta, pakeičianti įtaisytą

Įskiepis gali deklaruoti kelis tipus vienu metu - media įskiepis yra ir service, ir bar-widget. Juostos valdikliai gauna papildomą barWidget bloką su rodomu pavadinimu, kategorija, neprivalomu defaultSection ir allowMultiple, kuris sako, ar prasminga turėti daugiau nei vieną jį juostoje. Dauguma valdiklių jį nustato į false; skirtukai ir indikatoriai nustato jį į true.

Prieš ką nors skelbdamas, patikrink tai:

omarchy plugin validate ./my-plugin

Tai paleidžia tuos pačius patikrinimus, kuriuos shell atlieka įkėlimo metu: schemos versiją, privalomus laukus, id, kuris nėra rezervuotas, įėjimo taškus, kurie yra saugūs santykiniai keliai ir iš tikrųjų egzistuoja, įėjimo tašką kiekvienam tipui, kurį pretendei, ir be simbolinių nuorodų niekur aplanko viduje.

Įskiepių kūrimui žiūrėk shell nuorodą ir pirmosios šalies įskiepių katalogą.

Dalinimasis savuoju su pasauliu

Kai sukūrei kažką, kas tau patinka, įdėk tai į viešą git saugyklą. Tai visas platinimo mechanizmas - tada bet kas gali paleisti omarchy plugin add prieš tavo URL ir turėti jį veikiantį per kelias sekundes.

Kad padėtum žmonėms jį iš tikrųjų rasti, išvardyk jį plugins.omarchy.org. Tai Omarchy shell įskiepių turgus (marketplace) ir pirmoji vieta, kurios žiūrėti, kai domiesi, ar kas nors jau sukūrę valdiklį, kurį ruošiesi rašyti. Peržiūrėk jį prieš pradedant!