{Minted}

この記事では、minted パッケージを使って、LaTeX ドキュメント内でプログラミング言語のソースコードを整形し、シンタックスハイライトする方法を紹介します。まずは例を見てみましょう。

\documentclass{article}
\usepackage{minted}
\begin{document}
\begin{minted}{python}
import numpy as np
    
def incmatrix(genl1,genl2):
    m = len(genl1)
    n = len(genl2)
    M = None #to become the incidence matrix
    VT = np.zeros((n*m,1), int)  #dummy variable
    
    #compute the bitwise xor matrix
    M1 = bitxormatrix(genl1)
    M2 = np.triu(bitxormatrix(genl2),1) 

    for i in range(m-1):
        for j in range(i+1, m):
            [r,c] = np.where(M2 == M1[i,j])
            for k in range(len(r)):
                VT[(i)*n + r[k]] = 1;
                VT[(i)*n + c[k]] = 1;
                VT[(j)*n + r[k]] = 1;
                VT[(j)*n + c[k]] = 1;
                
                if M is None:
                    M = np.copy(VT)
                else:
                    M = np.concatenate((M, VT), 1)
                
                VT = np.zeros((n*m,1), int)
    
    return M
\end{minted}
\end{document}

この例の出力は次のとおりです。

ここでは 2 つの重要なコマンドがあります。プリアンブルでは、次のように記述してパッケージを読み込みます。

\usepackage{minted}

次に、\begin{minted}{python} と \end{minted} のタグで環境を区切ります。この環境ではテキストが等幅フォントでそのまま（verbatim）出力され、コメント、キーワード、関数に色が付けられます。パラメーター python は、ソースコードが書かれているプログラミング言語です。minted は 150 以上のプログラミング言語やマークアップ言語、設定ファイルをサポートしています。サポートされている言語の一覧はリファレンスガイドを参照してください。

注意：ローカルの LaTeX ディストリビューションで minted を動作させるには、Pygments という追加のプログラムをインストールする必要があります。Overleaf を使えば、それをインストールしたり、ドキュメントをコンパイルするために特別なコマンドを実行したりする手間が省けます。Overleaf では、minted を使用するドキュメントは「そのまますぐに」動作します。

​

基本的な使い方

次の例で示すように、minted 環境を設定して、組版されるコードの見た目を変更できます。ここでは、minted 環境で key=value 形式のパラメーターをカンマ区切りでいくつか使用しています。

\documentclass{article}
\usepackage{minted}
\usepackage{xcolor} % to access the named colour LightGray
\definecolor{LightGray}{gray}{0.9}
\begin{document}
\begin{minted}
[
frame=lines,
framesep=2mm,
baselinestretch=1.2,
bgcolor=LightGray,
fontsize=\footnotesize,
linenos
]
{python}
import numpy as np
    
def incmatrix(genl1,genl2):
    m = len(genl1)
    n = len(genl2)
    M = None #to become the incidence matrix
    VT = np.zeros((n*m,1), int)  #dummy variable
    
    #compute the bitwise xor matrix
    M1 = bitxormatrix(genl1)
    M2 = np.triu(bitxormatrix(genl2),1) 

    for i in range(m-1):
        for j in range(i+1, m):
            [r,c] = np.where(M2 == M1[i,j])
            for k in range(len(r)):
                VT[(i)*n + r[k]] = 1;
                VT[(i)*n + c[k]] = 1;
                VT[(j)*n + r[k]] = 1;
                VT[(j)*n + c[k]] = 1;
                
                if M is None:
                    M = np.copy(VT)
                else:
                    M = np.concatenate((M, VT), 1)
                
                VT = np.zeros((n*m,1), int)
    
    return M
\end{minted}
\end{document}

この例の出力は次のとおりです。

この例で使用しているパラメーターは次のとおりです。

• frame=lines：コードの上下に 2 本の線を引いて枠を作ります。他に指定できる値は leftline、topline、bottomline、single です。
• framesep=2mm：枠との間隔を 2mm に設定します。他の長さの単位も使用できます。
• baselinestretch=1.2：コードの行間を 1.2 に設定します。
• bgcolor=LightGray：背景色を LightGray に設定します。これを機能させるには xcolor パッケージを読み込む必要があります。色の操作について詳しくは LaTeX で色を使うを参照してください。
• fontsize=\footnotesize：フォントサイズを footnotesize に設定します。他の任意のフォントサイズも設定できます。
• linenos：行番号を有効にします。

その他の便利なオプションは次のとおりです。

• mathescape：コードのコメント内で数式モードを有効にします。
• rulecolor：枠の色を変更します。
• showspaces：スペースを可視化する特殊文字を有効にします。

​

ファイルからコードを読み込む

コードは通常ソースファイルに保存されているため、次の例で示すように、ファイルからコードを自動的に読み込むコマンドはとても便利です。

\documentclass{article}
\usepackage{minted}
\title{Importing files using minted}
\begin{document}
The next code will be directly imported from a file:

\inputminted{octave}{BitXorMatrix.m}
\end{document}

この例の出力は次のとおりです。

コマンド \inputminted{octave}{BitXorMatrix.m} はファイル BitXorMatrix.m からコードを読み込みます。パラメーター octave は、コードのプログラミング言語を LaTeX に伝えます。このコマンドには、ファイルの一部だけを読み込むための追加パラメーターを 2 つ指定できます。たとえば、2 行目から 12 行目までのコードを読み込むには、コマンドは次のようになります。

\inputminted[firstline=2, lastline=12]{octave}{BitXorMatrix.m}

​

1 行のコード

1 行だけのコードを入力したい場合は、次の例に示す構文のコマンド \mint が使えます。

One-line code formatting also works with \texttt{minted}. For example, a small fragment of HTML like this:
\mint{html}|<h2>Something <b>here</b></h2>|
\noindent can be formatted correctly.

この例の出力は次のとおりです。

波括弧内のパラメーターはプログラミング言語（この場合はマークアップ言語の html）を指定し、実際に整形されるテキストは ’|’ 文字で区切られます。

​

セルフホストの Overleaf での問題

サンドボックスコンパイルを使用し、かつ Overleaf サーバーで Overleaf をデプロイしている場合、minted がうまく動作しないことがあります。詳細については issues/131 を参照してください。minted を動作させるには、arm 命令プロファイルといくつかのシステムコールを有効にする必要があります。