Kurzantwort: Was ist GitHub Profile 3D Contrib?
GitHub Profile 3D Contrib ist eine GitHub Action, die den Beitragskalender eines Benutzers in 3D-Bilder für das Profil umwandelt. Der Workflow legt die erzeugten Bilder im selben Repository ab, sodass das README einen aktuellen 3D-Beitragskalender anzeigen kann.
Die Suchabsicht unterscheidet sich von GitHub City. Wer nach github profile 3d contrib sucht, braucht meist eine Workflow-Datei, einen Bildpfad für das Profil-README und einen zuverlässigen Aktualisierungsplan. Wer GitHub City sucht, möchte meist einen Online-Visualisierer ohne Änderungen am Repository.
Nutzen Sie profile-3d-contrib, wenn die Ausgabe in ein GitHub-Profil-README gehört. Nutzen Sie GitHub City für eine schnell prüfbare 3D-Stadt im Browser und den Vergleich der 3D-Tools, wenn Sie zwischen README-Bildern, interaktiven Städten und druckbaren Modellen wählen.
Bei github profile 3d contrib geht es hier um README-Automatisierung, GitHub Actions, generierte Dateien und Fehlerbehebung. Fuer eine Online-Stadt mit Benutzernamen nutze GitHub City.
profile-3d-contrib einrichten, ohne das README zu brechen
Starte mit der offiziellen Action und pruefe jeden GitHub-spezifischen Schritt. Eine kleine, explizite Konfiguration laesst sich am besten manuell testen.
Spezielles Profil Repository erstellen
Erstelle ein public Repository, dessen Name exakt deinem GitHub Username entspricht.
Workflow Datei hinzufugen
Lege .github/workflows/profile-3d.yml an, setze contents: write und nutze die Action mit GITHUB_TOKEN.
Einmal manuell starten
Nutze workflow_dispatch, damit Rechte-, Token- oder YAML-Fehler sofort sichtbar werden.
Generiertes Bild einbetten
Fuge den SVG- oder PNG-Pfad in README.md ein und prufe Branch, Ordner, Grossschreibung und relativen Pfad.
Private Contributions prufen
Private Aktivitat kann nur erscheinen, wenn dein Profil die offentliche Zusammenfassung erlaubt.
Workflow Dateien und Einstellungen prufen
Eine zuverlässige profile-3d-contrib-Konfiguration ist klein, besteht aber aus mehreren Teilen. Behandeln Sie Workflow, Bildordner, README-Pfad und Profileinstellungen als eine zusammenhängende Kette.
Wenn das Bild im Actions-Protokoll aktualisiert wird, aber nicht im README erscheint, liegt das Problem meist nicht am Generator. Häufiger sind der committete Pfad, Branch, Cache oder Markdown-Verweis die Ursache.
| Datei oder Einstellung | Zweck | Prufpunkt |
|---|---|---|
| README.md | Zeigt den 3D Kalender im GitHub Profil. | Der Pfad muss exakt zur committeten Datei passen. |
| .github/workflows/profile-3d.yml | Startet den Generator geplant oder manuell. | Schreibrechte und manuellen Trigger vorsehen. |
| Ausgabeordner | Speichert erzeugte SVG/PNG Dateien. | Prufen, ob die Dateien nach dem Lauf committet wurden. |
| Profileinstellungen | Regeln die offentliche Zusammenfassung privater Aktivitat. | Nur aktivieren, wenn diese Anzeige gewunscht ist. |
| Workflow-Commit-Schritt | Schreibt erzeugte SVG- oder PNG-Dateien in das Profil-Repository. | Nur generierte Bilder committen, leere Commits abfangen und Cache-Dateien ignorieren. |
profile-3d-contrib vs GitHub City vs GitHub Skyline
Alle diese Tools verwenden GitHub-Beitragsdaten, lösen aber unterschiedliche Aufgaben. Wählen Sie nicht nur nach dem Begriff 3D-Beitragsgraph.
profile-3d-contrib
Am besten fur ein dauerhaft sichtbares README Bild. Es braucht Repository Setup und Actions.
GitHub City
Am besten fur sofortige Exploration im Browser ohne YAML oder Profil Repository Anderungen.
GitHub Skyline
Am besten fur modellartige 3D Ausgaben statt README Bild oder Browser Stadt.
Fehlende oder veraltete 3D Bilder beheben
Wenn das erzeugte Bild fehlt, öffnen Sie zuerst den neuesten Actions-Lauf. Ein fehlgeschlagener Lauf deutet auf Token-, Berechtigungs-, YAML- oder Rate-Limit-Probleme hin. Ein erfolgreicher Lauf ohne README-Bild weist eher auf Ausgabe-Pfad oder Markdown hin.
Wenn das Bild leer aussieht, vergleichen Sie es mit dem offiziellen GitHub-Beitragsgraphen. Beiträge, die in GitHub selbst nicht erscheinen, fehlen normalerweise auch in erzeugten 3D-Bildern. Für commitbezogene Ursachen nutzen Sie die Commit-Graph-Checkliste.
Wenn das Bild veraltet ist, prüfen Sie Zeitzone des geplanten Triggers, Branch-Schutz, ob der Commit-Schritt Dateien gepusht hat, und ob GitHub das gerenderte README-Bild cached.
Wenn Actions erfolgreich ist, aber README alt wirkt, pruefe Datei-Hash, Bildpfad und moegliche GitHub- oder Browser-Caches.
Wenn du noch das gesamte Profil planst, nutze zuerst den GitHub Profile README Template Guide, bevor du ein 3D-Beitragsbild einfügst. Für statische README-Widgets, die keine generierten 3D-Bilder sind, nutzen Sie den GitHub streak stats Guide statt diesen Actions-Workflow zu ändern.
Nutze keinen README Generator zum Debuggen roher Git Daten
profile-3d-contrib visualisiert, was GitHub veröffentlicht. Wenn Beitragszahlen nicht stimmen, prüfen Sie E-Mail-Adressen, Standard-Branches, private Beitragseinstellungen und Fork-Regeln, bevor Sie den 3D-Generator ändern.
FAQ
Ist profile-3d-contrib dasselbe wie GitHub City?
Nein. profile-3d-contrib erzeugt README Bilder per Actions; GitHub City ist interaktiv im Browser.
Brauche ich GitHub Actions?
Ja. Der normale Ablauf regeneriert und committet das Bild mit Actions.
Warum ist mein 3D Bild leer?
Prufe den offiziellen Graph, danach Rechte, Token, Username, Ausgabe Branch und README Pfad.
Konnen private Contributions erscheinen?
Nur die von GitHub offentlich freigegebene Zusammenfassung kann erscheinen.
Welches Tool fur schnelles Teilen?
GitHub City fur eine schnelle interaktive Ansicht; profile-3d-contrib fur README Ausgabe.
Welche Dateien erzeugt github-profile-3d-contrib normalerweise?
Meist SVG- oder PNG-Bilder eines 3D-Beitragskalenders, die im Profil-Repository gespeichert und aus README.md referenziert werden.
Was pruefe ich vor YAML-Aenderungen?
Profil-Repository-Name, Actions-Berechtigungen, Ausgabeordner, Branch, README-Pfad, Benutzername und sichtbare GitHub-Aktivitaet.