logo

badwolf

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

badwolf.fr.1 (7076B)

    

  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 navigateur minimaliste et orienté vie-privée basé sur WebKitGTK
  15. .Sh SYNOPSIS
  16. .Nm
  17. .Op Ar options webkit/gtk
  18. .Op Ar URLs or chemins
  19. .Sh DESCRIPTION
  20. .Nm
  21. est un navigateur minimaliste qui prend soin de la vie privée, c'est
  22. basé WebKitGTK et accept donc les options et variables d'environements de
  23. WebKitGTK et ses dépendances, malheuresement il ne semble pas avoir de pages
  24. de man pour celles-ci.
  25. .Pp
  26. Une configuration dynamique spécifique à
  27. .Nm
  28. sera sans doute rajoutée
  29. dans une version suivante.
  30. .Sh RACCOURCIS
  31. Cette section liste les raccourcis et leurs actions, chaque point est décris
  32. avec le widget actif ou avec
  33. .Aq tout
  34. quand il fonctionne sur la fenêtre
  35. entière, suivit par le raccourcis.
  36. .Bl -tag -width Ds
  37. .It vueweb Ctrl-Défilement
  38. (Dé)-Grossir le zoom de la page.
  39. .It vueweb Ctrl-0
  40. Remettre le zoom de la page à 100%.
  41. .It vueweb Ctrl-SourisPremier, vueweb SourisMilieu
  42. Ouvrir le lien sélectionné dans un nouvel onglet. (Note: JS modifie
  43. quand-même l'action)
  44. .It tout Ctrl-t
  45. Créer un nouvel onglet (dans une nouvelle session, comme un apuis sur le
  46. bouton dédié)
  47. .It navigateur Ctrl-F4, navigateur Alt-d
  48. Fermer l'onglet courant.
  49. .It navigateur Ctrl-f
  50. Aller dans le champ de recherche.
  51. .It navigateur Ctrl-l
  52. Aller dans la barre d'URL.
  53. .It navigateur Ctrl-Maj-r / Ctrl-r, navigateur F5
  54. Recharger le contenu dans l'onglet courant (avec/sans nettoyer le cache).
  55. .It navigateur Échap
  56. Arrêter le chargement dans l'onglet courant.
  57. .It navigateur F7
  58. (Dé)-Activer la navigation par curseur.
  59. .It navigateur F12
  60. Ouvrir les outils de dévelopement.
  61. .It navigateur Ctrl-[ / Ctrl-]
  62. Naviguer dans l'historique courrant précédent/suivant.
  63. .It navigateur Ctrl-p
  64. Imprimer la page courante. (ouvre une nouvelle fenêtre)
  65. .It tout Alt-Gauche / Alt-Droite
  66. Aller à l'onglet précédent/suivant.
  67. .It tout F1
  68. Montrer la fenêtre d'À Propos.
  69. .It tout Alt-n
  70. Où n est n'importe quelle touche de la barre numérique.
  71. Aller à l'onglet n, 0 va au dernier.
  72. .El
  73. .Ss PAR DÉFAULTS
  74. Ceci est une liste incomplète des raccourcis par défaults dans WebKit/GTK:
  75. .Bl -tag -width Ds
  76. .It tout Ctrl-PageUp / Ctrl-PageDown
  77. Aller à l'onglet précédent/suivant.
  78. .It recherche Ctrl-g / Ctrl-Maj-g
  79. Quand le champ de recherche est actif, aller au résultat précédent/suivant.
  80. .It recherche Échap
  81. Annule la recherche actuelle.
  82. .It champ-texte Ctrl-;
  83. Insérer un Émoji
  84. .El
  85. .Sh ENVIRONMENT
  86. .Bl -tag -width Ds
  87. .It Ev BADWOLF_L10N
  88. Une liste séparé par des deux-points dans le format langue_PAYS où la langue
  89. est en ISO-639 et le PAYS en ISO-3166.
  90. Par example
  91. .Ic BADWOLF_L10N="en_GB:fr_FR:de_DE" .
  92. Quand cette variable n'est pas configuré, la correction orthographique est
  93. désactivée.
  94. Un nom plus générique est voulu pour le futur.
  95. .Pp
  96. Pour avoir la liste des dictionaires installés, executez:
  97. .Ic enchant-lsmod-2 -list-dicts
  98. ou avant enchant 2.0:
  99. .Ic enchant-lsmod -list-dicts
  100. .El
  101. .Sh FICHIERS
  102. Les chemins suivants utilisent la syntaxe de
  103. .Xr sh 1
  104. pour correctement
  105. supporter la XDG Base Directory Specification, vous pouver utiliser la
  106. commande
  107. .Xr echo 1
  108. pour vérifier où cela se trouve sur votre système.
  109. .Pp
  110. .Bl -tag -width Ds -compact
  111. .It Pa ${XDG_CONFIG_HOME:-$HOME/.config}/badwolf/content-filters.json
  112. Fichier content-filter spécifique à WebKit, cela permet de blocker le
  113. contenu indésirable (pubs, nagware, …).
  114. Pour une introduction au format, voir (en anglais):
  115. .Lk https://webkit.org/blog/3476/content-blockers-first-look/
  116. .Lk https://webkit.org/blog/4062/targeting-domains-with-content-blockers/
  117. .Lk https://developer.apple.com/documentation/safariservices/creating_a_content_blocker
  118. .Pp
  119. Pour un convertiseur de filtres compatibles AdBlockPlus, essayez:
  120. .Lk https://gitlab.com/eyeo/adblockplus/abp2blocklist
  121. .Pp
  122. Pour un fichier prêt à l'usage (que vous devrez mettre à jour
  123. périodiquement), essayez:
  124. .Lk https://easylist-downloads.adblockplus.org/easylist_min_content_blocker.json
  125. .It Pa ${XDG_CACHE_HOME:-$HOME/.cache}/badwolf/filters
  126. Stockage des filtres compilés, les fichiers présents sont automatiquement
  127. générés et ne doivent pas être édité.
  128. Documenté ici seulement pour les isolations ou la gestion des contrôle
  129. d'accès.
  130. .It Pa ${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/bookmarks.xbel
  131. Fichier XBEL (XML Bookmark Exchange Language; Language XML d'Échange de
  132. Marques-Pages), connu pour être supporté par:
  133. .Xr elinks 1 ,
  134. .Xr konqueror 1 ,
  135. .Xr kbookmarkeditor 1 .
  136. .Pp
  137. Vous pouvez faire un lien symbolique depuis leur fichiers, mais vous pouvez
  138. aussi utiliser
  139. .Lk https://www.w3.org/TR/xinclude/ XInclude
  140. qui est supporté nativement par
  141. .Nm
  142. pour automatiquement fusionner
  143. plusieurs fichiers XBEL.
  144. .Pp
  145. Aussi les marques-pages ne sont pas re-triés, vous pouvez donc mettre les
  146. plus fréquement utilisés au début du fichier.
  147. .Pp
  148. Pour plus d'information à propos du format, voir (en anglais):
  149. .Lk http://pyxml.sourceforge.net/topics/xbel/
  150. .Pp
  151. Pour un example de fichier XBEL voir:
  152. .Lk https://hacktivis.me/bookmarks.xbel
  153. .It Pa ${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/webkit-web-extension/
  154. Répertoire contenant les
  155. .Lk https://webkitgtk.org/reference/webkit2gtk/stable/WebKitWebExtension.html WebKitWebExtensions
  156. pour être chargés dans
  157. .Nm . Note\ : Ce ne sont pas les Web-Extensions basé sur JavaScript et supporté par Firefox ou Chrome, mais du code natif dans des shared objects qui utilisent l'API WebKitGTK.
  158. .Pp
  159. Des examples de quelques extensions utiles peuvent être trouvés sur:
  160. .Lk https://hacktivis.me/git/badwolf-extensions
  161. .It Pa ${DATADIR:-/usr/local/share}/badwolf/interface.css
  162. .It Pa ${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/interface.css
  163. Fichiers CSS (respectivement système et utilisateur) pour changer le style
  164. de l'interface de
  165. .Nm .
  166. Voir
  167. .Lk https://docs.gtk.org/gtk3/css-properties.html
  168. pour la liste des propriétés disponibles.
  169. .Pp
  170. Pour tester les styles je recommende d'utiliser la variable d'environemnt
  171. .Ev GTK_DEBUG=interactive
  172. et d'aller à l'onglet CSS.
  173. .It Pa ${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/scripts/
  174. Dossier contenant les userscripts JavaScript (finisant en
  175. .Ic .js )
  176. lancés
  177. à chaque chargement de page, descendant dans les iframes, utile pour changer
  178. le comportement ou rajouter des fonctionalitées aux sites web.
  179. .Pp
  180. Veuillez noter que pour l'instant, contrairement aux userscripts à la
  181. GreaseMonkey, ils sont toujours exécutés, sans filtrage de domaines / URLs.
  182. .El
  183. .Sh AUTHORS
  184. .An Haelwenn (lanodan) Monnier Aq Mt contact+badwolf@hacktivis.me
  185. .Sh BUGS
  186. Vous pouvez soumettre des contributions ou des tickets à
  187. .Lk https://sr.ht/~lanodan/badwolf/
  188. avec
  189. .Xr git-send-email 1
  190. pour les modifications.