.\"******************************************************************* .\" .\" 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 [\fIOPÇÕES\fP] \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 Somente imprime o link da URL web na saída padrão (STDOUT), 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 CONFIGURAÇÃO .SS "ORIGENS REMOTAS COM SUPORTE" A lista atual de origens remotas com suporte é: .RS .IP \(bu euandreh.xyz (onde o próprio git\-permalink está hospedado =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 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#td\-cebc5298\-17ad\-5c60\-dfa5\-a25b66433a3a #td\-cebc5298\-17ad\-5c60\-dfa5\-a25b66433a3a .UE para discussão e mais informações. .SS 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://euandreh.xyz/fallible.git/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 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 imprime \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 .P Abre o arquivo \fI\-\-help\fP: .nf $ git permalink \-\- \-\-help Abrindo https://euandreh.xyz/non\-existent\-repository.git/tree/\-\-help?id=470a9fa9329495cfcbef8cc5e32e3a38d3c3103e .fi .SH "CÓDIGO DE SAÍDA" .TP \fB0\fP Execução bem\-sucedida. .TP \fB1\fP Sem suporte à origem remota. Veja a lista de quais tem suporte em ORIGENS REMOTAS COM SUPORTE, e como adicionar origens customizadas a partir de um modelo em MODELOS. .TP \fB2\fP Argumentos inválidos. .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/pt/ Página inicial .UE . .IP \(bu .UR https://lists.sr.ht/~euandreh/public\-inbox?search=%5Bgit\-permalink%5D Comentários e discussões .UE .