diff options
Diffstat (limited to 'doc/git-permalink.eo.1.in')
| -rw-r--r-- | doc/git-permalink.eo.1.in | 206 |
1 files changed, 206 insertions, 0 deletions
diff --git a/doc/git-permalink.eo.1.in b/doc/git-permalink.eo.1.in new file mode 100644 index 0000000..0d799c0 --- /dev/null +++ b/doc/git-permalink.eo.1.in @@ -0,0 +1,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 REMOTOJ" + +La nunaj subtenitaj remotoj 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#task\-cebc5298\-17ad\-5c60\-dfa5\-a25b66433a3a +#task\-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 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 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://git.euandreh.xyz/non\-existent\-repository/tree/\-\-help?id=470a9fa9329495cfcbef8cc5e32e3a38d3c3103e +.fi + +.SH ELIRKODOJ + +.TP +\fB0\fP +Bona ekzekuto. + +.TP +\fB1\fP +Nesubtenita remoto. Vidu la subtenitoj en SUBTENITAJ REMOTOJ, kaŭ 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/ +Ĉefpaĝo +.UE . +.IP \(bu +.UR https://lists.sr.ht/~euandreh/public\-inbox?search=%5Bgit\-permalink%5D +Komentoj kaj diskutoj +.UE . |