aboutsummaryrefslogtreecommitdiffstatshomepage
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--Makefile2
-rw-r--r--meson.build2
-rw-r--r--weltschmerz.fi.1309
3 files changed, 312 insertions, 1 deletions
diff --git a/Makefile b/Makefile
index a12a971..4658a9c 100644
--- a/Makefile
+++ b/Makefile
@@ -12,7 +12,7 @@ MOFILES := $(POFILES:.po=.mo)
.SUFFIXES:
.SUFFIXES: .po .mo
-MANI18N := weltschmerz.de.1
+MANI18N := weltschmerz.de.1 weltschmerz.fi.1
all: weltschmerz weltschmerz.1 weltschmerz.desktop $(MOFILES) $(MANI18N)
diff --git a/meson.build b/meson.build
index 9284ba8..f9d64a5 100644
--- a/meson.build
+++ b/meson.build
@@ -24,6 +24,8 @@ install_man('weltschmerz.1')
# until we rely on that
install_data('weltschmerz.de.1',
install_dir: join_paths(get_option('mandir'), 'de', 'man1'), rename: 'weltschmerz.1')
+install_data('weltschmerz.fi.1',
+ install_dir: join_paths(get_option('mandir'), 'fi', 'man1'), rename: 'weltschmerz.1')
i18n.merge_file(
input: 'weltschmerz.desktop.in',
diff --git a/weltschmerz.fi.1 b/weltschmerz.fi.1
new file mode 100644
index 0000000..c348e9c
--- /dev/null
+++ b/weltschmerz.fi.1
@@ -0,0 +1,309 @@
+.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 .