盒子 - 云端在线

程序：

您的姓名

框 - 文本模式框和注释绘图过滤器

概要

箱 [-hlmrv] [-a 格式] [-d 设计] [-f 文件] [-i 缩进] [-k bool] [-p pad] [-s 大小]
[-t tabopts] [输入文件 [输出文件]]

商品描述

盒 是一个文本过滤器，可以在其输入文本周围绘制任何类型的框。 盒子设计
选择范围从简单的盒子到复杂的 ASCII 艺术。 一个盒子也可以被移除和
已修复，即使它已因编辑内部文本而严重损坏。 由于盒子可能
向任何一侧敞开， 箱 也可用于在任何编程中创建区域注释
语。 各种新的盒子设计可以通过附加到一个
自由格式配置文件。
箱 最初打算与 VIM(1) 文本编辑器，但可以绑定
到任何支持过滤器的文本编辑器，以及从命令行调用的
独立工具。

配置

提供的选项 箱 如下：

-a 绳子
框内文本的对齐/定位。 此选项采用格式字符串参数
这是从左到右阅读。 格式字符串不能包含空格和
必须由以下一项或多项组成：

hx - 可能更大的框内输入文本块的水平对齐方式。
可能的值 x ，那恭喜你， l （嗯，用于左对齐）， c （中心），或 r （对）。
这不会影响输入文本块内文本行的对齐
（使用 j 取而代之）。
vx - 可能更大的框内输入文本块的垂直对齐方式。
可能的值 x ，那恭喜你， t （用于顶部对齐）， c （中心），或 b （底部）。
jx - 输入文本块内的行对齐。 可能的值 x ，那恭喜你， l
（嗯，左对齐）， c （中心），或 r （对）。 这不影响
输入文本块本身在框中的对齐方式。 使用 h 和 v 参数
用于输入文本块定位。

简写符号（可与上述参数结合使用）：
l (ell) - 简称 hlvcjl
c - 短缺 hcvcjc
r - 短缺 hrvcjr

出厂默认设置为 -a is hlvt.

-c 绳子
简单案例的命令行设计定义。 此选项的参数是
“西” (W) 形状的定义。 定义的形状必须由一个
线，即不允许多线形状。 这 -c 选项旨在作为快捷方式
对于那些需要创建简单区域注释的情况，只需要一个
要放置在每一行前面的某个字符或字符序列。 在
在这种情况下，简单地指定更方便 -c 比做一个完整的
配置文件中的设计定义，其中定义的唯一形状是西方
形状。
这个选项意味着一个 -d 并且不访问配置文件。 -c 当然可能是
与任何其他选项结合使用。 默认情况下， -c 未指定。

-d 绳子
设计选择。 此选项的一个参数是要使用的设计名称。

-f 绳子
使用备用配置文件。 此选项的一个参数是有效的名称
箱 配置文件，包含新的和令人兴奋的设计！

-h 打印使用信息。

-i 绳子
缩进模式。 可能的参数是“文本”（框内缩进文本），“框”
（缩进框，不是框内的文本），或“无”（丢弃缩进）。 参数
可以缩写。 默认是缩进框​​，而不是文本。

-k 布尔
删除前导/尾随空行。 的价值 布尔 可以指定为
on、yes、true、1 或 t，均表示是，或 off、no、false、0 或 f，均表示否。
这是不区分大小写的。 此选项仅在与 -r。 如果
设置为 yes，将从输出中删除前导和尾随空行。 如果设置
否，返回前一个框的全部内容。 默认为否，如果两者都
盒子的顶部和底部是开放的，就像大多数区域一样
注释。 如果盒子的设计定义了顶部或底部，则默认为
是。

-l (ell) 列出设计。 生成配置中所有可用框设计的列表
文件，以及一个示例框和有关它的创建者的信息。 还检查
整个配置文件的语法。 如果结合使用 -d, 显示详细
有关指定设计的信息。

-m 补箱。 这会删除一个（可能损坏的）盒子，就像 -r，并重新绘制它
然后。 根据给定的选项绘制修补的框。 这可能是
重要的是要知道何时恢复填充、标识等
修补过的盒子。 暗示 -k 假。

-p 绳子
填充。 在输入文本块周围的空格中指定填充
盒子。 参数字符串不能包含空格，必须由一个
以下字符的组合，每个字符后跟一个数字，表示
在空格中填充：
a -（全部）一次为所有边提供填充
h - (horiz) 为两个水平边提供填充
v -（垂直）为两个垂直边提供填充
b -（底部）为底部（南）侧提供填充
l -（左）为左（西）侧提供填充
t - （顶部）为顶部（北）侧提供填充
r -（右）为右（东）侧提供填充
示例： -p a4t2 会将内边距定义为所有边的 4 个字符，除了
对于框的顶部，输入文本块将仅距 2 行
盒子。
默认情况下，除非在配置文件中另外指定，否则不使用填充。

-r 取出盒子。 删除现有的框而不是绘制它。 使用哪种设计是
自动检测。 为了节省时间或万一检测不
正确决定，结合 -d 指定设计。 默认是绘制一个
新盒子。

-s 宽度x高度
盒子大小。 此选项以列为单位指定所需的框大小（对于宽度）
和线（用于高度）。 如果只给出一个数字作为参数，这个数字
指定所需的框宽度。 以“x”为前缀的单个数字仅指定
箱体高度。 实际产生的盒子大小可能因个人而异
所选设计的形状尺寸。 此外，其他命令行选项可能会影响
盒子尺寸（如 -p).
默认情况下，围绕文本创建尽可能小的框。

-t 绳子
标签处理。 此选项控制如何处理输入文本中的制表符。
选项字符串必须始终以 UINT 表示距离的数字
制表位之间。 正确设置此值很重要，或制表器
字符会打乱您的输入文本。 正确的制表距离值取决于
用于您正在处理的文本的设置。 一个常见的值是 8。
紧随制表距离之后，可以附加一个可选字符，
告诉 箱 如何处理前导标签。 以下选项可用：
e - 将标签扩展为空格
k - 保持标签尽可能接近他们的状态
u - 取消展开标签。 这使得 箱 将尽可能多的空格转换为制表符。

为了保持向后兼容性， -t 绳子 可以只是一个数字。 在
那种情况， e 假定用于选项卡处理，这将删除所有选项卡并替换它们
带空格。 出厂默认为 -t 选项只是 8，这就是这样一个
情况。
例如，您可以指定 -t 4u 以使您的前导标签未展开。
在框内容中，制表符始终转换为空格。 这里的标签距离
例子是 4。

-v 打印出当前版本号。

配置 FILES

盒 将使用命令行上指定的配置文件（使用 -f）。 如果不
在命令行中指定配置文件， 箱 将检查 BOXES 环境
变量，其中可能包含要使用的文件名。 如果未设置 BOXES， 箱 会尝试阅读
$HOME/.boxes 并将其用作配置文件。 做不到这一点， 箱 将尝试阅读
系统范围的配置文件（请参阅文件）。

的语法 箱 配置文件在网站上有描述（见下文）。 他们相当
不言自明，虽然。

可用性

盒 可从其网站获得http://boxes.thomasjensen.com/>. 网站
还提供了许多说明本手册页以及更深入的示例
文档。

看一看 VIM(1) 在http://www.vim.org/>!

使用 onworks.net 服务在线使用 box