Export_a_Soi

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'Udem
- template2.latex : template avec la mise en page d'une proposition d'article
2 fichiers de style bibliographique : udem-apa.csl et chicago-author-date.csl
1 dossier media pour les images

Nécessaire pour l'exercice : pandoc, git, compte overleaf.

Édition dans VsCodium.

Avant toute modification

Dans le terminal,

Premier réflexe :

git pull

Se placer sur sa branche (le nom de la branche est ici margot) :

git switch margot

git checkout -b margot

Deuxième réflexe :

git pull

Rédaction/Édition

É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.

Conversion/Production

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.

Gestion/Diffusion

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

Conseils

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)

Pour aller plus loin (Facultatif)

Je souhaite citer des références dans le texte

Même édition que dans Stylo : il faut insérer la clef bibtex à l'endroit souhaité.

Je souhaite un autre style bibliographique :

importer le fichier du style bibliographique en .csl dans le dossier et modifier la commande selon le nom du fichier de style bibliographique

Je souhaite séparer ma bibliographie de mon corps de texte

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 commande xelatex 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.

Je souhaite changer les couleurs utilisées

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

Je souhaite ajouter une image

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.

Mmellet / Export_a_Soi