BADWOLF(1)

NAME
badwolf - navigateur minimaliste et orienté vie-privée basé sur WebKitGTK

SYNOPSIS
badwolf [options webkit/gtk] [URLs or chemins]

DESCRIPTION
badwolf 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.

Une configuration dynamique spécifique à badwolf sera sans doute rajoutée dans une version suivante.

RACCOURCIS
Cette section liste les raccourcis et leurs actions, chaque point est décris avec le widget actif ou avec <tout> quand il fonctionne sur la fenêtre entière, suivit par le raccourcis.

vueweb Ctrl-Défilement
    (Dé)-Grossir le zoom de la page.

vueweb Ctrl-0
    Remettre le zoom de la page à 100%.

vueweb Ctrl-SourisPremier, vueweb SourisMilieu
    Ouvrir le lien sélectionné dans un nouvel onglet. (Note: JS modifie quand-même l'action)

tout Ctrl-t
    Créer un nouvel onglet (dans une nouvelle session, comme un apuis sur le bouton dédié)

navigateur Ctrl-F4, navigateur Alt-d
    Fermer l'onglet courant.

navigateur Ctrl-f
    Aller dans le champ de recherche.

navigateur Ctrl-l
    Aller dans la barre d'URL.

navigateur Ctrl-Maj-r / Ctrl-r, navigateur F5
    Recharger le contenu dans l'onglet courant (avec/sans nettoyer le cache).

navigateur Échap
    Arrêter le chargement dans l'onglet courant.

navigateur F7
    (Dé)-Activer la navigation par curseur.

navigateur F12
    Ouvrir les outils de dévelopement.

navigateur Ctrl-[ / Ctrl-]
    Naviguer dans l'historique courrant précédent/suivant.

navigateur Ctrl-p
    Imprimer la page courante. (ouvre une nouvelle fenêtre)

tout Alt-Gauche / Alt-Droite
    Aller à l'onglet précédent/suivant.

tout F1
    Montrer la fenêtre d'À Propos.

tout Alt-n
    Où n est n'importe quelle touche de la barre numérique. Aller à l'onglet n, 0 va au dernier.

  PAR DÉFAULTS
Ceci est une liste incomplète des raccourcis par défaults dans WebKit/GTK:

tout Ctrl-PageUp / Ctrl-PageDown
    Aller à l'onglet précédent/suivant.

recherche Ctrl-g / Ctrl-Maj-g
    Quand le champ de recherche est actif, aller au résultat précédent/suivant.

recherche Échap
    Annule la recherche actuelle.

champ-texte Ctrl-;
    Insérer un Émoji

ENVIRONMENT

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 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.

    Pour avoir la liste des dictionaires installés, executez: enchant-lsmod-2 -list-dicts ou avant enchant 2.0: enchant-lsmod -list-dicts

FICHIERS
Les chemins suivants utilisent la syntaxe de sh(1) pour correctement supporter la XDG Base Directory Specification, vous pouver utiliser la commande echo(1) pour vérifier où cela se trouve sur votre système.

${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): https://webkit.org/blog/3476/content-blockers-first-look/ https://webkit.org/blog/4062/targeting-domains-with-content-blockers/ https://developer.apple.com/documentation/safariservices/creating_a_content_blocker

    Pour un convertiseur de filtres compatibles AdBlockPlus, essayez: https://gitlab.com/eyeo/adblockplus/abp2blocklist

    Pour un fichier prêt à l'usage (que vous devrez mettre à jour périodiquement), essayez: https://easylist-downloads.adblockplus.org/easylist_min_content_blocker.json
${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.
${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: elinks(1), konqueror(1), kbookmarkeditor(1).

    Vous pouvez faire un lien symbolique depuis leur fichiers, mais vous pouvez aussi utiliser XInclude: https://www.w3.org/TR/xinclude/ qui est supporté nativement par badwolf pour automatiquement fusionner plusieurs fichiers XBEL.

    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.

    Pour plus d'information à propos du format, voir (en anglais): http://pyxml.sourceforge.net/topics/xbel/

    Pour un example de fichier XBEL voir: https://hacktivis.me/bookmarks.xbel
${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/webkit-web-extension/
    Répertoire contenant les WebKitWebExtensions: https://webkitgtk.org/reference/webkit2gtk/stable/WebKitWebExtension.html pour être chargés dans. 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.

    Des examples de quelques extensions utiles peuvent être trouvés sur: https://hacktivis.me/git/badwolf-extensions
${DATADIR:-/usr/local/share}/badwolf/interface.css
${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/interface.css
    Fichiers CSS (respectivement système et utilisateur) pour changer le style de l'interface de badwolf. Voir https://docs.gtk.org/gtk3/css-properties.html pour la liste des propriétés disponibles.

    Pour tester les styles je recommende d'utiliser la variable d'environemnt GTK_DEBUG=interactive et d'aller à l'onglet CSS.
${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/scripts/
    Dossier contenant les userscripts JavaScript (finisant en .js) lancés à chaque chargement de page, descendant dans les iframes, utile pour changer le comportement ou rajouter des fonctionalitées aux sites web.

    Veuillez noter que pour l'instant, contrairement aux userscripts à la GreaseMonkey, ils sont toujours exécutés, sans filtrage de domaines / URLs.

AUTHORS
Haelwenn (lanodan) Monnier <contact+badwolf@hacktivis.me>

BUGS
Vous pouvez soumettre des contributions ou des tickets à https://sr.ht/~lanodan/badwolf/ avec git-send-email(1) pour les modifications.