.\"*******************************************************************
.\"
.\" 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énérer liens web permanent (permalink)
de fichiers dans un dépôt.


.SH SYNOPSIS

\fBgit\-permalink\fP [\fIOPTIONS\fP] \fIFICHIER\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
substitution d'URL.  Il utilise ces valeurs pour construire un URL
\fIpermanent\fP, avec le commit inclus pour garantir la unicité, e
optionnellement le nombre 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 dans la sortie standard (STDOUT),
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 nombre de version.


.SH CONFIGURATION

.SS "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
git.kernel.org
.IP \(bu
savannah
.IP \(bu
notabug
.IP \(bu
codeberg
.IP \(bu
bitbucket
.IP \(bu
pagure
.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#td\-cebc5298\-17ad\-5c60\-dfa5\-a25b66433a3a
#td\-cebc5298\-17ad\-5c60\-dfa5\-a25b66433a3a
.UE
pour les discussions et plus
d'information.

.SS 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 utilise
\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://euandreh.xyz/fallible.git/tree/%s?id=%s
.fi

Dans cet exemple, 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 exemple, 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 EXEMPLES

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énérez un lien des lignes 59 à 94 de \fInongnu/packages/clojure.scm\fP dans un
projet héberger 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 nombre 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

.P
Ouvrez \fI\-\-help\fP:

.nf
	$ git permalink \-\- \-\-help
	Ouverture de https://euandreh.xyz/non\-existent\-repository.git/tree/\-\-help?id=470a9fa9329495cfcbef8cc5e32e3a38d3c3103e
.fi

.SH "CODES DE SORTIE"

.TP 
\fB0\fP
Exécution réussie.

.TP 
\fB1\fP
Références distante non prise en charge.  Voir la liste de références prises
en charge dans RÉFÉRENCES DISTANTES PRISE EN CHARGE, et comme ajouter un à
partir d'un modèles dans MODÈLES.

.TP 
\fB2\fP
Arguments invalides.


.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 sujet "\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/fr/
Page d'accueil
.UE .
.IP \(bu
.UR https://lists.sr.ht/~euandreh/public\-inbox?search=%5Bgit\-permalink%5D
Commentaires et discussions
.UE .