在LaTeX中插入程序代碼

轉載自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}
相關文章
相關標籤/搜索