846c0c7525
Signalé sur /de/appareils/bornes/goecharger/ : la page était allemande sur deux
lignes et anglaise sur tout le reste. Le diagnostic a séparé deux choses que
j'avais mises dans le même sac le 2026-10-12.
LA LIGNE DE PARTAGE, écrite en tête du générateur :
• les LIBELLÉS QUE NOUS ÉCRIVONS (en-têtes de colonnes, titres de section,
oui/non, « Documentation fabricant ») → TRADUITS. Ils ne désignent rien à
l'écran, l'anglais n'y était qu'une friction. REF devient REF_I18N, trois
jeux de 20 libellés.
• le CONTENU VENANT DE NYMEA (noms de modèles, clés de registres, libellés de
champs comme « MAC address », unités) → VERBATIM, en anglais. Ce sont
exactement les chaînes que l'installateur lit DANS L'APP, qui tourne en
en_US. Les traduire rendrait la doc inutilisable pour retrouver un champ à
l'écran.
Et la pièce qui change l'expérience plus que la traduction elle-même : une note
`verbatim`, générée dans la langue de la page, en tête du bloc de référence.
Sans elle le mélange FR/EN passe pour une traduction bâclée ; avec elle c'est
une convention que le lecteur comprend.
L'injection devient sensible à la langue : `locale_of()` déduit la langue du
suffixe du fichier et `process()` rend le bloc en conséquence. Sans ça le même
bloc partait à l'identique dans les trois versions.
TAGLINES ET TITRES — i18n/devices.yaml, 52 entrées
Le tagline vivait en paragraphe libre, écrit UNE SEULE FOIS à la création de la
page : il restait donc en anglais sur les trois versions, y compris la
FRANÇAISE. Il entre dans le bloc badges, donc il est régénéré, donc traduisible
pour toujours. 52 taglines en fr et de ; l'anglais retombe sur l'amont.
Les traductions vivent dans le dépôt de DOC et pas dans les meta.json : trois
des cinq dépôts plugins sont des dépôts nymea amont que l'AGENTS.md interdit de
modifier. Repli sur l'amont pour toute entrée absente.
Deux titres s'affichaient en FRANÇAIS sous /de/ et /en/ — « Compteur ABB B2x »,
« Borne ABB Terra AC » : corrigés, dans la page et dans la nav.
Deux coquilles AMONT corrigées au passage, repérées en relisant les 57 entrées :
meta.json annonçait « Bestel » pour Vestel et « Easeex » pour Easee. Signalées
comme corrections, pas comme traductions, dans i18n/devices.yaml.
48 FICHES FR ÉTAIENT DANS UN ANCIEN FORMAT, ET MENTAIENT
Trouvé en vérifiant : 48 fiches FR n'avaient pas de marqueur `__badges_*__`.
Leurs badges étaient du HTML figé, écrit une fois — goecharger affichait
« NIGHTLY » alors que PORTING_STATUS dit `stable` depuis. Elles sont migrées au
format canonique : badges générés, donc exacts, plus titre localisé, tagline et
intertitre. Reste `hvac/homeconnect.md`, orpheline (plugin hors PORTING_STATUS).
NAV : UN CONSTAT QUI ÉVITE DE REFAIRE L'ESSAI
`literate-nav` ne lit que son `nav_file` : la substitution par suffixe de
mkdocs-static-i18n ne s'y applique PAS. Un `SUMMARY.de.md` généré n'était lu par
personne et la barre latérale allemande gardait les noms français. Testé, puis
retiré — et la raison est écrite dans le générateur pour que personne n'y
revienne. Les libellés de nav passent par `nav_translations` : 31 éléments
traduits par langue au lieu de 29.
RÉFÉRENCE API : LAISSÉE EN ANGLAIS, DÉLIBÉRÉMENT
Les 23 pages de l'API n'ont pas de variante par langue. Leur traduire les
libellés aurait fait voir du FRANÇAIS aux lecteurs /de/ et /en/ par le repli —
une régression. Créer 46 variantes pour traduire dix libellés aurait triplé
28 000 mots de contenu généré pour un gain nul : le reste de la page (noms de
méthodes, de champs, de types, descriptions) est l'API elle-même, et ce sont les
chaînes qu'on écrit dans ses requêtes. À la place, une note explique dans les
trois langues POURQUOI cette référence est en anglais.
Vérifié : build --strict sans avertissement, les deux générateurs rendent « Doc à
jour » en --check, et la fiche goecharger relue dans les trois langues.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
66 lines
2.5 KiB
Markdown
66 lines
2.5 KiB
Markdown
* [Compatibilité](compatibilite.md)
|
|
* [Compteurs](compteurs/index.md)
|
|
* [Eastron SDM](compteurs/eastron.md)
|
|
* [Compteur ABB B2x](compteurs/abb-b2x.md)
|
|
* [powerfox](compteurs/powerfox.md)
|
|
* [B+G E-Tech](compteurs/bgetech.md)
|
|
* [inepro Metering](compteurs/inepro.md)
|
|
* [Schrack](compteurs/schrack.md)
|
|
* [Vestel](compteurs/vestel.md)
|
|
* [Senseair](compteurs/senseair.md)
|
|
* [Bornes de recharge](bornes/index.md)
|
|
* [Borne ABB Terra AC](bornes/abb-terra.md)
|
|
* [Keba](bornes/keba.md)
|
|
* [Easee](bornes/easee.md)
|
|
* [go-eCharger](bornes/goecharger.md)
|
|
* [EVBox](bornes/evbox.md)
|
|
* [EVerest](bornes/everest.md)
|
|
* [Amber Electric](bornes/v2xeamberelectric.md)
|
|
* [Amperfied](bornes/amperfied.md)
|
|
* [MENNEKES](bornes/mennekes.md)
|
|
* [webasto](bornes/webasto.md)
|
|
* [PC Electric](bornes/pcelectric.md)
|
|
* [PhoenixConnect](bornes/phoenixconnect.md)
|
|
* [INRO](bornes/inro.md)
|
|
* [SmartDevices](smart/index.md)
|
|
* [Shelly](smart/shelly.md)
|
|
* [Tasmota](smart/tasmota.md)
|
|
* [Tuya](smart/tuya.md)
|
|
* [GPIO](smart/gpio.md)
|
|
* [USB Relay](smart/usbrelay.md)
|
|
* [USB-RLY82](smart/usbrly82.md)
|
|
* [MQTT client](smart/mqttclient.md)
|
|
* [Modbus Commander](smart/modbuscommander.md)
|
|
* [UniPi](smart/unipi.md)
|
|
* [HVAC](hvac/index.md)
|
|
* [Daikin](hvac/daikinairco.md)
|
|
* [SG-Ready](hvac/sgready.md)
|
|
* [SimpleHeatpump](hvac/simpleheatpump.md)
|
|
* [Tado](hvac/tado.md)
|
|
* [Stiebel Eltron](hvac/stiebeleltron.md)
|
|
* [iDM](hvac/idm.md)
|
|
* [Drexel und Weiss](hvac/drexelundweiss.md)
|
|
* [alpha innotec](hvac/alphainnotec.md)
|
|
* [my-PV](hvac/mypv.md)
|
|
* [Onduleurs / PV](onduleurs/index.md)
|
|
* [Fronius](onduleurs/fronius.md)
|
|
* [Bosswerk](onduleurs/bosswerk.md)
|
|
* [Solar-Log](onduleurs/solarlog.md)
|
|
* [SMA](onduleurs/sma.md)
|
|
* [SolaX Power Inverter](onduleurs/solax.md)
|
|
* [Sungrow Inverter](onduleurs/sungrow.md)
|
|
* [Huawei FusionSolar](onduleurs/huawei.md)
|
|
* [KOSTAL Solar Electric](onduleurs/kostal.md)
|
|
* [mtec](onduleurs/mtec.md)
|
|
* [Wattsonic](onduleurs/wattsonic.md)
|
|
* [SunSpec](onduleurs/sunspec.md)
|
|
* [Tarifs & prévisions](tarifs/index.md)
|
|
* [OpenMeteo](tarifs/openmeteo.md)
|
|
* [aWATTar](tarifs/awattar.md)
|
|
* [Tempo](tarifs/tempo.md)
|
|
* [spot-hinta](tarifs/spothinta.md)
|
|
* [Types génériques](generic/index.md)
|
|
* [genericenergy](generic/genericenergy.md)
|
|
* [genericheatingcooling](generic/genericheatingcooling.md)
|
|
* [genericcar](generic/genericcar.md)
|