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
- Allez sur github.com → New repository
- Nom :
nguyenvuquochung-portfolio(le nom du dossier doit correspondre pour éviter toute confusion) - Visibilité : Public (requis pour Cloudflare Pages gratuit)
- 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
- Connectez-vous sur dash.cloudflare.com
- Workers & Pages → Create application → Pages → Connect to Git
- 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ètre | Valeur |
|---|---|
| Framework preset | None |
| 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
- Dans le projet Pages → Custom domains → Set up a custom domain
- Saisissez votre domaine (ex.
nguyenvuquochung.com) - Cloudflare ajoutera automatiquement les enregistrements DNS (CNAME pointant vers
nguyenvuquochung-portfolio.pages.dev) - 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ème | Solution |
|---|---|
| Le site affiche une ancienne version | Rafraîchissement dur : Ctrl+Shift+R. Purge du cache Cloudflare : Pages → Caching → Purge cache |
| Le domaine personnalisé ne fonctionne pas | Vérifiez que le DNS Cloudflare a l'enregistrement CNAME ; attendez jusqu'à 5 min pour la propagation |
Erreur JS X is not defined | Vérifiez l'ordre de chargement des scripts dans index.html ; main.js doit être en dernier |
| L'image de portrait se réinitialise au rechargement | Attendu — 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'email | Comportement normal ; il encapsule automatiquement votre balise <script> pour l'obfuscation des e-mails |