.\"******************************************************************* .\" .\" 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.git\-existent\-repository/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: \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 .