Configuration du site personnel
Accompagnez un nouvel utilisateur dans la création de son portfolio à l’adresse https://<son-nom-utilisateur>.github.io. L’architecture est fixe ; l’apparence, le contenu et le personnage du chatbot sont entièrement personnalisés pour l’utilisateur.
Ce qu’il obtient
- Site statique d’une seule page, sans bundler. GitHub Pages sert
mainà la racine du dépôt. - Hero — son portrait + nom + une ligne de localisation + une ligne d’accroche.
- Section Projets avec une frise chronologique verticale estompée dans l’en-tête de section (icônes de clé pour le travail, de livre pour les études, d’étincelle pour les projets annexes ; chaque étape montre l’entreprise, le rôle, la date, le lieu) et une grille de fiches projets dans le corps — le tout généré à partir du CV de l’utilisateur.
- Filtre frise ↔ fiches — survolez ou mettez au clavier une étape de la frise pour masquer les fiches projets non liées ; cliquez pour verrouiller le filtre (recliquez pour effacer). Seules les étapes ayant au moins une fiche liée deviennent interactives ; les autres restent inertes.
- Fiches pliables — chaque fiche projet n’affiche par défaut que sa catégorie + titre + étiquettes d’outils ; le résumé et la ligne de métriques apparaissent au survol/focus, ce qui rend la grille facile à parcourir.
- Chatbot (optionnel) — un lanceur flottant en bas à droite + un panneau contextuel (pas une section de page en ligne) alimenté par l’API compatible OpenAI de DeepSeek derrière un Cloudflare Worker qui détient la clé API. L’utilisateur choisit le nom du bot ; l’agent propose un avatar emoji correspondant. Les réponses du bot interprètent le Markdown. Limitation de débit à deux niveaux.
- Section Contact — email + les URL sociales de l’utilisateur.
Prérequis
| Nécessaire pour | Outil | Installation |
|---|---|---|
| Tout | git | généralement déjà installé |
| Tout | Compte GitHub + CLI gh | brew install gh puis gh auth login |
| Tout | python3 (aperçu local) | généralement déjà installé |
| Chatbot | Compte Cloudflare (gratuit) | https://dash.cloudflare.com |
| Chatbot | CLI wrangler | npm install -g wrangler puis wrangler login |
| Chatbot | Clé API DeepSeek | https://platform.deepseek.com/ → API keys |
| Changement de portrait | Node.js | brew install node |
Étapes
1. Recueillir les entrées de l’utilisateur
Faites ceci avant de toucher aux fichiers. Rassemblez tout en une fois pour que les étapes suivantes soient des modifications automatisées. Mélangez AskUserQuestion pour les choix multiples et les invites directes pour le texte libre.
Récupérez chacun de ces éléments auprès de l’utilisateur :
| Entrée | Comment demander | Exemple |
|---|---|---|
| Nom d’utilisateur GitHub | direct | jane (le dépôt sera jane.github.io) |
| Nom affiché | direct | Jane Doe ou Jane "JD" Doe |
| Phrase de localisation | directe, courte | Région parisienne, À distance, Tokyo |
| Accroche | directe, une phrase | Je construis des systèmes de ML et j’adore livrer. |
| CV | coller du texte ou chemin d’un fichier | CV complet — utilisé pour peupler la frise, les fiches projets, les connaissances du chatbot |
| Photo | chemin d’une image carrée sur le disque | /Users/jane/Desktop/portrait.jpg. L’utilisateur peut la déposer à la racine du dépôt en tant que raw.jpg après le clonage. |
| URL sociales | directes, chacune facultative | Profil LinkedIn / GitHub / Medium / email personnel |
| Chatbot ? | AskUserQuestion | oui / non |
| Nom du chatbot (si oui) | direct | Pot, Nova, Echo, etc. |
| Style visuel | AskUserQuestion | "Collez une URL que j’aime" OU "Décrivez-le avec des mots" |
Après avoir collecté le nom du chatbot, proposez 2–3 avatars emoji qui correspondent thématiquement et laissez l’utilisateur choisir. Exemples :
| Nom | Avatars proposés |
|---|---|
| Pot | 🫖 (théière) · 🍲 · 🎨 |
| Nova | 🌟 · 💫 · 🌠 |
| Echo | 📣 · 🔊 · 🌀 |
| Ember | 🔥 · 🪵 · ✨ |
| Atlas | 🗺️ · 🧭 · 🌍 |
| Bit | 💾 · 🔢 · 🤖 |
| Sage | 🌿 · 📖 · 🦉 |
Si rien d’évident ne correspond, proposez des neutres : 🤖, 💬, 🪄. Stockez l’emoji + le nom choisis — vous les écrirez dans le code plus tard.
2. Créer le dépôt GitHub
gh repo create <nom-utilisateur>.github.io --public --description "Site personnel"
Les sites utilisateurs GitHub Pages DOIVENT être à <nom-utilisateur>.github.io.
3. Cloner le template
git clone https://github.com/donotdonuts/donotdonuts.github.io mon-site
cd mon-site
rm -rf .git
git init -b main
git remote add origin https://github.com/<nom-utilisateur>/<nom-utilisateur>.github.io.git
4. Choisir un style visuel
Le template a par défaut une esthétique crème + IBM Plex Mono. Remplacez-la en fonction de la réponse de l’utilisateur de l’étape 1.
4a. Si l’utilisateur a donné une URL
Récupérez le CSS de la page et extrayez les tokens :
curl -sL "<url>" -o /tmp/ref.html
grep -oE 'href="[^"]+\.css[^"]*"' /tmp/ref.html | sort -u
curl -sL "<origine>/<chemin-css>" -o /tmp/ref-1.css
# police réellement appliquée au body
grep -oE 'body[^{]{0,30}\{[^}]+\}' /tmp/ref-1.css | head -5
# toutes les définitions de propriétés personnalisées CSS
grep -oE -- '--[a-zA-Z-]+:[^;}]+' /tmp/ref-1.css | sort -u | head -60
Cherchez : hex d’arrière-plan, hex de premier plan/encre, hex de bordure, hex d’accentuation, police appliquée au body, URL @font-face.
4b. Si l’utilisateur a donné une description
Traduisez la description en tokens concrets. Heuristiques :
| Mots | Implication |
|---|---|
| "minimal", "éditorial", "papier" | Fond crème/blanc cassé, encre foncée, séparateurs fins |
| "sombre", "terminal", "IDE" | Fond quasi noir (#0f1115), encre claire, bordures grises subtiles |
| "chaud", "analogique" | Crème légèrement jaune (#faf5e8), encre brun-noir |
| "brutaliste" | Blanc pur ou noir pur, bordures pleines de 2px+ |
| "technique", "données" | Monospace (IBM Plex Mono, JetBrains Mono), gris froids |
| "magazine", "éditorial" | Serif (EB Garamond, Fraunces), interlignage généreux |
| "ludique" | Une accentuation saturée, sinon atténuée |
4c. Proposer + appliquer
Compilez 13 tokens + une pile de polices. Montrez la palette proposée sous forme de bloc de code et obtenez l’approbation avant de modifier les fichiers.
:root {
--bg: <hex>; /* arrière-plan de la page */
--bg-soft: <hex>; /* sous-panneaux — généralement --bg mélangé à ~3% de --ink */
--bg-hover: <hex>; /* survol d’étiquette/chip */
--card-bg: <hex>; /* remplissage opaque des fiches (blanc si thème clair) */
--ink: <hex>; /* texte principal */
--ink-soft: <hex>; /* ~80% de --ink */
--ink-mute: <hex>; /* ~60% */
--ink-faint: <hex>; /* ~40% */
--border: <hex>; /* séparateurs subtils */
--border-strong: <hex>; /* séparateurs porteurs */
--up: <hex>; /* métriques positives (verdâtre par défaut) */
--down: <hex>; /* métriques négatives (rougeâtre par défaut) */
--accent-ink: <hex>; /* liens */
--font-mono: "<Famille>", ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
}
Ensuite :
- Ouvrez
css/styles.css, trouvez le bloc:root, remplacez les valeurs. - Ouvrez
index.html, mettez à jour le<link>Google Fonts dans<head>avec la nouvelle famille de polices + poids.
5. Générer le contenu à partir du CV + entrées
Utilisez le CV et les autres entrées de l’étape 1 pour remplir index.html :
-
<head>—<title>=<Nom affiché> — <premier-rôle-du-CV>;<meta name="description">à partir de l’accroche. -
Hero :
<h1 class="hero-title">← nom affiché<p class="hero-location">← phrase de localisation<p class="hero-tagline">← accroche
-
Frise chronologique — analysez le CV en étapes. Un
<li class="tl-stop">par rôle, par diplôme, ET par catégorie de projet personnel en cours que l’utilisateur souhaite mettre en avant. Ordre présent → plus ancien (haut en bas dans le DOM). Choisissez un slug courtdata-experiencepour chacun (par exemplemars,vibe,coach,gatech) — c’est ce que le filtre utilise pour lier les étapes aux fiches. Ajouteztabindex="0"uniquement sur les étapes qui ont au moins une fiche projet liée (les autres restent inertes).<li class="tl-stop tl-stop-travail" data-experience="<slug>" tabindex="0"> <!-- tl-stop-travail | tl-stop-edu | tl-stop-vibe (choisissez un) --> <svg class="tl-icon tl-icon-travail" aria-hidden="true"> <use href="#icon-cle"/> <!-- #icon-cle | #icon-livre | #icon-eticelle --> </svg> <div class="tl-info"> <strong>Entreprise / École</strong> <span>Rôle / Diplôme</span> <em>Début — Fin</em> <i class="tl-loc">Ville, État</i> </div> </li>Supprimez
tabindex="0"sur les étapes d’études/anciens rôles qui n’ont pas de fiches projets liées —js/main.jsles détecte automatiquement au chargement et les laisse non interactives. -
Projets — environ six blocs
<article class="project-card">, générés à partir des projets/réalisations notables du CV. Chaque fiche DOIT porter un slugdata-experiencecorrespondant à l’étape dont elle provient, sinon elle ne participera pas au filtre :<article class="project-card" data-experience="<slug>"> <header class="project-head"> <span class="project-tag">Catégorie</span> <h3>Titre du projet</h3> </header> <p>Résumé en 1–2 phrases tiré de la puce du CV.</p> <dl class="project-metrics"> <div><dt>Métrique</dt><dd class="up">+valeur</dd></div> <div><dt>Métrique</dt><dd>valeur</dd></div> </dl> <ul class="tag-list small"><li>Outil</li><li>Outil</li></ul> </article>Utilisez
<dd class="up">/<dd class="down">pour colorer les métriques. Les fiches s’affichent plissées par défaut — seuls la balise, le titre et les étiquettes d’outils sont visibles jusqu’au survol/focus-within qui révèle le résumé + les métriques. Gardez les résumés concis ; ils n’existent que pour récompenser un survol. -
Message d’accueil du chat — le message d’ouverture du bot est du HTML en ligne à l’intérieur de
#chat-paneldansindex.html(dans le<div class="chat-log">du panneau), donc il s’affiche instantanément lorsque l’utilisateur ouvre le panneau contextuel pour la première fois. Réécrivez-le en utilisant le nom du bot choisi + l’avatar emoji. Format :<div class="chat-msg chat-msg-bot"> <span class="chat-avatar" aria-label="<Nom du Bot>">EMOJI</span> <div class="chat-bubble"> <p>Bonjour, je suis <strong><Nom du Bot></strong> — l’assistant IA de <Nom affiché>, <verbe> à partir de son CV.</p> <p>Demandez-moi :</p> <ul> <li>Entreprises / rôles</li> <li>Méthodes / approches</li> <li>Projets / compétences / formation</li> </ul> <p>Que souhaitez-vous savoir ?</p> </div> </div> -
Contact — email + chaque URL sociale fournie en tant que
<li>dans.connect-list. Supprimez les lignes pour toute plateforme non fournie.
6. Ajouter le portrait
Demandez où se trouve sa photo. Copiez-la à la racine du dépôt en tant que raw.jpg, puis redimensionnez :
cp <chemin-photo-utilisateur> raw.jpg
mkdir -p assets
sips -Z 720 raw.jpg --out assets/portrait.jpg
Si le fond de la photo ne correspond pas au nouveau --bg, changez-le avec le script fourni :
cd /tmp && rm -rf img-fix && mkdir img-fix && cd img-fix
npm init -y > /dev/null
npm install [email protected] --silent
node <chemin-dossier-skill>/scripts/shift-portrait.js \
/path/to/mon-site/raw.jpg \
/path/to/mon-site/assets/portrait.jpg \
"#<votre-hex-bg>"
Par défaut à #fbf7eb si le troisième argument est omis. raw.jpg est dans .gitignore.
7. Configurer le chatbot (ignorer si l’utilisateur a dit non)
7a. Worker
cd worker
wrangler login
wrangler secret put DEEPSEEK_API_KEY
worker/wrangler.toml :
ALLOWED_ORIGIN = "https://<nom-utilisateur>.github.io,http://localhost:8000,http://127.0.0.1:8000"
MODEL = "deepseek-chat"
worker/worker.js → SYSTEM_PROMPT — réécrivez à partir du CV de l’utilisateur. Conservez la structure des sections (À propos / Rôle actuel / Rôles passés / Formation / Boîte à outils). Réécrivez également la phrase d’ouverture du personnage en utilisant le nom du bot + l’avatar :
const SYSTEM_PROMPT = `Vous êtes "<Nom du Bot>" <EMOJI> — un assistant IA amical et concis intégré sur le site personnel de <Nom affiché>. …`;
Déployez :
wrangler deploy
7b. Client
js/config.js :
window.SITE_CONFIG = {
chatWorkerUrl: "https://<worker>.workers.dev",
};
js/chatbot.js — mettez à jour les constantes en haut :
const AVATAR = "<EMOJI>";
const AVATAR_LABEL = "<Nom du Bot>";
8. Aperçu + publication
python3 -m http.server 8000 # http://localhost:8000
Parcourez chaque section. Testez le chat. Redimensionnez à la largeur mobile. Ensuite :
git add .
git commit -m "initial : site personnel"
git push -u origin main
En ligne à https://<nom-utilisateur>.github.io/ en moins de 60 secondes.
Architecture du template (ne pas modifier)
Mise en page des sections
Chaque section utilise .section-grid: 280px 1fr. La colonne de 280px correspond à la plus longue étiquette de la frise. Réduisez à 240px si toutes les étiquettes sont courtes, élargissez à 320px si longues.
Frise chronologique
- Se trouve dans l’en-tête de section Projets
section-head, juste en dessous du titre, àopacity: 0.45. Le survol, le focus ou un filtre actif la fait passer à 0,95. - L’ordre dans le DOM = ordre visuel du haut vers le bas. Présent → plus ancien. PAS proportionnel au temps — réparti uniformément via
gapflex. - Trois types d’icônes prêts à l’emploi :
#icon-cle(travail,.tl-stop-travail),#icon-livre(éducation,.tl-stop-edu),#icon-eticelle(vibe / projet annexe,.tl-stop-vibe). Les trois définitions<symbol>se trouvent dans le sprite SVG juste après<header>. Pour ajouter une nouvelle catégorie d’icône :- Ajoutez un
<symbol id="icon-foo">avec votre chemin SVG - Ajoutez
.tl-icon-foo { color: var(--ink-mute); } - Référencez avec
<svg class="tl-icon tl-icon-foo"><use href="#icon-foo"/></svg>
- Ajoutez un
- Chaque étape porte
data-experience="<slug>"; les étapes dont le slug correspond à au moins une fiche projet reçoivent égalementtabindex="0"pour quejs/main.jspuisse les rendre interactives pour le filtre.
Filtre de projet (clic + survol)
Entièrement piloté par js/main.js, zéro configuration — il analyse le DOM au chargement et branche les gestionnaires uniquement là où ils s’appliquent.
- Au chargement, chaque étape dont le slug
data-experienceest présent sur au moins une.project-cardreçoit.tl-stop-a-projets+role="button"+aria-pressed="false". Les étapes sans fiches liées restent inertes. - Survol / focus d’une étape interactive → filtre temporaire : les fiches non correspondantes deviennent
.is-dim(la grille ajoute.is-filtering, que CSS traduit endisplay: nonesur les fiches atténuées — elles sont retirées de la mise en page, pas seulement estompées). - Clic (ou
Entrée/Espace) → verrouillage : l’étape reçoit.is-locked, opacité totale, icône colorée à l’encre, nom d’entreprise souligné. Recliquez sur la même étape pour effacer ; cliquez sur une autre pour changer. - Pendant le verrouillage, survoler une autre étape prévisualise ses fiches ;
mouseleavesur la bande (oufocusouthors de celle-ci) ramène au filtre verrouillé.
Chatbot
- Le panneau contextuel est un
<aside>fixe en bas à droite. Le bouton de lancement est un<button>rond avec l’icône du chat. - Le composant
chatbot.jsest entièrement autonome — il crée le panneau DOM et le bouton de lancement lors de l’initialisation siwindow.SITE_CONFIG.chatWorkerUrlest défini. - Limitation de débit : 10 requêtes par minute par adresse IP (appliquée côté Worker) ; 20 messages cumulés par session dans le client — au-delà, le bouton d’envoi est désactivé avec un message « Limite de session atteinte ».
- Toutes les réponses du bot sont rendues en Markdown via
marked(chargé à partir d’un CDN).
Couleurs et thème
Le bloc :root dans css/styles.css est le seul endroit qui contrôle les couleurs. Ne dupliquez pas les variables de couleur ailleurs. Si une règle CSS a besoin d’une nuance, utilisez color-mix() ou rgba() avec les tokens racine.
Responsive
/* la grille devient verticale en dessous de 720px */
@media (max-width: 720px) {
.section-grid { grid-template-columns: 1fr; }
.section-head { margin-bottom: 0; }
}
Ne personnalisez pas davantage — le template gère le reste.
Gestion des erreurs
| Problème | Cause probable | Correctif |
|---|---|---|
| La frise ne filtre pas | data-experience mal écrit sur une fiche ou une étape | Vérifiez la correspondance des slugs ; ils doivent être identiques |
| Le chat ne répond pas | L’URL du Worker dans js/config.js est incorrecte | Remplacez-la par l’URL réelle après wrangler deploy |
| Le portrait n’a pas la bonne couleur de fond | Le script n’a pas été appelé, ou le code hex n’est pas celui de --bg | Relancez shift-portrait.js avec le bon hex |
| GitHub Pages 404 | Le dépôt ne s’appelle pas <nom-utilisateur>.github.io | Renommez le dépôt sur GitHub |
Liste de vérification finale
- La frise est dans l’ordre (présent → plus ancien)
- Chaque étape avec au moins une fiche a
tabindex="0" - Les fiches projets utilisent les bons slugs
data-experience - Le message d’accueil du chatbot utilise le nom et l’emoji choisis
-
js/config.jspointe vers le Worker déployé - Le portrait a été redimensionné à 720px et le fond changé
- Le site s’affiche correctement sur mobile (720px et moins)
- Le commit initial a été poussé sur
main