Siirry sisältöön
Chapters
  1. Tervetuloa Omarchyyn!
  2. Aloittaminen
  3. Tuletko Macista tai Windowsista
  4. Navigointi
  5. Yläpalkki
  6. Teemat
  7. Pikanäppäimet
  8. Yhtenäinen leikepöytä ja historia
  9. Muistutukset
  10. Ilmoitukset
  11. Tekstin poiminta ja sanelu
  12. Kuvakaappaukset ja tallennus
  13. Kytkimet, joutokäynti ja näytönsäästäjä
  14. Omarchy CLI
  15. Pääte
  16. Neovim
  17. Tekoäly
  18. Kehitystyökalut
  19. Shell-työkalut
  20. Shell-funktiot
  21. TUIs
  22. Graafiset sovellukset
  23. Selaimet
  24. Kaupalliset sovellukset/palvelut
  25. Verkkosovellukset
  26. Pelaaminen
  27. PDF:ien täyttäminen
  28. Windows VM
  29. Muut paketit
  30. Päivitykset
  31. Dotfiles
  32. Shell-lisäosat
  33. Näytöt
  34. Näppäimistö, hiiri, kosketuslevy
  35. Verkkoyhteydet
  36. Järjestelmän lepotila
  37. Laitteistotodennus
  38. Fontit
  39. Taustakuvat
  40. Kehote
  41. Brändäys
  42. Yleisiä viilauksia
  43. Oman teeman tekeminen
  44. Mac-tuki
  45. Vianmääritys
  46. Usein kysytyt kysymykset
  47. Järjestelmän tilannevedokset
  48. Tietoturva
  49. Omarchy käytössä...
  50. Kaksoiskäynnistysasennus
  51. Valvomattomat asennukset

Ohjekirja

Shell-lisäosat

Omarchy-työpöytä toimii yhtenä pitkään elävänä Quickshell-prosessina nimeltä omarchy-shell, ja melkein kaikki, mitä näet näytöllä, on lisäosa sen sisällä. Palkki on lisäosa. Niin ovat myös siitä putoavat paneelit, koko näytön peitteet, kuten emoji-valitsin ja leikepöydän hallinta, itse Omarchy-valikko, lukitusnäyttö, polkit-valintaikkuna ja päättömät palvelut, jotka tarkkailevat akkuasi ja lämmittävät näyttöäsi yöllä.

Se ei ole vain toteutuksen yksityiskohta. Se tarkoittaa, että voit kytkeä työpöydän osia pois päältä, vaihtaa niitä tai kirjoittaa omia koskematta riviäkään Omarchyn lähdekoodia.

Ensimmäisen osapuolen lisäosat toimitetaan Omarchyn mukana ja sijaitsevat hakemistossa $OMARCHY_PATH/shell/plugins/. Kaikki, mitä lisäät itse - omat kokeilusi tai jotain GitHubista löytämääsi - sijaitsee hakemistossa ~/.config/omarchy/plugins/. Molemmat löydetään samalla tavalla käynnistyksen yhteydessä, mutta sisäänrakennetut saavat luotettuja shell-rajapintoja, kun taas kolmannen osapuolen lisäosat saavat rajoitetun rajapinnan, joka on rajattu niiden omaan palveluun ja elinkaareen. Sisäänrakennettujen kloonit säilyttävät vain lähdekohtaisen määrityksen ja käyttökutsut, joita alkuperäinen käyttäytyminen tarvitsee.

Sen näkeminen, mitä sinulla on

omarchy plugin list

Se tulostaa jokaisen löydetyn lisäosan id:ineen, sen, onko se käytössä, sen, onko se ensimmäisen vai kolmannen osapuolen, sen lajit ja sen näyttönimen. Lisää --json, jos syötät sitä jollekin muulle.

Lisäosien id:t ovat nimiavaruudella varustettuja. Sisäänrakennetut alkavat kaikki etuliitteellä omarchy. - omarchy.clock, omarchy.network, omarchy.notifications - ja tuo nimiavaruus on varattu, joten kolmannen osapuolen lisäosa ei voi koskaan vaatia sitä.

Niiden kytkeminen päälle ja pois

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

Tai käytä valikkoa: Asetukset > Plugins:ssä on Enable, Disable, Add, Clone ja Remove, jokaisessa valitsin, joka tarjoaa vain ne lisäosat, jotka sopivat kyseiseen toimintaan.

Käytössäolotila tallennetaan tiedostoon ~/.config/omarchy/shell.json, ja sääntö eroaa hieman kahden lisäosalajin osalta. Kolmannen osapuolen lisäosa on käytössä täsmälleen silloin, kun sen id esiintyy jossain tuossa tiedostossa - palkin asettelumerkintänä, merkintänä listassa plugins[] tai merkintänä bar.id. Ensimmäisen osapuolen lisäosat, jotka eivät ole palkin widgettejä, ovat toisin päin: ne ovat oletuksena päällä ja kytkeytyvät pois vain olemalla listassa disabledPlugins[].

Täydellä palkin lisäosalla ei ole lainkaan pois-tilaa. Palkkeja on aina täsmälleen yksi, joten korvaat sen ottamalla käyttöön toisen. Palkin widgettien sijoittelu käsitellään kohdassa yläpalkki.

Lisäosan lisääminen gitistä

Kolmannen osapuolen lisäosa on vain git-repo, jonka juuressa on tiedosto manifest.json.

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

Ennen kuin se tekee mitään, se kertoo sinulle selkeästi, että lisäosat toimivat mielivaltaisena, hiekkalaatikoimattomana koodina pitkään elävän shell-prosessisi sisällä, näyttää sinulle URL:n ja pyytää sinua vahvistamaan. Ota se vakavasti. Kolmannen osapuolen lisäosarajapinta ei suoraan paljasta todennuspalveluja, ja korvaava palkki saa vain rajoitettuja kykyjä määritellylle ei-todennuskäyttöliittymälle. Visuaaliset lisäosat jakavat silti shellin QML-näkymän ja voivat kulkea tavallisten yläobjektien kautta, kun taas kaikki lisäosakoodi toimii kaiken sen kanssa, minkä käyttäjätilisi voi tavoittaa. Todennustila suojataan erikseen pitämällä nuo palvelut tavoitettavan isäntäobjektigraafin ulkopuolella. Lisää vain repoja, joita olet valmis ajamaan, ja lue ne ennen kuin otat ne käyttöön.

Korvaava palkki voi hahmontaa asennettuja widgettejä, mutta palveluun nojaavilla kolmannen osapuolen widgeteillä voi siellä olla rajoitettua toiminnallisuutta, koska palkki ei saa pyytää toisen lisäosan elävää palveluobjektia. Vaihda takaisin sisäänrakennettuun omarchy.bar-palkkiin, jos sellainen widgetti tarvitsee kumppanipalveluaan.

Sitten se kloonaa repon vaihehakemistoon, validoi manifestin, kieltää asennuksen, jos toinen lisäosa jo vaatii tuon id:n, ja siirtää sen hakemistoon ~/.config/omarchy/plugins/<id>/. Ilman valitsinta --enable se kysyy, haluatko sen päälle nyt, ja voit sanoa ei ja mennä lukemaan koodia ensin. Se ei koskaan aja mitään lisäosasta, ei koskaan suorita asennuskoukkua eikä koskaan pyydä sudoa - se kloonaa tiedostoja, tarkistaa manifestin ja kääntää bitin IPC:n yli.

Päivittäminen on saman noudetun kopion pikaeteenpäin-veto:

omarchy plugin update acme.weather
omarchy plugin update

Ilman id:tä se päivittää jokaisen git-hallinnoidun lisäosasi. Se näyttää sinulle diffin ennen sen soveltamista, kieltäytyy päivittämästä, jos sinulla on paikallisia muutoksia, joista se ei voi pikaedetä ohi, ja palauttaa, jos uusi revisio epäonnistuu validoinnissa.

omarchy plugin remove acme.weather

Poisto kytkee lisäosan ensin pois käytöstä ja poistaa sen sitten, jos se on git-noudettu kopio (repo on edelleen ylävirrassa), tai irrottaa sen linkityksen, jos se on symbolinen linkki. Käsin tehty lisäosakansio, jossa ei ole git-repoa, siirretään aikaleimattuun varmuuskopioon lisäosahakemiston sisällä sen sijaan, että se poistettaisiin suoralta kädeltä.

Sisäänrakennetun kloonaaminen muokattavaksi

Tämä on suosikkiosani. Jos haluat muuttaa sitä, kuinka sisäänrakennettu widgetti käyttäytyy, älä muokkaa tiedostoja hakemistossa $OMARCHY_PATH - ne kuuluvat pakettiin ja seuraava päivitys ylikirjoittaa ne. Kloonaa se sen sijaan:

omarchy plugin clone omarchy.clock

Se kopioi koko lisäosan hakemistoon ~/.config/omarchy/plugins/dhh.clock (sinun käyttäjänimesi, ei minun), nimeää sen uudelleen muotoon “My Clock”, ottaa sen käyttöön ja vaihtaa shellin sisäänrakennetusta kopioosi - säilyttäen olemassa olevan palkin widgetin sijainnin ja asetukset. Lisää --edit avataksesi uuden hakemiston muuttujassa $EDITOR heti, minkä valikon Asetukset > Plugins > Clone Plugin tekee puolestasi.

Käyttäjänimietuliite pitää kloonisi id:n sinun omasi, joten sen jakaminen ei törmää kenenkään muun kanssa. Alkuperäiselle sisäänrakennetulle id:lle tehdyt kutsut reititetään klooniisi, joten minkään, mikä viittasi tunnisteeseen omarchy.clock, ei tarvitse päivittyä. Ja jos sotket sen, omarchy plugin remove dhh.clock laittaa sisäänrakennetun takaisin.

Tiedoston tallentaminen minne tahansa hakemistossa ~/.config/omarchy/plugins/ lataa lisäosakoodin uudelleen automaattisesti, joten voit jättää editorin auki ja katsella muutostesi saapumista.

Oman kirjoittaminen

Lisäosa on hakemisto, jossa on tiedosto manifest.json ja jonkin verran QML:ää. Manifesti julistaa schemaVersion: 1, kentän id, name, version, yhden tai useamman kentän kinds ja objektin entryPoints, joka osoittaa jokaisen lajin QML-tiedostoon:

Laji Mikä se on
bar-widget Komponentti, jonka aktiivinen palkki voi pudottaa osioon
panel Pysyvä tai kutsuttu kelluva ikkuna
overlay Koko näytön peite
menu Kutsuttu valikkopinta
service Päätön singleton ilman käyttöliittymää
bar Täysi palkki, joka korvaa sisäänrakennetun

Lisäosa voi julistaa useita lajeja kerralla - media-lisäosa on sekä service että bar-widget. Palkin widgetit saavat ylimääräisen lohkon barWidget, jossa on näyttönimi, luokka, valinnainen defaultSection ja allowMultiple, joka kertoo, onko järkevää olla useampaa kuin yksi palkissa. Useimmat widgetit asettavat sen arvoon false; välikkeet ja ilmaisimet asettavat sen arvoon true.

Ennen kuin julkaiset mitään, tarkista se:

omarchy plugin validate ./my-plugin

Se ajaa samat tarkistukset, jotka shell tekee latausaikana: skeemaversion, vaaditut kentät, id:n, joka ei ole varattu, aloituspisteet, jotka ovat turvallisia suhteellisia polkuja ja oikeasti olemassa, aloituspisteen jokaiselle lajille, jonka väitit, eikä symbolisia linkkejä missään kansion sisällä.

Lisäosakehitykseen katso shell-viite ja ensimmäisen osapuolen lisäosaluettelo.

Omasi jakaminen maailmalle

Kun olet tehnyt jotain, mistä pidät, laita se julkiseen git-repoon. Se on koko jakelumekanismi - kuka tahansa voi sitten ajaa omarchy plugin add URL-osoitettasi vasten ja saada sen käyntiin sekunneissa.

Auttaaksesi ihmisiä oikeasti löytämään sen, listaa se osoitteessa plugins.omarchy.org. Se on Omarchy-shell-lisäosien kauppapaikka, ja se on ensimmäinen paikka, josta kannattaa katsoa, kun pohdit, onko joku jo rakentanut widgetin, jota olet aikeissa kirjoittaa. Selaa sitä ennen kuin aloitat!