.\" BadWolf: Minimalist and privacy-oriented WebKitGTK+ browser .\" Copyright © 2019-2023 Badwolf Authors .\" 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.