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
|
.\"*******************************************************************
.\"
.\" 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 [EBLOJ] \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, 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 SUPERREGOJ
Se vi volas agordi la URL ŝablonon por projekto kun nesubtenita remoton, 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://git.euandreh.xyz/fallible/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 "SUBTENITAJ REMOTOJ"
La nunaj subtenitaj remotoj estas:
.RS
.IP \(bu
git.euandreh.xyz (kie git\-permalink estas gastiga =p)
.IP \(bu
sourcehut
.IP \(bu
savannah
.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#task\-cebc5298\-17ad\-5c60\-dfa5\-a25b66433a3a
#task\-cebc5298\-17ad\-5c60\-dfa5\-a25b66433a3a
.UE
por diskuto kaj pli da
informoj.
.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
.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/
Ĉefpaĝo
.UE .
.IP \(bu
.UR https://lists.sr.ht/~euandreh/public\-inbox?search=%5Bgit\-permalink%5D
Komentoj kaj diskutoj
.UE .
|
