Resposta rapida: Skyline e para modelo, GitHub City para navegador
GitHub Skyline e um visualizador focado em modelo. Ele converte contribuicoes em uma skyline 3D, enquanto GitHub City prioriza exploracao interativa no navegador.
A diferenca principal e a saida. Skyline faz sentido para objeto, arquivo ou impressao. GitHub City faz sentido quando voce quer digitar um usuario e ver a cidade rapidamente.
Antes de gerar, confira o grafico oficial. E-mail de commit, branch, fork, privacidade e tempo de atualizacao podem esconder atividade.
O caminho seguro e validar os dados, escolher por formato final e usar Skyline apenas quando o modelo exportavel compensar o setup local.
O projeto oficial gh-skyline descreve o GitHub Skyline como uma extensão do GitHub CLI que gera um arquivo STL binário com dados de contribuições. O caminho atual de instalação usa gh extension install github/gh-skyline; consulte o repositório para opções e requisitos. Para comparar saídas, veja GitHub City vs GitCity vs GitHub Skyline.
Como funciona um fluxo do GitHub Skyline
O fluxo do Skyline exige mais configuração que um visualizador apenas no navegador, mas os passos são previsíveis quando a verificação dos dados fica separada da geração do modelo.
Confirme o perfil e o gráfico
Comece no perfil público do GitHub. Se o gráfico oficial estiver vazio ou incompleto, corrija isso primeiro.
Prepare o GitHub CLI
Instale o GitHub CLI, autentique com gh auth e instale a extensão com gh extension install github/gh-skyline. Siga o repositório oficial para opções e requisitos atuais.
Gere o modelo skyline
Execute o fluxo para a conta e o ano corretos, com autenticação consistente.
Revise antes de imprimir ou compartilhar
Confira se as semanas ativas geram a altura esperada. Se parecer vazio, volte ao gráfico oficial.
Use GitHub City como alternativa rápida
Para captura de portfólio ou exploração rápida, GitHub City costuma ser mais direto.
GitHub Skyline, GitHub City e o gráfico oficial de contribuições
Escolha pelo formato de saída: Skyline prioriza o modelo, GitHub City prioriza o navegador e o gráfico oficial é a referência dos dados.
| Opção | Melhor para | Saída | Esforço | Quando escolher |
|---|---|---|---|---|
| GitHub Skyline | Histórico exportável ou imprimível | Modelo 3D estilo skyline | Médio | Você precisa de modelo, fluxo tipo STL ou geração local. |
| GitHub City | Visualização 3D online rápida | Cidade 3D interativa no navegador | Baixo | Você quer digitar um usuário e explorar rápido. |
| GitCity / CodeCity | Narrativa visual alternativa do perfil | Cena visual compartilhável | Baixo a médio | Você quer outra metáfora de cidade. |
| Gráfico oficial do GitHub | Verificar se a atividade foi contada | Mapa de calor em calendário | Nenhum | Você precisa da base factual antes de um visualizador 3D. |
Solução de problemas: por que um GitHub Skyline pode parecer vazio ou incorreto
A maioria dos problemas do Skyline começa antes da geração do modelo. Se o GitHub não contabiliza uma atividade no gráfico oficial, ela também pode não aparecer na exportação. As causas comuns são e-mail de commit não associado, branch não contabilizada, fork não mesclado, visibilidade de contribuições privadas, elegibilidade do repositório ou um pequeno atraso de atualização.
O segundo grupo de problemas está no fluxo local. Um visualizador de linha de comando pode falhar se a extensão CLI não estiver instalada, faltar autenticação, as permissões não corresponderem à conta ou o ano solicitado tiver pouca atividade visível. Trate isso como configuração, não como problema de SEO ou visualização.
Por fim, lembre-se de que um skyline é uma metáfora visual. Ferramentas diferentes podem converter semanas, dias ou volumes de contribuição em alturas diferentes. Um skyline menor que uma cidade não significa necessariamente que os dados estejam errados; a escala de renderização pode ser outra.
Commits ausentes
Confira email, branches contados, forks, visibilidade do repositório e atualização.
Trabalho privado
Contribuições privadas podem ficar ocultas ou anônimas conforme as configurações.
Conta ou ano errado
Confirme usuário e intervalo.
Falha de setup
Confira GitHub CLI, autenticação, extensão e instruções do repositório.
Quando vale a pena usar o GitHub Skyline
Use o GitHub Skyline quando o artefato final for o objetivo. Ele combina com impressão 3D, objetos de mesa, eventos, retrospectivas de equipe e lembranças pessoais de desenvolvimento. A configuração local extra vale a pena porque permite controlar o modelo gerado.
Use o GitHub City quando velocidade e acessibilidade forem mais importantes. Um recrutador, colega ou visitante pode abrir uma página, inserir um nome de usuário público e ver uma cidade de contribuições sem instalar nada. Isso torna o GitHub City mais prático para explorar um portfólio, enquanto o Skyline é melhor para projetos orientados a modelos.
Um bom portfólio pode usar os dois: Skyline para uma exportação refinada ou objeto impresso, GitHub City para exploração interativa e o gráfico oficial do GitHub como base factual. Use texto claro nos links para mostrar que são visões diferentes do histórico de contribuições, não medições concorrentes.
Regra prática
Se você não consegue explicar por que precisa de um arquivo de modelo, comece pelo GitHub City. Se precisa de um skyline físico ou exportável, use o GitHub Skyline depois de verificar o gráfico oficial de contribuições.
Perguntas frequentes
O que é o GitHub Skyline?
O GitHub Skyline é uma forma orientada a modelos de transformar o histórico de contribuições do GitHub em uma visualização 3D no estilo skyline, geralmente associada ao fluxo gh-skyline.
GitHub Skyline é a mesma coisa que GitHub City?
Não. O GitHub Skyline é melhor para modelos exportáveis, enquanto o GitHub City serve para explorar rapidamente uma cidade 3D no navegador.
O GitHub Skyline pode criar um arquivo STL?
As buscas por Skyline costumam focar em saída STL ou imprimível. Siga as instruções atuais do repositório gh-skyline para o comportamento exato, pois as ferramentas podem mudar.
Por que meu GitHub Skyline está vazio?
Verifique primeiro o gráfico oficial de contribuições do GitHub. E-mail de commit, branch, fork, visibilidade privada, elegibilidade do repositório ou ano incorretos podem deixar o skyline vazio.
O que é melhor para um portfólio: GitHub Skyline ou GitHub City?
Use o GitHub City para uma visualização interativa rápida na web. Use o GitHub Skyline quando quiser um modelo, uma impressão ou um arquivo exportável no portfólio.
O GitHub Skyline gera um arquivo STL?
Sim. O projeto oficial github/gh-skyline descreve a extensão como uma ferramenta que gera um arquivo STL binário a partir de dados de contribuições do GitHub. Consulte o repositório antes de instalar, pois os requisitos de linha de comando podem mudar.