注册 登录  
 加关注
   显示下一条  |  关闭
温馨提示!由于新浪微博认证机制调整,您的新浪微博帐号绑定已过期,请重新绑定!立即重新绑定新浪微博》  |  关闭

一粒浮尘

飘渺虚无

 
 
 

日志

 
 

怎么在LaTeX中插入程序源代码?  

2013-08-04 15:05:42|  分类: Tex |  标签: |举报 |字号 订阅

  下载LOFTER 我的照片书  |
(From http://www.chinatex.org/bbs/forum.php?mod=viewthread&tid=3692&extra=page%3D1 )
问题描述
怎么在LaTeX中插入程序源代码?

解决方案
listsings 宏包。

补充扩展
listings 是专用于代码排版的 LaTeX 宏包,可对关键词、注释和字符串等使用不同的字体和颜色或颜色,也可以为代码添加边框、背景等风格。
1 基本用法
下面给出一份用于排版 C 语言 HelloWorld 程序代码的完整的 LaTeX 文档:
  1. \documentclass{article}
  2. \usepackage{listings}
  3. \begin{document}
  4. \begin{lstlisting}[language=C]
  5. int main(int argc, char ** argv)
  6. {
  7. printf("Hello world!\n");
  8. return 0;
  9. }
  10. \end{lstlisting}
  11. \end{document}
复制代码

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

语法高亮的排版效果如下图所示:
4 添加边框
listings 宏包为代码边框提供了很多风格,大体可分为带有阴影的边框与圆角边框。这里仅仅给出一个阴影边框的示例,至于其它边框风格,可查阅 listings 宏包文档,里面给出了一些示例。
下面 LaTeX 源文档将为代码添加阴影边框,并将阴影设置为浅灰色:
  1. \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}]
  2. int main(int argc, char ** argv)
  3. {
  4. printf("Hello world!\n");
  5. return 0;
  6. }
  7. \end{lstlisting}
复制代码
排版效果如下图:


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

listings 宏包通过参数 numbers 来设定行号,该参数的值有两个,分别是 left 与 right,表示行号显示在代码的左侧还是右侧。下面为带有边框的代码添加行号,并设置行号字体为 \tiny:
  1. \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}]
  2. int main(int argc, char ** argv)
  3. {
  4. printf("Hello world!\n");
  5. return 0;
  6. }
  7. \end{lstlisting}
复制代码
排版效果如下图所示:

6 全局设置

上面所给的各个示例中,lstlisting 环境后面尾随了很多参数,要是每使用一次 lstlisting 环境就要设置这么多参数,那就没什么意思了。
可以使用 \lstset 命令在 LaTeX 源文档的导言区设定好 lstlisting 环境所用的公共参数,如下:
  1. \documentclass{article}
  2. \usepackage{listings}
  3. \usepackage{xcolor}
  4. \begin{document}
  5. \lstset{numbers=left,
  6. numberstyle=\tiny,
  7. keywordstyle=\color{blue!70}, commentstyle=\color{red!50!green!50!blue!50},
  8. frame=shadowbox,
  9. rulesepcolor=\color{red!20!green!20!blue!20}
  10. }
  11. \begin{lstlisting}[language={[ANSI]C}]
  12. int main(int argc, char ** argv)
  13. {
  14. printf("Hello world!\n");
  15. return 0;
  16. }
  17. \end{lstlisting}
  18. \end{document}
复制代码
7 显示中文
listings 宏包默认是不支持包含中文字串的代码显示的,但是可以使用 “逃逸” 字串来显示中文。

在 \lstset 命令中设置逃逸字串的开始符号与终止符号,推荐使用的符号是左引号,即 “ `”
  1. \lstset{numbers=left,
  2. numberstyle=\tiny, keywordstyle=\color{blue!70}, commentstyle=\color{red!50!green!50!blue!50},
  3. frame=shadowbox, rulesepcolor=\color{red!20!green!20!blue!20},
  4. escapeinside=``}
  5. ……
  6. \begin{lstlisting}[language={[ANSI]C}]
  7. int main(int argc, char ** argv)
  8. {
  9. printf("`我爱中文`!\n");
  10. return 0;
  11. }
  12. \end{lstlisting}
复制代码

8 调整一下边距

listings 的代码框的宽度默认是与页芯等宽的,其上边距也过于小,可根据自己的审美观念适度调整一下。我通常是将代码框的左右边距设置为 2em,上边距为 1em,下边距采用默认值即可,所作设定如下:
[code]\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}[/cide]

  评论这张
 
阅读(2584)| 评论(0)
推荐 转载

历史上的今天

在LOFTER的更多文章

评论

<#--最新日志,群博日志--> <#--推荐日志--> <#--引用记录--> <#--博主推荐--> <#--随机阅读--> <#--首页推荐--> <#--历史上的今天--> <#--被推荐日志--> <#--上一篇,下一篇--> <#-- 热度 --> <#-- 网易新闻广告 --> <#--右边模块结构--> <#--评论模块结构--> <#--引用模块结构--> <#--博主发起的投票-->
 
 
 
 
 
 
 
 
 
 
 
 
 
 

页脚

网易公司版权所有 ©1997-2017