Skip to content

fix(inovmicro-exao): Ajout des photos manquantes#175

Open
MatteoCnda1 wants to merge 3 commits into
mainfrom
fix/inovmicro-i09-photos-manquantes
Open

fix(inovmicro-exao): Ajout des photos manquantes#175
MatteoCnda1 wants to merge 3 commits into
mainfrom
fix/inovmicro-i09-photos-manquantes

Conversation

@MatteoCnda1
Copy link
Copy Markdown
Collaborator

Résumé

  • Ajoute deux photos réelles de la STeaMi en situation dans la fiche i09-inclinaison-accelerometre : une photo du programme principal (orientation + valeurs X/Y/Z sur l'écran OLED) et une photo de l'amélioration niveau à bulle (barre de progression inclinaison)
  • Corrige les figcaption qui contenaient un texte générique erroné ("température et commentaire de confort") remplacé par des descriptions fidèles au contenu de chaque photo
  • Corrige le commentaire inline de ecran._d.text() qui indiquait des coordonnées incorrectes

Type de changement

  • Contenu — fiche, doc, texte
  • Catalogue — entrée(s) dans resources.ts ou projects.ts
  • Code — composant React, page, type, CSS
  • Configuration — config Docusaurus, CI, hooks
  • Assets — images, PDFs, vidéos

Test plan

  • npm run build (dans site/) passe sans erreur ni nouveau warning
  • npm run typecheck passe
  • Vérification visuelle locale dans le navigateur (rendu des deux <figure>, affichage des photos, lisibilité des figcaption)
  • Lint OK : npm run format:check && npm run lint:md
  • (Si fiche) Conforme aux conventions de CLAUDE.md
  • (Si lien externe ajouté) Vérification manuelle qu'il fonctionne

Issues liées

Closes #162
Refs #137 (PR d'origine de la fiche i09)

@github-actions
Copy link
Copy Markdown
Contributor

Images automagically compressed by Calibre's image-actions

Compression reduced images by 23.5%, saving 153.8 KB.

Filename Before After Improvement Visual comparison
site/static/img/ressources/inovmicro-exao/i09-inclinaison-accelerometre/Steami_prog1.jpeg 349.9 KB 268.9 KB 23.1% View diff
site/static/img/ressources/inovmicro-exao/i09-inclinaison-accelerometre/Steami_amelioration3.jpeg 303.2 KB 230.3 KB 24.0% View diff

- Alt text des deux <figure> ne mentionnait plus le sujet de la fiche
  (« Thermomètre très lisible sur la STeaMi », copié-collé d'une autre
  fiche). Remplacement par une description fidèle de chaque photo.
- Figcaption « via l'accelerometre » → « via l'accéléromètre »
  (texte affiché, donc accents requis).

Refs #162
Copy link
Copy Markdown
Member

@nedseb nedseb left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Merci pour les photos Mattéo, elles sont nettes et illustrent bien le résultat sur la carte. Quelques points à revoir avant merge ; je viens de pousser un commit (65192dc) qui adresse les deux plus évidents (alt text + accent figcaption), il reste les sujets pédagogiques ci-dessous :

Bloquant : régression d'API dans afficher_capteur

Le code passe de :

ecran.title(orientation)
ecran.text("X:...g", at="NW")
ecran.text("Y:...g", at="W")
ecran.text("Z:...g", at="SW")

à :

ecran._d.text(orientation, 25, 30, 15)   # x=10, y=10, couleur=blanc fixe
ecran.value("{:+.2f}".format(acceleration_x), label="X", unit="g")
ecran.subtitle(
    \"Y:{:+.2f}g\".format(acceleration_y),
    \"Z:{:+.2f}g\".format(acceleration_z),
)

Trois soucis cumulés ici :

  1. ecran._d.text() est un accès direct au driver bas niveau (le préfixe _d signe une API privée). Le projet construit le wiki autour de l'API haut niveau steami_screen : les autres fiches qui ont une mise en page similaire (i15, i11, i10) restent dans cette API, et l'encart « API bas niveau » d'i10 oriente vers screen.pixel()/line()/rect()/circle() quand on a besoin de coordonnées exactes — pas vers _d.text. Si l'objectif est juste de rendre le titre en blanc plutôt qu'en GRAY, le canal idiomatique serait plutôt ecran.text(orientation, at=\"N\", color=WHITE) (cf. couleurs documentées dans i10).
  2. Le commentaire ment : il annonce x=10, y=10, couleur=blanc fixe alors que les arguments réels sont 25, 30, 15. Soit on le supprime, soit on aligne les valeurs.
  3. Coordonnées magiques (25, 30, 15) sans nommage — contraire à l'esprit « identifiants/constantes parlants » des conventions MicroPython STeaMi.

Le ecran.subtitle(\"Y:...\", \"Z:...\") en deux arguments est OK, c'est le même pattern que i15.

Description PR à corriger

Corrige le commentaire inline de ecran._d.text() qui indiquait des coordonnées incorrectes

Sur main, ecran._d.text() n'existe pas du tout : cette PR introduit le code (avec son commentaire faux). La description gagnerait à dire « refonte de l'affichage de afficher_capteur pour utiliser value()/subtitle() comme i15 » plutôt que « correction d'un commentaire ».

Cases du template sur-cochées

Les cases « Catalogue » et « Code (composant React, page, type, CSS) » sont cochées dans la PR mais seuls la fiche markdown et les deux JPEG sont touchés. À décocher pour la lisibilité.

Mineur : nommage des fichiers

Steami_prog1.jpeg / Steami_amelioration3.jpeg mélangent CamelCase et snake_case. Le wiki utilise soit un préfixe numéroté kebab-case (i10 : 01-steami-oled-vide.jpeg...), soit un nom descriptif simple en snake_case (i15 : steami_graph.jpeg). Idéalement à renommer en 01-prog-principal.jpeg / 02-amelioration-niveau-a-bulle.jpeg (ou équivalent kebab-case) pour rester homogène avec i10 qui a aussi plusieurs photos. Cosmétique, mais autant le faire maintenant.

Périmètre de la PR

Le titre annonce « Ajout des photos manquantes » mais la PR refait aussi l'affichage du programme principal — typiquement deux PRs distinctes. Pas bloquant vu la taille, juste à garder en tête pour la prochaine fois.


Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Cette PR complète la fiche I‑NOVMICRO EXAO i09-inclinaison-accelerometre en ajoutant des visuels réels de la carte STeaMi en fonctionnement, afin de corriger le manque de photos “en situation” signalé dans #162.

Changes:

  • Ajout de deux <figure> (photo du programme principal + photo de l’amélioration “niveau à bulle”) dans la fiche i09.
  • Mise à jour du code d’affichage OLED présenté dans la fiche (orientation + valeurs).
  • Correction/alignement des légendes (figcaption) pour décrire fidèlement le contenu des photos.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

ecran.text("X:{:+.2f}g".format(acceleration_x), at="NW")
ecran.text("Y:{:+.2f}g".format(acceleration_y), at="W")
ecran.text("Z:{:+.2f}g".format(acceleration_z), at="SW")
ecran._d.text(orientation, 25, 30, 15) # x=10, y=10, couleur=blanc fixe
@nedseb
Copy link
Copy Markdown
Member

nedseb commented May 27, 2026

rtMattéo, petit point de coordination sur cette PR :

État actuel

Depuis l'ouverture, 9 PRs ont mergé sur main (#172, #174, #176, #177, #181, #183, #185, #186, #188, #190). Si on mergeait cette PR telle quelle, on supprimerait t04-vscode.md, t06-bases-micropython.md, les modifs de callouts de #185, le tri progressif de #183, les tableaux d'en-tête de #190, les 3 photos i14 de #177, etc. La PR est techniquement « MERGEABLE » côté git mais sémantiquement destructrice (le contenu retiré n'a pas de conflit textuel avec ce que cette PR ajoute).

Il faut donc :

  1. Rebaser la branche fix/inovmicro-i09-photos-manquantes sur main à jour.
  2. Vérifier que le diff final n'affecte que i09-inclinaison-accelerometre.md et les deux JPEG Steami_prog1.jpeg / Steami_amelioration3.jpeg.

Tu peux faire :

git fetch origin main
git rebase origin/main
# Résoudre les conflits éventuels, ne garder que les ajouts photos + ton commit d'origine
git push --force-with-lease

Point bloquant de ma revue (toujours non adressé)

Ma changes-requested du 27 mai pointait surtout la régression d'API dans afficher_capteur :

ecran._d.text(orientation, 25, 30, 15)   # API privée + commentaire qui ne correspond pas aux arguments

Idéalement, remplacer par l'API publique ecran.text(orientation, at="N", color=WHITE) (cf. fiche i10-texte-oled qui documente color=). Si tu changes l'API, la mise en page du titre va légèrement bouger (centré vs position manuelle) ; il faudra peut-être refaire une photo Steami_prog1.jpeg pour qu'elle corresponde.

En attendant

On laisse cette PR de côté pour l'instant. Quand tu auras rebasé + ajusté le code, fais signe et on la merge rapidement.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

Photos manquantes pour la fiche i09-inclinaison-accelerometre

4 participants