Dokumentation

Dokumentation der Erstellung dieser Seite

Diese Seite dokumentiert, wie der SAP Coding Lernpfad auf claudiu.info aufgebaut und veröffentlicht wurde. Sie dient als technische und inhaltliche Nachvollziehbarkeit der Umsetzung.

Status

Die Seite ist vollständig online. Die Domain claudiu.info ist nun korrekt mit diesem Repository verbunden.

Wichtige Ursache beim Domain-Problem:
Die Domain war zuvor noch bei einem anderen Repository im selben GitHub-Account hinterlegt. Deshalb konnte GitHub Pages die Domain zunächst nicht für dieses Repository übernehmen.

Ziel der Seite

claudiu.info wurde als statischer SAP-Lernpfad umgesetzt. Die Startseite bündelt Themenkarten, offizielle Kursressourcen, Verwendungshinweise und einen lokalen Notizenbereich. Einzelne Unterseiten vertiefen die jeweiligen Themen.

Technische Umsetzung

Hosting über GitHub Pages.
Eigene Domain: claudiu.info.
Statische HTML-Seiten ohne Framework-Abhängigkeit.
Responsives Layout mit CSS Grid und systemnahen Schriftarten.
Lokale Notizen über localStorage.
TXT-Export der Notizen über Blob und Download-Link.
Navigation über relative Links, damit die Seite unabhängig vom Repository-Pfad funktioniert.

Erstellte Bereiche

Übersicht der Themen auf der Startseite.
ABAP Code lernen.
BTP ABAP Trial einrichten.
SAPUI5 Anwendungen entwickeln.
CDS-Views und Datenmodellierung.
Workflow und Formulare.
Schnittstellen und Erweiterungen.
Impressum.
Dokumentation der Seitenerstellung.

Umsetzungsschritte

1. Bereinigung der GitHub-Pages-Struktur

Die Seite wurde von einem alten Template bereinigt und auf eine schlanke statische Struktur reduziert.

2. Startseite aufgebaut

Die Startseite wurde als Themenübersicht mit Karten, Introtext, Kursressourcen und Verwendungshinweisen umgesetzt.

3. Unterseiten ergänzt

Für die relevanten Lernbereiche wurden eigene Unterseiten mit Zielen, Ressourcen und Notizenbereich erstellt.

4. Notizenfunktion erweitert

Der Notizenbereich speichert lokal im Browser und ermöglicht zusätzlich den Download als TXT-Datei.

5. Impressum und Navigation ergänzt

Das Impressum wurde gestalterisch an das Design angepasst. Auf den Unterseiten wurde ein Link zurück zur Übersicht ergänzt.

6. Custom Domain korrigiert

Die Domain claudiu.info war noch einem anderen Repository zugeordnet. Nach Entfernung bzw. Korrektur dieser Zuordnung konnte die Domain im richtigen Repository verwendet werden.

7. Veröffentlichung geprüft

Nach der GitHub-Pages-Konfiguration wurde geprüft, ob die Seite unter der eigenen Domain vollständig erreichbar ist.

Fehlermeldung und Bedeutung

Während der Einrichtung der Custom Domain erschien folgende GitHub-Pages-Fehlermeldung:

The custom domain `claudiu.info` is already taken by another repository in your account. Check out https://docs.github.com/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site for information about how to remove this domain from the other repository.

GitHub Pages Fehlermeldung: claudiu.info ist bereits einem anderen Repository zugeordnet — Visualisierte Troubleshooting-Notiz zur GitHub-Pages-Fehlermeldung und zur Ursache der Domain-Kollision.

Die Meldung bedeutet: GitHub erlaubt eine Custom Domain nur an einer eindeutigen Stelle. Wenn dieselbe Domain bereits in einem anderen Repository eingetragen ist, muss sie dort zuerst entfernt werden, bevor sie im gewünschten Repository hinterlegt werden kann.

Wichtigste Learnings

Bei GitHub Pages ist nicht nur DNS entscheidend, sondern auch die Zuordnung der Domain im Repository.
Eine Domain kann im selben GitHub-Account nicht gleichzeitig mehreren Repositories als Custom Domain zugeordnet sein.
Fehlermeldungen von GitHub Pages sollten dokumentiert werden, weil sie später beim Debugging sehr hilfreich sind.
Relative Links sind robuster als absolute Repository-Pfade, wenn später eine eigene Domain verwendet wird.
Nach Änderungen an Pages, DNS oder Custom Domains kann es einige Minuten dauern, bis GitHub und der Browser den aktuellen Stand anzeigen.
Bei unerwartetem Verhalten zuerst prüfen: Repository-Zuordnung, Pages-Branch, Custom-Domain-Feld, CNAME-Datei, DNS-Einträge und Browser-Cache.

Wartungshinweise

Neue Themen können als neue Ordner mit eigener index.html ergänzt werden.
Links auf der Startseite sollten relativ gesetzt werden, z. B. ./sapui5/.
Bei Änderungen an GitHub Pages kann es einige Minuten dauern, bis die veröffentlichte Seite aktualisiert ist.
Falls der Browser alte Inhalte zeigt, sollte mit Strg + F5 neu geladen werden.
Bei Domain-Problemen zuerst prüfen, ob die Domain noch in einem anderen Repository eingetragen ist.