commit: 4e4f3e781b4cda7893767ce287e69c4f6bcba5a2
parent e1aa749c560b922709902cbcf37d9abf15d6d2ed
Author: Haelwenn (lanodan) Monnier <contact@hacktivis.me>
Date: Wed, 6 Apr 2022 18:41:50 +0200
badwolf.fr.1: Introduce translated manpage
Diffstat:
| M | Makefile | 6 | +++++- |
| A | badwolf.fr.1 | 143 | +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
2 files changed, 148 insertions(+), 1 deletion(-)
diff --git a/Makefile b/Makefile
@@ -11,6 +11,7 @@ OBJS_test = fmt_test.o uri_test.o bookmarks_test.o
EXE = badwolf
EXE_test = fmt_test uri_test bookmarks_test
TRANS = fr.mo pt_BR.mo tr.mo de.mo vi.mo
+TRANS_MAN = badwolf.fr.1
DOCS = usr.bin.badwolf README.md KnowledgeBase.md interface.txt
all: config.mk $(EXE) $(TRANS) po/messages.pot
@@ -66,7 +67,7 @@ test: $(EXE_test)
.PHONY: lint
lint:
- $(MANDOC) -Tlint -Wunsupp,error,warning ./badwolf.1
+ $(MANDOC) -Tlint -Wunsupp,error,warning ./badwolf.1 $(TRANS_MAN)
$(SHELLCHECK) ./configure
$(FLAWFINDER) .
@@ -76,6 +77,9 @@ install: all
cp -p badwolf $(DESTDIR)$(BINDIR)/
mkdir -p $(DESTDIR)$(MANDIR)/man1
cp -p badwolf.1 $(DESTDIR)$(MANDIR)/man1/
+ # TODO: use $TRANS_MAN
+ mkdir -p $(DESTDIR)$(MANDIR)/fr/man1
+ cp -p badwolf.fr.1 $(DESTDIR)$(MANDIR)/fr/man1/badwolf.1
mkdir -p $(DESTDIR)$(DATADIR)/locale
cp -r locale/ $(DESTDIR)$(DATADIR)/
cp interface.css $(DESTDIR)$(DATADIR)/
diff --git a/badwolf.fr.1 b/badwolf.fr.1
@@ -0,0 +1,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.
