O que é um GitHub Gist?

Você provavelmente já ouviu falar do GitHub , a plataforma para hospedar, armazenar e editar código. Muitos projetos de código aberto e equipes de desenvolvimento privadas usam este aplicativo da web para compartilhar seu trabalho.

Mas você sabia que o GitHub tem um spin-off bem escondido chamado GitHub Gist? É uma maneira mais rápida e simples de compartilhar código online. Como o Pastebin, o Gist é uma ferramenta para compartilhar texto na Internet. Mas ele oferece recursos adicionais e é notavelmente apoiado pelo controle de versão robusto do Git.

Como encontrar o site GitHub Gist

GitHub Gist é o nome do site que hospeda gists. Uma "essência" é um trecho de código que pode ser público ou secreto.

O site principal do GitHub não promove particularmente o GitHub Gist , então você precisará pesquisá-lo ou marcar o URL para uso regular.

O site é um subdomínio do site principal do GitHub e seu login funciona nos dois sites. Qualquer pessoa pode ver as gists públicas, mas você precisará fazer login para criar um novo conteúdo da gist.

Criando uma essência

Quando você está conectado ao GitHub, a página inicial do Gist exibe um formulário que permite criar rapidamente um novo gist.

Escolha um nome de arquivo apropriado, insira o conteúdo do arquivo e clique no botão Criar essência . Você pode configurar o editor básico com um punhado de opções de formatação. Você também pode escolher se a essência é secreta ou pública por meio do botão Criar .

O editor aplicará o realce de sintaxe de acordo com a extensão do seu arquivo. Certifique-se de escolher uma extensão apropriada para o tipo de arquivo. Você também verá uma boa visualização específica do tipo ao visualizar certos arquivos em uma essência. Arquivos Markdown funcionam particularmente bem para visualização e edição.

Ao editar, você pode adicionar mais arquivos com o botão Adicionar arquivo . Muitos gists são pequenos o suficiente para exigir apenas um arquivo, mas você pode usar mais, se necessário.

Trabalhando com pontos essenciais

Se você clicar no botão Editar , obterá um editor de texto básico por arquivo. O Gist permite que você faça edições por meio de sua interface da web e, para pequenos exemplos de código, isso é perfeitamente suficiente.

No entanto, nos bastidores, cada essência é um repositório Git. Isso significa que você pode rastrear revisões de arquivos e realizar outras operações git. A guia Revisões perto do canto superior esquerdo exibe os commits para o repositório de sua essência.

Atrás do botão Incorporar estão opções para clonar o repositório, para que você possa trabalhar com uma essência remotamente. No entanto, você deve estar ciente de que os repositórios gist são ligeiramente restritos. Em particular, embora uma essência possa conter muitos arquivos, ela não pode conter diretórios.

Essências na linha de comando

O programa de linha de comando do GitHub , gh, tem suporte para gists. Você pode criar, excluir, listar e editar gists diretamente de um terminal. Isso é mais conveniente do que tratar a essência como um repositório git normal.

Por exemplo, se você tiver um arquivo existente, poderá criar imediatamente uma essência secreta a partir dele usando este comando:

 $ gh gist create index.md
 - Creating gist index.md
 ✓ Created gist index.md
 https://gist.github.com/027442d9e34f35ee4bf64bbbc1a81a62

O comando termina com um URL que representa a nova essência. Você também pode editar uma essência:

 gh gist edit 027442d9e34f35ee4bf64bbbc1a81a62

Isso abrirá seu editor de texto padrão. Depois de fazer uma edição e fechar seu editor, o gh envia automaticamente sua alteração para o GitHub.

Como reutilizar o conteúdo essencial

Ao visualizar a essência, você notará um botão denominado Raw ao lado de cada arquivo. Isso fornece uma versão em texto simples do arquivo que pode ser útil para salvar ou copiar. Observe que você não pode usar isso para hospedar arquivos. Por exemplo, se você tentar fazer referência a um arquivo JavaScript usando esse link, não funcionará.

Você pode, no entanto, exibir o conteúdo de uma essência em outro lugar. Isso é ótimo para exemplos de código, e o destaque de sintaxe significa que eles ficarão ótimos em postagens de blog ou artigos. Para fazer isso, copie o código ao lado do botão Incorporar e inclua-o em seu HTML.

Essências são um utilitário desconhecido

O GitHub não anuncia muito as essências, mas não deixe que isso o desanime. Eles são uma combinação muito acessível de Pastebin e Git. Gists são um ótimo caso de uso para qualquer pequeno trecho de código que não garante um repositório completo. Eles são uma excelente opção leve se você deseja apenas compartilhar algum código rapidamente. A opção de incorporação pode ser útil se você estiver publicando um artigo técnico.

Confira outros aplicativos que permitem que você compartilhe trechos de código com nosso guia de alternativas Pastebin.