Devo evidenziare il codice sorgente in LaTeX. Il pacchetto listingssembra essere la scelta migliore per la maggior parte dei casi d'uso e per me lo è stato, fino ad ora.

Tuttavia, ora ho bisogno di maggiore flessibilità. In generale, quello che sto cercando è un vero lexer. In particolare, ho bisogno (per una definizione della propria lingua) di definire (ed evidenziare!) I propri stili numerici. listingsnon consente l'evidenziazione dei numeri nel codice. Tuttavia, devo produrre qualcosa del genere:

listingsinoltre non può far fronte a delimitatori arbitrari per le stringhe. Considera il seguente codice Ruby valido:

s = %q!this is a string.!

Qui, !può essere sostituito da quasi tutti i delimitatori.

(Che listingsnon può gestire Unicode è anche abbastanza fastidioso, ma questo è un altro problema.)

Idealmente, sto cercando un'estensione listingsche mi permetta di fornire regole di lexing più complesse. Ma a parte questo, sto anche cercando alternative praticabili.

Altri thread hanno suggerito di usare Pygments che possono produrre output LaTeX. C'è anche un pacchetto - texments- per facilitare la transizione.

Tuttavia, questo manca di funzionalità. In particolare, sono interessato alla listingsnumerazione delle righe in stile, ai riferimenti alle righe del codice sorgente e alla possibilità di incorporare LaTeX nel codice sorgente (opzioni texcle mathescapein listings).

Ad esempio, ecco un set di codice sorgente con il listingsquale mostra alcune delle cose che una sostituzione dovrebbe anche fornire:

^{_{["Aggiunta laterale" modificata da Bit Twiddling Hacks]}}

Prendendo a cuore il consiglio di Norman, ho messo insieme una soluzione che utilizzava (un patch ) Pygments per evidenziare e inserire il maggior numero possibile di funzionalità senza scoppiare ;-)

Ho anche creato un pacchetto LateX, una volta che la mia patch di Pygments è stata rilasciata nella versione 1.2 ...

Presentazione coniata

coniato è un pacchetto che utilizza Pygments per fornire l'evidenziazione della sintassi di prim'ordine in LaTeX. Ad esempio, consente il seguente output.

Ecco un file minimo per riprodurre il codice sopra (nota che l'inclusione di caratteri Unicode potrebbe richiedere 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 = "This is a Unicode π in the sky"
  /*
  Defined as $\pi=\lim_{n\to\infty}\frac{P_n}{d}$ where $P$ is the perimeter
  of an $n$-sided regular polygon circumscribing a
  circle of diameter $d$.
  */
  const double pi = 3.1415926535
\end{minted}
\end{document}

Questo può essere composto usando il seguente comando:

xelatex -shell-escape test.tex

(Ma coniato funziona anche con latexe pdflatex...)

minted.styfunziona in modo simile texments.styma consente funzionalità aggiuntive.

Come ottenerlo

• coniato è elencato su CTAN ( informazioni sul pacchetto )

• la documentazione è ovviamente inclusa.

• ora coniato è gestito da Geoffrey Poore. La versione di sviluppo, incluso l'ultimo .styfile , è disponibile su github.com/gpoore/minted e può essere clonata da lì.

Ancora una volta, grazie a Norman per avermi motivato a produrre questo pacchetto.

TeX è (notoriamente) Turing completo, ma sono abbastanza sicuro che dovrai scrivere tu stesso questa estensione. La documentazione chiarisce che l'autore originale l'ha listingsreso orfano nel 2004 e che non è stato aggiornato dal 2006. Il pacchetto non è stato progettato per sovrascrivere la formattazione dei letterali numerici, ma potresti essere in grado di modificarlo cambiando il definizione di \lst@ProcessDigit. Se ciò non funziona, dovrai capire in dettaglio come funzionano le opzioni di "stile identificatore" e dovrai duplicare quel macchinario per i tuoi letterali numerici.

Non capisco bene perché sei così riluttante a introdurre uno strumento esterno nella tua toolchain, ma poiché lo sei, dovrai fare un lavoro extra. Dopo aver esaminato il codice sorgente, mi aspetto che la modifica listingssia possibile, ma personalmente sceglierei di preelaborare il mio LaTeX.

Questo è un pacchetto che converte il codice sorgente in TeX e LaTeX con l'evidenziazione della sintassi. È possibile aggiungere facilmente definizioni personalizzate del linguaggio di programmazione.

L'evidenziazione supporta 100 linguaggi di programmazione e include 50 temi di colore. È dotato di riformattazione e rientro del codice.

Non l'ho usato per sapere come BENE funziona, ma qualcun altro che conosco ha detto che ha funzionato abbastanza bene. Se ne avrò la possibilità, lo proverò da solo e vedrò.