Installer XeTeX

Si vous utilisez la distribution TeXLive, vous y trouverez un paquet texlive-xetex. La plupart des extensions de LaTeX fonctionneront correctement avec XeTeX, moyennant parfois quelques réglages mineurs.

Pour une distribution basée sur APT (debian et dérivés), la commande suivante installera XeTeX et XeLaTeX :

# en root
aptitude install texlive-xetex

Adapter les en-têtes

XeTeX est installé, vous allez compiler un premier document avec. Ouvrez votre éditeur, créez un nouveau document LaTeX, et assurez-vous de travailler en Unicode, typiquement UTF–8. Voici à quoi ressemble un document XeLaTeX minimal :

\documentclass[a4paper]{article}

% La ligne suivante est obligatoire, et ne fonctionnera qu'avec XeLaTeX
\usepackage{fontspec}
% (optionnel) vous pouvez choisir une police OpenType de votre choix
\setmainfont{DejaVu Sans}

% Notez le paramètre additionnel 'xetex' pour hyperref
\usepackage[pdfauthor={Paul Rivier},xetex]{hyperref}

\title{Mon premier document XeTeX}
\author{Paul Rivier}

\begin{document}

\maketitle

% La flèche est le caractère unicode « Rightwards Arrow »
\section{ LaTeX → XeLaTeX }

% Les points de suspension sont en fait une ellipse en un seul caractère
XeTeX est un compilateur \TeX{} un peu plus moderne …

\end{document}

Pour le compiler, tapez simplement xelatex à la place de pdflatex :

xelatex monfichier.tex

Après avoir essayé de nombreuses polices alternatives, je suis revenu à la police TeX de base, que je trouve la plus esthétique, et qui couvre une large palette de caractères. Donc j’utilise la ligne fontspec mais pas la setmainfont.

Le passage à l’Unicode ouvre la voie à de nombreuses améliorations dans le fonctionnement de LaTeX, par exemple dans les césures des mots accentués. Le paquet Polyglossia est un remplaçant moderne de Babel, qui ne présente pas de difficulté pour les césures des mots accentués.

Note : LuaTeX permet également l’utilisation de fichiers Unicode.

Où accumuler les connaissances ?

Au début, vous pouvez simplement copier-coller systématiquement vos en-têtes LaTeX de document en document, en enrichissant petit à petit le contenu. L’inconvénient est que ça entraîne beaucoup de duplication de code et de pollution visuelle au début de votre fichier. La pollution du document peut être évitée en mettant les en-têtes dans un fichier séparé du contenu, et en l’incluant via la commande \input. Mais où mettre ce fichier d’en-tête ? Vous pouvez le dupliquer de dossier en dossier pour chacun de vos documents, ou vous pouvez le conserver à un seul endroit et y faire référence par un chemin absolu.

En fait, le système LaTeX a prévu ce problème et propose une solution standard, que nous allons découvrir ici.

L’arbre texmf

Chaque utilisateur peut, dans son dossier personnel, placer un dossier texmf qui sera son « arbre local TeX ». Le contenu de ce dossier sera automatiquement reconnu par LaTeX et directement utilisable dans tous vos documents. Il y a plusieurs usages pour un tel arbre, et nous allons voir quelques exemples. Attention, pour pouvoir utiliser l’arbre texmf, il faudra l’indexer, la procédure est expliquée plus loin.

Les images

S’il vous arrive souvent d’utiliser un jeu d’images pour vos documents, vous pouvez les placer dans l’arbre. Vous pourrez ensuite y faire référence dans votre document par un simple nom de fichier. Par exemple, placez vos logos dans ~/texmf/tex/latex/pictures/logos.

Les paquets

Vous pouvez installer manuellement des paquets LaTeX dans votre arbre local pour les utiliser par la suite dans vos documents. Pour cela, suivez ces instructions.

Vous pouvez également créer vos propres paquets pour y mettre vos fonctions préférées. Par exemple, on va créer une commande spéciale pour les adresses internet : \simpleLink. Elle prendra un seul argument, l’adresse, et l’insérera dans le document en la rendant cliquable. Dans ~/texmf/tex/latex/packages/my-urls.sty, insérez :

%%% URLS
%%%
%%% Utilisation : \simplelink{www.foo.bar}

\ProvidesPackage{my-urls}

\newcommand{\simplelink}[1]{%
  \href{http://#1}{#1}}

Voila ! Vous venez de faire votre paquet, vous pourrez l’inclure dans vos documents et classes via \usepackage{my-urls} pour accéder à votre fonction \simpleLink.

Les classes

Essayez toujours de faire vos documents avec classe ! N’hésitez pas à créer vos propres classes pour y placer les en-têtes que vous utilisez systématiquement. Par exemple, ouvrez ~/texmf/tex/latex/classes/mon-article.cls dans votre éditeur pour y placer ce qui suit.

\NeedsTeXFormat{LaTeX2e}[2003/12/01]
\ProvidesClass{mon-article}
%              [2010 - Classe XeLaTeX pour rapports courts]

\ProcessOptions\relax

% vous pouvez dériver d'une classe existante
\LoadClassWithOptions{article}

\usepackage{fontspec}
\usepackage[french]{babel} % \og \fg \nombre{1234} 
\usepackage[xetex]{hyperref}

\setpapersize{A4}

\newcommand{\todo}[1]{\marginpar{{\color{red}#1}}}

\newenvironment{vcenterpage}
{\vspace*{\fill}}
{\vspace*{\fill}\par}

\setlength{\parindent}{1em}
\setlength{\parskip}{.15em}
\widowpenalty=500
\clubpenalty=500
\raggedbottom

Voila, vous venez de créer votre classe LaTeX, que vous pouvez utiliser via \documentclass{mon-article}.

Indexation de l’arbre

L’indexation de l’arbre est une opération manuelle et obligatoire dès que vous en modifiez le contenu. Heureusement, elle est simple et rapide :

texhash ~/texmf

Votre arbre est maintenant prêt à être utilisé ! Vous pouvez y créer vos paquets, vos classes, et y mettre tout contenu dont vous avez régulièrement besoin pour vos documents.

Configuration de SSL/TLS

Le protocole LDAP accepte le chiffrement par SSL en utilisant soit le protocole LDAPS sur un port dédié, soit la commande STARTTLS. Le support du chiffrement SSL étant variable selon les clients LDAP, il est important de maintenir plusieurs canaux d’accès au serveur. Voici une règle d’accès à placer en premier dans votre configuration qui :

• autorise de manière inconditionnelle les accès chiffrés ;
• autorise les accès non chiffrés uniquement par l’interface locale.

access to *
      by peername.ip=127.0.0.1 break
      by ssf=56 break
      by * none

Tester la connexion chiffrée

Les clients LDAP ne sont pas toujours explicites quand la connexion est impossible à cause d’une erreur SSL. Les commandes openssl ou gnutls-cli permettent de valider rapidement la mise en place de SSL.

# Test ldaps :
$ openssl s_client -connect votre_serveur_ldap:636 -CAfile /etc/ssl/certs/ca-certificates.crt
# ou avec gnutls :
$ gnutls-cli --x509cafile /etc/ssl/certs/ca-certificates.crt -p 636 votre_serveur_ldap

Certains nœuds sont introuvables

Si votre serveur LDAP ne retrouve plus des entrées qui sont pourtant bien présentes dans l’arbre, il y a fort à parier que les indexes sont périmés. Cela arrive de manière certaine après avoir modifié les critères d’indexation dans la configuration du serveur. Dans ce cas, la procédure est simple :

1. stopper le serveur LDAP ;
2. exécuter la commande slapindex sous l’utilisateur qui fait tourner le serveur (openldap sous debian) ;
3. relancer le serveur !