.Dd 23. lokakuuta 2021 .Dt WELTSCHMERZ 1 .Os .Sh NIMI .Nm weltschmerz .Nd pieni VTE-pohjainen pääte-emulaattori .Sh YLEISKATSAUS .Nm .Oo .Ar komento .Op Ar argumentti... .Oc .Sh KUVAUS .Nm on VTE-vimpaimeen perustuva pääte-emulaattori. Se tukee klikattavia URL-osoitteita ja hyperlinkkejä, sisältää yksinkertaisen hakutoiminnon ja voi ladata konfiguraationsa uudelleen käynnissä ollessaan. .Pp .Nm suorittaa annetun komennon tai ilman komentoa ajettuna ympäristömuuttujassa .Ev SHELL olevan ohjelman. Jos .Ev SHELL on tyhjä tai sille ei ole asetettu arvoa, .Nm käyttää käyttäjän tiedostossa .Pa /etc/passwd määriteltyä komentotulkkia, tai jollei komentotulkkia ole määritelty siellä, oletusarvoa .Pa /bin/sh . .Pp Leikepöydälle voi kopioida näppäinyhdistelmällä .Sy CTRL + Shift + C ja sieltä liittää yhdistelmällä .Sy CTRL + Shift + V . .Pp Kirjaisinkokoa voi säätää vierittämällä hiirellä pitäen samaan aikaan .Sy CTRL pohjassa tai käyttämällä näppäinyhdistelmiä .Sy CTRL + = ja .Sy CTRL + - . Oletuskoon saa palautettua yhdistelmällä .Sy CTRL + 0 . .Pp Oletustiedostoselaimen voi avata tämänhetkisessä hakemistossa näppäinyhdistelmällä .Sy CTRL + Shift + O ja uuden pääteikkunan yhdistelmällä .Sy CTRL + Shift + T . Nämä ominaisuudet vaativat joko pääteessä ajettavan ohjelman lähettävän OSC 7 -ohjauskoodeja tai ajoympäristön tarjoavan Linux-tyylisen procfs:n polun .Pa /proc alla. .Sh HAKUPÄÄLLYSIKKUNA Hakupäällysikkunan voi avata näppäinyhdistelmällä .Sy CTRL + Shift + F . Haku päivittyy automaattisesti käyttäjän kirjoittaessa hakupalkkiin. .Pp Päällysikkunassa voi käyttää seuraavia näppäinyhdistelmiä: .Bl -tag -width Ds .It Sy Enter , CTRL + G Siirry seuraavaan hakutulokseen. .It Sy Shift + Enter , CTRL + Shift + G Siirry edelliseen hakutulokseen. .It Sy Escape Sulje päällysikkuna. .El .Sh ASETUKSET .Nm konfiguroidaan asetustiedostolla. Jos .Nm saa SIGUSR1-signaalin tai käyttäjä painaa .Sy CTRL + Shift + R , .Nm lukee asetustiedoston uudelleen. .Pp .Nm käyttää GLib:n avain-arvo-tiedostoparseria. Sen käyttämä formaatti koostuu ryhmiin kootuista avain-arvo-pareista: .Bd -literal -offset indent [misc] font = Iosevka Light 16 [colours] foreground = #000000 background = #ffffff [open-with] mpv = mpv % .Ed .Pp Tarkemmissa yksityiskohdissa käänny GLib:n dokumentaation puoleen. .Pp Ryhmän .Em misc asetukset ovat: .Bl -tag -width Ds .It Sy allow-hyperlinks Tämän ollessa .Sy true .Nm korostaa ja käsittelee OSC 8 -hyperlinkit. Tämän ollessa .Sy false hyperlinkkituki on kokonaan pois päältä. Oletusarvo on .Sy false . .It Sy autohide-mouse Tämän ollessa .Sy true .Nm piilottaa hiiren osoittimen käyttäjän painaessa näppäintä ja näyttää sen uudelleen hiirtä liikutettaessa. Tämän ollessa .Sy false hiiren osoitin on aina näkyvissä. Oletusarvo on .Sy false . .It Sy cursor-blink Määrittää välkkyykö osoitin. Mahdolliset arvot ovat .Sy true , .Sy false ja .Sy system . Oletusarvo on .Sy system . .Pp Tämän ollessa .Sy system .Nm noudattaa GTK:n asetusta .Sy gtk-cursor-blink . Lisäyksityiskohdissa käänny GTK:n dokumentaation puoleen. .It Sy cursor-shape Määrittää päätteen osoittimen muodon. Mahdolliset arvot ovat .Sy beam , .Sy block ja .Sy underline . Oletusarvo on .Sy block . .It Sy font Määrittää päätetekstin kirjaisimen. Kirjaisimen tulee olla Pangon kirjaisinmääritelmän muodossa, joka koostuu yhdestä tai useammasta kirjaisinperheestä, nollasta tai useammasta tyyliasetuksesta ja koosta pisteissä (tai pikseleissä jos sitä seuraa .Dq px ) : .Bd -literal -offset indent Monospace 12 Iosevka, DejaVu Sans Mono bold italic 16 Gohu GohuFont 11px .Ed .Pp Yksityiskohdissa käänny Pangon dokumentaation puoleen. .Pp Oletusarvo on .Sy Monospace 12 . .It Sy scrollback Määritää montako riviä päätehistoriaa .Nm säilyttää. Arvo .Sy -1 tarkoittaa loputonta päätehistoriaa. Oletusarvo on .Sy 10000 . .It Sy scrollbar Tämän ollessa .Sy true .Nm piirtää liukupalkin pääteikkunan oikeaan laitaan. Tämän ollesa .Sy false .Nm ei piirrä liukupalkkia. Oletusarvo on .Sy true . .It Sy prefer-osc7 Tämän ollessa .Sy true .Nm yrittää käyttää OSC 7:ää tämänhetkisen hakemiston selvittämiseksi. Jos tämä ei tuota sopivaa polkua, .Nm selvittää lapsiprosessin hakemiston proc-tiedostojärjestelmän avulla. Tämän ollessa .Sy false .Nm käyttää vain proc-tiedostojärjestelmää. Oletusarvo on .Sy true . .Pp Huomioithan että .Nm käyttää päällysteliukupalkkia sen ollessa saatavilla. Tämä tarkoittaa, että .Nm piirtää liukupalkin päätteen päälle ja häivyttää sen pois automaattisesti jollei sitä käytetä. Jos haluat kytkeä tämän pois päältä, aseta ympäristömuuttujan .Ev GTK_OVERLAY_SCROLLING arvoksi .Sy 0 tai muokkaa GTK:n asetusta .Sy gtk-overlay-scrolling . .El .Pp Ryhmä .Em colours sisältää väripaletin ja väriohitukset. Kaikkien ryhmän avainten kanssa tulee käyttää värimääritelmiä: .Bd -filled -offset indent .TS tab(/); l |l lb |l. Määritelmä/Esimerkkiarvo = Heksadesimaalinen/#00ffff RGB/rgb(0, 255, 255) RGBA/rgba(0, 255, 255, 1) X11-väri/cyan .TE .Ed .Pp Paletti määrittää 16 päätteen perusväriä. Paletin avaimet ovat muotoa: .Bd -literal -offset indent . .Ed .Pp Värityyppi on joko .Dq normal tai .Dq bright , ja mahdolliset värin nimet oletusarvojensa kera ovat: .Bd -filled -offset indent .TS tab(/); l |l |l lb |l |l. Värin nimi/Oletus (normal)/Oletus (bright) = black/black/grey50 red/red3/red green/green3/green yellow/yellow3/yellow blue/blue2/#5c5cff magenta/magenta3/magenta cyan/cyan3/cyan white/grey90/white .TE .Ed .Pp Väriohitukset määrittävät tietyjen päätten osien värit. Seuraava taulukko sisältää mahdolliset väriohitukset sekä oletuskäytöksen jollei niitä ole asetettu: .Bd -filled -offset indent .TS tab(/); l |l lb |il. Avain/Oletus = foreground/normal.white background/normal.black cursor.foreground/käänteisvärit cursor.background/käänteisvärit selection.foreground/käänteisvärit selection.background/käänteisvärit bold/säilytä väri .TE .Ed .Pp Asetukset ryhmässä .Em open-with määritelevät ohjelmia, joita voi ajaa URI-kontekstivalikosta. Avain määrittää ohjelman nimen kuten se esiintyy valikossa, ja arvo suoritettavan komennon. .Pp .Nm käsittelee lainausmerkit kuten POSIX .Xr sh 1 , mutta ei tue jokerimerkkejä tai muuttujia. Jokainen .Dq % korvataan URI-osoitteella komentoa suoritettaessa. .Sh TIEDOSTOT .Bl -tag -width Ds .It Em $XDG_CONFIG_HOME/weltschmerz/config .Nm weltschmerzin asetustiedosto. .El .Pp .Nm noudattaa XDG:n pohjahakemistomääritelmää. Jos $XDG_CONFIG_HOME ei ole asetettu tai on asetettu tyjäksi, sen oletusarvo on .Em ~/.config . .Sh TEKIJÄT .An -nosplit .Nm weltschmerzin on tehnyt .An Wolfgang Müller Aq Mt wolf@oriole.systems .