Move to new doc system

[zoic21]

🚀 Refonte du système de documentation

Cette PR introduit une refonte complète du système de documentation afin de simplifier la maintenance, améliorer la cohérence et réduire la complexité globale.

🔧 Changements principaux

Migration vers GitHub Pages par dépôt
La documentation est désormais directement hébergée via GitHub Pages sur chaque dépôt, au lieu d’utiliser un dépôt centralisé.
→ Cela permet une gestion indépendante, plus simple et plus cohérente avec le cycle de vie des projets.
Suppression du système de traduction interne
Les traductions ne sont plus gérées dans le dépôt.
→ On s’appuie désormais sur les fonctionnalités natives de traduction des navigateurs, ce qui supprime une source importante de complexité et de maintenance.
Mise en place d’un template unifié
Un template commun est introduit pour l’ensemble des documentations.
→ Il permet :

• une structure homogène entre les projets
• la génération automatique du menu
• une meilleure maintenabilité globale

🎯 Objectifs

Réduire la dette technique liée à la documentation
Simplifier les contributions
Uniformiser l’expérience utilisateur
Supprimer les dépendances inutiles (traduction, repo central)

🔍 Démonstration

Un exemple du rendu final est disponible ici :
👉 https://jeedom.github.io/core/

[Mips2648]

Salut,
J'essaie de tester pour avoir la doc en anglais par exemple, comment on fait?
je suis sur un navigateur qui déclare en_us comme langue voulue mais la page s'affiche toujours en Fr, je ne comprend pas comment c'est sensé fonctionner

ca veut dire quoi:

→ On s’appuie désormais sur les fonctionnalités natives de traduction des navigateurs

[Salvialf]

Je n'arrive pas à tester, il y a des choses spéciales à mettre en place pour avoir le texte traduit ? J'ai beau changer la langue du navigateur c'est toujours en français mais avec des soucis de syntaxe (des espaces qui apparaissent dans les liens URL notamment).

Autre question, quid de la documentation actuelle ? La présente PR est à part sous un format différent pour tester ou il va falloir revoir jeedom/documentations en intégralité ?

[zoic21]

Normalement ton navigateur te propose la traduction mais il ne faut pas avoir desactiver la traduction pour la langue source (fr ici). Si tu as fait comme moi il ne traduit pas le fr et le en automatiquement.

[Mips2648]

An automatic translation mechanism via the browser will bring many issues like these:

How is it plan to fix that?

[pifou25]

Pourquoi avoir laissé la doc dans ce repo, plutôt que la regrouper dans jeedom/documentation ?

Et aussi, pourquoi avoir finalement supprimé la gestion des traductions, alors que la PR du mois dernier #3251 avait à priori corrigé les problèmes (quels problèmes?)

[Salvialf]

Salut @pifou25,

Pourquoi avoir laissé la doc dans ce repo, plutôt que la regrouper dans jeedom/documentation ?

La documentation du core reste dans le core car elle évolue en même temps que lui. La garder ici permet d’éviter les décalages entre une version du core et sa doc.

---

alors que la PR du mois dernier #3251 avait à priori corrigé les problèmes

La PR #3251 concernait la traduction de l'interface du core.
La présente PR #3252 traite, elle, de la documentation et de sa traduction.
Les deux sujets sont indépendants.

[pifou25]

ok merci, ce n'était pas très clair pour moi qu'est-ce qui remplace quoi :)
Donc en gros le repo jeedom/documentations concerne plutôt les plugins de Jeedom et continuera d'exister ici https://doc.jeedom.com/fr_FR/ (ou il sera migré aussi sur son propre github page ?)
Mais la doc du core (qui était dans la doc la partie "manuel d'utilisation" + "manuel de configuration", c'était dans documentations/fr_FR/core) est déplacée ici https://jeedom.github.io/core/