190 lines
7 KiB
Groff
190 lines
7 KiB
Groff
|
.\" 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.
|