{"id":104,"date":"2025-07-09T10:05:29","date_gmt":"2025-07-09T08:05:29","guid":{"rendered":"https:\/\/e-publish.uliege.be\/md2\/?post_type=chapter&p=104"},"modified":"2026-01-14T09:53:29","modified_gmt":"2026-01-14T08:53:29","slug":"les-complements-du-texte","status":"publish","type":"chapter","link":"https:\/\/e-publish.uliege.be\/md2\/chapter\/les-complements-du-texte\/","title":{"raw":"Les compl\u00e9ments du texte","rendered":"Les compl\u00e9ments du texte"},"content":{"raw":" A<\/span>ppel\u00e9s \u00e9galement \"appareil critique\", ces compl\u00e9ments sont la base des textes scientifiques.\r\n
\r\n

Les notes de bas de page<\/h1>\r\nLes notes sont cr\u00e9\u00e9es avec l\u2019ajout d\u2019un \"^\" et le texte de la note est encadr\u00e9 de \"[\" et \"]\"\u00a0:\r\n
\r\n
ceci est le texte^[Et ceci est la note.].<\/pre>\r\n<\/div>\r\nLes notes de bas de page sont num\u00e9rot\u00e9es automatiquement. Cette m\u00e9thode est sp\u00e9cifique \u00e0 la cr\u00e9ation de documents pdf avec Pandoc-Markdown. On peut aussi utiliser cette m\u00e9thode pour ajouter une note dans les \u00e9l\u00e9ments de l\u2019en-t\u00eate (pour le titre, le r\u00e9sum\u00e9 ou un auteur).\r\n\r\nIl y a une m\u00e9thode un peu plus complexe (et compatible pour les exportations ePub, HTML, odt et docx) qui se fait en deux temps, avec l\u2019appel de note\u00a0:\r\n
\r\n
ceci est le texte[^num\u00e9ro de la note].<\/pre>\r\n<\/div>\r\net avec toutes les notes regroup\u00e9es \u00e0 la fin du document .md\u00a0:\r\n
\r\n
[^num\u00e9ro de la note]: Et ceci est la note.<\/pre>\r\n<\/div>\r\n<\/div>\r\n
\r\n
Les liens<\/h1>\r\nPour cr\u00e9er un lien vers une page Web, il faut utiliser la s\u00e9quence [ ](). Entre les crochets, on va placer le texte \u00e0 afficher et, entre les parenth\u00e8ses, l\u2019URL cible\u00a0:\r\n
\r\n
[texte \u00e0 afficher](https:\/\/url.cible.org)<\/pre>\r\n<\/div>\r\nOn peut aussi, pour une \u00e9criture plus rapide, placer l\u2019URL entre \"<\" et \">\".\r\n
\r\n
<https:\/\/URL.be><\/pre>\r\n<\/div>\r\nmais alors, le texte du lien sera l\u2019URL elle-m\u00eame.\r\n\r\nSi une m\u00eame URL doit est utilis\u00e9e plusieurs fois dans le m\u00eame document, on peut regrouper les liens sur une m\u00eame adresse. \u00c0 la fin du document, on ajoute\u00a0:\r\n
\r\n
[1]: <https:opensolution.be> \"site de r\u00e9f\u00e9rence\"<\/pre>\r\n<\/div>\r\net dans le texte on fait le lien \u00e0 cette URL en l\u2019appelant\u00a0:\r\n
\r\n
texte texte vers ce [site][1]<\/pre>\r\n<\/div>\r\n(Attention, le lien est entre crochets et non entre parenth\u00e8ses.)\r\n\r\nIl est aussi possible de cr\u00e9er des liens \u00e0 l\u2019int\u00e9rieur d\u2019un document[footnote]Ne fonctionne pas si les liens sont transform\u00e9s en notes en bas de page avec l\u2019instruction links-as-notes: true<\/strong> dans l\u2019en-t\u00eate YAML.[\/footnote]. Pour cela\u00a0:\r\n
    \r\n \t
  1. il faut ajouter une ancre (ici, apr\u00e8s un titre)\u00a0:<\/li>\r\n<\/ol>\r\n
    <\/code><\/pre>\r\n
    \r\n
    # chapitre 10 {#chap10}<\/pre>\r\n<\/div>\r\n
    <\/code><\/pre>\r\n
      \r\n \t
    1. cr\u00e9er le lien avec la s\u00e9quence\u00a0:<\/li>\r\n<\/ol>\r\n
      \r\n
      texte texte texte, voir [chapitre 10](#chap10)<\/pre>\r\n<\/div>\r\n<\/div>\r\n
      \r\n
      Les figures<\/h1>\r\nLa syntaxe pour ins\u00e9rer une figure est comparable \u00e0 celle de la cr\u00e9ation d\u2019un lien. Il faut seulement faire pr\u00e9c\u00e9der l\u2019instruction d\u2019un \"!\". L\u2019image qui sera ins\u00e9r\u00e9e peut \u00eatre un fichier pr\u00e9sent sur l\u2019ordinateur (attention \u00e0 appeler le fichier au bon endroit sur le disque dur) ou une image quelque part sur le web (il faut alors entrer une URL correcte).\r\n\r\nS\u2019il y a une l\u00e9gende (texte entre le [ et ]), les images sont centr\u00e9es et automatiquement num\u00e9rot\u00e9es avec \"Figure x\u00a0:\" + la l\u00e9gende. Pandoc<\/em> va \u00e9ventuellement d\u00e9placer le texte avant et apr\u00e8s les figures pour optimiser le remplissage des pages.\r\n\r\nCeci\u00a0:<\/strong>\r\n
      \r\n
      ![Le logo de *Markdown*](markdown-large.png)<\/pre>\r\n<\/div>\r\nDonnera\u00a0:<\/strong>\r\n\r\n\"image\"\r\n\r\nS\u2019il n\u2019y a pas de l\u00e9gende (texte entre le [ et ]), la figure sera align\u00e9e \u00e0 gauche. La mise en forme sera peut-\u00eatre moins optimale.\r\n\r\nIl est possible de modifier la taille de l\u2019image en ajoutant { width=50% }<\/strong> derri\u00e8re l\u2019appel d\u2019image (ici, r\u00e9duction de la taille de 50%).\r\n\r\n<\/div>\r\n
      \r\n
      Les tableaux<\/h1>\r\nMarkdown g\u00e8re plut\u00f4t bien les tableaux. Il faut utiliser le \"|\" pour s\u00e9parer les colonnes et le saut de ligne pour s\u00e9parer les lignes.\r\n\r\nPour aligner \u00e0 gauche (les colonnes sont align\u00e9es \u00e0 gauche par d\u00e9faut), centrer ou aligner \u00e0 droite le contenu d\u2019une colonne, il faut le d\u00e9clarer dans la deuxi\u00e8me ligne en ajoutant \":\" \u00e0 gauche, \":\" des deux c\u00f4t\u00e9s ou \":\" \u00e0 droite des trois \"-\". Le nombre de tirets (\"-\") va influencer la largeur de la colonne.\r\n\r\nLa s\u00e9quence suivante\u00a0:<\/strong>\r\n
      \r\n
      | gauche | centre | droite |\r\n|:---|:---:|---:|\r\n| cellule 1.1 | cellule 2.1 | cellule 3.1 |\r\n| cellule 1.2 | cellule 2.2 | cellule 3.2 |\r\n| cellule 1.3 | cellule 2.3 | cellule 3.3 |\r\n: Titre du tableau<\/pre>\r\n<\/div>\r\n
      \u00a0Donnera\u00a0:\r\n\"\"<\/strong><\/pre>\r\n \r\n\r\nLes enrichissements (gras, italique\u2026) sont autoris\u00e9s pour toutes les cellules du tableau.\r\n\r\nLe titre du tableau appara\u00eet au-dessus, num\u00e9rot\u00e9, comme pour les figures (o\u00f9 il appara\u00eet en dessous).\r\n\r\nAvec cette syntaxe, il n\u2019est pas possible, avec Pandoc-Markdown, de fusionner des cellules. Il faut alors utiliser une autre syntaxe un peu plus complexe (ici, pour fusionner les cellules A2 et A3)\u00a0:\r\n
      \r\n
      +---------------+:-----------:+------------:+\r\n| **gauche**|**centre**| **droite**|\r\n+---------------+-------------+-------------+\r\n| cellules fus. |cellule 2.1|cellule 3.1|\r\n|               |cellule 2.2|cellule 3.2|\r\n+---------------+-------------+-------------+\r\n| cellule 1.3   |cellule 2.3|cellule 3.3|\r\n+---------------+-------------+-------------+\r\n: Titre du tableau\r\n<\/pre>\r\n<\/div>\r\n<\/div>\r\n \r\n\r\n \r\n\r\n \r\n
      \r\n\r\npour avoir\u00a0:<\/strong>\r\n\r\n\"\"\r\n\r\nL\u2019utilisation de la syntaxe html est aussi une solution.\r\n\r\nLa cr\u00e9ation de tableaux avec Markdown peut para\u00eetre assez complexe. Plusieurs outils d\u2019\u00e9dition pr\u00e9voient des aides. Il existe aussi sur le Web un g\u00e9n\u00e9rateur de tables[footnote]https:\/\/www.tablesgenerator.com\/markdown*tables<\/a>[\/footnote] Markdown qui facilite leur cr\u00e9ation (y compris la transformation de fichiers .csv provenant d\u2019un tableur).\r\n\r\n<\/div>\r\n
      \r\n
      Les \u00e9quations math\u00e9matiques<\/h1>\r\nIl est aussi possible d\u2019int\u00e9grer des \u00e9quations math\u00e9matiques avec la syntaxe TeX Math<\/em> de LaTeX<\/em>[footnote]Ne fonctionne pas pour les documents html.[\/footnote]. Dans un fichier Markdown, ces \u00e9quations sont encadr\u00e9es par \"$$\".\r\n\r\nLa s\u00e9quence suivante\u00a0:<\/strong>\r\n
      \r\n
      $$x = \\frac {-b \\pm \\sqrt{b^2 \u2013 4ac}}{2a}$$<\/pre>\r\n<\/div>\r\n \r\n\r\n \r\n\r\n \r\n\r\ndonnera\u00a0:<\/strong>\r\n\r\n\"\"\r\n\r\nEncore une fois, l\u2019objectif reste juste de montrer ce qui est possible et non de d\u00e9tailler cette syntaxe. Il y a un tutoriel tr\u00e8s complet sur WikiBooks<\/em>[footnote]https:\/\/en.wikibooks.org\/wiki\/LaTeX\/Mathematics<\/a>[\/footnote]. On peut aussi utiliser un \u00e9diteur en ligne[footnote]http:\/\/www.hostmath.com\/<\/a>[\/footnote] pour \u00e9crire les \u00e9quations.\r\n\r\n<\/div>\r\n
      \r\n
      Les citations<\/h1>\r\nPour citer et mettre en \u00e9vidence un passage de texte, il faut utiliser le caract\u00e8re \">\" en d\u00e9but de paragraphe.\r\n\r\nCe passage\u00a0:<\/strong>\r\n
      \r\n
      > \"But here\u2019s the most important bit, saved for last:\r\nnone of this matters if you want to write a book. Quite\r\na few people have told me that they want to write a\r\nbook, but they\u2019re not sure about which tools to use.\r\nMy advice: all you need to write a book is a program\r\nthat allows you to write text into a file\" [@ball2018].<\/pre>\r\n<\/div>\r\nDonnera\u00a0:<\/strong>\r\n
      \"But here\u2019s the most important bit, saved for last: none of this matters if you want to write a book. Quite a few people have told me that they want to write a book, but they\u2019re not sure about which tools to use. My advice: all you need to write a book is a program that allows you to write text into a file\" (Ball, 2018).<\/blockquote>\r\nLe paragraphe est d\u00e9cal\u00e9 \u00e0 droite avec une justification gauche et droite (comme le reste du texte). Avec deux \">\", le retrait sera plus important.\r\n\r\nNotez au passage l\u2019ajout de la citation \u00e0 l\u2019auteur du texte qui va reproduire le renvoi \u00e0 la bibliographie suivant la norme s\u00e9lectionn\u00e9e dans l\u2019en-t\u00eate YAML et ajouter la r\u00e9f\u00e9rence dans la bibliographie en fin de document (voir ci-dessous pour plus d\u2019explications \u00e0 propos des possibilit\u00e9s en mati\u00e8re de bibliographie).\r\n\r\n<\/div>\r\n
      \r\n
      Les appels bibliographiques et la bibliographie<\/h1>\r\nUn \u00e9l\u00e9ment puissant de l\u2019utilisation de Markdown avec Pandoc<\/em> est la facilit\u00e9 d\u2019insertion de citations bibliographiques dans le texte et de g\u00e9n\u00e9ration d\u2019une bibliographie \u00e0 la fin du document (pdf mais aussi HTML, ePub, odt, docx\u2026).\r\n\r\nPour que cela fonctionne\u00a0:\r\n
        \r\n \t
      1. il faut que deux fichiers soient pr\u00e9sents dans le m\u00eame r\u00e9pertoire que le document .md\u00a0:<\/li>\r\n<\/ol>\r\n