轉載自http://blog.linuxgem.org/lyanry/show/319.htmlhtml
listings 是專用於代碼排版的 LaTeX宏包,可對關鍵詞、註釋和字符串等使用不一樣的字體和顏色或顏色,也能夠爲代碼添加邊框、背景等風格。linux
1 基本用法
下面給出一份用於排版 C 語言 HelloWorld 程序代碼的完整的 LaTeX 文檔:ide
\documentclass{
article}
\usepackage{
listings}
\begin{
document}
\begin{
lstlisting}[
language=C]
int main(int argc, char ** argv)
{
printf("Hello world!
\n");
return 0;
}
\end{
lstlisting}
\end{
document}
注意,要使用 listings 宏包提供的語法高亮,須要 xcolor 宏包支持。字體
語法高亮的排版效果以下圖所示:spa
4 添加邊框
listings宏包爲代碼邊框提供了不少風格,大致可分爲帶有陰影的邊框與圓角邊框。這裏僅僅給出一個陰影邊框的示例,至於其它邊框風格,可查閱listings 宏包文檔,裏面給出了一些示例。htm
下面 LaTeX 源文檔將爲代碼添加陰影邊框,並將陰影設置爲淺灰色:blog
\begin{
lstlisting}[language={[ANSI]C},keywordstyle=\color{blue!70},commentstyle=\color{red!50!green!50!blue!50},frame=shadowbox, rulesepcolor=\color{red!20!green!20!blue!20}]
int main(int argc, char ** argv)
{
printf("Hello world!
\n");
return 0;
}
\end{
lstlisting}
排版效果以下圖:ip
5 添加行號
不少時候須要對文檔中的代碼進行解釋,只有帶有行號的代碼纔可讓解釋更清晰,由於你只須要說第 x行代碼有什麼做用便可。若是沒有行號,那對讀者而言就太殘忍了,他們不得不從你的文字敘述中得知行號信息,而後去一行一行的查到相應代碼行。文檔
listings 宏包經過參數 numbers 來設定行號,該參數的值有兩個,分別是 left 與right,表示行號顯示在代碼的左側仍是右側。下面爲帶有邊框的代碼添加行號,並設置行號字體爲 \tiny:字符串
\begin{
lstlisting}[language={[ANSI]C},numbers=left, numberstyle=\tiny,keywordstyle=\color{blue!70},commentstyle=\color{red!50!green!50!blue!50},frame=shadowbox, rulesepcolor=\color{red!20!green!20!blue!20}]
int main(int argc, char ** argv)
{
printf("Hello world!
\n");
return 0;
}
\end{
lstlisting}
排版效果以下圖所示:
6 全局設置
上面所給的各個示例中,lstlisting 環境後面尾隨了不少參數,要是每使用一次 lstlisting環境就要設置這麼多參數,那就沒什麼意思了。
可使用 \lstset 命令在 LaTeX 源文檔的導言區設定好 lstlisting 環境所用的公共參數,以下:
\documentclass{
article}
\usepackage{
listings}
\usepackage{
xcolor}
\begin{
document}
\lstset{numbers=left,
numberstyle=
\tiny,
keywordstyle=
\color{
blue!70},commentstyle=\color{red!50!green!50!blue!50},
frame=shadowbox,
rulesepcolor=
\color{
red!20!green!20!blue!20}
}
\begin{
lstlisting}[language={[ANSI]C}]
int main(int argc, char ** argv)
{
printf("Hello world!
\n");
return 0;
}
\end{
lstlisting}
\end{
document}
7 顯示中文
listings 宏包默認是不支持包含中文字串的代碼顯示的,可是可使用 「逃逸」 字串來顯示中文。
在 \lstset 命令中設置逃逸字串的開始符號與終止符號,推薦使用的符號是左引號,即 「 `」
\lstset{numbers=left,
numberstyle=
\tiny,keywordstyle=
\color{
blue!70},commentstyle=\color{red!50!green!50!blue!50},
frame=shadowbox, rulesepcolor=
\color{
red!20!green!20!blue!20},
escapeinside=``}
……
\begin{
lstlisting}[language={[ANSI]C}]
int main(int argc, char ** argv)
{
printf("`我愛中文`!
\n");
return 0;
}
\end{
lstlisting}
8 調整一下邊距
listings的代碼框的寬度默認是與頁芯等寬的,其上邊距也過於小,可根據本身的審美觀念適度調整一下。我一般是將代碼框的左右邊距設置爲2em,上邊距爲 1em,下邊距採用默認值便可,所做設定以下:
\lstset{
numbers=left,numberstyle=\tiny,keywordstyle=\color{blue!70},commentstyle=\color{red!50!green!50!blue!50},frame=shadowbox, rulesepcolor=\color{red!20!green!20!blue!20},escapeinside=``,xleftmargin=2em,xrightmargin=2em, aboveskip=1em}