• Passer à la navigation principale
  • Passer au contenu principal
  • Passer à la barre latérale principale
Histoire Lyonel Kaufmann

Histoire Lyonel Kaufmann

  • Mes Publications
  • Blog
  • Cours
    • Planifier
    • Film&Histoire
  • A propos

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.

blank

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…

Partager :

  • Cliquer pour envoyer un lien par e-mail à un ami(ouvre dans une nouvelle fenêtre) E-mail
  • Cliquer pour imprimer(ouvre dans une nouvelle fenêtre) Imprimer
  • Cliquez pour partager sur Pocket(ouvre dans une nouvelle fenêtre) Pocket
  • Cliquer pour partager sur Mastodon(ouvre dans une nouvelle fenêtre) Mastodon
  • Cliquer pour partager sur Bluesky(ouvre dans une nouvelle fenêtre) Bluesky
  • Cliquez pour partager sur Threads(ouvre dans une nouvelle fenêtre) Threads
  • Cliquez pour partager sur Tumblr(ouvre dans une nouvelle fenêtre) Tumblr
  • Cliquez pour partager sur LinkedIn(ouvre dans une nouvelle fenêtre) LinkedIn
  • Cliquez pour partager sur Facebook(ouvre dans une nouvelle fenêtre) Facebook
  • Cliquez pour partager sur WhatsApp(ouvre dans une nouvelle fenêtre) WhatsApp
  • Cliquez pour partager sur Telegram(ouvre dans une nouvelle fenêtre) Telegram

J’aime ça :

J’aime chargement…

Similaire

Classé sous :Humanités Digitales

blank

À propos Lyonel Kaufmann

Historien & Blogueur

Barre latérale principale

Lyonel Kaufmann

blankHistorien & Blogueur En savoir plus…

Derniers articles

blank

Colloque infoclio.ch 2025: Open Science in History. Ouvrir les sciences des Lumières à l’intelligence articifielle (21.11.2025

16 septembre 2025 Par Lyonel Kaufmann Laisser un commentaire

L’Open Science met les chercheuses et chercheurs au-devant de choix toujours plus complexes relatifs au partage de leurs résultats, méthodes, outils et données de recherche. Le colloque infoclio.ch 2025 explore les antécédents intellectuels et techniques de la notion d’Open science et discute des enjeux pratiques de sa mise en œuvre à l’ère des modèles génératifs […]

Abstract painting, coloring, modern art

Une histoire fragmentée ? Liens et ruptures dans un paysage de la recherche et de l’éducation en pleine remise en question (Journées suisses d’histoire 2025)

11 septembre 2025 Par Lyonel Kaufmann Laisser un commentaire

Dans le cadre des journées suisses d’histoire à Lucerne (juillet 2025), j’ai eu le plaisir d’assister et de réaliser le compte rendu pour infoclio.ch de la table ronde intitulée Fragmentierte Geschichte? Verbindungen und Brüche in einer sich ausdifferenzierenden Forschungs- und Bildungslandschaftm à laquelle participaient du côté francophone Nadine Fink (HEP Vaud) et François Vallotton (Université […]

blank

Vernissage : Plateforme Assistance et coercition (16.09.2025)

10 septembre 2025 Par Lyonel Kaufmann Laisser un commentaire

ÉVÉNEMENT 🗓️ Enseigner une histoire longtemps tue. Écouter les voix de celles et ceux qui l’ont vécue. Cinq témoins romands prennent la parole dans un nouveau média éducatif pour aborder les mesures de coercition à des fins d’assistance et des placements extrafamiliaux en Suisse. Conçue pour les élèves dès le secondaire I, la plateforme «Assistance […]

blank

Restes humains issus de contextes coloniaux en Suisse. Un état des lieux

9 septembre 2025 Par Lyonel Kaufmann Laisser un commentaire

Ce rapport donne un aperçu général de la question des restes humains conservés dans les musées suisses. Ce rapport s’appuie sur une enquête menée entre 2023 et 2025 et fournit pour la première fois un état des lieux des restes humains («ancestral remains») acquis dans des contextes coloniaux et conservés dans des musées et collections […]

blank

Jean-Pierre Azéma (1937-2025)

15 juillet 2025 Par Lyonel Kaufmann Laisser un commentaire

J’apprends par France Culture que l’historien Jean-Pierre Azéma est mort à l’âge de 87 ans. Spécialiste du régime de Vichy et de la Résistance, il a profondément marqué l’historiographie contemporaine, en contribuant à éclairer une page longtemps restée trouble de l’histoire nationale. Mais Jean-Pierre Azéma ne fut pas seulement un historien du papier : en […]

blank

Lectures de l’été : IA et éducation

1 juillet 2025 Par Lyonel Kaufmann Laisser un commentaire

L’été est toujours un moment où enfin on dispose de temps, où le flux interrompu et stressant du quotidien ralenti quelque peu. Il est favorable au farniente, à la lecture de polar, mais aussi à la réflexion. Je vous propose ainsi trois articles que je vais prendre le temps de lire attentivement consacrés à des […]

Décès du documentariste Marcel Ophüls à 97 ans

26 mai 2025 Par Lyonel Kaufmann Laisser un commentaire

Décès du documentariste Marcel Ophüls à 97 ans. Le maître français du documentaire historique est mort samedi dans sa maison du sud-ouest de la France, a-t-on appris lundi auprès de sa famille. Fils du grand cinéaste allemand Max Ophüls (“ La Ronde”, “Lola Montès”…), Marcel Ophüls avait fui l’Allemagne nazie enfant pour s’installer en France, avant de […]

Tirés de nos archives

blank

Stéphanie Demers : Les pratiques éducatives sont des pratiques humaines et sociales qui ne répondent pas aux algorithmes

6 septembre 2018 Par Lyonel Kaufmann Laisser un commentaire

Que nous apprennent les batteries d’évaluations nationales sur l’efficacité d’un système éducatif ? Pas grand chose et surtout rien d’essentiel, répond Stéphanie Demers, professeure à l’Université du Québec en Outaouais. Dans cet entretien donné au Café pédagogique elle montre non seulement les retombées négatives de ces système d’évaluation mais aussi leur incapacité à évaluer réellement […]

blank

Qu’est-ce que ça change ? | Educavox

28 décembre 2011 Par Lyonel Kaufmann Laisser un commentaire

Un excellent article de Pierre Frackowiak que n’aurait pas renié Larry Cuban. A intégrer à ses bonnes résolutions pédagogiques pour 2012. Tout d’abord le constat : «Surprenant quelques auditeurs convaincus que le seul fait d’utiliser les technologies nouvelles est un progrès, j’ai posé la question « qu’est-ce que ça change ? ». J’évoquai le saint exercice bled réalisé […]

blank

M078 – Bibliographie

13 mars 2006 Par Lyonel Kaufmann Laisser un commentaire

1. Ouvrages de base • DALONGEVILLE A., HUBER M., Enseigner l’histoire autrement : Devenir les héros des événements du passé, Lyon, Chronique Sociale, 2002. • LAUTIER N., Enseigner l’histoire au lycée, Paris, A. Colin, 1997. • LE PELLEC J., MARCOS-ALVAREZ V., Enseigner l’histoire : un métier qui s’apprend, Hachette, 1991. ** REY B., STRASZEWKI M., […]

blank

Le futur de l’éducation numérique | Mondes sociaux

24 septembre 2019 Par Lyonel Kaufmann Laisser un commentaire

 »Hacker c’est donc se rebeller, détourner les codes, être à la limite de la légalité… pour faire avancer la société (..) Parce qu’une action vaut mieux qu’une critique, j’ai créé HackEdu, avec une conviction : l’éducation ne peut-être disruptée que par ceux qui la font ». (Stéphanie Pfeiffer, créatrice de HackEdu) Le recours à ce vocabulaire […]

blank

“Groom” : les auteurs de “Spirou” veulent décrypter l’actu en BD pour les ados | Télérama

16 janvier 2016 Par Lyonel Kaufmann Laisser un commentaire

Décrypter l’information en BD, c’est le pari de Groom. Emanation du magazine Spirou et destiné prioritairement aux 8-14 ans, ce semestriel dont le premier numéro a été tiré à cinquante mille exemplaires, vient tout juste d’arriver en kiosque. Attentats parisiens, crise des réfugiés, rapprochement Cuba-Etats-Unis, Dieselgate : ce cousin du Petit Quotidien et de La Revue Dessinée qui […]

blank

Revue de presse : Que retenir du XIXème siècle ? Au-delà des clichés, les possibles. | aggiornamento hist-geo

30 mars 2013 Par Lyonel Kaufmann Laisser un commentaire

«Le récit du XIXe siècle n’est pas celui d’une « légende dorée » qui se caractérisait par des marches inexorables vers la République ou le progrès économique et social, ni celui d’une « légende noire », réduite à l’oppression des ouvriers et des indigènes. Au lieu d’édifier les élèves, notre métier est de les initier […]

blank

Québec : Enseignement de l’histoire au secondaire: la réforme est reportée

13 mai 2016 Par Lyonel Kaufmann Laisser un commentaire

La réforme de l’enseignement de l’histoire du Québec et du Canada au secondaire n’aura pas lieu à l’automne prochain comme prévu, a confirmé le ministère de l’Éducation, jeudi. Au lieu de cela, le ministère effectuera des changements au programme pour qu’il reflète mieux les minorités culturelles et linguistiques de la province, selon une source au […]

Creative Commons License
Cette création est mise à disposition sous un contrat Creative Commons. Lyonel Kaufmann 2004-2025

Creative Commons License Ce contenu est mis à disposition sous un contrat Creative Commons. Lyonel Kaufmann 2004-2025.
Thème Aspire 2.0.1 de Genesis Framework · WordPress · Se connecter

%d