Dans l'environnement numérique,
écrire = écrire + structurer.
Nicolas Sauret, Marcello Vitali-Rosati et Servanne Monjour
Café OpenEdition
21 janvier 2020 | Open Edition
===
§§§§§SLIDEmoveDown§§§§§
===
%%%%%%%%%%%%%%%%%%SECTIONmoveRight%%%%%%%%%%%%%%%%%%
Mettre à profit les compétences sémantiques de l'auteur en lui redonnant la maîtrise de la structure et de la sémantique du texte
§§§§§SLIDEmoveDown§§§§§
2 problèmes :
- propriétaire
- manque de sémantique
%%%%%%%%%%%%%%%%%%SECTIONmoveRight%%%%%%%%%%%%%%%%%%
===
Fondamentalement, Stylo est né de cette catastrophe, et de la conviction que, en tant qu'universitaire, il convenait de prendre autant soin des écrits que l'on étudiaient que de la chaine de production de l'écrit.
Stylo est notre expérimentation, notre bricolage local. C'est sans doute aussi un peu notre cheval de Troie dans l'Université, avec l'ambition justement d'institutionnaliser certaines pratiques d'écriture et d'édition déjà émergentes dans la communauté des SHS.
Et ça marche !
§§§§§SLIDEmoveDown§§§§§
- Continuité des données workflow fluide de l'auteur à l'éditeur
- WYSIWYM est affiché ce qui est signifié
- Balisage souple
- Sémantique alignement sur des autorités, balisage inline
- Plusieurs exports HTML5, XML-TEI, XML-ERUDIT, PDF, TEX, ODT, DOCX
- Publications multiples sans perte d'information CMS, Érudit, Indesign, Lodel (?)
- Environnement soutenable chaîne modulable basé sur des outils et des formats standards
§§§§§SLIDEmoveDown§§§§§
=== Ce que montre avant tout cet historique, c'est la modularité de la chaine, principe que l'on reprend des travaux d'Antoine Fauchié, modularité tant les formats utilisés, les outils qui implémentent ces formats, et les logiciels de traitements sont interchangeables.
§§§§§SLIDEmoveDown§§§§§
3 éléments principaux + modules techniques :
- Éditeur de métadonnées
- yaml
- DC, RDFa, Foaf, ScholarlyArticle, Google Scholar, Prism schema
- Vocabulaire contrôlé
- Alignement avec des autorités (Rameau, Wikidata, LOC)
- Via l'API rechercheisidore (Huma-num)
- Éditeur de texte avec balisage interne
- Markdown enrichi
- autres ?
- Gestion bibliographique
- BibTeX
- Api Zotero
- Conversion
- pandoc (vers html, LateX, pdf)
- XSLT (vers TEI-LOD, Erudit)
- Versioning
- git
- comparateur de versions
- Plateforme
- MongoDB (bdd)
- GraphQL (backend)
- ReactJS (frontend)
- API
=== Sans m'y attarder, voici les différents briques logicielles, les différents formats, les différents services qui sont articulés dans Stylo. Au fur et à mesure de la conception, nous avons pu remplacer un outil par un autre, nous avons pu améliorer ou optimiser tel ou tel aspect de la chaîne.
Autant la chaîne que Stylo ou Process sont des outils et des protocoles encore en friche.
Par ailleurs, ce que n'a pas montré cette chronologie, c'est l'enrichissement permanent depuis avril 2017 du modèle de données et de métadonnées des articles.
§§§§§SLIDEmoveDown§§§§§
§§§§§SLIDEmoveDown§§§§§
=== Stylo est à la fois un outil de rédaction de texte scientifique et un outil d'édition de document scientifique. Cet agencement est permis par l'articulation de trois fichiers au coeur de son fonctionnement.
§§§§§SLIDEmoveDown§§§§§
===
- Le corps de texte, au format markdown
- La bibliographie, au format bibtex
- Les métadonnées, au format yaml
§§§§§SLIDEmoveDown§§§§§
=== Je vous montre ici l'interface complète, où l'on retrouve un éditeur de métadonnées, qui vient modifier le fichier yaml associé au document, un gestionnaire de références qui vient modifier le fichier bibtex assoié. Ce gestionnaire est capable de se synchroniser avec une collection zotero en ligne.
On retrouve le corps de texte au centre,
Ainsi que plusieurs modules outillant nos trois sources : ajoutant des fonctionnalités de versionning, la table des matières du corps de texte, des statistiques sur le document et non visible ici un comparateur de version.
§§§§§SLIDEmoveDown§§§§§
=== Le choix du markdown/yaml et du html au détriment peut-être d'un modèle XML au schéma déclaré et stabilisé a été d'abord celui d'une extrême souplesse nécessaire à l'expérimentation. Ce processus d'élaboration d'un modèle éditorial, celui de la formalisation de nos métadonnées et des templates associés a été un processus itératif, souple et peu contraignant.
Cela nous a permis de démarrer très vite la production d'articles, d'identifier des cas de figure particulier, et de réintégrer dans la chaine : de nouvelles données, nouveaux champs et nouvelles balises.
La chaine md+yaml+bib existe depuis plus de 2 ans, 27 mois pendant lesquels les champs du yaml n'ont cessés d'être mis à jour au fur et à mesure des besoins identifiés. Stylo a largement bénéficié de ces itérations pendant sa conception.
Plus récemment, au début de l'année, nous avons procédé à une refonte complète de l'outil, tant sur le backend et la gestion de la base de données, que sur le frontend en redéveloppant entièrement l'application. Nous en avons profité pour génériciser les templates et le modèle de données des articles.
§§§§§SLIDEmoveDown§§§§§
=== Ainsi, la preuve de concept initiale s'est ramifiée au fil des enrichissements que nous intégrons au texte et aux métadonnées :
- utilisation d'autorités (orcid, Rameau) dans les métadonnées
- utilisation de services d'enrichissement (Isidore à la demande) pour qualifier les articles
- [next slide]
§§§§§SLIDEmoveDown§§§§§
===
- sémantisation du corps de texte
- références structurées via l'api de zotero
Ce bricolage constant est important. Les éditeurs de la revue peuvent en témoigner, ils sont eux-mêmes obligés de se salir les mains. Mais ces mains pleines de cambouis, de balises, de commandes bash, de branches fusionnées, sont les témoins de leur capacitation, d'une nouvelle maîtrise qui va bien au-delà de l'édition d'un document.
%%%%%%%%%%%%%%%%%%SECTIONmoveRight%%%%%%%%%%%%%%%%%%
- Usage par plusieurs revues Sens Public, Études françaises, Nouvelles vues, Romantism on the Net, Itinéraires
- Intégration complète avec Érudit
- Intégration dans les services Huma-Num isidore.science et Nakala
%%%%%%%%%%%%%%%%%%SECTIONmoveRight%%%%%%%%%%%%%%%%%%
contribuer : github.com/EcrituresNumeriques/stylo/
écrire : stylo.ecrituresnumeriques.ca
premiers pas : stylo-doc.ecrituresnumerique.ca
tuto : youtu.be/qcwEqbcxBF8