Améliorations


Contexte

Ce Wiki constitue une bonne base de travail et permettra aux générations futurs de se lancer directement dans le cœur du projet. En effet, étant donné l'environnement nouveau dans lequel nous devions travailler, beaucoup de temps a été consacré à la compréhension de MathJax et de Jupyter. Il a fallu également effectuer un travail conséquent pour savoir de quelle manière "étendre" Jupyter en y intégrant nos propres fonctions écrites en JavaScript/JQuery. De ce fait, l'objectif réelle du projet n'a pas été atteint mais le travail réalisé nous a permis de produire une documentation qui permettra de guider et orienter les futurs acteurs de ce projet.

Quelques pistes

------- Jupyter --------

Le plus gros travail sur Jupyter a été fait : pouvoir intégrer nos propres fonctions et faire ce que l'on voulait. Bien que créer des boutons n'était pas l'objectif réel du projet, cela permet quand même de montrer la capacité des extensions. Les extensions nous permettent d'effectuer n'importe quelles opérations qui dépendent de SageMath (exécuter des méthodes propres à Sage), de Jupyter (réutiliser les fonctions écrites dans Jupyter) et même de MathJax (récupérer les jax par exemple et pouvoir agir dessus). On remarque donc que la plus grosse partie a été faite concernant Jupyter et que la partie vraiment manquante dépend de MathJax. La page suivante vous définira de nombreuses fonctions qui vous permettront d’interagir avec Jupyter fonctions_utile

------- MathJax --------

Si vous êtes amenés à continuer le projet, vous devez vous concentrer sur MathJax. Oubliez Jupyter ! Le travail a été fait en amont par notre groupe et vous savez maintenant comment intégrer votre code sur Jupyter. Essayer de comprendre la logique autour de MathJax, comment sont reconnus les formules, comment sont-elles interprétées, comment sont faites les conversions de l'input a l'output. L'exemple n°1 de la page mathjax peut vous donner des pistes.

------- MathJax + Jupyter --------

Le but du projet était de pouvoir agir sur les sorties des équations écrites dans Jupyter et qui serait afficher en LaTex. Il nous fallait extraire de ces "outputs" des informations telles que les variables ou encore les opérandes afin d'agir sur ceux-ci. La manière d'effectuer ce type d'opération reste encore floue. Cependant, si vous vous référencez à la page MathJax du wiki, vous disposez de plusieurs exemple vous montrons la façon d'agir sur les formules, une à une ou toutes à la fois. Ainsi, en se documentant bien sur MathJax qui fournit une documentation conséquente, il sera possible d'extraire, soit via la formule entrée ou via l'arbre MathML, l'équation.

Il sera également essentiel de comprendre le processus de conversion d'une formule écrite "basiquement" dans l'input de Jupyter et comprendre comment elle est interprété par MathJax.

------- Les erreurs à ne pas faire --------

N'hésitez SURTOUT PAS à rentrer en contact avec les anciens membres du projet si vous avez la moindre question. Étant les précurseurs du projet, nous avons perdus beaucoup de temps à tester des choses sans réellement savoir si elles allaient aboutir à un résultat satisfaisant. Nous avions testés les Widgets pour Jupyter et nous avons même pensé à modifier directement le code source de Jupyter. Mais nous avons trouvé une bien meilleure alternative. Soyez organisé, partagez vous les taches. Suivez vos Sprint et discutez avec votre encadrant pour qu'il puisse vous diriger vers des solutions.