.\" BadWolf: Minimalist and privacy-oriented WebKitGTK+ browser .\" Copyright © 2019-2023 Badwolf Authors .\" 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.