.\"*******************************************************************
.\"
.\" 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 .