Risposta rapida: cos e GitHub Profile 3D Contrib?
GitHub Profile 3D Contrib è una GitHub Action che trasforma il calendario dei contributi in immagini 3D pronte per il profilo. Il workflow genera i file e li esegue in commit, così il README può mostrare un calendario 3D aggiornato.
L intento è diverso da quello di GitHub City. Chi cerca github profile 3d contrib di solito vuole un file YAML, un percorso per l immagine del README e una pianificazione affidabile; chi cerca GitHub City vuole spesso un visualizzatore online senza modificare un repository.
Usa profile-3d-contrib quando l output deve vivere nel README del profilo GitHub. Usa GitHub City per esplorare rapidamente una città 3D nel browser e il confronto tra strumenti 3D per scegliere tra immagini README, città interattive e modelli stampabili.
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 configurazione di profile-3d-contrib è piccola, ma comprende più elementi collegati. Considera workflow, cartella delle immagini, percorso del README e impostazioni del profilo come un unica catena.
Se l immagine si aggiorna nei log di Actions ma non nel README, il problema di solito non è il generatore. Più spesso riguarda il percorso committato, il branch, la cache o il riferimento 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
Tutti questi strumenti usano dati di contributo GitHub, ma risolvono esigenze diverse. Non scegliere solo in base alla frase grafico dei contributi 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
Se manca l immagine generata, apri prima l esecuzione più recente di Actions. Un errore indica problemi di token, permessi, YAML o limiti. Un esecuzione riuscita senza immagine nel README indica il percorso di output o il Markdown.
Se l immagine sembra vuota, confrontala con il grafico ufficiale dei contributi GitHub. Ciò che non appare nel calendario ufficiale di solito non apparirà neppure nell immagine 3D. Per i commit, usa la checklist del commit graph.
Se l immagine è obsoleta, controlla il fuso orario del trigger pianificato, la protezione del branch, se il passaggio di commit ha eseguito il push e la cache dell immagine README di GitHub.
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.
Non usare un generatore README per diagnosticare i dati Git grezzi
profile-3d-contrib visualizza ciò che GitHub espone. Se i conteggi non tornano, controlla e-mail, branch predefiniti, impostazioni dei contributi privati e regole dei fork prima di cambiare il generatore 3D.
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.