• 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

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 […]

blank

Passion Médiévistes : Hors-série 34 – Le Moyen Âge au cinéma

22 avril 2025 Par Lyonel Kaufmann Laisser un commentaire

À l’occasion de l’édition 2025 du Festival international du film court d’Angoulême, deux invités sont venus croiser, dans cet épisode hors-série de Passion Médiévistes, leurs expériences sur les représentation du Moyen Âge au cinéma. Les invités : Cet épisode vient proposer les regards complémentaires d’un réalisateur et d’un historien pour interroger la manière dont le […]

blank

Trous de mémoires de Nicolas Juncker

17 avril 2025 Par Lyonel Kaufmann Laisser un commentaire

Comment raconter la guerre d’Algérie et ses mémoires sans tomber dans le pathos ou la leçon d’histoire trop académique ? Trous de mémoires relève ce défi avec audace, mêlant comédie burlesque et réflexion historique. Nicolas Juncker y explore, avec un humour grinçant, les tensions et contradictions qui entourent la mémoire de ce conflit, en s’inspirant du […]

blank

Ces familles néerlandaises qui découvrent un passé de collaboration – rts.ch

28 mars 2025 Par Lyonel Kaufmann Laisser un commentaire

C’est avec stupeur que de nombreux Néerlandais et Néerlandaises ont récemment découvert sur internet qu’un membre de leur famille avait collaboré avec les nazis durant la Seconde Guerre mondiale. En cause: la mise en ligne d’une liste de 425’000 noms par les archives nationales des Pays-Bas. Depuis janvier, les descendants affluent à La Haye, souvent […]

blank

Spreitenbach: Un paradis du shopping ou la porte des enfers? – Blog du Musée national suisse

24 mars 2025 Par Lyonel Kaufmann Laisser un commentaire

En 1975, l’Association suisse des instituteurs publia le panneau scolaire n°167. Celui-ci montre une vue aérienne de la commune de Spreitenbach, dans la vallée de la Limmat. Ou plus précisément de la ville nouvelle de Spreitenbach, «Neu-Spreitenbach», avec son centre commercial entouré d’un immense parking rempli de voitures aux couleurs vives et son imposant quartier […]

Tirés de nos archives

blank

M078 – «L’enseignant d’histoire transmetteur de savoir» (Séminaire)

18 décembre 2006 Par Lyonel Kaufmann Laisser un commentaire

L’ENSEIGNEMENT MAGISTRAL L’enseignement magistral ou modèle transmissif se qualifie par l’accès aux vérités par le discours, par l’exposé, par la démonstration. Cette méthode axée principalement sur le professeur, a pour but de présenter des propositions vraies sous forme de transmission. L’élève se devra donc de reconnaître comme évidence les savoirs acquis. Dans notre exposé consacré […]

blank

Un an après : Pourquoi Cléopâtre n’a pas inventé le vibromasseur

8 mai 2017 Par Lyonel Kaufmann Laisser un commentaire

À l’occasion de la sortie récente d’une bande dessinée à succès sur l’histoire de la sexualité, par Philippe Brenot et Laetitia Coryn (Les Arènes BD, 2016), l’information selon laquelle Cléopâtre aurait inventé, il y a un peu plus de 2000 ans, le premier vibromasseur a fait le tour du Web, témoignant de la fascination qu’exerce aujourd’hui encore l’ancienne […]

blank

Une « histoire de l’Histoire » à Berlin, capitale du XXe siècle

15 août 2011 Par Lyonel Kaufmann Laisser un commentaire

Une « histoire de l’Histoire » à Berlin, capitale du XXe siècle Mouvements artistiques, Rosa Luxemburg, Deuxième Guerre mondiale, le Mur et sa chute : Berlin est-elle la « capitale » du XXe siècle, pour le meilleur et pour le pire ? La réponse est oui pour l’auteur de cet article sur Rue89. «Cela devrait être Berlin. C’est […]

blank

Dossier d'actualité – Impact des TIC dans l'enseignement – janvier 2009

4 février 2009 Par Lyonel Kaufmann Laisser un commentaire

Dossier d’actualité – Impact des TIC dans l’enseignement – janvier 2009: Comment individualiser les…

blank

Nuit et Brouillard – Jean Ferrat

23 juillet 2010 Par Lyonel Kaufmann Laisser un commentaire

En 1963, Jean Ferrat compose cette chanson en mémoire des victimes des camps de concentration. Son père, immigré juif de Russie est mort à Auschwitz. La chanson fut « déconseillée » par le directeur de l’ORTF, mais passa un dimanche à midi sur la première chaîne, dans l’émission Discorama de Denise Glaser. Cette chanson fera partie avec cinquante-neuf […]

blank

EdNum – Casser les codes : le long chemin des femmes

26 novembre 2022 Par Lyonel Kaufmann Laisser un commentaire

En rassemblant les acteurs et les actrices engagé.e.s dans l’inclusion indispensable des femmes dans les secteur du numérique, l’association Femmes@Numérique, créée en 2021, souhaite donner toutes ses chances à la transformation en profondeur qui doit être conduite pour atteindre cet objectif. Elle a aussi servi de point de départ à la formation et au colloque organisés les 16 et […]

blank

Thomas Paine, La justice agraire opposée à la loi et monopole agraire, ou plan d’amélioration du sort des hommes, Paris, an V (1797), p.20 L’Europe peut-elle être dite “civilisée” ? – Révolution Française

22 avril 2010 Par Lyonel Kaufmann Laisser un commentaire

L’état actuel de la civilisation en Europe est aussi injuste dans ses principes, qu’odieux dans ses conséquences : on en est généralement convaincu, et c’est ce sentiment intime qui fait craindre les progrès des lumières, et qui fait trembler les possesseurs des propriétés à la seule idée d’une révolution ; […]. Lorsque la richesse et l’éclat, 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