Leverage po4a to translate manpages

1 files changed, 178 insertions, 0 deletions

diff --git a/doc/git-permalink.fr.1 b/doc/git-permalink.fr.1
new file mode 100644
index 0000000..8c8c6d8
--- /dev/null
+++ b/doc/git-permalink.fr.1
@@ -0,0 +1,178 @@
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH GIT\-PERMALINK 1 @DATE@ "git\-permalink @VERSION@" "manual d'utilisateur de git\-permalink"
+
+
+.SH NOM
+
+git\-permalink \- extension Git pour génerér liens web permanent (permalink)
+de fichiers dans un dépôt.
+
+
+.SH SYNOPSIS
+
+\fBgit\-permalink\fP [OPTIONS] \fIFICHIERS\fP [\fILINENO\fP]
+
+
+.SH DESCRIPTION
+
+\fBgit\-permalink\fP utilise Git pour prendre a) le commit au \fIHEAD\fP et b) le
+\fIremote.origin.url\fP avec \fBgit\-config\fP(1), et se possible c) un modèle de
+substituition d'URL.  Il utilise ces valeurs pour construire un URL
+\fIpermanent\fP, avec le commit inclus pour garantir la unicitè, e
+optionalement le numeró de la ligne choisi.
+
+\fBgit\-permalink\fP après utilise \fBxdg\-open\fP(1) pour ouvrir l'URL.
+
+.SH OPTIONS
+
+.TP 
+\fB\-p\fP
+Seulement imprimez le lien d'URL web, n'essayez pas de l'ouvrir avec
+\fBxdg\-open\fP(1) ou faire quelques choses avec lui.  Par défaut cela est
+désactivé.
+
+.TP 
+\fB\-\-help\fP, \fB\-h\fP
+Affiche message d'aide.
+
+.TP 
+\fB\-\-version\fP, \fB\-V\fP
+Imprime le numeró de version.
+
+
+.SH MODÈLES
+
+Si vous souhaitez configurer le modèle de substitution d'URL pour un projet
+que a un références distantes que n'est pas prises en charge, vous utilize
+\fBgit\-config\fP(1).
+
+Il y a deux options de configuration disponible:
+
+.TP 
+\fBgit\-permalink.template\-file\-commit\fP
+Un modèle de substitution d'URL où le nom du \fIfichier\fP est avant, et le
+\fIcommit\fP est après.  cgit utilise cette type d'URL, comme dans:
+
+.nf
+	https://git.euandreh.xyz/fallible/tree/%s?id=%s
+.fi
+
+Dans cet example, le nom du \fIfichier\fP est avant et le \fIcommit\fP est à la
+fin, après le "id=".
+
+.TP 
+\fBgit\-permalink.template\-commit\-file\fP
+Un modèle de substitution d'URL où le \fIcommit\fP est avant, et le nom du
+\fIfichier\fP est après.  sourcehut utilise cette type d'URL, comme dans:
+
+.nf
+	https://git.sr.ht/~sircmpwn/scdoc/tree/%s/item/%s
+.fi
+
+Dans cet example, le \fIcommit\fP est avant dans le chemin de l'URL, et le
+\fIfichier\fP est après.
+
+.P
+Si aucune options n'est pas trouvé par \fBgit\-config\fP(1) et \fBgit\-permalink\fP
+ne peut pas deviner l'URL, cela se termine par une erreur.
+
+
+.SH "RÉFÉRENCES DISTANTES PRISES EN CHARGE"
+
+La liste de références distantes prises en charge est:
+
+.RS
+.IP \(bu
+git.euandreh.xyz (où git\-permalink est hébergé =p)
+.IP \(bu
+sourcehut
+.IP \(bu
+savannah
+.IP \(bu
+gitlab
+.IP \(bu
+github
+.RE
+
+Les changements pour ajouter plus de sites d'hébergement de code sont les
+bienvenus!
+
+Regarde
+.UR https://euandreh.xyz/git\-permalink/TODOs.html#task\-cebc5298\-17ad\-5c60\-dfa5\-a25b66433a3a
+#task\-cebc5298\-17ad\-5c60\-dfa5\-a25b66433a3a
+.UE
+pour les discussions et
+plus d'information.
+
+
+.SH EXAMPLES
+
+Ouvrez \fIsrc/fold.c\fP d'un projet qui a de référence distante pointée a
+\fIsourcehut\fP:
+
+.nf
+	$ git permalink src/fold.c 125
+	Ouverture de https://git.sr.ht/~sircmpwn/ctools/tree/fbf17d92f5ed1c38983f73df912f051ad0f9ef2d/item/src/fold.c#L125
+.fi
+
+Géneréz un lien des lignes 59 à 94 de \fInongnu/packages/clojure.scm\fP dans un
+projet hébergér sur \fIgitlab\fP, mais seulement imprimez le lien \fIsans\fP
+l'ouvrir avec \fBxdg\-open\fP(1):
+
+.nf
+	$ git permalink \-p nongnu/packages/clojure.scm 59\-94
+	https://gitlab.com/nonguix/nonguix/\-/blob/c9d7f30bcbd3a6e3076e56a972c33963c73c4d58/nongnu/packages/clojure.scm#L59\-94
+.fi
+
+.P
+Configurez un modèle de substitution d'URL, et ouvrir le fichier
+\fIsrc/app_add.c\fP sans choisir un numeró de ligne:
+
+.nf
+	$ git config git\-permalink.template\-file\-commit 'https://git.alpinelinux.org/apk\-tools/tree/%s?id=%s'
+	$ git permalink src/app_add.c
+	Ouverture de https://git.alpinelinux.org/apk\-tools/tree/src/app_add.c?id=aeeb119fd8652c044cd5ceebce572b5c716914e3
+.fi
+
+
+.SH "VOIR AUSSI"
+
+\fBgit\-config\fP(1)  \fBxdg\-open\fP(1)
+
+
+.SH AUTEURS
+
+.MT eu@euandre.org
+EuAndreh
+.ME
+et les contributeurs.
+
+
+.SH BUGS
+
+.IP \(bu
+Soumettre un bogue dans la
+.MT ~euandreh/public\-inbox@lists.sr.ht
+liste
+de diffusion
+.ME .
+Utilise le sujèt "\f(CR[git\-permalink] BUG ou TASK:
+<description>\fR".
+.IP \(bu
+Parcourir les bogues
+.UR https://euandreh.xyz/git\-permalink/TODOs.html
+en
+ligne
+.UE .
+.IP \(bu
+.UR https://euandreh.xyz/git\-permalink/
+Page d'accueil
+.UE .
+.IP \(bu
+.UR https://lists.sr.ht/~euandreh/public\-inbox?search=%5Bgit\-permalink%5D
+Commentaires et discussions
+.UE .