Reponse rapide : qu est-ce que GitHub Profile 3D Contrib ?
GitHub Profile 3D Contrib est une GitHub Action qui transforme le calendrier de contributions en images 3D pretes pour un profil. Le workflow genere puis commit les fichiers afin que le README affiche un calendrier 3D a jour.
L intention n est pas celle de GitHub City. Une recherche github profile 3d contrib vise surtout un fichier YAML, un chemin d image et une execution planifiee fiable. GitHub City repond plutot au besoin d ouvrir un visualiseur en ligne sans modifier de depot.
Utilisez profile-3d-contrib si le resultat doit vivre dans le README. Utilisez GitHub City pour explorer dans le navigateur et le comparatif 3D pour choisir entre image README, ville interactive et modele.
Pour github profile 3d contrib, cette page couvre l automatisation README, GitHub Actions, les fichiers generes et le depannage. Pour saisir un nom et voir une ville en ligne, utilisez GitHub City.
Configurer profile-3d-contrib sans casser le README
Commencez avec l action officielle puis verifiez chaque exigence GitHub. Une configuration courte et explicite est plus facile a relancer manuellement.
Creez le depot special de profil
Creez un depot public dont le nom correspond exactement a votre nom d utilisateur GitHub.
Ajoutez le fichier workflow
Creez .github/workflows/profile-3d.yml, donnez contents: write et utilisez l action avec GITHUB_TOKEN.
Lancez-le une premiere fois
Utilisez workflow_dispatch pour rendre visibles les erreurs de permission, token, YAML ou fichiers manquants.
Integrez l image generee
Ajoutez le chemin SVG ou PNG dans README.md. Si l image est cassee, controlez branche, dossier, casse et chemin relatif.
Controlez les contributions privees
Les contributions privees n apparaissent en resume public que si vos reglages de profil l autorisent.
Fichiers et reglages a verifier
La configuration est courte, mais elle depend d une chaine complete : workflow, dossier genere, chemin dans le README et reglages du profil.
Si les fichiers sont generes dans Actions mais absents du README, la cause est souvent le chemin, la branche, le cache ou la reference Markdown.
| Fichier ou reglage | Objectif | A verifier |
|---|---|---|
| README.md | Affiche le calendrier 3D sur votre profil. | Le chemin doit correspondre exactement au fichier commite. |
| .github/workflows/profile-3d.yml | Execute le generateur selon un planning ou manuellement. | Ajoutez les droits d ecriture et un declencheur manuel. |
| Dossier de sortie | Stocke les SVG ou PNG generes. | Verifiez que les fichiers sont bien commites. |
| Reglages du profil | Determinent si l activite privee peut etre resumee publiquement. | Activez seulement si vous souhaitez cette visibilite. |
| Etape de commit du workflow | Ecrit les fichiers SVG ou PNG generes dans le depot de profil. | Commiter seulement les images generees, eviter les commits vides et ignorer les caches. |
profile-3d-contrib, GitHub City ou GitHub Skyline
Ces outils utilisent les donnees de contribution, mais ne servent pas le meme objectif.
profile-3d-contrib
Ideal pour une image visible en permanence dans le README de profil. Il demande un depot et Actions.
GitHub City
Ideal pour explorer instantanement une ville 3D dans le navigateur sans ajouter de workflow.
GitHub Skyline
Meilleur pour une forme 3D ou un rendu exportable plutot qu une image README.
Depanner une image 3D absente ou ancienne
Ouvrez d abord la derniere execution Actions. Un echec indique souvent token, permissions, YAML ou limites. Une execution reussie sans image dans le README pointe plutot vers le chemin Markdown.
Si l image est vide, comparez avec le graphe officiel GitHub. Ce qui n apparait pas dans le calendrier officiel n apparait generalement pas dans l image 3D. Pour les commits, consultez le guide commit graph.
Si l image est ancienne, verifiez le fuseau horaire du cron, la protection de branche, le push des fichiers et le cache du README.
Si Actions reussit mais que l image semble ancienne, verifiez le hash du fichier, le chemin README et les caches GitHub ou navigateur.
Si vous planifiez encore toute la page de profil, utilisez le guide de modèle GitHub profile README avant d'ajouter une image 3D. Pour les widgets README statiques qui ne sont pas des images 3D générées, utilisez le guide GitHub streak stats au lieu de modifier ce workflow Actions.
Ne deboguez pas les donnees Git brutes avec un generateur README
profile-3d-contrib visualise ce que GitHub expose. Corrigez emails, branches, confidentialite et regles de forks avant de modifier le generateur.
FAQ
Est-ce identique a GitHub City ?
Non. profile-3d-contrib genere des images via GitHub Actions; GitHub City est un visualiseur interactif.
Faut-il GitHub Actions ?
Oui. Le setup normal utilise Actions pour regenerer et commiter l image automatiquement.
Pourquoi mon image 3D est-elle vide ?
Comparez avec le graphe officiel, puis controlez permissions, token, utilisateur, branche et chemin README.
Les contributions privees peuvent-elles apparaitre ?
Seulement le resume public autorise par GitHub peut etre reflete.
Quel outil pour partager rapidement ?
GitHub City pour une vue interactive rapide; profile-3d-contrib pour le README.
Quels fichiers github-profile-3d-contrib genere-t-il ?
Le plus souvent des images SVG ou PNG du calendrier 3D, stockees dans le depot de profil et referencees par README.md.
Que verifier avant de changer le YAML ?
Nom du depot de profil, permissions Actions, dossier de sortie, branche, chemin README, utilisateur et activite visible sur GitHub.