189 lines
7 KiB
Groff
Executable file
189 lines
7 KiB
Groff
Executable file
.\" BadWolf: Minimalist and privacy-oriented WebKitGTK+ browser
|
||
.\" Copyright © 2019-2023 Badwolf Authors <https://hacktivis.me/projects/badwolf>
|
||
.\" SPDX-License-Identifier: BSD-3-Clause
|
||
.\"*******************************************************************
|
||
.\"
|
||
.\" This file was generated with po4a. Translate the source file.
|
||
.\"
|
||
.\"*******************************************************************
|
||
.Dd 2022-07-13
|
||
.Dt BADWOLF 1
|
||
.Os
|
||
.Sh NAME
|
||
.Nm badwolf
|
||
.Nd minimalistischer und privatsphäre-orientierter Webbrowser basierend auf WebKitGTK
|
||
.Sh ÜBERSICHT
|
||
.Nm
|
||
.Op Ar WebKit-/GTK-Optionen
|
||
.Op Ar URLs oder Pfade
|
||
.Sh BESCHREIBUNG
|
||
.Nm
|
||
ist ein minimalistischer Webbrowser, der die Privatssphäre seiner
|
||
Nutzer respektiert. Er basiert auf WebKitGTK und akzeptiert daher alle
|
||
Optionen und Umgebungsvariablen, die WebKitGTK (und Abhängigkeiten) auch
|
||
akzeptieren, leider gibt es dafür keine Manpages.
|
||
.Pp
|
||
Laufzeitspezifische Konfigurationsmöglichkeiten für
|
||
.Nm
|
||
werden
|
||
wahrscheinlich in einer späteren Version hinzugefügt.
|
||
.Sh TASTENKOMBINATIONEN
|
||
Der folgende Abschnitt listet die unterstützten Tastenkombinationen und ihre
|
||
Funktionen auf. Vor jeder Tastenkombination steht der greifende Kontext.
|
||
.Bl -tag -width Ds
|
||
.It webview Ctrl-Scroll
|
||
Zoomt die Website rein/raus.
|
||
.It webview Ctrl-0
|
||
Setzt den Zoom auf 100% zurück.
|
||
.It webview Ctrl-MousePrimary, webview MouseMiddle
|
||
Öffnet den hervorgehobenen Link in einem neuen Tab. (Hinweis: Dieses
|
||
Verhalten kann mit Javascript manipuliert werden)
|
||
.It any Ctrl-t
|
||
Eröffnet einen neuen Tab in einer neuen Sitzung (ähnlich wie der "Neuer
|
||
Tab"-Knopf)
|
||
.It browser Ctrl-F4, browser Alt-d
|
||
Schließt den aktuellen Tab
|
||
.It browser Ctrl-f
|
||
Hebt das Suchfeld hervor
|
||
.It browser Ctrl-l
|
||
Hebt die Addresszeile hervor
|
||
.It browser Ctrl-Shift-r / Ctrl-r, browser F5
|
||
Lädt den aktuellen Tab neu (jeweils mit und ohne den Cache zu leeren)
|
||
.It browser Escape
|
||
Bricht das Laden ab
|
||
.It browser F7
|
||
Aktiviert den Tastaturmodus (Navigation mit dem Textcursor)
|
||
.It browser F12
|
||
Öffnet die Entwickleroptionen
|
||
.It browser Ctrl-[ / Ctrl-]
|
||
Zur vorherigen/nächsten Seite im Suchverlauf gehen
|
||
.It browser Ctrl-p
|
||
Druckt die aktuelle Seite aus. (Eröffnet Dialogfenster)
|
||
.It any Alt-Left / Alt-Right
|
||
Wechseln zum vorherigen/nächsten Tab
|
||
.It any F1
|
||
Zeigt Informationen über das Programm
|
||
.It any Alt-n
|
||
n ist eine Zahl. Wechseln zum Tab n. 0 wechselt zum letzten Tab.
|
||
.El
|
||
.Ss STANDARDTASTENKOMBINATIONEN
|
||
Im Folgenden befindet sich eine unvollständige Liste mit standartmäßigen
|
||
Webkit-/GTK-Tastenkombinationen:
|
||
.Bl -tag -width Ds
|
||
.It any Ctrl-PageUp / Ctrl-PageDown
|
||
Wechseln zum vorherigen/nächsten Tab
|
||
.It search Ctrl-g / Ctrl-Shift-g
|
||
Zum nächsten/vorherigen Suchtreffer gehen
|
||
.It search Escape
|
||
Bricht die Suche ab
|
||
.It textarea Ctrl-;
|
||
Emoji einfügen😚️
|
||
.El
|
||
.Sh UMGEBUNGSVARIABLEN
|
||
.Bl -tag -width Ds
|
||
.It Ev BADWOLF_L10N
|
||
Eine mit Doppelpunkten getrennte List im Format sprache_LAND wo die sprache
|
||
ISO-639 und das LAND ISO-3166 ist. Z.B.:
|
||
.Ic BADWOLF_L10N="en_GB:fr_FR:de_DE" .
|
||
Wenn diese Variable nicht gesetzt ist,
|
||
gibt es keine Rechtschreibprüfung. Der Variablenname könnte in der Zukunft
|
||
durch einen generischeren ersetzt werden.
|
||
.Pp
|
||
Um eine List mit installierten Sprächen zu bekommen, muss
|
||
.Ic enchant-lsmod-2 -list-dicts
|
||
ausgeführt werden. Bei Versionen vor enchant
|
||
2.0:
|
||
.Ic enchant-lsmod -list-dicts
|
||
.El
|
||
.Sh DATEIEN
|
||
Die im Folgenden aufgelistetene Pfade benutzen
|
||
.Xr sh 1
|
||
-Syntaxe, um der
|
||
XDG-Base-Directory-Specifation gerecht zu werden. Du kannst den Befehl
|
||
.Xr echo 1
|
||
benutzen, um zu gucken, wo das auf dem Computer ist.
|
||
.Pp
|
||
.Bl -tag -width Ds -compact
|
||
.It Pa ${XDG_CONFIG_HOME:-$HOME/.config}/badwolf/content-filters.json
|
||
WebKit-spezifischer Inhaltsfilter-Datei, mit der unerwünschte Inhalte
|
||
(z.B. Werbung, Schadsoftware, ...) geblockt werden können. Für mehr
|
||
Informationen, siehe:
|
||
.Lk https://webkit.org/blog/3476/content-blockers-first-look/
|
||
.Lk https://webkit.org/blog/4062/targeting-domains-with-content-blockers/
|
||
.Lk https://developer.apple.com/documentation/safariservices/creating_a_content_blocker
|
||
.Pp
|
||
Es gibt einen Übersetzer, der AdblockPlus-Filterlisten in Webkit-Blocklisten
|
||
übersetzen kann:
|
||
.Lk https://gitlab.com/eyeo/adblockplus/abp2blocklist
|
||
.Pp
|
||
Für eine fertige Datei (die regelmäßig aktualisiert werden sollte), siehe:
|
||
.Lk https://easylist-downloads.adblockplus.org/easylist_min_content_blocker.json
|
||
.It Pa ${XDG_CACHE_HOME:-$HOME/.cache}/badwolf/filters
|
||
Hier werden kompilierte Filter gespeichert. Diese Dateien werden automatisch
|
||
generiert und sollten deswegen nicht bearbeitet werden. Diese Datei wird
|
||
hier überhaupt nur dokumentiert, damit sie in Sandboxen/Zugriffskontrollen
|
||
eingearbeitet werden kann.
|
||
.It Pa ${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/bookmarks.xbel
|
||
XBEL (XML Bookmark Exchange Language) Datei, wird momentan unterstützt von:
|
||
.Xr elinks 1 ,
|
||
.Xr konqueror 1 ,
|
||
.Xr kbookmarkeditor 1 .
|
||
.Pp
|
||
Du kannst einfach eine Verknüpfung zu deren Dateien erstellen, aber
|
||
vielleicht möchtest du lieber
|
||
.Lk https://www.w3.org/TR/xinclude/ XInclude
|
||
benutzen, welches von
|
||
.Nm
|
||
systemeigen unterstützt wird und mehrer
|
||
XBEL-Dateien zusammenfügt.
|
||
.Pp
|
||
Außerdem werden die Lesezeicheneinträge nicht neusortiert, deswegen ist es
|
||
eventuell gewünscht, die am häufigsten genutzen Einträge an den Anfang der
|
||
Datei zu schieben.
|
||
.Pp
|
||
Für weitere Informationen über dieses Format siehe:
|
||
.Lk http://pyxml.sourceforge.net/topics/xbel/
|
||
.Pp
|
||
Für eine Beispiel-XBEL-Datei siehe:
|
||
.Lk https://hacktivis.me/bookmarks.xbel
|
||
.It Pa ${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/webkit-web-extension/
|
||
Verzeichnis mit den
|
||
.Lk https://webkitgtk.org/reference/webkit2gtk/stable/WebKitWebExtension.html WebKitWebExtensions
|
||
die in
|
||
.Nm geladen werden sollen. Hinweis: Es handelt sich dabei nicht um Javascript-basierte Erweitungen wie man sie von Firefox oder Chrome kennt, sondern um systemeigenen Code aus Shared Objects der WebKitGTK API.
|
||
.Pp
|
||
Für Beispiele nützlicher Erweiterungen siehe:
|
||
.Lk https://hacktivis.me/git/badwolf-extensions
|
||
.It Pa ${DATADIR:-/usr/local/share}/badwolf/interface.css
|
||
.It Pa ${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/interface.css
|
||
CSS-Dateien (jeweils System und User-Ebene), um das Aussehen das Interfaces
|
||
anzupassen. Siehe
|
||
.Lk https://docs.gtk.org/gtk3/css-properties.html
|
||
für die zur Verfügung stehen Eigenschaften.
|
||
.Pp
|
||
Für das Austesten eines Aussehens ist es zu empfehlen die Umgebungsvariable
|
||
.Ev GTK_DEBUG=interactive
|
||
biem Start zu setzen und dann in den CSS tab zu
|
||
gehen.
|
||
.It Pa ${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/scripts/
|
||
Verzeichnis, welches die JavaScript-Userscripts enthält (Dateiendung
|
||
.Ic .js ) ,
|
||
die am Start des Ladens jeder Seite ausgeführt werden und sich auch
|
||
in iframes verschachteln. Nützlich um Website-Verhalten zu manipulieren oder
|
||
fehlende Funktionen zu ergänzen.
|
||
.Pp
|
||
Es ist anzumerken, dass — anders als bei GreaseMonkey-artigen Userscripts —
|
||
die
|
||
.Nm
|
||
-Userscripts immer ausgeführt werden, unabhängig von
|
||
Hostname/URLs.
|
||
.El
|
||
.Sh AUTOREN.
|
||
.An Haelwenn (lanodan) Monnier Aq Mt contact+badwolf@hacktivis.me ,
|
||
Übersetzung von Ben Kaps
|
||
.Sh BUGS
|
||
Verbesserungen oder Fehlerberichte können unter
|
||
.Lk https://sr.ht/~lanodan/badwolf/
|
||
mit
|
||
.Xr git-send-email 1
|
||
für Patches eingereicht werden.
|