logo

badwolf

minimalist and privacy-oriented web browser based on WebKitGTK git clone https://hacktivis.me/git/badwolf.git

badwolf.de.1 (7212B)

    

  1. .\" BadWolf: Minimalist and privacy-oriented WebKitGTK+ browser
  2. .\" Copyright © 2019-2023 Badwolf Authors <https://hacktivis.me/projects/badwolf>
  3. .\" SPDX-License-Identifier: BSD-3-Clause
  4. .\"*******************************************************************
  5. .\"
  6. .\" This file was generated with po4a. Translate the source file.
  7. .\"
  8. .\"*******************************************************************
  9. .Dd 2022-07-13
  10. .Dt BADWOLF 1
  11. .Os
  12. .Sh NAME
  13. .Nm badwolf
  14. .Nd minimalistischer und privatsphäre-orientierter Webbrowser basierend auf WebKitGTK
  15. .Sh ÜBERSICHT
  16. .Nm
  17. .Op Ar WebKit-/GTK-Optionen
  18. .Op Ar URLs oder Pfade
  19. .Sh BESCHREIBUNG
  20. .Nm
  21. ist ein minimalistischer Webbrowser, der die Privatssphäre seiner
  22. Nutzer respektiert. Er basiert auf WebKitGTK und akzeptiert daher alle
  23. Optionen und Umgebungsvariablen, die WebKitGTK (und Abhängigkeiten) auch
  24. akzeptieren, leider gibt es dafür keine Manpages.
  25. .Pp
  26. Laufzeitspezifische Konfigurationsmöglichkeiten für
  27. .Nm
  28. werden
  29. wahrscheinlich in einer späteren Version hinzugefügt.
  30. .Sh TASTENKOMBINATIONEN
  31. Der folgende Abschnitt listet die unterstützten Tastenkombinationen und ihre
  32. Funktionen auf. Vor jeder Tastenkombination steht der greifende Kontext.
  33. .Bl -tag -width Ds
  34. .It webview Ctrl-Scroll
  35. Zoomt die Website rein/raus.
  36. .It webview Ctrl-0
  37. Setzt den Zoom auf 100% zurück.
  38. .It webview Ctrl-MousePrimary, webview MouseMiddle
  39. Öffnet den hervorgehobenen Link in einem neuen Tab. (Hinweis: Dieses
  40. Verhalten kann mit Javascript manipuliert werden)
  41. .It any Ctrl-t
  42. Eröffnet einen neuen Tab in einer neuen Sitzung (ähnlich wie der "Neuer
  43. Tab"-Knopf)
  44. .It browser Ctrl-F4, browser Alt-d
  45. Schließt den aktuellen Tab
  46. .It browser Ctrl-f
  47. Hebt das Suchfeld hervor
  48. .It browser Ctrl-l
  49. Hebt die Addresszeile hervor
  50. .It browser Ctrl-Shift-r / Ctrl-r, browser F5
  51. Lädt den aktuellen Tab neu (jeweils mit und ohne den Cache zu leeren)
  52. .It browser Escape
  53. Bricht das Laden ab
  54. .It browser F7
  55. Aktiviert den Tastaturmodus (Navigation mit dem Textcursor)
  56. .It browser F12
  57. Öffnet die Entwickleroptionen
  58. .It browser Ctrl-[ / Ctrl-]
  59. Zur vorherigen/nächsten Seite im Suchverlauf gehen
  60. .It browser Ctrl-p
  61. Druckt die aktuelle Seite aus. (Eröffnet Dialogfenster)
  62. .It any Alt-Left / Alt-Right
  63. Wechseln zum vorherigen/nächsten Tab
  64. .It any F1
  65. Zeigt Informationen über das Programm
  66. .It any Alt-n
  67. n ist eine Zahl. Wechseln zum Tab n. 0 wechselt zum letzten Tab.
  68. .El
  69. .Ss STANDARDTASTENKOMBINATIONEN
  70. Im Folgenden befindet sich eine unvollständige Liste mit standartmäßigen
  71. Webkit-/GTK-Tastenkombinationen:
  72. .Bl -tag -width Ds
  73. .It any Ctrl-PageUp / Ctrl-PageDown
  74. Wechseln zum vorherigen/nächsten Tab
  75. .It search Ctrl-g / Ctrl-Shift-g
  76. Zum nächsten/vorherigen Suchtreffer gehen
  77. .It search Escape
  78. Bricht die Suche ab
  79. .It textarea Ctrl-;
  80. Emoji einfügen😚️
  81. .El
  82. .Sh UMGEBUNGSVARIABLEN
  83. .Bl -tag -width Ds
  84. .It Ev BADWOLF_L10N
  85. Eine mit Doppelpunkten getrennte List im Format sprache_LAND wo die sprache
  86. ISO-639 und das LAND ISO-3166 ist. Z.B.:
  87. .Ic BADWOLF_L10N="en_GB:fr_FR:de_DE" .
  88. Wenn diese Variable nicht gesetzt ist,
  89. gibt es keine Rechtschreibprüfung. Der Variablenname könnte in der Zukunft
  90. durch einen generischeren ersetzt werden.
  91. .Pp
  92. Um eine List mit installierten Sprächen zu bekommen, muss
  93. .Ic enchant-lsmod-2 -list-dicts
  94. ausgeführt werden. Bei Versionen vor enchant
  95. 2.0:
  96. .Ic enchant-lsmod -list-dicts
  97. .El
  98. .Sh DATEIEN
  99. Die im Folgenden aufgelistetene Pfade benutzen
  100. .Xr sh 1
  101. -Syntaxe, um der
  102. XDG-Base-Directory-Specifation gerecht zu werden. Du kannst den Befehl
  103. .Xr echo 1
  104. benutzen, um zu gucken, wo das auf dem Computer ist.
  105. .Pp
  106. .Bl -tag -width Ds -compact
  107. .It Pa ${XDG_CONFIG_HOME:-$HOME/.config}/badwolf/content-filters.json
  108. WebKit-spezifischer Inhaltsfilter-Datei, mit der unerwünschte Inhalte
  109. (z.B. Werbung, Schadsoftware, ...) geblockt werden können. Für mehr
  110. Informationen, siehe:
  111. .Lk https://webkit.org/blog/3476/content-blockers-first-look/
  112. .Lk https://webkit.org/blog/4062/targeting-domains-with-content-blockers/
  113. .Lk https://developer.apple.com/documentation/safariservices/creating_a_content_blocker
  114. .Pp
  115. Es gibt einen Übersetzer, der AdblockPlus-Filterlisten in Webkit-Blocklisten
  116. übersetzen kann:
  117. .Lk https://gitlab.com/eyeo/adblockplus/abp2blocklist
  118. .Pp
  119. Für eine fertige Datei (die regelmäßig aktualisiert werden sollte), siehe:
  120. .Lk https://easylist-downloads.adblockplus.org/easylist_min_content_blocker.json
  121. .It Pa ${XDG_CACHE_HOME:-$HOME/.cache}/badwolf/filters
  122. Hier werden kompilierte Filter gespeichert. Diese Dateien werden automatisch
  123. generiert und sollten deswegen nicht bearbeitet werden. Diese Datei wird
  124. hier überhaupt nur dokumentiert, damit sie in Sandboxen/Zugriffskontrollen
  125. eingearbeitet werden kann.
  126. .It Pa ${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/bookmarks.xbel
  127. XBEL (XML Bookmark Exchange Language) Datei, wird momentan unterstützt von:
  128. .Xr elinks 1 ,
  129. .Xr konqueror 1 ,
  130. .Xr kbookmarkeditor 1 .
  131. .Pp
  132. Du kannst einfach eine Verknüpfung zu deren Dateien erstellen, aber
  133. vielleicht möchtest du lieber
  134. .Lk https://www.w3.org/TR/xinclude/ XInclude
  135. benutzen, welches von
  136. .Nm
  137. systemeigen unterstützt wird und mehrer
  138. XBEL-Dateien zusammenfügt.
  139. .Pp
  140. Außerdem werden die Lesezeicheneinträge nicht neusortiert, deswegen ist es
  141. eventuell gewünscht, die am häufigsten genutzen Einträge an den Anfang der
  142. Datei zu schieben.
  143. .Pp
  144. Für weitere Informationen über dieses Format siehe:
  145. .Lk http://pyxml.sourceforge.net/topics/xbel/
  146. .Pp
  147. Für eine Beispiel-XBEL-Datei siehe:
  148. .Lk https://hacktivis.me/bookmarks.xbel
  149. .It Pa ${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/webkit-web-extension/
  150. Verzeichnis mit den
  151. .Lk https://webkitgtk.org/reference/webkit2gtk/stable/WebKitWebExtension.html WebKitWebExtensions
  152. die in
  153. .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.
  154. .Pp
  155. Für Beispiele nützlicher Erweiterungen siehe:
  156. .Lk https://hacktivis.me/git/badwolf-extensions
  157. .It Pa ${DATADIR:-/usr/local/share}/badwolf/interface.css
  158. .It Pa ${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/interface.css
  159. CSS-Dateien (jeweils System und User-Ebene), um das Aussehen das Interfaces
  160. anzupassen. Siehe
  161. .Lk https://docs.gtk.org/gtk3/css-properties.html
  162. für die zur Verfügung stehen Eigenschaften.
  163. .Pp
  164. Für das Austesten eines Aussehens ist es zu empfehlen die Umgebungsvariable
  165. .Ev GTK_DEBUG=interactive
  166. biem Start zu setzen und dann in den CSS tab zu
  167. gehen.
  168. .It Pa ${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/scripts/
  169. Verzeichnis, welches die JavaScript-Userscripts enthält (Dateiendung
  170. .Ic .js ) ,
  171. die am Start des Ladens jeder Seite ausgeführt werden und sich auch
  172. in iframes verschachteln. Nützlich um Website-Verhalten zu manipulieren oder
  173. fehlende Funktionen zu ergänzen.
  174. .Pp
  175. Es ist anzumerken, dass — anders als bei GreaseMonkey-artigen Userscripts —
  176. die
  177. .Nm
  178. -Userscripts immer ausgeführt werden, unabhängig von
  179. Hostname/URLs.
  180. .El
  181. .Sh AUTOREN.
  182. .An Haelwenn (lanodan) Monnier Aq Mt contact+badwolf@hacktivis.me ,
  183. Übersetzung von Ben Kaps
  184. .Sh BUGS
  185. Verbesserungen oder Fehlerberichte können unter
  186. .Lk https://sr.ht/~lanodan/badwolf/
  187. mit
  188. .Xr git-send-email 1
  189. für Patches eingereicht werden.