[杂记]如何在LaTeX里插入高亮代码

继上次学会在ppt里面插入带有高亮的c程序代码之后，zyy在这条不归路上越走越远…… 好的，长话短说，今天我介绍的是怎么在LaTeX中插入高亮的c程序代码。（其实不止c程序的代码，别的语言也是可以的，本文以c代码为例）（zyy你作业写完了吗！一天就知道写博客不去好好学习挂科了怎么办！）（……写完就去好好学习别着急…… ♪(^∇^*)）

 

本文将介绍两种方法，当然两种都需要LaTeX（废话……），第二种需要额外的一个软件——Highlight。

 

[方法一]使用Listings宏包对代码进行高亮显示

这里不讲原理，直接说例子。

比如我们想插入这样的一段代码：

/*
PROG:LeTeX test
NAME:zyy 
*/
#include <stdio.h>
int main()
{
    //Note
    printf("Hello world!\n");
    return 0;
}

 

给出对应的tex的代码，注意listings对代码进行高亮要使用xcolor宏包（这里我找不到tex的高亮…… 醉了…… ）：

\documentclass[12pt]{article}
\usepackage{listings}
\usepackage{xcolor}
\lstset{
    %行号
    numbers=left,
    %背景框
    framexleftmargin=10mm,
    frame=none,
    %背景色
    %backgroundcolor=\color[rgb]{1,1,0.76},
    backgroundcolor=\color[RGB]{245,245,244},
    %样式
    keywordstyle=\bf\color{blue},
    identifierstyle=\bf,
    numberstyle=\color[RGB]{0,192,192},
    commentstyle=\it\color[RGB]{0,96,96},
    stringstyle=\rmfamily\slshape\color[RGB]{128,0,0},
    %显示空格
    showstringspaces=false
}

\begin{document}
\begin{lstlisting}[language={C}]
/*
PROG:LeTeX test
NAME:zyy
*/
#include <stdio.h>
int main()
{
    //Note
    printf("Hello world!\n");
    return 0;
}
\end{lstlisting}
\end{document}

 

实现的样子如下：

这里有一个弊端，就是似乎不能插入中文，我试过了用CJK的环境也不行，可能是因为我对LaTeX了解还很少，如果有人实现了代码中的中文显示，请不吝赐教！

当然，我个人是觉得这个不太好看，所以建议不怕麻烦的同学看后一种方法。

 

[方法二]使用Highlight对代码进行高亮处理

Highlight是一款软件，可以生成许多种程序语言的高亮，并以多种形式输出，其中包括LaTeX。

这里给出下载地址（真的没有广告费）：http://www.andre-simon.de/zip/download.php

Highlight的使用也相当简单，下面是它的界面：

注意到左下角的选项版，选择LaTeX输出即可，其他参数可以自己设置。这里值得一提的是，高亮主题非常多，我没有全部尝试过，不过相对来说比较喜欢bclear，当然这一款的对比度并不是很强烈，所以看个人爱好选择吧。我的选择如下：

这里注意一下选择“内嵌页面样式（defs）”。将预览结果复制到剪贴板之后，新建一个.tex文档，粘贴即可。

当然这里会有几个小问题需要修改一下：

1、为了支持中文，需要用到CJK宏包。在前面加入“\usepackage{CJK}”，并在正文中相应地添加“\begin{CJK*}{GBK}{song}”和“\end{CJK*}”；

2、有一个似乎是为了插入双引号的方式，似乎有点问题（可能是LaTex的版本不兼容），作这样的修改即可：加入“\newcommand{\dq}{"}”，并把正文中的“\shorthandoff{"}”和“\shorthandon{"}”注释掉。

（这个语法我找了很久，才在这里找到解释，感谢：http://tex.stackexchange.com/questions/299721/using-dq-in-subsections-has-an-extra）

3、它生成的代码的“\end{document}”之间有空格，把空格删掉。

首先给出代码：

\documentclass{article}
\usepackage{color}
\usepackage{alltt}
\usepackage[T1]{fontenc}
\usepackage[latin1]{inputenc}
\usepackage{CJK}%中文

\newcommand{\hlstd}[1]{\textcolor[rgb]{0.2,0.2,0.2}{#1}}
\newcommand{\hlnum}[1]{\textcolor[rgb]{0.06,0.58,0.63}{#1}}
\newcommand{\hlesc}[1]{\textcolor[rgb]{0.86,0.41,0.09}{#1}}
\newcommand{\hlstr}[1]{\textcolor[rgb]{0.06,0.58,0.63}{#1}}
\newcommand{\hlpps}[1]{\textcolor[rgb]{0.06,0.58,0.63}{#1}}
\newcommand{\hlslc}[1]{\textcolor[rgb]{0.59,0.59,0.59}{#1}}
\newcommand{\hlcom}[1]{\textcolor[rgb]{0.59,0.59,0.59}{#1}}
\newcommand{\hlppc}[1]{\textcolor[rgb]{0.41,0.78,0.23}{#1}}
\newcommand{\hlopt}[1]{\textcolor[rgb]{0.2,0.2,0.2}{#1}}
\newcommand{\hlipl}[1]{\textcolor[rgb]{0.45,0.46,0.77}{#1}}
\newcommand{\hllin}[1]{\textcolor[rgb]{0.59,0.59,0.59}{#1}}
\newcommand{\hlkwa}[1]{\textcolor[rgb]{0.23,0.42,0.78}{#1}}
\newcommand{\hlkwb}[1]{\textcolor[rgb]{0.63,0,0.31}{#1}}
\newcommand{\hlkwc}[1]{\textcolor[rgb]{0,0.63,0.31}{#1}}
\newcommand{\hlkwd}[1]{\textcolor[rgb]{0.78,0.23,0.41}{#1}}
\definecolor{bgcolor}{rgb}{1,1,1}
\newcommand{\dq}{"}

\title{Source file}
\begin{document}
\begin{CJK*}{GBK}{song}
\pagecolor{bgcolor}
\newsavebox{\hlboxopenbrace}
\newsavebox{\hlboxclosebrace}
\newsavebox{\hlboxlessthan}
\newsavebox{\hlboxgreaterthan}
\newsavebox{\hlboxdollar}
\newsavebox{\hlboxunderscore}
\newsavebox{\hlboxand}
\newsavebox{\hlboxhash}
\newsavebox{\hlboxat}
\newsavebox{\hlboxbackslash}
\newsavebox{\hlboxpercent}
\newsavebox{\hlboxhat}
\setbox\hlboxopenbrace=\hbox{\verb.{.}
\setbox\hlboxclosebrace=\hbox{\verb.}.}
\setbox\hlboxlessthan=\hbox{\verb.<.}
\setbox\hlboxgreaterthan=\hbox{\verb.>.}
\setbox\hlboxdollar=\hbox{\verb.$.}
\setbox\hlboxunderscore=\hbox{\verb._.}
\setbox\hlboxand=\hbox{\verb.&.}
\setbox\hlboxhash=\hbox{\verb.#.}
\setbox\hlboxat=\hbox{\verb.@.}
\setbox\hlboxbackslash=\hbox{\verb.\.}
\setbox\hlboxpercent=\hbox{\verb.\%.}
\setbox\hlboxhat=\hbox{\verb.^.}
\def\urltilda{\kern -.15em\lower .7ex\hbox{\~{}}\kern .04em}
\noindent
\ttfamily
%\shorthandoff{"}
\hlstd{}\hllin{\ 1\ }\hlcom{/{*}}\\
\hllin{\ 2\ }\hlcom{项目：LeTeX测试}\\
\hllin{\ 3\ }\hlcom{作者：zyy}\\
\hllin{\ 4\ }\hlcom{{*}/}\hlstd{}\\
\hllin{\ 5\ }\hlppc{\#include\ \usebox{\hlboxlessthan}stdio.h\usebox{\hlboxgreaterthan}}\\
\hllin{\ 6\ }\hlstd{}\hlkwb{int\ }\hlstd{}\hlkwd{main}\hlstd{}\hlopt{()}\\
\hllin{\ 7\ }\hlstd{}\hlopt{\usebox{\hlboxopenbrace}}\\
\hllin{\ 8\ }\hlstd{\ }\hlslc{//这里是中文注释}\\
\hllin{\ 9\ }\hlstd{\ }\hlkwd{printf}\hlstd{}\hlopt{(}\hlstd{}\hlstr{\dq{}Hello\ world!}\hlesc{$\backslash$n}\hlstr{\dq{}}\hlstd{}\hlopt{);}\\
\hllin{10\ }\hlstd{\ }\hlkwa{return\ }\hlstd{}\hlnum{0}\hlstd{}\hlopt{;}\\
\hllin{11\ }\hlstd{}\hlopt{\usebox{\hlboxclosebrace}}\hlstd{}\\
\mbox{}
\normalfont
\normalsize
%\shorthandon{"}
\end{CJK*}
\end{document}
(* LaTeX generated by highlight 3.28, http://www.andre-simon.de/ *)

 

最后的效果是这样的：

这个比前一种方式好多了是吧？

 

[总结]

使用listings相当简便，要配置的东西并不多，也能实现高亮的效果；Highlight的高亮效果更加丰富，并且支持中文注释，只是实现略复杂一些。

 

 

时隔两年后的更新：

感谢@SYCstudio的交流，学习到了一种新的方法，使用minted宏包来实现代码高亮，个人觉得效果还不错，跟Highlight的效果差不多，就是最开始的配置稍微麻烦一点，不过配置好了之后每次使用会比较方便。这里贴一个介绍如何使用minted宏包的博客地址：https://blog.csdn.net/u012705410/article/details/50605374

希望跟大家一起交流，共同进步。