Geekographie Maïeulesque

ArabLuaTeX : ArabTeX pour LuaLaTeX

Robert Alessi — 2016-04-13T06:30:00Z

La notation « ArabTeX » a été introduite sous TeX/LaTeX en 1992. Elle a été ensuite portée sous XeLaTeX par arabxetex. arabluatex l'introduit pour la première fois sous LuaLaTeX. arabluatex ne prend actuellement en charge que la langue arabe. C'est une différence importante par rapport à arabtex qui intègre un grand nombre de langues sémitiques. De nouvelles langues seront progressivement ajoutées à arabluatex, à commencer par l'hébreu et le syriaque.

Présentation

Il n'est pas question d'entrer ici dans le détail. Le package, actuellement en version 1.0.1 est publié sur le CTAN, où l'on peut trouver une documentation complète.

Pour une comparaison entre arabtex (pour (La)TeX), arabxetex (pour XeLaTeX) et arabluatex (pour LuaLaTeX), je renvoie à cette documentation (point 1.1).

Comme arabtex, arabluatex transforme la notation ASCII ArabTeX en arabe unicode. Cette notation est intéressante à deux titres :

elle s'intègre parfaitement au code informatique. Cela est particulièrement important quand il s'agit de saisir des documents complexes, tels que des documents scientifiques ou des éditions critiques dans lesquelles abondent toutes sortes d'annotations. Ce n'est pas le cas du script arabe unicode, qui perturbe constamment le sens des crochets, parenthèses, accolades et autres signes informatiques, sans parler des interversions de mots.
elle permet un encodage précis de la langue arabe, et donne la possibilité, par exemple, de séparer les préfixes, les particules et les affixes, introduisant ainsi la possibilité de recherches grammaticales selon des critères complexes.

Il faut ajouter à cette liste les différentes possibilités de traitement du code ASCII ArabTeX :

vocalisation totale (scriptio plena) : mode [fullvoc]
vocalisation : mode [voc]
arabe non-vocalisé (scriptio defectiva) : mode [novoc]
translittération selon les différents standards : mode [trans]

Tous ces traitements sont possibles à partir d'une seule opération de saisie.

Particularités

Le fonctionnement d'arabluatex est très différent de celui de ses prédécesseurs. Le traitement du code ASCII ne repose ni sur TeX ni sur le moteur TECkit, mais sur un jeu de fonctions Lua. Dans un premier temps, sont traitées dans les environnements arabes toutes les commandes LaTeX qui sont censées avoir de l'arabe dans leurs arguments, comme \emph ou \textbf. Ensuite, le code ASCII, une fois isolé, est confié à de nouvelles fonctions qui appliquent diverses tables de correspondances selon les choix qui ont été faits.

Autre particularité très importante : arabluatex ne fait appel ni à polyglossia ni à luabidi. Les sens d'écriture sont pris en charge directement par les primitives de LuaTeX que sont \pagedir \bodydir \pardir et \textdir. Sous LuaTeX, c'est en effet toujours ainsi que l'on devrait régler les sens d'écriture.

Dernier point important : arabluatex ne traite pas le code ASCII tout à fait comme ses prédécesseurs. Il faut donc lire la documentation avant de l'utiliser.

Pour ne prendre ici qu'un exemple, sous arabluatex on ne doit jamais écrire deux fois une lettre solaire pour obtenir le tašdīd euphonique. Ainsi, pour obtenir اَلشَّمسُ, on peut écrire al-^samsu ou a^s-^samsu, mais jamais al-^s^samsu qui est en fait absurde.

arabluatex et reledmac

Dans les environnements \arb{} ou\begin{arab} ... \end{arab} la commande à double argument \edtext{}{} est prise en charge. On peut ainsi avoir ceci :

\beginnumbering \pstart \begin{arab} wa-ya.sIru ta.hta 'l-jildi \edtext{\arb{.sadIduN}}{\Afootnote{M: \arb{.sadIdaN} E1}} \end{arab} \pend \endnumbering

Comme on le voit, dans l'édition d'un texte arabe, il faut remettre la commande \arb{} dans le premier argument de \edtext{}{}. On peut ainsi avoir comme lemme du texte dans une autre langue que l'arabe.

arabluatex et les commandes complexes

Comme on l'a dit plus haut, toute commande LaTeX à argument simple, placée à l'intérieur d'un environnement arabe, est censée contenir exclusivement du texte arabe.

Parfois, ce n'est pas le cas. Par exemple, si l'on souhaite insérer une commande dont l'agument est une dimension, il faut l'insérer elle-même dans la commande \RL{} fournie par arabluatex, comme ceci :

\begin{arab} da_hala \RL{\hspace{1in}} mubtasimaN \end{arab}

Si l'argument ne contient que de l'arabe, on écrira :

\begin{arab} \index{d_hl}da_hala mubtasimaN \end{arab}

Et c'est tout ! La « magie » de Lua fera le reste, et l'on obtiendra à la fin un index tout arabe, avec un classement alphabétique correct. En revanche, si la commande \index{} ne contient pas que de l'arabe, il faudra écrire :

\begin{arab} \RL{\index{d_hl|see{...}}}da_hala mubtasimaN \end{arab}

En conclusion

Happy LuaTeXing, bien sûr !

Comment convertir un article saisi en .tex vers un traitement de textes

Robert Alessi — 2015-02-13T12:09:16Z

Pandoc est présenté comme le « couteau suisse » des convertisseurs de documents. Nous nous proposons ici de l'utiliser dans un but précis. Le cas pratique est le suivant : nous avons saisi un article sous (X^e)LaTeX, mais l'éditeur réclame un fichier dans un format de traitement de texte, avec une bibliographie ou bien une liste des références à la fin. Avec pandoc, ce type de transformation est très facile à réaliser, même à partir d'un document source .tex relativement complexe.

Dans le document simple que j'attache à la fin de cet article, on trouvera la plupart des commandes que l'on utilise dans un article : citations, notes de bas de page, bibliographie. On trouvera aussi des mots en grec ancien, et même en arabe. Le but est de montrer comment on peut travailler entièrement sous XeLaTeX, puis convertir l'article au dernier moment dans le format .odt pour le donner à l'éditeur.

Le préambule du document .tex

Il doit être aussi simple que possible pour une raison évidente : les raffinements typographiques et de mise en page sont réservés à (X^e)LaTeX lui-même. Le fichier de traitement de texte devra être propre, et répondre aux exigences de base de l'éditeur, qui le reprendra de toute façon dans son propre système de mise en page.

On peut donc partir de ceci :

\documentclass{article}
% J'aime bien toujours charger babel dont la typographie est bien
% meilleure que celle de polyglossia. Mais si vous le souhaitez,
% ou si vous en avez besoin, vous pouvez toujours mettre:
% \usepackage{polyglossia}
% \setdefaultlanguage{french}
\usepackage[french]{babel}
\usepackage{fontspec,xltxtra}
\setmainfont{Linux Libertine O}
\setsansfont{Linux Biolinum O}
\setmonofont[Scale=.9]{Linux Libertine Mono O} \usepackage{csquotes} \title{}
\author{}

À vrai dire, on peut se contenter de :

\documentclass{article}
\usepackage{fontspec,xltxtra} \title{}
\author{}

car par défaut, pandoc ignorera les paramètres de langue et les polices de caractère. Le plus simple sera de choisir ces éléments dans les paramètres du document de traitement de texte, comme nous le verrons à la fin de cet article. J'ai cependant ajouté ces lignes dans le préambule du source .tex, car on peut souhaiter compiler le document plusieurs fois avant de le passer sous traitement de texte.

Auquel cas, une solution est de créer deux préambules : l'un pour LaTeX, l'autre pour pandoc. On les écrira dans deux fichiers distincts qu'on inclura au cas par cas.

Les commandes courantes

Quels sont les éléments couramment utilsés dans un article ? On peut penser à ceci :

un résumé :
```
\begin{abstract}
\end{abstract}
```
des commandes de division de texte : \section{}, \subsection{}, \paragraph{}, etc.
des notes de bas de page : \footnote{}
des citations :
```
\begin{quote}
\end{quote}
```
des citations en vers :
```
\begin{verse}
\end{verse}
```
des commandes de mise en forme des mots \emph{}, \textbf{}

Tout cela est parfaitement pris en charge par pandoc.

Tableaux

Les tableaux sont également pris en charge, mais les extensions telles que longtable ne le sont pas. Si le document comporte des tableaux longs, on les saisira néanmoins dans l'environnement standard tabular. Sous (X^e)LaTeX, les résultats ne seront pas bons, mais les tableaux seront correctement convertis sous traitement de texte.

Si on utilise longtable sans utiliser de type de colonnes personnalisé, une solution peut être de mettre dans le préambule spécifique à pandoc les lignes suivantes :

\let\longtable\tabular
\let\endlongtable\endtabular

Ce qui permettra d'utiliser longtable lorsqu'on utilise (X^e)LaTeX.

Langues étrangères

La seule contrainte est de les saisir en unicode : tous les caractères seront convertis, et même les langues qui se lisent de droite à gauche, comme l'arabe, seront reconnues. Si les textes en langue étrangère sont saisis dans des commandes telles que \textgreek{} pour le grec ou \textarab{} pour l'arabe, peu importe : les commandes seront le plus souvent ignorées.

Dans certains cas cependant, les commandes de changement de langue propres polyglossia produisent des effets inattendus : on a ainsi constaté en faisant des tests que des commandes telles que \textfrench{} ou \textlatin{} ne produisaient rien ! Les textes passés en argument disparaissent tout simplement !

Dans ce cas, il faut neutraliser ces commandes dans le préambule, de la façon suivante (l'exemple qui suit neutralise les deux commandes données au paragraphe précédent) :

\renewcommand{\textfrench}[1]{#1}
\renewcommand{\textlatin}[1]{#1}

En fonction des commandes à neutraliser, on adaptera ce code, qu'il faut évidemment placer dans le préambule après celles qui ont servi à charger polyglossia ou tout autre package dans lequel ces commandes sont définies.

Bibliographie

On prend ici le cas d'une bibliographie construite à l'aide de biblatex/biber. Le plus important est de comprendre que pandoc ignore les styles de citation et les styles de bibliographie que l'on a choisis dans le source .tex. À la place, pandoc peut utiliser tout style au format CSL. Il en exixte un très grand nombre (voir ci-dessous).

Dans le document, on peut utiliser les commandes de citation suivantes :

\cite{}
\autocite{}
\citeyear{}
\parencite{}
\footcite{}
\textcite[avant][après]{}
\smartcite[avant][après]{}
\autocite{}
\citeauthor{}

Et à la fin du document, on mettra simplement \printbibliography. Les bibliographies multiples ne sont pas prises en charge.

Conversion du document

La conversion se fait à la ligne de commande.

Pour un document sans bibliographie, on fait ceci :

pandoc --latex-engine=xelatex article.tex -o article.odt

Pour un document avec bibliographie, on a deux possibilités.

1 Choix par défaut du style Chicago author-date :

pandoc --bibliography="bibliographie.bib" --biblatex \
--latex-engine=xelatex article.tex -o article.odt

Cette commande convertit le fichier article.tex vers article.odt, en utilisant pour les citations le fichier bibliographie.bib.

2 Choix d'un style CSL. Dans cet exemple, j'utilise le style « harvard-kings-college-london » :

pandoc --filter pandoc-citeproc --csl=harvard-kings-college-london.csl \
--bibliography="bibliographie.bib" --biblatex \
--latex-engine=xelatex article.tex -o article.odt

Pour récupérer un style existant, on peut se rendre ici : https://www.zotero.org/styles. Le dépôt Git est ici : https://github.com/citation-style-language/styles.

Il faut enregistrer le fichier CSL au même endroit que les fichiers .tex et .bib.

Post-traitement

Observez bien le fichier de sortie. Vous remarquerez qu'il est bien stylé. Il sera alors très facile de générer une table des matières.

En ce qui concerne les langues à caractères non-occidentaux, comme le grec ou l'arabe, il suffit encore de modifier les paramètres du document LibreOffice pour que tout soit adapté parfaitement sur l'ensemble du document. Dans le document LibreOffice attaché, voici comment j'ai procédé :

Langue française

Typographie

Remarquez que l'utilisation des features OpenType dans les paramètres dits des « Polices standard (occidentales) » a pour effet d'insérer automatiquement des espaces fines entre les mots et tout signe de ponctuation double.

Fichiers

Voici les fichiers que j'ai utilisés. Ils vous permettront de vous entraîner !

Comment convertir un article saisi en .tex vers un traitement de textes

Zip de l'ensemble des fichiers - 625.6 kio

Documentation sur les fichiers de style CSL (format xml) : http://citationstyles.org/downloads/primer.html

Éditer un texte arabe avec eledmac

Robert Alessi — 2014-03-22T17:57:04Z

Cet article explique comment utiliser eledmac pour présenter l'édition critique d'un texte arabe avec un apparat critique rédigé de droite à gauche. Il a été écrit non par l'auteur habituel de ce blog, mais par Robert Alessi [1].

Introduction

L'édition critique d'un texte arabe est une tâche complexe. Sous XeLaTeX, plusieurs possibilités s'offrent à l'éditeur :

utiliser polyglossia seul, et tout saisir en arabe ;
utiliser polyglossia combiné avec arabxetex qui permet, au choix, de saisir le texte en arabe ou bien de le coder en arabtex.

Avant de commencer, il faut bien réfléchir. Si on décide de saisir tout en arabe une édition complexe, avec plusieurs lignes d'apparat critique à chaque page, l'introduction, dans des paragraphes rédigés de droite à gauche, de multiples séquences telles que \edtext{...}{\Afootnote{...}}, transformées en {{...}edtext{...}{\Afootnote\, se transformera vite en torture pour l'éditeur. On peut certes améliorer cette présentation en introduisant dans le texte des tags unicode invisibles permettant d'insérer du texte LTR dans des paragraphes RTL, mais cette technique nécessite une discipline très rigoureuse qui exige bien plus de concentration que la saisie du texte critique lui-même.

Une autre solution consiste à utiliser arabxetex en plus de polyglossia qui reste obligatoire pour la mise en page d'ensemble. À mon avis, cela présente de multiples avantages :

arabxetex permet toujours la saisie unicode. Par exemple, sous arabxetex, la séquence \textarab{أَهلًا وَسَهلًا} est strictement équivalente à la séquence \textarab{'ahlaN wa-sahlaN} ;
que l'on ait choisi de saisir en unicode ou bien en arabtex, arabxetex permet de régler en une seule opération la vocalisation de tout le texte. Il suffit de changer une simple option dans le préambule pour cela :
\usepackage{arabxetex} —> texte non vocalisé ;
\usepackage[voc]{arabxetex} —> texte vocalisé ;
\usepackage[fullvoc]{arabxetex} —> texte vocalisé entièrement (scriptio plena), avec waṣla, sukūn, etc. ; [2]

Illustration

Dans l'exemple présenté ici, on a choisi la saisie en arabtex. L'apparat critique est présenté de droite à gauche et rédigé en latin.

Les premières lignes du préambule se passent de commentaire. Comme les variantes sont présentées en latin, on a choisi de charger par défaut une série de polices de caractères adaptées. Si l'on est sûr de ne pas avoir à saisir des mots latins dans l'apparat ou ailleurs dans le texte, les lignes

\setmainfont{Linux Libertine O}
\setsansfont{Linux Biolinum O}
\setmonofont[Scale=.8]{Linux Libertine Mono O}

peuvent être omises.

On charge ensuite polyglossia :

\usepackage{polyglossia}
\setdefaultlanguage{arabic}

puis, si on souhaite l'utiliser, arabxetex lui-même :

\newfontfamily\arabicfont[Script=Arabic]{Amiri}
\usepackage[fullvoc]{arabxetex}
\newcommand{\ta}{\textarabic}
\newcommand{\tanv}[1]{\textarabic[novoc]{#1}}

Remarques :

si l'on ne souhaite pas utiliser arabxetex, il faudra maintenir la ligne qui charge la police arabe pour que polyglossia puisse l'utiliser ;
dans cet exemple, on présente par défaut l'arabe vocalisé (option fullvoc) ; on a en outre défini deux nouvelles commandes : l'une, \ta{} est un raccourci pour \textarabic{} tandis que l'autre, \tanv{}, permet de saisir exceptionnellement des mots en scriptio defectiva.

Si l'on s'en tient là, XeLaTeX se plaindra à chaque compilation en précisant que arabxetex tente d'utiliser une commande, \aemph{}, qui est déjà définie par polyglossia. Pour éviter cela, on ajoute la ligne :

\let\aemph\veryundefinedcommand

puis l'on définit le sens d'écriture des notes de bas de page et la position du filet séparateur des notes :

\usepackage{bidi}
\setfootnoteRL
\rightfootnoterule

Techniquement parlant, \usepackage{bidi} n'est pas nécessaire, car le package en question est chargé automatiquement par polyglossia et arabxetex.

Viennent enfin eledmac et ses options. Parmi celles-ci,

\renewcommand{\numlabfont}{\fontspec[Mapping=arabicdigits]{Amiri}}

permet d'obtenir la numérotation des lignes en chiffres indiens si on le souhaite. Pour illustrer cela, on a choisi ici de numéroter chaque ligne de texte.

Exemple complet

\documentclass[a4paper,article,12pt]{memoir}
\usepackage[no-math]{fontspec}
\usepackage{xltxtra,xunicode,amsmath}
\defaultfontfeatures{Ligatures=TeX}
\setmainfont{Linux Libertine O}
\setsansfont{Linux Biolinum O}
\setmonofont[Scale=.8]{Linux Libertine Mono O} \usepackage{polyglossia}
\setdefaultlanguage{arabic}
\newcommand{\up}[1]{\textsuperscript{#1}} \newfontfamily\arabicfont[Script=Arabic]{Amiri}
\usepackage[fullvoc]{arabxetex}
\newcommand{\ta}{\textarabic}
\newcommand{\tanv}[1]{\textarabic[novoc]{#1}} % Pour permettre à polyglosssia et arabxetex de coexister:
\let\aemph\veryundefinedcommand \usepackage{bidi}
\setfootnoteRL
\rightfootnoterule \usepackage{eledmac}
\lineation{page}
\firstlinenum{1}
\linenumincrement{1}
\footparagraph{A}
\renewcommand{\numlabfont}{\fontspec[Mapping=arabicdigits]{Amiri}} \begin{document}
\thispagestyle{empty} \beginnumbering \pstart
\begin{arab} al-maqAlaTu 'l-'Ul_A min tafsIri jAlInUsa \edtext{li-l-maqAlaTi}% {\lemma{\ta{li-l-maqAlaTi\ldots\ 'ifI_dImiyA}}\Afootnote{ \textLR{M: om. E1 restit. E1\up{3mg}}}} 'l-_t_tAniyyaTi min kitAbi 'abuqrA.ta 'l-musamm_A 'ifI_dImiyA \edtext{tarjamaTu}% {\lemma{\ta{tarjamaTu\ldots\ 'is.h_aqa}}\Afootnote{\textLR{M: om.E1}}} .hunayniN \edtext{ibni}{\Afootnote{\textLR{scripsi:} \tanv{bn} \textLR{M}}} \edlabel{tit-ishaqin}'is.h----_aqa
\end{arab}
\pend \pstart \begin{arab} (1) qAla 'abuqrA.tu: al-jamru 'l-.s.sayfiyyu 'lla_dI kAna bi-qrAn|nUna jA'at 'am.tAruN jUduN maa .harri 'l-.s.sayfi kullihi wa-kAna 'ak_taru mA yakUnu maa 'l-janUbi wa-ya.sIru ta.hta 'l-jildi \edtext{.sadIduN}{\Afootnote{\textLR{M: \ta{.sadIdaN} E1}}} \edtext{fa-'i_dA}{\Afootnote{\textLR{E1: \ta{wa-'i_dA} M}}} {\char"0671}.htaqana saxuna wa-wallada \edtext{.hikkaTaN}{\Afootnote{\textLR{M E1\up{2mg}}}} \edtext{_tumma}{\Afootnote{\textLR{om. M}}} kAnat taxruju fIhi nuffa.hAtuN \edtext{\ta{^sabIhaTuN bi-.harIqi}}{\Afootnote{M: \tanv{ta^sbIh|h bi-.hrq} E1}} 'l-nnAri wa-kAna tuxuyyalu 'ilayhim 'anna mA dUna 'l-jildi ya.htariqu {\char"0671}.htirAqaN. \end{arab}
\pend \endnumbering \end{document}

Exemple d'édition de texte arabe au format PDF

On me demande souvent quel est le meilleur éditeur de texte pour saisir de l'arabe. Je réponds ici très rapidement à cette question :

emacs est désormais parfaitement capable de faire ce travail ;
texstudio est également excellent dans ce domaine, bien meilleur que texmaker qui n'est pas capable d'aligner à droite les paragraphes saisis en arabe. Par ailleurs, texmaker ne gère pas le hard wrap. À la place, il « enroule » les lignes, ce qui consomme beaucoup de mémoire et finit par ralentir considérablement le logiciel à mesure que le fichier grossit ;
scribes est à mon avis le meilleur de tous : arabe unicode parfaitement formaté et très lisible ;
yudit : parfait, mais ne connaît pas le langage LaTeX. Donc pas de syntax highlighting, ni de raccourcis.

[1] Si d'autres veulent proposer des articles, ils sont le bienvenus.

[2] une autre option, trans, permet de translittérer le texte arabe automatiquement en caractères romains. Cela dépasse l'objet du présent article.