Projet personnel

Site personnel : une petite machine à publier trilingue

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.

Pourquoi le construire moi-même

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.

Rendre l’information facile à suivre

L’accueil est un CV que l’on fait défiler

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.

Deux niveaux : les listes pour l’aperçu, les détails pour la profondeur

Projets, compétitions et archive académique suivent tous le schéma « page de liste + pages de détail » :

  • la liste offre des filtres (tout / académique / programmation / médiation) pour comprendre l’orientation d’un coup d’œil ;
  • les pages de détail partagent un même gabarit : fil d’Ariane, titre et résumé, encart factuel (cours, période, rôle), articles liés, compétences liées et commentaires.

Le visiteur sait toujours où il est et où il peut aller.

Un langage visuel unique

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.

Construit avec Hugo

  • Générateur : Hugo (extended), déployé en fichiers statiques purs, sans backend ;
  • Thème : Toha comme base, avec des surcharges layouts/ pour les projets, les compétitions, l’archive académique et la page CV ;
  • Données : les sections de l’accueil et l’archive académique vivent dans data/ en YAML ; les gabarits ne font que les composer ;
  • Contenu : billets en Markdown avec des shortcodes maison (figures, citations, vidéo) ;
  • Ressources : images redimensionnées par largeur, CSS et JS minifiés et empreintés via Hugo Pipes — les caches restent toujours frais.

Bénéfice direct : ajouter un cours, un projet ou une photo est une modification de données, jamais de gabarit.

Ce que le site sait faire

Archive académique

Chaque université dispose d’une archive complète :

  • cours listés par semestre, avec code, note, GPA et crédits ECTS ;
  • notes colorées par tranche (90+, 80–89, 70–79, sous 70 ; les notes A/B/C sont traitées de la même manière) ;
  • les codes de cours sont des ancres (ex. #course-UR06), donc les pages projets pointent directement vers un cours ;
  • cours, projets de cours et compétitions se lient entre eux : un relevé de notes mène jusqu’à une page de compétition de drone.

Détail des projets

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.

Détail des compétitions

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.

Liens et activité

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.

Interactions et animations

Des détails discrets pour une lecture confortable :

  • une barre de progression de lecture se remplit en haut de page ;
  • un bouton « retour en haut » apparaît après 520 px ;
  • les blocs de contenu montent légèrement à l’entrée dans le viewport (IntersectionObserver), et la préférence système « réduire les animations » désactive tout ;
  • les blocs de code ont un bouton de copie avec confirmation brève.

Commentaires

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.

Générateur de CV

/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.

Trois langues et publication

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 :

  • un dépôt privé contient les sources Hugo et tout le contenu ;
  • un dépôt public ne reçoit que le résultat de construction : 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.

Ce que j’en retiens

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.

Notes techniques

01 Construire le site : configuration Hugo (chinois) Démarrer un site Hugo de zéro : arborescence, configuration et premiers gabarits. 02 Shortcodes, fils d'Ariane et structure des pages (chinois) Modéliser les contenus répétés avec des shortcodes, et les compromis des fils d'Ariane et tables des matières. 03 Cache des ressources et liens multilingues (chinois) Deux pièges rencontrés en publiant l'archive académique : différences local/ligne et préfixes de langue. 04 Redirection de langue sur un site statique (chinois) Comment fonctionne la redirection à la première visite, et pourquoi la géolocalisation IP a été écartée. 05 Des commentaires sur un blog statique avec giscus (chinois) Donner une section commentaires à un site sans serveur, et l'accorder au thème du site. 06 Construire un générateur de CV (chinois) Insertion des données, le piège de safeJS, pagination A4 par blocs et export jsPDF page par page.

Compétences associées

  • Hugo
  • Git