diff options
| -rw-r--r-- | weltschmerz.de.1 | 291 |
1 files changed, 291 insertions, 0 deletions
diff --git a/weltschmerz.de.1 b/weltschmerz.de.1 new file mode 100644 index 0000000..d96f78e --- /dev/null +++ b/weltschmerz.de.1 @@ -0,0 +1,291 @@ +.Dd 12. Juli 2021 +.Dt WELTSCHMERZ 1 +.Os +.Sh BEZEICHNUNG +.Nm weltschmerz +.Nd ein kleiner Terminalemulator auf VTE-Basis +.Sh ÜBERSICHT +.Nm +.Oo +.Ar Befehl +.Op Ar Argument... +.Oc +.Sh BESCHREIBUNG +.Nm +ist ein Terminalemulator der auf dem VTE-Widget aufgebaut ist. +Er liefert klickbare URLs und Hyperlinks, beinhaltet eine einfache +Suchfunktion, und kann die Konfiguration während der Laufzeit neu laden. +.Pp +.Nm +führt den angegebenen Befehl aus, oder - falls kein Befehl übergeben +wurde - das Programm, das in der Umgebungsvariable +.Ev SHELL +angegeben ist. +Im Falle dass diese Umgebungsvariable nicht vorhanden oder leer ist, +greift +.Nm +auf die Shell des Benutzers wie in +.Pa /etc/passwd +angegeben zurück. +Schlussendlich, falls auch dieser Eintrag fehlt, wird +.Pa /bin/sh +ausgeführt. +.Pp +Die Zwischenablage kann mit +.Sy Strg + Umschalt + C +befüllt und mit +.Sy Strg + Umschalt + V +eingefügt werden. +.Pp +Die Fontgröße kann durch das Scrollen mit gedrückter +.Sy Strg-Taste +oder durch das Betätigen von +.Sy Strg + = +und +.Sy Strg + - +vergrößert und verkleinert werden. +Die Standardgröße kann mit +.Sy Strg + 0 +wiederhergestellt werden. +.Pp +Das aktuelle Verzeichnis des Programms kann mit +.Sy Strg + Umschalt + O +im Dateimanager geöffnet werden. +Diese Funktion ist nur vorhanden, wenn das zugrunde liegende Programm +(etwa der Editor oder die Shell) die OSC 7 Escape-Sequenz unterstützt. +.Pp +Genau so lässt sich mit +.Sy Strg + Umschalt + T +ein neues Terminal-Fenster im aktuellen Verzeichnis öffnen. +Die oben genannten Einschränkungen gelten auch hier. +.Sh SUCHFELD +Das Suchfeld lässt sich mit +.Sy Strg + Umschalt + F +öffnen. +Die Suche wird hierbei beim Tippen im Suchfeld automatisch aktualisiert. +.Pp +Im Suchfeld gelten die folgenden Tastenkombinationen: +.Bl -tag -width Ds +.It Sy Enter , Strg + G +Zum nächsten Suchergebnis springen. +.It Sy Umschalt + Enter , Strg + Umschalt + G +Zum vorherigen Suchergebnis springen. +.It Sy Escape +Das Suchfeld schließen. +.El +.Sh KONFIGURATION +Die Konfiguration geschieht durch eine Konfigurationsdatei. +.Nm +liest diese Datei beim Empfang des SIGUSR1-Signals oder beim Druck auf +.Sy Strg + Umschalt + R +neu. +.Pp +.Nm +benutzt den Schlüssel-Wert-Parser aus GLib. +Das Dateiformat hierfür besteht aus Gruppen von Schlüssel-Wert-Paaren: +.Bd -literal -offset indent +[misc] +font = Iosevka Light 16 + +[colours] +foreground = #000000 +background = #ffffff +.Ed +.Pp +Die GLib-Dokumentation enthält weiterführende Informationen über dieses +Format. +.Pp +Die Einstellungen für die Schlüsselgruppe +.Em misc +sind wie folgt: +.Bl -tag -width Ds +.It Sy allow-hyperlinks +Ist der Wert +.Sy true , +so werden OSC-8-Hyperlinks verarbeitet und hervorgehoben. +Ist er +.Sy false , +so werden diese Hyperlinks komplett ignoriert. +Der Standardwert ist +.Sy false . +.It Sy autohide-mouse +Ist der Wert +.Sy true , +so wird der Mauszeiger nach einer Tasteneingabe versteckt und bei dem +Bewegen des Zeigers wieder angezeigt. +Ist er +.Sy false , +so wird der Mauszeiger immer angezeigt. +Der Standardwert ist +.Sy false . +.It Sy cursor-shape +Gibt die Form des Terminal-Cursors an. +Mögliche Werte sind +.Sy beam , +.Sy block , +und +.Sy underline . +Der Standardwert ist +.Sy block . +.It Sy cursor-blink +Gibt an, ob der Terminal-Cursor blinken soll. +Mögliche Werte sind +.Sy true , +.Sy false , +und +.Sy system . +Der Standardwert ist +.Sy system . +.Pp +Ist der Wert +.Sy system , +so zieht +.Nm +die GTK-Einstellung +.Sy gtk-cursor-blink +heran. +Die GTK-Dokumentation enthält weiterführende Informationen über diese +Einstellung. +.It Sy font +Gibt an, welche Schriftart für den Text verwendet wird. +Die Schriftart wird in Form einer Schriftbezeichnung der +Pango-Bibliothek angegeben. +Diese besteht aus einer oder mehreren Schriftartfamilien, null oder +mehreren Stilen, und der Größe der Schriftart in Punkten (oder Pixeln, +wenn ein Suffix +.Dq px +angegeben wird): +.Bd -literal -offset indent +Monospace 12 +Iosevka, DejaVu Sans Mono bold italic 16 +Gohu GohuFont 11px +.Ed +.Pp +Die Pango-Dokumentation enthält hierüber weiterführende Informationen. +.Pp +Der Standardwert ist +.Sy Monospace 12 . +.It Sy scrollback +Gibt an, wie viele Zeilen im Ausgabeverlauf gespeichert werden. +Mit einem Wert von +.Sy -1 +wird die Größe des Ausgabeverlaufs nicht limitiert. +Der Standardwert ist +.Sy 10000 . +.It Sy scrollbar +Ist der Wert +.Sy true , +so zeigt +.Nm +auf der rechten Seite des Terminal-Fensters einen Scrollbalken +an. +Ist er +.Sy false , +so wird kein Scrollbalken angezeigt. +Der Standardwert ist +.Sy true . +.Pp +.Nm +benutzt falls möglich das von GTK sogennante +.Dq overlay scrolling . +Das bedeutet, dass der Scrollbalken über das Terminal gezeichnet und bei +Bedarf versteckt wird. +Dieses Verhalten kann durch das Setzen der Umgebungsvariable +.Ev GTK_OVERLAY_SCROLLING +auf +.Sy 0 +unterdrückt werden. +Genau so kann auch die GTK-Einstellung +.Sy gtk-overlay-scrolling +verwendet werden. +.El +.Pp +Die Schlüsselgruppe +.Em colours +enthält die Farbpalette und andere Farbeinstellungen. +Die Werte in dieser Gruppe sind ausschließlich Farbangaben: +.Bd -filled -offset indent +.TS +tab(/); +l |l +lb |l. +Angabeart/Beispielangabe += +Hexadezimal/#00ffff +RGB/rgb(0, 255, 255) +RGBA/rgba(0, 255, 255, 1) +X11-Farben/cyan +.TE +.Ed +.Pp +Die Farbpalette enthält die 16 Grundfarben für das Terminal. +Die Schlüssel für die Farbpalette werden wie folgt gebildet: +.Bd -literal -offset indent +<Farbtyp>.<Farbname> +.Ed +.Pp +Der Farbtyp ist entweder +.Dq normal +für normale Farben oder +.Dq bright +für helle Farben. +Die Farbnamen sowie deren Standardwerte sind wie folgt: +.Bd -filled -offset indent +.TS +tab(/); +l |l |l +lb |l |l. +Farbname/Standardwert (normal)/Standartwert (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 +Die folgenden Farbeinstellungen geben an, welche Farben für bestimmte +Teile des Terminals (wie etwa Vorder- und Hintergrund, sowie die Auswahl +und fett gedruckter Text) verwendet werden. +Die Standardwerte werden benutzt, wenn diese Einstellungen nicht gesetzt +sind: +.Bd -filled -offset indent +.TS +tab(/); +l |l +lb |il. +Schlüssel/Standardwert += +foreground/normal.white +background/normal.black +cursor.foreground/Invertierte Darstellung +cursor.background/Invertierte Darstellung +selection.foreground/Invertierte Darstellung +selection.background/Invertierte Darstellung +bold/Farbe bleibt unverändert +.TE +.Ed +.Sh DATEIEN +.Bl -tag -width Ds +.It Em $XDG_CONFIG_HOME/weltschmerz/config +Die Konfigurationsdatei für +.Nm . +.El +.Pp +.Nm +hält sich an die +.Dq XDG Base Directory Specification . +Ist $XDG_CONFIG_HOME nicht vorhanden oder leer, so +wird +.Em ~/.config +verwendet. +.Sh AUTOREN +.An -nosplit +.Nm +wurde von +.An Wolfgang Müller Aq Mt wolf@oriole.systems +entwickelt. |