Saya perlu menyoroti kode sumber di LaTeX. Paket tersebut listingstampaknya menjadi pilihan terbaik untuk sebagian besar kasus penggunaan dan bagi saya, sampai sekarang.

Namun, sekarang saya perlu lebih banyak fleksibilitas. Secara umum, apa yang saya cari adalah lexer nyata . Secara khusus, saya perlu (untuk definisi bahasa sendiri) untuk mendefinisikan (dan menyoroti!) Gaya nomor sendiri. listingstidak mengizinkan penyorotan angka dalam kode. Namun, saya perlu membuat sesuatu seperti ini:

listingsjuga tidak dapat mengatasi pembatas acak untuk string. Pertimbangkan kode Ruby yang valid berikut:

s = %q!this is a string.!

Di sini, !dapat diganti oleh hampir semua pembatas.

(Itu listingstidak bisa menangani Unicode juga cukup menjengkelkan, tapi itu masalah lain.)

Idealnya, saya mencari perpanjangan listingsyang memungkinkan saya untuk memberikan aturan lexing yang lebih kompleks. Tetapi selain itu, saya juga mencari alternatif yang layak.

Utas lain menyarankan menggunakan Pygments yang dapat menghasilkan keluaran LaTeX. Bahkan ada paket - texments- untuk memudahkan transisi.

Namun, ini sangat kekurangan fitur. Secara khusus, saya tertarik pada listingspenomoran baris-gaya, referensi baris kode sumber, dan kemungkinan menanamkan LaTeX dalam kode sumber (opsi texcldan mathescapedalam listings).

Sebagai contoh, inilah set kode sumber listingsyang menunjukkan beberapa hal yang harus disediakan oleh pengganti:

^{_{["Tambahan Sideways" dimodifikasi dari Bit Twiddling Hacks]}}

Mengambil nasihat Norman ke dalam hati, saya telah meretas bersama solusi yang menggunakan Pygments ( tambalan ) untuk menyoroti dan mendorong sebanyak mungkin fitur tanpa meledak ;-)

Saya juga telah membuat paket LateX, setelah patch Pygments saya dirilis di versi 1.2 ...

Menyajikan dicetak

minted adalah paket yang menggunakan Pygments untuk memberikan highlight sintaksis terkemuka di LaTeX. Sebagai contoh, ini memungkinkan output berikut.

Berikut adalah file minimal untuk mereproduksi kode di atas (perhatikan bahwa termasuk karakter Unicode mungkin memerlukan 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}

Ini dapat diketik menggunakan perintah berikut:

xelatex -shell-escape test.tex

(Tapi dicetak juga bekerja dengan latexdan pdflatex...)

minted.stybekerja serupa dengan texments.stytetapi memungkinkan fitur tambahan.

Bagaimana cara mendapatkannya

• dicetak adalah terdaftar di CTAN ( paket Info )

• Dokumentasi tentu saja disertakan.

• minted sekarang dikelola oleh Geoffrey Poore. Versi pengembangan, termasuk .styfile terbaru , tersedia di github.com/gpoore/minted , dan dapat dikloning dari sana.

Sekali lagi, terima kasih kepada Norman karena telah memotivasi saya untuk memproduksi paket ini.

TeX (terkenal) Turing-complete, tapi saya cukup yakin Anda harus menulis ekstensi ini sendiri. Dokumentasinya memperjelas bahwa penulis asli listingsmenjadi yatim piatu pada tahun 2004, dan belum diperbarui sejak 2006. Paket ini tidak dirancang untuk mengganti format literal angka, tetapi Anda mungkin dapat memodifikasinya dengan mengubah definisi\lst@ProcessDigit . Jika itu tidak berhasil, Anda harus memahami secara detail bagaimana opsi "gaya pengenal" bekerja, dan Anda harus menduplikasi mesin itu untuk literal numerik Anda.

Saya tidak begitu mengerti mengapa Anda begitu enggan untuk memperkenalkan alat eksternal ke dalam rantai alat Anda, tetapi karena Anda, Anda harus melakukan pekerjaan ekstra. Setelah melihat kode sumber, saya berharap bahwa memodifikasi listingsharus dimungkinkan, tetapi saya pribadi akan memilih untuk memproses ulang LaTeX saya sebagai gantinya.

Ini adalah paket yang mengubah kode sumber ke TeX dan LaTeX dengan penyorotan sintaksis. Dimungkinkan untuk menambahkan definisi bahasa pemrograman kustom dengan mudah.

Sorot mendukung 100 bahasa pemrograman dan termasuk 50 tema warna. Ini fitur pemformatan ulang dan indentasi kode.

Saya belum menggunakannya untuk mengetahui cara kerja BAIK, tetapi orang lain yang saya kenal mengatakan itu bekerja dengan cukup baik. Jika saya mendapat kesempatan, saya akan mencobanya sendiri dan melihat.