[[https://pandoc.org/|Site web]]

====Rustines====

===Docx===

  * Styles

Respect des styles par défaut de Word. Il est nécessaire de passer un document de référence avec les noms de style en anglais. [[https://github.com/hokorobi/pandoc-docx-reference/raw/master/reference.docx|Exemple]] {{ :prog:pandoc:ref.docx |Archive du 28/04/2018 le 31/03/2023}}

C'est sur la base de ce document qui sera pris la mise en page, les styles.

Et générer le document en passant l'option ''%%--%%reference-doc=ref.docx''.

Attention, ''%%--reference-doc%%'' ne prend que les styles et pas la taille de la page. Utiliser ''-V geometry:a4paper,margin=2cm''.

  * Insérer un saut de page

Utiliser la balise ''\newpage'' et passer par un filter ''lua''.

[[https://github.com/pandoc-ext/pagebreak|pagebreak.lua]] {{ :prog:pandoc:pagebreak.lua.txt |Archive du 20/04/2023 le 01/09/2023}}

Et générer le document en passant l'option ''%%--%%lua-filter=filter.lua''.

[[https://github.com/jgm/pandoc/issues/6358|Page break \newpage does not work in docx output]] {{ :prog:pandoc:page_break_newpage_does_not_work_in_docx_output_issue_6358_jgm_pandoc_github_31_03_2023_12_56_36_.html |Archive du 11/05/2020 le 31/03/2023}}

  * Taille des images

''![texte alternatif](image.jpg){width=8cm}\''

Le ''\'' final indique qu'il ne faut pas insérer la légende en dessous de l'image si l'image est toute seule sur une ligne.

Sinon, le plus simple est de ne pas activer la fonctionnalité ''implicit_figures'' :

''-f markdown-implicit_figures''

[[https://pandoc.org/MANUAL.html#images|Manuel]] {{ :prog:pandoc:pandoc_-_pandoc_user_s_guide_31_03_2023_13_31_25_.html |Manuel du v3.1.2 le 31/03/2023}}

  * Utilisation des ''Title''

Par défaut ''#'' désigne ''Title 1''. Pour forcer l'utilisation de ''Title'', il faut forcer un décalage avec l'option ''%%--%%shift-heading-level-by=-1''.

[[https://stackoverflow.com/questions/56004886/pandoc-set-document-title-to-first-title|Pandoc : set document title to first title]] {{ :prog:pandoc:github_-_pandoc_set_document_title_to_first_title_-_stack_overflow_31_03_2023_13_17_40_.html |Archive du 06/05/2019 le 31/03/2023}}