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
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
|
.\" BadWolf: Minimalist and privacy-oriented WebKitGTK+ browser
.\" Copyright © 2019-2022 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-04-06
.Dt GOODWOLF 1
.Os
.Sh NAME
.Nm goodwolf
.Nd navigateur minimaliste et orienté vie-privée basé sur WebKitGTK
.Sh SYNOPSIS
.Nm
.Op Ar options webkit/gtk
.Op Ar URLs or chemins
.Sh DESCRIPTION
.Nm
est un navigateur minimaliste 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
Une configuration dynamique spécifique à
.Nm
sera sans doute rajoutée
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-Maj-r / Ctrl-r, navigateur F5
Recharger le contenu dans l'onglet courant (avec/sans nettoyer le cache).
.It navigateur Échap
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-Gauche / Alt-Droite
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-Maj-g
Quand le champ de recherche est actif, aller au résultat précédent/suivant.
.It recherche Échap
Annule la recherche actuelle.
.El
.Sh ENVIRONMENT
.Bl -tag -width Ds
.It Ev GOODWOLF_L10N
A colon-separated list in the form lang_COUNTRY where lang is in ISO-639 and
COUNTRY in ISO-3166. For example
.Ic GOODWOLF_L10N="en_GB:fr_FR:de_DE" .
When this variable isn't set, spelling isn't activated. A more generic
variable name is also intended to be used in the future.
.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}/goodwolf/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 de filtres compatibles 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}/goodwolf/filters
Stockage des filtres compilés, les fichiers présents sont automatiquement
générés et ne doivent pas être édité.
Documenté ici seulement pour les isolations ou la gestion des contrôle
d'accès.
.It Pa ${XDG_DATA_HOME:-$HOME/.local/share}/goodwolf/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 depuisleurs 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}/goodwolf/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/goodwolf-extensions
.It Pa ${DATADIR:-/usr/local/share}/goodwolf/interface.css
.It Pa ${XDG_DATA_HOME:-$HOME/.local/share}/goodwolf/interface.css
.\" GNOME can't even into doing any redirections of the few docs available
Fichiers CSS (respectivement système et utilisateur) pour changer le style
de l'interface de
.Nm .
Voir
.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+goodwolf@hacktivis.me
.Sh BUGS
Vous pouvez soumettre des contributions ou des tickets à
.Lk https://sr.ht/~lanodan/goodwolf/
avec
.Xr git-send-email 1
pour les modifications.
|