dialog的man文档 -- 中文翻译
希望大家帮忙校对。有任何的翻译错误或是译得不准确的地方,可以直接跟贴提出,也可以发邮件给我。欢迎您的任何建议和反馈。 :odialog homepage:
http://hightek.org/dialog/
dialog的man文档中文翻译
Dialog Version :
Version: 1.0-20040731
第一部分:common options
由 [email protected] 和 [email protected] 翻译完成,MichaelBibby校对。
Rickyaaron (ricky293 AT tom DOT com)
MichaelBibby (michaelbibby AT sohu DOT com)
DIALOG(1) DIALOG(1)
名称
dialog - 由shell显示的对话框。
概要
dialog --clear
dialog --create-rc file
dialog --print-maxsize
dialog common-options box-options
描述
dialog 是一个可以让你陈列各种问题或者使用一个shell script的对话框来显示信息的程序。
以下对话框的类型已经实现(尽管不是所有都被编译进dialog)
calendar, checklist, form, fselect,gauge,infobox,inputbox,
inputmenu, menu, msgbox (message), password, radiolist, tailbox,
tailboxbg, textbox, timebox, and yesno (yes/no)。
你可以在一个脚本中放置一个或多个对话框
- 使用 –and-widget 表示强制Dialog处理到下一个dialog直到按下ESC键取消。
- 简单地加一个标志给下一个对话框,组合成一条链。当一个会话的返回值为非0,比如,
Cancel或者No(查看诊断),会话就会停止。
一些部件,比如,清单,会写文本到会话的输出。
一般情况下是标准错误,但是这里有一些选项可以改变它: --output-fd,--stderr 和 --stdout。
在按下Cancel(或ESC)时不会写入文本;这种情况下会话会立即退出。
选项
所有的选项以"--"开头。
单独的”--“符号作为跳脱符(ESCAPE)使用,也就是说,命令行上的下一个标记不作为一个选项。
dialog --title -- --Not an option
--file 选项告诉dialog从文件中读取参数作为它的值。
dialog --file parameterfile
不被双引号所引用的空白部分是无效的(使用反斜线来引用单个字符)。结果会被插入命令行并替代
--file 选项和它的值。命令行将从那个位置解释。
普通选项
--aspect ratio
当你使用自动调整大小的时候这个参数给你控制框的大小(范例 0的高和宽)。
它描述宽/高,默认值为9,意思是1行有9个字大小。
--backtitle backtitle
指定显示在背景顶端的标题。
--beep
每次刷新屏幕时发出声音警告。
--beep-after
输入被中断时发出声音警报。例如ctrl/C。
--begin y x
指定对话框左上角在屏幕上的坐标。
--cancel-label string
为“Cancel”按钮指定标签。
--clear
退出时清屏。这个参数只能单独使用,不能和别的参数联合使用。
--colors
解释内含在对话框的”\Z”的顺序属性。他告诉对话框设置颜色或者视频属性:
0到7是ANSI码在curses中分别指定为:黑色,红色,绿色,黄色,蓝色,紫红色,蓝绿色和白色。
粗体用’b’设置,重设用‘B’。背面用’r’设置,重设用’R’。下划线用’u’设置,
重设用’U’。所做出的改动将会累积起来。例如,”\Zb\Z1’”表示文本显示红色。
恢复正常的设置用”\Zn”。
--cr-wrap
解释对话框内的文本换行相当于一个新行。另外。dialog只会控制文本适应对话框。
即使你可以控制一行突破这个规则,dialog也会自动调整所有在对话框内的文本
使他们与对话框的宽度一样。不用cr-wrap,文本的版面会排列成脚本的原始规则。
参看 --no-collapse 和 --trim 选项。
--create-rc file
当对话框支持运行时配置,这个参数可用来一个示例的配置文件并指定这个文件。
--defaultno
设置yes/no对话框的默认值为NO。同样的,可以使提供OK和Cancel按钮的组件默认按钮
为Cancel。如果给出的 --nocancel 参数覆盖了这个参数,默认的按钮就是YES(
内部和OK按钮一样)
--default-item string
设置menu对话框中checklist的默认选项,通常是第一项。
--exit-label string
为“EXIT”按钮指定标签。
--extra-button
在OK和Cancel按钮之间添加一个按钮。
--extra-label string
为添加的按钮“Extra”指定标签。注意:在inputmenu组件中,默认是Rename。
--help
打印帮助信息到标准输出。如果没有给出选项,帮助信息就会被打印出来。
--help-button
在checklist,radiolist和menu的对话框OK和Cancel按钮之后显示一个帮助按钮。
如果同时也给出了 -—item-help 选项,退出时返回值和”OK”按钮的返回值一样,
而且 --item-help 的内容会被写到会话的输出。另外,返回状态显示“Help”按钮被按下,
并且没有信息被打印出来。
--help-label string
为“Help”按钮指定标签。
--help-status
如果选择了 --help-button 选项,在 --item-help 的帮助信息之后会显示checklist,
radiolist或者form的信息。这个选项可以在处理完help请求后重建checklist的状态。
--ignore
忽略dialog不认可的选项。众所周知的一个是"--icon"选项,任何情况下都会被忽略,
但这是一个相对其他实现而言兼容性较好的选择。
--input-fd fd
从给定的文件描述符中读取键盘输入。大部分的dialog脚本从标准输入读取,但是gauge
组件从管道读取(那通常是标准输入)。当dialog试着重新打开终端时一些配置不能严格执行。
如果你的脚本必须工作在那种类型的环境中,可以使用这个选项。
--insecure
输入密码时回显星号(×),将使得passwd组件更友好但较不安全。
--item-help
在屏幕底部为当前选择的的项目增加一列,用以解释说明checklist和menu对话框的标签数据。
--keep-window
退出时不清屏和重绘窗口。当几个组件在同一个程序中运行时,对于保留窗口内容很有用的。
注意,curses在开始一个新的处理时会清空屏幕。
--max-input size
限制输入的字符串在给定的大小之内。如果没有指定,默认是2048。
--no-cancel
--nocancel
在checklist,inputbox和menu对话框中禁用“Cancel”按钮。脚本仍然可以监测用户
是否按下ESC键退出。
--no-collapse
通常dialog将tab符转化为空格,并在message对话框中将多个空格减少为一个空格。
使用这个选项可以禁用这个功能。应该注意的是,dialog仍然会约束文本和正文遵从
--cr-wrap 和 --trim 选项。
--no-kill
告诉dialog放置一个tailboxbg对话框在后台,同时打印它的进程ID号到dialog的输出。
做为后台进程运行时,SIGHUP是被禁止的。
--no-label string
为“NO”按钮指定标签。
--no-shadow
禁止对话框投向右下方的阴影。
--ok-label string
为“OK”按钮指定标签。
--output-fd fd
直接输出到给定的文件描述符。多数dialog脚本写到标准输出,但是错误信息可能也被
输出到那里,这取决于你的脚本。
--print-maxsize
打印对话框最大的大小(也就是屏幕大小)到标准输出。
这个参数要单独使用,不能和别的参数一起使用。
--print-size
打印每一个对话框的大小到标准错输出。
--print-version
打印dialog的版本到标准输出。这个参数要单独使用,不能和别的参数一起使用。
--separate-output
对于chicklist组件,输出结果一次输出一行,没有限额.这一便利的分离可以被别的程序使用。
--separator string
--separate-widget string
指定一个分隔符,分离dialog中每个组件的输出。它可以用来简单地分析一个dialog
中几个组件的结果。如果没有给出这个选项,默认的分隔符是一个tab符号。
--shadow
在每一个对话框的右下方显示阴影。
--single-quoted
对于checklist的输出,象 --item-help 的帮助文本一样,如果需要,就使用单引号
(如果不需要就用引号)如果没有设置这个选项,dialog使用双引号来引用每个选项。
这需要临时使用反斜杆以便输出对shell脚本有用。
--size-err
在试图使用对话框之前检查对话框形成后的大小。如果大于屏幕就会打印检查出来的大小。
(这个参数已经废弃了,所有被调用的新窗口都会被监测。)
--sleep secs
在处理完一个对话框后静止(延迟)的时间(秒)。
--stderr
直接输出到标准错误。自从curses规则地将屏幕更新写入标准输出以来,这就是默认的。
--stdout
直接输出到标准输出。自从curses规则地将屏幕更新写入标准输出以来,就提供这个选项
为Xdialog提供兼容,但是不推荐在可移植的脚本中使用。如果使用这个选项,dialog
为了显示,会试着重新打开终端。这依赖于你的平台和环境,可能会失败。
--tab-correct
转换每个tab字符为一个或多个空格。另外,tab会根据curses库的说明进行渲染。
--tab-len n
如果给出了 --tab-correct 选项,指定一个tab符号为多少个空格。默认是8。
--timeout secs
如果在指定的时间内没有用户应答则超时退出(以错误规则退出)。如果后台使用了
--tailboxbg选项,它就会失效。指定为0秒时将被忽略。
--title title
指定显示在对话框顶部的标题。
--trim
除去主要的空白部分,从文字上新的一行来调整并显示消息正文。
参看 --cr-wrap 和 --no-collapse 选项。
--version
等同于”—print-version”。
--visit-items
修改checklist,radiobox,menubox和inputmenu的tab键遍历功能,使得列表中的
选项可以用tab键访问。这是一个视觉上的帮助,光标的位置可以帮助一些用户。
--yes-label string
为“YES”按钮指定字符串。
第二部分:box options (对话框选项)
由 MichaelBibby 翻译并做初步校对。
对话框选项
所有的对话框至少有三个参数:
text
对话框的标题或内容。
height
对话框的高度。
width
对话框的宽度。
其它参数依赖于dialog框类型。
--calendar text height width day month year
日历框在单独的可调整的窗口中显示 月/日/年。如果没有给出 日/月/年 的值,或所给
的值为负数,将会使用当前日期的相应值代替。可以用上、下、左、右这几个方向键来增大
或减小它们的值。用VI风格的h,j,k,l键在日期之间移动。tab或backtab(退格制表符)
在窗口之间移动。如果所给的年的值为0,那么当前日期的年份将作为初始值。
退出的时候,日期会以 日/月/年 的格式打印到终端。
--checklist text height width list-height [ tag item status ] 。。。
checklist对话框就象一个menu对话框,在表单中列出多个选项。用户可以选中或去掉
每一个选项,而不是在选项之间选择一个。可以用status来指定每个选项默认是选中还是去除。
退出时,被选中的选项的tag字符串会以列表的格式输出到dialog的输出。如果没有给出
--separate-output选项,字符串将会被引用起来以便脚本容易分离它们。参看
修改引用行为的--single-quoted选项。
--form text height width formheight [ label y x item y x flen ilen ] . . .
form对话框显示一个由标签(label)和域(field)组成的表单,而这些标签和域被放置在
给定坐标的可滚动窗口上。域的高度(the field length)flen和输入高度(input-length)
ilen表明了域的最大长度。前者定义了显示被选择的域高度,后者定义了域中
输入数据的长度。如果flen为0,对应的域就不能更改。如果ilen为0,则被设置为flen的值。
使用上、下箭头(或者control/N,control/P)在区域之间移动,tab键在窗口之间移动。
退出时,表单域的内容被写入到dialog的输出,每个域由新的一行分隔。只用于输入的区域
(flen为0)不会被输出。
--fselect filepath height width
文件选择对话框(file-selection dialog)显示一个文本条目窗口,上面的两个
窗口标着目录名和文件名,你可以输入一个文件名(或目录)。
文件路径可以是目录窗口显示的路径和文件,文本条目窗口包含了预选的文件名。
使用tab键或箭头键可以在窗口之间移动。在目录窗口或文件窗口内使用up/down箭头键
在列表中选择。空格键复制当前的选择到文本条目窗口。
键入一些可打印的字符可以在文本条目窗口中选择焦点,键入字符可以滚动目录窗口和
文件窗口到最靠近的匹配。
回车键或”OK“按钮接受文本条目窗口中当前的结果并退出。
退出时,文本条目窗口的内容被写入到dialog的输出。
--gauge text height width [percent]
gauge box在对话框底部显示一个指示百分比的计量器。新的百分比从标准输入中读取,
一行便是一个整体。计量器在达到新的百分比时更新一次。标准输入读取字符串”XXX“,然后
跟在另一个的”XXX“后面的行被作为新的提示符。文件结束符(EOF)到达标准输入时,gauge便退 感谢 MichaelBibby, 感谢 MichaelBibby,怎么现在被顶上来了 :)
有翻译得不对和不准确的地方,欢迎大家指正
我尽快修正
谢谢 :) 现在也不晚阿:mrgreen: :-D 看了,顶了 不错! 关于'--colors'的使用:
这个选项改变的是文字的背景色和文字的颜色,不是这个对话框的背景色
使用方法为:
dialog --colors --yesno "\Z0\Z1 Yes or no ?" 15 60
b Bold
B reset (对b的reset)
u underline
U reset(对u的reset)
r reverse(背景)
R reset(对r的reset)
0 black
1 red
2 green
3 yellow
4 blue
5 magenta
6 cyan
7 white
页:
[1]