nDiki : pod2latex

Pod ドキュメントを LaTeX 形式ドキュメントに変換するツール。

Perl モジュール GnuWin32 Javadoc Web UTF-8 EUC-JP インストーラ ActivePerl 開発 Windows Perl pLaTeX ビルド TeX ドキュメンテーションコメント gzip 仕様 dvipdfmx インストール不要 GNU tar API GNU Make MinGW

■ pod2latex

仕事で書いた Perl モジュールの API 仕様を紙媒体にしなければならないので、今回は pod2latex を使ってみる。

 pod2latex -modify -full -out hoge-utf8.tex lib

で lib ディレクトリ以下の *.pm の Pod が集められて hoge-utf8.tex になる。ソースを UTF-8 で書いているのでこれを lv などで EUC-JP に変換して、platex してdvipdfmx。

前に Javadoc から LaTeX に落とした時に比べて非常にすんなりと変換してくれる。 '=item foo([opt])' とかすると ] 文字が落ちたりする以外は特に今のところ目につく問題なし。

ま、いざとなったらスクリプトに手を入れて直せるだろうし、なかなかいいんじゃないでしょうか。

• Twitter ベイジアンフィルタプロキシ (2007-12-29)
• bundle を作成して Perl モジュールをまとめてインストール。 (2004-10-21)
• 日本語ファイル名どんとこい (2005-03-07)
• pLaTeX + hyperref + dvipdfmx で PDFにしおりを (2005-04-15)
• LaTeX でプレゼンテーション (2005-06-21)

■ Windows 用 GNU tar

この間 Windows 用の GNU Make として MinGW版を選択して、プロジェクトのドキュメントのビルドの自動化をすすめている。

しかし(最初からわかっていたのだが)make だけでは駄目で各ユーティリティがなくて結構不便。 touch すら無いし。 幸い全員の環境に ActivePerl が入っていることが前提になっているので、必要ならスクリプトを書いていけばある程度はなんとかなる。

今日は、プロジェクトで開発したPerl モジュールのソースアーカイブを自動的に一時ディレクトリに展開して pod2latex をかけてごにょごにょという処理の Makefile を書く。 さすがに tar が無いと無理だ (Archive::Tar を使うという手もなくはないが結局標準ではないし)。

@ GnuWin32

ということでGNU tarを探す。例によってインストール不要という条件で。

MinGW の中からは探せず。 GnuWin32 のものを使ってみる。 ついでに gzip も

• tar.exe (GNU tar tar-1.13-1-bin.zip)
  • libiconv-2.dll (libiconv-1.8-1-bin.zip)
  • libintl-2.dll (libintl-0.11.5-2-bin.zip)
• gzip.exe (gzip-1.3.5-bin.zip)

fork できないとかで tar の -z オプションが使えない。かなりがっかり。

@ texinst753 (W32TeX Web2C-7.5.3 簡易インストーラ)

あれ、gzip が最初からPATH上にあるなと思ったら、texinst753 に含まれていた奴。 GNU tar も入っている。 ちょっとバージョンが古めだけど -z も効くし、これが扱いやすいかも。

なにより他のプロジェクトメンバの Windows BOX にもそれぞれ入っているはずだし。

ということで GNU tar 確保。

• ActivePerl で Ming (2005-02-23)
• 私的10大ニュース2004 [ comp ] (2004-12-31)
• PAR::Repository でビルド済み Perl モジュールをネット... (2006-12-12)
• TrueCrypt で USB メモリに Windows と Linux ... (2006-12-14)
• Module::Build でソースパッケージング (2005-08-24)