Communitygithub.com

nguyenvuquochung/nguyenvuquochung-portfolio

Installieren Sie diese Erweiterungen vor dem Start:

Was ist nguyenvuquochung-portfolio?

Diese AI-Agentenfähigkeit beschreibt einen vollständigen Workflow zur Bereitstellung einer statischen Portfolio-Website über VS Code, GitHub und Cloudflare Pages. Sie ist speziell für das Repository 'nguyenvuquochung-portfolio' konzipiert, das eine mehrsprachige, seitenbasierte Portfolio-Website mit Rollen (Produktion, Regie, Regieassistenz, Schnitt) enthält. Der Workflow führt den Benutzer von der Einrichtung der VS Code-Erweiterungen über die initiale Git-Initialisierung und das Erstellen des GitHub-Repos bis hin zum ersten Deploy auf Cloudflare Pages – ohne Build-Schritt. Auch das Einrichten einer benutzerdefinierten Domain über Cloudflare DNS wird erklärt. Der tägliche Workflow beschreibt, wie Inhalte über `git push` aktualisiert werden, woraufhin Cloudflare automatisch neu deployt. Darüber hinaus werden detaillierte Informationen zur Projektstruktur, zur Aktualisierung von Inhalten (Biografie, Filmografie, Projektkarten) sowie zur Anpassung von Akzentfarben gegeben. Optional kann ein GitHub-Content-Loader aktiviert werden, um Inhalte ohne erneutes Deployment zu aktualisieren. Ein Troubleshooting-Abschnitt hilft bei häufigen Problemen wie Cache-Problemen, JS-Fehlern oder Domain-Problemen.

Funktioniert mit✓Claude Code~Codex CLI✓Cursor
npx skills add nguyenvuquochung/nguyenvuquochung-portfolio

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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

  1. Gehen Sie zu github.com → New repository
  2. Name: nguyenvuquochung-portfolio (Ordnername entsprechend wählen, um Verwirrung zu vermeiden)
  3. Sichtbarkeit: Public (erforderlich für kostenlose Cloudflare Pages)
  4. 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

  1. Melden Sie sich bei dash.cloudflare.com an
  2. Workers & Pages → Create application → Pages → Connect to Git
  3. Autorieren Sie GitHub und wählen Sie das Repository nguyenvuquochung-portfolio aus

2.2 Build-Einstellungen

Dies ist eine statische Website ohne Build-Schritt:

EinstellungWert
Framework-VoreinstellungKeine
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

  1. Im Pages-Projekt → Custom domains → Set up a custom domain
  2. Geben Sie Ihre Domain ein (z.B. nguyenvuquochung.com)
  3. Cloudflare fügt automatisch die DNS-Einträge hinzu (CNAME-Zeiger auf nguyenvuquochung-portfolio.pages.dev)
  4. 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

ProblemLösung
Website zeigt alte VersionHard 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ückErwartet – Porträt wird nur im Speicher gehalten. Verwenden Sie den GitHub Content Loader für Persistenz
Cloudflare injiziert E-Mail-Decode-SkriptNormales Verhalten; es umschließt Ihr <script>-Tag automatisch zur E-Mail-Verschleierung

Verwandte Skills