Repository pour export pandoc Md vers PDF avec template LaTeX.
Ce qu'il contient :
texte.md
: fichier pour le corps de texte incluant les métadonnées (YAML)bib.bib
: fichier pour la bibliographie (BibTeX)- 2 templates LaTeX
template1.latex
: template avec la mise en page de l'Udemtemplate2.latex
: template avec la mise en page d'une proposition d'article
- 2 fichiers de style bibliographique :
udem-apa.csl
etchicago-author-date.csl
- 1 dossier
media
pour les images
Nécessaire pour l'exercice : pandoc, git, compte overleaf.
Édition dans VsCodium.
Dans le terminal,
Premier réflexe :
git pull
Se placer sur sa branche (le nom de la branche est ici margot) :
git switch margot
ou
git checkout -b margot
Deuxième réflexe :
git pull
Éditer le texte.md avec les informations suivantes :
- Métadonnées
Adapter les métadonnées suivantes :
---
author:
- forname: Prénom
- surname: Nom
- institution: Université de Montréal
teacher:
- forname: Prénom
surname: Nom
title: Titre
subtitle: sous-titre
year: 2023
month: Mars
day: 21
cours:
- id: FRA3825
title: Pratiques de l'édition numérique
nocite: '@*'
---
Si des clefs ne vous sont pas nécessaires : laissez-les vides mais ne les supprimez pas.
subtitle:
- Corps de texte
Rédiger votre proposition de projet d'écriture.
- Besoin d'écriture
- Inspiration
- Objectifs (technique, éditorial ou personnel)
400-500 mots.
- Enrichissement
Si nécessaire, éditer votre texte (italique, mise en gras, tirets longs, hyperliens, références, niveaux de titre, appels de note, etc.).
Rappel
- Le dernier titre dans votre texte doit être celui de la bibliographie
- Pas de titre de niveau 1 dans le corps du texte
- Séparation des paragraphes par un saut de ligne
Sauvegarde avant les conversions.
Dans votre terminal,
- Md vers TeX
Lancer la commande selon vos choix de template et de style bibliographique :
pandoc --standalone --bibliography=bib.bib --citeproc --template=template1.latex --csl=udem-apa.csl -f markdown -t latex texte.md -o texte.tex
Si vous souhaitez convertir avec le template 2, il faut remplacer template1.md
par template2.md
dans la commande.
Si vous souhaitez le style bibliographique de Chicago, il faut remplacer udem-apa.csl
par chicago-author-date.csl
.
Durant la conversion, beaucoup de fichiers vont être créés, il faut les conserver même si vous n'en aurez pas d'utilité directe.
- LaTeX vers PDF (à la séance prochaine)
Rappel
- Si vous changez les noms des fichiers, il faut les changer dans les commandes.
Pour pusher vos modifications sur le repository Export à soi sur votre propre branche.
Ajouter ses modifications :
git add texte.tex
Commiter ses modifications :
git commit -m "mon bon commit qui décrit ce que j'ai fait"
Pusher ses modifitions une première fois (remplacer "margot" par le nom de votre branch)
git push --set-upstream origin margot
Pour les push suivants :
git push
Pour vérifier que tout est à jour sur sa branche :
git status
- LaTeX vers PDF
- produire le PDF via Overleaf
Rappel : Votre terminal est votre ami, ce qui ne veut pas dire qu'il vous aime mais qu'il vous informe quand il y a une erreur dans les fichiers qui empêchent la bonne conversion.
Erreurs fréquentes
- problème d'indentation dans les métadonnées (le yaml est un être sensible)
- problème de balisage dans le template si modifié (le latex est également sensible)
Même édition que dans Stylo : il faut insérer la clef bibtex à l'endroit souhaité.
- importer le fichier du style bibliographique en .csl dans le dossier et modifier la commande selon le nom du fichier de style bibliographique
Deux possibilités :
- soit je place la balise
\newpage
directement dans mon fichier.md avant le titre de la Bibliographie
\newpage
## Bibliographie
- soit je place la balise
\newpage
dans le fichier.tex (une fois produit) avant de lancer la commandexelatex texte.tex
comme suit.
\newpage
\hypertarget{bibliographie}{%
\subsection*{Bibliographie}\label{bibliographie}}
\addcontentsline{toc}{subsection}{Bibliographie}
La deuxième option force à refaire l'opération après chaque conversion md vers tex.
Choisir la couleur à partir des labels listés ici.
- pour les liens internes (appels de note) : modifier le nom dans à la ligne 152 (Template 1) ou ligne 86 (Template 2).
linkcolor= Blue,
- pour les liens externes (hyperliens) : modifier la ligne 151(Template 1) ou ligne 85 (Template 2).
urlcolor= TealBlue,
- pour les lignes (seulement dans le Template 2) : modifier la ligne 43 pour changer le trait en bas de page,
\xpretocmd{\footrule}{\color{TealBlue}}{}{}
modifier la ligne 237 pour le trait de haut de page.
\color{TealBlue}\hrule
Uploader l'image dans le bon dossier (media).
Éditer votre image en markdown :
![légende](chemin)
Pour que l'image apparaisse dans la PDF : ne pas oublier d'uploader l'image dans l'espace projet d'Overleaf.
En + : Je peux changer l'image de page de garde (seulement dans le Template 1) en uploadant une image dans media/
au nom de logo.png
.