aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/weltschmerz.fi.1
blob: c348e9c5b723af263ae835ab216276cfb4e1a254 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
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 .