<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY author1 "Sun">
<!ENTITY author2 "Java Desktop System Documentation Team">
<!ENTITY publisher "Sun Microsystems, Inc.">
<!ENTITY legal SYSTEM "legal.xml">
<!ENTITY appversion "2.6.0">
<!ENTITY app "<application>MateDialog</application>">
<!ENTITY appname "MateDialog">
<!ENTITY date "August 2004">
<!ENTITY manrevision "2.0">
]>
<!-- ================ Document Header ================= -->
<article id="index" lang="ru">

  <articleinfo>
    <title>Руководство MateDialog</title>
    <subtitle>MateDialog Руководство приложения рабочего стола В2.0</subtitle>
    <copyright lang="en">
	    <year>2003</year>
	    <year>2004</year>
	    <holder>Sun Microsystems, Inc.</holder>
    </copyright>

    <!-- Translators: uncomment this
    <copyright>
	    <year>2004</year>
	    <holder>ME_THE_TRANSLATOR</holder>
    </copyright>
    -->

    <publisher>
	    <publishername lang="en">Sun Microsystems, Inc.</publishername>
    </publisher>

      <legalnotice id="legalnotice">
	<para>Следующим разрешается копировать и/или модифицировать этот документ при условии соблюдения GNU Free Documentation License (GFDL), версии 1.1 или любой более поздней опубликованной ассоциацией свободного программного обеспечения версией без неизменяемых частей, без текстов на обложках. Вы можете найти копию лицензии по этой <ulink type="help" url="help:fdl">ссылке</ulink> или в файле COPYING-DOCS, распространяемом с этим документом.</para>
         <para>Этот документ является частью документации MATE распространяемой под лицензией GFDL. Если вы хотите распространять этот документ отдельно от общей документации, вы должны приложить копию лицензии к документу, как написано в части 6 лицензии.</para>

	<para>Некоторые имена и марки используются компаниями для различения их продуктов и услуг и являются торговыми марками. Эти марки присутствуют в документации и члены проекта документирования MATE знают об этом. Имена выделяются заглавными буквами или начальной заглавной буквой.</para>

	<para lang="en">
	  DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
	  UNDER  THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
	  WITH THE FURTHER UNDERSTANDING THAT:

	  <orderedlist>
		<listitem>
		  <para lang="en">DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
                    WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
                    IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
                    THAT THE DOCUMENT OR MODIFIED VERSION OF THE
                    DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
                    A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
                    RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
                    OF THE DOCUMENT OR MODIFIED VERSION OF THE
                    DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
                    MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
                    YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
                    CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
                    SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
                    OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
                    LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
                    VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
                    EXCEPT UNDER THIS DISCLAIMER; AND
		  </para>
		</listitem>
		<listitem>
		  <para lang="en">UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
                       THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
                       CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
                       INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
                       DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
                       OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
                       PARTIES, BE LIABLE TO ANY PERSON FOR ANY
                       DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
                       CONSEQUENTIAL DAMAGES OF ANY CHARACTER
                       INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
                       OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
                       MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
                       LOSSES ARISING OUT OF OR RELATING TO USE OF THE
                       DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
                       EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
                       THE POSSIBILITY OF SUCH DAMAGES.
		  </para>
		</listitem>
	  </orderedlist>
	</para>
  </legalnotice>



    <authorgroup>
      <author lang="en">
        <firstname>Sun</firstname>
        <surname>Java Desktop System Documentation Team</surname>
        <affiliation><orgname>Sun Microsystems, Inc.</orgname></affiliation>
      </author>
      <author role="maintainer" lang="en">
        <firstname>Glynn</firstname>
        <surname>Foster</surname>
        <affiliation>
          <orgname>MATE Documentation Project</orgname>
        </affiliation>
      </author>
      <editor lang="en">
        <firstname>Nicholas</firstname>
        <surname>Curran</surname>
        <affiliation>
          <orgname>MATE Documentation Project</orgname>
        </affiliation>
      </editor>
    </authorgroup>

    <revhistory>
      <revision lang="en">
        <revnumber>MateDialog Desktop Application Manual V2.0</revnumber>
        <date>August 2004</date>
        <revdescription>
          <para role="author" lang="en">Sun Java Desktop System Documentation Team</para>
          <para role="publisher" lang="en">Sun Microsystems, Inc.</para>
        </revdescription>
      </revision>

      <revision lang="en">
        <revnumber>MateDialog Manual V1.0</revnumber>
        <date>January 2003</date>
        <revdescription>
          <para role="author" lang="en">Glynn Foster</para>
          <para role="publisher" lang="en"> MATE Documentation Project </para>
        </revdescription>
      </revision>
    </revhistory>

    <releaseinfo>Это руководство описывает версию MateDialog 2.6.0.</releaseinfo>

    <legalnotice>
	    <title>Обратная связь</title>
	    <para>Для обратной связи, следуйте указаниям на <ulink url="help:mate-feedback" type="help">странице обратной связи</ulink>.</para>
<!-- Translators may also add here feedback address for translations -->

    </legalnotice>
    <abstract role="description">
            <para>MateDialog это обновлённая версия gdialog, адаптация программы dialog для среды MATE. Это приложение позволяет вам изображать диалоговые окна с помощью команд из командной строки и сценариев оболочки.</para>
    </abstract>
  </articleinfo>
  
  <indexterm lang="en">
    <primary>matedialog command</primary>
  </indexterm>
  <indexterm lang="en">
    <primary>dialog creator</primary>
  </indexterm>
<!-- ================ Document Body ================= -->

<!-- ==== Introduction ====== -->

  <sect1 id="matedialog-introduction">
    <title>Введение</title>

    <para><application>MateDialog</application> позволяет вам создавать следующие типы простых диалоговых окон:</para>

    <itemizedlist>
        <listitem><para>Календарь</para></listitem>
	<listitem><para>Выбор файла</para></listitem>
	<listitem><para>Список</para></listitem>
	<listitem><para>Значок уведомления</para></listitem>
        <listitem><para>Сообщение</para>
            <itemizedlist>
	        <listitem><para>Ошибка</para></listitem>
		<listitem><para>Информация</para></listitem>
		<listitem><para>Вопрос</para></listitem>
		<listitem><para>Предупреждение</para></listitem>
	    </itemizedlist>
	</listitem>
	<listitem><para>Прогресс</para></listitem>
        <listitem><para>Ввод текста</para></listitem>
	<listitem><para>Текстовая информация</para></listitem>
    </itemizedlist>

  </sect1>

<!-- ==== Usage ====== -->

  <sect1 id="matedialog-usage">
    <title>Использование</title>

    <para>Когда вы пишите сценарии, вы можете использовать <application>MateDialog</application>, чтобы создавать простые диалоговые окна, которые графически взаимодействуют с пользователем, как в следующих случаях:</para>
    <itemizedlist>
      <listitem>
        <para>Вы можете создать диалоговое окно, чтобы получить информацию от пользователя. Например, вы можете попросить пользователя выбрать дату из календаря или выбрать файл из окна выбора файла.</para>
      </listitem>
      <listitem>
        <para>Вы можете создать диалоговое окно, чтобы предоставить информацию пользователю. Например, вы можете использовать окно с индикатором прогресса, чтобы указать текущее состояние операции или использовать окно предупреждения, чтобы оповестить пользователя.</para>
      </listitem>
    </itemizedlist>
    <para lang="en">
	When the user closes the dialog, <application>MateDialog</application> prints the text produced by the dialog to standard output.
    </para>

    <note>
      <para>Когда вы пишите команды <application>MateDialog</application>, убедитесь, что вы помещаете каждый аргумент в кавычки.</para>
      <para lang="en">
        For example, use: <screen lang="en"><userinput><command>matedialog --calendar --title="Holiday Planner"</command></userinput></screen> Do not use: <screen lang="en"><userinput><command>matedialog --calendar --title=Holiday Planner</command></userinput></screen>
      </para>
      <para>Если вы не используете кавычки, вы можете получить неожиданные результаты.</para>
    </note>

    <sect2 id="matedialog-usage-mnemonics">
      <title>Клавиша доступа</title>
	<para>Клавиша доступа это клавиша, которая позволяет вам выполнять действие с клавиатуры, нежели используя мышь для выбора команды из меню или диалогового окна. Каждая клавиша доступа устанавливается с помощью подчёркнутой буквы в параметре, задающем текст меню или диалогового окна.</para>
	<para>Некоторые окна <application>MateDialog</application> поддерживают использование клавиш доступа. Чтобы указать символ, который нужно использовать для клавиши доступа, поместите знак подчёркивания перед тем символом в тексте диалогового окна. Следующий пример показывает, как установить букву 'В' для клавиши доступа:</para>
	<screen lang="en"><userinput>"_Choose a name".</userinput></screen>
    </sect2>

    <sect2 id="matedialog-usage-exitcodes">
      <title>Коды Выхода</title>
    <para><application>MateDialog</application> возвращает следующие коды выхода:</para>

    <informaltable frame="all">
      <tgroup cols="2" colsep="1" rowsep="1">
        <colspec colname="COLSPEC0" colwidth="50*"/>
        <colspec colname="COLSPEC1" colwidth="50*"/>
        <thead>
          <row valign="top">
            <entry colname="COLSPEC0">
              <para>Код выхода</para></entry>
            <entry colname="COLSPEC1">
              <para>Описание</para></entry>
          </row>
        </thead>
        <tbody>
          <row valign="top">
            <entry>
              <para lang="en"><varname>0</varname></para>
            </entry>
            <entry>
              <para>Пользователь нажал либо <guibutton>OK</guibutton>, либо <guibutton>Закрыть</guibutton>.</para>
            </entry>
          </row>
          <row valign="top">
            <entry>
              <para lang="en"><varname>1</varname></para>
            </entry>
            <entry>
              <para>Пользователь либо нажал <guibutton>Отмена</guibutton>, либо использовал функции окна, чтобы закрыть диалоговое окно.</para>
            </entry>
          </row>
          <row valign="top">
            <entry>
              <para lang="en"><varname>-1</varname></para>
            </entry>
            <entry>
              <para>Произошла неожиданная ошибка.</para>
            </entry>
          </row>
          <row valign="top">
            <entry>
              <para lang="en"><varname>5</varname></para>
            </entry>
            <entry>
              <para lang="en">The dialog has been closed because the timeout has been reached.</para>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </informaltable>

    </sect2>


  <!-- ==== General Options ====== -->

  <sect2 id="matedialog-usage-general-options">
    <title>Общие параметры</title>

    <para>Все диалоговые окна <application>MateDialog</application> поддерживают следующие общие параметры:</para>

    <variablelist>

      <varlistentry>
        <term><option>--title</option>=<replaceable>заголовок</replaceable></term>
	<listitem>
	  <para>Указывает заголовок диалогового окна.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--window-icon</option>=<replaceable>путь_к_значку</replaceable></term>
	<listitem>
	  <para>Указывает значок, который изображается в рамке диалогового окна. Существуют 4 запасных значка, доступных по следующим ключевым словам - 'info', 'warning', 'question' и 'error'.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--width</option>=<replaceable>ширина</replaceable></term>
	<listitem>
	  <para>Указывает ширину диалогового окна.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--height</option>=<replaceable>высота</replaceable></term>
	<listitem>
	  <para>Указывает высоту диалогового окна.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--timeout</option>=<replaceable>timeout</replaceable></term>
	<listitem>
	  <para lang="en">Specifies the timeout in seconds after which the dialog is closed.</para>
	</listitem>
      </varlistentry>

    </variablelist>

  </sect2>

<!-- ==== Miscellaneous Options ====== -->

  <sect2 id="matedialog-help-options">
    <title>Параметры вызова справки</title>

    <para><application>MateDialog</application> предоставляет следующие параметры справки:</para>

    <variablelist>

      <varlistentry>
        <term lang="en"><option>--help</option></term>
	<listitem>
	  <para>Показывает сокращённый текст помощи.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--help-all</option></term>
	<listitem>
	  <para>Показывает полный текст помощи для всех диалоговых окон.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-general</option></term>
	<listitem>
	  <para>Показывает текст помощи по общим параметрам диалоговых окон.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-calendar</option></term>
	<listitem>
	  <para>Показывает текст помощи по параметрам диалогового окна календаря.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-entry</option></term>
	<listitem>
	  <para>Показывает текст помощи по параметрам диалогового окна ввода текста.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-error</option></term>
	<listitem>
	  <para>Показывает текст помощи по параметрам диалогового окна сообщения об ошибке.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-info</option></term>
	<listitem>
	  <para>Показывает текст помощи по параметрам диалогового окна информации.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-file-selection</option></term>
	<listitem>
	  <para>Показывает текст помощи по параметрам диалогового окна выбора файла.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-list</option></term>
	<listitem>
	  <para>Показывает текст помощи по параметрам диалогового окна списка.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-notification</option></term>
	<listitem>
	  <para>Показывает текст помощи по параметрам значка уведомлений.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-progress</option></term>
	<listitem>
	  <para>Показывает текст помощи по параметрам диалогового окна индикатора прогресса.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-question</option></term>
	<listitem>
	  <para>Показывает текст помощи по параметрам диалогового окна вопроса.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-warning</option></term>
	<listitem>
	  <para>Показывает текст помощи по параметрам диалогового окна предупреждения.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-text-info</option></term>
	<listitem>
	  <para>Показывает текст помощи по параметрам диалогового окна текстовой информации.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-misc</option></term>
	<listitem>
	  <para>Показывает помощь по разнообразным параметрам.</para>
	</listitem>
      </varlistentry>
 
      <varlistentry>
        <term lang="en"><option>--help-gtk</option></term>
	<listitem>
	  <para>Показывает помощь по параметрам GTK+ .</para>
	</listitem>
      </varlistentry>
 
    </variablelist>

  </sect2>

<!-- ==== Miscellaneous Options ====== -->

  <sect2 id="matedialog-miscellaneous-options">
    <title>Разнообразные параметры</title>

    <para><application>MateDialog</application> также может запускаться со следующими дополнительными параметрами:</para>

    <variablelist>

      <varlistentry>
        <term lang="en"><option>--about</option></term>
	<listitem>
	  <para>Изображает диалоговое окно <guilabel>О программе MateDialog</guilabel>, которое содержит информацию о версии <application>MateDialog</application>, информацию об авторских правах и информацию о разработчике.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--version</option></term>
	<listitem>
	  <para>Изображает номер версии <application>MateDialog</application>.</para>
	</listitem>
      </varlistentry>

    </variablelist>

  </sect2>

<!-- ==== GTK+ Options ====== -->

  <sect2 id="matedialog-gtk-options">
    <title>Параметры GTK+</title>

    <para><application>MateDialog</application> поддерживает стандартные параметры программ GTK+ . Для получения большей информации о GTK+ параметрах, выполните команду <command>matedialog -?</command>.</para>

  </sect2>

<!-- ==== Environment variables ==== -->

  <sect2 id="matedialog-environment-variables">
    <title lang="en">Environment Variables</title>

    <para lang="en">
      Normally, <application>MateDialog</application> detects the terminal window from which it was launched
      and keeps itself above that window.  This behavior can be disabled by
      unsetting the <envar>WINDOWID</envar> environment variable.
    </para>

  </sect2>

  </sect1>
<!-- ==== Calendar Options ====== -->

  <sect1 id="matedialog-calendar-options">
    <title>Диалоговое окно календарь</title>

    <para lang="en">
        Use the <option>--calendar</option> option to create a calendar dialog. <application>MateDialog</application> returns the selected date to standard output. If no date is specified on the command line, the dialog uses the current date.
    </para>
    <para>Диалоговое окно календарь поддерживает следующие параметры:</para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>текст</replaceable></term>
	<listitem>
	  <para>Указывает текст, который будет изображён в диалоговом окне календаря.</para>
	</listitem>
      </varlistentry>
     	
      <varlistentry>
        <term><option>--day</option>=<replaceable>день</replaceable></term>
	<listitem>
	  <para>Указывает день, который будет выделен в диалоговом окне календаря. <replaceable>День</replaceable> должен быть числом между 1 и 31 включительно.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--month</option>=<replaceable>месяц</replaceable></term>
	<listitem>
	  <para>Указывает месяц, который будет выделен в диалоговом окне календаря. <replaceable>Месяц</replaceable> должен быть числом между 1 и 12 включительно.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--year</option>=<replaceable>год</replaceable></term>
	<listitem>
	  <para>Указывает год, который будет выбран в диалоговом окне календаря.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--date-format</option>=<replaceable>формат</replaceable></term>
	<listitem>
	  <para>Указывает формат даты, в котором она будет возвращена после выбора из диалогового окна. Формат даты по умолчанию зависит от локальных настроек. <replaceable>Формат</replaceable> должен иметь вид, приемлемый функцией <command>strftime</command>, например <literal>%A %d/%m/%y</literal>.</para>
	</listitem>
      </varlistentry>

    </variablelist>

    <para lang="en">
      The following example script shows how to create a calendar dialog:

      <programlisting lang="en">
        #!/bin/sh


        if matedialog --calendar \
        --title="Select a Date" \
        --text="Click on a date to select that date." \
        --day=10 --month=8 --year=2004
          then echo $?
          else echo "No date selected"
        fi
      </programlisting>

    </para>

    <figure id="matedialog-calendar-screenshot">
      <title>Пример диалогового окна календарь</title>
      <screenshot>
        <mediaobject lang="en">
          <imageobject>
              <imagedata fileref="figures/matedialog-calendar-screenshot.png" format="PNG"/>
          </imageobject>
          <textobject>
              <phrase><application>MateDialog</application> calendar dialog example</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
   </figure>
													  
  </sect1>


<!-- ==== File Selection Options ====== -->

  <sect1 id="matedialog-file-selection-options">
    <title>Диалоговое окно выбора файла</title>

    <para lang="en">
	Use the <option>--file-selection</option> option to create a file selection dialog. <application>MateDialog</application> returns the selected files or directories to standard 
        output. The default mode of the file selection dialog is open.
    </para>
    <para>Диалоговое окно выбора файлов поддерживает следующие параметры:</para>

    <variablelist>

      <varlistentry>
        <term><option>--filename</option>=<replaceable>имя_файла</replaceable></term>
	<listitem>
	  <para>Указывает файл или директорию, которая будет выбрана в диалоговом окне, когда оно впервые появится.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term lang="en"><option>--multiple</option></term>
	<listitem>
	  <para>Позволяет выбирать сразу несколько файлов в окне выбора.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term lang="en"><option>--directory</option></term>
	<listitem>
	  <para>Позволяет выбирать только директории в диалоговом окне выбора файла.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term lang="en"><option>--save</option></term>
	<listitem>
	  <para>Устанавливает диалоговое окно в режим сохранения файла.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term><option>--separator</option>=<replaceable>разделитель</replaceable></term>
	<listitem>
	  <para>Указывает строку, которая будет использована для разделения возвращённого списка имён файлов.</para>
	</listitem>
      </varlistentry>

    </variablelist>

    <para lang="en">
      The following example script shows how to create a file selection dialog:

      <programlisting lang="en">
        #!/bin/sh

        FILE=`matedialog --file-selection --title="Select a File"`

        case $? in
                 0)
                        echo "\"$FILE\" selected.";;
                 1)
                        echo "No file selected.";;
                -1)
                        echo "No file selected.";;
        esac
      </programlisting>
    </para>

    <figure id="matedialog-fileselection-screenshot">
      <title>Пример диалогового окна выбора файла</title>
      <screenshot>
        <mediaobject lang="en">
          <imageobject>
            <imagedata fileref="figures/matedialog-fileselection-screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase><application>MateDialog</application> file selection dialog example</phrase>
	  </textobject>
        </mediaobject>
      </screenshot>
    </figure>

  </sect1>

<!-- ==== Notification Options ====== -->
  <sect1 id="matedialog-notification-options">
    <title>Значок уведомления</title>

    <para>
    </para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>текст</replaceable></term>
	<listitem>
	  <para>Указывает текст, который будет изображён в области уведомления.</para>
	</listitem>
      </varlistentry>

    </variablelist>

    <para lang="en">
      The following example script shows how to create a notification icon:
      <programlisting lang="en">
        #!/bin/sh

        matedialog --notification\
          --window-icon="info" \
          --text="There are system updates necessary!"
      </programlisting>

    </para>

    <figure id="matedialog-notification-screenshot">
      <title>Пример значка уведомления</title>
      <screenshot>
        <mediaobject lang="en">
          <imageobject>
              <imagedata fileref="figures/matedialog-notification-screenshot.png" format="PNG"/>
          </imageobject>
          <textobject>
              <phrase><application>MateDialog</application> notification icon example</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
   </figure>
													  
  </sect1>

<!-- ==== List Options ====== -->

  <sect1 id="matedialog-list-options">
    <title>Диалоговое окно списка</title>

    <para lang="en">
	Use the <option>--list</option> option to create a list dialog. <application>MateDialog</application> returns the entries in the first column of text of selected rows to standard output.
    </para>

    <para>Данные для этого диалогового окна должны указываться столбец за столбцом, строка за строкой. Данные могут быть поданы диалоговому окну через стандартный ввод. Каждая запись должна быть отделена символом новой строки.</para>

    <para>Если вы используете параметр <option>--checklist</option> или <option>--radiolist</option>, каждая строка должна начинаться либо с 'TRUE', либо с 'FALSE'.</para>

    <para>Диалоговое окно списка поддерживает следующие параметры:</para>

    <variablelist>

      <varlistentry>
        <term><option>--column</option>=<replaceable>столбец</replaceable></term>
	<listitem>
	  <para>Указывает заголовки столбцов, которые будут изображены в диалоговом окне списка. Вы должны указать параметр <option>--column</option> для каждого столбца, который вы хотите отобразить в диалоговом окне.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--checklist</option></term>
	<listitem>
	  <para>Указывает, что первый столбец в диалоговом окне списка содержит флажки.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--radiolist</option></term>
	<listitem>
	  <para>Указывает, что первый столбец в диалоговом окне содержит поля выбора.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--editable</option></term>
	<listitem>
	  <para>Позволяет редактирование изображаемых элементов.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--separator</option>=<replaceable>разделитель</replaceable></term>
	<listitem>
	  <para>Указывает строку-разделитель, используемую, когда диалоговое окно возвращает выбранные элементы.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--print-column</option>=<replaceable>столбец</replaceable></term>
	<listitem>
	  <para>Указывает, какой столбец нужно печатать при выборе элемента. По умолчания это 1-й столбец. Можно использовать 'ALL', чтобы печатать все столбцы из списка.</para>
	</listitem>
      </varlistentry>

    </variablelist>

    <para lang="en">
      The following example script shows how to create a list dialog:
      <programlisting lang="en">
        #!/bin/sh

        matedialog --list \
          --title="Choose the Bugs You Wish to View" \
          --column="Bug Number" --column="Severity" --column="Description" \
            992383 Normal "GtkTreeView crashes on multiple selections" \
            293823 High "MATE Dictionary does not handle proxy" \
            393823 Critical "Menu editing does not work in MATE 2.0"
      </programlisting>

    </para>

    <figure id="matedialog-list-screenshot">
      <title>Пример диалогового окна списка</title>
      <screenshot>
        <mediaobject lang="en">
          <imageobject>
            <imagedata fileref="figures/matedialog-list-screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase><application>MateDialog</application> list dialog example</phrase>
	  </textobject>
        </mediaobject>
      </screenshot>
    </figure>

  </sect1>

<!-- ==== Message Options ====== -->

  <sect1 id="matedialog-message-options">
    <title>Диалоговое окно сообщений</title>

    <para><application>MateDialog</application> может создавать четыре типа диалоговых окон сообщений:</para>
    <itemizedlist>
      <listitem>
        <para>Ошибка</para>
      </listitem>
      <listitem>
        <para>Информация</para>
      </listitem>
      <listitem>
        <para>Вопрос</para>
      </listitem>
      <listitem>
        <para>Предупреждение</para>
      </listitem>
    </itemizedlist>

    <para>Для каждого типа используйте параметр <option>--text</option>, чтобы задать текст в диалоге.</para>

    <sect2 id="matedialog-error-dialog">
      <title>Диалоговое окно ошибки</title>

      <para>Используйте параметр <option>--error</option>, чтобы создать диалоговое окно ошибки.</para>

      <para lang="en">
        The following example script shows how to create an error dialog:

        <programlisting lang="en">
          #!/bin/bash

          matedialog --error \
          --text="Could not find /var/log/syslog."
        </programlisting>

      </para>

      <figure id="matedialog-error-screenshot">
        <title>Пример диалогового окна ошибки</title>
        <screenshot>
          <mediaobject lang="en">
            <imageobject>
              <imagedata fileref="figures/matedialog-error-screenshot.png" format="PNG"/>
	    </imageobject>
	    <textobject>
	      <phrase><application>MateDialog</application> error dialog example</phrase>
	    </textobject>
          </mediaobject>
        </screenshot>
      </figure>
    </sect2>

    <sect2 id="matedialog-info-dialog">
      <title>Диалоговое окно информации</title>

      <para>Используйте параметр <option>--info</option>, чтобы создать диалоговое окно информации.</para>

      <para lang="en">
        The following example script shows how to create an information dialog:

        <programlisting lang="en">
          #!/bin/bash

          matedialog --info \
          --text="Merge complete. Updated 3 of 10 files."
        </programlisting>

      </para>

      <figure id="matedialog-information-screenshot">
        <title>Пример диалогового окна информации</title>
        <screenshot>
          <mediaobject lang="en">
            <imageobject>
              <imagedata fileref="figures/matedialog-information-screenshot.png" format="PNG"/>
	    </imageobject>
	    <textobject>
	      <phrase><application>MateDialog</application> information dialog example</phrase>
	    </textobject>
          </mediaobject>
        </screenshot>
      </figure>
    </sect2>

    <sect2 id="matedialog-question-dialog">
      <title>Диалоговое окно вопроса</title>

      <para>Используйте параметр <option>--question</option>, чтобы создать диалоговое окно вопроса.</para>

      <para lang="en">
        The following example script shows how to create a question dialog:

        <programlisting lang="en">
          #!/bin/bash

          matedialog --question \
          --text="Are you sure you wish to proceed?"
        </programlisting>

      </para>

      <figure id="matedialog-question-screenshot">
        <title>Пример диалогового окна вопроса</title>
        <screenshot>
          <mediaobject lang="en">
            <imageobject>
              <imagedata fileref="figures/matedialog-question-screenshot.png" format="PNG"/>
	    </imageobject>
	    <textobject>
	      <phrase><application>MateDialog</application> question dialog example</phrase>
	    </textobject>
          </mediaobject>
        </screenshot>
      </figure>
    </sect2>

    <sect2 id="matedialog-warning-dialog">
      <title>Диалоговое окно предупреждения</title>

      <para>Используйте параметр <option>--warning</option>, чтобы создать диалоговое окно предупреждения.</para>

      <para lang="en">
        The following example script shows how to create a warning dialog:

        <programlisting lang="en">
          #!/bin/bash
        
          matedialog --warning \
          --text="Disconnect the power cable to avoid electrical shock."
        </programlisting>

      </para>

      <figure id="matedialog-warning-screenshot">
        <title>Пример диалогового окна предупреждения</title>
        <screenshot>
          <mediaobject lang="en">
            <imageobject>
              <imagedata fileref="figures/matedialog-warning-screenshot.png" format="PNG"/>
	    </imageobject>
	    <textobject>
	      <phrase><application>MateDialog</application> warning dialog example</phrase>
	    </textobject>
          </mediaobject>
        </screenshot>
      </figure>
    </sect2>

  </sect1>

<!-- ==== Progress Options ====== -->

  <sect1 id="matedialog-progress-options">
    <title>Диалоговое окно индикатора прогресса</title>

    <para>Используйте параметр <option>--progress</option>, чтобы создать диалоговое окно индикатора прогресса.</para>

    <para><application>MateDialog</application> считывает данные из стандартного ввода строка за строкой. Если строка начинается с #, то текст, следующий за этим префиксом размещается в диалоговом окне. Если строка содержит только число, то индикатор прогресса устанавливается на этот процент выполнения.</para>
	
    <para>Диалоговое окно индикатора прогресса поддерживает следующие параметры:</para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>текст</replaceable></term>
	<listitem>
	  <para>Указывает текст, который будет изображён в диалоговом окне.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--percentage</option>=<replaceable>процент</replaceable></term>
	<listitem>
	  <para>Указывает начальное состояние индикатора прогресса.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term lang="en"><option>--auto-close</option></term>
	<listitem>
	  <para>Диалоговое окно закрывается, когда процент выполнения достиг 100% .</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--pulsate</option></term>
	<listitem>
	  <para>Указывает, что индикатор прогресса пульсирует до тех пор, пока из стандартного ввода не будет прочитан символ конца файла EOF.</para>
	</listitem>
      </varlistentry>

    </variablelist>

    <para lang="en">
      The following example script shows how to create a progress dialog:
      <programlisting lang="en">
        #!/bin/sh
        (
        echo "10" ; sleep 1
        echo "# Updating mail logs" ; sleep 1
        echo "20" ; sleep 1
        echo "# Resetting cron jobs" ; sleep 1
        echo "50" ; sleep 1
        echo "This line will just be ignored" ; sleep 1
        echo "75" ; sleep 1
        echo "# Rebooting system" ; sleep 1
        echo "100" ; sleep 1
        ) |
        matedialog --progress \
          --title="Update System Logs" \
          --text="Scanning mail logs..." \
          --percentage=0

        if [ "$?" = -1 ] ; then
                matedialog --error \
                  --text="Update canceled."
        fi

      </programlisting>

    </para>

    <figure id="matedialog-progress-screenshot">
      <title>Пример диалогового окна индикатора прогресса\</title>
      <screenshot>
        <mediaobject lang="en">
          <imageobject>
            <imagedata fileref="figures/matedialog-progress-screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase><application>MateDialog</application> progress dialog example</phrase>
	  </textobject>
        </mediaobject>
      </screenshot>
    </figure>

  </sect1>

<!-- ==== Text Entry Options ====== -->

  <sect1 id="matedialog-text-entry-options">
    <title>Диалоговое окно ввода текста</title>

    <para lang="en">
        Use the <option>--entry</option> option to create a text entry dialog. <application>MateDialog</application> returns the contents of the text entry to standard output. 
    </para>	
    <para>Диалоговое окно ввода текста поддерживает следующие параметры:</para>

    <variablelist>

      <varlistentry>
        <term><option>--text</option>=<replaceable>текст</replaceable></term>
	<listitem>
	  <para>Указывает текст, который будет изображён в диалоговом окне (но не в поле ввода).</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--entry-text</option>=<replaceable>текст</replaceable></term>
	<listitem>
	  <para>Указывает текст, который будет изображён в поле ввода диалогового окна.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--hide-text</option></term>
	<listitem>
	  <para>Скрывает текст в поле ввода диалогового окна.</para>
	</listitem>
      </varlistentry>

    </variablelist>

    <para lang="en">
      The following example script shows how to create a text entry dialog:

      <programlisting lang="en">
        #!/bin/sh

        if matedialog --entry \
        --title="Add an Entry" \
        --text="Enter your _password:" \
        --entry-text "password" \
        --hide-text
          then echo $?
          else echo "No password entered"
        fi
      </programlisting>

    </para>

    <figure id="matedialog-entry-screenshot">
      <title>Пример диалогового окна ввода текста</title>
      <screenshot>
        <mediaobject lang="en">
          <imageobject>
            <imagedata fileref="figures/matedialog-entry-screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase><application>MateDialog</application> text entry dialog example</phrase>
	  </textobject>
        </mediaobject>
      </screenshot>
    </figure>
  </sect1>

<!-- ==== Text Information Options ====== -->

  <sect1 id="matedialog-text-options">
    <title>Диалоговое окно текстовой информации</title>

    <para>Используйте параметр <option>--text-info</option>, чтобы создать диалоговое окно текстовой информации.</para>
	
    <para>Диалоговое окно текстовой информации поддерживает следующие параметры:</para>

    <variablelist>

      <varlistentry>
        <term><option>--filename</option>=<replaceable>имя_файла</replaceable></term>
	<listitem>
	  <para>Указывает имя файла, который будет загружен в окно текстовой информации.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
        <term lang="en"><option>--editable</option></term>
        <listitem>
          <para lang="en">Allows the displayed text to be edited. The edited text is returned to standard output when the dialog is closed.</para>
        </listitem>
      </varlistentry>

    </variablelist>

    <para lang="en">
      The following example script shows how to create a text information dialog:
      <programlisting lang="en">
        #!/bin/sh

        FILE=`matedialog --file-selection \
          --title="Select a File"`

        case $? in
                 0)
                        matedialog --text-info \
                          --title=$FILE \
                          --filename=$FILE \
                          --editable 2&gt;/tmp/tmp.txt;;
                 1)
                        echo "No file selected.";;
                -1)
                        echo "No file selected.";;
        esac
      </programlisting>

    </para>

    <figure id="matedialog-text-screenshot">
      <title>Пример диалогового окна текстовой информации</title>
      <screenshot>
        <mediaobject lang="en">
          <imageobject>
            <imagedata fileref="figures/matedialog-text-screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase><application>MateDialog</application> text information dialog example</phrase>
	  </textobject>
        </mediaobject>
      </screenshot>
    </figure>

  </sect1>

</article>
