{"id":111,"date":"2023-04-06T11:36:21","date_gmt":"2023-04-06T09:36:21","guid":{"rendered":"https:\/\/e-publish.uliege.be\/md\/?post_type=back-matter&p=111"},"modified":"2024-10-30T10:10:12","modified_gmt":"2024-10-30T09:10:12","slug":"a-propos","status":"publish","type":"back-matter","link":"https:\/\/e-publish.uliege.be\/md\/back-matter\/a-propos\/","title":{"raw":"\u00c0 propos","rendered":"\u00c0 propos"},"content":{"raw":"
\r\n
\r\n

Construction du site (et du manuel)<\/h1>\r\nPour le site qui a pr\u00e9c\u00e9d\u00e9 ce manuel, toutes les pages ont \u00e9t\u00e9 r\u00e9dig\u00e9es en Markdown<\/em> et mises en ligne gr\u00e2ce \u00e0 MKDocs<\/em>[footnote]https:\/\/www.mkdocs.org\/<\/a>[\/footnote], logiciel permettant de cr\u00e9er de fa\u00e7on simple et rapide des sites Web statiques[footnote]https:\/\/frank.taillandier.me\/2016\/03\/08\/les-gestionnaires-de-contenu-statique\/<\/a>[\/footnote].\r\n\r\nPour la version \"manuel\", c'est la plateforme e-publish[footnote]https:\/\/e-publish.uliege.be<\/a>[\/footnote] qui a \u00e9t\u00e9 utilis\u00e9e par importation de la version ePub du site web.\r\n
\r\n

R\u00e9flexions et chemin personnel<\/h2>\r\nCe manuel est enti\u00e8rement consacr\u00e9 \u00e0 l\u2019utilisation de Markdown<\/em> pour la r\u00e9daction et la production de documents acad\u00e9miques de qualit\u00e9.\r\n\r\nHabitu\u00e9 \u00e0 la r\u00e9daction structur\u00e9e depuis plus de 15 ans (plusieurs documents r\u00e9dig\u00e9s au format XML-Docbook<\/em> avec oXygen<\/em>), la d\u00e9couverte de Markdown<\/em> est plus r\u00e9cente et date de fin 2017. Lors de la recherche d\u2019un outil \u201cdistraction free<\/em>\u201d pour r\u00e9diger un article, Typora<\/em> est apparu comme une \u00e9vidence. Le format d\u2019enregistrement des fichiers de Typora<\/em> est Markdown<\/em> et donc Markdown<\/em> est \u00e9galement apparu comme une \u00e9vidence.\r\n\r\nApr\u00e8s avoir r\u00e9dig\u00e9 un premier billet sur infolit.be, deux petits tutoriels (Cr\u00e9er des documents professionnels avec Markdown et Pandoc. L\u2019\u00e9criture num\u00e9rique ouverte[footnote]https:\/\/orbi.uliege.be\/handle\/2268\/255717<\/a>[\/footnote] et Cr\u00e9er des pr\u00e9sentations avec Markdown, Beamer et Pandoc[footnote]https:\/\/orbi.uliege.be\/handle\/2268\/255718<\/a>[\/footnote]) ont rapidement suivi.\r\n\r\n\u00c9tant donn\u00e9 qu\u2019il n\u2019est pas simple de trouver une source francophone compl\u00e8te \u00e0 propos de Markdown<\/em>, il semblait n\u00e9cessaire de proposer ce site Web, \u00e0 la fois plaidoyer et petit manuel \u00e0 l\u2019usage des d\u00e9butants pour d\u00e9couvrir, comprendre et utiliser Markdown<\/em>. L\u2019ensemble des contenus est bas\u00e9 sur ma propre exp\u00e9rience et sur les diverses d\u00e9couvertes, aliment\u00e9es par mes besoins de trouver des solutions pragmatiques, \u00e0 propos de Markdown<\/em>.\r\n\r\nJe ne suis pas un geek<\/em> et les limites de mon utilisation de Markdown<\/em> sont bas\u00e9es sur le niveau de complexit\u00e9. Il est possible d\u2019aller tr\u00e8s loin avec des commandes et options moins accessibles. Le principe de base de cette pr\u00e9sentation est que l\u2019utilisation de Markdown<\/em> pour la cr\u00e9ation de documents professionnels reste simple.\r\n\r\nBernard Pochet<\/a>\r\n\r\n<\/div>\r\n<\/div>\r\n
<\/div>\r\n<\/div>","rendered":"
\n
\n

Construction du site (et du manuel)<\/h1>\n

Pour le site qui a pr\u00e9c\u00e9d\u00e9 ce manuel, toutes les pages ont \u00e9t\u00e9 r\u00e9dig\u00e9es en Markdown<\/em> et mises en ligne gr\u00e2ce \u00e0 MKDocs<\/em>[1]<\/sup><\/a>, logiciel permettant de cr\u00e9er de fa\u00e7on simple et rapide des sites Web statiques[2]<\/sup><\/a>.<\/p>\n

Pour la version \u00ab\u00a0manuel\u00a0\u00bb, c’est la plateforme e-publish[3]<\/sup><\/a> qui a \u00e9t\u00e9 utilis\u00e9e par importation de la version ePub du site web.<\/p>\n

\n

R\u00e9flexions et chemin personnel<\/h2>\n

Ce manuel est enti\u00e8rement consacr\u00e9 \u00e0 l\u2019utilisation de Markdown<\/em> pour la r\u00e9daction et la production de documents acad\u00e9miques de qualit\u00e9.<\/p>\n

Habitu\u00e9 \u00e0 la r\u00e9daction structur\u00e9e depuis plus de 15 ans (plusieurs documents r\u00e9dig\u00e9s au format XML-Docbook<\/em> avec oXygen<\/em>), la d\u00e9couverte de Markdown<\/em> est plus r\u00e9cente et date de fin 2017. Lors de la recherche d\u2019un outil \u201cdistraction free<\/em>\u201d pour r\u00e9diger un article, Typora<\/em> est apparu comme une \u00e9vidence. Le format d\u2019enregistrement des fichiers de Typora<\/em> est Markdown<\/em> et donc Markdown<\/em> est \u00e9galement apparu comme une \u00e9vidence.<\/p>\n

Apr\u00e8s avoir r\u00e9dig\u00e9 un premier billet sur infolit.be, deux petits tutoriels (Cr\u00e9er des documents professionnels avec Markdown et Pandoc. L\u2019\u00e9criture num\u00e9rique ouverte[4]<\/sup><\/a> et Cr\u00e9er des pr\u00e9sentations avec Markdown, Beamer et Pandoc[5]<\/sup><\/a>) ont rapidement suivi.<\/p>\n

\u00c9tant donn\u00e9 qu\u2019il n\u2019est pas simple de trouver une source francophone compl\u00e8te \u00e0 propos de Markdown<\/em>, il semblait n\u00e9cessaire de proposer ce site Web, \u00e0 la fois plaidoyer et petit manuel \u00e0 l\u2019usage des d\u00e9butants pour d\u00e9couvrir, comprendre et utiliser Markdown<\/em>. L\u2019ensemble des contenus est bas\u00e9 sur ma propre exp\u00e9rience et sur les diverses d\u00e9couvertes, aliment\u00e9es par mes besoins de trouver des solutions pragmatiques, \u00e0 propos de Markdown<\/em>.<\/p>\n

Je ne suis pas un geek<\/em> et les limites de mon utilisation de Markdown<\/em> sont bas\u00e9es sur le niveau de complexit\u00e9. Il est possible d\u2019aller tr\u00e8s loin avec des commandes et options moins accessibles. Le principe de base de cette pr\u00e9sentation est que l\u2019utilisation de Markdown<\/em> pour la cr\u00e9ation de documents professionnels reste simple.<\/p>\n

Bernard Pochet<\/a><\/p>\n<\/div>\n<\/div>\n

<\/div>\n<\/div>\n
  1. https:\/\/www.mkdocs.org\/<\/a> ↵<\/a><\/li>
  2. https:\/\/frank.taillandier.me\/2016\/03\/08\/les-gestionnaires-de-contenu-statique\/<\/a> ↵<\/a><\/li>
  3. https:\/\/e-publish.uliege.be<\/a> ↵<\/a><\/li>
  4. https:\/\/orbi.uliege.be\/handle\/2268\/255717<\/a> ↵<\/a><\/li>
  5. https:\/\/orbi.uliege.be\/handle\/2268\/255718<\/a> ↵<\/a><\/li><\/ol><\/div>","protected":false},"author":1,"menu_order":1,"template":"","meta":{"pb_show_title":"on","pb_short_title":"","pb_subtitle":"","pb_authors":[],"pb_section_license":""},"back-matter-type":[],"contributor":[],"license":[],"class_list":["post-111","back-matter","type-back-matter","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/e-publish.uliege.be\/md\/wp-json\/pressbooks\/v2\/back-matter\/111"}],"collection":[{"href":"https:\/\/e-publish.uliege.be\/md\/wp-json\/pressbooks\/v2\/back-matter"}],"about":[{"href":"https:\/\/e-publish.uliege.be\/md\/wp-json\/wp\/v2\/types\/back-matter"}],"author":[{"embeddable":true,"href":"https:\/\/e-publish.uliege.be\/md\/wp-json\/wp\/v2\/users\/1"}],"version-history":[{"count":8,"href":"https:\/\/e-publish.uliege.be\/md\/wp-json\/pressbooks\/v2\/back-matter\/111\/revisions"}],"predecessor-version":[{"id":399,"href":"https:\/\/e-publish.uliege.be\/md\/wp-json\/pressbooks\/v2\/back-matter\/111\/revisions\/399"}],"metadata":[{"href":"https:\/\/e-publish.uliege.be\/md\/wp-json\/pressbooks\/v2\/back-matter\/111\/metadata\/"}],"wp:attachment":[{"href":"https:\/\/e-publish.uliege.be\/md\/wp-json\/wp\/v2\/media?parent=111"}],"wp:term":[{"taxonomy":"back-matter-type","embeddable":true,"href":"https:\/\/e-publish.uliege.be\/md\/wp-json\/pressbooks\/v2\/back-matter-type?post=111"},{"taxonomy":"contributor","embeddable":true,"href":"https:\/\/e-publish.uliege.be\/md\/wp-json\/wp\/v2\/contributor?post=111"},{"taxonomy":"license","embeddable":true,"href":"https:\/\/e-publish.uliege.be\/md\/wp-json\/wp\/v2\/license?post=111"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}