{"id":4,"date":"2022-05-03T16:31:43","date_gmt":"2022-05-03T14:31:43","guid":{"rendered":"https:\/\/e-publish.uliege.be\/markdown\/?p=4"},"modified":"2025-10-13T10:16:22","modified_gmt":"2025-10-13T08:16:22","slug":"introduction","status":"publish","type":"front-matter","link":"https:\/\/e-publish.uliege.be\/md\/front-matter\/introduction\/","title":{"raw":"Introduction","rendered":"Introduction"},"content":{"raw":"<div id=\"accueil\" class=\"level1\" data-number=\"1\">\r\n<div class=\"textbox\">\r\n<p class=\"book-header__description\"><strong>ATTENTION : Une <a href=\"https:\/\/e-publish.uliege.be\/md2\">nouvelle \u00e9dition<\/a> de cet ouvrage est publi\u00e9e sur cette m\u00eame plateforme depuis octobre 2025.<\/strong><\/p>\r\n\r\n<\/div>\r\n&nbsp;\r\n\r\nCe manuel est consacr\u00e9 \u00e0 l\u2019\u00e9criture acad\u00e9mique avec <em>Markdown<\/em> et <em>Pandoc<\/em>[footnote]Markdown est de plus en plus utilis\u00e9 par la communaut\u00e9 scientifique. Voir ce qu'en disent les contributeurs de Wikipedia&amp;nbsp: <a href=\"https:\/\/fr.wikipedia.org\/wiki\/Markdown\" target=\"_blank\" rel=\"noopener\">https:\/\/fr.wikipedia.org\/wiki\/Markdown<\/a>.[\/footnote]. Il propose une r\u00e9flexion sur nos outils et m\u00e9thodes d\u2019\u00e9criture acad\u00e9mique[footnote]<a href=\"https:\/\/www.arthurperret.fr\/cours\/2021-09-21-ecriture-academique-format-texte.html\" target=\"_blank\" rel=\"noopener\">https:\/\/www.arthurperret.fr\/cours\/2021-09-21-ecriture-academique-format-texte.html<\/a>[\/footnote].\r\n\r\nGr\u00e2ce \u00e0 la facilit\u00e9 et \u00e0 la puissance des formats num\u00e9riques ouverts (ici <em>Markdown<\/em>), ce manuel \u00e0 \u00e9t\u00e9 cr\u00e9\u00e9 \u00e0 partir du site Markdown &amp; vous[footnote]G\u00e9n\u00e9r\u00e9 avec le logiciel MKDocs, ce site a maintenant \u00e9t\u00e9 ferm\u00e9.[\/footnote].\r\n\r\nAvec le num\u00e9rique et ce qu\u2019il peut nous offrir mais aussi ce qu\u2019il a tendance \u00e0 nous imposer, il devient n\u00e9cessaire de s\u2019arr\u00eater un moment.\r\n<blockquote>\"La technologie nous promet de nous rendre libres en nous d\u00e9livrant de toutes les t\u00e2ches ennuyeuses, triviales, r\u00e9p\u00e9titives, purement mat\u00e9rielles, en nous fournissant des \u00ab\u00a0solutions\u00a0\u00bb de plus en plus performantes, simples, intuitives, rapides et efficaces. Les GAFAM nous font r\u00eaver d\u2019un monde qui fonctionne tout seul, d\u2019un monde o\u00f9 nous sommes pris\u00b7es en charge jusqu\u2019\u00e0 nos identit\u00e9s par un petit nombre de compagnies priv\u00e9es. Mais cette d\u00e9livrance se fait au prix d\u2019une perte totale d\u2019autonomie, avec une d\u00e9pendance compl\u00e8te \u00e0 ces technologies et \u00e0 ces entreprises. (<a href=\"https:\/\/e-publish.uliege.be\/md\/chapter\/sources#biblio\">Vitali-Rosati, 2024<\/a>)\"<\/blockquote>\r\nCette r\u00e9flexion est aliment\u00e9e par les principes :\r\n<ul>\r\n \t<li>de l\u2019\u00e9dition num\u00e9rique<\/li>\r\n \t<li>de la science ouverte<\/li>\r\n \t<li>de l\u2019\u00e9cologie num\u00e9rique et du d\u00e9veloppement durable<\/li>\r\n \t<li>de l\u2019ouverture et du d\u00e9cloisonnement entre pratiques.<\/li>\r\n<\/ul>\r\n<div id=\"\u00e9dition-num\u00e9rique\" class=\"level2\" data-number=\"1.1\">\r\n<h1 data-number=\"1.1\">\u00c9dition num\u00e9rique<\/h1>\r\nAvec les nouveaux modes de consultation (\u00e0 l\u2019\u00e9cran essentiellement), l\u2019\u00e9dition num\u00e9rique va au minimum produire des fichiers de type <em>html<\/em> (des pages web), <em>ePub<\/em> (cr\u00e9\u00e9s pour les liseuses \u00e9lectroniques) et <em>pdf<\/em> (entre autres pour une impression de qualit\u00e9).\r\n\r\nAlors que l\u2019\u00e9dition traditionnelle se concentre sur la qualit\u00e9 esth\u00e9tique du document et de la page imprim\u00e9e, l\u2019\u00e9dition num\u00e9rique va plut\u00f4t se concentrer sur la qualit\u00e9 des fichiers utilis\u00e9s pour la publication dans ses diff\u00e9rents formats (<a href=\"https:\/\/e-publish.uliege.be\/md\/chapter\/sources#biblio\" target=\"_blank\" rel=\"noopener\">Fauchi\u00e9, 2020<\/a>).\r\n\r\nCe changement de point focal permet de proposer des processus plus ouverts. Ils sont bas\u00e9s sur les principes du <em>Single Source Publishing<\/em> et utilisent un fichier unique (ou un ensemble de fichiers, comme pour ce manuel) pour produire un m\u00eame contenu dans diff\u00e9rents formats.\r\n\r\nLa d\u00e9marche de la publication num\u00e9rique consiste d\u00e8s lors \u00e0 remplacer une pseudo-structuration esth\u00e9tique (majuscules, tailles, gras, italiques, soulign\u00e9s ou styles al\u00e9atoires des traitements de texte pour signifier la structure d\u2019un texte) par une structuration s\u00e9mantique stricte permettant aux logiciels utilis\u00e9s de \u201ccomprendre\u201d la structure d\u2019un texte et de la r\u00e9percuter esth\u00e9tiquement et fonctionnellement.\r\n\r\nProduire un document <em>pdf<\/em> avec un traitement de texte (<em>Word<\/em>) ou avec un logiciel de mise en page (<em>InDesign<\/em>) n\u2019est donc pas de l\u2019\u00e9dition num\u00e9rique.\r\n\r\nL\u2019utilisation de fichiers au <a href=\"https:\/\/e-publish.uliege.be\/md\/chapter\/format-texte#texte\" target=\"_blank\" rel=\"noopener\">format \u201ctexte\u201d<\/a>, balis\u00e9s avec <em>Markdown<\/em> et transform\u00e9s avec <em>Pandoc<\/em>, repose sur le principe de l\u2019\u00e9dition num\u00e9rique. \u00c0 partir d\u2019une m\u00eame source (fichier(s)) cette m\u00e9thode permet de produire une grande quantit\u00e9 de formats de fichiers diff\u00e9rents[footnote]<a href=\"https:\/\/pandoc.org\/\" target=\"_blank\" rel=\"noopener\">https:\/\/pandoc.org\/<\/a>[\/footnote].\r\n\r\n<\/div>\r\n<div id=\"la-science-ouverte\" class=\"level2\" data-number=\"1.2\">\r\n<h1 data-number=\"1.2\">La science ouverte<\/h1>\r\nL\u2019UNESCO a publi\u00e9 en 2021 un rapport de synth\u00e8se de \u201cRecommandation de l\u2019UNESCO sur une science ouverte[footnote]<a href=\"https:\/\/unesdoc.unesco.org\/ark:\/48223\/pf0000379949_fre\" target=\"_blank\" rel=\"noopener\">https:\/\/unesdoc.unesco.org\/ark:\/48223\/pf0000379949_fre<\/a>[\/footnote]\" . Pour l\u2019UNESCO,\r\n<blockquote>\u201cla science ouverte s\u2019entend comme un concept inclusif qui englobe diff\u00e9rents mouvements et pratiques visant \u00e0 rendre les connaissances scientifiques multilingues, librement accessibles \u00e0 tous et r\u00e9utilisables par tous, \u00e0 renforcer la collaboration scientifique et le partage des informations au profit de la science et de la soci\u00e9t\u00e9, ainsi qu\u2019\u00e0 ouvrir les processus de cr\u00e9ation, d\u2019\u00e9valuation et de diffusion des connaissances scientifiques aux acteurs de la soci\u00e9t\u00e9 au-del\u00e0 de la communaut\u00e9 scientifique traditionnelle.<\/blockquote>\r\n<blockquote>Elle inclut toutes les disciplines scientifiques et tous les aspects des pratiques savantes, y compris les sciences fondamentales et appliqu\u00e9es, les sciences naturelles et les sciences sociales et humaines, et repose sur les piliers essentiels suivants&amp;nbsp: les connaissances scientifiques ouvertes\u00a0 les infrastructures de la science ouverte\u00a0 la communication scientifique\u00a0 la participation ouverte des acteurs de la soci\u00e9t\u00e9 et le dialogue ouvert avec les autres syst\u00e8mes de connaissances\u201d.\r\n\r\n[caption id=\"attachment_62\" align=\"aligncenter\" width=\"1288\"]<img class=\"wp-image-62 size-full\" src=\"https:\/\/e-publish.uliege.be\/md\/wp-content\/uploads\/sites\/15\/2023\/04\/file0-e1688282283765.png\" alt=\"\" width=\"1288\" height=\"1256\" \/> Les axes de la science ouverte[\/caption]<\/blockquote>\r\n<span style=\"text-align: initial;font-size: 1em\">En mati\u00e8re d\u2019\u00e9criture acad\u00e9mique, ces principes nous incitent \u00e0 ouvrir l\u2019ensemble de nos textes, dans des formats ouverts ind\u00e9pendamment des outils utilis\u00e9s.<\/span>\r\n\r\nAvec l\u2019usage de <em>Markdown<\/em>, ce sont \u00e9galement les outils qui sont ouverts, au del\u00e0 des formats eux-m\u00eames. Les logiciels libres sont d\u2019ailleurs un des axes de la science ouverte (figure ci-dessus).\r\n\r\n<\/div>\r\n<div id=\"\u00e9cologie-num\u00e9rique-et-du-d\u00e9veloppement-durable\" class=\"level2\" data-number=\"1.3\">\r\n<h1 data-number=\"1.3\">\u00c9cologie num\u00e9rique et d\u00e9veloppement durable<\/h1>\r\nLe d\u00e9veloppement durable[footnote]Voir&amp;nbsp: <a href=\"https:\/\/infolit.be\/site\/dd\/\" target=\"_blank\" rel=\"noopener\">https:\/\/infolit.be\/site\/dd\/<\/a>.[\/footnote] passe par l\u2019utilisation de logiciels ouverts et libres. Il int\u00e8gre l\u2019utilisateur dans une communaut\u00e9 durable sans attendre le bon vouloir des \u00e9diteurs propri\u00e9taires des produits et des services. L\u2019utilisation de logiciels libres r\u00e9duit la menace de l\u2019obsolescence pr\u00e9visible[footnote]<a href=\"https:\/\/interventions-numeriques.fr\/blog\/2017\/03\/18\/windows-lobsolescence-programmee\/\" target=\"_blank\" rel=\"noopener\">https:\/\/interventions-numeriques.fr\/blog\/2017\/03\/18\/windows-lobsolescence-programmee\/<\/a>[\/footnote] par d\u00e9faut de support sur le moyen terme et surtout l\u2019utilisation de technologies, n\u00e9cessitant toujours plus de puissance, qui raccourcissent la dur\u00e9e de vie du mat\u00e9riel qui reste lui aux mains de l\u2019industrie (<a href=\"https:\/\/e-publish.uliege.be\/md\/chapter\/sources#biblio\">European Union, 2021<\/a>).\r\n\r\nUtiliser <em>Markdown<\/em>, c\u2019est aussi revenir aux principes du <em>low-tech<\/em> et de la sobri\u00e9t\u00e9 num\u00e9rique (voir article <em>Humanit\u00e9s Num\u00e9riques<\/em>[footnote]<a href=\"https:\/\/doi.org\/10.4000\/revuehn.2858\" target=\"_blank\" rel=\"noopener\">https:\/\/doi.org\/10.4000\/revuehn.2858<\/a>[\/footnote] et GreenIT[footnote]<a href=\"https:\/\/www.greenit.fr\/2021\/12\/08\/numerique-40-du-budget-ges-soutenable-dun-europeen\/\" target=\"_blank\" rel=\"noopener\">https:\/\/www.greenit.fr\/2021\/12\/08\/numerique-40-du-budget-ges-soutenable-dun-europeen\/<\/a>[\/footnote]). Le mod\u00e8le propos\u00e9 dans ces pages permet de se passer de logiciels complexes et \u00e9nergivores. Il permet de revenir \u00e0 des m\u00e9thodes qui vont \u00e0 l\u2019essentiel en faisant les choses dans l\u2019ordre, \u00e9crire, illustrer, \u00e9diter puis publier, de mani\u00e8re durable et sans perte de temps et d\u2019\u00e9nergie inutiles.\r\n\r\n[caption id=\"attachment_63\" align=\"aligncenter\" width=\"1251\"]<img class=\"wp-image-63 size-full\" src=\"https:\/\/e-publish.uliege.be\/md\/wp-content\/uploads\/sites\/15\/2023\/04\/file1-e1688281935984.png\" alt=\"\" width=\"1251\" height=\"1209\" \/> Les neuf piliers du low-tech[\/caption]\r\n<h1>Ouverture (et non cloisonnement)<\/h1>\r\n<span style=\"font-weight: normal;text-align: initial;font-family: Lora, serif;font-size: 1em\">La cha\u00eene logicielle bas\u00e9e sur <\/span><em style=\"font-weight: normal;text-align: initial;font-family: Lora, serif;font-size: 1em\">Markdown<\/em><span style=\"font-weight: normal;text-align: initial;font-family: Lora, serif;font-size: 1em\"> et <\/span><em style=\"font-weight: normal;text-align: initial;font-family: Lora, serif;font-size: 1em\">Pandoc<\/em><span style=\"font-weight: normal;text-align: initial;font-family: Lora, serif;font-size: 1em\"> va r\u00e9pondre \u00e0 des objectifs de simplification, d\u2019ouverture, de qualit\u00e9 et de durabilit\u00e9.<\/span>\r\n\r\n<span style=\"font-weight: normal;text-align: initial;font-family: Lora, serif;font-size: 1em\">E<\/span>n premi\u00e8re analyse, on pourrait penser que, pour des questions de formats et de logiciels, ses utilisateurs vont se couper d\u2019un ensemble de r\u00e9seaux et de pratiques, qu\u2019ils ne vont pas pouvoir \u00e9changer avec des coll\u00e8gues qui travaillent de mani\u00e8re plus classique, avec un traitement de texte, qu\u2019ils ne vont pas pouvoir fournir leurs textes dans les formats exig\u00e9s par les \u00e9diteurs.\r\n\r\nIl n\u2019en est rien. L\u2019int\u00e9r\u00eat d\u2019associer <em>Pandoc<\/em> (un logiciel) avec <em>Markdown<\/em> (un format) dans la cha\u00eene logicielle facilite au contraire les \u00e9changes entre formats et donc entre acteurs. <em>Pandoc<\/em> peut \u00eatre install\u00e9 sur toutes les plateformes (<em>Windows, Mac<\/em>\u00a0ou <em>Linux<\/em>). Il peut \u201clire\u201d et aussi \u201cproduire\u201d des fichiers de traitement de texte (docx, odt\u2026). Lire \u00e0 ce propos le billet d\u2019Arthur Perret, <em>Markdown et traitement de texte&amp;nbsp: une m\u00e9thode pour collaborer<\/em>[footnote]<a href=\"https:\/\/www.arthurperret.fr\/blog\/2022-10-25-markdown-traitement-de-texte-methode-pour-collaborer.html\" target=\"_blank\" rel=\"noopener\">https:\/\/www.arthurperret.fr\/blog\/2022-10-25-markdown-traitement-de-texte-methode-pour-collaborer.html<\/a>[\/footnote].\r\n\r\nDes ajustements sont parfois n\u00e9cessaires mais le format et la m\u00e9thode ne sont jamais un obstacle aux \u00e9changes et \u00e0 la collaboration.\r\n\r\n<\/div>\r\n<div id=\"objectifs\" class=\"level2\" data-number=\"1.5\">\r\n<h1 data-number=\"1.5\">Objectifs<\/h1>\r\nCe manuel a en d\u00e9finitive plusieurs objectifs :\r\n<ul>\r\n \t<li>expliquer <a href=\"https:\/\/e-publish.uliege.be\/md\/chapter\/format-texte#texte\">pourquoi<\/a> il est possible de changer ses habitudes pour r\u00e9diger, structurer ses id\u00e9es, produire des documents de qualit\u00e9 ;<\/li>\r\n \t<li>expliquer comment utiliser <em>Markdown<\/em> et <em>Pandoc<\/em> pour la cr\u00e9ation de documents pdf professionnels ;<\/li>\r\n \t<li>montrer ce qui est possible avec <em>Markdown<\/em> et d\u00e9crire quelques m\u00e9thodes.<\/li>\r\n<\/ul>\r\nPour appuyer l\u2019int\u00e9r\u00eat de l\u2019utilisation de <em>Markdown<\/em>, un <a href=\"https:\/\/e-publish.uliege.be\/md\/chapter\/format-texte#separer\">chapitre<\/a> est consacr\u00e9e \u00e0 la n\u00e9cessaire structuration d\u2019un document et \u00e0 l\u2019imp\u00e9rative s\u00e9paration du fond et de la forme, \u00e0 toutes les \u00e9tapes de la r\u00e9daction d\u2019un document, que ce soit un article, un livre (sous diff\u00e9rents formats), un rapport, une th\u00e8se ou une pr\u00e9sentation (un chapitre est aussi consacr\u00e9 \u00e0 la cr\u00e9ation de pr\u00e9sentations professionnelles).\r\n\r\nCe manuel propose une introduction \u00e0 ces outils mais il n\u2019en est pas pour autant limit\u00e9 aux seuls d\u00e9butants. L\u2019id\u00e9e est de revenir aux fondamentaux et donc de ne pas essayer de reproduire co\u00fbte que co\u00fbte tout ce qui est possible avec un traitement de texte classique (dont on peut se passer). Si la solution est en d\u00e9finitive trop complexe, le choix de <em>Markdown<\/em> n\u2019a plus beaucoup de sens.\r\n<div class=\"textbox\">\r\n\r\nPour ceux qui veulent n\u00e9anmoins aller plus loin, des commandes suppl\u00e9mentaires et des pistes sont propos\u00e9es dans le chapitre <a href=\"https:\/\/e-publish.uliege.be\/md\/chapter\/sources#plus\">Sources<\/a> et dans un <a href=\"https:\/\/opensolution.be\/mv2\/\" target=\"_blank\" rel=\"noopener\">\"site compagnon\"<\/a>.\r\n\r\n<\/div>\r\n&nbsp;\r\n\r\n<\/div>\r\n<\/div>","rendered":"<div id=\"accueil\" class=\"level1\" data-number=\"1\">\n<div class=\"textbox\">\n<p class=\"book-header__description\"><strong>ATTENTION : Une <a href=\"https:\/\/e-publish.uliege.be\/md2\">nouvelle \u00e9dition<\/a> de cet ouvrage est publi\u00e9e sur cette m\u00eame plateforme depuis octobre 2025.<\/strong><\/p>\n<\/div>\n<p>&nbsp;<\/p>\n<p>Ce manuel est consacr\u00e9 \u00e0 l\u2019\u00e9criture acad\u00e9mique avec <em>Markdown<\/em> et <em>Pandoc<\/em><a class=\"footnote\" title=\"Markdown est de plus en plus utilis\u00e9 par la communaut\u00e9 scientifique. Voir ce qu'en disent les contributeurs de Wikipedia&amp;nbsp: https:\/\/fr.wikipedia.org\/wiki\/Markdown.\" id=\"return-footnote-4-1\" href=\"#footnote-4-1\" aria-label=\"Footnote 1\"><sup class=\"footnote\">[1]<\/sup><\/a>. Il propose une r\u00e9flexion sur nos outils et m\u00e9thodes d\u2019\u00e9criture acad\u00e9mique<a class=\"footnote\" title=\"https:\/\/www.arthurperret.fr\/cours\/2021-09-21-ecriture-academique-format-texte.html\" id=\"return-footnote-4-2\" href=\"#footnote-4-2\" aria-label=\"Footnote 2\"><sup class=\"footnote\">[2]<\/sup><\/a>.<\/p>\n<p>Gr\u00e2ce \u00e0 la facilit\u00e9 et \u00e0 la puissance des formats num\u00e9riques ouverts (ici <em>Markdown<\/em>), ce manuel \u00e0 \u00e9t\u00e9 cr\u00e9\u00e9 \u00e0 partir du site Markdown &amp; vous<a class=\"footnote\" title=\"G\u00e9n\u00e9r\u00e9 avec le logiciel MKDocs, ce site a maintenant \u00e9t\u00e9 ferm\u00e9.\" id=\"return-footnote-4-3\" href=\"#footnote-4-3\" aria-label=\"Footnote 3\"><sup class=\"footnote\">[3]<\/sup><\/a>.<\/p>\n<p>Avec le num\u00e9rique et ce qu\u2019il peut nous offrir mais aussi ce qu\u2019il a tendance \u00e0 nous imposer, il devient n\u00e9cessaire de s\u2019arr\u00eater un moment.<\/p>\n<blockquote><p>\u00ab\u00a0La technologie nous promet de nous rendre libres en nous d\u00e9livrant de toutes les t\u00e2ches ennuyeuses, triviales, r\u00e9p\u00e9titives, purement mat\u00e9rielles, en nous fournissant des \u00ab\u00a0solutions\u00a0\u00bb de plus en plus performantes, simples, intuitives, rapides et efficaces. Les GAFAM nous font r\u00eaver d\u2019un monde qui fonctionne tout seul, d\u2019un monde o\u00f9 nous sommes pris\u00b7es en charge jusqu\u2019\u00e0 nos identit\u00e9s par un petit nombre de compagnies priv\u00e9es. Mais cette d\u00e9livrance se fait au prix d\u2019une perte totale d\u2019autonomie, avec une d\u00e9pendance compl\u00e8te \u00e0 ces technologies et \u00e0 ces entreprises. (<a href=\"https:\/\/e-publish.uliege.be\/md\/chapter\/sources#biblio\">Vitali-Rosati, 2024<\/a>)\u00a0\u00bb<\/p><\/blockquote>\n<p>Cette r\u00e9flexion est aliment\u00e9e par les principes :<\/p>\n<ul>\n<li>de l\u2019\u00e9dition num\u00e9rique<\/li>\n<li>de la science ouverte<\/li>\n<li>de l\u2019\u00e9cologie num\u00e9rique et du d\u00e9veloppement durable<\/li>\n<li>de l\u2019ouverture et du d\u00e9cloisonnement entre pratiques.<\/li>\n<\/ul>\n<div id=\"\u00e9dition-num\u00e9rique\" class=\"level2\" data-number=\"1.1\">\n<h1 data-number=\"1.1\">\u00c9dition num\u00e9rique<\/h1>\n<p>Avec les nouveaux modes de consultation (\u00e0 l\u2019\u00e9cran essentiellement), l\u2019\u00e9dition num\u00e9rique va au minimum produire des fichiers de type <em>html<\/em> (des pages web), <em>ePub<\/em> (cr\u00e9\u00e9s pour les liseuses \u00e9lectroniques) et <em>pdf<\/em> (entre autres pour une impression de qualit\u00e9).<\/p>\n<p>Alors que l\u2019\u00e9dition traditionnelle se concentre sur la qualit\u00e9 esth\u00e9tique du document et de la page imprim\u00e9e, l\u2019\u00e9dition num\u00e9rique va plut\u00f4t se concentrer sur la qualit\u00e9 des fichiers utilis\u00e9s pour la publication dans ses diff\u00e9rents formats (<a href=\"https:\/\/e-publish.uliege.be\/md\/chapter\/sources#biblio\" target=\"_blank\" rel=\"noopener\">Fauchi\u00e9, 2020<\/a>).<\/p>\n<p>Ce changement de point focal permet de proposer des processus plus ouverts. Ils sont bas\u00e9s sur les principes du <em>Single Source Publishing<\/em> et utilisent un fichier unique (ou un ensemble de fichiers, comme pour ce manuel) pour produire un m\u00eame contenu dans diff\u00e9rents formats.<\/p>\n<p>La d\u00e9marche de la publication num\u00e9rique consiste d\u00e8s lors \u00e0 remplacer une pseudo-structuration esth\u00e9tique (majuscules, tailles, gras, italiques, soulign\u00e9s ou styles al\u00e9atoires des traitements de texte pour signifier la structure d\u2019un texte) par une structuration s\u00e9mantique stricte permettant aux logiciels utilis\u00e9s de \u201ccomprendre\u201d la structure d\u2019un texte et de la r\u00e9percuter esth\u00e9tiquement et fonctionnellement.<\/p>\n<p>Produire un document <em>pdf<\/em> avec un traitement de texte (<em>Word<\/em>) ou avec un logiciel de mise en page (<em>InDesign<\/em>) n\u2019est donc pas de l\u2019\u00e9dition num\u00e9rique.<\/p>\n<p>L\u2019utilisation de fichiers au <a href=\"https:\/\/e-publish.uliege.be\/md\/chapter\/format-texte#texte\" target=\"_blank\" rel=\"noopener\">format \u201ctexte\u201d<\/a>, balis\u00e9s avec <em>Markdown<\/em> et transform\u00e9s avec <em>Pandoc<\/em>, repose sur le principe de l\u2019\u00e9dition num\u00e9rique. \u00c0 partir d\u2019une m\u00eame source (fichier(s)) cette m\u00e9thode permet de produire une grande quantit\u00e9 de formats de fichiers diff\u00e9rents<a class=\"footnote\" title=\"https:\/\/pandoc.org\/\" id=\"return-footnote-4-4\" href=\"#footnote-4-4\" aria-label=\"Footnote 4\"><sup class=\"footnote\">[4]<\/sup><\/a>.<\/p>\n<\/div>\n<div id=\"la-science-ouverte\" class=\"level2\" data-number=\"1.2\">\n<h1 data-number=\"1.2\">La science ouverte<\/h1>\n<p>L\u2019UNESCO a publi\u00e9 en 2021 un rapport de synth\u00e8se de \u201cRecommandation de l\u2019UNESCO sur une science ouverte<a class=\"footnote\" title=\"https:\/\/unesdoc.unesco.org\/ark:\/48223\/pf0000379949_fre\" id=\"return-footnote-4-5\" href=\"#footnote-4-5\" aria-label=\"Footnote 5\"><sup class=\"footnote\">[5]<\/sup><\/a>\u00a0\u00bb . Pour l\u2019UNESCO,<\/p>\n<blockquote><p>\u201cla science ouverte s\u2019entend comme un concept inclusif qui englobe diff\u00e9rents mouvements et pratiques visant \u00e0 rendre les connaissances scientifiques multilingues, librement accessibles \u00e0 tous et r\u00e9utilisables par tous, \u00e0 renforcer la collaboration scientifique et le partage des informations au profit de la science et de la soci\u00e9t\u00e9, ainsi qu\u2019\u00e0 ouvrir les processus de cr\u00e9ation, d\u2019\u00e9valuation et de diffusion des connaissances scientifiques aux acteurs de la soci\u00e9t\u00e9 au-del\u00e0 de la communaut\u00e9 scientifique traditionnelle.<\/p><\/blockquote>\n<blockquote><p>Elle inclut toutes les disciplines scientifiques et tous les aspects des pratiques savantes, y compris les sciences fondamentales et appliqu\u00e9es, les sciences naturelles et les sciences sociales et humaines, et repose sur les piliers essentiels suivants&amp;nbsp: les connaissances scientifiques ouvertes\u00a0 les infrastructures de la science ouverte\u00a0 la communication scientifique\u00a0 la participation ouverte des acteurs de la soci\u00e9t\u00e9 et le dialogue ouvert avec les autres syst\u00e8mes de connaissances\u201d.<\/p>\n<figure id=\"attachment_62\" aria-describedby=\"caption-attachment-62\" style=\"width: 1288px\" class=\"wp-caption aligncenter\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-62 size-full\" src=\"https:\/\/e-publish.uliege.be\/md\/wp-content\/uploads\/sites\/15\/2023\/04\/file0-e1688282283765.png\" alt=\"\" width=\"1288\" height=\"1256\" srcset=\"https:\/\/e-publish.uliege.be\/md\/wp-content\/uploads\/sites\/15\/2023\/04\/file0-e1688282283765.png 1288w, https:\/\/e-publish.uliege.be\/md\/wp-content\/uploads\/sites\/15\/2023\/04\/file0-e1688282283765-300x293.png 300w, https:\/\/e-publish.uliege.be\/md\/wp-content\/uploads\/sites\/15\/2023\/04\/file0-e1688282283765-1024x999.png 1024w, https:\/\/e-publish.uliege.be\/md\/wp-content\/uploads\/sites\/15\/2023\/04\/file0-e1688282283765-768x749.png 768w, https:\/\/e-publish.uliege.be\/md\/wp-content\/uploads\/sites\/15\/2023\/04\/file0-e1688282283765-65x63.png 65w, https:\/\/e-publish.uliege.be\/md\/wp-content\/uploads\/sites\/15\/2023\/04\/file0-e1688282283765-225x219.png 225w, https:\/\/e-publish.uliege.be\/md\/wp-content\/uploads\/sites\/15\/2023\/04\/file0-e1688282283765-350x341.png 350w\" sizes=\"(max-width: 1288px) 100vw, 1288px\" \/><figcaption id=\"caption-attachment-62\" class=\"wp-caption-text\">Les axes de la science ouverte<\/figcaption><\/figure>\n<\/blockquote>\n<p><span style=\"text-align: initial;font-size: 1em\">En mati\u00e8re d\u2019\u00e9criture acad\u00e9mique, ces principes nous incitent \u00e0 ouvrir l\u2019ensemble de nos textes, dans des formats ouverts ind\u00e9pendamment des outils utilis\u00e9s.<\/span><\/p>\n<p>Avec l\u2019usage de <em>Markdown<\/em>, ce sont \u00e9galement les outils qui sont ouverts, au del\u00e0 des formats eux-m\u00eames. Les logiciels libres sont d\u2019ailleurs un des axes de la science ouverte (figure ci-dessus).<\/p>\n<\/div>\n<div id=\"\u00e9cologie-num\u00e9rique-et-du-d\u00e9veloppement-durable\" class=\"level2\" data-number=\"1.3\">\n<h1 data-number=\"1.3\">\u00c9cologie num\u00e9rique et d\u00e9veloppement durable<\/h1>\n<p>Le d\u00e9veloppement durable<a class=\"footnote\" title=\"Voir&amp;nbsp: https:\/\/infolit.be\/site\/dd\/.\" id=\"return-footnote-4-6\" href=\"#footnote-4-6\" aria-label=\"Footnote 6\"><sup class=\"footnote\">[6]<\/sup><\/a> passe par l\u2019utilisation de logiciels ouverts et libres. Il int\u00e8gre l\u2019utilisateur dans une communaut\u00e9 durable sans attendre le bon vouloir des \u00e9diteurs propri\u00e9taires des produits et des services. L\u2019utilisation de logiciels libres r\u00e9duit la menace de l\u2019obsolescence pr\u00e9visible<a class=\"footnote\" title=\"https:\/\/interventions-numeriques.fr\/blog\/2017\/03\/18\/windows-lobsolescence-programmee\/\" id=\"return-footnote-4-7\" href=\"#footnote-4-7\" aria-label=\"Footnote 7\"><sup class=\"footnote\">[7]<\/sup><\/a> par d\u00e9faut de support sur le moyen terme et surtout l\u2019utilisation de technologies, n\u00e9cessitant toujours plus de puissance, qui raccourcissent la dur\u00e9e de vie du mat\u00e9riel qui reste lui aux mains de l\u2019industrie (<a href=\"https:\/\/e-publish.uliege.be\/md\/chapter\/sources#biblio\">European Union, 2021<\/a>).<\/p>\n<p>Utiliser <em>Markdown<\/em>, c\u2019est aussi revenir aux principes du <em>low-tech<\/em> et de la sobri\u00e9t\u00e9 num\u00e9rique (voir article <em>Humanit\u00e9s Num\u00e9riques<\/em><a class=\"footnote\" title=\"https:\/\/doi.org\/10.4000\/revuehn.2858\" id=\"return-footnote-4-8\" href=\"#footnote-4-8\" aria-label=\"Footnote 8\"><sup class=\"footnote\">[8]<\/sup><\/a> et GreenIT<a class=\"footnote\" title=\"https:\/\/www.greenit.fr\/2021\/12\/08\/numerique-40-du-budget-ges-soutenable-dun-europeen\/\" id=\"return-footnote-4-9\" href=\"#footnote-4-9\" aria-label=\"Footnote 9\"><sup class=\"footnote\">[9]<\/sup><\/a>). Le mod\u00e8le propos\u00e9 dans ces pages permet de se passer de logiciels complexes et \u00e9nergivores. Il permet de revenir \u00e0 des m\u00e9thodes qui vont \u00e0 l\u2019essentiel en faisant les choses dans l\u2019ordre, \u00e9crire, illustrer, \u00e9diter puis publier, de mani\u00e8re durable et sans perte de temps et d\u2019\u00e9nergie inutiles.<\/p>\n<figure id=\"attachment_63\" aria-describedby=\"caption-attachment-63\" style=\"width: 1251px\" class=\"wp-caption aligncenter\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-63 size-full\" src=\"https:\/\/e-publish.uliege.be\/md\/wp-content\/uploads\/sites\/15\/2023\/04\/file1-e1688281935984.png\" alt=\"\" width=\"1251\" height=\"1209\" srcset=\"https:\/\/e-publish.uliege.be\/md\/wp-content\/uploads\/sites\/15\/2023\/04\/file1-e1688281935984.png 1251w, https:\/\/e-publish.uliege.be\/md\/wp-content\/uploads\/sites\/15\/2023\/04\/file1-e1688281935984-300x290.png 300w, https:\/\/e-publish.uliege.be\/md\/wp-content\/uploads\/sites\/15\/2023\/04\/file1-e1688281935984-1024x990.png 1024w, https:\/\/e-publish.uliege.be\/md\/wp-content\/uploads\/sites\/15\/2023\/04\/file1-e1688281935984-768x742.png 768w, https:\/\/e-publish.uliege.be\/md\/wp-content\/uploads\/sites\/15\/2023\/04\/file1-e1688281935984-65x63.png 65w, https:\/\/e-publish.uliege.be\/md\/wp-content\/uploads\/sites\/15\/2023\/04\/file1-e1688281935984-225x217.png 225w, https:\/\/e-publish.uliege.be\/md\/wp-content\/uploads\/sites\/15\/2023\/04\/file1-e1688281935984-350x338.png 350w\" sizes=\"(max-width: 1251px) 100vw, 1251px\" \/><figcaption id=\"caption-attachment-63\" class=\"wp-caption-text\">Les neuf piliers du low-tech<\/figcaption><\/figure>\n<h1>Ouverture (et non cloisonnement)<\/h1>\n<p><span style=\"font-weight: normal;text-align: initial;font-family: Lora, serif;font-size: 1em\">La cha\u00eene logicielle bas\u00e9e sur <\/span><em style=\"font-weight: normal;text-align: initial;font-family: Lora, serif;font-size: 1em\">Markdown<\/em><span style=\"font-weight: normal;text-align: initial;font-family: Lora, serif;font-size: 1em\"> et <\/span><em style=\"font-weight: normal;text-align: initial;font-family: Lora, serif;font-size: 1em\">Pandoc<\/em><span style=\"font-weight: normal;text-align: initial;font-family: Lora, serif;font-size: 1em\"> va r\u00e9pondre \u00e0 des objectifs de simplification, d\u2019ouverture, de qualit\u00e9 et de durabilit\u00e9.<\/span><\/p>\n<p><span style=\"font-weight: normal;text-align: initial;font-family: Lora, serif;font-size: 1em\">E<\/span>n premi\u00e8re analyse, on pourrait penser que, pour des questions de formats et de logiciels, ses utilisateurs vont se couper d\u2019un ensemble de r\u00e9seaux et de pratiques, qu\u2019ils ne vont pas pouvoir \u00e9changer avec des coll\u00e8gues qui travaillent de mani\u00e8re plus classique, avec un traitement de texte, qu\u2019ils ne vont pas pouvoir fournir leurs textes dans les formats exig\u00e9s par les \u00e9diteurs.<\/p>\n<p>Il n\u2019en est rien. L\u2019int\u00e9r\u00eat d\u2019associer <em>Pandoc<\/em> (un logiciel) avec <em>Markdown<\/em> (un format) dans la cha\u00eene logicielle facilite au contraire les \u00e9changes entre formats et donc entre acteurs. <em>Pandoc<\/em> peut \u00eatre install\u00e9 sur toutes les plateformes (<em>Windows, Mac<\/em>\u00a0ou <em>Linux<\/em>). Il peut \u201clire\u201d et aussi \u201cproduire\u201d des fichiers de traitement de texte (docx, odt\u2026). Lire \u00e0 ce propos le billet d\u2019Arthur Perret, <em>Markdown et traitement de texte&amp;nbsp: une m\u00e9thode pour collaborer<\/em><a class=\"footnote\" title=\"https:\/\/www.arthurperret.fr\/blog\/2022-10-25-markdown-traitement-de-texte-methode-pour-collaborer.html\" id=\"return-footnote-4-10\" href=\"#footnote-4-10\" aria-label=\"Footnote 10\"><sup class=\"footnote\">[10]<\/sup><\/a>.<\/p>\n<p>Des ajustements sont parfois n\u00e9cessaires mais le format et la m\u00e9thode ne sont jamais un obstacle aux \u00e9changes et \u00e0 la collaboration.<\/p>\n<\/div>\n<div id=\"objectifs\" class=\"level2\" data-number=\"1.5\">\n<h1 data-number=\"1.5\">Objectifs<\/h1>\n<p>Ce manuel a en d\u00e9finitive plusieurs objectifs :<\/p>\n<ul>\n<li>expliquer <a href=\"https:\/\/e-publish.uliege.be\/md\/chapter\/format-texte#texte\">pourquoi<\/a> il est possible de changer ses habitudes pour r\u00e9diger, structurer ses id\u00e9es, produire des documents de qualit\u00e9 ;<\/li>\n<li>expliquer comment utiliser <em>Markdown<\/em> et <em>Pandoc<\/em> pour la cr\u00e9ation de documents pdf professionnels ;<\/li>\n<li>montrer ce qui est possible avec <em>Markdown<\/em> et d\u00e9crire quelques m\u00e9thodes.<\/li>\n<\/ul>\n<p>Pour appuyer l\u2019int\u00e9r\u00eat de l\u2019utilisation de <em>Markdown<\/em>, un <a href=\"https:\/\/e-publish.uliege.be\/md\/chapter\/format-texte#separer\">chapitre<\/a> est consacr\u00e9e \u00e0 la n\u00e9cessaire structuration d\u2019un document et \u00e0 l\u2019imp\u00e9rative s\u00e9paration du fond et de la forme, \u00e0 toutes les \u00e9tapes de la r\u00e9daction d\u2019un document, que ce soit un article, un livre (sous diff\u00e9rents formats), un rapport, une th\u00e8se ou une pr\u00e9sentation (un chapitre est aussi consacr\u00e9 \u00e0 la cr\u00e9ation de pr\u00e9sentations professionnelles).<\/p>\n<p>Ce manuel propose une introduction \u00e0 ces outils mais il n\u2019en est pas pour autant limit\u00e9 aux seuls d\u00e9butants. L\u2019id\u00e9e est de revenir aux fondamentaux et donc de ne pas essayer de reproduire co\u00fbte que co\u00fbte tout ce qui est possible avec un traitement de texte classique (dont on peut se passer). Si la solution est en d\u00e9finitive trop complexe, le choix de <em>Markdown<\/em> n\u2019a plus beaucoup de sens.<\/p>\n<div class=\"textbox\">\n<p>Pour ceux qui veulent n\u00e9anmoins aller plus loin, des commandes suppl\u00e9mentaires et des pistes sont propos\u00e9es dans le chapitre <a href=\"https:\/\/e-publish.uliege.be\/md\/chapter\/sources#plus\">Sources<\/a> et dans un <a href=\"https:\/\/opensolution.be\/mv2\/\" target=\"_blank\" rel=\"noopener\">\u00ab\u00a0site compagnon\u00a0\u00bb<\/a>.<\/p>\n<\/div>\n<p>&nbsp;<\/p>\n<\/div>\n<\/div>\n<hr class=\"before-footnotes clear\" \/><div class=\"footnotes\"><ol><li id=\"footnote-4-1\">Markdown est de plus en plus utilis\u00e9 par la communaut\u00e9 scientifique. Voir ce qu'en disent les contributeurs de Wikipedia&amp;nbsp: <a href=\"https:\/\/fr.wikipedia.org\/wiki\/Markdown\" target=\"_blank\" rel=\"noopener\">https:\/\/fr.wikipedia.org\/wiki\/Markdown<\/a>. <a href=\"#return-footnote-4-1\" class=\"return-footnote\" aria-label=\"Return to footnote 1\">&crarr;<\/a><\/li><li id=\"footnote-4-2\"><a href=\"https:\/\/www.arthurperret.fr\/cours\/2021-09-21-ecriture-academique-format-texte.html\" target=\"_blank\" rel=\"noopener\">https:\/\/www.arthurperret.fr\/cours\/2021-09-21-ecriture-academique-format-texte.html<\/a> <a href=\"#return-footnote-4-2\" class=\"return-footnote\" aria-label=\"Return to footnote 2\">&crarr;<\/a><\/li><li id=\"footnote-4-3\">G\u00e9n\u00e9r\u00e9 avec le logiciel MKDocs, ce site a maintenant \u00e9t\u00e9 ferm\u00e9. <a href=\"#return-footnote-4-3\" class=\"return-footnote\" aria-label=\"Return to footnote 3\">&crarr;<\/a><\/li><li id=\"footnote-4-4\"><a href=\"https:\/\/pandoc.org\/\" target=\"_blank\" rel=\"noopener\">https:\/\/pandoc.org\/<\/a> <a href=\"#return-footnote-4-4\" class=\"return-footnote\" aria-label=\"Return to footnote 4\">&crarr;<\/a><\/li><li id=\"footnote-4-5\"><a href=\"https:\/\/unesdoc.unesco.org\/ark:\/48223\/pf0000379949_fre\" target=\"_blank\" rel=\"noopener\">https:\/\/unesdoc.unesco.org\/ark:\/48223\/pf0000379949_fre<\/a> <a href=\"#return-footnote-4-5\" class=\"return-footnote\" aria-label=\"Return to footnote 5\">&crarr;<\/a><\/li><li id=\"footnote-4-6\">Voir&amp;nbsp: <a href=\"https:\/\/infolit.be\/site\/dd\/\" target=\"_blank\" rel=\"noopener\">https:\/\/infolit.be\/site\/dd\/<\/a>. <a href=\"#return-footnote-4-6\" class=\"return-footnote\" aria-label=\"Return to footnote 6\">&crarr;<\/a><\/li><li id=\"footnote-4-7\"><a href=\"https:\/\/interventions-numeriques.fr\/blog\/2017\/03\/18\/windows-lobsolescence-programmee\/\" target=\"_blank\" rel=\"noopener\">https:\/\/interventions-numeriques.fr\/blog\/2017\/03\/18\/windows-lobsolescence-programmee\/<\/a> <a href=\"#return-footnote-4-7\" class=\"return-footnote\" aria-label=\"Return to footnote 7\">&crarr;<\/a><\/li><li id=\"footnote-4-8\"><a href=\"https:\/\/doi.org\/10.4000\/revuehn.2858\" target=\"_blank\" rel=\"noopener\">https:\/\/doi.org\/10.4000\/revuehn.2858<\/a> <a href=\"#return-footnote-4-8\" class=\"return-footnote\" aria-label=\"Return to footnote 8\">&crarr;<\/a><\/li><li id=\"footnote-4-9\"><a href=\"https:\/\/www.greenit.fr\/2021\/12\/08\/numerique-40-du-budget-ges-soutenable-dun-europeen\/\" target=\"_blank\" rel=\"noopener\">https:\/\/www.greenit.fr\/2021\/12\/08\/numerique-40-du-budget-ges-soutenable-dun-europeen\/<\/a> <a href=\"#return-footnote-4-9\" class=\"return-footnote\" aria-label=\"Return to footnote 9\">&crarr;<\/a><\/li><li id=\"footnote-4-10\"><a href=\"https:\/\/www.arthurperret.fr\/blog\/2022-10-25-markdown-traitement-de-texte-methode-pour-collaborer.html\" target=\"_blank\" rel=\"noopener\">https:\/\/www.arthurperret.fr\/blog\/2022-10-25-markdown-traitement-de-texte-methode-pour-collaborer.html<\/a> <a href=\"#return-footnote-4-10\" class=\"return-footnote\" aria-label=\"Return to footnote 10\">&crarr;<\/a><\/li><\/ol><\/div>","protected":false},"author":1,"menu_order":2,"template":"","meta":{"pb_show_title":"on","pb_short_title":"","pb_subtitle":"","pb_authors":[],"pb_section_license":""},"front-matter-type":[13],"contributor":[],"license":[],"class_list":["post-4","front-matter","type-front-matter","status-publish","hentry","front-matter-type-introduction"],"_links":{"self":[{"href":"https:\/\/e-publish.uliege.be\/md\/wp-json\/pressbooks\/v2\/front-matter\/4"}],"collection":[{"href":"https:\/\/e-publish.uliege.be\/md\/wp-json\/pressbooks\/v2\/front-matter"}],"about":[{"href":"https:\/\/e-publish.uliege.be\/md\/wp-json\/wp\/v2\/types\/front-matter"}],"author":[{"embeddable":true,"href":"https:\/\/e-publish.uliege.be\/md\/wp-json\/wp\/v2\/users\/1"}],"version-history":[{"count":47,"href":"https:\/\/e-publish.uliege.be\/md\/wp-json\/pressbooks\/v2\/front-matter\/4\/revisions"}],"predecessor-version":[{"id":552,"href":"https:\/\/e-publish.uliege.be\/md\/wp-json\/pressbooks\/v2\/front-matter\/4\/revisions\/552"}],"metadata":[{"href":"https:\/\/e-publish.uliege.be\/md\/wp-json\/pressbooks\/v2\/front-matter\/4\/metadata\/"}],"wp:attachment":[{"href":"https:\/\/e-publish.uliege.be\/md\/wp-json\/wp\/v2\/media?parent=4"}],"wp:term":[{"taxonomy":"front-matter-type","embeddable":true,"href":"https:\/\/e-publish.uliege.be\/md\/wp-json\/pressbooks\/v2\/front-matter-type?post=4"},{"taxonomy":"contributor","embeddable":true,"href":"https:\/\/e-publish.uliege.be\/md\/wp-json\/wp\/v2\/contributor?post=4"},{"taxonomy":"license","embeddable":true,"href":"https:\/\/e-publish.uliege.be\/md\/wp-json\/wp\/v2\/license?post=4"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}