Humanités Digitales

Markdown : The Programming Historian

13 décembre 2020 by Lyonel Kaufmann

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…

A Digital Project Handbook

11 décembre 2020 by Lyonel Kaufmann

Beth Fischer (boursière postdoctorale en sciences humaines numériques au Williams College Museum of Art) et Hannah Jacobs (spécialiste des sciences humaines numériques, Wired ! Lab, Duke University) proposent des ressources ouvertes, évaluées par les pairs, de contenus et d’informations relatives à la réalisation de projets numériques en sciences humaines.

Leur Digital Book offre

des conseils sur les flux de travail, les ressources et les principes de calcul ;
des sujets applicables à de nombreux types de projets;
un contenu modulaire et téléchargeable, permettant aux utilisateurs de créer des guides annotés personnalisés.

L’illustration ci-dessous synthétise la structure de leur projet et permet de visualiser les sujets abordés dans leur Digital Project Handbook :

Leurs ressources ouvertes comblent le fossé entre les tutoriels spécifiques présent sur la plate-forme et le discours disciplinaire en sciences humaines numériques.

Beth Fischer et Hannah Jacobs souhaitent ainsi combler le fossé entre les tutoriels spécifiques à la plate-forme et le discours disciplinaire en sciences humaines numériques.

Exemple : les projets temporels

A titre d’exemple, voici la traduction de la partie introductive de la page consacrée aux projets temporels.

Les projets temporels nécessitent rarement de nouveaux biens d’équipement, bien que vous puissiez y intégrer des sous-projets, comme des séquences vidéo ou des documents d’archives, qui nécessitent un équipement spécial. Il y aura parfois des coûts d’équipement pour des présentations spéciales de projets temporels, comme les panneaux d’affichage lumineux interactifs qui sont très populaires dans les expositions.

La plupart des programmes et des plateformes permettant de réaliser des projets temporels fonctionnent bien sur un ordinateur standard sans puissance de traitement supplémentaire, et nombre d’entre eux peuvent même être entièrement exécutés dans un navigateur web, ce qui permet de travailler facilement sur n’importe quel ordinateur connecté à Internet.

Les programmes utiles pour les projets temporels appartiennent généralement à l’une des trois catégories suivantes

– Les plates-formes ou programmes temporels qui vous permettent de créer une ou plusieurs séries d’événements d’idées en série.

– Les plates-formes de narration d’histoires comme StoryMapJS, ESRI Story Maps, ou les programmes qui aident à la création de récits de type cinématographique.

– Des programmes d’analyse de données et de réseaux comme Tableau ou GraphCommons, y compris ceux utilisés pour la cartographie, qui vous permettent de montrer comment les espaces, les idées ou d’autres facteurs évoluent dans le temps les uns par rapport aux autres.

[…]

Les matériaux proposés sont riches et intéressants et sont complétés par des études de cas significatives et documentées. Le tout forme une boîte à outils utile et inspirante relativement aux humanités à l’ère numérique.

Le site : A Digital Project Handbook

Guide : Ouvrir la Science – Passeport pour la Science Ouverte

7 octobre 2020 by Lyonel Kaufmann

Ce Passeport pour la science ouverte a été conçu pour accompagner les doctorant•es à chaque étape de leur parcours de recherche, quel que soit leur champ disciplinaire. Il propose une série de bonnes pratiques et d’outils directement activables. Cependant, à mon avis, son intérêt dépasse largement l’accompagnement des doctorant•es. Et la science ouverte nous concerne toutes et tous. A consommer donc sans modération.

Le préambule de ce guide

La science ouverte est née des nouvelles opportunités offertes par la révolution numérique en matière de partage et de diffusion des contenus scientifiques. Elle consiste d’abord à rendre accessible à tous les résultats de la recherche, en levant les barrières techniques ou financières qui entravent l’accès aux publications scientifiques. Elle consiste aussi à ouvrir la boîte noire du chercheur en partageant autant que possible les données et les méthodes sous-jacentes aux publications.

Le choix de la science ouverte revient d’abord à affirmer qu’une recherche majoritairement financée sur fonds publics doit restituer le plus largement possible ses résultats au public. Il se nourrit aussi du constat que l’ouverture est le gage d’une recherche mieux documentée et plus étayée, et que le partage renforce le caractère cumulatif de la science et favorise ses avancées. Une science ouverte et transparente contribue également à accroître la crédibilité de la recherche dans la société, un enjeu dont la crise sanitaire de 2020 nous a rappelé toute l’importance. Elle est porteuse enfin d’un profond mouvement de démocratisation des savoirs au bénéfice des organisations, des entreprises, des citoyens, et particulièrement des étudiants, pour lesquels la facilité d’accès à la connaissance est une condition de la réussite.

Les politiques de science ouverte sont désormais portées au plus haut niveau par l’Union européenne qui, depuis 2012, conditionne ses aides à la recherche scientifique à l’ouverture des publications, et par de grands organismes de recherche dans le monde, tels que les National Institutes of Health aux Etats-Unis. En France, la ministre de l’Enseignement supérieur, de la Recherche et de l’Innovation Frédérique Vidal a lancé en 2018 un ambitieux Plan national pour la science ouverte, qui s’incarne depuis dans de multiples initiatives.

En définitive, ce sont bien les chercheurs qui, à travers leurs engagements et leurs pratiques, incarnent et font vivre la science ouverte. Au moment où vous vous engagez dans la préparation de votre doctorat, dernière étape de votre parcours de formation et première étape de votre vie professionnelle, c’est donc à vous qu’il appartient de mettre en œuvre ces principes.

Le _Passeport pour la science ouverte _est un guide conçu pour vous accompagner à chaque étape de votre parcours de recherche, depuis l’élaboration de votre démarche scientifique jusqu’à la diffusion de ses résultats. Il vous propose une série de bonnes pratiques et d’outils directement activables et il s’adresse à l’ensemble des champs disciplinaires.

Nous souhaitons qu’il vous donne l’envie et les moyens de concrétiser les ambitions de la science ouverte, en partageant avec le plus grand nombre les résultats et les données des recherches que vous allez conduire.

Anne-Sophie Barthez

Directrice générale de l’enseignement supérieur et de l’insertion professionnelle

Bernard Larrouturou

Directeur général de la recherche et de l’innovation

La Table des matières

Concevoir sa démarche scientifique de manière ouverte
- Utiliser des ressources librement accessibles
- Prévoir la gestion des données
- Travailler de manière reproductible : pour soi, pour les autres
Diffuser sa recherche
- Diffuser ses publications en accès ouvert
- Rendre sa thèse librement accessible
- Ouvrir les données de recherche
Préparer l’après-thèse, rejoindre le mouvement
- Des politiques publiques enracinées
- Évaluer la recherche autrement

Agir dès maintenant

Aller plus loin

Glossaire

Sources

Accéder au guide : www.ouvrirlascience.fr

Le guide est sous licence _Creative Commons_BY-SA.

Frÿburg 1606 : Voir Fribourg comme en 1606

9 septembre 2020 by Lyonel Kaufmann

Comment vivaient les habitants de Fribourg au début du XVIIe siècle? Comment étaient-ils habillés? Quelles étaient leurs occupations professionnelles? Et quelle était l’apparence de la ville? La nouvelle offre de Fribourg Tourisme invite les visiteurs de la Cité des Zaehringen à se plonger dans le passé. Grâce à un visioguide (avec écouteurs et tablette), ceux-ci voyagent dans l’espace et le temps.

Philippe, le guide virtuel, présente les murs séculaires de Fribourg à la lumière du plan de ville réalisé en 1606 sous forme de gravure par Martin Martini. Traversant les siècles, il emmène les spectateurs/auditeurs à la découverte de fortifications disparues ou de légendes, et, surtout, leur fait rencontrer des personnages dans leur quotidien de 1606. Parmi ceux-ci: Marie, une Fribourgeoise née en 1586. A travers leur dialogue, le visiteur peut tracer des traits d’union entre le présent et le passé.

Location des audioguides à Fribourg Tourisme (12 francs par personne, 17 francs pour deux personnes sur une tablette). La visite dure trois heures. Disponible aussi pour smartphone.

Source : La Liberté https://www.laliberte.ch/news/regions/canton/voir-fribourg-comme-en-1606-576182

Un jeu vidéo pour s’immerger dans le confinement des autres

23 août 2020 by Lyonel Kaufmann

Suite aux mesures sanitaires mises en place ce printemps en Suisse, deux étudiants, un graphiste, un chercheur de l’EPFL et un journaliste du «Temps» ont créé un récit interactif.

La question s’est posée au début du semi-confinement, alors que le covid était déjà omniprésent dans les médias: comment aborder cette thématique d’actualité autrement? Et si nous explorions la piste du jeu vidéo pour s’immerger dans le quotidien d’autres personnes et entrevoir ce qu’elles ont vécu? Lancé par l’Initiative pour l’innovation dans les médias (à laquelle Le Temps est affilié) en collaboration avec l’EPFL et l’Unil, ce projet de création de jeu vidéo a été mené durant l’été. Retour sur une coopération inédite menant à la création de Quatre apparts & un confinement.

Chargés de coordonner ce projet, Yannick Rochat et Paul Ronga ont décidé de s’inspirer des game jams, ces événements qui ne durent qu’un week-end et lors desquels on se réunit pour créer des jeux vidéo de A à Z. En un temps limité, il s’agit de tirer parti de toutes les compétences présentes, de laisser libre cours à l’esprit d’initiative et de faire preuve de bienveillance mutuelle.

Le résultat est superbe graphiquement. Les utilisateurs peuvent cliquer sur les appartements numériques, visiter chaque personnage et participer brièvement à leur vie: leurs décisions, leurs inquiétudes, leurs désirs ou leurs frustrations. Certaines expériences peuvent sembler familières aux utilisateurs, tandis que d’autres offrent une perspective différente sur ce que d’autres personnes peuvent ressentir pendant le confinement. Une réussite !

De plus, grâce à son code open source, d’autres médias et institutions sont invités à publier ou adapter l’expérience de jeu unique, par exemple dans d’autres langues.

Le jeu hébergé sur le site-web et l’application mobile Le Temps. : « Quatre apparts et un confinement »

L’équipe de développement/réalisation :

Conception du jeu : Saara Jones @astonedf
Graphisme : Mathias Hängärtner @matang
Développement : Andrew Dobis @dobios
Coordination du projet : Yannick Rochat @yrochat, Paul Ronga @palrogg
Producteurs : Mounir Krichane (IMI), Gaël Hürlimann (Le Temps)

Source : Un jeu vidéo pour s’immerger dans le confinement des autres – Le Temps

Briser le mur numérique, #LUDOVIALES – Jour 3

30 avril 2020 by Lyonel Kaufmann

Qui l’eut cru, nous voilà déjà au terme du troisième jour des LUDOVIALES. Ce pari un peu fou a débuté il y a trois semaines. Hier, j’ai le sentiment que nous sommes parvenus à briser le mur numérique.

Concrèrement les LUDOVIALES, c’est l’idée et le sentiment qu’un besoin et un créneau existeraient pour permettre aux enseignants et formateurs de tous degrés d’échanger leurs expériences relativement à un enseignement réalisé en temps de pandémie, de croiser nos regards depuis toute la francophonie et de prendre un peu de recul pour (un peu) mieux comprendre le changement que nous connaissons toutes et tous.

C’est le pari d’une équipe d’organisateurs engagés dans les différents Ludovias existants ou en devenir (Belgique, Canada, France, Suisse). Cette équipe est composée de gens qui, dans le fond, ne doutent de rien, sont prêts à relever tous les défis et sont capables de vivre et gérer les incertitudes. Notre force collective est de savoir qu’il sera possible à n’importe quel moment de compter sur les autres. Et ça marche.

Le démarrage a été chaud. Après un premier temps à prendre nos marques et la mesure de certains défs techniques, cela a été mieux. La bienveillance des participant.e.s nous a aussi grandement aidés et soutenus. Merci à eux.

Dès le deuxième jour, nous étions (mieux) rodés. Boostés que nous avons été par le nombre sans cesse grandissant de participant.e.s inscrit.e.s et leur énergie contagieuse.

Après maintenant trois jours, la modération de nos salles d’ateliers (visioconférence) n’a plus de secret (ou presque) pour nous. J’ai l’impression d’avoir fait cela toute ma vie. J’en oublie quasiment le premier atelier à 70 participant.e.s et ma connexion sonore qui plante dès le début alors que je dois modérer et aider techniquement l’intervenant.e. 😳 Mythique.

Bon toute la technique a progressé ces dernières années dans le domaine de la visioconférence. Elle reste cependant fragile et souvent un peu aléatoire même avec un nombre restreint de participant.e.s. Nous sommes encore dans une technique et un monde de pionnier. Mais nous sommes sur le bon chemin. Et les participants de cette première édition vont sûrement progresser grandement dans l’appropriation de ces outils.

Hier soir (cette nuit), j’ai pensé à l’ouvrage, très initiateur pour moi, Breaking down the digital wall. Learning to Teach in a Post-Modem World de Burniske et Monke datant de 2001.

« Breaking Down the Digital Walls » est un livre inhabituel qui décrit comment, dans différentes parties du monde, deux enseignants réfléchis et utilisateurs d’ordinateurs ont créé des projets de collaboration sur Internet pour des lycéens de divers pays. Ils nous amènent à saisir la philosophie qui les anime et plus particulièrement que l’utilisation des ordinateurs à l’école est bien plus une question d’apprentissage que de technologie.

Même Larry Cuban en a dit du bien :

« Remplies d’idées pratiques et de beaucoup de sagesse, ces voix authentiques de la salle de classe devraient donner à réfléchir aux promoteurs et aux sceptiques quant à l’utilisation des ordinateurs comme outils d’apprentissage ».

Dans cet ouvrage, les auteurs Burniske et Monke sont professeurs dans deux pays différents et entreprennent un projet de correspondance scolaire par email. D’un côté, les élèves disposent des ordinateurs en nombre de dernier cri et d’une excellente connexion. De l’autre, l’établissement ne dispose que d’un ordinateur dans un bureau, non accessible pour les élèves et avec un modem tout pourri qui ne peut être utilisé que la nuit. Les conditions techniques n’empêchent pourtant pas la correspondance. Le dispositif didactique et pédagogique est adapté aux conditions techniques existantes. Ce sera le professeur qui postera hors les cours et de nuit le courriel rédigé par ses élèves durant la semaine à leurs correspondants. La situation de communication prime et l’outil ne l’entrave pas.

A sa lecture au début des années 2000, ce livre m’a éclairé et renforcé dans l’idée que la démarche didactique et le projet pédagogique priment sur l’outil. L’outil sera toujours quelque part lacunaire, voire susceptible de défaillance, mais il s’agit de faire avec, voire de le contourner, plutôt que de trouver toutes les bonnes raisons pour ne pas réaliser le projet pédagogique et didactique.

Plus qu’un livre sur la technologie, c’est un livre de nature philosophique et ethique. Burniske pose la question de comment trouver des moyens d’utiliser correctement la technologie en classe, c’est-à-dire sans renoncer aux questions humaines ou au contexte. Monke s’interroge sur les moyens à donner aux enseignants et sur la liberté d’éduquer correctement leurs élèves. Tous les deux considèrent leur élèves non pas comme des produits ou des consommateurs, mais comme une communauté de personnes qui ont besoin d’être nourries, prises en charge et finalement amenées à une compréhension plus profonde de leur place dans le monde.

En bref, c’est un livre qui est toujours présent dans un coin de ma tête et de mes réflexions relatives à l’utilisation et la place des technologies dans l’enseignement. Il est intégré à ma posture intellectuelle en matière d’éducation et d’enseignement à l’ère numérique.

Aujourd’hui, les conditions de l’enseignement à distance d’urgence nous plonge tous dans cette réalité-là. Il s’agit pour nous, avec les moyens techniques aussi lacunaires et imparfaits à notre disposition et à celle de nos élèves ou étudiant.e.s, de maintenir la communication et construire le projet pédagogique entre nous/eux, pour eux/nous.

Tant pis si la connexion est parfois chaotique et défaillante dans les ateliers des LUDOVIALES comme avec nos élèves et étudiant.e.s, le besoin d’être au monde, de rendre compte, de nous enrichir et de confronter nos expériences vécues depuis un mois prime. Quitte parfois à devoir briser le mur numérique pour nous permettre d’être au monde et côte à côte.