轉(zhuǎn)載自http://blog.linuxgem.org/lyanry/show/319.html
listings 是專用于代碼排版的 LaTeX 宏包，可對(duì)關(guān)鍵詞、注釋和字符串等使用不同的字體和顏色或顏色，也可以為代碼添加邊框、背景等風(fēng)格。
1 基本用法
下面給出一份用于排版 C 語(yǔ)言 HelloWorld 程序代碼的完整的 LaTeX 文檔：
\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 宏包提供的語(yǔ)法高亮，需要 xcolor 宏包支持。
語(yǔ)法高亮的排版效果如下圖所示：
2 添加邊框
listings 宏包為代碼邊框提供了很多風(fēng)格，大體可分為帶有陰影的邊框與圓角邊框。這里僅僅給出一個(gè)陰影邊框的示例，至于其它邊框風(fēng)格，可查閱 listings 宏包文檔，里面給出了一些示例。
下面 LaTeX 源文檔將為代碼添加陰影邊框，并將陰影設(shè)置為淺灰色：
\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}
3 添加行號(hào)
很多時(shí)候需要對(duì)文檔中的代碼進(jìn)行解釋，只有帶有行號(hào)的代碼才可以讓解釋更清晰，因?yàn)槟阒恍枰f(shuō)第 x 行代碼有什么作用即可。如果沒(méi)有行號(hào)，那對(duì)讀者而言就太殘忍了，他們不得不從你的文字?jǐn)⑹鲋械弥刑?hào)信息，然后去一行一行的查到相應(yīng)代碼行。
listings 宏包通過(guò)參數(shù) numbers 來(lái)設(shè)定行號(hào)，該參數(shù)的值有兩個(gè)，分別是 left 與 right，表示行號(hào)顯示在代碼的左側(cè)還是右側(cè)。下面為帶有邊框的代碼添加行號(hào)，并設(shè)置行號(hào)字體為 \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}
4 全局設(shè)置
上面所給的各個(gè)示例中，lstlisting 環(huán)境后面尾隨了很多參數(shù)，要是每使用一次 lstlisting 環(huán)境就要設(shè)置這么多參數(shù)，那就沒(méi)什么意思了。
可以使用 \lstset 命令在 LaTeX 源文檔的導(dǎo)言區(qū)設(shè)定好 lstlisting 環(huán)境所用的公共參數(shù)，如下：
\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}
5 顯示中文
listings 宏包默認(rèn)是不支持包含中文字串的代碼顯示的，但是可以使用 “逃逸” 字串來(lái)顯示中文。
在 \lstset 命令中設(shè)置逃逸字串的開(kāi)始符號(hào)與終止符號(hào)，推薦使用的符號(hào)是左引號(hào)，即 “`”
\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("`我愛(ài)中文`!\n");
return 0;
}
\end{lstlisting}
6 調(diào)整一下邊距
listings 的代碼框的寬度默認(rèn)是與頁(yè)芯等寬的，其上邊距也過(guò)于小，可根據(jù)自己的審美觀念適度調(diào)整一下。我通常是將代碼框的左右邊距設(shè)置為 2em，上邊距為 1em，下邊距采用默認(rèn)值即可，所作設(shè)定如下：
\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}
