1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
|
.\"*******************************************************************
.\"
.\" 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 .
|
