#
4 LATEX 入門

この節では、LATEX の概念と構文法について簡単に紹介し、 ドキュメントの作者が ``TEXnician'' にならなくてもドキュメントを 十分生産的に書けるような情報を提供します。

おそらく、Python ドキュメントのマークアップにおいて心に留めておくべき 最も重要な概念は、TEX が非体系的なのに対して、LATEX は TEX の上のレイヤとして設計されていて、本質的には構造化マークアップを サポートしているということです。 Python 特有のマークアップは、 標準の LATEX ドキュメントクラスで提供されている構造を拡張し、 Python 特有の情報のサポートを目的としています。

LATEX ドキュメントには、二つの構成要素: プリアンブルと本体が 入っています。プリアンブルは、タイトル、著者のリスト、日付、ドキュメント が属する クラス といった、ドキュメント自体に関するメタデータ を指定するために使用されます。その他の情報で、インデクスの生成や 参考文献データベースの使用を制御するものもプリアンブル内に置けます。 ほとんどの著者にとっては、既存のドキュメントからプリアンブルをコピーし、 いくつかの情報を修正するだけで、簡単にプリアンブルを作成できます。

ドキュメントのクラス は、広範なドキュメントカテゴリに おける位置づけを行い、基本的な書式化プロパティを設定するために 使われます。 Python ドキュメントの場合、二つのクラス: `manual` クラスと `howto` クラスが使われています。 これらのクラスではまた、Python における概念やデータ構造を記述 する際に使う追加のマークアップを定義しています。これらのクラスに 関する詳しい説明は後述の 5 節、 ``ドキュメントクラス'' にあります。プリアンブルの最初に置かれているのが、ドキュメントクラスの 宣言です。

クラス宣言の後ろには数多くのマクロ があり、ドキュメントに 関する詳しい情報を与えたり、追加の必要なマークアップを設定しています。 プリアンブルからは何も出力生成されません; 自由文 (free text) は出力生成につながるため、プリアンブルに自由文をおくとエラーに なります。

ドキュメント本体はプリアンブルの後に続けます。本体には、出力すべき ドキュメントの構成要素を構造的にマークアップして入れます。 一般的なLATEX の構造には、階層化された章節、番号付けリストや 箇条書きリスト、そしてドキュメントの概要や索引といった特殊な 構造があります。