python宏包latex_[转]latex的宏包之显示程序代码

排版源代码， \lstset{lang ge=C,caption= C code,label=ccode} \begin{lstlisting} for (i=0; i!=n; i++) stat[i]= i; \end{lstlisting}

如果源代码很长，可以放在额外的文档中，然后导入 \lstinputlisting{source_filename.c} 支持的程序语言 ABAPIDLPlasmACSLinformPOVAdaJavaProlog

AlgolJVMISPromelaAntkshPythonAssemblerLispR

AwkLogoRed?bashmakeRexxBasicMathematicaRSL

CMatlabR yC++MercurySCamlMetaPostSAS

CleanMirandaScilabCobolMizarshComalMLSHELXL

cshModula-2SimulaDelphiMuPADSQLEiffelNASTRANtcl

ElanOberon-2TeXerlangOCLVBScriptEuphoriaOctaveVerilog

FortranOzVHDLGCLPascalVRMLGnuplotPerlXML

HaskellPHPXSLTHTMLPL/I 定制

listings 宏包提供一系列的可定制参数， \lstset{ %

lang ge=Octave,  % 程序语言名称

basicstyle=\footnotesize,  % 基本字体的字号

numbers=left,  % 行号位置

numberstyle=\footnotesize,  % 行号字体的字号

stepnumber=2,  % 行号的显示步长

numbersep=5pt,  % 行号与代码间距

backgroundcolor=\color{white},  % 背景色 需要 \usepackage{color}

showspaces=false,  % 显示空格

showstringspaces=false,  % 字符串中显示空格

showtabs=false,  % 显示

TAB frame=single,  % 显示边框

tabsize=2,  % TAB 被当作两个空格

captionpos=b,  % 标题位置

breaklines=tr,  % 自动断行

breakatwhitespace=false,  % 断行只在空格处

escapeinside={\%*}{*)}  % 添加注释，暂时离开 listings }

listings 是专用于代码排版的 LaTeX 宏包，可对关键词、注释和字符串等使用不同的字体和颜色或颜色，也可以为代码添加边框、背景等风格。见：http://hi.baidu.com/shawpinlee/blog/item/9ec431cbae28e41cbe09e6e4.html

1 基本用法

下面给出一份用于排版 C 语言 HelloWorld 程序代码的完整的 LaTeX 文档：

\documentclass{article}

\usepackage{listings}

\begin{document}

\begin{lstlisting}[lang ge=C]

int main(int argc, char ** argv)

{

/* print a string "Hello world!"

printf("Hello world!\n");

return 0;

}

\end{lstlisting}

\end{document}

排版效果如下图所示：

2 对计算机语言的支持

listings 宏包支持大约近百种计算机语言，下面只列举几个常用的： C ：ANSI, Handel, Objective, Sharp

C++ ：ANSI, GNU, ISO, Vis l

Delphi

Java ：empty, AspectJ

TeX ：AlLaTeX, common, LaTeX, plain, primitive

XML

Gnuplot

HTML

Python

R y

make ：empty, gnu

从上面的语言支持列表可看到有些语言是分为了多种类型的，比如 C 语言分为了 ANSI, Handel, Objective, Sharp 等类型。在使用 listings 宏包时，对某种语言存在多种类型的情况下，可以指定所需类型的，例如：

\begin{lstlisting}[lang ge={[ANSI]C}]

int main(int argc, char ** argv)

{

/* print a string "Hello world!"

printf("Hello world!\n");

return 0;

}

\end{lstlisting}

3 语法高亮

listings 宏包提供了关键词高亮与注释高亮，分别体现为 keywordstyle 与 commentstyle 参数。

下面将 C 语言关键词使用浅蓝色高亮显示，代码采用灰色显示：

\documentclass{article}

\usepackage{listings}

\usepackage{xcolor} % 使用颜色宏包

\begin{document}

\begin{lstlisting}[lang ge={[ANSI]C}, keywordstyle=\color{bl!70}, commentstyle=\color{red!50!green!50!bl!50}]

int main(int argc, char ** argv)

{

/* print a string "Hello world!" */

printf("Hello world!\n");

return 0;

}

\end{lstlisting}

\end{document}

注意，要使用 listings 宏包提供的语法高亮，需要 xcolor 宏包支持。

语法高亮的排版效果如下图所示：

4 添加边框

listings 宏包为代码边框提供了很多风格，大体可分为带有阴影的边框与圆角边框。这里仅仅给出一个阴影边框的示例，至于其它边框风格，可查阅 listings 宏包文档，里面给出了一些示例。

下面 LaTeX 源文档将为代码添加阴影边框，并将阴影设置为浅灰色：

\begin{lstlisting}[lang ge={[ANSI]C}, keywordstyle=\color{bl!70}, commentstyle=\color{red!50!green!50!bl!50}, frame=shadowbox, rulesepcolor=\color{red!20!green!20!bl!20}]

int main(int argc, char ** argv)

{

/* print a string "Hello world!" */

printf("Hello world!\n");

return 0;

}

\end{lstlisting}

排版效果如下图：

5 添加行号

很多时候需要对文档中的代码进行解释，只有带有行号的代码才可以让解释更清晰，因为你只需要说第 x 行代码有什么作用即可。如果没有行号，那对读者而言就太残忍了，他们不得不从你的文字叙述中得知行号信息，然后去一行一行的查到相应代码行。

listings 宏包通过参数 numbers 来设定行号，该参数的值有两个，分别是 left 与 right，表示行号显示在代码的左侧还是右侧。下面为带有边框的代码添加行号，并设置行号字体为 \tiny：

\begin{lstlisting}[lang ge={[ANSI]C}, numbers=left, numberstyle=\tiny, keywordstyle=\color{bl!70}, commentstyle=\color{red!50!green!50!bl!50}, frame=shadowbox, rulesepcolor=\color{red!20!green!20!bl!20}]

int main(int argc, char ** argv)

{

/* print a string "Hello world!" */

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{bl!70}, commentstyle=\color{red!50!green!50!bl!50},

frame=shadowbox,

rulesepcolor=\color{red!20!green!20!bl!20}

}

\begin{lstlisting}[lang ge={[ANSI]C}]

int main(int argc, char ** argv)

{

/* print a string "Hello world!" */

printf("Hello world!\n");

return 0;

}

\end{lstlisting}

\end{document}

7 显示中文

listings 宏包默认是不支持包含中文字串的代码显示的，但是可以使用 “逃逸” 字串来显示中文。

在 \lstset 命令中设置逃逸字串的开始符号与终止符号，推荐使用的符号是左引号，即 “`”

\lstset{numbers=left,

numberstyle=\tiny, keywordstyle=\color{bl!70}, commentstyle=\color{red!50!green!50!bl!50},

frame=shadowbox, rulesepcolor=\color{red!20!green!20!bl!20},

escapeinside=``}

……

\begin{lstlisting}[lang ge={[ANSI]C}]

int main(int argc, char ** argv)

{

/* print a string "Hello world!" */

printf("`我爱中文`!\n");

return 0;

}

\end{lstlisting}

8 调整一下边距

listings 的代码框的宽度默认是与页芯等宽的，其上边距也过于小，可根据自己的审美观念适度调整一下。我通常是将代码框的左右边距设置为 2em，上边距为 1em，下边距采用默认值即可，所作设定如下：

\lstset{numbers=left, numberstyle=\tiny, keywordstyle=\color{bl!70}, commentstyle=\color{red!50!green!50!bl!50}, frame=shadowbox, rulesepcolor=\color{red!20!green!20!bl!20},escapeinside=``, xleftmargin=2em,xrightmargin=2em, aboveskip=1em}