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
|
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH GIT\-PERMALINK 1 @DATE@ "git\-permalink @VERSION@" "git\-permalink uzmanlibro"
.SH NOMO
git\-permalink \- Git\-etendo por generi interretajn konstantajn ligojn
(permalink) de dosieroj en deponejo.
.SH RESUMO
\fBgit\-permalink\fP [\fIEBLOJ\fP] \fIDOSIERO\fP [\fILINIONO\fP]
.SH PRISKRIBO
\fBgit\-permalink\fP uzas Git por akiri a) la commit ĉe \fIHEAD\fP kaj b) la
\fIremote.origin.url\fP per \fBgit\-config\fP(1), kaj laŭvole c) URL ŝablono. Ĝi
tiam uzas tiujn por krei \fIkonstantan\fP URL ligon (permalink), kun la commit
ene por certigi ke ĝi estas konstantan, kaj laŭvole la linia numero
elektita.
\fBgit\-permalink\fP tiam uzas \fBxdg\-open\fP(1) por malfermi la URL.
.SH EBLOJ
.TP
\fB\-p\fP
Nur presas la ligon per norma eligo (STDOUT), ne provas malfermi ĝin kun
\fBxdg\-open\fP(1) aŭ fari ion alian. Defaŭlte ĉi tio estas malŝaltita.
.TP
\fB\-\-help\fP, \fB\-h\fP
Montras helpmesaĝon.
.TP
\fB\-\-version\fP, \fB\-V\fP
Montras versian numeron.
.SH AGORDO
.SS "SUBTENITAJ ORIGINOJ"
La nunaj subtenitaj originoj estas:
.RS
.IP \(bu
git.euandreh.xyz (kie git\-permalink estas gastiga =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
Ŝanĝoj por subteni pli da fontkodaj forĝejoj estas bonvenaj!
Foliumu
.UR https://euandreh.xyz/git\-permalink/TODOs.html#td\-cebc5298\-17ad\-5c60\-dfa5\-a25b66433a3a
#td\-cebc5298\-17ad\-5c60\-dfa5\-a25b66433a3a
.UE
por diskuto kaj pli da
informoj.
.SS SUPERREGOJ
Se vi volas agordi la URL ŝablonon por projekto kun nesubtenita origino
, vi povas uzi \fBgit\-config\fP(1).
Estas du agordaj elektoj disponeblaj:
.TP
\fBgit\-permalink.template\-file\-commit\fP
URL ŝablono, kie la nomo de la \fIdosiero\fP estas unue, kaj la \fIcommit\fP estas
due. cgit uzas ĉi tiun specon de URL, kiel en:
.nf
https://euandreh.xyz/fallible.git/tree/%s?id=%s
.fi
Laŭ ĉi tiu ekzemplo, la nomo de la \fIdosiero\fP estas unue kaj la \fIcommit\fP
estas fine post "id=".
.TP
\fBgit\-permalink.template\-commit\-file\fP
URL ŝablono, kie la \fIcommit\fP estas unue, kaj la nomo de la \fIdosiero\fP estas
due. sourcehut uzas ĉi tiun specon de URL, kiel en:
.nf
https://git.sr.ht/~sircmpwn/scdoc/tree/%s/item/%s
.fi
Laŭ ĉi tiu ekzemplo, la \fIcommit\fP estas unue en la URL, kaj la nome de la
\fIdosiero\fP estas poste.
.P
Se neniu el tiuj estas estas trovita por \fBgit\-config\fP(1) aŭ
\fBgit\-permalink\fP ne povas diveni la URL, ĝi eliras erare.
.SH EKZEMPLOJ
Malfermas \fIsrc/fold.c\fP de projekto kiu origino direktiĝas al \fIsourcehut\fP:
.nf
$ git permalink src/fold.c 125
Malfermado de https://git.sr.ht/~sircmpwn/ctools/tree/fbf17d92f5ed1c38983f73df912f051ad0f9ef2d/item/src/fold.c#L125
.fi
Kreas ligon por linioj 59 ĝis 94 de \fInongnu/packages/clojure.scm\fP en
projekto gastigita ĉe \fIgitlab\fP, sed nur presu ĝin \fIsen\fP malfermi kun
\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
Agordas URL superrego, kaj malfermas la dosieron \fIsrc/app_add.c\fP sen elekti
specifan linion:
.nf
$ git config git\-permalink.template\-file\-commit 'https://git.alpinelinux.org/apk\-tools/tree/%s?id=%s'
$ git permalink src/app_add.c
Malfermado de https://git.alpinelinux.org/apk\-tools/tree/src/app_add.c?id=aeeb119fd8652c044cd5ceebce572b5c716914e3
.fi
.P
Malfermas \fI\-\-help\fP:
.nf
$ git permalink \-\- \-\-help
Malfermado de https://euandreh.xyz/non\-existent\-repository.git/tree/\-\-help?id=470a9fa9329495cfcbef8cc5e32e3a38d3c3103e
.fi
.SH ELIRKODOJ
.TP
\fB0\fP
Bona ekzekuto.
.TP
\fB1\fP
Nesubtenita origino. Vidu la subtenitoj en SUBTENITAJ ORIGINOJ, kaj kiel
aldoni ion en SUPERREGOJ.
.TP
\fB2\fP
Malvalidaj argumentoj.
.SH "VIDU ANKAŬ"
\fBgit\-config\fP(1) \fBxdg\-open\fP(1)
.SH AŬTOROJ
.MT eu@euandre.org
EuAndreh
.ME
kaj la kontribuuloj.
.SH MISFUNKCIOJ
.IP \(bu
Raportu misfunkcioj al la
.MT ~euandreh/public\-inbox@lists.sr.ht
dissendolisto
.ME .
Uzu la subjekton "\f(CR[git\-permalink] BUG aŭ TASK:
<priskribo>\fR".
.IP \(bu
Foliumu misfunkcioj
.UR https://euandreh.xyz/git\-permalink/TODOs.html
rete
.UE .
.IP \(bu
.UR https://euandreh.xyz/git\-permalink/eo/
Ĉefpaĝo
.UE .
.IP \(bu
.UR https://lists.sr.ht/~euandreh/public\-inbox?search=%5Bgit\-permalink%5D
Komentoj kaj diskutoj
.UE .
|