docs

A barra de ferramentas

Uma barra por tipo de visão, cada uma totalmente personalizável: clique nela com o botão direito (ou Visualizar → Personalizar Barra de Ferramentas…) e arraste itens para fora, reorganize-os, adicione o que começa oculto. Cada visão lembra seu próprio arranjo entre as aberturas do app.

Como funciona a personalização

O PullMark não tem uma barra de ferramentas — tem uma por tipo de visão, do mesmo jeito que a janela de composição do Mail mantém uma barra diferente da janela principal. Você personaliza a barra que está vendo: abra um arquivo de pull request para personalizar a barra de arquivo de PR, um documento local para personalizar a barra de arquivo local. A paleta só oferece os itens que existem onde você a abriu.

Tudo na paleta é permitido — remova, reordene, solte um Espaço Flexível para afastar os grupos. Itens marcados como oculto abaixo começam na paleta, não na barra. O único lugar aonde itens não vão é a faixa da própria barra lateral, ao lado do botão de alternância: aquela seção pertence ao sistema, e o que for solto lá se acomoda no início da seção principal. Restaure qualquer barra arrastando o conjunto padrão de volta, do rodapé da paleta.

Em toda visão

Item	Padrão	O que faz
Voltar/Avançar	exibido	Volta e avança por todos os documentos que você viu — mantenha uma das setas pressionada para ver o histórico.
Review	exibido	O controle de revisão que se transforma, só em visões de PR — contagem de comentários pendentes, veredito, envio. Sobrevive mais tempo a uma janela estreita: o status da revisão continua visível quando os outros itens recolhem para o overflow.
Abrir Arquivo ou Pasta	exibido	Abrir Markdown local ou uma pasta como Localização.
Abrir Pull Request	exibido	Abrir um pull request do GitHub por URL.
Aparência	exibido	Claro · Escuro · Sistema, para o app inteiro.

Arquivos locais

Item	Padrão	O que faz
Compartilhar	exibido	A folha padrão de compartilhamento para o arquivo.
Editar	exibido	Modo de Edição — clique em qualquer bloco para editar no lugar.
Comparar	exibido	Comparar com um commit ou branch (exige um repositório git). Um pontinho significa que o arquivo tem mudanças não commitadas.
Blame	exibido	Quem mudou cada bloco por último; desativado fora de um repositório.
Sumário	exibido	A barra lateral de títulos.
Recarregar	exibido	Reler o arquivo do disco.
Código-Fonte	oculto	O Markdown cru por trás da página renderizada.
Mais Zoom · Tamanho Real · Menos Zoom	oculto	Itens separados — adicione só o par que você usa.
Largura do Conteúdo	oculto	Standard · Wide · Full Width.
Adicionar Nota de Margem	oculto	Só na paleta enquanto as notas de margem estiverem ativadas.

Documentos do GitHub

Documentos lidos direto de um repositório — abertos por links, ⌘K ou uma Localização de repositório navegado.

Item	Padrão	O que faz
Comparar	exibido	O mesmo documento em outra branch, como diff renderizado.
Blame	exibido	Blame por bloco, pela API do GitHub.
Sumário	exibido	A barra lateral de títulos.
Compartilhar	oculto	A página github.com do documento — o link que uma pessoa quer de verdade, nunca uma URL crua.
Recarregar	oculto	Re-resolve a branch para sua ponta atual e rebusca. Desativado — com o motivo — para documentos abertos num commit específico, que não pode mudar.
Código-Fonte	oculto	O Markdown cru.
Itens de zoom · Largura do Conteúdo	oculto	Como nos arquivos locais.

Arquivos de pull request

Item	Padrão	O que faz
Navegação do PR	exibido	De volta à visão geral, arquivo Markdown anterior/seguinte e o menu de salto n-de-m — um grupo só, uma unidade arrastável.
Visualizar	exibido	Diff Renderizado · Diff do Código-Fonte · Resultado, centralizado.
Sumário	exibido	A barra lateral de títulos.
Layout	exibido	Em linha ou lado a lado — ativo na visão Diff Renderizado (arquivos novos sempre renderizam em linha).
Blame	exibido	Ativo na visão Resultado, onde há um documento pronto para anotar.
Comentar no Arquivo	exibido	Um comentário sobre o arquivo como um todo, não sobre uma linha específica.
Itens de zoom · Largura do Conteúdo	oculto	Como nos arquivos locais.

A visão geral do PR e docs de repositório navegados de um PR

A visão geral se mantém mínima: Compartilhar (a página do pull request no GitHub) mais os itens de toda visão. Um documento de repositório navegado a partir do conteúdo de um PR carrega Blame e Sumário, com os itens de zoom e a Largura do Conteúdo na sua paleta.