path: root/weltschmerz.fi.1

.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-shape
Määrittää päätteen osoittimen muodon.
Mahdolliset arvot ovat
.Sy beam ,
.Sy block
ja
.Sy underline .
Oletusarvo on
.Sy block .
.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 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 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 .
.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 .
.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
<värityyppi>.<värin nimi>
.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 .