From d0a5a24788e6c1720fce72629da4639fac372fad Mon Sep 17 00:00:00 2001 From: EuAndreh Date: Sat, 19 Jun 2021 01:47:04 -0300 Subject: Leverage po4a to translate manpages --- doc/git-permalink.fr.1 | 178 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 178 insertions(+) create mode 100644 doc/git-permalink.fr.1 (limited to 'doc/git-permalink.fr.1') 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: +\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 . -- cgit v1.2.3