Up One Level Python ドキュメントの作成 Contents
Previous: Up: Python ドキュメントの作成 Next:


8 画像の取り込み

Python の標準ドキュメントは、図や画像を全く使っていません; これは 意図的にそうしているのです。ドキュメントのフォーマットを行う際に 利用する外部ツールが、まだ画像をうまく扱えるほどではなかったからです。 ツールの進歩やメンテナによる改善にともなって、画像に対するサポートも 改善されてきました。

mkhowto スクリプトから起動される内部ツールは、画像を 直接サポートしているわけではありませんが、mkhowto が 外部ツールによるグラフィクスのサポートを妨げることはありません。

こうしたツールと howto やmanual ドキュメントクラス を使ったグラフィクスの利用はまだ広く行われてはいませんが、うまく 動作することは知られています。基本的には、以下のようにアプローチ します:

  1. 好きなアプリケーションで、画像や図版を作成します。

  2. 出力したい形式に合わせて、画像の形式を変換します。 HTML または PostScript を生成したければ、画像や図版は encapsulated PostScript (EPS, .eps ファイル) 形式に変換します; LaTeX2HTML は EPS ファイルを .gif ファイルに変換できます; .gif ファイルを直接指定してもかまいません。 PDF を (pdflatex で) 生成したいなら、 ``カプセル化 (encapsulated)'' PDF ファイルが必要です。Linux や Unix向けに配布されているteTeX についてくるepstopdf を使えば、EPS ファイルから変換できます。

  3. ドキュメント内で、グラフィクスをサポートするためのパッケージ graphicx を ``import'' するための行を以下のようにして追加します: 

    \usepackage{graphicx}

  4. 図版や画像を取り込みたい場所で、以下のようなマークアップを 行います: 

    \begin{figure}
  \centering
  \includegraphics[width=5in]{myimage}
  \caption{myimage の説明}
\end{figure}

    \includegraphics マクロにはファイルの拡張子を指定しないので 注意してください。もし特定の形式のドキュメントしか生成したくないの なら、拡張子をつけてもかまいませんが、複数の形式をサポートしたければ 拡張子を省略しておいたほうが楽です。

  5. mkhowto を通常通りに走らせます。

make の機能をサポートするようなシステムで作業を行っているな ら、画像の変換の際に生じる中間ファイルを最新に保つようにできます。 下の例では、 dia で作成した図を取り込んでいるような ドキュメントをフォーマットするための Makefile を示しています: 

default: pdf
all:     html pdf ps

html:   mydoc/mydoc.html
pdf:    mydoc.pdf
ps:     mydoc.ps

mydoc/mydoc.html:  mydoc.tex mygraphic.eps
        mkhowto --html $<

mydoc.pdf:  mydoc.tex mygraphic.pdf
        mkhowto --pdf $<

mydoc.ps:   mydoc.tex mygraphic.eps
        mkhowto --postscript $<

.SUFFIXES: .dia .eps .pdf

.dia.eps:
        dia --nosplash --export $@ $<

.eps.pdf:
        epstopdf $<

Up One Level Python ドキュメントの作成 Contents
Previous: Up: Python ドキュメントの作成 Next:
ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。