.\"*******************************************************************
.\"
.\" 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:
<descrição>\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 .