Astro : d’un CV à un site statique
Le chemin complet, pour un indépendant ou une association : transformer un profil et une idée de logo en un site qu’une seule personne peut maintenir. Le code compte plus que l’hébergement.
Au départ, deux éléments : un profil LinkedIn ou un CV, et une idée graphique. À l’arrivée, un site statique bilingue, sans base de données, sans serveur et sans framework côté client. Ce qui suit décrit les étapes, avec le code utile.
La tentation est d’écrire ses expériences directement en HTML. C’est l’erreur qui coûte le plus cher par la suite : chaque correction de date se fait à deux endroits, et une seconde langue double le travail. Il vaut mieux extraire le CV une fois en données typées, que les pages utilisent ensuite.
// src/data/missions.ts
export interface Mission {
id: string;
client: string; // identical in both languages
stack: string;
period: Bilingual<string>; // 'mai — septembre 2025' / 'May — September 2025'
title: Bilingual<string>;
}
export const MISSIONS: Mission[] = [
{
id: 'ocde',
client: 'OCDE',
stack: 'Microsoft Fabric · Power BI · Python',
period: { fr: 'mai : septembre 2025', en: 'May: September 2025' },
title: {
fr: 'Cas d’usage RH sur Microsoft Fabric',
en: 'HR use case on Microsoft Fabric',
},
},
];Le nom du client et la pile technique ne se traduisent pas ; la période et le titre, si. Séparer les deux dès le départ évite de traduire « Python » quarante fois. Une page de détail par mission se génère ensuite automatiquement.
--- // src/pages/missions/[id].astro
import { MISSIONS } from '../../data/missions';
export function getStaticPaths() {
return MISSIONS.map((m) => ({ params: { id: m.id }, props: { mission: m } }));
}
const { mission } = Astro.props;
---
<h1>{mission.title.fr}</h1>Une idée de logo ne fait pas une identité. Il faut produire les décisions qui en découlent : combien d’encres, quelles graisses, quelles tailles, quels espacements. Une fois écrites sous forme de design tokens, ces décisions deviennent l’unique référence, et le reste du site ne peut plus introduire de valeur nouvelle.
/* tokens/colors.css — three inks and one paper, nothing else */
:root {
--ink: #17171B;
--paper: #F6F4EF;
--accent: #C33A28;
}
/* The dark theme is a switch, not a filter:
the accent lightens, it does not invert. */
:root[data-surface='ink'] {
--ink: #F6F4EF;
--paper: #17171B;
--accent: #E8674C;
}Attention à un piège. Si un composant fixe « fond noir, texte blanc » en dur, il disparaît en mode sombre, où le noir est la couleur de la page. L’inversion doit être définie par rapport à la surface, et non en valeurs absolues.
:root { --surface-inverse: var(--ink); --on-inverse: var(--paper); }
:root[data-surface='ink'] { --surface-inverse: var(--paper); --on-inverse: var(--ink); }
.btn--primary {
background: var(--surface-inverse);
color: var(--on-inverse);
}Astro convient parce qu’il produit du HTML et n’envoie aucun JavaScript tant qu’on ne lui en demande pas. Pour un site vitrine, c’est le bon comportement par défaut : les pages restent lisibles sans script, et leur poids n’augmente pas avec le nombre de composants.
npm create astro@latest -- --template minimal
npm installLe résultat de la construction est du HTML lisible : les styles des composants sont isolés par un attribut, et aucune balise <script> n’apparaît tant qu’on n’en écrit pas.
<!-- dist/services/index.html — aucun script, aucun runtime -->
<article class="card" data-astro-cid-7f3k2p>
<h2 class="card__title" data-astro-cid-7f3k2p>Construire</h2>
<p class="card__note" data-astro-cid-7f3k2p>Applications web, plateformes analytiques.</p>
</article>Les styles généraux se chargent une fois dans la mise en page, et chaque composant garde les siens dans son propre fichier. Astro les isole automatiquement, sans convention de nommage à respecter.
--- // src/layouts/Base.astro
import '../styles/tokens.css';
const { title, lang } = Astro.props;
---
<html lang={lang}>
<head><title>{title}</title></head>
<body><slot /></body>
</html>La méthode coûteuse consiste à dupliquer les pages. La méthode durable consiste à écrire chaque page une fois et à la rendre accessible par deux routes : le contenu est dans une vue, et les fichiers de route ne font que transmettre la langue.
--- // src/pages/services.astro (French, at the root)
import Services from '../views/Services.astro';
---
<Services lang="fr" />
--- // src/pages/en/services.astro (English, prefixed)
import Services from '../../views/Services.astro';
---
<Services lang="en" />Le sélecteur de langue doit mener à la même page dans l’autre langue, et non à l’accueil. Ses deux étiquettes doivent aussi rester dans le même ordre. Si la langue courante est affichée en premier, les étiquettes échangent leur place à chaque clic, et le bouton se déplace sous le curseur.
export function alternatePath(path: string, lang: 'fr' | 'en') {
const stripped = path.replace(/^\/en(?=\/|$)/, '') || '/';
return lang === 'fr' ? `/en${stripped === '/' ? '' : stripped}` : stripped;
}Une charte qu’aucun contrôle ne vérifie reste une intention. Trente lignes de Node suffisent à refuser ce que l’identité interdit : une couleur écrite en dur, une fonte non déclarée, une ombre. Le contrôle s’exécute avant chaque publication, et il a déjà bloqué du code écrit dix minutes plus tôt.
// scripts/check-adherence.mjs
const RULES = [
{ id: 'hex', re: /#[0-9a-fA-F]{3,8}\b/g, msg: 'hard-coded colour — use a token' },
{ id: 'shadow', re: /box-shadow:\s*(?!none)/g, msg: 'no shadow in the system' },
];
for (const file of walk('src')) {
// Comments quote the values on purpose: neutralise them first.
const text = stripComments(readFileSync(file, 'utf8'));
text.split('\n').forEach((line, i) => {
for (const rule of RULES) {
if (rule.re.test(line)) findings.push(`${file}:${i + 1} ${rule.msg}`);
}
});
}
process.exit(findings.length ? 1 : 0);"scripts": {
"verify": "astro check && node scripts/check-adherence.mjs && astro build"
}Un symbole chargé par une balise <img> ne peut pas hériter de la couleur du texte : currentColor y désigne la couleur par défaut du fichier, et non celle de la page. En mode sombre, tous les pictogrammes sont restés noirs sur fond noir. La correction consiste à les insérer directement dans le document au lieu de les lier.
--- // src/components/Schema.astro
const FILES = import.meta.glob('../assets/*.svg', {
query: '?raw', import: 'default', eager: true,
});
const { name, height } = Astro.props;
const raw = FILES[`../assets/${name}.svg`];
// Strip width/height on the opening <svg> tag only:
// a global replace empties the <rect> elements inside as well.
const [, w, h] = raw.match(/viewBox="0 0 ([\d.]+) ([\d.]+)"/);
const width = Math.round((height * +w) / +h);
---
<span style="color: var(--ink)" set:html={resize(raw, width, height)} />C’est la partie la moins intéressante, ce qui est une bonne chose. Un site statique peut être hébergé n’importe où. Un dépôt privé, une tâche de construction qui refuse de publier si le contrôle échoue, un hébergeur statique : trois éléments, sans administration système.
- run: npm ci
- run: npm run verify # types + adherence + build; a failure publishes nothing
- uses: cloudflare/wrangler-action@v3
with:
apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
command: pages deploy dist --project-name=mon-site- Un CMS. Le contenu tient dans des fichiers versionnés, et une interface d’édition ajouterait une base de données à sauvegarder pour trois pages.
- Un framework côté client. Rien sur ce site ne nécessite de gestion d’état, et le seul script fait quelques lignes pour modifier un attribut.
- Les adresses électroniques dans les pages, que les robots collectent en premier.
- La mesure d’audience. Sans cookie, il n’y a pas de bandeau de consentement à prévoir.
Pour une association ou un indépendant, l’important est de pouvoir reprendre le site dans deux ans, plus que de le mettre en ligne. Des données typées, des design tokens et un contrôle qui bloque les écarts permettent cette reprise.