Projet personnel
Hugo + Toha · chinois / anglais / français
Un site statique trilingue propulsé par Hugo : accueil piloté par les données, archive académique où les cours renvoient aux projets et compétitions, pages de détail pour projets et compétitions, commentaires giscus, barre de progression et animations au défilement, et un générateur /cv/ qui transforme les données du site en PDF A4.
Un site sous thème peut héberger un CV, mais je voulais séparer complètement le contenu de la mise en page : les mêmes données d’études, de projets et de compétitions doivent alimenter l’accueil, l’archive académique, le CV et le blog en même temps. Seule une construction maison le permet.
Le site a démarré en avril 2024 avec un thème simple, puis est passé à Toha, en transformant progressivement l’accueil, les pages projets, les pages compétitions et l’archive académique en mises en page pilotées par les données. Aujourd’hui, c’est un portfolio trilingue, sans backend, lisible de bout en bout sur téléphone.
Plutôt qu’un mur de cartes, l’accueil suit un ordre de lecture réfléchi : à propos → compétences → expériences → formation → projets → compétitions → liens. Chaque section existe seule, mais lue à la suite, elle forme une présentation complète. L’ordre vient d’un champ weight : réorganiser revient à changer un nombre.
Projets, compétitions et archive académique suivent tous le schéma « page de liste + pages de détail » :
Le visiteur sait toujours où il est et où il peut aller.
Couleurs, tailles de texte et espacements sont partagés : titres de section soulignés, dates alignées à droite en chiffres tabulaires, léger déplacement au survol des cartes. Le mode sombre n’est pas une simple inversion : il redéfinit un jeu de variables CSS pour les voiles, les textes et les bordures.
layouts/ pour les projets, les compétitions, l’archive académique et la page CV ;data/ en YAML ; les gabarits ne font que les composer ;Bénéfice direct : ajouter un cours, un projet ou une photo est une modification de données, jamais de gabarit.
Chaque université dispose d’une archive complète :
#course-UR06), donc les pages projets pointent directement vers un cours ;Chaque page projet contient le cours et la période, mon rôle, des liens vers les dépôts (les dépôts publics sont liés directement, le dépôt source reste privé), les articles liés, les compétences liées et une section commentaires. Les articles liés rassemblent les retours techniques d’un même projet.
Les pages compétition mettent les résultats en avant : prix, période et rôle en tête, puis le contexte et ma part, et une galerie de certificats qui s’ouvrent en grand. Les articles liés apparaissent en bas.
La section liens de l’accueil rassemble GitHub, Gitee, CSDN, LeetCode, Luogu et LinkedIn. Les cartes de contributions et la chronologie d’activité récente montrent ce que je fais en ce moment, au-delà des lignes statiques du CV.
Des détails discrets pour une lecture confortable :
IntersectionObserver), et la préférence système « réduire les animations » désactive tout ;Un site purement statique n’a pas de serveur : les commentaires vivent dans GitHub Discussions, giscus ne charge qu’une iframe. Le thème des commentaires suit le mode clair/sombre du site, et les billets, projets et compétitions acceptent tous des commentaires.
/cv/ est la page la plus lourde du site : choisir une langue et les entrées, suivre un aperçu A4 paginé et exporter un PDF cliquable. Tout le contenu vient du YAML de l’accueil, et les versions anglaise et française pointent automatiquement les liens internes vers les pages correspondantes. Les détails sont dans cet article.
Le site existe en chinois, anglais et français : les traductions sont côte à côte (*.en.md / *.fr.md), les données vivent sous data/<lang>/, et les entrées de navigation uniquement chinoises sont étiquetées (Chinese) / (Chinois). La première visite redirige selon la langue du navigateur — délibérément pas selon l’IP, car VPN et déplacements rendent l’IP menteuse.
La publication est répartie sur deux dépôts :
publish.ps1 reconstruit, regroupe tout en un seul commit et force le push.Le dépôt source n’est pas public, mais le résultat publié et les données de commentaires le sont :
Les brouillons et les scripts n’atteignent jamais le dépôt GitHub Pages public, tandis que l’historique des sources reste complet.
La leçon principale : chaque fonctionnalité confortable repose sur des structures de données disciplinées. Si l’accueil avait été écrit en longs blocs HTML, ni les liens croisés de l’archive, ni le générateur de CV, ni les pages trilingues n’existeraient.
L’autre leçon est l’hygiène d’ingénierie : scripts de construction et de publication, empreintes de ressources, et pièges d’encodage (consoles Windows, PowerShell, deux-points et esperluettes en YAML) — chacun documenté, et la plupart racontés dans les articles de ce site.
Le site continue de grandir : recherche plein texte consciente du chinois, davantage de gabarits de CV, et des journaux de lecture annuels transformés en chronologie.