Version PDF de l’article

Emacs permet de sortir des documents ayant le format HTML, LaTeX, odt et bien d’autres… Mais aussi en PDF. Toutefois, il est nécessaire d’effectuer une certaine configuration pour exporter dans ce format PDF.

I. Création d’un fichier de configuration  pour Emacs (init file)

Vous devez ensuite créer un fichier à la racine de votre utilisateur en cours. Ce fichier comportera la configuration pour l’utilisateur courant. Dans notre exemple, notre utilisateur sera « juh« . Le fichier se trouvera donc dans « /home/juh/« .
Création du fichier :

Création fichier de configuration
cd /home/juh
sudo touch .emacs

Le fichier est volontairement nommé « .emacs« , pour qu’il puisse être caché d’une part, mais aussi parce qu’Emacs sera capable de retrouver ce fichier tout seul.

Dans ce fichier, nous allons écrire la configuration de base nécessaire pour un export fiable et viable en PDF.

Exemple utilisable de fichier.emacs
(require 'org-latex)
(add-to-list 'org-export-latex-classes
             '("ubuntu-straight-article"
"\\documentclass[10pt,a4paper]{article}
\\usepackage{fontspec}
\\setromanfont{Ubuntu Light}
\\setsansfont{Ubuntu Light}
\\setmonofont{Inconsolata}
\\usepackage{graphicx}
\\usepackage{polyglossia}
\\setdefaultlanguage{french}
\\usepackage[draft=true]{hyperref}
\\usepackage{geometry}
\\geometry{a4paper, textwidth=17cm, textheight=25cm}
      [NO-DEFAULT-PACKAGES]
      [NO-PACKAGES]"
               ("\\section{%s}" . "\\section*{%s}")
               ("\\subsection{%s}" . "\\subsection*{%s}")
               ("\\subsubsection{%s}" . "\\subsubsection*{%s}")
               ("\\paragraph{%s}" . "\\paragraph*{%s}")
               ("\\subparagraph{%s}" . "\\subparagraph*{%s}")))

(setq org-latex-to-pdf-process '("xelatex -interaction nonstopmode %f"
"xelatex -interaction nonstopmode %f"))

Une fois le contenu copié / collé dans notre fichier « .emacs« , enregistrez le & fermez le.

Par défaut, Emacs comprendra que le fichier « .emacs » créé à la racine de votre dossier perso’ sera à lire & à utiliser pour l’utilisateur courant.
Ce que dit la doc’ officiel d’Emacs :

32.7.4. How Emacs Finds Your Init File

Normally Emacs uses the environment variable HOME to find .emacs; that’s what ~ means in a file name. But if you have done su, Emacs tries to find your own .emacs, not that of the user you are currently pretending to be.

Lancez Emacs une première fois (ou relancez-le si vous l’aviez déjà ouvert), pour qu’il initialise se fichier nouvellement créé. Vous ne verrez rien de spécial apparaître à l’écran, puisque l’initialisation se fait discrètement.
Nous pouvons passer maintenant à l’installation des paquets supplémentaires nécessaires pour l’export PDF.

II. Téléchargements & installation des paquets supplémentaires

Le choix des paquets est volontairement important, & le téléchargement est lui aussi important (plus de 400mo).
Cependant, de nombreux paquets ne vous seront pas nécessaires dans cette install, notamment les paquets « *-doc ». Vous pouvez les supprimer une fois installés (les fichiers « *-doc »), à moins que vous ne puissiez les bloquer selon votre utilitaire de téléchargement de paquets.

NB : Un tutoriel est disponible sur IDEALOGEEK pour empêcher l’installation de paquets supplémentaires, tels que les paquets « Recommandés » & « Suggérés » (Clic ME)

Liste des paquets à installer - Ligne de commande
sudo apt-get install texlive texlive-base texlive-latex-base texlive-latex-extra
texlive-latex-recommended texlive-fonts-extra texlive-fonts-recommended texlive-extra-utils texlive-xetex

Laissez l’installation & la configuration se faire : tout est automatisé pour cette partie. Vous n’avez juste qu’à regarder ce qu’il se passe, pour savoir quels sont les paquets installés…

III. Police d’écriture à ajouter

Les paquets TeXLive installés, il est nécessaire d’ajouter une famille de police à votre système pour que les « fonts » lors de l’export soient lisible.
Pour vous éviter des recherches sur internet, je vous fournis directement ces polices d’écriture. 

[wpdm_file id=1 title="true" desc="false" ]

Ces polices d’écritures sont à placer dans le dossier « /usr/share/fonts/truetype »

IV. Template à modifier

Nous devons effectuée une dernière modification quant au template utilisé dans nos documents. Ces lignes seront à rajouter à chaque document nouvellement créé.

Je n’ai pas encore trouvé le moyen d’automatiser cette tâche, mais je pense bien qu’une personne parmi vous pourra me donner la solution .

Insérez-y le template (Ctrl-C + Ctrl-E + T) de base d’une part, puis ajoutez ces quelques lignes juste au dessus du template précédemment ajouté :

Lignes de commande
#+LaTeX_CLASS: ubuntu-straight-article
#+LaTeX_CLASS_OPTIONS: [twoside,microtype]
#+LaTeX_CLASS_OPTIONS: [secnums,secnumss,secnumsss,secnump,secnumsp]
#+LaTeX_CLASS_OPTIONS: [tocdepths,tocdepthss,tocdepthsss]

Ces 4 lignes permettent d’ajouter des options supplémentaires pour l’export PDF, notamment au niveau du type de format & de la police utilisé pour l’export (ubuntu-straight-article), mais aussi au niveau des marges d’impression & des interlignes.

V. Tests d’export PDF

Lorsque la procédure est terminée, vous pouvez tenter un export en PDF de votre documents. Pour cela, entrez dans le « mode export » d’Emacs (Ctrl-C + Ctrl-E), puis appuyez sur la touche « P« .

Emacs travaillera tout seul, et selon la taille du document, le temps d’export peut prendre du temps. Lors de la fin de l’export, Emacs vous affichera une petite phrase tout en bas de la fenêtre :

Exporting to PDF... Done.

Vous avez dorénavant un Emacs capable d’exporter des documents textes brut en fichier PDF propres et esthétiquement très réussis !

D’autres tutoriels sont disponibles !!

• Installation et utilisation de base d’Emacs & Org-mode
• Configurer l’exportation des fichiers en .pdf
• Les tableaux sous Emacs
• Rendre Emacs plus « user-friendly »