Communitygithub.com

nguyenvuquochung/nguyenvuquochung-portfolio

Installez ces extensions avant de commencer :

Qu'est-ce que nguyenvuquochung-portfolio ?

Ce skill automatise le déploiement du portfolio personnel de Nguyen Vu Quoc Hung sur Cloudflare Pages via VS Code et GitHub. Il fournit un guide complet pour configurer un dépôt Git, connecter Cloudflare Pages, et définir les paramètres de build pour un site statique (framework preset : None, répertoire de sortie : `/`). Le déploiement est déclenché automatiquement à chaque push sur la branche principale. Le skill inclut également des instructions pour la gestion du contenu bilingue (JS, anglais/vietnamien), l'ajout de projets, la modification des couleurs d'accent, et l'utilisation d'un chargeur de contenu GitHub optionnel pour éviter les redéploiements. Une section de dépannage couvre les problèmes courants comme le cache Cloudflare, les erreurs JS et les domaines personnalisés.

Compatible avec✓Claude Code~Codex CLI✓Cursor
npx skills add nguyenvuquochung/nguyenvuquochung-portfolio

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Workflow de déploiement du portfolio

VS Code → GitHub → Cloudflare Pages


1. Configuration unique

1.1 Extensions VS Code

Installez ces extensions avant de commencer :

  • Live Server (ritwickdey.liveserver) — prévisualisez le site localement sans étape de build
  • GitLens (optionnel) — vue améliorée de l'historique Git

1.2 Créer un dépôt GitHub

  1. Allez sur github.com → New repository
  2. Nom : nguyenvuquochung-portfolio (le nom du dossier doit correspondre pour éviter toute confusion)
  3. Visibilité : Public (requis pour Cloudflare Pages gratuit)
  4. Ne pas ajouter de README/gitignore (vous avez déjà des fichiers en local)

1.3 Initialiser Git localement

Ouvrez le terminal VS Code (Ctrl+`` ) et exécutez :

git init
git add .
git commit -m "Initial commit"
git branch -M main
git remote add origin https://github.com/VOTRE_NOM_UTILISATEUR/nguyenvuquochung-portfolio.git
git push -u origin main

Un fichier .gitattributes avec * text=auto eol=lf est déjà présent — cela garantit des fins de ligne Unix cohérentes sur toutes les plateformes.


2. Cloudflare Pages — Premier déploiement

2.1 Connecter le dépôt

  1. Connectez-vous sur dash.cloudflare.com
  2. Workers & Pages → Create application → Pages → Connect to Git
  3. Autorisez GitHub et sélectionnez le dépôt nguyenvuquochung-portfolio

2.2 Paramètres de build

Il s'agit d'un site statique sans étape de build :

ParamètreValeur
Framework presetNone
Commande de build(laisser vide)
Répertoire de sortie du build/
Répertoire racine(laisser vide)

Cliquez sur Save and Deploy. Votre site sera en ligne à l'adresse https://nguyenvuquochung-portfolio.pages.dev en ~30 secondes.

2.3 Domaine personnalisé via DNS Cloudflare

  1. Dans le projet Pages → Custom domains → Set up a custom domain
  2. Saisissez votre domaine (ex. nguyenvuquochung.com)
  3. Cloudflare ajoutera automatiquement les enregistrements DNS (CNAME pointant vers nguyenvuquochung-portfolio.pages.dev)
  4. Le certificat SSL est provisionné automatiquement — aucune configuration nécessaire

Si votre domaine a été enregistré en dehors de Cloudflare : Mettez d'abord à jour les serveurs de noms chez votre registrar avec ceux de Cloudflare, puis la configuration DNS automatique fonctionnera.


3. Workflow quotidien

Chaque fois que vous mettez à jour du contenu ou du code :

# 1. Enregistrez vos modifications dans VS Code
# 2. Staging, commit et push
git add .
git commit -m "Mise à jour : décrivez ce qui a changé"
git push

Cloudflare Pages détecte le push et redéploie automatiquement. En ligne en ~30 secondes.


4. Structure du projet

nguyenvuquochung-portfolio/
├── index.html          ← Squelette HTML (7 pages virtuelles, toute la mise en page)
├── style.css           ← Tout le CSS (variables, animations, système de pages)
├── js/
│   ├── content.js      ← Données textuelles bilingues (const C = {en, vi})
│   ├── about.js        ← renderP2() — Rendu de la page À propos
│   ├── contact.js      ← goToPage7 / goToPage1FromP7
│   ├── production.js   ← Tableau P3_PROJECTS + rendu/navigation (vert)
│   ├── director.js     ← Tableau P4_PROJECTS + rendu/navigation (bleu)
│   ├── assistant.js    ← Tableau P5_PROJECTS + rendu/navigation (rouge)
│   ├── editor.js       ← Tableau P6_PROJECTS + rendu/navigation (jaune)
│   └── main.js         ← Moteur principal : curseur, physique, transitions, navigation, chargeur
├── .gitattributes      ← Applique les fins de ligne LF
└── SKILL.md            ← Ce fichier

Ordre de chargement des scripts

Les scripts doivent être chargés dans cet ordre (déjà défini dans index.html) :

content.js → about.js → contact.js → production.js → director.js → assistant.js → editor.js → main.js

main.js est en dernier car il appelle des fonctions définies dans tous les autres fichiers.


5. Mise à jour du contenu

Modifier la biographie / citation / filmographie

Modifiez js/content.js — l'objet C contient tout le texte bilingue :

const C = {
  en: { sub: "...", about: [...], films: [...], ... },
  vi: { sub: "...", about: [...], films: [...], ... }
};

Ajouter une carte de projet à une page de rôle

Modifiez le fichier js/*.js correspondant. Exemple pour un projet de réalisateur (js/director.js) :

const P4_PROJECTS = [
  {
    id: 'mon-nouveau-film',
    title: 'Tên Phim',
    en: 'Film Title',
    year: '2025',
    desc: 'Courte description du projet.',
    img: ''           // laissez vide ou ajoutez une URL
  },
  // ... entrées existantes
];

Les nouveaux projets doivent être ajoutés en haut du tableau du rôle concerné (js/assistant.js, js/director.js, js/production.js, js/editor.js) afin qu'ils apparaissent en premier sur cette page. L'ordre d'affichage doit suivre l'ordre d'insertion pour les éléments récemment ajoutés, en commençant par le plus récent actuellement en haut.

Modifier les couleurs d'accent

Modifiez style.css, bloc :root :

:root {
  --green:  #00e676;   /* Production */
  --blue:   #1a6fff;   /* Réalisateur */
  --red:    #ff1a1a;   /* Assistant réalisateur */
  --yellow: #ffe000;   /* Monteur */
}

6. Chargeur de contenu Cloudflare (Optionnel)

main.js inclut un chargeur de contenu GitHub raw. Si vous souhaitez mettre à jour le contenu sans redéployer, hébergez un fichier content.json sur GitHub et configurez ces constantes en haut de main.js :

const GITHUB_OWNER  = 'votre-nom-utilisateur';
const GITHUB_REPO   = 'nguyenvuquochung-portfolio';
const GITHUB_BRANCH = 'main';
const GITHUB_PATH   = 'content.json';

Une fois configuré, le site récupérera le contenu mis à jour à chaque chargement. Laissez vide pour désactiver.


7. Dépannage

ProblèmeSolution
Le site affiche une ancienne versionRafraîchissement dur : Ctrl+Shift+R. Purge du cache Cloudflare : Pages → Caching → Purge cache
Le domaine personnalisé ne fonctionne pasVérifiez que le DNS Cloudflare a l'enregistrement CNAME ; attendez jusqu'à 5 min pour la propagation
Erreur JS X is not definedVérifiez l'ordre de chargement des scripts dans index.html ; main.js doit être en dernier
L'image de portrait se réinitialise au rechargementAttendu — le portrait est stocké uniquement en mémoire. Utilisez le chargeur de contenu GitHub pour la persistance
Cloudflare injecte un script de décodage d'emailComportement normal ; il encapsule automatiquement votre balise <script> pour l'obfuscation des e-mails

Skills associés