Créer un site personnel
Objectif
Créer ou reconcevoir un site web personnel sous forme de fichiers statiques simples : HTML, CSS et éventuellement JavaScript vanilla.
Cette compétence est l'étape d'implémentation après avoir choisi une direction visuelle. Elle transforme une recommandation de thème, un profil utilisateur, des notes, des exemples d'articles, des descriptions de projets ou un dossier de site statique existant en un site personnel fonctionnel.
Promesse principale :
- Aucun framework.
- Aucune étape de construction.
- Aucune installation de paquets.
- Aucune dépendance d'exécution.
- Ouvrir directement
index.htmlpour un aperçu manuel. - Utiliser des liens relatifs aux pages et des ressources pour que l'ouverture directe de fichier, le HTTP local et l'hébergement statique fonctionnent tous.
- Déployer le dossier sur un hébergement statique.
Pour un contrôle qualité automatisé via navigateur, servez le dossier statique en HTTP local plutôt que d'ouvrir des URL file://.
Contrat
Entrées :
- Direction thématique, informations de profil utilisateur, besoins en pages, contenu échantillon ou un dossier statique existant.
- Références facultatives qui doivent guider le style sans exiger une reproduction haute-fidélité.
- Dossier de sortie souhaité et contraintes statiques.
Sorties :
- Un dossier de site statique simple avec HTML, CSS, JavaScript vanilla facultatif, ressources locales et types de pages représentatifs.
EDITING.mdpour les modifications futures lors de la création d'un nouveau site ou d'une refonte majeure.- Instructions d'aperçu local et résumé de validation.
Limites :
- Ne pas recréer fidèlement un site web cible spécifique ; utiliser
copy-website-style. - Ne pas importer de grandes archives d'écrits ; utiliser
add-blog-posts. - Ne pas publier ni configurer l'hébergement ; utiliser
publish-static-site. - Ne pas introduire de frameworks, installations de paquets, backends, CMS, authentification ou bases de données, sauf demande explicite de l'utilisateur.
Condition de succès :
- Les types de pages requis existent et la navigation pointe vers des chemins relatifs réels.
- Le site fonctionne comme des fichiers statiques simples, sans étape de construction.
- La source est lisible en UTF-8, les espaces réservés sont clairs, et
review-static-sitepeut réussir ou ne signaler que des limitations acceptées.
Si la condition échoue :
- Corrigez les types de pages manquants, les chemins, les ressources, l'encodage, les espaces réservés ou les problèmes de navigateur dans cette compétence.
- Utilisez
personalize-sitelorsque l'échec est dû à une identité/contenu utilisateur manquant. - Réutilisez
review-static-siteaprès les corrections.
Pipeline court
Suivez ce pipeline pour un travail de site personnel original :
- Clarifiez l'objectif du site, la direction thématique, le contenu disponible et le périmètre des pages.
- Décidez de la carte des pages statiques et de la stratégie des espaces réservés avant de coder.
- Construisez d'abord la structure commune : en-tête, navigation, mise en page principale, pied de page, variables CSS globales et interactions partagées.
- Implémentez la page d'accueil et chaque type de page demandé ou implicite.
- Utilisez le contenu de l'utilisateur ou des espaces réservés clairement remplaçables ; n'inventez pas d'identité personnelle détaillée.
- Ajoutez un guide d'édition pour les modifications futures par modèle/utilisateur.
- Vérifiez la compatibilité des chemins d'ouverture directe avec des liens relatifs et des ressources.
- Validez localement via HTTP dans un navigateur réel.
- Vérifiez les liens, les ressources, les types de pages et la lisibilité de la source UTF-8 avant la livraison finale.
Quand l'utiliser
Utilisez cette compétence lorsque l'utilisateur :
- Souhaite un site personnel, blog, page d'accueil, portfolio, page de recherche ou site web statique simple en HTML/CSS/JS.
- Demande à implémenter une direction thématique produite par
search-blog-theme. - Souhaite un site simple sans framework, facile à inspecter, éditer et déployer.
- Souhaite reconcevoir un site statique existant tout en le gardant sans dépendance.
- Fournit des références visuelles lâches, mais n'exige pas une reproduction haute-fidélité.
Ne pas l'utiliser quand
N'utilisez pas cette compétence lorsque :
- L'utilisateur souhaite seulement rechercher des thèmes ou comparer des références visuelles. Utilisez
search-blog-theme. - L'utilisateur souhaite recréer fidèlement l'apparence, la mise en page, l'animation ou l'interaction d'un site web spécifique. Utilisez
copy-website-style. - L'utilisateur souhaite migrer de nombreux articles, convertir des notes Obsidian, réparer des frontmatter, ou déplacer de grandes archives de contenu. Utilisez
add-blog-posts. - L'utilisateur souhaite uniquement de l'aide pour le déploiement, le DNS, GitHub Pages, Cloudflare Pages, Cloudflare Pages Direct Upload, Netlify ou Vercel. Utilisez
publish-static-site. - L'utilisateur demande explicitement un projet avec framework comme Next.js, Astro, Hugo, Jekyll, Quartz ou React.
- L'utilisateur demande un backend, une base de données, une authentification, un CMS, un système de commentaires ou un comportement serveur dynamique.
Entrées
Utilisez tout ce que l'utilisateur fournit. Ne bloquez pas si certains détails manquent.
Les entrées utiles incluent :
- Direction thématique : archive de code privée, tableau de bord de journal de recherche, jardin numérique, portfolio bento, carnet de terrain, système d'exploitation personnel, etc.
- Profil utilisateur : nom, courte biographie, rôle, localisation, liens sociaux, avatar, CV, publications, projets.
- Besoins en pages : accueil, à propos, blog, projets, notes, publications, contact.
- Contenu échantillon : 1 à 3 articles, descriptions de projets, extraits Markdown, pages HTML plus anciennes.
- Dossier de site existant : fichiers HTML/CSS/JS actuels à conserver ou à refactoriser.
- Références lâches : v0, Figma, thèmes GitHub, modèles de framework, captures d'écran ou références d'ambiance.
Règle des références
Les références peuvent provenir de n'importe quelle pile. Traitez-les comme des références visuelles et structurelles, non comme des choix d'implémentation, sauf si l'utilisateur demande explicitement d'utiliser ce framework.
Pour un site statique simple, traduisez les références comme suit :
- Composants React, Next ou Astro -> sections HTML répétées avec classes CSS réutilisables.
- Classes utilitaires Tailwind -> règles CSS normales dans
assets/style.css. - Routes de framework -> fichiers
.htmlliés. - Collections de contenu ou données CMS -> listes HTML statiques ou petits fichiers JSON.
- Configuration de thème -> propriétés personnalisées CSS.
- Interactions simples -> JavaScript vanilla uniquement lorsque c'est utile.
Si l'utilisateur souhaite correspondre fidèlement à un site web spécifique, déléguez à copy-website-style au lieu de le traiter comme une référence lâche.
Structure de site par défaut
Pour un nouveau site, préférez cette structure sauf demande contraire de l'utilisateur :
site/
index.html
EDITING.md
about.html
blog.html
projects.html
posts/
first-post.html
assets/
style.css
script.js
images/
data/
posts.json
profile.json
Pour un site existant, conservez la structure actuelle de l'utilisateur lorsque c'est pratique. Ne renommez pas ou ne réorganisez pas de grandes parties du site à moins que cela n'améliore clairement le travail demandé.
Attentes concernant les pages
Créez uniquement les pages nécessaires à la demande de l'utilisateur. Pour un starter de site personnel complet, incluez :
- Accueil : identité, courte introduction, zone héroïque spécifique au thème, articles récents, projets sélectionnés.
- À propos : biographie, centres d'intérêt, compétences, contact, liens sociaux, CV/publications facultatif.
- Index du blog : liste d'articles avec titre, date, tags et résumé.
- Page d'article : mise en page d'article lisible avec titre, date, tags, contenu et navigation de retour à l'index du blog.
- Projets : cartes ou lignes de projet avec description, pile technique, liens et résultat.
Rendez le premier écran utile. Ne créez pas une page d'atterrissage marketing lorsque l'utilisateur a demandé un site personnel ou un blog.
Pour un starter de site personnel ou blog complet, ne vous arrêtez pas à une seule page d'accueil. Créez des types de pages représentatifs fonctionnels, même si le contenu n'est que des espaces réservés :
- Au moins une page d'article/détail pour un blog.
- Une page de liste ou d'archive lorsque des articles, notes, projets ou publications font partie du site.
- Une page de profil/à propos lorsque la page d'accueil renvoie à l'identité ou aux détails de fond.
- Toute page spéciale implicite du concept choisi, comme notes, liens, jardin, now, uses, publications ou expériences.
Pour de grandes collections de contenu futures, créez la structure et quelques entrées d'espace réservé représentatives plutôt que d'inventer une archive complète.
Règle de compatibilité des chemins
Les sites statiques générés doivent fonctionner lorsque l'utilisateur ouvre directement index.html, lorsqu'ils sont servis en HTTP local, et lorsqu'ils sont déployés sur des hébergeurs statiques courants.
Règles par défaut :
- Utilisez des chemins relatifs aux pages pour tous les liens et ressources locaux au site.
- Depuis les pages racines, liez CSS/JS/images comme
assets/style.css,assets/script.js,assets/images/avatar.png, et les pages commeabout.htmlouposts/example.html. - Depuis les pages imbriquées comme
posts/example.html, liez les ressources partagées comme../assets/style.csset les pages racines comme../blog.htmlou../index.html. - N'utilisez pas de chemins absolus à la racine du site comme
/assets/style.css,/assets/script.js,/posts/example.html,/data/posts.json,/images/foo.png, ou/sauf si l'utilisateur accepte explicitement un comportement limité au serveur racine. - Appliquez la même règle aux
url(...)CSS, favicons, images Open Graph, images de couverture, polices, ressources KaTeX/math, liens RSS/sitemap et URL générées par JavaScript. - Lors du déplacement ou de l'ajout d'une page, recalculez les chemins en fonction de la profondeur du dossier de cette page au lieu de copier des liens depuis une page racine.
Évitez les hypothèses limitées au serveur :
- Ne comptez pas sur
fetch("data/posts.json")ou d'autres récupérations de fichiers locaux pour la navigation principale, les listes d'articles ou le contenu de la page d'accueil si l'aperçu par ouverture directe fait partie de la promesse. - Si des données répétées sont utiles, soit rendez le contenu essentiel directement en HTML, soit stockez les données dans un objet JavaScript local chargé avec une balise
<script src="assets/script.js">relative. - Les améliorations facultatives peuvent utiliser des fichiers de données uniquement lorsque la page reste lisible et navigable sans cette récupération.
Règles de style
Laissez le thème sélectionné guider le langage visuel, mais gardez le site lisible et maintenable.
- Mettez le style global du site dans
assets/style.css. - Utilisez des propriétés personnalisées CSS pour les couleurs, les espacements, les bordures et les choix typographiques.
- Utilisez du HTML sémantique lorsque c'est possible :
header,nav,main,article,section,footer. - Utilisez des règles de mise en page réactives pour que les pages fonctionnent sur mobile et desktop.
- Rendez les pages d'articles plus calmes que la page d'accueil si le thème est visuellement intense.
- Préférez les polices système sauf si l'utilisateur demande une police spécifique ou si le thème en nécessite fortement une.
- Ne comptez pas sur des ressources distantes sauf si l'utilisateur les fournit ou si elles sont clairement acceptables.
- Ne laissez pas les effets décoratifs gêner la lecture, la navigation ou l'accessibilité.
Règles d'interaction
Utilisez du JavaScript vanilla uniquement lorsqu'il apporte une valeur claire.
Bons usages :
- Bouton de bascule de navigation mobile.
- Bouton de bascule de thème.
- Filtrage léger par tag ou article.
- Petits effets progressifs qui n'affectent pas la lecture principale.
À éviter :
- Frameworks d'animation lourds.
- Décoration lourde basée sur Canvas sauf demande explicite de l'utilisateur.
- Effets nécessitant un serveur de développement ou une installation de paquets.
- Scintillement continu, effets de glitch agressifs ou effets de défilement qui nuisent à la lecture.
Respectez prefers-reduced-motion pour les thèmes animés.
Règle de simplification statique
Lorsqu'une référence lâche comporte des fonctionnalités complexes ou dépendantes d'un framework, traduisez-les en équivalents statiques plus simples :
- Globe 3D -> carte thématique, panneau de statut, constellation de projets ou bloc visuel statique.
- Grille bento animée -> grille CSS réactive avec effets de survol subtils.
- Simulateur de terminal -> navigation thématique et contenu de style journal, pas une fausse ligne de commande sauf si utile.
- Graphe de connaissances -> tags, articles connexes, index thématique ou liens organisés manuellement.
- Recherche dynamique -> entrée de filtre simple, pages de tags statiques ou pas de recherche pour la première version.
- Articles pilotés par CMS ->
posts/*.htmlplusdata/posts.json.
Préférez une version statique propre qui capture le ressenti souhaité par l'utilisateur plutôt qu'une copie surdimensionnée de la référence.
Règle pour site existant
Lors de la modification d'un site existant :
- Inspectez la structure de fichiers actuelle avant d'éditer.
- Préservez le contenu utilisateur et les fichiers non liés.
- Limitez les modifications aux pages et ressources demandées.
- Réutilisez les conventions visuelles existantes lorsqu'elles fonctionnent déjà.
- Évitez de remplacer l'intégralité du site sauf si l'utilisateur demande une refonte complète.
- Si le site possède déjà
style.cssouscript.js, étendez-les soigneusement plutôt que de créer des doublons conflictuels.
Règle de contenu
Pour de petites quantités de contenu, écrivez du HTML statique directement.
Pour du contenu répété comme des articles ou des projets, utilisez :
- Du HTML statique répété lorsque la liste est courte.
- Un objet de données JavaScript local plus un rendu JavaScript vanilla lorsque cela améliore la maintenabilité.
- Un petit fichier JSON uniquement lorsque le site est autorisé à nécessiter du HTTP local/hébergement statique pour cette fonctionnalité, et que la page principale fonctionne toujours sans cela.
N'inventez pas de faits personnels détaillés. Utilisez des espaces réservés clairement lorsque les données utilisateur manquent.
Gardez les espaces réservés faciles à trouver et à remplacer. Préférez stocker le contenu répété dans un endroit clairement nommé comme data/*.json, un bloc de données documenté dans assets/script.js, ou une section HTML répétée avec des noms de classe stables.
Marquez clairement le texte d'espace réservé, les articles de démonstration, les exemples de projets et les liens factices dans les fichiers ou EDITING.md afin que l'utilisateur ou un modèle futur puisse les remplacer avant publication.
Règle du guide d'édition
Lors de la création d'un nouveau site ou d'une refonte matérielle d'un site existant, incluez EDITING.md dans le dossier de sortie.
EDITING.md est principalement destiné à un modèle ou agent futur qui modifiera le site généré plus tard. Restez concis mais concret. Expliquez :
- Hiérarchie des dossiers et à quoi chaque fichier/dossier sert.
- Formats de fichiers utilisés par le site : HTML, CSS, JS, JSON/blocs de données et images.
- Carte des pages : quel fichier généré est l'accueil, à propos/profil, blog/liste, article/détail, projets, notes, liens ou autres types de pages.
- Régions de mise en page partagée : en-tête, navigation, navigation mobile, contenu principal, pied de page, barres latérales, superpositions ou contrôles de thème.
- Où se trouve chaque région majeure de la page d'accueil dans
index.html, en utilisant les noms de section/classe à proximité. - Où se trouve chaque modèle de sous-page et comment les liens internes y connectent.
- Où le contenu répété est stocké et son format d'objet/balisage attendu.
- Comment modifier le titre du site, le slogan, l'avatar/logo, la navigation, les articles en vedette, les listes de projets, les listes de liens, les images, les couleurs et les variables de thème.
- Quel contenu est uniquement un espace réservé et doit être remplacé avant publication.
Règle d'intégrité de l'encodage
Les fichiers source générés doivent être en UTF-8 valide et lisibles par un humain dans leur forme source, pas seulement corrects visuellement dans des captures d'écran de navigateur.
Pour les pages ou guides d'édition contenant du texte chinois, japonais, coréen, latin accentué ou autre contenu non ASCII :
- Incluez
<meta charset="utf-8">dans les fichiers HTML. - Écrivez les fichiers en UTF-8.
- Vérifiez la lisibilité de la source avec un lecteur compatible UTF-8 avant la livraison finale.
...
[abrégé pour la traduction]