1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
|
.\" BadWolf: Minimalist and privacy-oriented WebKitGTK+ browser
.\" Copyright © 2019-2022 Badwolf Authors <https://hacktivis.me/projects/badwolf>
.\" SPDX-License-Identifier: BSD-3-Clause
.Dd 2022-04-06
.Dt BADWOLF 1
.Os
.Sh NAME
.Nm badwolf
.Nd navigateur minimaliste et orienté vie-privée basé sur WebKitGTK
.Sh SYNOPSIS
.Nm
.Op Ar options webkit/gtk
.Op Ar URLs ou chemins
.Sh DESCRIPTION
.Nm
est un navigateur minimalist qui prend soin de la vie privée, c'est basé WebKitGTK et accept donc les options et variables d'environements de WebKitGTK et ses dépendances, malheuresement il ne semble pas avoir de pages de man pour celles-ci.
.Pp
Un configuration dynamique spécifique à
.Nm
sera sans doute rajouté dans une version suivante.
.Sh RACCOURCIS
Cette section liste les raccourcis et leurs actions, chaque point est décris avec le widget actif ou avec
.Aq tout
quand il fonctionne sur la fenêtre entière, suivit par le raccourcis.
.Bl -tag -width Ds
.It vueweb Ctrl-Défilement
(Dé)-Grossir le zoom de la page.
.It vueweb Ctrl-0
Remettre le zoom de la page à 100%.
.It tout Ctrl-t
Créer un nouvel onglet (dans une nouvelle session, comme un apuis sur le bouton dédié)
.It navigateur Ctrl-F4, navigateur Alt-d
Fermer l'onglet courant.
.It navigateur Ctrl-f
Aller dans le champ de recherche.
.It navigateur Ctrl-l
Aller dans la barre d'URL.
.It navigateur Ctrl-Shift-r / Ctrl-r, navigateur F5
Recharger le contenu dans l'onglet courant (avec/sans nettoyer le cache).
.It navigateur Escape
Arrêter le chargement dans l'onglet courant.
.It navigateur F7
(Dé)-Activer la navigation par curseur.
.It navigateur F12
Ouvrir les outils de dévelopement.
.It navigateur Ctrl-[ / Ctrl-]
Naviguer dans l'historique courrant précédent/suivant.
.It navigateur Ctrl-p
Imprimer la page courante. (ouvre une nouvelle fenêtre)
.It tout Alt-Left / Alt-Right
Aller à l'onglet précédent/suivant.
.It tout F1
Montrer la fenêtre d'À Propos.
.It tout Alt-n
Où n est n'importe quelle touche de la barre numérique.
Aller à l'onglet n, 0 va au dernier.
.El
.Ss PAR DÉFAULTS
Ceci est une liste incomplète des raccourcis par défaults dans WebKit/GTK:
.Bl -tag -width Ds
.It tout Ctrl-PageUp / Ctrl-PageDown
Aller à l'onglet précédent/suivant.
.It recherche Ctrl-g / Ctrl-Shift-g
Quand le champ de recherche est actif, aller au résultat précédent/suivant.
.It recherche Escape
Annule la recherche actuelle.
.El
.Sh ENVIRONMENT
.Bl -tag -width Ds
.It Ev BADWOLF_L10N
Une liste séparé par des deux-points dans le format langue_PAYS où la langue est en ISO-639 et le PAYS en ISO-3166.
Par example
.Ic BADWOLF_L10N="en_GB:fr_FR:de_DE" .
Quand cette variable n'est pas configuré, la correction orthographique est désactivée.
Un nom plus générique est voulu pour le futur.
.Pp
Pour avoir la liste des dictionaires installés, executez:
.Ic enchant-lsmod-2 -list-dicts
ou avant enchant 2.0:
.Ic enchant-lsmod -list-dicts
.El
.Sh FICHIERS
Les chemins suivants utilisent la syntaxe de
.Xr sh 1
pour correctement supporter la XDG Base Directory Specification, vous pouver utiliser la commande
.Xr echo 1
pour vérifier où cela se trouve sur votre système.
.Pp
.Bl -tag -width Ds -compact
.It Pa ${XDG_CONFIG_HOME:-$HOME/.config}/badwolf/content-filters.json
Fichier content-filter spécifique à WebKit, cela permet de blocker le contenu indésirable (pubs, nagware, …)
Pour une introduction au format, voir (en anglais):
.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
Pour un convertiseur qui utilise les filtres style-AdBlockPlus, essayez:
.Lk https://gitlab.com/eyeo/adblockplus/abp2blocklist
.Pp
Pour un fichier prêt à l'usage (que vous devrez mettre à jour périodiquement), essayez:
.Lk https://easylist-downloads.adblockplus.org/easylist_min_content_blocker.json
.It Pa ${XDG_CACHE_HOME:-$HOME/.cache}/badwolf/filters
Là où les filtres compilé sont stockés, les fichiers présents sont automatiquement générés et ne devrait pas être édité.
Documenté ici seulement pour des raisons d'isolation ou de contrôle d'accès.
.It Pa ${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/bookmarks.xbel
Fichier XBEL (XML Bookmark Exchange Language; Language XML d'Échange de Marques-Pages), connu pour être supporté par:
.Xr elinks 1 ,
.Xr konqueror 1 ,
.Xr kbookmarkeditor 1 . Faire un lien symbolique depuis leurs chemins fonctionne mais vous pouvez aussi utiliser des XInclude pour fusionner plusieurs fichiers XBEL.
.Pp
Pour plus d'information à propos du format, voir (en anglais):
.Lk http://pyxml.sourceforge.net/topics/xbel/
.Pp
Pour un example de fichier XBEL voir:
.Lk https://hacktivis.me/bookmarks.xbel
.It Pa ${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/webkit-web-extension/
Répertoire contenant les
.Lk https://webkitgtk.org/reference/webkit2gtk/stable/WebKitWebExtension.html WebKitWebExtensions
pour être chargés dans
.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.
.Pp
Des examples de quelques extensions utiles peuvent être trouvés sur:
.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
Fichiers CSS (respectivement système et utilisateur) pour changer le style de l'interface de
.Nm .
Voir
.\" GNOME can't even into doing any redirections of the few docs available
.Lk http://web.archive.org/web/20210420214617/https://developer.gnome.org/gtk3/stable/chap-css-properties.html
pour la liste des propriétés disponibles.
.Pp
Pour tester les styles je recommende d'utiliser la variable d'environemnt
.Ev GTK_DEBUG=interactive
et d'aller à l'onglet CSS.
.El
.Sh AUTHORS
.An Haelwenn (lanodan) Monnier Aq Mt contact+badwolf@hacktivis.me
.Sh BUGS
Vous pouvez soumettre des contributions ou des tickets à
.Lk https://sr.ht/~lanodan/badwolf
avec
.Xr git-send-email 1 pour les modifications.
|