Banner ASCII para código-fonte e README
Transforme um nome curto em um título que destaque num arquivo ou README. Envolva como comentários, caiba na largura e copie.
Configurações
Dicas
Use um nome curto, não uma frase
O banner é uma grade de caracteres miúdos que formam letras grandes. Um nome tão curto quanto uma função ou arquivo — init, main — deixa essas formas legíveis. Uma frase inteira gasta tantas células que a palavra some. Duas palavras? Coloque-as em duas linhas para cada uma continuar grande.
Marcas de comentário entram na largura da linha
Ao envolver o banner como comentários, cada linha ganha caracteres a mais, como // e espaços de recuo. O editor também conta. Se o arquivo fica em 80 caracteres por linha, ponha a largura em 80. Aqui pode parecer certo e ainda transbordar ao colar. Ajustar à largura encolhe até o bloco copiado caber nesse limite.
Num /* */, um */ do desenho encerra o comentário
Em C e Java, um comentário vai de /* até o primeiro */. Se o preenchimento desenhar * e / juntos, o resto é lido como código de verdade. Esta página insere um espaço para impedir isso. Preencher com # ou . nunca desenha o par. Envolver cada linha com // não tem fechamento.
README e arquivos-fonte não aceitam os mesmos caracteres
Um README costuma aceitar qualquer caractere. Algumas árvores de código — estilo kernel Linux, checadores antigos — só aceitam letras e símbolos em inglês. Tons como █ ficam claros num README e lá são recusados. Antes de colar nesses arquivos, ligue Só ASCII e escreva o nome com letras em inglês.
Mesmo como comentário, caiba em oitenta colunas
Abrir o espaço entre letras muda a impressão do cabeçalho. Some os caracteres que viram comentário, e uma linha passa de oitenta colunas sem quase perceber. Olhe esse orçamento.
Casos de Uso Comuns
No topo de um arquivo-fonte
Coloque um nome de módulo curto no topo de um .c ou .py, como comentários, em 80 caracteres por linha. É texto comum, então o diff mostra as mesmas letras.
Como título de um README
Abra um README no GitHub com o nome do projeto como banner. Envolva numa cerca e não precisa de hospedar imagem nem de um link que quebra quando o arquivo muda de lugar.
Ao abrir o terminal
Cole na mensagem de login, num arquivo de arranque do shell ou no tmux. Uma sessão SSH não mostra imagem; mostra estas letras.
Para marcar um trecho num script
Coloque um banner compacto acima de um alvo de Makefile ou de um trecho de deploy. Não é fonte de interface — só caracteres que já estão no arquivo.
Na descrição de um pull request
Se a mudança é um comando ou um binário com nome, coloque um banner cercado na descrição do pull request. Quem revisa vê as mesmas letras em qualquer cliente.