【LaTeX小技巧02】在论文中插入代码块

使用到的包有 minted、caption 和 currfile。定义的辅助命令如下：

\usepackage{minted}

\usepackage{currfile}

\usepackage{caption}

\newenvironment{code}{\captionsetup{type=listing}}{}

\makeatletter

\renewcommand*{\thelisting}{\thesection.\arabic{listing}}

\@addtoreset{listing}{section}

\makeatother

\newcommand{\inputcode}[3]{

\begin{code}

\inputminted[mathescape,

linenos,

breaklines,

numbersep=5pt,

gobble=0,

tabsize=4,

fontsize=\footnotesize,

frame=lines,

framesep=2mm]{#1}{#2}%

\caption{#3}

\end{code}%

}

说明

代码的长度可能超过一页，所以不能用 float。在这一情况下，为了能够添加题注，引入 caption 包，并定义了 code 环境用于包裹代码。

更新了 \thelisting 命令，这里的效果是代码块的编号计数在每一节都自动重置。

定义了 \inputcode 命令，其中使用了自定义的 code 环境。命令有三个参数，第一个为语言名称（需要根据 minted 文档来填写），第二个为代码文件的文件名，第三个为题注。

\inputminted 中的配置选项可以根据文档自行调整。

在文件中的使用方式为：

\edef\CurrentFileDir{\currfiledir}

\inputcode{C}{\CurrentFileDir/abc.c}{用于计算 ABC 的代码}

这里使用 currfile 包解决相对路径问题，这样就可以在别的 .tex 文件中直接 \input 引入这里的内容，而代码文件的路径是相对于当前编写的这一个 .tex 文件的。这样只要保证这个文件和源代码文件的相对位置不变，任意移动也不会有影响。

实际效果如下图所示（实际的代码在文件 abc.c 中，而不在 .tex 文件中）：