gtbl - クラウドでオンライン

プログラム：

NAME

tbl - troff 用のテーブルのフォーマット

SYNOPSIS

tbl [-履歴書] [ファイル ...]

DESCRIPTION

このマニュアルページでは、GNUバージョンの tbl、これは groff ドキュメントの一部です
フォーマットシステム。 tbl に埋め込まれたテーブルの説明をコンパイルします troff 入力ファイル
によって理解されるコマンドに変換される troff。 通常は、次のコマンドを使用して呼び出す必要があります。 -t
のオプション グロフ。 Unixとの互換性が高い tbl。 GNU によって生成された出力 tbl
Unixでは処理できない troff; GNU で処理する必要があります troff。 ファイルがない場合は、
コマンドラインで指定するか、ファイル名を指定します。 - が与えられると、標準入力が読み取られます。

OPTIONS

-C 互換モードを有効にして認識する 。TS & .TE たとえその後に
スペースまたは改行以外の文字。 リーダー文字（\a）は次のように扱われます。
通訳。

-v バージョン番号を印刷します。

言語 概要

tbl でラップされたテーブルの説明が見つかることを期待します。 。TS (テーブルスタート) と .TE （表
終わり）マクロ。 このような各テーブル セクション内で、次のコマンドを使用して別のテーブルを定義できます。
要求 .T& 最後のコマンドの前に .TE。 各テーブル定義には次のようなものがあります。
構造：

グローバル オプション
これはオプションです。 このテーブル パーツでは、次のオプションのいくつかを使用できます。
1行以上。 の 全体的な オプション 部 常に次の時間までに終了する必要があります セミコロン ;
.

表 形式でアーカイブしたプロジェクトを保存します． 仕様
この部分は必ず指定する必要があり、オプションではありません。 列の数を決定します
テーブルの（セル）。 さらに、各セルは中央、左で分類されます。
この仕様には複数の行を含めることができますが、必ず指定する必要があります。
までに終わる ドット . 最後の行の最後に。 各セルを定義した後、
の項目に表示されます。 指定子 追加することもできますが、それはオプションです。

デフォルトでは、セルはタブ文字で区切られます。 それを変えることができるのは、 全体的な
オプション tbl(c)ここで、 c は任意の文字です。

SIMPLE 例

最も簡単なテーブル定義は次のとおりです。
。TS
CC 。
これが中心です
さて、これも
.TE
使用することにより、 c c c、表全体の各セルが中央に配置されます。 区切り文字
ここがデフォルトです タブ.

結果は

これが中心です
さて、これも

この定義は次と同じです
。TS
タブ（@）;
CC。
これは@中心です
そうですね、@これも@
.TE
ここでは、区切りタブ文字が文字に変更されます。 @.

さらに、タイトルを追加したり、センタリング方向を他のさまざまな方向に変更したりできます。
フォーマット：
。TS
タブ（@）;
css
LCN 。
役職
左@中央@123
別の@番号@75
.TE
結果は

役職
左センター 123
別の数字75
ここに l 手段 左寄せ, n 手段 数値、ここにあります 右寄せ.

USAGE

グローバル オプション
直後の行 。TS マクロには次のグローバルのいずれかを含めることができます
オプション (文字の大文字と小文字は無視します – Unix tbl は、すべての文字を含むオプションのみを受け入れます)
文字は小文字、またはすべての文字は大文字）、スペース、タブ、またはカンマで区切ります。

オールボックス 表の各項目をボックスに入れます。

ボックス テーブルを箱で囲みます。

センター テーブルを中央に配置します (デフォルトは左寄せ)。 代替キーワード名 センター
も認識されます (これは GNU tbl 拡張機能です)。

小数点(c)
数値列の小数点として認識される文字を設定します (GNU tbl
のみ）。

デリム(xy)
　 x & y の開始および終了区切り文字として 式とします。

ダブルボックス
テーブルを二重の箱で囲みます。

ダブルフレーム
doublebox と同じ (GNU tbl のみ)。

拡張 テーブルの幅を現在の行の長さと同じにする (列を区切る)
要素）。 XNUMX つ以上の「x」列指定子が使用されている場合は無視されます (以下を参照)。

列幅の合計が現在の行の長さより大きい場合、
カラム分離係数はゼロに設定されます。 このようなテーブルは右マージンまで拡張されます。
カラム分離はまったくありません。

フレーム ボックスと同じ (GNU tbl のみ)。

線幅(n)
行またはルールを設定します (例: ボックス）in n-ポイントタイプ。

ノーキープ 改ページを防ぐために迂回を使用しないでください (GNU tbl のみ)。 通常は tbl 試み
転換を使用して、ボックス化されたテーブルでの望ましくない中断を防ぐため。 これはできる
脚注の場合、マクロ パッケージ自身の流用の使用とひどく相互作用することがあります。
たとえば、などが使用されます。

場所がない
データ項目の先頭と末尾のスペースを無視します (GNU tbl のみ)。

ノーワーン 現在の行幅を超えるテーブルに関する警告をオフにする (GNU tbl
のみ）。

タブ（x) キャラクターを使用する x 入力データの行内の項目を区切るためのタブの代わりに。

グローバル オプションはセミコロンで終わる必要があります。 オプションの間に空白がある可能性があります
括弧内の引数。

表 形式でアーカイブしたプロジェクトを保存します． 仕様
グローバル オプションの後には、テーブルの各行の形式を説明する行が続きます。 それぞれ
このようなフォーマット行は、最後のフォーマット行を除き、テーブル自体の XNUMX 行を記述します。
(ピリオドで終わる必要があります) は、テーブルの残りのすべての行を説明します。 独身者-
キー文字は、表の各行の各列を説明します。 キーとなるキャラクターは、
スペースまたはタブで区切ります。 複数行のフォーマット指定を実行できます。
カンマで区切って同じ行にまとめます。

各キー文字の後に、フォントとポイント サイズを決定する指定子を付けることができます。
対応する項目の列幅、列間の間隔などを決定します。

最も長いフォーマット行は、テーブル内の列の数を定義します。 フォーマットがありません
フォーマット行の末尾の記述子は次のように想定されます。 L。 データ内の余分な列
(対応する形式エントリがないもの) は無視されます。

使用可能なキー文字は次のとおりです。

a,A この列の最も長い行を中央に配置し、この列の他のすべての行を左揃えにします。
その中心線を基準にして列を移動します。 アイデアはそのようなアルファベットを使用することです
サブ列 (したがってキー文字の名前) との組み合わせ L; 彼らです
サブ列と呼ばれる理由 A 項目は相対的に 1n だけインデントされます L エントリー。
例：

。TS
タブ（;）;
ん、あん。
項目 1;XNUMX
サブアイテム 2;XNUMX
サブアイテム 3;XNUMX
.T&
ん、あん。
項目 11;XNUMX
サブ項目 22;XNUMX
サブアイテム 33;XNUMX
.TE

結果：

項目 1 XNUMX
小項目 2 XNUMX
小項目 3 XNUMX
項目 11 XNUMX
サブ項目 22 XNUMX
サブ項目 33 XNUMX

c,C 項目を列内の中央に配置します。

l,L 列内の項目を左揃えにします。

n,N 列内の項目を数値的に揃える: 数値の単位位置が揃えられます。
垂直に。 数字の隣に XNUMX つ以上のドットがある場合は、右端のドットを使用します。
XNUMX つは垂直方向の位置合わせ用です。 ドットがない場合は、右端の数字を使用します。
垂直方向の配置。 それ以外の場合は、項目を列内の中央に配置します。 アライメントは次のように行うことができます
'\&' を使用して特定の位置に強制的に配置されます。 このインスタンスが XNUMX つ以上ある場合
データ内に存在する特殊 (非印刷) 文字。左端の文字を使用します。
アライメント。 例：

。TS
n.
1
1.5
1.5.3
腹が立つ
a\&bcde
.TE

結果：

1
1.5
1.5.3
腹が立つ
腹が立つ

数値入力を組み合わせた場合 L or R エントリ – これは、次の場合に発生する可能性があります。
テーブル形式は次のように変更されます .T& – 最も幅の広い中央 数 (入力されたデータのうち、
下 N 指定子レジーム) 最も広いものに対して相対的 L or R エントリ、保存
すべての数値エントリの位置合わせ。 に反して A エントリを入力すると、余分なものはありません
インデント。

方程式の使用 (次のように処理されます) 式) を使用する列内で N 指定子
ほとんどの場合、次のような問題が発生します tbl垂直方向を見つけるためのアルゴリズム
上で説明したように、位置合わせを行います。 グローバルを使用する デリム ただし、オプションです。
作ることが可能 tbl 内のデータを無視する 式 そのための区切り文字。

r,R 列内の項目を右寄せにします。

s,S 左側の前の項目をこの列に広げます。 最初の列には使用できません。

^ この列の前の行からエントリを下に広げます。 最初の行には許可されません。

_,- このエントリを水平線に置き換えます。 「_」と「-」は次の目的で使用できることに注意してください。
テーブルフィールドのみ。列区切り線は対象外。

= このエントリを二重の水平線に置き換えます。 「=」は次の目的で使用できることに注意してください。
テーブルフィールドのみ。列区切り線は対象外。

| 対応する列が縦罫線になります（XNUMXつ隣接する場合は、
二重縦罫）。

最初のキー文字の左側または最後のキー文字の右側にある垂直バー
テーブルの端に線が入ります。

テーブル内のデータ形式を変更するには、 .T& コマンド (行の先頭)。
この後には、次のようなフォーマット行とデータ行が続きます (ただし、グローバル オプションはありません)。 。TS
リクエストで詳細に指定された通りになります。

コラム 指定子
列キー文字の接尾辞に使用できる指定子は次のとおりです (順序は任意です)。

b,B の短縮形 fB (影響を受けるエントリを太字にします)。

d,D 「^」列指定子または「\^」を使用して、垂直方向に行にまたがる項目を開始します。
データ項目を垂直方向の中央に配置するのではなく、その範囲の一番下に配置します (GNU tbl
のみ）。 例：

。TS
タブ(;) オールボックス;
ll
lld
r ^
XNUMX番目。
0000;フーバー
T{
1111
.br
2222
T};ふー
r;
T{
3333
.br
4444
T};バー
\^;\^
.TE

結果：

┌──────┬────────┐
│0000 │ フーバー │
├──────┼────────┤
│1111 │ │
│2222 │ │
§─────┤ │
│ r │ foo │
├──────┼────────┤
│3333 │ │
│4444 │ バー │
└──────┴────────┘
e,E 等間隔の列を作成します。 この指定子でマークされたすべての列は同じものを取得します
幅; これは、影響を受ける列幅が計算された後に発生します (つまり、
幅の最大値が優先されます)。

f,F これらの指定子のいずれかの後にフォント名 (XNUMX つまたは XNUMX つ) を続けることができます。
文字数)、フォント番号 (XNUMX 桁)、または括弧内の長い名前 (
最後の形式は GNU tbl 拡張です)。 XNUMX 文字のフォント名は XNUMX 文字で区切る必要があります
またはその後に続く空白。

i,I の短縮形 fI (影響を受けるエントリを斜体にします)。

m,M これは GNU tbl 拡張機能です。 これらの指定子のいずれかの後にマクロを続けることができます
名前 (XNUMX 文字または XNUMX 文字)、または括弧内の長い名前。 ひとつは-
文字マクロ名とその後に続くものは XNUMX つ以上の空白で区切る必要があります。
ここで名前を指定できるマクロは、マクロを作成する前に定義しておく必要があります。
テーブル。 これは、テーブルのセルのテキストが出力される直前に呼び出されます。 実装されたとおり
現在、このマクロはブロック入力が使用される場合、つまり、ブロック入力が使用される場合にのみ呼び出されます。
「T{」と「T}」。 マクロには単純なものだけを含める必要があります troff を変更するリクエスト
テキスト調整、ハイフネーション、サイズ、フォントなどのテキスト ブロックの書式設定。 マクロ
と呼ばれる After 他のセルの変更 b, f or v が出力されます。 したがって、マクロは
他の変更指定子を上書きできます。

p,P 数値を続けると、影響を受けるフィールドのポイント サイズが変更されます。 もし
符号付きの場合、現在のポイント サイズは (符号付きの数値を使用して) 増加または減少します。
符号付き数字の代わりに GNU tbl 拡張が使用されます)。 ポイント サイズ指定子が続きます
列区切り番号で区切る場合は、XNUMX つ以上の空白で区切る必要があります。

t,T 垂直方向に複数の行にまたがる項目を、その範囲の先頭から開始します。
垂直方向の中央に配置します。

u,U 対応する列を半行上に移動します。

v,V 後ろに数字が続き、これは、テキストで使用される垂直の行間隔を示します。
複数行のテーブルエントリ。 署名されている場合、現在の垂直行間隔は次のようになります。
インクリメントまたはデクリメント (符号付き数字の代わりに符号付き数値を使用すると、
GNU tbl 拡張子)。 垂直行間隔指定子の後に列が続く
分離番号は XNUMX つ以上の空白で区切る必要があります。 の場合は効果がありません。
対応するテーブルエントリはテキストブロックではありません。

w,W 列幅の最小値。 後に次のいずれかが続く必要があります troff(1) 幅表現
括弧内または単位のない整数。 単位が指定されていない場合は、en 単位が使用されます。
含まれるテキスト ブロックのデフォルトの行の長さとしても使用されます。 複数使用する場合
特定の列の幅を指定する回数を繰り返すと、最後のエントリが有効になります。

x,X 拡張された列。 すべての列幅を計算した後、 x 指定子、使用
この列の残りの線幅。 複数展開されている場合
列、残りの水平スペースを影響を受ける列に均等に分配します
(これは GNU 拡張機能です)。 この機能は、
最小列幅。

z,Z 幅計算の目的で対応する列を無視します。つまり、使用しないでください。
この列のフィールドを使用して幅を計算します。この列の指定子のみが使用されます。

キー文字の数字接尾辞は、en 単位の列区切りとして解釈されます。
(次の場合は比例して乗算されます) 拡張 オプションがオンになっている - テーブルがいっぱいの場合、これは
ゼロになる可能性もあります）。 デフォルトの分離は 3n です。

列指定子 x と相互に排他的です e & w （しかし e 相互に排他的ではありません
　 w); 特定の列に対して複数回指定した場合は、最後のエントリが有効になります。
x 両方の設定を解除します e & w、どちらか e or w オーバーライド x.

表 データ
フォーマット行の後には、テーブルの実際のデータを含む行が続きます。
ついに .TE。 このようなデータ行内では、通常、項目はタブ文字で区切られます。
(または、 タブ オプション）。 長い入力行は分割できる
行の最後の文字が '\' の場合は複数行 (これは後に消えます)
連結）。

注意してください tbl 各エントリに \w を適用して、列幅を行ごとに計算します。
テキストブロックではありません。 結果として、次のような構造

。TS
c、l。
\s[20]MM
んー
.TE

失敗; どちらか言わなければなりません

。TS
CP20、LP20。
MM
んー
.TE

or

。TS
c、l。
\s[20]MM
\s[20]MMMM
.TE

行の先頭にドットがあり、その後に数字以外が続く場合は、troff コマンドとして処理されます。
変更なく通過しました。 この場合、テーブルの位置は変更されません。

データ行が「_」または「=」のみで構成されている場合、それぞれ XNUMX 行または XNUMX 行になります。
その時点でテーブル全体に描かれます。 データ行内の XNUMX つの項目が「_」のみで構成されている場合
または「=」を使用すると、その項目は XNUMX 行または XNUMX 行に置き換えられ、隣接する項目が結合されます。 もしも
データ項目が '\_' または '\=' のみで構成されている場合は、それぞれ XNUMX 本線または XNUMX 本線が描画されます。
隣接する点と結合しない点でフィールドを横切ってください。

'\Rx' ('x' 任意の文字) のみで構成されるデータ項目は、次の繰り返しによって置き換えられます。
文字 'x' は列と同じ幅です (隣接する文字と結合しません)。

「\^」のみで構成されるデータ項目は、すぐ上のフィールドが複数の範囲にまたがることを示します。
この行を下向きに移動します。

テキスト ブロック
テキスト ブロックを使用すると、XNUMX つのエントリとして長すぎるデータを XNUMX つのエントリとして入力できます。
タブ間の単純な文字列。 「T{」で始まり「T}」で終わります。 前者
行は終了する必要があり、後者は行を開始する必要があり、その後に他のデータ列が続く可能性があります。
(タブで区切るか、 タブ グローバルオプション）。

デフォルトでは、テキスト ブロックは以前にアクティブだった設定でフォーマットされます。
テーブルに入る。おそらく、 m, v, w tbl 指定子。 例えば、
すべてのテキスト ブロックを右にずらして配置するには、次のように挿入します。 .na スタート直前に 。TS （と 。広告
テーブルの後）。

'w' または 'x[cq] 指定子が指定されていない場合 を テキスト ブロック スパンの列、
テキスト ブロックのデフォルトの長さ (より正確には、テキスト ブロックの処理に使用される行の長さ)
テキスト ブロックの流用) は L×C/(N+1) として計算されます。ここで、「L」は現在の行の長さ、「C」は
テキスト ブロックがまたがる列の数、および 'N' はテキスト ブロックの合計列数です。
テーブル。 ただし、レジスタに返される実際の迂回幅は次のとおりであることに注意してください。 \n[dl]
最終的にはテキスト ブロックの幅として使用されます。 必要に応じて、テキストを制御することもできます
を直接挿入した場合のブロック幅 。NS 'T{' の直後にリクエストします。

その他
番号レジスター \n[TW] テーブルの幅を保持します。 テーブル自体内では使用できません
ただし、呼び出す直前に定義されています .TE このマクロがそれを利用できるようにします。

tbl マクロも定義します .T# これにより、ボックス化されたテーブルの底部と側面の線が作成されます。
一方、 tbl テーブルの最後でこのマクロ自体を呼び出します。マクロで使用できます。
パッケージを使用して、ページ フッター内で呼び出して、複数ページのテーブル用のボックスを作成します。 アン
この例を次に示します。 -MS テーブルの場合にこの機能を提供するマクロ
で始まる 。TS H への標準的な呼び出しの代わりに、 。TS マクロ。

インタラクション WITH EQN

tbl(1) は常に前に呼び出す必要があります 式（1）（グロフ(1) は自動的に処理されます。
プリプロセッサの正しい順序)。

GNU TBL 強化

テーブル内の列数やテキストの数に制限はありません。
ブロック。 列幅を決定する際には、テーブルの行だけでなく、すべての行が考慮されます。
最初の 200。テーブル継続 (.T&) 行は最初の 200 行に制限されません。

数字とアルファベットの項目が同じ列に表示される場合があります。

数字とアルファベットの項目は水平方向にまたがる場合があります。

tbl 数字で始まるレジスタ、文字列、マクロ、および迂回名を使用します 3。 時
tbl で始まる名前は使用しないでください。 3.

GNU TBL 以内に マクロス

Since tbl 独自のマクロを定義します (各テーブルの直前) 'end-
of-マクロ」マクロ。 さらに、エスケープ文字をオフにする必要があります。 ここに、
例。

.eo
.de ATABLE ..
。TS
オールボックスタブ(;);
NS。
\$1;\$2
.TE
...
.ec
.ATABLE テーブル
.ATABLE 別のテーブル
.ATABLE そして「もうひとつ」

ただし、すべての機能が利用できるわけではないことに注意してください。 tbl マクロにラップできるため、 tbl 見て
より前の入力 troff。 たとえば、垂直方向に整列した数値の書式設定です。
これらの数値がマクロパラメータとして渡されると、小数点は失敗します。
点の位置合わせは次のように処理されます。 tbl それ自体: '\$1'、'\$2' などのみを認識するため、
小数点が認識できません。

onworks.net サービスを使用して gtbl をオンラインで使用する