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