Mise en évidence du code source en LaTeX

Question

Je dois mettre en évidence le code source en LaTeX. Le package listings semble être le meilleur choix pour la plupart des cas d'utilisation et pour moi aussi, jusqu'à maintenant.

Cependant, maintenant j'ai besoin de plus de flexibilité. En général, ce que je cherche est un véritable lexer. En particulier, j'ai besoin (pour une définition de langage personnalisée) de définir (et mettre en évidence !) des styles de numérotation personnalisés. listings ne permet pas de mettre en évidence les nombres dans le code. Cependant, j'ai besoin de produire quelque chose comme ceci :

listings ne peut pas non plus gérer des délimiteurs arbitraires pour les chaînes. Considérez le code Ruby valide suivant :

s = %q!this is a string.!

Ici, ! peut être remplacé par presque n'importe quel délimiteur.

(Le fait que listings ne puisse pas gérer l'Unicode est également assez frustrant, mais c'est un autre problème.)

Idéalement, je cherche une extension de listings qui me permet de fournir des règles de lexing plus complexes. Mais en l'absence de cela, je recherche également des alternatives viables.

D'autres fils ont suggéré d'utiliser Pygments qui peut produire une sortie LaTeX. Il y a même un package - texments - pour faciliter la transition.

Cependant, cela manque cruellement de fonctionnalités. En particulier, je m'intéresse à la numérotation des lignes de style listings, aux références de lignes de code source et à la possibilité d'intégrer du LaTeX dans le code source (options texcl et mathescape dans listings).

Par exemple, voici un code source mis en forme avec listings qui montre certaines des choses qu'un remplacement devrait également fournir :

_{[“Addition de côté” modifiée à partir de Bit Twiddling Hacks]}

Answer 1

En prenant à cœur les conseils de Norman, j'ai bricolé une solution qui utilisait (un patched) Pygments pour la mise en évidence et ai intégré autant de fonctionnalités que possible sans exploser ;-)

J'ai également créé un package LateX, une fois que mon correctif Pygments a été publié dans version 1.2 ...

Présentation de minted

minted est un package qui utilise Pygments pour fournir une coloration syntaxique de qualité supérieure dans LaTeX. Par exemple, cela permet de produire la sortie suivante.

Voici un fichier minimal pour reproduire le code ci-dessus (remarquez que l'inclusion de caractères Unicode peut nécessiter XeTeX)!

\documentclass[a4paper]{article}
\usepackage{fontspec}
\usepackage{minted}

\setsansfont{Calibri}
\setmonofont{Consolas}

\begin{document}
\renewcommand{\theFancyVerbLine}{
  \sffamily\textcolor[rgb]{0.5,0.5,0.5}{\scriptsize\arabic{FancyVerbLine}}}

\begin{minted}[mathescape,
               linenos,
               numbersep=5pt,
               gobble=2,
               frame=lines,
               framesep=2mm]{csharp}
  string title = "C'est un Unicode π dans le ciel"
  /*
  Défini comme $\pi=\lim_{n\to\infty}\frac{P_n}{d}$ où $P$ est le périmètre
  d'un polygone régulier à n côtés circonscrivant un
  cercle de diamètre $d$.
  */
  const double pi = 3.1415926535
\end{minted}
\end{document}

Cela peut être mis en forme à l'aide de la commande suivante:

xelatex -shell-escape test.tex

(Mais minted fonctionne également avec latex et pdflatex...)

minted.sty fonctionne de manière similaire à texments.sty mais permet des fonctionnalités supplémentaires.

Comment l'obtenir

• minted est listé sur CTAN (infos sur le package)

• la documentation est bien sûr incluse.

• minted est maintenant maintenu par Geoffrey Poore. La version de développement, incluant le dernier .sty fichier, est disponible sur github.com/gpoore/minted et peut être clonée à partir de là.

Encore une fois, merci à Norman de m'avoir motivé à produire ce package.

Answer 2

TeX est (à juste titre) Turing-complet, mais je suis assez sûr que vous devrez écrire cette extension vous-même. La documentation montre clairement que l'auteur original de listings l'a abandonnée en 2004 et qu'elle n'a pas été mise à jour depuis 2006. Le package n'a pas été conçu pour remplacer le formatage des littéraux numériques, mais vous pourriez être en mesure de le modifier en changeant la définition de \lst@ProcessDigit. Si cela ne fonctionne pas, vous devrez comprendre en détail le fonctionnement des options de "style d'identifiant" et vous devrez dupliquer cette machinerie pour vos littéraux numériques.

Je ne comprends pas vraiment pourquoi vous êtes si réticent à introduire un outil externe dans votre chaîne d'outils, mais étant donné que vous l'êtes, vous devrez faire un travail supplémentaire. Après avoir examiné le code source, je m'attends à ce que la modification de listings soit possible, mais personnellement je choisirais de prétraiter mon LaTeX à la place.

Answer 3

Le CTAN/highlight est un package qui convertit le code source en TeX et LaTeX avec une coloration syntaxique. Il est possible d'ajouter facilement des définitions de langage de programmation personnalisées.

Highlight prend en charge 100 langages de programmation et comprend 50 thèmes de couleurs. Il offre une reformatage et un indentation du code.

Je ne l'ai pas utilisé pour savoir à quel point il fonctionne bien, mais quelqu'un d'autre que je connais a dit que cela fonctionnait assez bien. Si j'ai l'occasion, je le testerai moi-même pour voir.

Answer 4

Do you have to use LaTeX? I migrated from it to Emacs org-mode a while ago and find the inline code editing capability much more convenient than listings (although I wasn't really a power user of the latter). Also, I'm not sure if the line numbers and other facilities you mentioned are readily available but actual highlighting is as flexible as a general mode in Emacs.