Skip to content

README : logo, badges GitHub et CTA de téléchargement - #29

Merged
SKOHscripts merged 1 commit into
mainfrom
docs/readme-header-badges
Jul 23, 2026
Merged

README : logo, badges GitHub et CTA de téléchargement#29
SKOHscripts merged 1 commit into
mainfrom
docs/readme-header-badges

Conversation

@SKOHscripts

Copy link
Copy Markdown
Owner

Summary

  • Ajoute le logo Kairos (static/icon-512.png) en haut du README, flotté à droite du titre.
  • Ajoute des badges GitHub : statut CI, dernière release, compteur de téléchargements, licence, plus trois badges de plateforme (Windows/Linux/Android).
  • Ajoute un lien direct vers la dernière release en tête de page.
  • Objectif : qu'un visiteur du dépôt comprenne immédiatement que Kairos est une application desktop (Windows/Linux) et mobile (Android) prête à télécharger.

Point technique important : le logo est placé via <img align="right"> (une balise inline simple) plutôt qu'un <table> HTML. Un conteneur de type bloc (<table>, <div>) aurait empêché le Markdown à l'intérieur (badges, gras, liens) d'être interprété — vérifié explicitement, ce README est rendu par deux moteurs différents : GitHub d'un côté, et le pipeline Python-Markdown de la page d'accueil de l'application elle-même de l'autre (app/main.py::_render_readme). Une première version avec <table> cassait silencieusement le rendu du # Kairos en H1 côté app (donc le sommaire de la page d'accueil), sans qu'aucun test existant ne le détecte a priori — repéré en testant directement le pipeline de rendu avant de committer.

Test plan

  • pytest (suite complète, 434 tests) — vert, y compris les tests de la page d'accueil qui dépendent du parsing du README (test_get_home_renders_readme_content, test_get_home_toc_links_to_readme_sections, test_get_home_toc_sits_right_after_en_bref)
  • Rendu vérifié directement via le pipeline markdown de l'app (H1 correctement reconnu, toc_tokens corrects, badges/liens/gras rendus comme du HTML, pas de markdown brut qui fuit)
  • Vérification visuelle (Playwright, page d'accueil) : logo + badges s'intègrent proprement dans le flux, aucune régression de mise en page (les badges shields.io apparaissent en icônes cassées dans le sandbox de développement faute d'accès réseau — normal, rendu correct attendu avec une connexion réelle)

🤖 Generated with Claude Code


Generated by Claude Code

Objectif : qu'un visiteur du dépôt comprenne en un coup d'œil que Kairos
est une application desktop (Windows/Linux) et mobile (Android) prête à
télécharger, pas juste un projet Python à cloner. Logo flotté à droite du
titre (attribut align, pas de tableau HTML) : un conteneur bloc aurait
empêché le rendu Markdown des badges à l'intérieur, aussi bien sur GitHub
que dans le pipeline Python-Markdown utilisé par la page d'accueil de
l'app elle-même (même README.md, deux moteurs de rendu différents) —
vérifié explicitement avant ce commit, avec un test dédié qui aurait
autrement échoué silencieusement.

Badges : statut CI, dernière release, compteur de téléchargements,
licence, plus trois badges de plateforme (Windows/Linux/Android) pour la
lisibilité immédiate. Lien direct vers la dernière release en haut de
page.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012rz3jgonqVHP4fzQsJh8oP
@SKOHscripts
SKOHscripts marked this pull request as ready for review July 23, 2026 07:59
@SKOHscripts
SKOHscripts merged commit f186739 into main Jul 23, 2026
1 check passed
@SKOHscripts
SKOHscripts deleted the docs/readme-header-badges branch July 23, 2026 07:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants