Dans le cadre d’une série d’articles consacrés au format markdown et à la question de la maîtrise de nos données, je vous présente aujourd’hui Stackedit.io. en prolongement de mon article consacré à The Programming Historian.

The Programming Historian propose aux personnes de se familiariser avec la rédaction en utilisant la syntaxe markdown avec Stackedit.io.

Stackedit.io vous offre la possibilité de rédiger des documents en utilisant le Markdown à l’aide de votre navigateur que vous soyez connecté ou non (les fichiers sont sauvegardés sur votre ordinateur). C’est plutôt malin.

Votre fenêtre de travail est scindée en deux. A gauche, vous rédigez votre texte et le mettez en forme au format markdown avec la barre de mise en forme (comme dans votre traitement de texte). A droite, vous visualisez le texte mis en forme. Vous pouvez également passer d’un mode à l’autre.

Les jetons d’accès émis par Google, Dropbox, GitHub… sont stockés dans votre navigateur et ne sont pas envoyés à un quelconque backend ou à une tierce partie, de sorte que personne n’a accès à vos données.

SackEdit vous permet aussi d’organiser vos fichiers au sein de dossiers. Il devient ainsi l’équivalent d’un bloc-notes personnalisé.

Vous pouvez gérer plusieurs espaces de travail et les synchoniser. Par exemple, l’un pourra être sur Google Drive et l’autre sur Github. En utilisant Github, vous pouvez ainsi synchroniser vos fichiers entre différents ordinateurs et vous disposez également d’une sauvegarde.

Mais le partage d’espace, grâce au mécanisme de synchronisation, permet un travail collaboratif. Si deux collaborateurs travaillent en même temps sur le même fichier, StackEdit se charge de fusionner les modifications. En plus, vous pouvez publier/sauvegarder vos fichiers sur Github, Google Drive ou Dropbox notamment.

En plus, il est églement possible de lier Stackedit.io avec votre compte WordPress ou Blogger et de rédiger vos billets de blogs en mardown avant de les publier sur votre blog.

Enfin, en mode sponsor (en clair un abonnement à StackEdit.io à durée variable), vous pouvez exporter votre travail au format .pdf ou .docx grâce à un moteur Pandoc.

Autrement, on retrouve les fonctionnalités de base de tout éditeur Markdown. StackEdit.io est une bonne entrée en matière pour se familiariser avec la rédaction de textes ou documents en utilisant la syntaxe Markdown.

Lien : Stackedit.io

Le format markdown présente l’avantage d’être un langage à la syntaxe relativement simple et léger. Il permet aussi de s’affranchir, au moment de la rédaction, de la question du format de fichier. En effet, au moment de la publication vous pourrez enregistrer le texte et les images dans un certain nombre de format courant (.docx, .pdf, .html, .epub a titre d’exemple). Ce n’est pas un format de texte propriétaire et il est plus puissant que le format .txt.

Dans le cadre d’une série d’articles consacrés au format markdown et à la question de la maîtrise de nos données, je vous présente aujourd’hui The Programming Historian et leurs leçons qui pourront vous être utiles dans le cadre de votre « encapacitation » (empowerment).

Présentation

The Programming Historian est un collectif d’universitaire qui publie des tutoriels évalués par des pairs permettant l’initiation à et l’apprentissage d’un large éventail d’outils numériques, de techniques et de flux de travail pour faciliter la recherche et l’enseignement en sciences humaines et sociales.

Les tutoriels et leçons sont publiés en trois langues : anglais, espagnol et français. Concernant les équipes éditoriales, la page suivante présente leurs membres : https://programminghistorian.org/fr/equipe-projet.html.

Leçon 1 : Préserver ses données de recherche

Avant d’en venir aux leçons sur le Markdown, il paraît utile de commencer par la leçon relative à la préservation de ses données de recherche. Cette leçon donne des pistes aux historiens et aux historiennes pour documenter, structurer et pérenniser leurs données de recherche.

Cette leçon est l’oeuvre de James Baker, maître de conférences en histoire et archives numériques à l’Université du Sussex et au Sussex Humanities Lab.

S’appuyant sur les leçons et l’expertise de professionnels en données de la recherche, cette leçon suggère aux historiennes et aux historiens des moyens de documenter et de structurer leurs propres données de manière à ce qu’elles restent utilisables dans le futur. Il ne se veut pas normatif mais suppose que les lecteurs et lectrices itéreront, changeront et adapteront les idées présentées pour correspondre au mieux à leurs recherches.

James Baker cite, notamment à l’appui de ces propos, William Stafford Noble :

Le principe de base est simple: quelqu’un non familiarisé avec votre projet devrait être capable de consulter vos fichiers informatiques et de comprendre en détails ce que vous avez fait et pourquoi […] Cependant, le plus souvent ce « quelqu’un » c’est vous. Dans quelques mois, vous ne vous souviendrez peut-être plus de ce que vous faisiez lorsque vous avez créé un ensemble particulier de fichiers, ou des conclusions que vous avez tirées. Vous devrez alors passer du temps à reconstruire vos expériences précédentes ou perdre toutes les connaissances que vous aviez acquises de ces expériences.
William Stafford Noble (2009) A Quick Guide to Organizing Computational Biology Projects. PLoSComputBiol 5(7): e1000424. doi:10.1371/journal.pcbi.1000424

Après en avoir poser le cadre et la nécessité, la leçontraite des points suivants :
1. Formats des fichiers.
2. Structuration des données de la recherche.

Pour poursuivre : James Baker, «Préserver ses données de recherche,» traduction par Anne-Sophie Bessero-Lagarde, The Programming Historian en français 2 (2020), https://doi.org/10.46430/phfr0009.

Leçon 2 : Débuter avec Markdown

Dans cette deuxième leçon, Sarah Simpkin, bibliothécaire spécialisée en SIG, géographie et informatique à l’Université d’Ottawa, nous propose une introduction à Markdown, une syntaxe en texte brut pour le formatage de documents. Vous découvrirez pourquoi l’utiliser, comment formater des fichiers Markdown et comment prévisualiser de tels fichiers sur le web.
Développé en 2004 par John Gruber, Markdown est à la fois un langage de balisage de fichiers textes et une fonctionnalité du langage Perl permettant de convertir des fichiers Markdown en HTML.
Les fichiers texte brut présentent plusieurs avantages comparés aux autres formats. Non seulement ils sont compatibles avec tout type d’appareil et de système d’exploitation, mais ils s’avèrent aussi plus pérennes. Comme l’indique Sarah Simpkin,

Si jamais vous avez tenté d’ouvrir un document sauvegardé dans une version antérieure d’un logiciel de traitement de texte, vous pouvez comprendre facilement les problèmes de compatibilité qui sont en jeu.

L’utilisation de la syntaxe Markdown vous permettra de produire des fichiers à la fois lisibles en texte brut et prêts à recevoir davantage de traitement sur une autre plateforme. Plusieurs systèmes de gestion de blogs, des générateurs de sites web statiques ou encore des plateformes comme GitHub prennent en charge des fichiers Markdown pour les convertir en HTML et les publier sur le web.

Par ailleurs, j’ajouterai que les fichiers en texte brut, tel que Markdown, sont de taille très modeste et donc occupent peu de place sur vos supports de mémoire ou lors de leur transmission.

Dans ce tutoriel, vous pratiquerez concrètement la syntaxe Markdown directement depuis votre navigateur préféré en utilisant un éditeur en ligne (StackEdit)

A lire : Sarah Simpkin, «Débuter avec Markdown,» traduction par Sofia Papastamkou, The Programming Historian en français 2 (2020), https://doi.org/10.46430/phfr0007.

Pour ma part, j’utilise Markdown pour prendre mes notes ou rédiger mes articles avec Ulysses, réaliser mes présentations de colloque ou de séminaire sur hackmd.io, organiser une partie de ma veille en récupérant des publications en ligne à l’aide de DevonThink ou publier, comme ici, sur mon blog (WordPress) à l’aide d’Ulysses ou de Drafts.

Leçon 3 : Rédaction durable avec Pandoc et Markdown

Dans cette leçon, un peu plus technique, Dennis Tenen, professeur en littérature anglaise et comparée à l’Université Columbia, et Grant Wythoff, maître de conférences au département de littérature anglaise et comparée de l’Université Columbia, vous apprennent les notions de base de Markdown, une syntaxe de balisage facile à lire et écrire, ainsi que Pandoc, un outil en ligne de commande qui permet de convertir du texte brut en différents types de fichiers bien formatés: PDF, .docx, HTML, LaTeX, diaporama, et plus encore.
À l’aide de Pandoc comme outil de composition numérique, vous pouvez utiliser la syntaxe Markdown pour ajouter des figures ou une bibliographie, et changer facilement de style de citation, par exemple de Chicago à MLA, le tout en utilisant du texte brut.
Écrire ce cette façon libère l’auteur(e) de son outil. Vous pouvez écrire en Markdown dans n’importe quel éditeur de texte brut, et la syntaxe dispose d’un riche écosystème de logiciels qui peuvent transformer ces textes en de magnifiques documents. C’est pour cette raison que Markdown connaît actuellement une hausse de popularité, non seulement comme outil de rédaction d’articles scientifiques, mais aussi comme norme pour l’édition en général.
Influencés par diverses disciplines, Dennis Tenen et Grant Wythoff ont été guidés par les principes suivants:
1. Pérennité.
2. Priorité à la lisibilité humaine.
3. Séparation de la forme et du contenu.
4. Compatibilité avec la recherche universitaire.
5. Indépendance vis-à-vis des plateformes.

La leçon : Dennis Tenen et Grant Wythoff, «Rédaction durable avec Pandoc et Markdown,» traduction par Marie-Christine Boucher, The Programming Historian en français 2 (2020), https://doi.org/10.46430/phfr0013.

Nous sommes arrivés maintenant au terme de notre première leçon relativement au Markdown et à la maîtrise de nos données. To be continued…