{"id":17900,"date":"2020-12-13T03:31:14","date_gmt":"2020-12-13T02:31:14","guid":{"rendered":"https:\/\/lyonelkaufmann.ch\/histoire\/?p=17900"},"modified":"2020-12-23T20:52:22","modified_gmt":"2020-12-23T19:52:22","slug":"markdown-the-programming-historian","status":"publish","type":"post","link":"https:\/\/lyonelkaufmann.ch\/histoire\/2020\/12\/13\/markdown-the-programming-historian\/","title":{"rendered":"Markdown : The Programming Historian"},"content":{"rendered":"

Le format markdown<\/em> pr\u00e9sente l\u2019avantage d\u2019\u00eatre un langage \u00e0 la syntaxe relativement simple et l\u00e9ger. Il permet aussi de s\u2019affranchir, au moment de la r\u00e9daction, 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\u2019exemple). Ce n’est pas un format de texte propri\u00e9taire et il est plus puissant que le format .txt.<\/strong><\/p>\n

Dans le cadre d\u2019une s\u00e9rie d\u2019articles consacr\u00e9s au format markdown<\/em> et \u00e0 la question de la ma\u00eetrise de nos donn\u00e9es, je vous pr\u00e9sente aujourd\u2019hui The Programming Historian<\/em><\/a> et leurs le\u00e7ons qui pourront vous \u00eatre utiles dans le cadre de votre \u00ab encapacitation \u00bb (empowerment)<\/em>.<\/strong><\/p>\n

\"\"<\/p>\n

Pr\u00e9sentation<\/h2>\n

The Programming Historian<\/a><\/em> est un collectif d\u2019universitaire qui publie des tutoriels \u00e9valu\u00e9s par des pairs permettant l’initiation \u00e0 et l’apprentissage d’un large \u00e9ventail d’outils num\u00e9riques, de techniques et de flux de travail pour faciliter la recherche et l’enseignement en sciences humaines et sociales.<\/p>\n

Les tutoriels et le\u00e7ons sont publi\u00e9s en trois langues : anglais, espagnol et fran\u00e7ais. Concernant les \u00e9quipes \u00e9ditoriales, la page suivante pr\u00e9sente leurs membres : https:\/\/programminghistorian.org\/fr\/equipe-projet.html<\/a>.<\/p>\n

Le\u00e7on 1 : Pr\u00e9server ses donn\u00e9es de recherche<\/h2>\n

Avant d\u2019en venir aux le\u00e7ons sur le Markdown, il para\u00eet utile de commencer par la le\u00e7on relative \u00e0 la pr\u00e9servation de ses donn\u00e9es de recherche<\/a>. Cette le\u00e7on donne des pistes aux historiens et aux historiennes pour documenter, structurer et p\u00e9renniser leurs donn\u00e9es de recherche.<\/p>\n

Cette le\u00e7on est l\u2019oeuvre de James Baker<\/a>, ma\u00eetre de conf\u00e9rences en histoire et archives num\u00e9riques \u00e0 l’Universit\u00e9 du Sussex et au Sussex Humanities Lab.<\/p>\n

S\u2019appuyant sur les le\u00e7ons et l\u2019expertise de professionnels en donn\u00e9es de la recherche, cette le\u00e7on sugg\u00e8re aux historiennes et aux historiens des moyens de documenter et de structurer leurs propres donn\u00e9es de mani\u00e8re \u00e0 ce qu\u2019elles restent utilisables dans le futur. Il ne se veut pas normatif mais suppose que les lecteurs et lectrices it\u00e9reront, changeront et adapteront les id\u00e9es pr\u00e9sent\u00e9es pour correspondre au mieux \u00e0 leurs recherches.<\/p>\n

James Baker cite, notamment \u00e0 l\u2019appui de ces propos, William Stafford Noble :<\/p>\n

Le principe de base est simple: quelqu\u2019un non familiaris\u00e9 avec votre projet devrait \u00eatre capable de consulter vos fichiers informatiques et de comprendre en d\u00e9tails ce que vous avez fait et pourquoi [\u2026] Cependant, le plus souvent ce \u00ab quelqu\u2019un \u00bb c\u2019est vous. Dans quelques mois, vous ne vous souviendrez peut-\u00eatre plus de ce que vous faisiez lorsque vous avez cr\u00e9\u00e9 un ensemble particulier de fichiers, ou des conclusions que vous avez tir\u00e9es. Vous devrez alors passer du temps \u00e0 reconstruire vos exp\u00e9riences pr\u00e9c\u00e9dentes ou perdre toutes les connaissances que vous aviez acquises de ces exp\u00e9riences.<\/em>
\nWilliam Stafford Noble (2009) A Quick Guide to Organizing Computational Biology Projects. PLoSComputBiol 5(7): e1000424. doi:10.1371\/journal.pcbi.1000424<\/p><\/blockquote>\n

Apr\u00e8s en avoir poser le cadre et la n\u00e9cessit\u00e9, la le\u00e7ontraite des points suivants :
\n1. Formats des fichiers.
\n2. Structuration des donn\u00e9es de la recherche.<\/p>\n

Pour poursuivre : James Baker, \u00abPr\u00e9server ses donn\u00e9es de recherche,\u00bb traduction par Anne-Sophie Bessero-Lagarde, The Programming Historian en fran\u00e7ais<\/em> 2 (2020), https:\/\/doi.org\/10.46430\/phfr0009<\/a>.<\/p>\n

Le\u00e7on 2 : D\u00e9buter avec Markdown<\/h2>\n

Dans cette deuxi\u00e8me le\u00e7on, Sarah Simpkin, biblioth\u00e9caire sp\u00e9cialis\u00e9e en SIG, g\u00e9ographie et informatique \u00e0 l’Universit\u00e9 d’Ottawa, nous propose une introduction \u00e0 Markdown, une syntaxe en texte brut pour le formatage de documents. Vous d\u00e9couvrirez pourquoi l\u2019utiliser, comment formater des fichiers Markdown et comment pr\u00e9visualiser de tels fichiers sur le web.
\nD\u00e9velopp\u00e9 en 2004 par John Gruber<\/a>, Markdown est \u00e0 la fois un langage de balisage de fichiers textes et une fonctionnalit\u00e9 du langage Perl permettant de convertir des fichiers Markdown en HTML.
\nLes fichiers texte brut pr\u00e9sentent plusieurs avantages compar\u00e9s aux autres formats. Non seulement ils sont compatibles avec tout type d\u2019appareil et de syst\u00e8me d\u2019exploitation, mais ils s\u2019av\u00e8rent aussi plus p\u00e9rennes. Comme l\u2019indique Sarah Simpkin,<\/p>\n

Si jamais vous avez tent\u00e9 d\u2019ouvrir un document sauvegard\u00e9 dans une version ant\u00e9rieure d\u2019un logiciel de traitement de texte, vous pouvez comprendre facilement les probl\u00e8mes de compatibilit\u00e9 qui sont en jeu.<\/p><\/blockquote>\n

L\u2019utilisation de la syntaxe Markdown vous permettra de produire des fichiers \u00e0 la fois lisibles en texte brut et pr\u00eats \u00e0 recevoir davantage de traitement sur une autre plateforme. Plusieurs syst\u00e8mes de gestion de blogs, des g\u00e9n\u00e9rateurs de sites web statiques ou encore des plateformes comme GitHub<\/a> prennent en charge des fichiers Markdown pour les convertir en HTML et les publier sur le web.<\/p>\n

Par ailleurs, j\u2019ajouterai que les fichiers en texte brut, tel que Markdown, sont de taille tr\u00e8s modeste et donc occupent peu de place sur vos supports de m\u00e9moire ou lors de leur transmission.<\/p>\n

Dans ce tutoriel, vous pratiquerez concr\u00e8tement la syntaxe Markdown directement depuis votre navigateur pr\u00e9f\u00e9r\u00e9 en utilisant un \u00e9diteur en ligne (StackEdit)<\/p>\n

A lire : Sarah Simpkin, \u00abD\u00e9buter avec Markdown,\u00bb traduction par Sofia Papastamkou, The Programming Historian en fran\u00e7ais<\/em> 2 (2020), https:\/\/doi.org\/10.46430\/phfr0007<\/a>.<\/p>\n

Pour ma part, j\u2019utilise Markdown pour prendre mes notes ou r\u00e9diger mes articles avec Ulysses<\/a>, r\u00e9aliser mes pr\u00e9sentations de colloque ou de s\u00e9minaire sur hackmd.io<\/a>, organiser une partie de ma veille en r\u00e9cup\u00e9rant des publications en ligne \u00e0 l\u2019aide de DevonThink<\/a> ou publier, comme ici, sur mon blog (WordPress) \u00e0 l\u2019aide d\u2019Ulysses ou de Drafts.<\/strong><\/p>\n

\"\"<\/p>\n

Le\u00e7on 3 : R\u00e9daction durable avec Pandoc et Markdown<\/h2>\n

Dans cette le\u00e7on, un peu plus technique, Dennis Tenen, professeur en litt\u00e9rature anglaise et compar\u00e9e \u00e0 l’Universit\u00e9 Columbia, et Grant Wythoff, ma\u00eetre de conf\u00e9rences au d\u00e9partement de litt\u00e9rature anglaise et compar\u00e9e de l’Universit\u00e9 Columbia, vous apprennent les notions de base de Markdown, une syntaxe de balisage facile \u00e0 lire et \u00e9crire, ainsi que Pandoc, un outil en ligne de commande qui permet de convertir du texte brut en diff\u00e9rents types de fichiers bien format\u00e9s: PDF, .docx, HTML, LaTeX, diaporama, et plus encore.
\n\u00c0 l\u2019aide de Pandoc comme outil de composition num\u00e9rique, vous pouvez utiliser la syntaxe Markdown pour ajouter des figures ou une bibliographie, et changer facilement de style de citation, par exemple de Chicago \u00e0 MLA, le tout en utilisant du texte brut.
\n\u00c9crire ce cette fa\u00e7on lib\u00e8re l\u2019auteur(e) de son outil. Vous pouvez \u00e9crire en Markdown dans n\u2019importe quel \u00e9diteur de texte brut, et la syntaxe dispose d\u2019un riche \u00e9cosyst\u00e8me de logiciels qui peuvent transformer ces textes en de magnifiques documents. C\u2019est pour cette raison que Markdown conna\u00eet actuellement une hausse de popularit\u00e9, non seulement comme outil de r\u00e9daction d\u2019articles scientifiques, mais aussi comme norme pour l\u2019\u00e9dition en g\u00e9n\u00e9ral.
\nInfluenc\u00e9s par diverses disciplines, Dennis Tenen et Grant Wythoff ont \u00e9t\u00e9 guid\u00e9s par les principes suivants:
\n1. P\u00e9rennit\u00e9.
\n2. Priorit\u00e9 \u00e0 la lisibilit\u00e9 humaine.
\n3. S\u00e9paration de la forme et du contenu.
\n4. Compatibilit\u00e9 avec la recherche universitaire.
\n5. Ind\u00e9pendance vis-\u00e0-vis des plateformes.<\/p>\n

La le\u00e7on : Dennis Tenen et Grant Wythoff, \u00abR\u00e9daction durable avec Pandoc et Markdown,\u00bb traduction par Marie-Christine Boucher, The Programming Historian en fran\u00e7ais<\/em> 2 (2020), https:\/\/doi.org\/10.46430\/phfr0013<\/a>.<\/p>\n

Nous sommes arriv\u00e9s maintenant au terme de notre premi\u00e8re le\u00e7on relativement au Markdown et \u00e0 la ma\u00eetrise de nos donn\u00e9es. To be continued\u2026<\/strong><\/p>\n","protected":false},"excerpt":{"rendered":"

Le format markdown pr\u00e9sente l\u2019avantage d\u2019\u00eatre un langage \u00e0 la syntaxe relativement simple et l\u00e9ger. Il permet aussi de s\u2019affranchir, au moment de la r\u00e9daction, 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, […]<\/p>\n","protected":false},"author":1,"featured_media":17903,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_import_markdown_pro_load_document_selector":0,"_import_markdown_pro_submit_text_textarea":"","_genesis_hide_title":false,"_genesis_hide_breadcrumbs":false,"_genesis_hide_singular_image":false,"_genesis_hide_footer_widgets":false,"_genesis_custom_body_class":"","_genesis_custom_post_class":"","_genesis_layout":"","jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[802],"tags":[],"class_list":{"0":"post-17900","1":"post","2":"type-post","3":"status-publish","4":"format-standard","5":"has-post-thumbnail","7":"category-humanites-digitales","8":"entry"},"jetpack_publicize_connections":[],"featured_image_src":"https:\/\/i0.wp.com\/lyonelkaufmann.ch\/histoire\/wp-content\/uploads\/2020\/12\/about.png?resize=600%2C400&ssl=1","featured_image_src_square":"https:\/\/i0.wp.com\/lyonelkaufmann.ch\/histoire\/wp-content\/uploads\/2020\/12\/about.png?resize=600%2C479&ssl=1","author_info":{"display_name":"Lyonel Kaufmann","author_link":"https:\/\/lyonelkaufmann.ch\/histoire\/author\/lyonelk\/"},"jetpack_featured_media_url":"https:\/\/i0.wp.com\/lyonelkaufmann.ch\/histoire\/wp-content\/uploads\/2020\/12\/about.png?fit=621%2C479&ssl=1","jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/p1rJVM-4EI","jetpack_likes_enabled":true,"jetpack-related-posts":[{"id":17959,"url":"https:\/\/lyonelkaufmann.ch\/histoire\/2020\/12\/23\/markdown-rediger-dans-votre-navigateur-avec-stackedit-io\/","url_meta":{"origin":17900,"position":0},"title":"Markdown : r\u00e9diger dans votre navigateur avec Stackedit.io","author":"Lyonel Kaufmann","date":"23 d\u00e9cembre 2020","format":false,"excerpt":"Dans le cadre d\u2019une s\u00e9rie d\u2019articles consacr\u00e9s au format markdown et \u00e0 la question de la ma\u00eetrise de nos donn\u00e9es, je vous pr\u00e9sente aujourd\u2019hui Stackedit.io. en prolongement de mon article consacr\u00e9 \u00e0 The Programming Historian. The Programming Historian propose aux personnes de se familiariser avec la r\u00e9daction en utilisant la\u2026","rel":"","context":"Dans "Humanit\u00e9s Digitales"","block_context":{"text":"Humanit\u00e9s Digitales","link":"https:\/\/lyonelkaufmann.ch\/histoire\/category\/humanites-digitales\/"},"img":{"alt_text":"spectacular view of small village on mountain valley","src":"https:\/\/i0.wp.com\/lyonelkaufmann.ch\/histoire\/wp-content\/uploads\/2020\/12\/pexels-photo-5966170.jpeg?fit=800%2C1200&ssl=1&resize=350%2C200","width":350,"height":200,"srcset":"https:\/\/i0.wp.com\/lyonelkaufmann.ch\/histoire\/wp-content\/uploads\/2020\/12\/pexels-photo-5966170.jpeg?fit=800%2C1200&ssl=1&resize=350%2C200 1x, https:\/\/i0.wp.com\/lyonelkaufmann.ch\/histoire\/wp-content\/uploads\/2020\/12\/pexels-photo-5966170.jpeg?fit=800%2C1200&ssl=1&resize=525%2C300 1.5x, https:\/\/i0.wp.com\/lyonelkaufmann.ch\/histoire\/wp-content\/uploads\/2020\/12\/pexels-photo-5966170.jpeg?fit=800%2C1200&ssl=1&resize=700%2C400 2x"},"classes":[]},{"id":18951,"url":"https:\/\/lyonelkaufmann.ch\/histoire\/2022\/06\/11\/markdown-simplenote-lecriture-collaborative-facile\/","url_meta":{"origin":17900,"position":1},"title":"Markdown : SimpleNote, l’\u00e9criture collaborative facile","author":"Lyonel Kaufmann","date":"11 juin 2022","format":false,"excerpt":"Le format markdown pr\u00e9sente l\u2019avantage d\u2019\u00eatre un langage \u00e0 la syntaxe relativement simple et l\u00e9ger. Il permet aussi de s\u2019affranchir, au moment de la r\u00e9daction, 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\u2026","rel":"","context":"Dans "Humanit\u00e9s Digitales"","block_context":{"text":"Humanit\u00e9s Digitales","link":"https:\/\/lyonelkaufmann.ch\/histoire\/category\/humanites-digitales\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":18999,"url":"https:\/\/lyonelkaufmann.ch\/histoire\/2022\/06\/21\/ulysses-passe-a-aux-tables\/","url_meta":{"origin":17900,"position":2},"title":"Ulysses passe \u00e0 table","author":"Lyonel Kaufmann","date":"21 juin 2022","format":false,"excerpt":"La fonction la plus demand\u00e9e par les utilisateurs d\u2019Ulysses ? La prise en charge compl\u00e8te des tableaux1. L\u2019\u00e9diteur de texte comprenait la syntaxe MultiMarkdown permettant de cr\u00e9er des s\u00e9ries, mais n\u2019offrait d\u2019aucune aide. Ulysses comble cette lacune, aussi bien sur iOS que macOS, et permet maintenant de cr\u00e9er des tableaux\u2026","rel":"","context":"Dans "Humanit\u00e9s Digitales"","block_context":{"text":"Humanit\u00e9s Digitales","link":"https:\/\/lyonelkaufmann.ch\/histoire\/category\/humanites-digitales\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":18959,"url":"https:\/\/lyonelkaufmann.ch\/histoire\/2022\/06\/12\/zotero-6-0-un-lecteur-de-pdf-ameliore-et-un-nouvel-editeur-de-notes\/","url_meta":{"origin":17900,"position":3},"title":"Zotero 6.0 : un lecteur de pdf am\u00e9lior\u00e9 et un nouvel \u00e9diteur de notes","author":"Lyonel Kaufmann","date":"12 juin 2022","format":false,"excerpt":"En mars 2022, la version 6 de Zotero a introduit une s\u00e9rie de nouvelles fonctionnalit\u00e9s, y compris une toute nouvelle fa\u00e7on de travailler avec les PDF et les notes, qui transformeront la fa\u00e7on dont vous menez votre recherche. C'est probablement la principale nouveaut\u00e9 de cette version. Ouvrir les PDF dans\u2026","rel":"","context":"Dans "Humanit\u00e9s Digitales"","block_context":{"text":"Humanit\u00e9s Digitales","link":"https:\/\/lyonelkaufmann.ch\/histoire\/category\/humanites-digitales\/"},"img":{"alt_text":"","src":"https:\/\/i0.wp.com\/lyonelkaufmann.ch\/histoire\/wp-content\/uploads\/2022\/06\/pdf-reader-e1678961170517.jpg?fit=720%2C469&ssl=1&resize=350%2C200","width":350,"height":200,"srcset":"https:\/\/i0.wp.com\/lyonelkaufmann.ch\/histoire\/wp-content\/uploads\/2022\/06\/pdf-reader-e1678961170517.jpg?fit=720%2C469&ssl=1&resize=350%2C200 1x, https:\/\/i0.wp.com\/lyonelkaufmann.ch\/histoire\/wp-content\/uploads\/2022\/06\/pdf-reader-e1678961170517.jpg?fit=720%2C469&ssl=1&resize=525%2C300 1.5x, https:\/\/i0.wp.com\/lyonelkaufmann.ch\/histoire\/wp-content\/uploads\/2022\/06\/pdf-reader-e1678961170517.jpg?fit=720%2C469&ssl=1&resize=700%2C400 2x"},"classes":[]},{"id":4623,"url":"https:\/\/lyonelkaufmann.ch\/histoire\/2009\/04\/23\/reading-a-book-composed-entirely-of-excerpts-from\/","url_meta":{"origin":17900,"position":4},"title":"The View From Out There (washingtonpost.com) : compte-rendu de l’ouvrage de Dana Lindaman et Kyle Ward (2004).\u00a0How Textbooks from Around the World Portray U.S. History.\u00a0New Press. ISBN\u00a0978-1565848948","author":"Lyonel Kaufmann","date":"23 avril 2009","format":"quote","excerpt":"Reading a book composed entirely of excerpts from textbooks may seem an unpromising activity, but history texts reveal much about national perspectives and prejudices: They are more expressive than government pronouncements; they get into matters diplomats avoid; and yet, as the authors note, they are in varying degrees state-sanctioned and\u2026","rel":"","context":"Dans "Nouvelles de l'histoire"","block_context":{"text":"Nouvelles de l'histoire","link":"https:\/\/lyonelkaufmann.ch\/histoire\/category\/nouvelles-de-lhistoire\/"},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":248,"url":"https:\/\/lyonelkaufmann.ch\/histoire\/2007\/10\/29\/roy-rosenzweig-19502007\/","url_meta":{"origin":17900,"position":5},"title":"Roy Rosenzweig (1950—2007)","author":"Lyonel Kaufmann","date":"29 octobre 2007","format":false,"excerpt":"Roy Rosenzweig (1950\u20142007) Roy Rosenzweig n'est pas un historien fort connu dans nos contr\u00e9es. C'est dommage. Historien am\u00e9ricain, il est un des pionniers relativement \u00e0 l'histoire et l'utilisation des nouveaux m\u00e9dias. Ses pr\u00e9occupations portaient notamment sur la mise \u00e0 disposition de ressources historiques sous forme digitale (Digital history). Parmi ses\u2026","rel":"","context":"Dans "Histoire savante"","block_context":{"text":"Histoire savante","link":"https:\/\/lyonelkaufmann.ch\/histoire\/category\/didactique\/histoire-savante\/"},"img":{"alt_text":"","src":"https:\/\/i0.wp.com\/lyonelkaufmann.ch\/histoire\/wp-content\/uploads\/2015\/07\/158.jpg?fit=234%2C252&ssl=1&resize=350%2C200","width":350,"height":200},"classes":[]}],"_links":{"self":[{"href":"https:\/\/lyonelkaufmann.ch\/histoire\/wp-json\/wp\/v2\/posts\/17900","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lyonelkaufmann.ch\/histoire\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lyonelkaufmann.ch\/histoire\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lyonelkaufmann.ch\/histoire\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lyonelkaufmann.ch\/histoire\/wp-json\/wp\/v2\/comments?post=17900"}],"version-history":[{"count":0,"href":"https:\/\/lyonelkaufmann.ch\/histoire\/wp-json\/wp\/v2\/posts\/17900\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/lyonelkaufmann.ch\/histoire\/wp-json\/wp\/v2\/media\/17903"}],"wp:attachment":[{"href":"https:\/\/lyonelkaufmann.ch\/histoire\/wp-json\/wp\/v2\/media?parent=17900"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lyonelkaufmann.ch\/histoire\/wp-json\/wp\/v2\/categories?post=17900"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lyonelkaufmann.ch\/histoire\/wp-json\/wp\/v2\/tags?post=17900"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}