{"id":99,"date":"2025-07-09T10:01:45","date_gmt":"2025-07-09T08:01:45","guid":{"rendered":"https:\/\/e-publish.uliege.be\/md2\/?post_type=chapter&p=99"},"modified":"2025-11-12T09:14:43","modified_gmt":"2025-11-12T08:14:43","slug":"la-structure-du-document","status":"publish","type":"chapter","link":"https:\/\/e-publish.uliege.be\/md2\/chapter\/la-structure-du-document\/","title":{"raw":"La structure du document","rendered":"La structure du document"},"content":{"raw":" L<\/span>a structuration d\u2019un document est un point essentiel dans sa qualit\u00e9. Le caract\u00e8re #<\/strong>, les paragraphes et les listes (simples ou num\u00e9riques) sont donc les trois \u00e9l\u00e9ments \u00e0 utiliser pour structurer un document avec Markdown.\r\n
\r\n

Les titres<\/h1>\r\nPour \u00eatre correctement structur\u00e9, un texte doit \u00eatre divis\u00e9 en parties, chapitres, sous-chapitres, etc. Avec Markdown, cette structure est particuli\u00e8rement simple \u00e0 mettre en \u0153uvre avec l\u2019utilisation du caract\u00e8re # (# titre de niveau 1<\/strong>, ## titre de niveau 2<\/strong>\u2026).\r\n\r\nMarkdown permet six niveaux de titre, mais il est rare de d\u00e9passer quatre niveaux dans un document d\u00e9j\u00e0 complexe.\r\n
\r\n
# Titre de niveau 1\r\n## Titre de niveau 2\r\n### Titre de niveau 3\r\n#### Titre de niveau 4\r\n##### Titre de niveau 5\r\n###### Titre de niveau 6<\/pre>\r\n<\/div>\r\nCes niveaux seront diff\u00e9rents en fonction de la classe<\/em> du document (voir tableau ci-dessous).\r\n\r\nPour un livre<\/strong> on aura des parties<\/strong> (qui commenceront par d\u00e9faut sur une page paire, \u00e0 droite, donc avec l\u2019ajout \u00e9ventuel d\u2019une page blanche), des chapitres<\/strong>, des sections<\/strong> et des sous-sections<\/strong>. Pour un rapport<\/strong>, ce sera la m\u00eame structure, mais il n\u2019y a pas de notion de pages paires et impaires. Pour un article<\/strong>, le niveau 1 (# titre) sera un chapitre<\/strong>.\r\n\r\nEn principe, un m\u00eame niveau ne peut pas appara\u00eetre seul. Si un chapitre ne contient qu\u2019une seule section, le titre de cette section doit \u00eatre supprim\u00e9 ou faire partie du titre du chapitre. Un document structur\u00e9 se construit comme un arbre. Il ne peut y avoir une branche contenant seulement une sous-branche.\r\n\r\n\r\n\r\n\r\n\r\n\r\n
Synth\u00e8se de la structure d\u2019un document cr\u00e9\u00e9 avec Markdown et LaTeX<\/em><\/caption>\r\n
classe<\/th>\r\npage titre<\/th>\r\nniveau 1<\/th>\r\nniveau 2<\/th>\r\n<\/tr>\r\n<\/thead>\r\n
article<\/td>\r\nnon (page 1)<\/td>\r\nChapitre<\/td>\r\nSection<\/td>\r\n<\/tr>\r\n
report<\/td>\r\noui<\/td>\r\nPartie<\/td>\r\nChapitre<\/td>\r\n<\/tr>\r\n
book<\/td>\r\noui<\/td>\r\nPartie[footnote]Pour introduire le livre (introduction et\/ou pr\u00e9face) ou pour ajouter des annexes ou une bibliographie, il faut ajouter les attributs \\frontmatter, \\mainmatter<\/strong> et \\backmatter<\/strong> au d\u00e9but des parties. Pour la classe book<\/strong>, si on ne fait pas pr\u00e9c\u00e9der l\u2019introduction de \\frontmatter<\/strong>, l\u2019introduction sera num\u00e9rot\u00e9e comme une partie.[\/footnote] (page paire)<\/td>\r\nChapitre<\/td>\r\n<\/tr>\r\n<\/tbody>\r\n<\/table>\r\nPour un document HTML, contrairement \u00e0 un document pdf o\u00f9 le titre du document se trouve dans l\u2019en-t\u00eate YAML, le titre de niveau 1 (# titre 1<\/strong>) est le titre de la page. Il ne doit donc appara\u00eetre qu\u2019une fois.\r\n\r\nLes titres peuvent \u00eatre num\u00e9rot\u00e9s automatiquement via une instruction pr\u00e9sente dans l\u2019en-t\u00eate YAML (numbersections: true<\/strong>). Pour emp\u00eacher la num\u00e9rotation d\u2019un titre en particulier, il faut ajouter \"{-}\"<\/strong> \u00e0 la suite du titre (sans espace).\r\n\r\n<\/div>\r\n
\r\n
Les paragraphes<\/h1>\r\nDans le texte, la s\u00e9paration en paragraphes est r\u00e9alis\u00e9e par un double saut de ligne.\r\n\r\nIl est cependant possible, en ajoutant \"\\\"<\/strong> (ou, avec les \u00e9diteurs qui l\u2019acceptent, trois espaces cons\u00e9cutifs) \u00e0 la fin de la ligne, de provoquer un saut de ligne sans cr\u00e9er un nouveau paragraphe.\r\n\r\n<\/div>\r\n
\r\n
Les listes<\/h1>\r\nMarkdown permet de cr\u00e9er des listes simples et des listes num\u00e9rot\u00e9es.\r\n\r\nPour les listes simples, il faut utiliser le tiret (ou le +<\/strong>) suivi d\u2019une espace[footnote]En typographie, le mot espace est au f\u00e9minin.[\/footnote].\r\n\r\nCeci\u00a0:<\/strong>\r\n
\r\n
\u2013 item 1\r\n\u2013 item 2\r\n+ item 3\r\n<\/pre>\r\n<\/div>\r\nDonnera\u00a0:<\/strong>\r\n\r\n\u2014\u00a0item 1\r\n\u2014\u00a0item 2\r\n\u2014\u00a0item 2\r\n\r\nNotez au passage[footnote]Sp\u00e9cifique pour les documents d\u00e9clar\u00e9s en fran\u00e7ais dans l\u2019en-t\u00eate YAML.[\/footnote] que les bullets sont ici remplac\u00e9s par des tirets longs (cadratins)[footnote] Le cadratin est une grandeur typographique qui \u00e9quivaut \u00e0 la largeur de la lettre la plus large, qui peut \u00eatre diff\u00e9rente d'une police \u00e0 l'autre. C'est approximativement l'espace occup\u00e9 par \"00\" (deux z\u00e9ro).[\/footnote].\r\n\r\nPour les listes num\u00e9rot\u00e9es, il faut mettre un chiffre (peu importe le chiffre, mais le premier indique le d\u00e9but de la num\u00e9rotation), suivi d\u2019un point et d\u2019une espace.\r\n\r\nCeci\u00a0:<\/strong>\r\n
\r\n
1. item 1\r\n1. item 2\r\n1. item 3\r\n<\/pre>\r\n<\/div>\r\nDonnera\u00a0:<\/strong>\r\n
    \r\n \t
  1. item 1<\/li>\r\n \t
  2. item 2<\/li>\r\n \t
  3. item 3<\/li>\r\n<\/ol>\r\nLes listes doivent \u00eatre pr\u00e9c\u00e9d\u00e9es d\u2019un saut de ligne. Il est possible de combiner les deux types de listes.\r\n\r\nPeut-\u00eatre moins utile, il est aussi possible de cr\u00e9er des cases \u00e0 cocher.\r\n\r\nCeci\u00a0:<\/strong>\r\n
    \r\n
    \u2013 [x] item 1, coch\u00e9\r\n\u2013 [ ] item 2, non-coch\u00e9\r\n\u2013 [x] item 2.1, coch\u00e9\r\n\u2013 [ ] item 2.2, non-coch\u00e9\r\n\u2013 [ ] item 3, non-coch\u00e9\r\n\u2013 [X] item 4, coch\u00e9\r\n<\/pre>\r\n<\/div>\r\n(attention aux espaces)\r\n\r\nDonnera\u00a0:<\/strong>\r\n\r\n\"\"\r\n\r\n \r\n\r\n \r\n\r\n<\/div>","rendered":"
     L<\/span>a structuration d\u2019un document est un point essentiel dans sa qualit\u00e9. Le caract\u00e8re #<\/strong>, les paragraphes et les listes (simples ou num\u00e9riques) sont donc les trois \u00e9l\u00e9ments \u00e0 utiliser pour structurer un document avec Markdown.<\/p>\n
    \n
    Les titres<\/h1>\n
    Pour \u00eatre correctement structur\u00e9, un texte doit \u00eatre divis\u00e9 en parties, chapitres, sous-chapitres, etc. Avec Markdown, cette structure est particuli\u00e8rement simple \u00e0 mettre en \u0153uvre avec l\u2019utilisation du caract\u00e8re # (# titre de niveau 1<\/strong>, ## titre de niveau 2<\/strong>\u2026).<\/p>\n
    Markdown permet six niveaux de titre, mais il est rare de d\u00e9passer quatre niveaux dans un document d\u00e9j\u00e0 complexe.<\/p>\n
    \n
    # Titre de niveau 1\r\n## Titre de niveau 2\r\n### Titre de niveau 3\r\n#### Titre de niveau 4\r\n##### Titre de niveau 5\r\n###### Titre de niveau 6<\/pre>\n<\/div>\n
    Ces niveaux seront diff\u00e9rents en fonction de la classe<\/em> du document (voir tableau ci-dessous).<\/p>\n
    Pour un livre<\/strong> on aura des parties<\/strong> (qui commenceront par d\u00e9faut sur une page paire, \u00e0 droite, donc avec l\u2019ajout \u00e9ventuel d\u2019une page blanche), des chapitres<\/strong>, des sections<\/strong> et des sous-sections<\/strong>. Pour un rapport<\/strong>, ce sera la m\u00eame structure, mais il n\u2019y a pas de notion de pages paires et impaires. Pour un article<\/strong>, le niveau 1 (# titre) sera un chapitre<\/strong>.<\/p>\n
    En principe, un m\u00eame niveau ne peut pas appara\u00eetre seul. Si un chapitre ne contient qu\u2019une seule section, le titre de cette section doit \u00eatre supprim\u00e9 ou faire partie du titre du chapitre. Un document structur\u00e9 se construit comme un arbre. Il ne peut y avoir une branche contenant seulement une sous-branche.<\/p>\n\n\n\n\n\n\n\n
    Synth\u00e8se de la structure d\u2019un document cr\u00e9\u00e9 avec Markdown et LaTeX<\/em><\/caption>\n
    classe<\/th>\npage titre<\/th>\nniveau 1<\/th>\nniveau 2<\/th>\n<\/tr>\n<\/thead>\n
    article<\/td>\nnon (page 1)<\/td>\nChapitre<\/td>\nSection<\/td>\n<\/tr>\n
    report<\/td>\noui<\/td>\nPartie<\/td>\nChapitre<\/td>\n<\/tr>\n
    book<\/td>\noui<\/td>\nPartie[1]<\/sup><\/a> (page paire)<\/td>\nChapitre<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    Pour un document HTML, contrairement \u00e0 un document pdf o\u00f9 le titre du document se trouve dans l\u2019en-t\u00eate YAML, le titre de niveau 1 (# titre 1<\/strong>) est le titre de la page. Il ne doit donc appara\u00eetre qu\u2019une fois.<\/p>\n
    Les titres peuvent \u00eatre num\u00e9rot\u00e9s automatiquement via une instruction pr\u00e9sente dans l\u2019en-t\u00eate YAML (numbersections: true<\/strong>). Pour emp\u00eacher la num\u00e9rotation d\u2019un titre en particulier, il faut ajouter \u00ab\u00a0{-}\u00a0\u00bb<\/strong> \u00e0 la suite du titre (sans espace).<\/p>\n<\/div>\n
    \n
    Les paragraphes<\/h1>\n
    Dans le texte, la s\u00e9paration en paragraphes est r\u00e9alis\u00e9e par un double saut de ligne.<\/p>\n
    Il est cependant possible, en ajoutant \u00ab\u00a0\\\u00a0\u00bb<\/strong> (ou, avec les \u00e9diteurs qui l\u2019acceptent, trois espaces cons\u00e9cutifs) \u00e0 la fin de la ligne, de provoquer un saut de ligne sans cr\u00e9er un nouveau paragraphe.<\/p>\n<\/div>\n
    \n
    Les listes<\/h1>\n
    Markdown permet de cr\u00e9er des listes simples et des listes num\u00e9rot\u00e9es.<\/p>\n
    Pour les listes simples, il faut utiliser le tiret (ou le +<\/strong>) suivi d\u2019une espace[2]<\/sup><\/a>.<\/p>\n
    Ceci\u00a0:<\/strong><\/p>\n
    \n
    \u2013 item 1\r\n\u2013 item 2\r\n+ item 3\r\n<\/pre>\n<\/div>\n
    Donnera\u00a0:<\/strong><\/p>\n
    \u2014\u00a0item 1
    \n\u2014\u00a0item 2
    \n\u2014\u00a0item 2<\/p>\n
    Notez au passage[3]<\/sup><\/a> que les bullets sont ici remplac\u00e9s par des tirets longs (cadratins)[4]<\/sup><\/a>.<\/p>\n
    Pour les listes num\u00e9rot\u00e9es, il faut mettre un chiffre (peu importe le chiffre, mais le premier indique le d\u00e9but de la num\u00e9rotation), suivi d\u2019un point et d\u2019une espace.<\/p>\n
    Ceci\u00a0:<\/strong><\/p>\n
    \n
    1. item 1\r\n1. item 2\r\n1. item 3\r\n<\/pre>\n<\/div>\n
    Donnera\u00a0:<\/strong><\/p>\n
      \n
    1. item 1<\/li>\n
    2. item 2<\/li>\n
    3. item 3<\/li>\n<\/ol>\n
      Les listes doivent \u00eatre pr\u00e9c\u00e9d\u00e9es d\u2019un saut de ligne. Il est possible de combiner les deux types de listes.<\/p>\n
      Peut-\u00eatre moins utile, il est aussi possible de cr\u00e9er des cases \u00e0 cocher.<\/p>\n
      Ceci\u00a0:<\/strong><\/p>\n
      \n
      \u2013 [x] item 1, coch\u00e9\r\n\u2013 [ ] item 2, non-coch\u00e9\r\n\u2013 [x] item 2.1, coch\u00e9\r\n\u2013 [ ] item 2.2, non-coch\u00e9\r\n\u2013 [ ] item 3, non-coch\u00e9\r\n\u2013 [X] item 4, coch\u00e9\r\n<\/pre>\n<\/div>\n
      (attention aux espaces)<\/p>\n
      Donnera\u00a0:<\/strong><\/p>\n
      \"\"<\/p>\n
       <\/p>\n
       <\/p>\n<\/div>\n
      1. Pour introduire le livre (introduction et\/ou pr\u00e9face) ou pour ajouter des annexes ou une bibliographie, il faut ajouter les attributs \\frontmatter, \\mainmatter<\/strong> et \\backmatter<\/strong> au d\u00e9but des parties. Pour la classe book<\/strong>, si on ne fait pas pr\u00e9c\u00e9der l\u2019introduction de \\frontmatter<\/strong>, l\u2019introduction sera num\u00e9rot\u00e9e comme une partie. ↵<\/a><\/li>
      2. En typographie, le mot espace est au f\u00e9minin. ↵<\/a><\/li>
      3. Sp\u00e9cifique pour les documents d\u00e9clar\u00e9s en fran\u00e7ais dans l\u2019en-t\u00eate YAML. ↵<\/a><\/li>
      4.  Le cadratin est une grandeur typographique qui \u00e9quivaut \u00e0 la largeur de la lettre la plus large, qui peut \u00eatre diff\u00e9rente d'une police \u00e0 l'autre. C'est approximativement l'espace occup\u00e9 par \"00\" (deux z\u00e9ro). ↵<\/a><\/li><\/ol><\/div>","protected":false},"author":2,"menu_order":2,"template":"","meta":{"pb_show_title":"on","pb_short_title":"","pb_subtitle":"","pb_authors":[],"pb_section_license":""},"chapter-type":[],"contributor":[],"license":[],"class_list":["post-99","chapter","type-chapter","status-publish","hentry"],"part":68,"_links":{"self":[{"href":"https:\/\/e-publish.uliege.be\/md2\/wp-json\/pressbooks\/v2\/chapters\/99"}],"collection":[{"href":"https:\/\/e-publish.uliege.be\/md2\/wp-json\/pressbooks\/v2\/chapters"}],"about":[{"href":"https:\/\/e-publish.uliege.be\/md2\/wp-json\/wp\/v2\/types\/chapter"}],"author":[{"embeddable":true,"href":"https:\/\/e-publish.uliege.be\/md2\/wp-json\/wp\/v2\/users\/2"}],"version-history":[{"count":29,"href":"https:\/\/e-publish.uliege.be\/md2\/wp-json\/pressbooks\/v2\/chapters\/99\/revisions"}],"predecessor-version":[{"id":1312,"href":"https:\/\/e-publish.uliege.be\/md2\/wp-json\/pressbooks\/v2\/chapters\/99\/revisions\/1312"}],"part":[{"href":"https:\/\/e-publish.uliege.be\/md2\/wp-json\/pressbooks\/v2\/parts\/68"}],"metadata":[{"href":"https:\/\/e-publish.uliege.be\/md2\/wp-json\/pressbooks\/v2\/chapters\/99\/metadata\/"}],"wp:attachment":[{"href":"https:\/\/e-publish.uliege.be\/md2\/wp-json\/wp\/v2\/media?parent=99"}],"wp:term":[{"taxonomy":"chapter-type","embeddable":true,"href":"https:\/\/e-publish.uliege.be\/md2\/wp-json\/pressbooks\/v2\/chapter-type?post=99"},{"taxonomy":"contributor","embeddable":true,"href":"https:\/\/e-publish.uliege.be\/md2\/wp-json\/wp\/v2\/contributor?post=99"},{"taxonomy":"license","embeddable":true,"href":"https:\/\/e-publish.uliege.be\/md2\/wp-json\/wp\/v2\/license?post=99"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}