badwolf

commit: caf0a4d2cd39f87c9e1bc21338d5682c43d9126e
parent e6fefba7e080b9674f4149db4f75ceb4565b296d
Author: Haelwenn (lanodan) Monnier <contact@hacktivis.me>
Date:   Tue, 19 Sep 2023 07:53:46 +0200

badwolf.de.1: Bundle

Diffstat:
A
badwolf.de.1
189
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

1 file changed, 189 insertions(+), 0 deletions(-)
diff --git a/badwolf.de.1 b/badwolf.de.1
@@ -0,0 +1,189 @@
+.\" 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.