ボックス - クラウドでオンライン

プログラム：

NAME

ボックス - テキストモードボックスとコメント描画フィルター

SYNOPSIS

ボックス [-hlmrv] [-a フォーマット] [-d デザイン] [-f ファイル] [-i インデント] [-k ブール] [-p パッド] [-s サイズ]
[-t tabopts] [infile [outfile]]

DESCRIPTION

ボックス（BOX） は、入力テキストの周囲にあらゆる種類のボックスを描画できるテキスト フィルターです。 ボックスデザイン
シンプルなボックスから複雑な ASCII アートまで、幅広い選択肢があります。 ボックスも取り外し可能です
たとえ内部のテキストの編集によりひどく損傷した場合でも、修復されます。 ボックスが
どの面でもオープンであること、 ボックス あらゆるプログラミングで地域のコメントを作成するためにも使用できます
言語。 あらゆる種類の新しいボックス デザインを簡単に追加し、共有することができます。
フリーフォーマットの設定ファイル。
ボックス 元々は とともに使用することを意図していました 活力(1) テキストエディタですが、紐付けることができます
フィルタをサポートする任意のテキスト エディタにアクセスできるほか、コマンド ラインから
スタンドアロンツール。

OPTIONS

によって提供されるオプション ボックス 次のとおりです。

-a 文字列
ボックス内のテキストの配置/位置。 このオプションはフォーマット文字列引数を受け取ります
これは左から右に読まれます。 フォーマット文字列には空白を含めることはできません。
次の XNUMX つ以上のコンポーネントで構成されている必要があります。

hx - より大きなボックス内の入力テキスト ブロックの水平方向の配置。
可能な値 x 　 l (まあ、左揃えの場合)、 c (中央)、または r （右）。
これは、入力テキスト ブロック内のテキスト行の位置揃えには影響しません。
（使用 j 代わりに引数を使用します)。
vx - より大きなボックス内の入力テキスト ブロックの垂直方向の配置。
可能な値 x 　 t (上部の位置合わせの場合)、 c (中央)、または b （下）。
jx - 入力テキスト ブロック内の行の位置揃え。 可能な値 x 　 l
(左揃えのため)、 c (中央)、または r （右）。 これは影響を受けません
ボックス内での入力テキスト ブロック自体の配置。 使用 h & v 引数
入力テキストブロックの位置決め用。

簡略記法 (上記の引数と組み合わせることができます):
l (エル) - の略称 hlvcjl
c - の略 hcvcjc
r - の略 hrvcjr

工場出荷時のデフォルト設定は、 -a is hlvt.

-c 文字列
単純なケースのコマンドライン設計定義。 このオプションの引数は、
「西」(W) 形状の定義。 定義された形状は XNUMX つだけで構成されている必要があります
つまり、複数の線の形状は許可されません。 の -c オプションはショートカットとして意図されています
単純な地域コメントを作成する場合には、
特定の文字または一連の文字を各行の前に配置します。 で
このような場合は、単純に指定する方がはるかに便利です。 -c 完全に行うよりも
構成ファイル内のデザイン定義。定義されている唯一の形状は西側です。
形状。
このオプションは、 -d 構成ファイルにはアクセスしません。 -c もちろんそうかもしれない
他のオプションと組み合わせて使用​​します。 デフォルトでは、 -c 指定されていません。

-d 文字列
デザインの選択。 このオプションの XNUMX つの引数は、使用するデザインの名前です。

-f 文字列
代替構成ファイルを使用してください。 このオプションの XNUMX つの引数は、有効な名前です。
ボックス 構成ファイルには、新しくエキサイティングなデザインが含まれています。

-h 使用情報を印刷します。

-i 文字列
インデントモード。 可能な引数は「text」（ボックス内のテキストをインデント）、「box」です。
(ボックス内のテキストではなく、ボックスをインデントします)、または「なし」(インデントを破棄します)。 引数
省略される場合があります。 デフォルトでは、ボックスはインデントされますが、テキストはインデントされません。

-k ブール
削除時に先頭/末尾の空白行を削除します。 の値 ブール 次のように指定できます
on、yes、true、1、または t (すべて「はい」を意味します)、または off、no、false、0、または f (「いいえ」を意味します)。
これは大文字と小文字が区別されません。 このオプションは、以下に関連する場合にのみ有効です。 -r。 場合
Yes に設定すると、先頭と末尾の空白行が出力から削除されます。 設定されている場合
いいえの場合は、前のボックスの内容全体が返されます。 両方の場合、デフォルトは no です。
ほとんどの地域の場合と同様、箱の上部と下部は開いています。
コメント。 ボックスのデザインで上部または下部が定義されている場合、デフォルトは
はい。

-l (エル) デザインをリストします。 構成内の利用可能なすべてのボックス設計のリストを生成します。
ファイルと、サンプル ボックスおよびその作成者に関する情報が含まれています。 もチェックします
構成ファイル全体の構文。 と関連して使用される場合 -d、詳細を表示します
指定されたデザインに関する情報。

-m 箱を修復します。 これにより、次のように (壊れている可能性のある) ボックスが削除されます。 -r、そしてそれを再描画します
その後。 修復されたボックスは、指定されたオプションに従って描画されます。 これはもしかしたら
パディングや識別情報などを復元する場合に知っておくことが重要です。
補修された箱。 暗示する -k 偽。

-p 文字列
パディング。 入力テキスト ブロックの周囲のすべての辺のスペースにパディングを指定します。
箱。 引数文字列には空白を含めることはできず、次の文字列で構成されている必要があります。
次の文字の組み合わせ。各文字の後には、内容を示す数字が続きます。
スペースのパディング:
a - (すべて) すべての側面に一度にパディングを与えます
h - (horiz) 水平両側にパディングを与える
v - (垂直) 垂直両側にパディングを与える
b - (底部) 底部 (南) 側にパディングを与える
l - (左) 左側 (西) 側にパディングを与える
t - (上) 上 (北) 側にパディングを与える
r - (右) 右側 (東) 側にパディングを与える
例： -p a4t2 は、パディングをすべての辺で 4 文字になるように定義します。
ボックスの上部では、入力テキスト ブロックはボックスから 2 行しか離れていません。
ボックス
デフォルトでは、構成ファイルで特に指定されていない限り、パディングは使用されません。

-r ボックスを取り外します。 既存のボックスを描画する代わりに削除します。 どのデザインを使用するかは、
自動的に検出されます。 時間を節約するため、または検出されない場合に備えて
正しく決定し、組み合わせる -d デザインを指定します。 デフォルトでは、
新しい箱。

-s 幅x高さ
箱のサイズ。 このオプションでは、目的のボックス サイズを列単位で指定します (幅の場合)
と線（高さ用）。 引数として数値が XNUMX つだけ指定された場合、この数値は
希望するボックスの幅を指定します。 「x」の接頭辞が付いた単一の数字は、
ボックスの高さ。 実際に出来上がる箱のサイズは個体により異なる場合がございます
選択したデザインの形状サイズ。 また、他のコマンド ライン オプションも影響を与える可能性があります。
箱のサイズ（など） -p).
デフォルトでは、テキストの周囲に可能な限り最小のボックスが作成されます。

-t 文字列
タブの扱い。 このオプションは、入力テキスト内のタブ文字の処理方法を制御します。
オプション文字列は常に uint 距離を表す数字
タブストップの間。 この値を正しく設定することが重要です。正しく設定しないと、
文字が入力テキストを混乱させる可能性があります。 正しいタブ距離の値は次の条件によって異なります。
処理しているテキストに使用される設定。 一般的な値は 8 です。
タブ距離の直後に、オプションの文字を追加できます。
占い ボックス 先頭のタブの扱い方。 次のオプションが利用可能です。
e - タブをスペースに展開します
k - 可能な限り過去の状態に近い状態でタブを維持します
u - タブを展開します。 これにより、 ボックス できるだけ多くのスペースをタブに変換します。

下位互換性を維持するために、 -t 文字列 単なる数字でも構いません。 で
その場合、 e すべてのタブを削除して置き換えるタブ処理を想定しています。
スペースあり。 工場出荷時のデフォルトは、 -t オプションは単純に 8 です。これはまさにそのようなものです
場合。
たとえば、次のように指定できます -t 先頭のタブを展開しないようにするには、4u を使用します。
ボックスのコンテンツでは、タブは常にスペースに変換されます。 このタブの距離は
例は4です。

-v 現在のバージョン番号を出力します。

CONFIGURATION ファイル

ボックス（BOX） コマンドラインで指定された構成ファイルを使用します(使用 -f）。 いいえの場合
設定ファイルはコマンドラインで指定されます。 ボックス BOXES環境をチェックします
変数。使用するファイル名が含まれる場合があります。 BOXESが設定されていない場合は、 ボックス 読んでみます
$HOME/.boxes を設定ファイルとして使用します。 それに失敗すると、 ボックス を読んでみます
システム全体の構成ファイル (「ファイル」を参照)。

の構文 ボックス 設定ファイルについては Web サイトで説明されています (下記を参照)。 彼らはかなりです
自明のことですが。

可用性

ボックス（BOX） の Web サイトから入手できます。http://boxes.thomasjensen.com/>。 ウェブサイト
また、このマニュアル ページを説明する多数の例と、より詳細な説明も掲載されています。
のドキュメントで詳しく説明されています）。

チェックアウト 活力(1) でhttp://www.vim.org/>!

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