LektionenSo veröffentlichst du deine Website über GitHub

Mini-Lektion 2 von 30 · Erstellen und veröffentlichen

Bereite eine wiedererkennbare Seite vor

Für wen ist das gedacht?

Für alle, die eine Website online stellen und zuverlässig aktualisieren möchten. Fertige Websitedateien werden bereitgestellt; du kannst GitHub Desktop und einen Programmierassistenten verwenden, ohne Git-Befehle zu schreiben.

Nutze die fertige P1-Website, statt zuerst eine Website zusammenzustellen.

Ziel dieser Lektion

  • Verbinde ein Übungsrepository mit einem Hostingdienst.
  • Veröffentliche eine sichtbare Änderung und überprüfe das öffentliche Ergebnis.
  • Finde die fehlgeschlagene Stufe, wenn die öffentliche Seite veraltet ist.
Erklärung, ausgearbeitetes Beispiel und Übung

Bevor du beginnst

Du brauchst eigene GitHub- und Netlify-Konten sowie GitHub Desktop oder einen gleichwertigen Zugang. Verwende ein separates Übungsrepository und Hostingprojekt. Die mitgelieferte P1-Seite funktioniert auch ohne die Lektion zur persönlichen Website. Die Musterantworten veranschaulichen mögliche Ergebnisse; sie sind keine bereits durchgeführten Tests in deinem Konto. Ersetze die Beispielbeobachtungen durch deine eigenen Ergebnisse oder benenne den noch blockierten Schritt.

Prüfe deine Vorkenntnisse

Diese Fähigkeiten sind hilfreich; ein Kursabschluss wird nicht erzwungen. Beherrschst du sie schon, starte hier. Sonst öffne die Vorbereitung. Eine eigene bestehende Website ist dank der Startdateien nicht nötig.

  1. So erstellst du deine erste persönliche Website

    Erstelle aus einer bereitgestellten Vorlage eine Vorstellung, einen Projektbereich und eine Kontaktmöglichkeit.

Geschätzte Dauer: 21–33 Min.

Schätzungen für die mitgelieferten Startdateien bei bereits eingerichteten Konten und Werkzeugen. Einrichtung, Deployment-Warteschlangen sowie E-Mail- und DNS-Wartezeiten kommen hinzu. Die Schätzungen schließen die Installation von GitHub Desktop, Kontozugriff und Build-Warteschlangen aus. Die Hosting-Nutzung hängt von deinem Konto ab.

Die Idee verstehen

Öffne die Übungsdateien und speichere index.html, style.css, netlify.toml und .gitignore in einem gemeinsamen Projektordner. Öffne index.html lokal, um die P1-Startseite zu sehen. Bitte dann deinen Programmierassistenten, die Dateien im Stammverzeichnis eines separaten Test-Repositorys abzulegen.

Auf der Seite sollte sichtbar Portfolio version P1 stehen. Wähle ein Übungsrepository und Hostingprojekt und prüfe, dass keines davon eine andere bestehende Live-Website ist.

Ein konkretes Beispiel

Verwende einen Übungsordner, der index.html, style.css, netlify.toml und .gitignore enthält. Die sichtbare Markierung Portfolio version P1 auf der Startseite macht genau diese erste Version später wiedererkennbar.

Nutze die bereitgestellte P1-Website und die Veröffentlichungsdateien. Hilf mir, sie mit GitHub Desktop im Stammverzeichnis eines separaten Übungsrepositorys abzulegen, die Änderungen auf private Dateien zu prüfen und das Repository mit meinem eigenen Netlify-Übungsprojekt zu verbinden. Frage vor der Veröffentlichung nach. Erkläre, wie ich P1 auf der öffentlichen Seite erkenne, und hilf mir dann, eine kleine P2-Änderung zu veröffentlichen, ohne eine bestehende produktive Website zu verändern.

Dateien für diesen Schritt

Hier beginnenWorkshop-Dateien

Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.

Selbst ausprobieren

Öffne die lokale P1-Seite. Welches Übungsrepository und welches Hostingprojekt wirst du verwenden?

Ausgearbeitete Lösung anzeigen

Beispiel für die Einrichtung: Ich verwende das Übungsrepository portfolio-publish-lab und ein separates Netlify-Projekt namens portfolio-publish-lab. Die lokale Startseite zeigt Portfolio version P1. Keiner dieser Orte ist meine bestehende Live-Website.

Was eine gute Antwort enthält

  • Benennt ein separates Übungsrepository und Hostingprojekt.
  • Erkennt die sichtbare P1-Markierung auf der lokal geöffneten Seite.
So funktioniert es (optional)

Bringe deine Website über GitHub online

Beim Veröffentlichen wird eine Version deiner Dateien auf einen Host kopiert, damit andere sie abrufen können.

Deine lokale Seite, das GitHub-Repository und das Hosting-Deployment sind drei verschiedene Orte. Eine lokal gespeicherte Datei aktualisiert die öffentliche Seite nicht automatisch. Ein Commit hält eine Version fest; ein verbundener Host kann diese Version bereitstellen.

Verwende für diese Lektion ein neues Übungsprojekt. Stelle sicher, dass der Ordner die tatsächliche Startseite und das Stylesheet enthält und kein übergeordneter Ordner mit einer beliebigen Dateisammlung ist.

Füge vor dem ersten Commit den Absatz „Portfolio version P1“ als sichtbare Versionskontrolle hinzu. Ändere ihn in der Abschlussaufgabe zusammen mit deiner sinnvollen Inhaltsänderung in P2. Die Markierung hilft, lokale Datei, Remote-Commit und bereitgestellte Seite zu vergleichen, ohne raten zu müssen, welche Kopie geöffnet ist.

Ausgearbeitetes Beispiel

Alex fügt einer Seite den sichtbaren Text „Portfolio version P1“ hinzu. Dieser Text und seine Commit-ID helfen uns, ein erfolgreiches Deployment von einem Browser zu unterscheiden, der noch eine ältere Version anzeigt.

Zusätzliche technische Übung

Du hast P1 lokal gespeichert, aber die gehostete Seite zeigt noch P0. Welche zwei Veröffentlichungsschritte könnten noch fehlen?

Ausgearbeitete Lösung anzeigen

Prüfe zuerst das Repository und dann den Deployment-Eintrag des Hosts. Ein Browser-Refresh kann keine Änderung veröffentlichen, die den Host nie erreicht hat.

  • Prüft, ob die Änderung committet und gepusht wurde.
  • Prüft, ob ein erfolgreiches Deployment diesen Commit verwendet hat.

Schritt 1 · So veröffentlichst du deine Website über GitHub

Prüfe die Änderung und übertrage sie zu GitHub

Prüfe vor der Veröffentlichung die Dateiliste.

Erklärung, ausgearbeitetes Beispiel und Übung

Die Idee verstehen

Gehe die geänderten Dateien in GitHub Desktop mit deinem Assistenten durch. Erstelle einen Commit mit den vorgesehenen Websitedateien und pushe den Übungsbranch, sobald alles bereit ist. Umgebungsdateien und geheime Kontodaten gehören nicht ins Repository.

Öffne das Repository auf GitHub und bestätige, dass die vorgesehene Startseite im Stammverzeichnis liegt. Falls in den Änderungen eine private Datei auftaucht, entferne sie, bevor du etwas überträgst.

Ein konkretes Beispiel

Vergleiche vor dem Übertragen die Liste geänderter Dateien. index.html und style.css gehören zu dieser öffentlichen Seite; eine private .env-Datei nicht. Prüfe nach dem Push die entfernte Dateiliste, statt anzunehmen, dass lokales Speichern GitHub erreicht hat.

Dateien für diesen Schritt

Hier beginnenWorkshop-Dateien

Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.

Selbst ausprobieren

Welche Dateien hast du übertragen, und findest du die vorgesehene Startseite im entfernten Übungsrepository?

Ausgearbeitete Lösung anzeigen

Beispielprotokoll: GitHub Desktop zeigte index.html, style.css, netlify.toml und .gitignore. Diese Dateien habe ich committed und gepusht. In GitHubs Dateiliste liegt index.html im Stammverzeichnis des Repositorys; keine .env-Datei oder private Kontodatei ist enthalten.

Was eine gute Antwort enthält

  • Nennt die vorgesehenen öffentlichen Websitedateien und prüft, dass private Dateien ausgeschlossen sind.
  • Bestätigt, dass die Startseite im entfernten Repository am Veröffentlichungsstamm liegt.
So funktioniert es (optional)

Lege die richtigen Dateien ins Repository

Committe eine kleine Auswahl öffentlicher Website-Dateien und prüfe sie vor dem Push.

Beispielweg: Erstelle auf GitHub ein Übungs-Repository und klone es über File → Clone repository in GitHub Desktop in einen neuen lokalen Ordner. Füge dem geklonten Ordner zuerst die mitgelieferte .gitignore hinzu. Kopiere anschließend nur deine öffentlichen Website-Dateien hinein, mit index.html im Stammverzeichnis, und prüfe die Änderungen vor dem Vormerken und Committen.

Prüfe in GitHub Desktop die Liste Changes und den Diff, schreibe eine Commit-Zusammenfassung, committe auf den vorgesehenen Branch und wähle dann Push origin. Steht dort stattdessen Publish branch, veröffentliche diesen Branch im Remote-Repository. Das folgende Kommandozeilenbeispiel ist eine Alternative für einen bereits initialisierten Klon. Eine Git-Ignore-Regel entfernt kein Geheimnis, das bereits committet wurde. Falls du versehentlich einen echten Schlüssel offenlegst, widerrufe ihn und repariere das Repository; das Löschen der aktuellen Datei reicht nicht.

Ausgearbeitetes Beispiel

Die Befehlsliste merkt gezielt benannte Website-Dateien vor statt aller Dateien auf dem Computer. Anschließend zeigt sie die vorgemerkte Änderung, damit du den Inhalt des Commits prüfen kannst.

git add index.html style.css netlify.toml .gitignore
git diff --cached
git commit -m "Add personal website"

Zusätzliche technische Übung

Dein vorgemerkter Diff enthält .env mit einem Dienstschlüssel. Was solltest du vor dem Push tun?

Ausgearbeitete Lösung anzeigen

Hebe die Vormerkung der Datei auf, halte sie außerhalb der Versionsverwaltung und prüfe den Diff erneut. Hat der Schlüssel ein Remote-Repository oder andere Personen erreicht, widerrufe ihn, statt anzunehmen, eine Ignore-Regel habe ihn privat gemacht.

Prüfe vor dem Push den vorgemerkten Diff erneut. Falls dieses Repository bereits Commits hatte, untersuche seine bisherige Historie und das Remote auf die Zugangsdaten, ohne deren Wert in einen Bericht zu kopieren. Tausche jeden echten offengelegten Schlüssel aus; .gitignore kann frühere Offenlegung nicht rückgängig machen.

  • Entfernt die geheime Datei aus den vorgemerkten Änderungen.
  • Prüft, ob die Zugangsdaten bereits offengelegt wurden, und tauscht sie bei Bedarf aus.

Schritt 2 · So veröffentlichst du deine Website über GitHub

Verbinde das Repository mit dem Hostingdienst

Lass den Hostingdienst den Ordner veröffentlichen, der die Startseite enthält.

Erklärung, ausgearbeitetes Beispiel und Übung

Die Idee verstehen

Erstelle oder wähle dein separates Netlify-Übungsprojekt und verbinde das vorgesehene Repository und den Branch. Nutze für diese bereitgestellte einfache Website die mitgelieferte Veröffentlichungskonfiguration; ein Framework-Build ist nicht nötig.

Warte, bis der Hostingdienst eine erfolgreiche Bereitstellung meldet. Öffne die öffentliche URL in einem privaten Fenster und suche nach P1; eine Erfolgsmeldung im Dashboard allein bestätigt noch nicht die richtige Seite.

Ein konkretes Beispiel

Lokale Seite: P1. GitHub: P1. Der Hoster meldet veröffentlicht, aber die öffentliche URL zeigt 404. Als Nächstes prüfst du, ob der Hoster den Ordner veröffentlicht, der tatsächlich index.html enthält.

Dateien für diesen Schritt

Hier beginnenWorkshop-Dateien

Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.

Selbst ausprobieren

Zeigt die öffentliche URL ohne Anmeldung deine P1-Seite? Wenn nicht, was siehst du tatsächlich?

Ausgearbeitete Lösung anzeigen

Beispielprotokoll: Ich öffnete die öffentliche Übungsadresse des Hosters in einem privaten Fenster und sah Portfolio version P1. Bei einem Fehler würde „404 an der öffentlichen URL; lokal öffnet P1 weiterhin“ zur Prüfung des Veröffentlichungsordners und der Startseite führen, nicht zu anderen Seitenfarben.

Was eine gute Antwort enthält

  • Beschreibt die tatsächliche Seite oder Fehlermeldung an der öffentlichen URL ohne Anmeldung.
  • Verwendet die P1-Markierung, um die vorgesehene Seite von einer anderen Veröffentlichung zu unterscheiden.
So funktioniert es (optional)

Verbinde den Host und wähle seinen Veröffentlichungsordner

Der Host muss wissen, welches Repository er verwenden soll und welcher Ordner die öffentlichen Dateien enthält.

Erstelle in deinem Netlify-Konto ein neues Projekt aus dem Übungs-Repository und wähle den vorgesehenen Produktionsbranch. Erlaube nur den benötigten Repository-Zugriff. Lasse für reines HTML den Build-Befehl leer und veröffentliche das Repository-Stammverzeichnis.

Die mitgelieferte netlify.toml legt dieses Stammverzeichnis ausdrücklich fest. Ein Framework-Projekt würde stattdessen die Build-Ausgabe seines Frameworks verwenden; übernimm diese Einstellung nicht ungeprüft in ein anders aufgebautes Projekt.

Prüfe vor der Host-Einrichtung den Ordnerbaum: Repository-Stammverzeichnis → index.html und style.css. Bei diesem Weg mit reinem HTML gehören publish='.' und ein leerer Build-Befehl zusammen. Der Quellordner eines Frameworks ist nicht automatisch seine Veröffentlichungsausgabe; diese ergibt sich aus den eigenen Build-Anweisungen.

Ausgearbeitetes Beispiel

Liegt index.html im Stammverzeichnis, liefert die Veröffentlichung von „.“ diese Datei als Startseite aus. Ein Ordner ohne die gebaute Startseite kann ein Deployment erzeugen, dessen Startadresse einen 404-Fehler zeigt.

[build]
  publish = "."

Netlify: Deployments erstellen

Zusätzliche technische Übung

Das Deployment gelingt, aber die Startseite zeigt 404. Welche Datei und welche Einstellung solltest du vergleichen?

Ausgearbeitete Lösung anzeigen

Prüfe, ob das gewählte Veröffentlichungsverzeichnis index.html enthält. Ein erfolgreicher Upload beweist nicht, dass der richtige Ordner hochgeladen wurde.

  • Findet index.html im Repository oder in der tatsächlichen Build-Ausgabe.
  • Vergleicht diesen Ort mit dem Veröffentlichungsverzeichnis.

Schritt 3 · So veröffentlichst du deine Website über GitHub

Verfolge die Ursache einer veralteten öffentlichen Seite

Vergleiche Repository, Hostingprotokoll und Browserergebnis.

Erklärung, ausgearbeitetes Beispiel und Übung

Die Idee verstehen

Ändere mit deinem Assistenten einen kleinen Inhalt und kennzeichne die Seite als P2. Speichere die Änderung, erstelle einen Commit und pushe ihn. Prüfe anschließend die zugehörige Bereitstellung beim Hostingdienst. Bewahre die frühere P1-Aufzeichnung zum Vergleich auf.

Prüfe, welche Version in GitHub liegt, welche der Hostingdienst bereitgestellt hat und was die angefragte öffentliche URL zeigt. Ein Neuladen im Browser überträgt keine noch nicht gepushte Änderung.

Ein konkretes Beispiel

GitHub P2 → Hoster P1 → öffentlich P1 deutet auf die Veröffentlichung hin. GitHub P2 → Hoster P2 → öffentlich P1 verlangt eine Prüfung der aufgerufenen URL und der ausgelieferten Antwort. Dieselbe veraltet wirkende Seite kann unterschiedliche Ursachen haben.

Dateien für diesen Schritt

Hier beginnenWorkshop-Dateien

Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.

Selbst ausprobieren

Welche Version zeigen Repository, Hostingdienst und öffentliche Seite gerade? Wo beginnt die Abweichung?

Ausgearbeitete Lösung anzeigen

Beispieldiagnose: GitHub enthält P2, die letzte erfolgreiche Veröffentlichung des Hosters verweist noch auf den P1-Commit, und die öffentliche Seite zeigt P1. Die erste Abweichung liegt zwischen GitHub und Hoster. Ich prüfe den ausgewählten Branch und den Veröffentlichungsdatensatz, bevor ich einen Browsercachefehler annehme.

Was eine gute Antwort enthält

  • Hält die beobachteten Versionen in GitHub, in der Hostingveröffentlichung und auf der öffentlichen Seite getrennt fest.
  • Findet die erste Abweichung und wählt eine Prüfung an dieser Stelle.
So funktioniert es (optional)

Ordne die veröffentlichte Seite ihrem Commit zu

Prüfe die bereitgestellte Version und die Besucheransicht, nicht nur eine grüne Deployment-Anzeige.

Öffne die öffentliche URL des Hosts in einem privaten Browserfenster. Prüfe, ob Startseite und Stylesheet ohne dass du als Website-Betreiber angemeldet bist laden. Klicke die internen Links an und prüfe die P1-Markierung.

Vergleiche den vom Host protokollierten Commit mit dem letzten vorgesehenen Commit des Repositorys. Eine veraltete Seite kann von einem älteren Deployment, einem unerwarteten Branch oder dem Cache stammen. Nutze diese Beobachtungen, um die nächste Prüfung zu wählen.

Ausgearbeitetes Beispiel

Ein nützliches Protokoll enthält Commit, Deployment-URL und sichtbare Markierung. Nennt das Deployment den P1-Commit, während die Seite P0 zeigt, prüfe zunächst angeforderte URL und Antwort, bevor du wahllos Build-Einstellungen änderst.

Zusätzliche technische Übung

Das Repository enthält P2, aber der Deployment-Eintrag nennt den P1-Commit. Ist das hauptsächlich ein Problem des Browser-Aktualisierens?

Ausgearbeitete Lösung anzeigen

Nein. Untersuche, warum der Host den P2-Commit nicht bereitgestellt hat. Untersuche den Browser-Cache erst, nachdem du bestätigt hast, dass die vorgesehene Version tatsächlich bereitgestellt ist.

  • Erkennt, dass P2 nicht bereitgestellt wurde.
  • Prüft die Branch-Auswahl und das Ergebnis des letzten Builds.

Schritt 4 · So veröffentlichst du deine Website über GitHub

Veröffentliche und überprüfe P2

Schließe mit einer erkennbaren tatsächlichen öffentlichen Aktualisierung ab.

Erklärung, ausgearbeitetes Beispiel und Übung

Die Idee verstehen

Veröffentliche die P2-Änderung über denselben Übungsweg. Öffne die endgültige Adresse ohne Anmeldung und prüfe den betroffenen Link oder Inhalt. Bewahre die Änderungs- und Bereitstellungskennungen von P1 und P2 aus den Werkzeugen auf.

Prüfe die Kennung und die tatsächlich geänderte Funktion, nicht nur ein grünes Bereitstellungssymbol. Nenne jeden Schritt, den du nicht abschließen konntest.

Ein konkretes Beispiel

Eine brauchbare P2-Übergabe verbindet drei Dinge: die passende Repositoryänderung, den Hostingdatensatz und den sichtbar geänderten Satz. Ein grünes Hostersymbol ohne den vorgesehenen öffentlichen Inhalt lässt den letzten Schritt ungeprüft.

Dateien für diesen Schritt

Hier beginnenWorkshop-Dateien

Öffne die Dateien unten oder lade sie einzeln herunter. Behalte beim Speichern des Projekts die angezeigten Ordnerpfade bei.

Selbst ausprobieren

Lege dein P2-Ergebnis und die Prüfungen vor, die zeigen, dass die gewünschte Änderung die öffentliche Seite erreicht hat.

Dein Ergebnis: Die öffentliche Übungs-URL, Versionsaufzeichnungen zu P1/P2 und die tatsächlichen Seitenprüfungen ohne Anmeldung.

Ausgearbeitete Lösung anzeigen

Beispielübergabe: Die Übungs-URL zeigt ohne Anmeldung Portfolio version P2. Repositoryänderung und erfolgreiche Hostingveröffentlichung verweisen auf denselben P2-Commit. Der geänderte Projektsatz erscheint, und Contact führt weiterhin zum Kontaktabschnitt. Den P1-Datensatz habe ich aufbewahrt, damit die frühere funktionierende Version erkennbar bleibt.

Was eine gute Antwort enthält

  • Verknüpft das öffentliche P2-Ergebnis mit der passenden Repositoryänderung und Veröffentlichung.
  • Beschreibt eine Browserprüfung des tatsächlich geänderten Inhalts oder Verhaltens.
So funktioniert es (optional)

Deine Aufgabe: veröffentliche eine zweite Version

Zeige, dass der Veröffentlichungsablauf nach der ersten erfolgreichen Veröffentlichung erneut funktioniert.

Nimm eine sinnvolle sichtbare Änderung vor, etwa eine zusätzliche Projektbeschreibung. Committe und pushe sie über dein eigenes Repository. Warte auf das entsprechende Deployment und prüfe dann seine öffentliche Seite.

Bewahre beide Versionsprotokolle auf. Den Zusammenhang zwischen Commits und Deployments brauchst du später beim Lernen von Vorschauen und Rollbacks.

Ausgearbeitetes Beispiel

Dein Vorher-nachher-Protokoll sollte die Änderung beschreiben und beide Commits identifizieren. Die öffentliche URL allein verrät nicht, welche Version jemand gesehen hat.

Die vollständige exemplarische Anleitung findest du in reference/assignment-walkthrough.txt. Vergleiche ihre Schritte mit deinem Ergebnis und fülle das Testprotokoll mit Beobachtungen aus deinem eigenen Projekt aus.

Zusätzliche technische Übung

Veröffentliche P2 und belege, dass der Host den vorgesehenen Commit ausliefert.

  1. Ändere ein sichtbares Element, aktualisiere die Markierung von P1 auf P2 und prüfe den Diff.
  2. Committe und pushe; finde das zugehörige Deployment.
  3. Teste die öffentliche URL und protokolliere die neue Markierung.
Ausgearbeitete Lösung anzeigen

Füge vor dem ersten Commit „Portfolio version P1“ als sichtbaren Absatz ein. Speichere die Seite, prüfe in GitHub Desktop den Diff unter Changes, committe nur index.html/style.css/netlify.toml/.gitignore und pushe den vorgesehenen Branch. Prüfe in der GitHub-Dateiansicht, ob diese vier Dateien im Repository-Stammverzeichnis liegen.

Protokolliere die Commit-ID als P1. Wähle in Netlify dasselbe Repository und denselben Branch, lasse den Build-Befehl leer und verwende publish='.'. Ordne den Commit des erfolgreichen Deployments P1 zu, öffne dann seine öffentliche URL abgemeldet und lies die Markierung. Ändere die Markierung in P2, wiederhole Commit, Push und Deployment und bewahre beide Protokolle auf.

Eine nützliche Diagnose lautet: repository=P2, deploy=P1, public marker=P1 → Branch-, Build- und Deployment-Status untersuchen. Ein anderer Fall ist deploy=P2, public marker=P1 → zunächst angeforderten Hostnamen, Antwort und Cache prüfen. Veröffentliche kein Geheimnis, um zu testen, ob Git es verbergen kann; prüfe vor dem Push den vorgemerkten Diff und jede vorhandene Historie.

  • Der öffentliche Inhalt entspricht der P2-Änderung und dem protokollierten Commit.
  • Startseite, CSS und Navigation funktionieren ohne Eigentümeranmeldung.

War diese Lektion hilfreich?

Hinterlasse ein Like oder teile sie mit jemandem, dem sie helfen könnte.