190 lines
6.9 KiB
Groff
Executable file
190 lines
6.9 KiB
Groff
Executable file
.\" 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 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 vueweb Ctrl-SourisPremier, vueweb SourisMilieu
|
|
Ouvrir le lien sélectionné dans un nouvel onglet. (Note: JS modifie
|
|
quand-même l'action)
|
|
.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.
|
|
.It champ-texte Ctrl-;
|
|
Insérer un Émoji
|
|
.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 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}/badwolf/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}/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 .
|
|
.Pp
|
|
Vous pouvez faire un lien symbolique depuis leur fichiers, mais vous pouvez
|
|
aussi utiliser
|
|
.Lk https://www.w3.org/TR/xinclude/ XInclude
|
|
qui est supporté nativement par
|
|
.Nm
|
|
pour automatiquement fusionner
|
|
plusieurs fichiers XBEL.
|
|
.Pp
|
|
Aussi les marques-pages ne sont pas re-triés, vous pouvez donc mettre les
|
|
plus fréquement utilisés au début du fichier.
|
|
.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
|
|
.Lk https://docs.gtk.org/gtk3/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.
|
|
.It Pa ${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/scripts/
|
|
Dossier contenant les userscripts JavaScript (finisant en
|
|
.Ic .js )
|
|
lancés
|
|
à chaque chargement de page, descendant dans les iframes, utile pour changer
|
|
le comportement ou rajouter des fonctionalitées aux sites web.
|
|
.Pp
|
|
Veuillez noter que pour l'instant, contrairement aux userscripts à la
|
|
GreaseMonkey, ils sont toujours exécutés, sans filtrage de domaines / URLs.
|
|
.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.
|