Tôi cần làm nổi bật mã nguồn trong LaTeX. Gói listingsdường như là sự lựa chọn tốt nhất cho hầu hết các trường hợp sử dụng và đối với tôi, cho đến bây giờ.

Tuy nhiên, bây giờ tôi cần linh hoạt hơn. Nói chung, những gì tôi đang tìm kiếm là một từ vựng thực sự . Cụ thể, tôi cần (đối với một định nghĩa ngôn ngữ riêng) để xác định (và tô sáng!) Các kiểu số riêng. listingskhông cho phép đánh dấu các số trong mã. Tuy nhiên, tôi cần phải sản xuất một cái gì đó như thế này:

listingscũng không thể đối phó với các dấu phân cách tùy ý cho các chuỗi. Hãy xem xét mã Ruby hợp lệ sau:

s = %q!this is a string.!

Ở đây, !có thể được thay thế bằng hầu như bất kỳ dấu phân cách.

(Điều đó listingskhông thể xử lý Unicode cũng khá khó chịu, nhưng đó là một vấn đề khác.)

Lý tưởng nhất, tôi đang tìm kiếm một phần mở rộng listingscho phép tôi cung cấp các quy tắc từ vựng phức tạp hơn. Nhưng để ngăn chặn điều đó, tôi cũng đang tìm kiếm các lựa chọn thay thế khả thi.

Các luồng khác đã đề xuất sử dụng Pygments có thể tạo đầu ra LaTeX. Thậm chí còn có một gói - texments- để dễ dàng chuyển đổi.

Tuy nhiên, điều này vô cùng thiếu tính năng. Cụ thể, tôi quan tâm đến việc listingsđánh số dòng kiểu, tham chiếu dòng mã nguồn và khả năng nhúng LaTeX vào mã nguồn (tùy chọn texclvà mathescapetrong listings).

Ví dụ, đây là một loại mã nguồn listingscho thấy một số điều mà một sự thay thế cũng sẽ cung cấp:

^{_{[Thêm Sideways bổ sung, cải tiến từ hack Twiddling]}}

Nắm bắt lời khuyên của Norman, tôi đã cùng nhau tìm ra một giải pháp sử dụng (một bản vá ) Pygments để làm nổi bật và đẩy vào càng nhiều tính năng càng tốt mà không bị vỡ ;-)

Tôi cũng đã tạo gói lateX, khi bản vá Pygments của tôi được phát hành trong phiên bản 1.2 .

Trình bày đúc

minted là gói sử dụng Pygments để cung cấp tô sáng cú pháp hàng đầu trong LaTeX. Ví dụ, nó cho phép đầu ra sau.

Đây là một tệp tối thiểu để sao chép mã ở trên (lưu ý rằng bao gồm các ký tự Unicode có thể yêu cầu 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}

Đây có thể là kiểu chữ bằng cách sử dụng lệnh sau:

xelatex -shell-escape test.tex

(Nhưng đúc cũng hoạt động với latexvà Giáo dục pdflatex)

minted.styhoạt động tương tự texments.stynhưng cho phép các tính năng bổ sung.

Làm thế nào để có được nó

• đúc được liệt kê trên CTAN ( thông tin gói )

• tài liệu là tất nhiên bao gồm.

• đúc tiền hiện được duy trì bởi Geoffrey Poore. Phiên bản phát triển, bao gồm .stytệp mới nhất , có sẵn tại github.com/gpoore/minted và có thể được sao chép từ đó.

Một lần nữa, cảm ơn Norman đã thúc đẩy tôi sản xuất gói này.

TeX (nổi tiếng) Turing-perfect, nhưng tôi khá chắc chắn rằng bạn sẽ phải tự viết phần mở rộng này. Tài liệu cho thấy rõ rằng tác giả gốc của listingsnó mồ côi năm 2004 và nó chưa được cập nhật từ năm 2006. Gói không được thiết kế để ghi đè định dạng của chữ số, nhưng bạn có thể sửa đổi nó bằng cách thay đổi định nghĩa của \lst@ProcessDigit. Nếu điều đó không hiệu quả, bạn sẽ phải hiểu chi tiết cách các tùy chọn "kiểu định danh" hoạt động và bạn sẽ phải sao chép máy móc đó cho chữ số của mình.

Tôi hoàn toàn không hiểu tại sao bạn lại miễn cưỡng giới thiệu một công cụ bên ngoài vào chuỗi công cụ của bạn, nhưng vì bạn là vậy, bạn sẽ phải làm thêm. Sau khi xem mã nguồn, tôi hy vọng rằng việc sửa đổi listingslà có thể, nhưng cá nhân tôi sẽ chọn xử lý trước LaTeX của mình.

Đây là gói chuyển đổi mã nguồn thành TeX và LaTeX với cú pháp tô sáng. Có thể thêm các định nghĩa ngôn ngữ lập trình tùy chỉnh một cách dễ dàng.

Highlight hỗ trợ 100 ngôn ngữ lập trình và bao gồm 50 chủ đề màu. Nó có tính năng định dạng lại mã và thụt lề.

Tôi đã không sử dụng nó để biết nó hoạt động như thế nào, nhưng một người khác mà tôi biết nói rằng nó hoạt động khá tốt. Nếu tôi có cơ hội, tôi sẽ tự mình thử và xem.