From d0a5a24788e6c1720fce72629da4639fac372fad Mon Sep 17 00:00:00 2001 From: EuAndreh Date: Sat, 19 Jun 2021 01:47:04 -0300 Subject: Leverage po4a to translate manpages --- Makefile | 1 + README.md | 7 +- aux/guix/manifest.scm | 4 +- aux/workflow/assert-manpages.sh | 136 +++++++++++- aux/workflow/update-translations.sh | 16 ++ doc/eo.po | 414 +++++++++++++++++++++++++++++++++++ doc/fr.po | 418 ++++++++++++++++++++++++++++++++++++ doc/git-permalink.1 | 155 ------------- doc/git-permalink.en.1 | 156 ++++++++++++++ doc/git-permalink.eo.1 | 172 +++++++++++++++ doc/git-permalink.fr.1 | 178 +++++++++++++++ doc/git-permalink.pt.1 | 174 +++++++++++++++ doc/pt.po | 417 +++++++++++++++++++++++++++++++++++ src/git-permalink.sh | 4 +- 14 files changed, 2089 insertions(+), 163 deletions(-) create mode 100755 aux/workflow/update-translations.sh create mode 100644 doc/eo.po create mode 100644 doc/fr.po delete mode 100644 doc/git-permalink.1 create mode 100644 doc/git-permalink.en.1 create mode 100644 doc/git-permalink.eo.1 create mode 100644 doc/git-permalink.fr.1 create mode 100644 doc/git-permalink.pt.1 create mode 100644 doc/pt.po diff --git a/Makefile b/Makefile index 6d800d9..38522c0 100644 --- a/Makefile +++ b/Makefile @@ -5,6 +5,7 @@ DATE = 2021-06-13 VERSION = 0.1.0 NAME = git-permalink MAILING_LIST = public-inbox +TRANSLATIONS = pt fr eo manpages = \ doc/git-permalink.1 diff --git a/README.md b/README.md index d95fcc5..8836ca3 100644 --- a/README.md +++ b/README.md @@ -50,9 +50,12 @@ There are no dependencies or requirements, only standard tools such as ## Documentation -The documentation is available via installed manpages or online: [`git-permalink.1`]. +The documentation is available via installed manpages or online: [`git-permalink.1`] ([pt], [fr], [eo]). -[`git-permalink.1`]: https://euandreh.xyz/git-permalink/git-permalink.1.html +[`git-permalink.1`]: https://euandreh.xyz/git-permalink/git-permalink.en.1.html +[pt]: https://euandreh.xyz/git-permalink/git-permalink.pt.1.html +[fr]: https://euandreh.xyz/git-permalink/git-permalink.fr.1.html +[eo]: https://euandreh.xyz/git-permalink/git-permalink.eo.1.html ## Contributing diff --git a/aux/guix/manifest.scm b/aux/guix/manifest.scm index 31af4b3..c3cd4a0 100644 --- a/aux/guix/manifest.scm +++ b/aux/guix/manifest.scm @@ -11,4 +11,6 @@ make perl shellcheck - pandoc))) + pandoc + gettext + po4a))) diff --git a/aux/workflow/assert-manpages.sh b/aux/workflow/assert-manpages.sh index f265ab4..7254d60 100644 --- a/aux/workflow/assert-manpages.sh +++ b/aux/workflow/assert-manpages.sh @@ -18,8 +18,9 @@ while getopts 'i' flag; do esac done -EXPECTED="$(mktemp)" -cat <> "$EXPECTED" + +EXPECTED_EN="$(mktemp)" +cat <> "$EXPECTED_EN" .SH AUTHORS @@ -37,7 +38,8 @@ Report bugs to the .MT ~euandreh/$MAILING_LIST@lists.sr.ht mailing list .ME . -Use the subject "\fC[$PROJECT] BUG or TASK: \fR". +Use the subject "\f(CR[$PROJECT] BUG or TASK: +\fR". .IP \(bu Browse bugs .UR https://$TLD/$PROJECT/TODOs.html @@ -53,12 +55,140 @@ Comments and discussions .UE . EOF +EXPECTED_PT="$(mktemp)" +cat <> "$EXPECTED_PT" + + +.SH AUTORES + +.MT eu@euandre.org +EuAndreh +.ME +e colaboradores. + + +.SH BUGS + +.IP \(bu +Relate bugs na +.MT ~euandreh/$MAILING_LIST@lists.sr.ht +lista de discussão +.ME . +Use o assunto "\f(CR[$PROJECT] BUG ou TASK: +\fR". +.IP \(bu +Veja os bugs +.UR https://$TLD/$PROJECT/TODOs.html +online +.UE . +.IP \(bu +.UR https://$TLD/$PROJECT/ +Página inicial +.UE . +.IP \(bu +.UR https://lists.sr.ht/~euandreh/$MAILING_LIST?search=%5B$PROJECT%5D +Comentários e discussões +.UE . +EOF + +EXPECTED_FR="$(mktemp)" +cat <> "$EXPECTED_FR" + + +.SH AUTEURS + +.MT eu@euandre.org +EuAndreh +.ME +et les contributeurs. + + +.SH BUGS + +.IP \(bu +Soumettre un bogue dans la +.MT ~euandreh/$MAILING_LIST@lists.sr.ht +liste +de diffusion +.ME . +Utilise le sujèt "\f(CR[$PROJECT] BUG ou TASK: +\fR". +.IP \(bu +Parcourir les bogues +.UR https://$TLD/$PROJECT/TODOs.html +en +ligne +.UE . +.IP \(bu +.UR https://$TLD/$PROJECT/ +Page d'accueil +.UE . +.IP \(bu +.UR https://lists.sr.ht/~euandreh/$MAILING_LIST?search=%5B$PROJECT%5D +Commentaires et discussions +.UE . +EOF + +EXPECTED_EO="$(mktemp)" +cat <> "$EXPECTED_EO" + + +.SH AŬTOROJ + +.MT eu@euandre.org +EuAndreh +.ME +kaj la kontribuuloj. + + +.SH MISFUNKCIOJ + +.IP \(bu +Raportu misfunkcioj al la +.MT ~euandreh/$MAILING_LIST@lists.sr.ht +dissendolisto +.ME . +Uzu la subjekton "\f(CR[$PROJECT] BUG aŭ TASK: +\fR". +.IP \(bu +Foliumu misfunkcioj +.UR https://$TLD/$PROJECT/TODOs.html +rete +.UE . +.IP \(bu +.UR https://$TLD/$PROJECT/ +Ĉefpaĝo +.UE . +.IP \(bu +.UR https://lists.sr.ht/~euandreh/$MAILING_LIST?search=%5B$PROJECT%5D +Komentoj kaj diskutoj +.UE . +EOF + + # shellcheck disable=2044 for f in $(find doc -type f -name '*.[0-9]'); do LINES="$(wc -l "$f" | cut -d\ -f1)" if [ "$LINES" = 1 ] && grep -Eq '^\.so man.+$' "$f"; then continue fi + + lang="$(echo "$f" | cut -d. -f2)" + case "$lang" in + pt) + EXPECTED="$EXPECTED_PT" + ;; + fr) + EXPECTED="$EXPECTED_FR" + ;; + eo) + EXPECTED="$EXPECTED_EO" + ;; + *) + EXPECTED="$EXPECTED_EN" + ;; + esac + if ! tail -n "$(wc -l < "$EXPECTED")" "$f" | diff - "$EXPECTED"; then echo "Missing metadata at the end of \"$f\" file" if [ "$IN_PLACE" = true ]; then diff --git a/aux/workflow/update-translations.sh b/aux/workflow/update-translations.sh new file mode 100755 index 0000000..1974580 --- /dev/null +++ b/aux/workflow/update-translations.sh @@ -0,0 +1,16 @@ +#!/bin/sh +set -eu + +for f in doc/*.en.[1-9]; do + # shellcheck disable=2068 + for lang in $@; do + to="$(echo "$f" | sed "s|\.en\.|.$lang.|")" + po4a-updatepo -f man -m "$f" -p "doc/$lang.po" + printf 'Translating %s...\n' "$to" >&2 + OUT="$(po4a-translate -f man -m "$f" -p "doc/$lang.po" -l "$to" -k 0 -v 2>&1)" + echo "$OUT" >&2 + if ! echo "$OUT" | grep -qF ' is 100% translated ('; then + printf "\n WARNING!\n Missing translations for %s\n\n" "$to" >&2 + fi + done +done diff --git a/doc/eo.po b/doc/eo.po new file mode 100644 index 0000000..4a4b33f --- /dev/null +++ b/doc/eo.po @@ -0,0 +1,414 @@ +# SOME DESCRIPTIVE TITLE +# Copyright (C) YEAR Free Software Foundation, Inc. +# This file is distributed under the same license as the PACKAGE package. +# FIRST AUTHOR , YEAR. +# +msgid "" +msgstr "" +"Project-Id-Version: \n" +"POT-Creation-Date: 2021-06-18 21:45-0300\n" +"PO-Revision-Date: 2021-06-19 01:37-0300\n" +"Last-Translator: \n" +"Language-Team: \n" +"Language: eo\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: Poedit 2.4.3\n" +"X-Poedit-Bookmarks: -1,-1,5,-1,-1,-1,-1,-1,-1,-1\n" + +#. type: TH +#: doc/git-permalink.en.1:1 +#, no-wrap +msgid "GIT-PERMALINK" +msgstr "GIT-PERMALINK" + +#. type: TH +#: doc/git-permalink.en.1:1 +#, no-wrap +msgid "@DATE@" +msgstr "@DATE@" + +#. type: TH +#: doc/git-permalink.en.1:1 +#, no-wrap +msgid "git-permalink @VERSION@" +msgstr "git-permalink @VERSION@" + +#. type: TH +#: doc/git-permalink.en.1:1 +#, no-wrap +msgid "git-permalink user manual" +msgstr "git-permalink uzmanlibro" + +#. type: SH +#: doc/git-permalink.en.1:4 +#, no-wrap +msgid "NAME" +msgstr "NOMO" + +#. type: Plain text +#: doc/git-permalink.en.1:7 +msgid "" +"git-permalink - Git extension to generate web permalinks of files in a " +"repository." +msgstr "" +"git-permalink - Git-etendo por generi interretajn konstantajn ligojn " +"(permalink) de dosieroj en deponejo." + +#. type: SH +#: doc/git-permalink.en.1:9 +#, no-wrap +msgid "SYNOPSYS" +msgstr "RESUMO" + +#. type: Plain text +#: doc/git-permalink.en.1:12 +msgid "B [OPTIONS] I [I]" +msgstr "B [EBLOJ] I [I]" + +#. type: SH +#: doc/git-permalink.en.1:14 +#, no-wrap +msgid "DESCRIPTION" +msgstr "PRISKRIBO" + +#. type: Plain text +#: doc/git-permalink.en.1:18 +msgid "" +"B will use Git itself to get a) the commit at I and b) " +"the I via B(1), and optionally c) an URL " +"template override. It then uses those values to build a permalink URL, with " +"the commit included on it to ensure it is I, and optionally the " +"line number of the selected file." +msgstr "" +"B uzas Git por akiri a) la commit ĉe I kaj b) la " +"I per B(1), kaj laŭvole c) URL ŝablono. Ĝi " +"tiam uzas tiujn por krei I URL ligon (permalink), kun la commit " +"ene por certigi ke ĝi estas konstantan, kaj laŭvole la linia numero elektita." + +#. type: Plain text +#: doc/git-permalink.en.1:20 +msgid "B then uses B(1) to open the URL." +msgstr "B tiam uzas B(1) por malfermi la URL." + +#. type: SH +#: doc/git-permalink.en.1:21 +#, no-wrap +msgid "OPTIONS" +msgstr "EBLOJ" + +#. type: TP +#: doc/git-permalink.en.1:23 +#, no-wrap +msgid "B<-p>" +msgstr "B<-p>" + +#. type: Plain text +#: doc/git-permalink.en.1:27 +msgid "" +"Only print the web URL link, don't try to open it with B(1) or do " +"anything else. By default this is turned off." +msgstr "" +"Nur presas la ligon, ne provas malfermi ĝin kun B(1) aŭ fari ion " +"alian. Defaŭlte ĉi tio estas malŝaltita." + +#. type: TP +#: doc/git-permalink.en.1:28 +#, no-wrap +msgid "B<--help>, B<-h>" +msgstr "B<--help>, B<-h>" + +#. type: Plain text +#: doc/git-permalink.en.1:31 +msgid "Show show help text." +msgstr "Montras helpmesaĝon." + +#. type: TP +#: doc/git-permalink.en.1:32 +#, no-wrap +msgid "B<--version>, B<-V>" +msgstr "B<--version>, B<-V>" + +#. type: Plain text +#: doc/git-permalink.en.1:35 +msgid "Show version number." +msgstr "Montras versian numeron." + +#. type: SH +#: doc/git-permalink.en.1:37 +#, no-wrap +msgid "OVERRIDES" +msgstr "SUPERREGOJ" + +#. type: Plain text +#: doc/git-permalink.en.1:40 +msgid "" +"If you want to configure the permalink URL template for a project with an " +"unsupported origin you can do so via B(1)." +msgstr "" +"Se vi volas agordi la URL ŝablonon por projekto kun nesubtenita remoton, vi " +"povas uzi B(1)." + +#. type: Plain text +#: doc/git-permalink.en.1:42 +msgid "There are two configuration options available:" +msgstr "Estas du agordaj elektoj disponeblaj:" + +#. type: TP +#: doc/git-permalink.en.1:43 +#, no-wrap +msgid "B" +msgstr "B" + +#. type: Plain text +#: doc/git-permalink.en.1:47 +msgid "" +"An URL template where the name of the I comes first, and the I " +"comes second. cgit uses this style of URL, with something like in:" +msgstr "" +"URL ŝablono, kie la nomo de la I estas unue, kaj la I estas " +"due. cgit uzas ĉi tiun specon de URL, kiel en:" + +#. type: Plain text +#: doc/git-permalink.en.1:50 +#, no-wrap +msgid "\thttps://git.euandreh.xyz/fallible/tree/%s?id=%s\n" +msgstr "\thttps://git.euandreh.xyz/fallible/tree/%s?id=%s\n" + +#. type: Plain text +#: doc/git-permalink.en.1:53 +msgid "" +"On this example, the name of the I comes first and I comes at " +"the very end after \"id=\"." +msgstr "" +"Laŭ ĉi tiu ekzemplo, la nomo de la I estas unue kaj la I " +"estas fine post \"id=\"." + +#. type: TP +#: doc/git-permalink.en.1:54 +#, no-wrap +msgid "B" +msgstr "B" + +#. type: Plain text +#: doc/git-permalink.en.1:58 +msgid "" +"An URL template where the I comes first, and the name of the I " +"comes second. sourcehut uses this style of URL, with something like:" +msgstr "" +"URL ŝablono, kie la I estas unue, kaj la nomo de la I estas " +"due. sourcehut uzas ĉi tiun specon de URL, kiel en:" + +#. type: Plain text +#: doc/git-permalink.en.1:61 +#, no-wrap +msgid "\thttps://git.sr.ht/~sircmpwn/scdoc/tree/%s/item/%s\n" +msgstr "\thttps://git.sr.ht/~sircmpwn/scdoc/tree/%s/item/%s\n" + +#. type: Plain text +#: doc/git-permalink.en.1:64 +msgid "" +"On this example, the I comes first on the URL path, and the I " +"name comes at the end." +msgstr "" +"Laŭ ĉi tiu ekzemplo, la I estas unue en la URL, kaj la nome de la " +"I estas poste." + +#. type: Plain text +#: doc/git-permalink.en.1:67 +msgid "" +"If none of those values are found by B(1) and B " +"can't guess the URL, it exits with an error." +msgstr "" +"Se neniu el tiuj estas estas trovita por B(1) aŭ B ne povas diveni la URL, ĝi eliras erare." + +#. type: SH +#: doc/git-permalink.en.1:69 +#, no-wrap +msgid "SUPPORTED REMOTES" +msgstr "SUBTENITAJ REMOTOJ" + +#. type: Plain text +#: doc/git-permalink.en.1:72 +msgid "The current supported remotes are:" +msgstr "La nunaj subtenitaj remotoj estas:" + +#. type: IP +#: doc/git-permalink.en.1:74 doc/git-permalink.en.1:76 +#: doc/git-permalink.en.1:78 doc/git-permalink.en.1:80 +#: doc/git-permalink.en.1:82 doc/git-permalink.en.1:137 +#: doc/git-permalink.en.1:144 doc/git-permalink.en.1:149 +#: doc/git-permalink.en.1:153 +#, no-wrap +msgid "\\(bu" +msgstr "\\(bu" + +#. type: Plain text +#: doc/git-permalink.en.1:76 +msgid "git.euandreh.xyz (where git-permalink itself is hosted =p)" +msgstr "git.euandreh.xyz (kie git-permalink estas gastiga =p)" + +#. type: Plain text +#: doc/git-permalink.en.1:78 +msgid "sourcehut" +msgstr "sourcehut" + +#. type: Plain text +#: doc/git-permalink.en.1:80 +msgid "savannah" +msgstr "savannah" + +#. type: Plain text +#: doc/git-permalink.en.1:82 +msgid "gitlab" +msgstr "gitlab" + +#. type: Plain text +#: doc/git-permalink.en.1:84 +msgid "github" +msgstr "github" + +#. type: Plain text +#: doc/git-permalink.en.1:87 +msgid "Patches to add support for more source code forges are welcome!" +msgstr "Ŝanĝoj por subteni pli da fontkodaj forĝejoj estas bonvenaj!" + +#. type: Plain text +#: doc/git-permalink.en.1:93 +msgid "" +"See E<.UR https://euandreh.xyz/git-permalink/TODOs.html#task-" +"cebc5298-17ad-5c60-dfa5-a25b66433a3a> #task-cebc5298-17ad-5c60-dfa5-" +"a25b66433a3a E<.UE> for discussion and more information." +msgstr "" +"Foliumu E<.UR https://euandreh.xyz/git-permalink/TODOs.html#task-" +"cebc5298-17ad-5c60-dfa5-a25b66433a3a> #task-cebc5298-17ad-5c60-dfa5-" +"a25b66433a3a E<.UE> por diskuto kaj pli da informoj." + +#. type: SH +#: doc/git-permalink.en.1:95 +#, no-wrap +msgid "EXAMPLES" +msgstr "EKZEMPLOJ" + +#. type: Plain text +#: doc/git-permalink.en.1:98 +msgid "" +"Open I of a project with its origin pointing to I:" +msgstr "" +"Malfermas I de projekto kiu origino direktiĝas al I:" + +#. type: Plain text +#: doc/git-permalink.en.1:102 +#, no-wrap +msgid "" +"\t$ git permalink src/fold.c 125\n" +"\tOpening https://git.sr.ht/~sircmpwn/ctools/tree/fbf17d92f5ed1c38983f73df912f051ad0f9ef2d/item/src/fold.c#L125\n" +msgstr "" +"\t$ git permalink src/fold.c 125\n" +"\tMalfermado de https://git.sr.ht/~sircmpwn/ctools/tree/fbf17d92f5ed1c38983f73df912f051ad0f9ef2d/item/src/fold.c#L125\n" + +#. type: Plain text +#: doc/git-permalink.en.1:105 +msgid "" +"Generate link for lines 59 through 94 of I on a " +"project hosted on I, but only print it I opening with B(1):" +msgstr "" +"Kreas ligon por linioj 59 ĝis 94 de I en " +"projekto gastigita ĉe I, sed nur presu ĝin I malfermi kun B(1):" + +#. type: Plain text +#: doc/git-permalink.en.1:109 +#, no-wrap +msgid "" +"\t$ git permalink -p nongnu/packages/clojure.scm 59-94\n" +"\thttps://gitlab.com/nonguix/nonguix/-/blob/c9d7f30bcbd3a6e3076e56a972c33963c73c4d58/nongnu/packages/clojure.scm#L59-94\n" +msgstr "" +"\t$ git permalink -p nongnu/packages/clojure.scm 59-94\n" +"\thttps://gitlab.com/nonguix/nonguix/-/blob/c9d7f30bcbd3a6e3076e56a972c33963c73c4d58/nongnu/packages/clojure.scm#L59-94\n" + +#. type: Plain text +#: doc/git-permalink.en.1:113 +msgid "" +"Configure an URL override, and open the file I without " +"selecting an specific line:" +msgstr "" +"Agordas URL superrego, kaj malfermas la dosieron I sen elekti " +"specifan linion:" + +#. type: Plain text +#: doc/git-permalink.en.1:118 +#, no-wrap +msgid "" +"\t$ git config git-permalink.template-file-commit 'https://git.alpinelinux.org/apk-tools/tree/%s?id=%s'\n" +"\t$ git permalink src/app_add.c\n" +"\tOpening https://git.alpinelinux.org/apk-tools/tree/src/app_add.c?id=aeeb119fd8652c044cd5ceebce572b5c716914e3\n" +msgstr "" +"\t$ git config git-permalink.template-file-commit 'https://git.alpinelinux.org/apk-tools/tree/%s?id=%s'\n" +"\t$ git permalink src/app_add.c\n" +"\\Malfermado de https://git.alpinelinux.org/apk-tools/tree/src/app_add.c?id=aeeb119fd8652c044cd5ceebce572b5c716914e3\n" + +#. type: SH +#: doc/git-permalink.en.1:121 +#, no-wrap +msgid "SEE ALSO" +msgstr "VIDU ANKAŬ" + +#. type: Plain text +#: doc/git-permalink.en.1:125 +msgid "B(1) B(1)" +msgstr "B(1) B(1)" + +#. type: SH +#: doc/git-permalink.en.1:127 +#, no-wrap +msgid "AUTHORS" +msgstr "AŬTOROJ" + +#. type: Plain text +#: doc/git-permalink.en.1:133 +msgid "E<.MT eu@euandre.org> EuAndreh E<.ME> and contributors." +msgstr "E<.MT eu@euandre.org> EuAndreh E<.ME> kaj la kontribuuloj." + +#. type: SH +#: doc/git-permalink.en.1:135 +#, no-wrap +msgid "BUGS" +msgstr "MISFUNKCIOJ" + +#. type: Plain text +#: doc/git-permalink.en.1:144 +msgid "" +"Report bugs to the E<.MT ~euandreh/public-inbox@lists.sr.ht> mailing list E<." +"ME .> Use the subject \"\\f(CR[git-permalink] BUG or TASK: " +"EdescriptionE\\fR\"." +msgstr "" +"Raportu misfunkcioj al la E<.MT ~euandreh/public-inbox@lists.sr.ht> " +"dissendolisto E<.ME .> Uzu la subjekton \"\\f(CR[git-permalink] BUG aŭ TASK: " +"EpriskriboE\\fR\"." + +#. type: Plain text +#: doc/git-permalink.en.1:149 +msgid "" +"Browse bugs E<.UR https://euandreh.xyz/git-permalink/TODOs.html> online E<." +"UE .>" +msgstr "" +"Foliumu misfunkcioj E<.UR https://euandreh.xyz/git-permalink/TODOs.html> " +"rete E<.UE .>" + +#. type: Plain text +#: doc/git-permalink.en.1:153 +msgid "E<.UR https://euandreh.xyz/git-permalink/> Homepage E<.UE .>" +msgstr "E<.UR https://euandreh.xyz/git-permalink/> Ĉefpaĝo E<.UE .>" + +#. type: Plain text +#: doc/git-permalink.en.1:156 +msgid "" +"E<.UR https://lists.sr.ht/~euandreh/public-inbox?search=%5Bgit-permalink%5D> " +"Comments and discussions E<.UE .>" +msgstr "" +"E<.UR https://lists.sr.ht/~euandreh/public-inbox?search=%5Bgit-permalink%5D> " +"Komentoj kaj diskutoj E<.UE .>" diff --git a/doc/fr.po b/doc/fr.po new file mode 100644 index 0000000..34a2c96 --- /dev/null +++ b/doc/fr.po @@ -0,0 +1,418 @@ +# SOME DESCRIPTIVE TITLE +# Copyright (C) YEAR Free Software Foundation, Inc. +# This file is distributed under the same license as the PACKAGE package. +# FIRST AUTHOR , YEAR. +# +msgid "" +msgstr "" +"Project-Id-Version: \n" +"POT-Creation-Date: 2021-06-18 21:45-0300\n" +"PO-Revision-Date: 2021-06-19 01:43-0300\n" +"Last-Translator: \n" +"Language-Team: \n" +"Language: fr\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: Poedit 2.4.3\n" + +#. type: TH +#: doc/git-permalink.en.1:1 +#, no-wrap +msgid "GIT-PERMALINK" +msgstr "GIT-PERMALINK" + +#. type: TH +#: doc/git-permalink.en.1:1 +#, no-wrap +msgid "@DATE@" +msgstr "@DATE@" + +#. type: TH +#: doc/git-permalink.en.1:1 +#, no-wrap +msgid "git-permalink @VERSION@" +msgstr "git-permalink @VERSION@" + +#. type: TH +#: doc/git-permalink.en.1:1 +#, no-wrap +msgid "git-permalink user manual" +msgstr "manual d'utilisateur de git-permalink" + +#. type: SH +#: doc/git-permalink.en.1:4 +#, no-wrap +msgid "NAME" +msgstr "NOM" + +#. type: Plain text +#: doc/git-permalink.en.1:7 +msgid "" +"git-permalink - Git extension to generate web permalinks of files in a " +"repository." +msgstr "" +"git-permalink - extension Git pour génerér liens web permanent (permalink) " +"de fichiers dans un dépôt." + +#. type: SH +#: doc/git-permalink.en.1:9 +#, no-wrap +msgid "SYNOPSYS" +msgstr "SYNOPSIS" + +#. type: Plain text +#: doc/git-permalink.en.1:12 +msgid "B [OPTIONS] I [I]" +msgstr "B [OPTIONS] I [I]" + +#. type: SH +#: doc/git-permalink.en.1:14 +#, no-wrap +msgid "DESCRIPTION" +msgstr "DESCRIPTION" + +#. type: Plain text +#: doc/git-permalink.en.1:18 +msgid "" +"B will use Git itself to get a) the commit at I and b) " +"the I via B(1), and optionally c) an URL " +"template override. It then uses those values to build a permalink URL, with " +"the commit included on it to ensure it is I, and optionally the " +"line number of the selected file." +msgstr "" +"B utilise Git pour prendre a) le commit au I et b) le " +"I avec B(1), et se possible c) un modèle de " +"substituition d'URL. Il utilise ces valeurs pour construire un URL " +"I, avec le commit inclus pour garantir la unicitè, e " +"optionalement le numeró de la ligne choisi." + +#. type: Plain text +#: doc/git-permalink.en.1:20 +msgid "B then uses B(1) to open the URL." +msgstr "B après utilise B(1) pour ouvrir l'URL." + +#. type: SH +#: doc/git-permalink.en.1:21 +#, no-wrap +msgid "OPTIONS" +msgstr "OPTIONS" + +#. type: TP +#: doc/git-permalink.en.1:23 +#, no-wrap +msgid "B<-p>" +msgstr "B<-p>" + +#. type: Plain text +#: doc/git-permalink.en.1:27 +msgid "" +"Only print the web URL link, don't try to open it with B(1) or do " +"anything else. By default this is turned off." +msgstr "" +"Seulement imprimez le lien d'URL web, n'essayez pas de l'ouvrir avec B(1) ou faire quelques choses avec lui. Par défaut cela est désactivé." + +#. type: TP +#: doc/git-permalink.en.1:28 +#, no-wrap +msgid "B<--help>, B<-h>" +msgstr "B<--help>, B<-h>" + +#. type: Plain text +#: doc/git-permalink.en.1:31 +msgid "Show show help text." +msgstr "Affiche message d'aide." + +#. type: TP +#: doc/git-permalink.en.1:32 +#, no-wrap +msgid "B<--version>, B<-V>" +msgstr "B<--version>, B<-V>" + +#. type: Plain text +#: doc/git-permalink.en.1:35 +msgid "Show version number." +msgstr "Imprime le numeró de version." + +#. type: SH +#: doc/git-permalink.en.1:37 +#, no-wrap +msgid "OVERRIDES" +msgstr "MODÈLES" + +#. type: Plain text +#: doc/git-permalink.en.1:40 +msgid "" +"If you want to configure the permalink URL template for a project with an " +"unsupported origin you can do so via B(1)." +msgstr "" +"Si vous souhaitez configurer le modèle de substitution d'URL pour un projet " +"que a un références distantes que n'est pas prises en charge, vous utilize " +"B(1)." + +#. type: Plain text +#: doc/git-permalink.en.1:42 +msgid "There are two configuration options available:" +msgstr "Il y a deux options de configuration disponible:" + +#. type: TP +#: doc/git-permalink.en.1:43 +#, no-wrap +msgid "B" +msgstr "B" + +#. type: Plain text +#: doc/git-permalink.en.1:47 +msgid "" +"An URL template where the name of the I comes first, and the I " +"comes second. cgit uses this style of URL, with something like in:" +msgstr "" +"Un modèle de substitution d'URL où le nom du I est avant, et le " +"I est après. cgit utilise cette type d'URL, comme dans:" + +#. type: Plain text +#: doc/git-permalink.en.1:50 +#, no-wrap +msgid "\thttps://git.euandreh.xyz/fallible/tree/%s?id=%s\n" +msgstr "\thttps://git.euandreh.xyz/fallible/tree/%s?id=%s\n" + +#. type: Plain text +#: doc/git-permalink.en.1:53 +msgid "" +"On this example, the name of the I comes first and I comes at " +"the very end after \"id=\"." +msgstr "" +"Dans cet example, le nom du I est avant et le I est à la " +"fin, après le \"id=\"." + +#. type: TP +#: doc/git-permalink.en.1:54 +#, no-wrap +msgid "B" +msgstr "B" + +#. type: Plain text +#: doc/git-permalink.en.1:58 +msgid "" +"An URL template where the I comes first, and the name of the I " +"comes second. sourcehut uses this style of URL, with something like:" +msgstr "" +"Un modèle de substitution d'URL où le I est avant, et le nom du " +"I est après. sourcehut utilise cette type d'URL, comme dans:" + +#. type: Plain text +#: doc/git-permalink.en.1:61 +#, no-wrap +msgid "\thttps://git.sr.ht/~sircmpwn/scdoc/tree/%s/item/%s\n" +msgstr "\thttps://git.sr.ht/~sircmpwn/scdoc/tree/%s/item/%s\n" + +#. type: Plain text +#: doc/git-permalink.en.1:64 +msgid "" +"On this example, the I comes first on the URL path, and the I " +"name comes at the end." +msgstr "" +"Dans cet example, le I est avant dans le chemin de l'URL, et le " +"I est après." + +#. type: Plain text +#: doc/git-permalink.en.1:67 +msgid "" +"If none of those values are found by B(1) and B " +"can't guess the URL, it exits with an error." +msgstr "" +"Si aucune options n'est pas trouvé par B(1) et B " +"ne peut pas deviner l'URL, cela se termine par une erreur." + +#. type: SH +#: doc/git-permalink.en.1:69 +#, no-wrap +msgid "SUPPORTED REMOTES" +msgstr "RÉFÉRENCES DISTANTES PRISES EN CHARGE" + +#. type: Plain text +#: doc/git-permalink.en.1:72 +msgid "The current supported remotes are:" +msgstr "La liste de références distantes prises en charge est:" + +#. type: IP +#: doc/git-permalink.en.1:74 doc/git-permalink.en.1:76 +#: doc/git-permalink.en.1:78 doc/git-permalink.en.1:80 +#: doc/git-permalink.en.1:82 doc/git-permalink.en.1:137 +#: doc/git-permalink.en.1:144 doc/git-permalink.en.1:149 +#: doc/git-permalink.en.1:153 +#, no-wrap +msgid "\\(bu" +msgstr "\\(bu" + +#. type: Plain text +#: doc/git-permalink.en.1:76 +msgid "git.euandreh.xyz (where git-permalink itself is hosted =p)" +msgstr "git.euandreh.xyz (où git-permalink est hébergé =p)" + +#. type: Plain text +#: doc/git-permalink.en.1:78 +msgid "sourcehut" +msgstr "sourcehut" + +#. type: Plain text +#: doc/git-permalink.en.1:80 +msgid "savannah" +msgstr "savannah" + +#. type: Plain text +#: doc/git-permalink.en.1:82 +msgid "gitlab" +msgstr "gitlab" + +#. type: Plain text +#: doc/git-permalink.en.1:84 +msgid "github" +msgstr "github" + +#. type: Plain text +#: doc/git-permalink.en.1:87 +msgid "Patches to add support for more source code forges are welcome!" +msgstr "" +"Les changements pour ajouter plus de sites d'hébergement de code sont les " +"bienvenus!" + +#. type: Plain text +#: doc/git-permalink.en.1:93 +msgid "" +"See E<.UR https://euandreh.xyz/git-permalink/TODOs.html#task-" +"cebc5298-17ad-5c60-dfa5-a25b66433a3a> #task-cebc5298-17ad-5c60-dfa5-" +"a25b66433a3a E<.UE> for discussion and more information." +msgstr "" +"Regarde E<.UR https://euandreh.xyz/git-permalink/TODOs.html#task-" +"cebc5298-17ad-5c60-dfa5-a25b66433a3a> #task-cebc5298-17ad-5c60-dfa5-" +"a25b66433a3a E<.UE> pour les discussions et plus d'information." + +#. type: SH +#: doc/git-permalink.en.1:95 +#, no-wrap +msgid "EXAMPLES" +msgstr "EXAMPLES" + +#. type: Plain text +#: doc/git-permalink.en.1:98 +msgid "" +"Open I of a project with its origin pointing to I:" +msgstr "" +"Ouvrez I d'un projet qui a de référence distante pointée a " +"I:" + +#. type: Plain text +#: doc/git-permalink.en.1:102 +#, no-wrap +msgid "" +"\t$ git permalink src/fold.c 125\n" +"\tOpening https://git.sr.ht/~sircmpwn/ctools/tree/fbf17d92f5ed1c38983f73df912f051ad0f9ef2d/item/src/fold.c#L125\n" +msgstr "" +"\t$ git permalink src/fold.c 125\n" +"\tOuverture de https://git.sr.ht/~sircmpwn/ctools/tree/fbf17d92f5ed1c38983f73df912f051ad0f9ef2d/item/src/fold.c#L125\n" + +#. type: Plain text +#: doc/git-permalink.en.1:105 +msgid "" +"Generate link for lines 59 through 94 of I on a " +"project hosted on I, but only print it I opening with B(1):" +msgstr "" +"Géneréz un lien des lignes 59 à 94 de I dans un " +"projet hébergér sur I, mais seulement imprimez le lien I " +"l'ouvrir avec B(1):" + +#. type: Plain text +#: doc/git-permalink.en.1:109 +#, no-wrap +msgid "" +"\t$ git permalink -p nongnu/packages/clojure.scm 59-94\n" +"\thttps://gitlab.com/nonguix/nonguix/-/blob/c9d7f30bcbd3a6e3076e56a972c33963c73c4d58/nongnu/packages/clojure.scm#L59-94\n" +msgstr "" +"\t$ git permalink -p nongnu/packages/clojure.scm 59-94\n" +"\thttps://gitlab.com/nonguix/nonguix/-/blob/c9d7f30bcbd3a6e3076e56a972c33963c73c4d58/nongnu/packages/clojure.scm#L59-94\n" + +#. type: Plain text +#: doc/git-permalink.en.1:113 +msgid "" +"Configure an URL override, and open the file I without " +"selecting an specific line:" +msgstr "" +"Configurez un modèle de substitution d'URL, et ouvrir le fichier I sans choisir un numeró de ligne:" + +#. type: Plain text +#: doc/git-permalink.en.1:118 +#, no-wrap +msgid "" +"\t$ git config git-permalink.template-file-commit 'https://git.alpinelinux.org/apk-tools/tree/%s?id=%s'\n" +"\t$ git permalink src/app_add.c\n" +"\tOpening https://git.alpinelinux.org/apk-tools/tree/src/app_add.c?id=aeeb119fd8652c044cd5ceebce572b5c716914e3\n" +msgstr "" +"\t$ git config git-permalink.template-file-commit 'https://git.alpinelinux.org/apk-tools/tree/%s?id=%s'\n" +"\t$ git permalink src/app_add.c\n" +"\tOuverture de https://git.alpinelinux.org/apk-tools/tree/src/app_add.c?id=aeeb119fd8652c044cd5ceebce572b5c716914e3\n" + +#. type: SH +#: doc/git-permalink.en.1:121 +#, no-wrap +msgid "SEE ALSO" +msgstr "VOIR AUSSI" + +#. type: Plain text +#: doc/git-permalink.en.1:125 +msgid "B(1) B(1)" +msgstr "B(1) B(1)" + +#. type: SH +#: doc/git-permalink.en.1:127 +#, no-wrap +msgid "AUTHORS" +msgstr "AUTEURS" + +#. type: Plain text +#: doc/git-permalink.en.1:133 +msgid "E<.MT eu@euandre.org> EuAndreh E<.ME> and contributors." +msgstr "E<.MT eu@euandre.org> EuAndreh E<.ME> et les contributeurs." + +#. type: SH +#: doc/git-permalink.en.1:135 +#, no-wrap +msgid "BUGS" +msgstr "BUGS" + +#. type: Plain text +#: doc/git-permalink.en.1:144 +msgid "" +"Report bugs to the E<.MT ~euandreh/public-inbox@lists.sr.ht> mailing list E<." +"ME .> Use the subject \"\\f(CR[git-permalink] BUG or TASK: " +"EdescriptionE\\fR\"." +msgstr "" +"Soumettre un bogue dans la E<.MT ~euandreh/public-inbox@lists.sr.ht> liste " +"de diffusion E<.ME .> Utilise le sujèt \"\\f(CR[git-permalink] BUG ou TASK: " +"EdescriptionE\\fR\"." + +#. type: Plain text +#: doc/git-permalink.en.1:149 +msgid "" +"Browse bugs E<.UR https://euandreh.xyz/git-permalink/TODOs.html> online E<." +"UE .>" +msgstr "" +"Parcourir les bogues E<.UR https://euandreh.xyz/git-permalink/TODOs.html> en " +"ligne E<.UE .>" + +#. type: Plain text +#: doc/git-permalink.en.1:153 +msgid "E<.UR https://euandreh.xyz/git-permalink/> Homepage E<.UE .>" +msgstr "E<.UR https://euandreh.xyz/git-permalink/> Page d'accueil E<.UE .>" + +#. type: Plain text +#: doc/git-permalink.en.1:156 +msgid "" +"E<.UR https://lists.sr.ht/~euandreh/public-inbox?search=%5Bgit-permalink%5D> " +"Comments and discussions E<.UE .>" +msgstr "" +"E<.UR https://lists.sr.ht/~euandreh/public-inbox?search=%5Bgit-permalink%5D> " +"Commentaires et discussions E<.UE .>" diff --git a/doc/git-permalink.1 b/doc/git-permalink.1 deleted file mode 100644 index bf4506f..0000000 --- a/doc/git-permalink.1 +++ /dev/null @@ -1,155 +0,0 @@ -.TH GIT-PERMALINK 1 @DATE@ "git-permalink @VERSION@" "git-permalink user manual" - - -.SH NAME - -git-permalink - Git extension to generate web permalinks of files in a repository. - - -.SH SYNOPSYS - -\fBgit-permalink\fR [OPTIONS] \fIFILE\fR [\fILINENO\fR] - - -.SH DESCRIPTION - -\fBgit-permalink\fR will use Git itself to get a) the commit at \fIHEAD\fR and b) the \fIremote.origin.url\fR via \fBgit-config\fR(1), and optionally c) an URL template override. -It then uses those values to build a permalink URL, with the commit included on it to ensure it is \fIpermanent\fR, and optionally the line number of the selected file. - -\fBgit-permalink\fR then uses \fBxdg-open\fR(1) to open the URL. - -.SH OPTIONS - -.TP -\fB-p\fR -Only print the web URL link, don't try to open it with \fBxdg-open\fR(1) or do anything else. -By default this is turned off. - -.TP -\fB--help\fR, \fB-h\fR -Show show help text. - -.TP -\fB--version\fR, \fB-V\fR -Show version number. - - -.SH OVERRIDES - -If you want to configure the permalink URL template for a project with an unsupported origin you can do so via \fBgit-config\fR(1). - -There are two configuration options available: - -.TP -\fBgit-permalink.template-commit-file\fR -An URL template where the \fIcommit\fR comes first, and the name of the \fIfile\fR comes second. -cgit uses this style of URL, with something like in: - -.nf - https://git.euandreh.xyz/fallible/tree/%s?id=%s -.fi - -On this example, the \fIfile\fR comes first and \fIcommit\fR comes at the very end after "id=". - -.TP -\fBgit-permalink.template-file-commit\fR -An URL template where the \fIcommit\fR comes first, and the name of the \fIfile\fR comes second. -sourcehut uses this style of URL, with something like: - -.nf - https://git.sr.ht/~sircmpwn/scdoc/tree/%s/item/%s -.fi - -On this example, the \fIcommit\fR comes first on the URL path, and the \fIfile\fR name comes at the end. - -.P -If none of those values are found by \fBgit-config\fR(1) and \fBgit-permalink\fR can't guess the URL, it exits with an error. - - -.SH SUPPORTED REMOTES - -The current supported remotes are: - -.RS -.IP \(bu -git.euandreh.xyz (where git-permalink itself is hosted =p) -.IP \(bu -sourcehut -.IP \(bu -savannah -.IP \(bu -gitlab -.IP \(bu -github -.RE - -Patches to add support for more source code forges are welcome! - -See -.UR https://euandreh.xyz/git-permalink/TODOs.html#task-cebc5298-17ad-5c60-dfa5-a25b66433a3a -#task-cebc5298-17ad-5c60-dfa5-a25b66433a3a -.UE -for discussion and more information. - - -.SH EXAMPLES - -Open \fIsrc/fold.c\fR of a project with its origin pointing to \fIsourcehut\fR: - -.nf - $ git permalink src/fold.c 125 - Opening https://git.sr.ht/~sircmpwn/ctools/tree/fbf17d92f5ed1c38983f73df912f051ad0f9ef2d/item/src/fold.c#L125 -.fi - -Generate link for lines 59 through 94 of \fInongnu/packages/clojure.scm\fR on a project hosted on \fIgitlab\fR, but only print it \fIwithout\fR opening with \fBxdg-open\fR(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 -Configure an URL override, and open the file \fIsrc/app_add.c\fR without selecting an specific line: - -.nf - $ git config git-permalink.template-file-commit 'https://git.alpinelinux.org/apk-tools/tree/%s?id=%s' - $ git permalink src/app_add.c - Opening https://git.alpinelinux.org/apk-tools/tree/src/app_add.c?id=aeeb119fd8652c044cd5ceebce572b5c716914e3 -.fi - - -.SH SEE ALSO - -\fBgit-config\fR(1) -\fBxdg-open\fR(1) - - -.SH AUTHORS - -.MT eu@euandre.org -EuAndreh -.ME -and contributors. - - -.SH BUGS - -.IP \(bu -Report bugs to the -.MT ~euandreh/public-inbox@lists.sr.ht -mailing list -.ME . -Use the subject "\fC[git-permalink] BUG or TASK: \fR". -.IP \(bu -Browse bugs -.UR https://euandreh.xyz/git-permalink/TODOs.html -online -.UE . -.IP \(bu -.UR https://euandreh.xyz/git-permalink/ -Homepage -.UE . -.IP \(bu -.UR https://lists.sr.ht/~euandreh/public-inbox?search=%5Bgit-permalink%5D -Comments and discussions -.UE . diff --git a/doc/git-permalink.en.1 b/doc/git-permalink.en.1 new file mode 100644 index 0000000..cf9cdca --- /dev/null +++ b/doc/git-permalink.en.1 @@ -0,0 +1,156 @@ +.TH GIT-PERMALINK 1 @DATE@ "git-permalink @VERSION@" "git-permalink user manual" + + +.SH NAME + +git-permalink - Git extension to generate web permalinks of files in a repository. + + +.SH SYNOPSYS + +\fBgit-permalink\fR [OPTIONS] \fIFILE\fR [\fILINENO\fR] + + +.SH DESCRIPTION + +\fBgit-permalink\fR will use Git itself to get a) the commit at \fIHEAD\fR and b) the \fIremote.origin.url\fR via \fBgit-config\fR(1), and optionally c) an URL template override. +It then uses those values to build a permalink URL, with the commit included on it to ensure it is \fIpermanent\fR, and optionally the line number of the selected file. + +\fBgit-permalink\fR then uses \fBxdg-open\fR(1) to open the URL. + +.SH OPTIONS + +.TP +\fB-p\fR +Only print the web URL link, don't try to open it with \fBxdg-open\fR(1) or do anything else. +By default this is turned off. + +.TP +\fB--help\fR, \fB-h\fR +Show show help text. + +.TP +\fB--version\fR, \fB-V\fR +Show version number. + + +.SH OVERRIDES + +If you want to configure the permalink URL template for a project with an unsupported origin you can do so via \fBgit-config\fR(1). + +There are two configuration options available: + +.TP +\fBgit-permalink.template-file-commit\fR +An URL template where the name of the \fIfile\fR comes first, and the \fIcommit\fR comes second. +cgit uses this style of URL, with something like in: + +.nf + https://git.euandreh.xyz/fallible/tree/%s?id=%s +.fi + +On this example, the name of the \fIfile\fR comes first and \fIcommit\fR comes at the very end after "id=". + +.TP +\fBgit-permalink.template-commit-file\fR +An URL template where the \fIcommit\fR comes first, and the name of the \fIfile\fR comes second. +sourcehut uses this style of URL, with something like: + +.nf + https://git.sr.ht/~sircmpwn/scdoc/tree/%s/item/%s +.fi + +On this example, the \fIcommit\fR comes first on the URL path, and the \fIfile\fR name comes at the end. + +.P +If none of those values are found by \fBgit-config\fR(1) and \fBgit-permalink\fR can't guess the URL, it exits with an error. + + +.SH SUPPORTED REMOTES + +The current supported remotes are: + +.RS +.IP \(bu +git.euandreh.xyz (where git-permalink itself is hosted =p) +.IP \(bu +sourcehut +.IP \(bu +savannah +.IP \(bu +gitlab +.IP \(bu +github +.RE + +Patches to add support for more source code forges are welcome! + +See +.UR https://euandreh.xyz/git-permalink/TODOs.html#task-cebc5298-17ad-5c60-dfa5-a25b66433a3a +#task-cebc5298-17ad-5c60-dfa5-a25b66433a3a +.UE +for discussion and more information. + + +.SH EXAMPLES + +Open \fIsrc/fold.c\fR of a project with its origin pointing to \fIsourcehut\fR: + +.nf + $ git permalink src/fold.c 125 + Opening https://git.sr.ht/~sircmpwn/ctools/tree/fbf17d92f5ed1c38983f73df912f051ad0f9ef2d/item/src/fold.c#L125 +.fi + +Generate link for lines 59 through 94 of \fInongnu/packages/clojure.scm\fR on a project hosted on \fIgitlab\fR, but only print it \fIwithout\fR opening with \fBxdg-open\fR(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 +Configure an URL override, and open the file \fIsrc/app_add.c\fR without selecting an specific line: + +.nf + $ git config git-permalink.template-file-commit 'https://git.alpinelinux.org/apk-tools/tree/%s?id=%s' + $ git permalink src/app_add.c + Opening https://git.alpinelinux.org/apk-tools/tree/src/app_add.c?id=aeeb119fd8652c044cd5ceebce572b5c716914e3 +.fi + + +.SH SEE ALSO + +\fBgit-config\fR(1) +\fBxdg-open\fR(1) + + +.SH AUTHORS + +.MT eu@euandre.org +EuAndreh +.ME +and contributors. + + +.SH BUGS + +.IP \(bu +Report bugs to the +.MT ~euandreh/public\-inbox@lists.sr.ht +mailing list +.ME . +Use the subject "\f(CR[git\-permalink] BUG or TASK: +\fR". +.IP \(bu +Browse bugs +.UR https://euandreh.xyz/git\-permalink/TODOs.html +online +.UE . +.IP \(bu +.UR https://euandreh.xyz/git\-permalink/ +Homepage +.UE . +.IP \(bu +.UR https://lists.sr.ht/~euandreh/public\-inbox?search=%5Bgit\-permalink%5D +Comments and discussions +.UE . diff --git a/doc/git-permalink.eo.1 b/doc/git-permalink.eo.1 new file mode 100644 index 0000000..621559a --- /dev/null +++ b/doc/git-permalink.eo.1 @@ -0,0 +1,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: +\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 . diff --git a/doc/git-permalink.fr.1 b/doc/git-permalink.fr.1 new file mode 100644 index 0000000..8c8c6d8 --- /dev/null +++ b/doc/git-permalink.fr.1 @@ -0,0 +1,178 @@ +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH GIT\-PERMALINK 1 @DATE@ "git\-permalink @VERSION@" "manual d'utilisateur de git\-permalink" + + +.SH NOM + +git\-permalink \- extension Git pour génerér liens web permanent (permalink) +de fichiers dans un dépôt. + + +.SH SYNOPSIS + +\fBgit\-permalink\fP [OPTIONS] \fIFICHIERS\fP [\fILINENO\fP] + + +.SH DESCRIPTION + +\fBgit\-permalink\fP utilise Git pour prendre a) le commit au \fIHEAD\fP et b) le +\fIremote.origin.url\fP avec \fBgit\-config\fP(1), et se possible c) un modèle de +substituition d'URL. Il utilise ces valeurs pour construire un URL +\fIpermanent\fP, avec le commit inclus pour garantir la unicitè, e +optionalement le numeró de la ligne choisi. + +\fBgit\-permalink\fP après utilise \fBxdg\-open\fP(1) pour ouvrir l'URL. + +.SH OPTIONS + +.TP +\fB\-p\fP +Seulement imprimez le lien d'URL web, n'essayez pas de l'ouvrir avec +\fBxdg\-open\fP(1) ou faire quelques choses avec lui. Par défaut cela est +désactivé. + +.TP +\fB\-\-help\fP, \fB\-h\fP +Affiche message d'aide. + +.TP +\fB\-\-version\fP, \fB\-V\fP +Imprime le numeró de version. + + +.SH MODÈLES + +Si vous souhaitez configurer le modèle de substitution d'URL pour un projet +que a un références distantes que n'est pas prises en charge, vous utilize +\fBgit\-config\fP(1). + +Il y a deux options de configuration disponible: + +.TP +\fBgit\-permalink.template\-file\-commit\fP +Un modèle de substitution d'URL où le nom du \fIfichier\fP est avant, et le +\fIcommit\fP est après. cgit utilise cette type d'URL, comme dans: + +.nf + https://git.euandreh.xyz/fallible/tree/%s?id=%s +.fi + +Dans cet example, le nom du \fIfichier\fP est avant et le \fIcommit\fP est à la +fin, après le "id=". + +.TP +\fBgit\-permalink.template\-commit\-file\fP +Un modèle de substitution d'URL où le \fIcommit\fP est avant, et le nom du +\fIfichier\fP est après. sourcehut utilise cette type d'URL, comme dans: + +.nf + https://git.sr.ht/~sircmpwn/scdoc/tree/%s/item/%s +.fi + +Dans cet example, le \fIcommit\fP est avant dans le chemin de l'URL, et le +\fIfichier\fP est après. + +.P +Si aucune options n'est pas trouvé par \fBgit\-config\fP(1) et \fBgit\-permalink\fP +ne peut pas deviner l'URL, cela se termine par une erreur. + + +.SH "RÉFÉRENCES DISTANTES PRISES EN CHARGE" + +La liste de références distantes prises en charge est: + +.RS +.IP \(bu +git.euandreh.xyz (où git\-permalink est hébergé =p) +.IP \(bu +sourcehut +.IP \(bu +savannah +.IP \(bu +gitlab +.IP \(bu +github +.RE + +Les changements pour ajouter plus de sites d'hébergement de code sont les +bienvenus! + +Regarde +.UR https://euandreh.xyz/git\-permalink/TODOs.html#task\-cebc5298\-17ad\-5c60\-dfa5\-a25b66433a3a +#task\-cebc5298\-17ad\-5c60\-dfa5\-a25b66433a3a +.UE +pour les discussions et +plus d'information. + + +.SH EXAMPLES + +Ouvrez \fIsrc/fold.c\fP d'un projet qui a de référence distante pointée a +\fIsourcehut\fP: + +.nf + $ git permalink src/fold.c 125 + Ouverture de https://git.sr.ht/~sircmpwn/ctools/tree/fbf17d92f5ed1c38983f73df912f051ad0f9ef2d/item/src/fold.c#L125 +.fi + +Géneréz un lien des lignes 59 à 94 de \fInongnu/packages/clojure.scm\fP dans un +projet hébergér sur \fIgitlab\fP, mais seulement imprimez le lien \fIsans\fP +l'ouvrir avec \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 +Configurez un modèle de substitution d'URL, et ouvrir le fichier +\fIsrc/app_add.c\fP sans choisir un numeró de ligne: + +.nf + $ git config git\-permalink.template\-file\-commit 'https://git.alpinelinux.org/apk\-tools/tree/%s?id=%s' + $ git permalink src/app_add.c + Ouverture de https://git.alpinelinux.org/apk\-tools/tree/src/app_add.c?id=aeeb119fd8652c044cd5ceebce572b5c716914e3 +.fi + + +.SH "VOIR AUSSI" + +\fBgit\-config\fP(1) \fBxdg\-open\fP(1) + + +.SH AUTEURS + +.MT eu@euandre.org +EuAndreh +.ME +et les contributeurs. + + +.SH BUGS + +.IP \(bu +Soumettre un bogue dans la +.MT ~euandreh/public\-inbox@lists.sr.ht +liste +de diffusion +.ME . +Utilise le sujèt "\f(CR[git\-permalink] BUG ou TASK: +\fR". +.IP \(bu +Parcourir les bogues +.UR https://euandreh.xyz/git\-permalink/TODOs.html +en +ligne +.UE . +.IP \(bu +.UR https://euandreh.xyz/git\-permalink/ +Page d'accueil +.UE . +.IP \(bu +.UR https://lists.sr.ht/~euandreh/public\-inbox?search=%5Bgit\-permalink%5D +Commentaires et discussions +.UE . diff --git a/doc/git-permalink.pt.1 b/doc/git-permalink.pt.1 new file mode 100644 index 0000000..1ddf493 --- /dev/null +++ b/doc/git-permalink.pt.1 @@ -0,0 +1,174 @@ +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH GIT\-PERMALINK 1 @DATE@ "git\-permalink @VERSION@" "manual do usuário do git\-permalink" + + +.SH NOME + +git\-permalink \- extensão Git para gerar links web permanentes (permalink) de +arquivos de um repositório. + + +.SH SINOPSE + +\fBgit\-permalink\fP [OPÇÕES] \fIARQUIVO\fP [\fINOLINHA\fP] + + +.SH DESCRIÇÃO + +\fBgit\-permalink\fP usa o próprio Git para pegar a) o commit do \fIHEAD\fP e b) o +\fIremote.origin.url\fP usando \fBgit\-config\fP(1), e opcionalmente c) um modelo +de substituição de URL. Então ele usa esses valores para construir o link +para uma URL \fIpermanente\fP (permalink), com o commit incluso para garantir +sua unicidade, e opcionalmente o número da linha selecionada. + +\fBgit\-permalink\fP depois usa o \fBxdg\-open\fP(1) para abrir a URL. + +.SH OPÇÔES + +.TP +\fB\-p\fP +Somento imprime o link da URL web, não tenta abrí\-lo com \fBxdg\-open\fP(1) ou +fazer qualquer coisa com ele. Por padrão isso está desligado. + +.TP +\fB\-\-help\fP, \fB\-h\fP +Mostra mensagem de ajuda. + +.TP +\fB\-\-version\fP, \fB\-V\fP +Imprime o número da versão. + + +.SH MODELOS + +Se você quiser configurar o modelo de substituição de URL de um projeto que +não tem suporte a um tipo de origem remota você pode fazê\-lo com +\fBgit\-config\fP(1). + +Há dois tipos de opções de configuração disponíveis: + +.TP +\fBgit\-permalink.template\-file\-commit\fP +Um modelo de substituição de URL em que o nome do \fIarquivo\fP vem primeiro, e +o \fIcommit\fP vem depois. cgit usa esse tipo de URL, como em: + +.nf + https://git.euandreh.xyz/fallible/tree/%s?id=%s +.fi + +Nesse exemplo, o nome do \fIarquivo\fP vem primeiro e o \fIcommit\fP vem só no +final, depois do "id=". + +.TP +\fBgit\-permalink.template\-commit\-file\fP +Um modelo de substituição de URL em que o \fIcommit\fP vem primeiro, e o nome +do \fIarquivo\fP vem depois. sourcehut usa esse tipo de URL, como em: + +.nf + https://git.sr.ht/~sircmpwn/scdoc/tree/%s/item/%s +.fi + +Nesse exemplo, o \fIcommit\fP aparece primeiro no caminho da URL, e o nome do +\fIarquivo\fP vem depois. + +.P +Se nenhuma das duas opções for encontrada pelo \fBgit\-config\fP(1) e o +\fBgit\-permalink\fP não consegue adivinhar a URL, ele termina com um erro. + + +.SH "ORIGENS REMOTAS COM SUPORTE" + +A lista atual de origens remotas com suporte é: + +.RS +.IP \(bu +git.euandreh.xyz (onde o próprio git\-permalink está hospedado =p) +.IP \(bu +sourcehut +.IP \(bu +savannah +.IP \(bu +gitlab +.IP \(bu +github +.RE + +Mudanças para adição de mais sites de hospedagem de código são bem\-vindas! + +Veja +.UR https://euandreh.xyz/git\-permalink/TODOs.html#task\-cebc5298\-17ad\-5c60\-dfa5\-a25b66433a3a +#task\-cebc5298\-17ad\-5c60\-dfa5\-a25b66433a3a +.UE +para discussão e mais +informações. + + +.SH EXEMPLOS + +Abre o arquivo \fIsrc/fold.c\fP de um projeto com a origem apontada para o +\fIsourcehut\fP: + +.nf + $ git permalink src/fold.c 125 + Abrindo https://git.sr.ht/~sircmpwn/ctools/tree/fbf17d92f5ed1c38983f73df912f051ad0f9ef2d/item/src/fold.c#L125 +.fi + +Gera um link das linhas 59 a 94 do arquivo \fInongnu/packages/clojure.scm\fP em +um projeto hospedado no \fIgitlab\fP, mas somente o imprimie \fIsem\fP abrí\-lo com +\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 +Configura um modelo de URL, e abre o arquivo \fIsrc/app_add.c\fP sem selecionar +uma linha específica: + +.nf + $ git config git\-permalink.template\-file\-commit 'https://git.alpinelinux.org/apk\-tools/tree/%s?id=%s' + $ git permalink src/app_add.c + Abrindo https://git.alpinelinux.org/apk\-tools/tree/src/app_add.c?id=aeeb119fd8652c044cd5ceebce572b5c716914e3 +.fi + + +.SH "VEJA TAMBÉM" + +\fBgit\-config\fP(1) \fBxdg\-open\fP(1) + + +.SH AUTORES + +.MT eu@euandre.org +EuAndreh +.ME +e colaboradores. + + +.SH BUGS + +.IP \(bu +Relate bugs na +.MT ~euandreh/public\-inbox@lists.sr.ht +lista de discussão +.ME . +Use o assunto "\f(CR[git\-permalink] BUG ou TASK: +\fR". +.IP \(bu +Veja os bugs +.UR https://euandreh.xyz/git\-permalink/TODOs.html +online +.UE . +.IP \(bu +.UR https://euandreh.xyz/git\-permalink/ +Página inicial +.UE . +.IP \(bu +.UR https://lists.sr.ht/~euandreh/public\-inbox?search=%5Bgit\-permalink%5D +Comentários e discussões +.UE . diff --git a/doc/pt.po b/doc/pt.po new file mode 100644 index 0000000..4a98bc5 --- /dev/null +++ b/doc/pt.po @@ -0,0 +1,417 @@ +# SOME DESCRIPTIVE TITLE +# Copyright (C) YEAR Free Software Foundation, Inc. +# This file is distributed under the same license as the PACKAGE package. +# FIRST AUTHOR , YEAR. +# +msgid "" +msgstr "" +"Project-Id-Version: \n" +"POT-Creation-Date: 2021-06-18 21:45-0300\n" +"PO-Revision-Date: 2021-06-19 01:37-0300\n" +"Last-Translator: \n" +"Language-Team: \n" +"Language: pt\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"X-Generator: Poedit 2.4.3\n" + +#. type: TH +#: doc/git-permalink.en.1:1 +#, no-wrap +msgid "GIT-PERMALINK" +msgstr "GIT-PERMALINK" + +#. type: TH +#: doc/git-permalink.en.1:1 +#, no-wrap +msgid "@DATE@" +msgstr "@DATE@" + +#. type: TH +#: doc/git-permalink.en.1:1 +#, no-wrap +msgid "git-permalink @VERSION@" +msgstr "git-permalink @VERSION@" + +#. type: TH +#: doc/git-permalink.en.1:1 +#, no-wrap +msgid "git-permalink user manual" +msgstr "manual do usuário do git-permalink" + +#. type: SH +#: doc/git-permalink.en.1:4 +#, no-wrap +msgid "NAME" +msgstr "NOME" + +#. type: Plain text +#: doc/git-permalink.en.1:7 +msgid "" +"git-permalink - Git extension to generate web permalinks of files in a " +"repository." +msgstr "" +"git-permalink - extensão Git para gerar links web permanentes (permalink) de " +"arquivos de um repositório." + +#. type: SH +#: doc/git-permalink.en.1:9 +#, no-wrap +msgid "SYNOPSYS" +msgstr "SINOPSE" + +#. type: Plain text +#: doc/git-permalink.en.1:12 +msgid "B [OPTIONS] I [I]" +msgstr "B [OPÇÕES] I [I]" + +#. type: SH +#: doc/git-permalink.en.1:14 +#, no-wrap +msgid "DESCRIPTION" +msgstr "DESCRIÇÃO" + +#. type: Plain text +#: doc/git-permalink.en.1:18 +msgid "" +"B will use Git itself to get a) the commit at I and b) " +"the I via B(1), and optionally c) an URL " +"template override. It then uses those values to build a permalink URL, with " +"the commit included on it to ensure it is I, and optionally the " +"line number of the selected file." +msgstr "" +"B usa o próprio Git para pegar a) o commit do I e b) o " +"I usando B(1), e opcionalmente c) um modelo " +"de substituição de URL. Então ele usa esses valores para construir o link " +"para uma URL I (permalink), com o commit incluso para garantir " +"sua unicidade, e opcionalmente o número da linha selecionada." + +#. type: Plain text +#: doc/git-permalink.en.1:20 +msgid "B then uses B(1) to open the URL." +msgstr "B depois usa o B(1) para abrir a URL." + +#. type: SH +#: doc/git-permalink.en.1:21 +#, no-wrap +msgid "OPTIONS" +msgstr "OPÇÔES" + +#. type: TP +#: doc/git-permalink.en.1:23 +#, no-wrap +msgid "B<-p>" +msgstr "B<-p>" + +#. type: Plain text +#: doc/git-permalink.en.1:27 +msgid "" +"Only print the web URL link, don't try to open it with B(1) or do " +"anything else. By default this is turned off." +msgstr "" +"Somento imprime o link da URL web, não tenta abrí-lo com B(1) ou " +"fazer qualquer coisa com ele. Por padrão isso está desligado." + +#. type: TP +#: doc/git-permalink.en.1:28 +#, no-wrap +msgid "B<--help>, B<-h>" +msgstr "B<--help>, B<-h>" + +#. type: Plain text +#: doc/git-permalink.en.1:31 +msgid "Show show help text." +msgstr "Mostra mensagem de ajuda." + +#. type: TP +#: doc/git-permalink.en.1:32 +#, no-wrap +msgid "B<--version>, B<-V>" +msgstr "B<--version>, B<-V>" + +#. type: Plain text +#: doc/git-permalink.en.1:35 +msgid "Show version number." +msgstr "Imprime o número da versão." + +#. type: SH +#: doc/git-permalink.en.1:37 +#, no-wrap +msgid "OVERRIDES" +msgstr "MODELOS" + +#. type: Plain text +#: doc/git-permalink.en.1:40 +msgid "" +"If you want to configure the permalink URL template for a project with an " +"unsupported origin you can do so via B(1)." +msgstr "" +"Se você quiser configurar o modelo de substituição de URL de um projeto que " +"não tem suporte a um tipo de origem remota você pode fazê-lo com B(1)." + +#. type: Plain text +#: doc/git-permalink.en.1:42 +msgid "There are two configuration options available:" +msgstr "Há dois tipos de opções de configuração disponíveis:" + +#. type: TP +#: doc/git-permalink.en.1:43 +#, no-wrap +msgid "B" +msgstr "B" + +#. type: Plain text +#: doc/git-permalink.en.1:47 +msgid "" +"An URL template where the name of the I comes first, and the I " +"comes second. cgit uses this style of URL, with something like in:" +msgstr "" +"Um modelo de substituição de URL em que o nome do I vem primeiro, e " +"o I vem depois. cgit usa esse tipo de URL, como em:" + +#. type: Plain text +#: doc/git-permalink.en.1:50 +#, no-wrap +msgid "\thttps://git.euandreh.xyz/fallible/tree/%s?id=%s\n" +msgstr "\thttps://git.euandreh.xyz/fallible/tree/%s?id=%s\n" + +#. type: Plain text +#: doc/git-permalink.en.1:53 +msgid "" +"On this example, the name of the I comes first and I comes at " +"the very end after \"id=\"." +msgstr "" +"Nesse exemplo, o nome do I vem primeiro e o I vem só no " +"final, depois do \"id=\"." + +#. type: TP +#: doc/git-permalink.en.1:54 +#, no-wrap +msgid "B" +msgstr "B" + +#. type: Plain text +#: doc/git-permalink.en.1:58 +msgid "" +"An URL template where the I comes first, and the name of the I " +"comes second. sourcehut uses this style of URL, with something like:" +msgstr "" +"Um modelo de substituição de URL em que o I vem primeiro, e o nome " +"do I vem depois. sourcehut usa esse tipo de URL, como em:" + +#. type: Plain text +#: doc/git-permalink.en.1:61 +#, no-wrap +msgid "\thttps://git.sr.ht/~sircmpwn/scdoc/tree/%s/item/%s\n" +msgstr "\thttps://git.sr.ht/~sircmpwn/scdoc/tree/%s/item/%s\n" + +#. type: Plain text +#: doc/git-permalink.en.1:64 +msgid "" +"On this example, the I comes first on the URL path, and the I " +"name comes at the end." +msgstr "" +"Nesse exemplo, o I aparece primeiro no caminho da URL, e o nome do " +"I vem depois." + +#. type: Plain text +#: doc/git-permalink.en.1:67 +msgid "" +"If none of those values are found by B(1) and B " +"can't guess the URL, it exits with an error." +msgstr "" +"Se nenhuma das duas opções for encontrada pelo B(1) e o B não consegue adivinhar a URL, ele termina com um erro." + +#. type: SH +#: doc/git-permalink.en.1:69 +#, no-wrap +msgid "SUPPORTED REMOTES" +msgstr "ORIGENS REMOTAS COM SUPORTE" + +#. type: Plain text +#: doc/git-permalink.en.1:72 +msgid "The current supported remotes are:" +msgstr "A lista atual de origens remotas com suporte é:" + +#. type: IP +#: doc/git-permalink.en.1:74 doc/git-permalink.en.1:76 +#: doc/git-permalink.en.1:78 doc/git-permalink.en.1:80 +#: doc/git-permalink.en.1:82 doc/git-permalink.en.1:137 +#: doc/git-permalink.en.1:144 doc/git-permalink.en.1:149 +#: doc/git-permalink.en.1:153 +#, no-wrap +msgid "\\(bu" +msgstr "\\(bu" + +#. type: Plain text +#: doc/git-permalink.en.1:76 +msgid "git.euandreh.xyz (where git-permalink itself is hosted =p)" +msgstr "git.euandreh.xyz (onde o próprio git-permalink está hospedado =p)" + +#. type: Plain text +#: doc/git-permalink.en.1:78 +msgid "sourcehut" +msgstr "sourcehut" + +#. type: Plain text +#: doc/git-permalink.en.1:80 +msgid "savannah" +msgstr "savannah" + +#. type: Plain text +#: doc/git-permalink.en.1:82 +msgid "gitlab" +msgstr "gitlab" + +#. type: Plain text +#: doc/git-permalink.en.1:84 +msgid "github" +msgstr "github" + +#. type: Plain text +#: doc/git-permalink.en.1:87 +msgid "Patches to add support for more source code forges are welcome!" +msgstr "" +"Mudanças para adição de mais sites de hospedagem de código são bem-vindas!" + +#. type: Plain text +#: doc/git-permalink.en.1:93 +msgid "" +"See E<.UR https://euandreh.xyz/git-permalink/TODOs.html#task-" +"cebc5298-17ad-5c60-dfa5-a25b66433a3a> #task-cebc5298-17ad-5c60-dfa5-" +"a25b66433a3a E<.UE> for discussion and more information." +msgstr "" +"Veja E<.UR https://euandreh.xyz/git-permalink/TODOs.html#task-" +"cebc5298-17ad-5c60-dfa5-a25b66433a3a> #task-cebc5298-17ad-5c60-dfa5-" +"a25b66433a3a E<.UE> para discussão e mais informações." + +#. type: SH +#: doc/git-permalink.en.1:95 +#, no-wrap +msgid "EXAMPLES" +msgstr "EXEMPLOS" + +#. type: Plain text +#: doc/git-permalink.en.1:98 +msgid "" +"Open I of a project with its origin pointing to I:" +msgstr "" +"Abre o arquivo I de um projeto com a origem apontada para o " +"I:" + +#. type: Plain text +#: doc/git-permalink.en.1:102 +#, no-wrap +msgid "" +"\t$ git permalink src/fold.c 125\n" +"\tOpening https://git.sr.ht/~sircmpwn/ctools/tree/fbf17d92f5ed1c38983f73df912f051ad0f9ef2d/item/src/fold.c#L125\n" +msgstr "" +"\t$ git permalink src/fold.c 125\n" +"\tAbrindo https://git.sr.ht/~sircmpwn/ctools/tree/fbf17d92f5ed1c38983f73df912f051ad0f9ef2d/item/src/fold.c#L125\n" + +#. type: Plain text +#: doc/git-permalink.en.1:105 +msgid "" +"Generate link for lines 59 through 94 of I on a " +"project hosted on I, but only print it I opening with B(1):" +msgstr "" +"Gera um link das linhas 59 a 94 do arquivo I em " +"um projeto hospedado no I, mas somente o imprimie I abrí-lo com " +"B(1):" + +#. type: Plain text +#: doc/git-permalink.en.1:109 +#, no-wrap +msgid "" +"\t$ git permalink -p nongnu/packages/clojure.scm 59-94\n" +"\thttps://gitlab.com/nonguix/nonguix/-/blob/c9d7f30bcbd3a6e3076e56a972c33963c73c4d58/nongnu/packages/clojure.scm#L59-94\n" +msgstr "" +"\t$ git permalink -p nongnu/packages/clojure.scm 59-94\n" +"\thttps://gitlab.com/nonguix/nonguix/-/blob/c9d7f30bcbd3a6e3076e56a972c33963c73c4d58/nongnu/packages/clojure.scm#L59-94\n" + +#. type: Plain text +#: doc/git-permalink.en.1:113 +msgid "" +"Configure an URL override, and open the file I without " +"selecting an specific line:" +msgstr "" +"Configura um modelo de URL, e abre o arquivo I sem selecionar " +"uma linha específica:" + +#. type: Plain text +#: doc/git-permalink.en.1:118 +#, no-wrap +msgid "" +"\t$ git config git-permalink.template-file-commit 'https://git.alpinelinux.org/apk-tools/tree/%s?id=%s'\n" +"\t$ git permalink src/app_add.c\n" +"\tOpening https://git.alpinelinux.org/apk-tools/tree/src/app_add.c?id=aeeb119fd8652c044cd5ceebce572b5c716914e3\n" +msgstr "" +"\t$ git config git-permalink.template-file-commit 'https://git.alpinelinux.org/apk-tools/tree/%s?id=%s'\n" +"\t$ git permalink src/app_add.c\n" +"\tAbrindo https://git.alpinelinux.org/apk-tools/tree/src/app_add.c?id=aeeb119fd8652c044cd5ceebce572b5c716914e3\n" + +#. type: SH +#: doc/git-permalink.en.1:121 +#, no-wrap +msgid "SEE ALSO" +msgstr "VEJA TAMBÉM" + +#. type: Plain text +#: doc/git-permalink.en.1:125 +msgid "B(1) B(1)" +msgstr "B(1) B(1)" + +#. type: SH +#: doc/git-permalink.en.1:127 +#, no-wrap +msgid "AUTHORS" +msgstr "AUTORES" + +#. type: Plain text +#: doc/git-permalink.en.1:133 +msgid "E<.MT eu@euandre.org> EuAndreh E<.ME> and contributors." +msgstr "E<.MT eu@euandre.org> EuAndreh E<.ME> e colaboradores." + +#. type: SH +#: doc/git-permalink.en.1:135 +#, no-wrap +msgid "BUGS" +msgstr "BUGS" + +#. type: Plain text +#: doc/git-permalink.en.1:144 +msgid "" +"Report bugs to the E<.MT ~euandreh/public-inbox@lists.sr.ht> mailing list E<." +"ME .> Use the subject \"\\f(CR[git-permalink] BUG or TASK: " +"EdescriptionE\\fR\"." +msgstr "" +"Relate bugs na E<.MT ~euandreh/public-inbox@lists.sr.ht> lista de discussão " +"E<.ME .> Use o assunto \"\\f(CR[git-permalink] BUG ou TASK: " +"EdescriçãoE\\fR\"." + +#. type: Plain text +#: doc/git-permalink.en.1:149 +msgid "" +"Browse bugs E<.UR https://euandreh.xyz/git-permalink/TODOs.html> online E<." +"UE .>" +msgstr "" +"Veja os bugs E<.UR https://euandreh.xyz/git-permalink/TODOs.html> online E<." +"UE .>" + +#. type: Plain text +#: doc/git-permalink.en.1:153 +msgid "E<.UR https://euandreh.xyz/git-permalink/> Homepage E<.UE .>" +msgstr "E<.UR https://euandreh.xyz/git-permalink/> Página inicial E<.UE .>" + +#. type: Plain text +#: doc/git-permalink.en.1:156 +msgid "" +"E<.UR https://lists.sr.ht/~euandreh/public-inbox?search=%5Bgit-permalink%5D> " +"Comments and discussions E<.UE .>" +msgstr "" +"E<.UR https://lists.sr.ht/~euandreh/public-inbox?search=%5Bgit-permalink%5D> " +"Comentários e discussões E<.UE .>" diff --git a/src/git-permalink.sh b/src/git-permalink.sh index f83bab3..2deb97e 100755 --- a/src/git-permalink.sh +++ b/src/git-permalink.sh @@ -5,7 +5,7 @@ set -eu MSG_USAGE_EN='Usage: git permalink [-phV] FILE [LINENO]' MSG_USAGE_PT='Uso: git permalink [-phV] ARQUIVO [NOLINHA]' MSG_USAGE_FR='Usage: git permalink [-phV] FICHIER [LINENO]' -MSG_USAGE_EO='Uzmaniero: git permalink [-phV] ARKIVO [LINIONO]' +MSG_USAGE_EO='Uzmaniero: git permalink [-phV] DOSIERO [LINIONO]' MSG_HELP_EN='Options: -p only print the link, don'"'"'t try to open it @@ -27,7 +27,7 @@ MSG_HELP_EO='Ebloj: MSG_MISSING_FILE_EN="Missing FILE argument." MSG_MISSING_FILE_PT="Faltando argumento ARQUIVO." MSG_MISSING_FILE_FR="L'argument FICHIER manque." -MSG_MISSING_FILE_EO="La argumento ARKIVO mankas." +MSG_MISSING_FILE_EO="La argumento DOSIERO mankas." MSG_UNSUPPORTED_ORIGIN_EN='Unsupported origin: %s. -- cgit v1.2.3