Project Taxonomy Guide
Project Taxonomy Guide
Structured front matter for projects and notes. Categories define the type of note; these fields add cross-cutting metadata.
See the Writing Guide for which category to use per note type.
Domain (domain)
Technical or thematic area — use on any note type, never as a Jekyll category:
data-sciencegeospatialmlopsweb-devai-agentsoptimizationenergy-modeling
Project hubs filtered by domain: /projects/.
Autonomy (autonomy)
How independently the work was carried out:
exercise— guided learning exercise (affiché learning sur le site)little-experiment— small independent exploration (weekend project, quick POC)solo-project— fully independent portfolio project
Production stage (stage)
How far the project has been taken toward production:
notebook— Jupyter notebook analysis or explorationprototype— working proof of conceptmvp— minimum viable productapp— deployed or production-ready application
Status (status)
Current state of the project or progress note:
goal— planned, not yet startedwip— work in progressdone— completed at the current stage
Featured (featured)
Set featured: true on a project hub to highlight it:
- Sorted first on /projects/ with a ★ Sélection badge
- Shown in the featured block on the home page
featured: true
Project link (project_id)
A slug shared between the project hub in _projects/ and related notes in _posts/.
Example: project_id: rc-model-heating links /projects/rc-model-heating/ to progress notes and timelines.
Competition (competition)
Optional slug for grouping challenge write-ups (category challenge):
titanicens-challenge-2024
Use one slug per competition across all related posts.
Image de couverture (header.teaser)
Image affichée sur les cartes projet (accueil, grille /projects/).
Tutoriel complet : /how-to/vignettes-projets/
---
title: "Mon projet"
header:
teaser: /assets/images/projects/mon-projet-cover.webp
teaser_alt: "Description courte de l'image pour l'accessibilité"
project_id: mon-projet
domain: geospatial
# ...
---
Conventions :
- Chemin relatif au site, ex.
/assets/images/projects/… - Format recommandé : 800×400 px (ratio 2:1) — WebP ou JPG
- Placeholders SVG fournis dans
assets/images/projects/— à remplacer par de vraies captures teaser_alt: texte lu par les lecteurs d’écran
Sans header.teaser, la carte utilise un fond coloré selon le domain.
Tags
Technologies and search keywords only: Python, QGIS, docker, Kaggle. Not for content type or domain.
Example front matter
Project hub (_projects/)
---
title: "RC Model for Home Heating"
permalink: /projects/rc-model-heating/
layout: single
project_id: rc-model-heating
domain: energy-modeling
autonomy: solo-project
stage: notebook
status: goal
featured: true
tags:
- Python
- RC model
---
Progress note
---
title: "Progress: calibration notebook"
date: "2025-06-01"
categories:
- progress
project_id: rc-model-heating
domain: energy-modeling
autonomy: solo-project
stage: notebook
status: wip
tags:
- Python
---
Challenge write-up
---
title: "Challenge: Titanic — baseline model"
date: "2025-06-01"
categories:
- challenge
domain: data-science
competition: titanic
tags:
- Kaggle
- classification
---