Portfolio-Deployment-Workflow
VS Code → GitHub → Cloudflare Pages
1. Einmalige Einrichtung
1.1 VS Code-Erweiterungen
Installieren Sie diese Erweiterungen vor dem Start:
- Live Server (
ritwickdey.liveserver) — Website lokal ohne Build-Schrittvorschau - GitLens (optional) — erweiterte Git-Verlaufsansicht
1.2 GitHub-Repository erstellen
- Gehen Sie zu github.com → New repository
- Name:
nguyenvuquochung-portfolio(Ordnername entsprechend wählen, um Verwirrung zu vermeiden) - Sichtbarkeit: Public (erforderlich für kostenlose Cloudflare Pages)
- Fügen Sie keine README/gitignore hinzu (Sie haben bereits lokale Dateien)
1.3 Git lokal initialisieren
Öffnen Sie das VS Code-Terminal (Strg+`` ) und führen Sie aus:
git init
git add .
git commit -m "Initial commit"
git branch -M main
git remote add origin https://github.com/YOUR_USERNAME/nguyenvuquochung-portfolio.git
git push -u origin main
Eine .gitattributes-Datei mit * text=auto eol=lf ist bereits vorhanden – dies stellt konsistente Unix-Zeilenumbrüche auf allen Plattformen sicher.
2. Cloudflare Pages — Erstes Deployment
2.1 Repository verbinden
- Melden Sie sich bei dash.cloudflare.com an
- Workers & Pages → Create application → Pages → Connect to Git
- Autorieren Sie GitHub und wählen Sie das Repository
nguyenvuquochung-portfolioaus
2.2 Build-Einstellungen
Dies ist eine statische Website ohne Build-Schritt:
| Einstellung | Wert |
|---|---|
| Framework-Voreinstellung | Keine |
| Build-Befehl | (leer lassen) |
| Build-Ausgabeverzeichnis | / |
| Stammverzeichnis | (leer lassen) |
Klicken Sie auf Save and Deploy. Ihre Website ist innerhalb von ~30 Sekunden unter https://nguyenvuquochung-portfolio.pages.dev live.
2.3 Benutzerdefinierte Domain über Cloudflare DNS
- Im Pages-Projekt → Custom domains → Set up a custom domain
- Geben Sie Ihre Domain ein (z.B.
nguyenvuquochung.com) - Cloudflare fügt automatisch die DNS-Einträge hinzu (CNAME-Zeiger auf
nguyenvuquochung-portfolio.pages.dev) - Das SSL-Zertifikat wird automatisch bereitgestellt – keine Konfiguration erforderlich
Wenn Ihre Domain außerhalb von Cloudflare registriert wurde: Aktualisieren Sie zuerst die Nameserver bei Ihrem Registrar auf die Nameserver von Cloudflare, dann funktioniert die automatische DNS-Einrichtung.
3. Täglicher Workflow
Jedes Mal, wenn Sie Inhalte oder Code aktualisieren:
# 1. Speichern Sie Ihre Änderungen in VS Code
# 2. Stagen, committen und pushen
git add .
git commit -m "Update: beschreiben Sie, was sich geändert hat"
git push
Cloudflare Pages erkennt den Push und deployt automatisch neu. Live in ~30 Sekunden.
4. Projektstruktur
nguyenvuquochung-portfolio/
├── index.html ← HTML-Grundgerüst (7 virtuelle Seiten, gesamtes Layout)
├── style.css ← Alle CSS (Variablen, Animationen, Seitensystem)
├── js/
│ ├── content.js ← Zweisprachige Textdaten (const C = {en, vi})
│ ├── about.js ← renderP2() — Renderer für die Über-mich-Seite
│ ├── contact.js ← goToPage7 / goToPage1FromP7
│ ├── production.js ← P3_PROJECTS-Array + render/nav (grün)
│ ├── director.js ← P4_PROJECTS-Array + render/nav (blau)
│ ├── assistant.js ← P5_PROJECTS-Array + render/nav (rot)
│ ├── editor.js ← P6_PROJECTS-Array + render/nav (gelb)
│ └── main.js ← Kern-Engine: Cursor, Physik, Übergänge, Navigation, Lader
├── .gitattributes ← Erzwingt LF-Zeilenumbrüche
└── SKILL.md ← Diese Datei
Skript-Ladereihenfolge
Skripte müssen in dieser Reihenfolge geladen werden (bereits in index.html festgelegt):
content.js → about.js → contact.js → production.js → director.js → assistant.js → editor.js → main.js
main.js ist als letztes, da es Funktionen aufruft, die in allen anderen Dateien definiert sind.
5. Inhalte aktualisieren
Biografie / Zitat / Filmografie ändern
Bearbeiten Sie js/content.js — das C-Objekt enthält alle zweisprachigen Texte:
const C = {
en: { sub: "...", about: [...], films: [...], ... },
vi: { sub: "...", about: [...], films: [...], ... }
};
Eine Projektkarte zu einer Rollenseite hinzufügen
Bearbeiten Sie die entsprechende js/*.js-Datei. Beispiel für ein Regie-Projekt (js/director.js):
const P4_PROJECTS = [
{
id: 'my-new-film',
title: 'Tên Phim',
en: 'Film Title',
year: '2025',
desc: 'Kurzbeschreibung des Projekts.',
img: '' // leer lassen oder URL hinzufügen
},
// ... vorhandene Einträge
];
Neue Projekte sollten oben im entsprechenden Rollen-Array (
js/assistant.js,js/director.js,js/production.js,js/editor.js) hinzugefügt werden, damit sie auf dieser Seite zuerst erscheinen. Die Anzeigereihenfolge sollte der Einfügereihenfolge für kürzlich hinzugefügte Elemente folgen, beginnend mit dem zuletzt hinzugefügten, das sich derzeit oben befindet.
Akzentfarben ändern
Bearbeiten Sie in style.css den :root-Block:
:root {
--green: #00e676; /* Produktion */
--blue: #1a6fff; /* Regie */
--red: #ff1a1a; /* Regieassistenz */
--yellow: #ffe000; /* Schnitt */
}
6. Cloudflare Content Loader (Optional)
main.js enthält einen GitHub-raw-Content-Loader. Wenn Sie Inhalte aktualisieren möchten, ohne neu zu deployen, hosten Sie eine content.json auf GitHub und konfigurieren Sie diese Konstanten am Anfang von main.js:
const GITHUB_OWNER = 'your-username';
const GITHUB_REPO = 'nguyenvuquochung-portfolio';
const GITHUB_BRANCH = 'main';
const GITHUB_PATH = 'content.json';
Wenn gesetzt, ruft die Website bei jedem Laden aktualisierte Inhalte ab. Leer lassen, um zu deaktivieren.
7. Fehlerbehebung
| Problem | Lösung |
|---|---|
| Website zeigt alte Version | Hard Refresh: Strg+Umschalt+R. Cloudflare-Cache leeren: Pages → Caching → Purge cache |
| Benutzerdefinierte Domain funktioniert nicht | Überprüfen Sie, ob der CNAME-Eintrag im Cloudflare DNS vorhanden ist; warten Sie bis zu 5 Min. auf die Verbreitung |
JS-Fehler X is not defined | Überprüfen Sie die Skript-Ladereihenfolge in index.html; main.js muss als letztes kommen |
| Porträtbild setzt sich beim Neuladen zurück | Erwartet – Porträt wird nur im Speicher gehalten. Verwenden Sie den GitHub Content Loader für Persistenz |
| Cloudflare injiziert E-Mail-Decode-Skript | Normales Verhalten; es umschließt Ihr <script>-Tag automatisch zur E-Mail-Verschleierung |