Zest Writer 2.0 est disponible

Zest Writer est un logiciel multiplateforme, ce qui signifie que vous pouvez l’avoir aussi sur votre système d’exploitation préféré.

Pour l’installer, il vous suffit de suivre les instructions ci-dessous.

Windows

Téléchargez le fichier d’installation et lancez-le : Lien de téléchargement

OsX

Téléchargez le fichier d’installation et lancez-le : Lien de téléchargement

Linux

Debian, Ubuntu, Mint, etc.

Dans un terminal :

# importez la clé GPG de bintray
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 379CE192D401AB61

# ajoutez une nouvelle source
echo "deb https://dl.bintray.com/zest-writer/deb wheezy main" | sudo tee -a /etc/apt/sources.list.d/zestwriter.list

# mettez à jour vos dépôts
sudo apt-get update

# installez Zest Writer
sudo apt-get install zestwriter

Fedora, CentOs, etc.

1. Créez le fichier /etc/yum.repos.d/zestwriter.repo et copiez le contenu suivant à l’intérieur :

[zestwriter]
name=zestwriter
baseurl=http://dl.bintray.com/zest-writer/rpm
gpgcheck=0
enabled=1

2. Installez Zest Writer en saisissant dans votre terminal yum install zestwriter.

Cette version est une grosse refonte de l’application, et même si elle apporte pas mal de correctifs, certaines fonctionnalités ont été retranchées (la plupart reviendront probablement dans les prochaines versions).

Les nouvelles fonctionnalités

• L’intégration du nouveau moteur zmarkdown : la précédente version fonctionnait encore avec l’ancien moteur markdown de ZdS écrit en Python, un boulot colossal a été fait pour utiliser le nouveau moteur écrit en JavaScript.
• Zest Writer supporte désormais la nouvelle version du format d’import/export de ZdS (version 2.1 du manifest.json) avec notamment la gestion de la publication partielle.

Les bugs corrigés

• #318 : La zone d’édition qui avait tendance à disparaître lors de l’externalisation du rendu est désormais fonctionnelle.
• #120 : Les caractères accentués que l’on ne pouvait pas taper dans la zone de rédaction (ce qui rendait l’écriture laborieuse) sont désormais fonctionnels.

Les fonctionnalités retranchées

Ces fonctionnalités ont été retranchées temporairement le temps de la livraison d’une première version fonctionnelle. Nous espérons qu’elles reviendront rapidement par la suite.

• La disparition du module de correction orthographique/grammatical
• La disparition de l’export PDF (on garde cependant l’export au format markdown)
• La zone de rédaction n’affiche plus de numéro de ligne pour se repérer
• La fonction de recherche/remplacer dans la zone de rédaction ne permet plus d’afficher les sélections multiples

Voilà un état des lieux du point de vue utilisateur, de ce qui change pour vous.

On ne se lance pas dans une refonte aussi énorme sans que celle-ci ne soit justifiée. La refonte de Zest Writer a été motivée par deux choses :

1. Intégrer le nouveau moteur zMarkdown de Zeste de Savoir
2. Permettre enfin de pouvoir saisir certains caractères accentués (ê, ï, etc.)

Ces deux objectifs ont entraîné tout un tas de changement au sein de l’application.

De Python-Zmarkdown à zMarkdown (JS)

Python-Zmarkdown est l’ancien moteur utilisé par Zeste de Savoir qui permet de convertir un texte en markdown vers du html. Ce dernier souffrait de pas mal de bugs, et commençait à être difficilement maintenable. L’équipe technique du site à donc décidé de crée un nouveau moteur, cette fois-ci le moteur est écrit en JavaScript.

Zest Writer, étant un éditeur hors ligne, il faut savoir qu’avant il embarquait un interpréteur python pour pouvoir traiter le markdown de la même façon que le site sans avoir besoin de se connecter au site (sinon on ne pourrait plus parler d’éditeur hors ligne).

Le défi imposé par le passage au nouveau moteur zMarkdown à Zest Writer était d’arriver à intégrer un interpréteur/moteur JavaScript au sein de Zest Writer qui permette à ce dernier de continuer à parser le markdown de la même façon que le site, tout en restant un éditeur hors ligne.

Après de nombreuses recherches et tests, mon choix s’est porté sur GraalVM. Il s’agit d’une machine virtuelle universelle pour exécuter des applications écrites en JavaScript, Python, Ruby, R, les langages de JVM comme Java, Scala, Kotlin, et les langages LLVM comme C et C++.

Plusieurs choses m’ont séduite avec GraalVM :

• La machine virtuelle est pilotable en Java (le langage dans lequel est écrit Zest Writer);
• Le support de la norme ECMA Script 2020 et le fait que sa dernière version se base sur Node.js v12, qui est un gage de modernité et me permet d’être serein quant au futures folies évolutions de zmarkdown;
• Le coté polyglotte de GraalVM me permet d’entrevoir un module de correction basé sur Grammalecte (qui est écrit en python);
• Le fait que ça "juste marche" et reste vraiment multiplate-forme.

Voilà dans l’ensemble comment on arrive, avec les bon outils à passer sur le nouveau moteur de zMarkdown dans sa version 8.3.0.

De RichTextFX au Textarea

RichTextFX est une bibliothèque écrite en Java qui permet en gros d’offrir une zone de texte enrichie dans son application. Elle se base sur JavaFX (la bibliothèque d’interface graphique pour Java). Jusqu’ici, Zest Writer utilisait cette bibliothèque pour offrir des choses sympa comme l’affichage des numéros de lignes dans la zone de rédaction, ou encore la sélection multiple.

Vu comme ça on pourrait penser que cette bibliothèque est idéale, mais non. Elle avait un gros défaut (qui est resté non corrigé depuis maintenant quatre ans) : il était impossible de taper des caractères circonflexes ou tréma. Après avoir attendu (en espérant que le problème se corrige), j’ai fini par baisser les bras et revenir à une zone de texte simple mais fonctionnelle.

De Java 8 à Java 11

C’est peut-être cette migration qui m’a le plus coûté. La raison est simple, depuis Java 9, le projet Jigsaw qui permet de rendre une application Java modulaire a changé beaucoup de choses dans la gestion des dépendances.

Il y a trois ans, la grosse majorité des dépendances de Zest Writer n’était pas compatible avec Java > 8, il a donc fallu attendre que ce soit le cas (à la bonne discrétion des mainteneurs donc). Jusqu’à aujourd’hui il y a certaines dépendances qui n’ont pas encore passé le cap (oui langagetools je parle bien de toi). À un moment il a fallu acter le divorce et passer à autre chose.

Si la nouvelle version à mise autant de temps à arriver (en dehors de ma motivation variable), c’est en partie à cause de cette migration.

Cette migration a permis de faire le tri dans les dépendances qui sont devenues inutiles comme toutes les bibliothèques d’apache client http et okhttp. Maintenant que dans le JDK 11 on a ce qu’il faut comme client http, il y a beaucoup de dépendances qui n’étaient plus justifiables.

De JavaFX 8 à JavaFX 13

JavaFX est la bibliothèque moderne recommandée pour faire des interfaces pour des applications Java. Zest Writer l’utilise toujours, car elle continue de répondre au besoin.

Pour être compatible Java 11, il fallait migrer de version de Java FX, et (c’est la que ça se corse) changer de plugin de déploiement de l’application.

Zest Writer utilise gradle pour construire ses binaires pour toutes les plateformes. Pour les applications JavaFX, il existe des plugins qui permettent de packager chacun des binaires (deb, rpm, dmg, msi). Le plugin utilisé pour Java FX 8 n’étant plus compatible, il a fallu changer de plugin de revoir complètement la phase de packaging. C’est ainsi que nous avons découvert l’excellent Badass JLink Plugin qui fait le café et dont les développeurs sont très réactifs.