A propos de ce répertoire

⚠️ 🇬🇧 Although the content of this repo is mainly in French, we'd be happy to answer questions in English as well 😃!

Un canevas de thèse incluant des fichiers en Markdown. Le but est simplement de montrer comment, avec un template Latex bien ficelé (et j'en profites pour dire merci à l'UQAR) et un fichier makefile, on peut avoir une thèse formatée tout en profitant du confort qu'offre Markdown.

J'ai créé ce répertoire après avoir formaté ma thèse dont la version, un peu différente, est disponible sur ce répertoire. Noté aussi que Alain Danet a adopté ce répertoire pour répondre aux exigences de l'université de Montpellier (voir le répertoire alaindanet/TheseCanevas).

Installation

Approche générale 💡

Ce répertoire a été conçu pour faciliter la compilation d'un document final de thèse à partir d'un canevas LaTeX et d'un ensemble de fichier écrits en LateX ou en Markdown. Pandoc est utilisé pour faire la conversion .md => .tex et le document est compilé avec pdflatex le tout étant orchestré par un makefile.
La section suivante donne plus de détails relatifs à ces outils.

Outils utilisés 🔧

1. Il faut une distribution Latex, le template doit être compilé avec pdflatex. Voici ce que la version que j'ai utilisée lors pour la dernière compilation réalisée en local avec Debian Buster::

pdfTeX 3.14159265-2.6-1.40.19 (TeX Live 2019/dev/Debian)
kpathsea version 6.3.1/dev
Copyright 2018 Han The Thanh (pdfTeX) et al.
There is NO warranty.  Redistribution of this software is
covered by the terms of both the pdfTeX copyright and
the Lesser GNU General Public License.
For more information about these matters, see the file
named COPYING and the pdfTeX source.
Primary author of pdfTeX: Han The Thanh (pdfTeX) et al.
Compiled with libpng 1.6.34; using libpng 1.6.36
Compiled with zlib 1.2.11; using zlib 1.2.11
Compiled with xpdf version 4.00

2. GNU make

3. Pandoc 2.7.3 pour convertir les fichier .md en fichier .tex (Pandoc fait bien plus que cela!), pour la dernière compilation j'ai utilisé les filtres Pandoc suivants\ :

• Pandoc-eqnos pour les équations,
• Pandoc-tablenos pour les tables,
• Pandoc-fignos pour les figures,
• pour les installer:

pip install pandoc-fignos pandoc-tablenos pandoc-eqnos

• Pour la syntaxe Pandoc Markdown, plusieurs liens utiles:
  • le lien vers R Mardown pour une approche pragmatique,
  • voir Common Mark pour plus de détails.

Avec Raspbian

Voici ce que j'ai utilisé pour que tout marche sur Raspbian-Jessie.

Mon fichier /etc/apt/sources.list est:

deb http://mirrordirector.raspbian.org/raspbian/ jessie main contrib non-freerpi
deb-src http://archive.raspbian.org/raspbian/ jessie main contrib non-free rpi
deb http://archive.raspbian.org/raspbian/ stretch main

Mettre tout à jour:

apt-get update && apt-get upgrade

Installer Latex:

$ apt-get install texlive-base texlive-science texlive-extra-utils\
  texlive-font-utils texlive-fonts-extra texlive-fonts-recommended\
  texlive-latex-base texlive-latex-extra texlive-lang-english \
  texlive-lang-french

Installer Pandoc:

sudo apt-get install pandoc pandoc-citeproc

Python est déjà installé, et a été mis-à jour plus haut, il faut cependant s'assurer que le pip soit à jour puis installer les filtres:

sudo apt-get install python-pip
sudo easy_install -U setuptools
sudo pip install pandoc-fignos pandoc-tablenos pandoc-eqnos

Voilà, le make devrait marcher.

Utilisation 🔨

Il faut se placer au niveau du Makefile et dans votre terminal entrez:

make

Pour faire un clean build commencez avec:

make clean