Super nouvelle !
Première chose : l'environnement de développement. Effectivement, sous Windows c'est plus pratique (téléchargez un Yadoms pour Windows). Préférez
VSCode comme éditeur. Il en existe d'autres, mais celui-ci est gratuit et plutôt bien fait et pratique.
Ensuite, le navigateur Chrome dispose d'outils pratiques (appuyez sur F12 depuis votre page pour les afficher).
Pour debugger votre code, il vous suffira d'ajouter le mot clé Javascript
et l'exécution s'arrêtera à ce point. Vous pourrez ainsi visualiser vos variables, exécuter votre code en pas-à-pas, etc...
D'un point de vue documentation de Yadoms, le mieux est de vous concentrer dans un premier temps sur le développement de widget (le lien que je vous ai donné), car il y a effectivement beaucoup de documentation, mais elle peut concerner le développement de Yadoms, de plugins, des problématiques de compilation, d'utilisation, etc...
Concernant le widget d'exemple, le chart est le widget qu'il faut absolument éviter pour démarrer : c'est le plus complexe de tous.
Je pense qu'il faut démarrer simplement, par un widget capable d'afficher (sous forme texte) la température et l'humidité (les 2 seules données variables si j'ai bien compris votre besoin). Il vous faudra établir la configuration du widget (fichier package.json) afin que l'utilisateur puisse sélectionner les données à afficher.
Ensuite vous pourrez afficher votre diagramme et placer votre point dessus.
Pour démarrer concrètement, dupliquez un widget (dev-empty-widget est fait pour ça, ou sinon numeric-display).
A ce propos, les widgets commençant par 'dev-' n'apparaissent pas dans Yadoms (car ils n'ont pas d'utilité fonctionnelle), et il y en a 2 dans les sources :
- dev-empty-widget : Widget contenant le minimum de code, destiné à être dupliqué pour démarrer un nouveau développement de widget
- dev-fake-widget : Widget concernant pas mal de code à des fins d'exemple (par contre, je ne suis pas sûr qu'il soit bien à jour...)
A partir de votre installation de Yadoms pour Windows, si vous n'avez pas de capteur physique capable de vous générer des données, vous pouvez utiliser le fake-plugin (n'apparait qu'en mode développeur, à activer dans yadoms.ini). Ce plugin qui est en fait destiné à montrer toutes les possibilités d'un plugin pour aider au développement de plugin, génère des données (température, niveau de batterie, etc...) toutes les 10 secondes.
Pour partager vore travail ensuite, il faudra :
- A partir du site Github, créer un fork de Yadoms dans votre compte Github
- Cloner les sources de Yadoms (depuis votre compte Github) sur votre PC
- Créer une branche à vous (nommée par exemple "psychometricDiagramWidget")
- Intégrer votre développement dans ces sources
- Pousser votre branche sous Github
- A partir du site Github, créer une pull-request (je devrai normalement être notifié, mais n'hésitez pas à me contacter directement)
J'espère que ces quelques renseignements vous permettront de démarrer, n'hésitez pas à demander à la moindre question.
Sébastien