[ << ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Texinfoにはリストと表を作成する方法がいくつかあります.リストは黒丸また は番号が付きます.二列の表は,最初の列の項目が強調されます.複数列の表も サポートされています.
Introducing Lists | Texinfo formats lists for you. | |
11.1 @itemize : 項目分けされたリストの作成 | How to construct a simple list. | |
11.2 @enumerate : 数字や文字が付いたリストの作成 | How to construct a numbered list. | |
11.3 二列の表の作成 | How to construct a two-column table. | |
11.4 複数列の表 | How to construct generalized tables. |
Texinfoは,リストや表のテキストの字下げと,列挙されたリストの番号付けを 自動的に行います.この最後の機能は,リストを編集する場合に番号を付け直す 必要が無いので便利です.
番号付のリストと表は,行の最初を適切な@-コマンドで開始し,単独行の対応
する@end
コマンドで終了します.表と項目に分けられたリストのコマン
ドも,開始の@-コマンドと同じ行に書式化情報を書くことを要求します.
例えば,@enumerate
コマンドで列挙リストを開始し,@end
enumerate
コマンドでリストを終了してください.項目分けリストを
@itemize
コマンドで開始し,@bullet
のような書式化コマンド
を同じ行に続け,@end itemize
コマンドでリストを終了してください.
リストのそれぞれの要素は,@item
や@itemx
コマンドに前置し
ます.
異なる種類の表とリストの項目分けされたリストは以下のようになります.
同じ項目で列挙されたリストは以下のようになります.
そして,同じ項目と@-コマンドの二列の表は以下のようになります.
@itemize
@enumerate
@table
@ftable
@vtable
@itemize
: 項目分けされたリストの作成
@itemize
コマンドは,印が必要なそれぞれの段落の最初に左のマージン
に黒丸や他の印を使用した,字下げされた段落の並びを生成します.
行の 最初に@itemize
を書き,項目分けされたリストを開始します.コ
マンドに続く同じ行に,文字やマークを生成するTexinfoコマンドを続けてくだ
さい.通常,@itemize
の後に@bullet
を書きますが,
@minus
や結果としてInfoファイルで一文字を生成するあらゆるコマンド
や文字を使用することが可能です.全く印をを付けたくない場合は@w
を使用してください.(@itemize
コマンド後に@bullet
のような
コマンドを書く場合,`{}'を省略できます.)マークコマンドを指定しな
い場合はデフォルトは@bullet
です.
@itemize
の後に,@end itemize
の行まで.字下げされた段落自
身のテキストを書いてください.
マージンに要求される印に対して,それぞれの段落の前に@item
のみの
行を書いてください.@item
にテキストを続けても構いません.
通常,@item
の前に空白行を書くべきです.これはInfoファイルにも空
白行を書きます.(TeXは,どちらの場合でも適切な空白を行間に挿入します.)
項目が非常に短いとき以外は,これらの空白行でリストの見ためが良くなります.
@itemize
の使用に続き,それが生成する出力の例は以下のようになりま
す.@bullet
はInfoでは`*',TeXでは丸い点を生成します.
@itemize @bullet @item fooに対するいくつかのテキスト. @item barに対する いくつかのテキスト. @end itemize |
これは,以下を生成します.
- fooに対するいくつかのテキスト.
- barに対する いくつかのテキスト.
項目分けされたリストには,他の項目分けされたリストを埋め込んでもかまいま せん.黒点で印を付けたリストの中にダッシュで印を付けたリストを埋め込んだ ものは以下のようになります.
@itemize @bullet @item 最初の項目. @itemize @minus @item 内部の項目. @item 二番目の内部の項目. @end itemize @item 二番目の外部項目. @end itemize |
これは,以下を生成します.
- 最初の項目.
- 内部の項目.
- 二番目の内部の項目.
- 二番目の外部項目.
@enumerate
: 数字や文字が付いたリストの作成
@enumerate
は,アイテムのラベルが黒丸の代わりに,連続した整数や文
字となる以外,@itemize
に似ています(see section @itemize
).
@enumerate
コマンドを行の最初に書いてください.コマンドは引数を要
求しませんが,オプションとして数字または文字を受け入れます.引数を用いな
いと,@enumerate
は数字`1'でリストを開始します.`3'のよ
うな数字の引数を用いると,コマンドはその番号からリストを開始します.
`a'または`A'のような大文字または小文字を用いると,コマンドはそ
の文字でリストを開始します.
項目分けされたリストと同じ方法で,列挙されたリストのテキストを書いてくだ
さい.列挙したいそれぞれの段落を始める前に,単独行に@item
を置い
てください.@item
で始まる行に他のテキストは一切書かないでくださ
い.
リストの項目の間に空白行を書くべきです.一般にInfoファイルが読みやすくな ります.
引数の無い@enumerate
の例は以下のようになります.
@enumerate @item 根本的な原因. @item 直接の原因. @end enumerate |
これは以下を生成します.
@enumerate 3 @item 元となる原因. @item 逆の原因. @item 永続する原因. @end enumerate |
これは以下を生成します.
@enumerate
を使用して組み立てられています.@enumerate
引数を用いないと,番号付リストを生成し,それは数字の1で始まります.
@enumerate positive-integer
(正の)数字の引数を用いると,その数字で番号付のリストを開始します.他の文 章で中断されたリストを続けるために,これを使用することが可能です.
@enumerate upper-case-letter
大文字の引数を用いると,それぞれの項目がその大文字で始まる文字で印が付い たリストを開始します.
@enumerate lower-case-letter
小文字の引数を用いると,それぞれの項目がその小文字で始まる文字で印が付い たリストを開始します.
アウトラインのように,番号付のリストを入れ子にすることも可能です.
@table
は,@itemize
(see section @itemize
)に
似ていますが.それぞれの項目に対して名前や見出し行を指定できます.
@table
コマンドは,二列の表を生成するために使用され,特に,用語集,
説明的な表示,そしてコマンドラインオプションの概要に役に立ちます.
@table コマンドの使用 | How to construct a two-column table. | |
11.3.1 @ftable と@vtable | Automatic indexing for two-column tables. | |
11.3.2 @itemx | How to put more entries in the first column. |
@table
コマンドの使用
二列の表を生成するために@table
コマンドを使用してください.
@table
コマンドを行の最初に書き,同じ行に@code
,
@samp
,@var
や,@kbd
(see section 9.1 定義,コマンド等を示す)のような
Texinfoの"表示"コマンドを引数として続けてください.これらのコマンドは
通常カッコで引数が続きますが,@item
は引数を供給するので,この場
合は引数無しでコマンド名を使用します.このコマンドは,それぞれの項目の最
初の列になるテキストに適用され,強調方法を決定します.例えば,
@code
は最初の列のテキストを@code
コマンドで強調します.
(我々はコマンドラインオプションの@table
に対し@code
を勧め
ます.)
@table
の引数として,@asis
コマンドの使用を選択してもかま
いません.@asis
は何もしないコマンドです.@table
の後にこ
のコマンドを使用した場合,TeXとInfoの書式化コマンドは,最初の列の項目
を強調せず("そのまま")出力します.
(@table
コマンドは,ここでリストアップした以外のコマンドを用いて
作業してもかまいません.しかし,通常はカッコ内に引数をとるコマンドのみが
使用可能です.)
それぞれの表の項目を,行の最初の@item
コマンドで開始してください.
最初の列のテキストを@item
コマンドと同じ行に書いてください.二番目
の列のテキストを@item
行に続く行と,それ以降の行に書いてください.
(二番目の列の項目が空の場合,何も入力する必要はありません.)サポートする
テキストは好きな行数を書いてもかまいませんし,複数の段落にしてもかまいま
せん.しかし,@item
と同じ行のテキストのみ,脚注も含めて,最初の
列に配置されます.
通常,@item
行の前に空白行を書くべきです.これはInfoファイルで空
白を書きます.項目が非常に短いとき以外は,空白行は見ためが良くなります.
例えば,以下の表は最初の列を@samp
で強調しています.
@table @samp @item foo これは@samp{foo}に対する テキストです. @item bar @samp{bar}に対するテキストです. @end table |
これは,以下を生成します.
二行以上の名前の項目を一つの塊のテキストでリストアップしたい場合,
@itemx
コマンドを使用してください.(See section @itemx
.)
@ftable
と@vtable
@ftable
と@vtable
コマンドは,@ftable
が自動的に表
の最初の列のそれぞれの項目を関数の索引に入れ,@vtable
が自動的に
表の最初の列のそれぞれの項目を変数の索引に入れる以外,@table
コマ
ンドと同じです.これは,索引作成の仕事を単純にします.@item
コマ
ンドと同じ行の項目のみ索引になり,それらはその行の表示と全く同じ形式で索
引になります.索引の詳細は,See section 12. 索引.
@ftable
や@vtable
を使用している二列の表は,行の最初に@-コ
マンドを書くことで開始し,同じ行に引数として@table
コマンドに対す
るものと全く同じものを,@code
コマンドのようなTexinfoコマンドで続
けてください.そして,単独行で@end ftable
や@end vtable
コ
マンドを使用して終りにしてください.
前のセクションの@table
の例を参照してください.
@itemx
同じ項目で,最初の列の項目が二つ以上あり,それぞれを単独行に現したい場合,
@itemx
コマンドを表の中で使用してください.@itemx
を最初の
項目以外の全てに使用してください.@itemx
は常に@item
コマ
ンドに続けるべきです.@itemx
コマンドは,最初の列のテキストの上に
余分な空白を生成しない以外は,@item
と全く同じように動作します.
例えば,以下のようにします.
@table @code @item upcase @itemx downcase この二つの関数は,引数として文字や文字列を受け入れ,対応した大文字(小文字) の文字や文字列を返します. @end table |
これは以下を生成します.
upcase
downcase
(この例は,二列の表に複数行をサポートしているテキストを表現していることに 注意してください.)
@multitable
で,それぞれの列が希望の幅を持つ,あらゆる数の列を持
つ表を構築することが可能となります.
単独の@multitable
行で列の幅を定義し,@tab
コマンドで分け
られた列で,@item
コマンドに続けて,実際の表のそれぞれの行を書き
ます.最終的に,@end multitable
で表を終了します.詳細は以下のセ
クションにあります.
11.4.1 複数列の表の幅 | Defining multitable column widths. | |
11.4.2 複数列の表の行 | Defining multitable rows, with examples. |
複数行の表の列の幅を二つの方法で定義することが可能です.行の長さを小数と
する方法,または行のプロトタイプを使用する方法です.二つの方法を混ぜたも
のはサポートしていません.どちらの場合でも,@multitable
コマンド
と同じ行で幅は完全に定義されます.
@columnfractions
と
(1より小さい)10進数を@multitable
コマンドの後に以下のように書いて
ください.
@multitable @columnfractions .33 .33 .33 |
小数部は上記がそうでないように,和が正確に1.0になる必要はありません.こ れで,行全体を満たす必要の無い表を生成することができます.好みで0を前置 することが可能です.
@multitable
コマンドの後にカッコで囲んで書いてください.例えば,
以下のようにします.
@multitable {some text for column one} {for column two} |
最初の列は,`some text for column one'で植字される幅を持ち,二列目は`for column two'の幅を持ちます.
プロトタイプ項目を表に書く必要はありません.
この例で単純なテキストを使用しましたが,プロトタイプ項目にTexinfoコマン
ドを含めることが可能です.@code
のようなマークアップコマンドは,
特に役に立つ可能性が高いものです.
列の幅を定義する@multitable
(前のセクション参照)の後で,
@item
で複数列の表の本体にそれぞれの行を開始し,列項目を
@tab
で分けます.改行は表の本体で特別扱いされず,必要な場所でソー
スファイルの入力行を改行してもかまいません.
複数列の表の完全な例は以下のようになります(The GNU Emacs Manualか らのテキストで,see section `Splitting Windows' in The GNU Emacs Manual).
@multitable @columnfractions .15 .45 .4 @item Key @tab Command @tab Description @item C-x 2 @tab @code{split-window-vertically} @tab Split the selected window into two windows, with one above the other. @item C-x 3 @tab @code{split-window-horizontally} @tab Split the selected window into two windows positioned side by side. @item C-Mouse-2 @tab @tab In the mode line or scroll bar of a window, split that window. @end multitable |
以下を生成します.
Key | Command | Description |
C-x 2 | split-window-vertically
| Split the selected window into two windows, with one above the other. |
C-x 3 | split-window-horizontally
| Split the selected window into two windows positioned side by side. |
C-Mouse-2 | In the mode line or scroll bar of a window, split that window. |
[ << ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |