iducationducation
IndexArticlesFormationsProfilOutilsBibliothech
N°014 — 2026
Navigation
01Index02Articles03Formations04Profil05Outils06Bibliothech
N°014 — 2026
iducationducation
IndexArticlesFormationsProfilOutilsBibliothech
N°014 — 2026
Navigation
01Index02Articles03Formations04Profil05Outils06Bibliothech
N°014 — 2026
Formations
Markdown · Débutant

GitHub Profile README

Construire un profil GitHub qui attire l'attention — badges dynamiques, stats en temps réel, mise en page soignée et automatisation via GitHub Actions.

Markdownshields.ioGitHub ActionsSVG
GitHub
01Le repo spécial GitHub02Markdown avancé et HTML inline03Badges shields.io04Stats GitHub dynamiques05Mise en page et design06Contenu et personal branding07Automatisation avec GitHub Actions
Chapitre 4·20 min

Stats GitHub dynamiques

Plusieurs services génèrent des cartes SVG dynamiques basées sur l'API GitHub. Elles se rafraîchissent à chaque chargement de page — les stats sont toujours à jour.

github-readme-stats

github-readme-stats est le service le plus utilisé. Il expose plusieurs types de cartes.

Carte de stats globales

README.md
<div align="center">
  <img
    src="https://github-readme-stats.vercel.app/api?username=williamloree&show_icons=true&theme=tokyonight&hide_border=true&include_all_commits=true&count_private=true"
    alt="GitHub Stats"
    height="180"
  />
</div>

Paramètres clés :

ParamètreValeurEffet
usernamewilliamloreeVotre username
themetokyonightThème visuel
hide_bordertrueSupprime la bordure
include_all_commitstrueCompte tous les commits, pas juste l'année
count_privatetrueInclut les repos privés
show_iconstrueAffiche les icônes à côté des stats

Carte des langages

README.md
<img
  src="https://github-readme-stats.vercel.app/api/top-langs/?username=williamloree&layout=compact&theme=tokyonight&hide_border=true&langs_count=8"
  alt="Top Languages"
  height="180"
/>

layout=compact affiche les langages en grille dense. langs_count=8 limite à 8 langages.

Pour exclure un repo du calcul (ex: un repo de cours avec beaucoup de HTML qui fausse les stats) :

&exclude_repo=nom-du-repo,autre-repo

Mettre les deux côte à côte

README.md
<div align="center">
  <img
    src="https://github-readme-stats.vercel.app/api?username=williamloree&show_icons=true&theme=tokyonight&hide_border=true"
    height="180"
  />
  <img
    src="https://github-readme-stats.vercel.app/api/top-langs/?username=williamloree&layout=compact&theme=tokyonight&hide_border=true"
    height="180"
  />
</div>

GitHub affiche les deux <img> côte à côte jusqu'à ce que la largeur totale dépasse celle du profil. Sur mobile, elles passent en colonne automatiquement.

GitHub Streak Stats

README.md
<div align="center">
  <img
    src="https://streak-stats.demolab.com?user=williamloree&theme=tokyonight&hide_border=true&date_format=j%20M%5B%20Y%5D"
    alt="GitHub Streak"
  />
</div>

Affiche trois métriques : total de contributions, streak actuel, et plus long streak. Utile pour montrer une activité régulière.

Thèmes disponibles

Les principaux services partagent les mêmes noms de thèmes :

ThèmeAmbiance
darkNoir simple
tokyonightBleu nuit — le plus populaire
radicalRose/violet
merkoVert terminal
gruvboxTons chauds
onedarkVS Code One Dark
draculaDracula classic
github_darkThème GitHub sombre officiel

Pour un profil cohérent, utiliser le même thème partout.

Trophées GitHub

README.md
<div align="center">
  <img
    src="https://github-profile-trophy.vercel.app/?username=williamloree&theme=tokyonight&no-frame=true&row=1&column=7"
    alt="Trophées"
  />
</div>

github-profile-trophy génère des trophées selon des critères : nombre de repos, de commits, de followers, d'étoiles, de PRs, d'issues, et de reviews.

row=1&column=7 affiche tous les trophées sur une seule ligne horizontale.

Carte de contribution — activité récente

README.md
<img
  src="https://github-readme-activity-graph.vercel.app/graph?username=williamloree&theme=tokyo-night&hide_border=true&area=true"
  width="100%"
  alt="Activité"
/>

github-readme-activity-graph génère un graphe de contributions façon GitHub mais en SVG exportable. area=true remplit la zone sous la courbe.

Limites de taux API

Ces services font des appels à l'API GitHub. En production, ils passent par leur propre token GitHub et gèrent le rate limiting. Si une carte s'affiche en erreur (failed to fetch), c'est souvent un dépassement de quota temporaire — la carte se rétablit seule.

Pour des stats fiables sur les repos privés, certains services demandent à déployer sa propre instance Vercel avec son propre token GitHub.

Précédent
Badges shields.io
Suivant
Mise en page et design

Développeur fullstack passionné. J'apprends en construisant et je documente tout — front, back, outils. Le code s'apprend mieux en public.

Naviguer

IndexTous les articlesFormationsProfilOutilsBibliothech

Ailleurs

GitHub RSS

Newsletter

Les articles, libs et découvertes. Une fois par semaine, pas plus.

© 2026 William LoreeConçu & codé à la main