Risposta rapida: cos e GitHub Profile 3D Contrib?
GitHub Profile 3D Contrib es una GitHub Action que convierte el calendario de contribuciones en imagenes 3D listas para un perfil. El workflow genera archivos y los confirma para que el README muestre un calendario 3D actualizado.
La intencion es distinta de GitHub City. Quien busca github profile 3d contrib normalmente necesita un archivo YAML, una ruta de imagen y una programacion fiable; quien busca GitHub City suele querer un visualizador online sin editar repositorios.
Usa profile-3d-contrib si la salida debe vivir en el README. Usa GitHub City para explorar en el navegador y la comparacion de herramientas 3D para elegir entre imagenes, ciudades interactivas y modelos.
Per github profile 3d contrib, questa pagina copre automazione README, GitHub Actions, file generati e troubleshooting. Per inserire un nome utente e vedere una citta online, usa GitHub City.
Configurare profile-3d-contrib senza rompere il README
Inizia dall action ufficiale e verifica ogni requisito GitHub. Una configurazione piccola, esplicita e facile da eseguire manualmente e la scelta piu sicura.
Crea il repository speciale del profilo
Crea un repository pubblico con lo stesso nome esatto del tuo username GitHub.
Aggiungi il workflow
Crea .github/workflows/profile-3d.yml, imposta contents: write e usa l action con GITHUB_TOKEN.
Eseguilo manualmente
Usa workflow_dispatch la prima volta per vedere errori di permessi, token o YAML.
Incorpora l immagine generata
Aggiungi il percorso SVG o PNG in README.md e controlla branch, cartella, maiuscole e percorso relativo.
Verifica i contributi privati
I contributi privati possono apparire solo come riepilogo pubblico se il profilo lo consente.
File e impostazioni da controllare
La configuracion es pequena, pero depende de una cadena: workflow, carpeta generada, ruta del README y ajustes de perfil.
Si Actions genera archivos pero el README no cambia, el problema suele estar en la ruta, la rama, la cache o la referencia Markdown.
| File o impostazione | Scopo | Cosa controllare |
|---|---|---|
| README.md | Mostra il calendario 3D nel profilo. | Il percorso deve corrispondere esattamente al file commitato. |
| .github/workflows/profile-3d.yml | Esegue il generatore su calendario o manualmente. | Aggiungi permessi di scrittura e trigger manuale. |
| Cartella output | Contiene SVG/PNG generati. | Verifica che i file siano commitati. |
| Impostazioni profilo | Regolano il riepilogo pubblico dell attivita privata. | Attiva solo se vuoi mostrarla. |
| Passaggio di commit del workflow | Scrive i file SVG o PNG generati nel repository del profilo. | Committa solo immagini generate, evita commit vuoti e ignora file di cache. |
profile-3d-contrib vs GitHub City vs GitHub Skyline
Todos usan datos de contribuciones, pero resuelven trabajos distintos. No elijas solo por la frase grafico 3D.
profile-3d-contrib
Ideale per un immagine sempre visibile nel README. Richiede repository e Actions.
GitHub City
Ideale per esplorare subito una citta 3D nel browser senza YAML.
GitHub Skyline
Migliore per forme 3D o output esportabili invece di immagini README.
Risolvere immagini 3D mancanti o vecchie
Abre primero la ultima ejecucion de Actions. Si fallo, mira permisos, token, YAML o limites. Si paso pero no hay imagen en README, revisa ruta y Markdown.
Si la imagen sale vacia, comparala con el grafico oficial de GitHub. Lo que no aparece ahi normalmente no aparecera en la imagen 3D. Para commits, usa la lista de comprobacion de commits.
Si esta obsoleta, revisa zona horaria del cron, proteccion de rama, push del commit y cache del README.
Se Actions riesce ma l immagine non cambia, controlla hash del file, percorso nel README e cache di GitHub o del browser.
Prima di sostituire l action, annota cosa cambia tra due esecuzioni: orario del workflow, branch usato, cartella di output, nome del file e percorso nel README. Questo controllo evita di confondere un problema di permessi con cache dell immagine o vecchi riferimenti Markdown.
Se stai ancora pianificando l'intera pagina profilo, usa la guida al template GitHub profile README prima di aggiungere un'immagine 3D. Per widget README statici che non sono immagini 3D generate, usa la guida GitHub streak stats invece di modificare questo workflow Actions.
No depures Git bruto desde un generador de README
profile-3d-contrib visualiza lo que GitHub expone. Corrige emails, ramas, privacidad y reglas de forks antes de cambiar el generador.
FAQ
profile-3d-contrib e uguale a GitHub City?
No. profile-3d-contrib genera immagini con Actions; GitHub City e interattivo nel browser.
Serve GitHub Actions?
Si. Il setup normale usa Actions per rigenerare e committare l immagine.
Perche l immagine 3D e vuota?
Controlla il grafico ufficiale, permessi, token, username, branch output e percorso README.
I contributi privati possono apparire?
Solo il riepilogo pubblico permesso da GitHub puo essere riflesso.
Quale tool per condividere rapidamente?
GitHub City per vista interattiva; profile-3d-contrib per README.
Quali file genera di solito github-profile-3d-contrib?
Di solito genera immagini SVG o PNG del calendario 3D, salvate nel repository del profilo e richiamate da README.md.
Cosa controllare prima di cambiare YAML?
Nome del repository profilo, permessi Actions, cartella output, branch, percorso README, utente e attivita visibile su GitHub.