dialog的man文档 -- 中文翻译

MichaelBibby

希望大家帮忙校对。有任何的翻译错误或是译得不准确的地方，可以直接跟贴提出，也可以发邮件给我。欢迎您的任何建议和反馈。

dialog 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)

[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]

MichaelBibby

第二部分：box options (对话框选项)

由 MichaelBibby 翻译并做初步校对。


[code:1]对话框选项

      
       所有的对话框至少有三个参数：



       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便退

BOoRFGOnZ

感谢 MichaelBibby,

MichaelBibby

[quote:38805cb386="BOoRFGOnZ"]感谢 MichaelBibby,[/quote]怎么现在被顶上来了

有翻译得不对和不准确的地方，欢迎大家指正
我尽快修正

谢谢

BOoRFGOnZ

现在也不晚阿  

wuyadu

看了，顶了

zhiguo9503

不错！

MichaelBibby

关于'--colors'的使用：
这个选项改变的是文字的背景色和文字的颜色，不是这个对话框的背景色
使用方法为：

[code:1]
dialog --colors --yesno "\Z0\Z1 Yes or no ?" 15 60[/code:1]

[code:1]
b Bold
B reset （对b的reset）

u underline
U reset（对u的reset）

r reverse（背景）
R reset（对r的reset）
[/code:1]

[code:1]
0 black
1 red
2 green
3 yellow
4 blue
5 magenta
6 cyan
7 white[/code:1]