dialog的man文档 -- 中文翻译
MichaelBibby
|
1#
发表于 2004-09-30 20:29
dialog的man文档 -- 中文翻译
希望大家帮忙校对。有任何的翻译错误或是译得不准确的地方，可以直接跟贴提出，也可以发邮件给我。欢迎您的任何建议和反馈。
 dialog homepage: http://hightek.org/dialog/ dialog的man文档中文翻译 Dialog Version : Version: 1.0-20040731 第一部分：common options 由 Rickyaaron@LinuxFans.org 和 MichaelBibby@LinuxFans.org 翻译完成，MichaelBibby校对。 Rickyaaron (ricky293 AT tom DOT com) MichaelBibby (michaelbibby AT sohu DOT com) [code:1] 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”按钮指定字符串。 [/code:1] |
看了，顶了