docs
Ajustes
Tudo atrás de ⌘, — quatro abas: Geral para comportamento, Aparência para como o PullMark se apresenta, Teclado para o mapa de teclas e Experimental para recursos ainda assentando. A janela reabre na aba que você usou por último.
Geral
Lendo isto onde o PullMark (0.28.1+) está instalado? Abra a aba Geral.
Leitura
| Ajuste | Opções · padrão | O que faz |
|---|---|---|
| Reabrir a sessão anterior ao iniciar | on/off — off para novas instalações | Reabre o que estava na barra lateral quando o PullMark foi encerrado — arquivos, pastas, PRs, issues, repositórios navegados e a entrada de prévia (ainda como prévia). Desligado, só Fixados volta. Quem já tinha uma sessão antes da 0.45.0 continua reabrindo. Depois de um crash ou encerramento forçado, um banner oferece a sessão anterior de volta de qualquer jeito — nada se perde até você dizer Agora Não. |
| Mostrar arquivos ocultos | on/off — off | Dotfiles e pastas ocultas em Localizações — docs em
.github/ e afins. Também alternável com
⇧⌘. (o mesmo atalho do Finder) ou Visualizar → Mostrar
Arquivos Ocultos; cada Localização aberta re-escaneia na troca. |
| Links de Markdown do GitHub | Perguntar no primeiro clique · Abrir no PullMark · Abrir no Navegador — Perguntar no primeiro clique | O que clicar num link para um arquivo Markdown no GitHub faz. Segure ⌘ ao clicar para o outro comportamento. A caixa “Lembrar minha escolha” do diálogo do primeiro clique define isto por você. |
| Clicar em arquivos em Localizações | Prévia Primeiro · Abrir por Completo — Prévia Primeiro | Prévia Primeiro mostra um arquivo com um clique sem mantê-lo — uma entrada em itálico (em Arquivos Abertos, ou sob seu repositório do GitHub) que a próxima prévia substitui; clique duas vezes ou comece a editar para mantê-lo. Abrir por Completo mantém cada arquivo que você clica. Vale para pastas locais e repositórios navegados do GitHub igualmente. Veja Prévias. |
Revisão
| Ajuste | Opções · padrão | O que faz |
|---|---|---|
| Layout padrão do diff | Em linha · Lado a lado — Em linha | Como os diffs renderizados de PR abrem. Alternável por arquivo com ⌥⌘L. |
| Mostrar pull requests e issues que envolvem você | on/off — on | Os grupos de envolvimento e os repositórios seguidos nas seções Pull Requests e Issues. Oculto de qualquer forma quando você não está conectado. |
| Só pull requests que alteram Markdown | on/off — on | Esconde pull requests sem arquivos Markdown — o PullMark não tem nada a mostrar para eles. |
| Agrupar trabalho do GitHub por | Tipo · Participação — Tipo | Tipo mantém uma seção Pull Requests e uma seção Issues. Participação cria uma única seção GitHub cujos grupos misturam os dois tipos, com um glifo por linha. |
| Mostrar a discussão da revisão na visão geral do PR | on/off — on | Threads de revisão inline aninhadas sob sua revisão na conversa da visão geral — todas as threads, incluindo arquivos que o PullMark não renderiza, com o trecho comentado ao lado. Desligado, mostra só vereditos e comentários. Graduado do Experimental na 0.34. |
GitHub
| Ajuste | O que faz |
|---|---|
| Conexão | Se o PullMark consegue falar com o GitHub, como quem, e por qual
fonte de credenciais ("Conectado como você · GitHub CLI").
Verificar Novamente relê as credenciais — depois de
gh auth login, ele conecta sem reabrir o app — e
Configurar… abre um passo a passo que detecta o que falta
neste Mac. Veja
Acesso ao GitHub
para a história completa das credenciais. |
Atualizações
| Ajuste | O que faz |
|---|---|
| Mostrar Novidades depois de uma atualização | Ligado (o padrão) apresenta as notas da versão depois que uma atualização chega; desligado troca por um banner discreto “Atualizado para o PullMark X” com as notas a um clique — uma atualização sempre se anuncia de algum jeito. |
| Atualizações | Buscar Atualizações… sob demanda; o PullMark também verifica na abertura e periodicamente. Quando uma atualização já é conhecida, a linha oferece Novidades, Atualizar Agora e um botão de re-verificação ali mesmo. As Novidades mostram as notas de cada release entre a sua versão e a nova, e Ajuda → Notas da Versão tem o histórico completo a qualquer momento. |
Sistema
| Ajuste | O que faz |
|---|---|
| App padrão de Markdown | Mostra qual app abre arquivos .md hoje;
Tornar o PullMark o Padrão reivindica o vínculo com
um clique. Se uma atualização futura fizer o macOS derrubá-lo, o
PullMark percebe e se oferece para retomá-lo. |
| Linha de comando | Instala o comando
pullmark em /usr/local/bin para
instalações via DMG (usuários do Homebrew já o têm). Mostra uma
marca quando um pullmark já está no seu PATH. |
| Prévias do Quick Look | Renderizado (o padrão) ou Código-Fonte — o que pressionar espaço no Finder mostra para arquivos Markdown. |
Aparência
Lendo isto onde o PullMark (0.28.1+) está instalado? Abra a aba Aparência.
O seletor Claro · Escuro · Sistema fica no topo — o app inteiro acompanha, cromo e páginas renderizadas por igual (cada tema traz seus próprios visuais claro e escuro). Abaixo dele, as opções visuais:
Cada escolha aqui é um cartão com prévia ao vivo, renderizada pelo pipeline de verdade — o que você vê é o que os documentos recebem.
Tema ↗
| Tema | Visual |
|---|---|
| GitHub (padrão) | O visual clássico, exatamente como em github.com. |
| Editorial | Títulos serifados de livro, sobre papel de tom quente. |
| Terminal | Monoespaçada com um toque de verde fósforo. |
Temas personalizados: solte arquivos
.css na pasta Themes (botão nesta aba) e eles aparecem
como cartões. Aplicam-se sobre o visual GitHub, seguem a aparência
Light/Dark e reestilizam os diffs também. As prévias do Quick Look
seguem seu tema (temas personalizados recuam para sua base GitHub
lá).
Largura do conteúdo ↗
| Escolha | Significado |
|---|---|
| Standard (padrão) | Uma medida clássica de leitura, como a de um livro. |
| Wide | Linhas mais longas, mais na tela — ainda limita o comprimento da linha. |
| Full Width | O texto usa a janela inteira — útil em tela cheia. |
Vale em todo lugar, ao vivo, e compõe com temas, blame, diffs e zoom. Também alternável no meio da leitura em Visualizar → Largura do Conteúdo.
Números de linha ↗
| Escolha | Significado |
|---|---|
| Ocultos (padrão) | Uma margem limpa; números sob demanda na visão Código-Fonte. |
| Visíveis | A linha inicial de cada bloco no código-fonte, na margem de documentos renderizados e diffs — passe o mouse sobre um número para o intervalo completo do bloco. A numeração é por bloco, não por linha visual (o texto renderizado quebra livremente). A visão do código-fonte cru sempre mostra os próprios números de linha. |
Teclado
Lendo isto onde o PullMark (0.28.1+) está instalado? Abra a aba Teclado.
O atalho de cada ação de menu é reatribuível — veja Atalhos de teclado para o mapa completo e como funcionam a gravação, os conflitos e o Restaurar Padrões.
Experimental
Lendo isto onde o PullMark (0.28.1+) está instalado? Abra a aba Experimental.
Recursos lançados antes de o design assentar, cada um rotulado beta ou alfa — o contrato de níveis explica o que cada um promete. Recursos alfa ficam ocultos até você ativar Mostrar recursos alfa (um diálogo explica os termos do alfa primeiro), e cada recurso tem seu próprio interruptor. As notas de margem moram aqui — beta desde a 0.35 e ativadas por padrão, com seu interruptor, o ajuste de autor e um botão Copiar para o trecho de instruções para agentes; o primeiro uso apresenta o recurso e oferece desligá-lo.
Onde as coisas ficam guardadas
Todas as preferências vivem no domínio de defaults
app.pullmark.PullMark. Sessões, posições de leitura e
rascunhos são apenas metadados — o PullMark nunca copia seus documentos
para lugar nenhum, e o conteúdo buscado do GitHub fica em memória.