Pygments を Windows にインストールして使う方法

Pygments は Python で記述されたシンタックスハイライターです。

様々なプログラミング言語、マークアップ言語等で書かれたソースコードを HTML に変換することが可能です。

Linux での Pygments のインストール方法、利用方法に関する情報は巷にあふれているので割愛。この記事では Windows 上に Pygments をインストールしてそれを利用する方法を紹介します。

Pygments のインストール方法

2015年5月現在、pip install Pygments で一発でインストール可能です。

C:\Python27\Tools>pip install Pygments
Downloading/unpacking Pygments
Installing collected packages: Pygments
Successfully installed Pygments
Cleaning up...

Pygments のインストール方法は次の手順で行います。

Python のインストール
ez_setup のインストール
Pygments のインストール
環境変数への登録 (任意)

Python のインストール

Pygments は Python で記述されているので Python をインストールしておく必要があります。

ここでは Python 2.7 をインストールしました。インストーラがあるので特に問題は無いと思いますが、不安な方は Windows への Python のインストールなどを参考にしてください。 (と言ってもこのページでは Python3.x のインストールを紹介しているのでご注意)

ここでは Python 2.7 を C:\Python27 にインストールしたとします。

ez_setup のインストール

次の手順で ez_setup をインストールします。

http://pypi.python.org/pypi/setuptools#windows から ez_setup.py をダウンロードして、 C:\Python27\Tools に保存。
コマンドプロンプト (cmd) から ez_setup.py を実行。
すると次のようになります。

> cd C:\Python27\Tools
C:\Python27\Tools>C:\Python27\python ez_setup.py
Downloading http://pypi.python.org/packages/2.7/s/setuptools/
setuptools-0.6c11-py2.7.egg
Processing setuptools-0.6c11-py2.7.egg
Copying setuptools-0.6c11-py2.7.egg to 
c:\python27\lib\site-packages
Adding setuptools 0.6c11 to easy-install.pth file
Installing easy_install-script.py script to C:\Python27\Scripts
Installing easy_install.exe script to C:\Python27\Scripts
Installing easy_install.exe.manifest script to C:\Python27\Scripts
Installing easy_install-2.7-script.py script to C:\Python27\Scripts
Installing easy_install-2.7.exe script to C:\Python27\Scripts
Installing easy_install-2.7.exe.manifest script to 
C:\Python27\Scripts

Installed c:\python27\lib\site-packages\setuptools-0.6c11-py2.7.egg
Processing dependencies for setuptools==0.6c11
Finished processing dependencies for setuptools==0.6c11

C:\Python27\Tools>

Pygments のインストール

上記をインストールしたら Pygments をインストールできます。

Pygments-1.4-py2.7.egg を C:\Temp にダウンロード
次のように easy_install に egg ファイル名を渡して実行。

C:\Python27\Scripts>easy_install.exe C:\Temp\Pygments-1.4-py2.7.egg
Processing Pygments-1.4-py2.7.egg
creating c:\python27\lib\site-packages\Pygments-1.4-py2.7.egg
Extracting Pygments-1.4-py2.7.egg to c:\python27\lib\site-packages
Adding Pygments 1.4 to easy-install.pth file
Installing pygmentize-script.py script to C:\Python27\Scripts
Installing pygmentize.exe script to C:\Python27\Scripts
Installing pygmentize.exe.manifest script to C:\Python27\Scripts

Installed c:\python27\lib\site-packages\pygments-1.4-py2.7.egg
Processing dependencies for Pygments==1.4
Finished processing dependencies for Pygments==1.4

環境変数 PATH に登録

この設定は任意です。どこからでもコマンドだけで利用できるようにするために、環境変数 PATH に pygmentize のある C:\Python27\Scripts を追加すると便利です。

Pygments の使い方

上記の設定をしたらコマンドプロンプトから、つぎのように実行できます。

C# ソースコード foo.cs を HTML に変換して、C:\Temp\a.html に保存するには・・・

>pygmentize -o C:\Temp\a.html foo.cs

CSS の定義など完全な HTML として出力するには・・・

>pygmentize -O full -o C:\Temp\a.html foo.cs