Git Blog

O que é Git Blog?

Git Blog é um app de escrita em Markdown para iPhone e iPad que permite rascunhar, editar e publicar posts de blog diretamente no seu repositório GitHub. Foi projetado para escritores que querem criar conteúdo em dispositivos móveis enquanto trabalham com fluxos de sites estáticos, incluindo Jekyll, Hugo, Astro e outros geradores de sites estáticos.

O app se conecta ao seu repositório para que você gerencie novos posts e edições em arquivos Markdown existentes, publicando alterações com fluxos que combinam com hábitos de branch Git ou pull requests.

Principais Recursos

• Editor de Markdown baseado em blocos com arrastar para reordenar cabeçalhos, listas, citações e blocos de código durante a escrita
• Integração com câmera e biblioteca de fotos, com o app processando e enviando imagens como parte do post
• Opções de layout de imagem (largura total, metade, lado a lado e classes de layout adicionais) para controlar como as imagens aparecem nos posts
• Modelos flexíveis de frontmatter com campos personalizados (incluindo texto, dropdowns e seletores de imagem) e suporte para importar frontmatter de posts existentes no repositório
• Múltiplos modos de publicação: push direto para a branch principal, criar nova branch ou abrir pull request
• Navegador de repositório para visualizar a estrutura de arquivos, abrir arquivos Markdown existentes, editá-los e republicar
• Modos de aparência claro, escuro e do sistema
• Armazenamento seguro de tokens usando o keychain do dispositivo

Como Usar o Git Blog

1. Abra o Git Blog no seu iPhone ou iPad e conecte-o ao seu repositório GitHub.
2. Crie um novo post Markdown usando o editor baseado em blocos, adicionando conteúdo e inserindo imagens conforme necessário.
3. Use modelos de frontmatter para definir campos obrigatórios (ou importe frontmatter de um post existente) para que o post siga a estrutura do seu site.
4. Publique usando o fluxo preferido — push para main, criar branch ou abrir pull request — e deixe o app gerenciar o commit (incluindo imagens).
5. Para revisar conteúdo existente, use o navegador de repositório para abrir um arquivo Markdown, editá-lo e republicar.

Casos de Uso

• Rascunhar um novo post de blog longe do laptop, publicando diretamente no seu site baseado em GitHub em um único fluxo móvel
• Editar posts Markdown já publicados navegando pela estrutura do repositório, abrindo um arquivo, aplicando atualizações e republicando
• Gerenciar posts para geradores de sites estáticos que dependem de campos de frontmatter (como selecionar valores de dropdowns ou fornecer seletores de imagem)
• Construir e formatar posts técnicos que exigem blocos de código e estrutura consistente, usando o editor baseado em blocos e reordenando blocos durante a escrita
• Publicar alterações em um fluxo Git amigável para equipes, fazendo push direto para main quando apropriado ou criando branch/pull request quando revisão é necessária

FAQ

• O Git Blog suporta geradores de sites estáticos?
  Sim. É descrito como compatível com Jekyll, Hugo, Astro e qualquer gerador de sites estáticos.

• Posso publicar alterações como pull request em vez de push para main?
  Sim. O app suporta publicação abrindo um pull request, além de push direto para a branch principal ou criação de nova branch.

• Como funciona o envio de imagens?
  Você pode tirar uma foto ou selecionar da biblioteca, e o Git Blog processa e envia as imagens junto com o post. O app inclui as imagens no commit durante a publicação.

• Posso editar arquivos Markdown existentes no meu repositório?
  Sim. O Git Blog inclui um navegador de repositório para abrir arquivos Markdown existentes, editá-los e republicar.

• Quais dispositivos e versões de SO são necessários?
  A listagem na App Store indica iOS 17.0 ou posterior para iPhone, iPadOS 17.0 ou posterior para iPad, macOS 14.0 ou posterior com chip Apple M1 ou superior para Mac, e visionOS 1.0 ou posterior para Apple Vision.

Alternativas

• Editores Markdown com suporte a GitHub (desktop/móvel): Também geram Markdown e sincronizam com GitHub, mas podem depender de operações Git manuais ou experiências de edição diferentes de um editor baseado em blocos.
• Ferramentas CMS para sites estáticos (editores de conteúdo web): Focam em autoria sem fluxos diretos de branch/pull request Git, o que pode simplificar a publicação, mas pode não combinar com um processo centrado em Git.
• Fluxos locais de sites estáticos (editar Markdown e build local): Oferecem controle total sobre renderização e previews, mas geralmente exigem um computador em vez de rascunhar e publicar diretamente de um telefone ou tablet.
• Edição web-based do GitHub: Mantém tudo na interface do GitHub para edições rápidas, mas não oferece o mesmo editor de blocos Markdown mobile-first e modelagem de frontmatter descritos para o Git Blog.