zenity/help/sr/zenity.xml

<?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 legal SYSTEM "legal.xml">
<!ENTITY version "1.0">
<!ENTITY app "<application>Zenity</application>">
]>
<!-- ================ Document Header ================= -->
<article id="index" lang="sr">

  <articleinfo>
    <title>Упутство за Зенит</title>
    <copyright>
	    <year>2003</year>
	    <holder>(Sun)це Microsystems</holder>
    </copyright><copyright><year>2004</year><holder>Данило Шеган (српски превод)</holder></copyright>

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

    <publisher>
	    <publishername>Подухват документовања Гнома</publishername>
    </publisher>

    <releaseinfo>Издање 1.0 упутства за Зенит</releaseinfo>

    <legalnotice id="feedback">
	    <title>Подаци за примедбе</title>
	    <para>Да пријавите грешку или нешто предложите у вези овог програма или упутства, погледајте <ulink type="help" url="ghelp:gnome-feedback"> страну за примедбе о Гному </ulink></para>
    </legalnotice>

    <authorgroup>
	    <author>
		    <firstname>Глин</firstname>
		    <surname>Фостер</surname>
		    <affiliation>
			    <orgname>Подухват документовања Гнома</orgname>
		    </affiliation>
            </author>
	    <editor>
	            <firstname>Николас</firstname>
		    <surname>Кјуран</surname>
		    <affiliation>
		            <orgname>Подухват документовања Гнома</orgname>
		    </affiliation>
	    </editor>
    </authorgroup>

    <revhistory>
	    <revision>
		    <revnumber>1.0</revnumber>
		    <date>18-01-2003</date>
		    <revdescription>
			    <para role="author">Глин Фостер</para>
			    <para role="publisher">Подухват документовања Гнома</para>
		    </revdescription>
            </revision>
    </revhistory>
  </articleinfo>
  
<!-- ================ Document Body ================= -->

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

  <sect1 id="zenity-introduction">
    <title>Увод</title>

    <para><application>Зенит</application> приказује једноставне прозорчиће у Гному.</para>

    <para><application>Зенит</application> може да прикаже наредне прозорчиће:</para>

    <itemizedlist><listitem><para><link linkend="zenity-calendar-options">Прозорче са календаром.</link></para></listitem><listitem><para><link linkend="zenity-text-entry-options">Прозорче за унос текста.</link></para></listitem><listitem><para>Разне прозорчиће са порукама укључујући:</para><itemizedlist><listitem><para><link linkend="zenity-error-dialog">Прозорче за грешке.</link></para></listitem><listitem><para><link linkend="zenity-info-dialog">Прозоче са обавештењима.</link></para></listitem><listitem><para><link linkend="zenity-question-dialog">Прозорче са питањем.</link></para></listitem><listitem><para><link linkend="zenity-warning-dialog">Прозорче са упозорењем.</link></para></listitem></itemizedlist></listitem><listitem><para><link linkend="zenity-file-selection-options">Прозорче за избор датотеке.</link></para></listitem><listitem><para><link linkend="zenity-list-options">Прозорче за списак могућности.</link></para></listitem><listitem><para><link linkend="zenity-progress-options">Прозорче напретка.</link></para></listitem><listitem><para><link linkend="zenity-text-options">Прозорче са текстом.</link></para></listitem></itemizedlist>

  </sect1>

<!-- ==== General Options ====== -->
  <sect1 id="zenity-basic-use">
    <title>Основна употреба</title>

    <para><application>Зенит</application> прави једноставне прозорчиће. Можете користити <application>Зенит</application> да напишете скрипту која се графички споразумева са корисником.</para>
    
    <para>Када корисник затвори прозорче, <application>Зенит</application> исписује текст који сачини прозорче на стандардни излаз за грешке.</para>

    <para>Проверите да ли су сви аргументи <application>Зениту</application> окружени наводницима. На пример, користите <command>zenity --calender --title="Планирање одмора"</command> уместо of <command>zenity --calender --title=Планирање одмора</command>. Уколико не користите наводнике, можете добити непредвиђене резултате.</para>

    <note>
        <title>ПАЖЊА</title>
	<para>Неки прозорчићи подржавају употребу пречица са тастатуре. Да наведеде који се знак користи као пречица, поставите подвлаку испред знака у тексту прозорчета. На пример, да поставите „И“ као пречицу са тастатуре у наредној реченици, користите „_Изаберите име“.</para>
    </note>

    <para><application>Зенит</application> враћа наредне завршне кодове:</para>

    <variablelist><varlistentry><term><varname>0</varname></term><listitem><para>Корисник је притиснуо или „У реду“ или „Затвори“.</para></listitem></varlistentry><varlistentry><term><varname>1</varname></term><listitem><para>Корисник је пристао или „Одустани“ или је затворио прозорче помоћу функција прозора.</para></listitem></varlistentry><varlistentry><term><varname>-1</varname></term><listitem><para>Дошло је до непредвиђене грешке.</para></listitem></varlistentry></variablelist>

  </sect1>

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

  <sect1 id="zenity-general-options">
    <title>Опште опције</title>

    <para>Сви прозорчићи имају следеће опште опције:</para>

    <variablelist><varlistentry><term><varname>--title</varname>=НАСЛОВ</term><listitem><para>Наводи наслов прозорчета.</para></listitem></varlistentry><varlistentry><term><varname>--window-icon</varname>=ПУТАЊА_ИКОНЕ</term><listitem><para>Наводи икону која ће се појавити у оквиру прозорчета.</para></listitem></varlistentry><varlistentry><term><varname>--width</varname>=ШИРИНА</term><listitem><para>Наводи ширину прозорчета.</para></listitem></varlistentry><varlistentry><term><varname>--height</varname>=ВИСИНА</term><listitem><para>Наводи висину прозорчета.</para></listitem></varlistentry></variablelist>

  </sect1>

<!-- ==== Calendar Options ====== -->

  <sect1 id="zenity-calendar-options">
    <title>Прозорче са календаром</title>

    <para>Користите <command>--calender</command> да направите прозорче са календаром. <application>Зенит</application> враћа изабрани датум преко стандардног излаза за грешке. Прозорче користи текући датум ако се не зада датум путем наредбе.</para>
    <para>Прозорче са календаром подржава наредне опције:</para>

    <variablelist><varlistentry><term><varname>--text</varname>=ТЕКСТ</term><listitem><para>Наводи текст који се приказује у прозорчету са календаром.</para></listitem></varlistentry><varlistentry><term><varname>--day</varname>=ДАН</term><listitem><para>Наводи дан који се бира у прозорчету са календаром. Дан мора бити број између 1 и 31.</para></listitem></varlistentry><varlistentry><term><varname>--month</varname>=МЕСЕЦ</term><listitem><para>Наводи месец који се бира у прозорчету са календаром. Месец мора бити број између 1 и 12.</para></listitem></varlistentry><varlistentry><term><varname>--year</varname>=ГОДИНА</term><listitem><para>Наводи годину која се бира у прозорчету са календаром.</para></listitem></varlistentry><varlistentry><term><varname>--date-format</varname>=ОБЛИК</term><listitem><para>Наводи облик датума који враћа прозорче са календаром након што се изабере датум. Подразумевани облик зависи од вашег локалитета. Облик мора бити у стилу <command>strftime</command>, на пример „%A, %d. %m. %y.“.</para></listitem></varlistentry></variablelist>

    <para>Следећа скрипта је пример употребе прозорчета са календаром: <programlisting>
		#!/bin/sh

		if zenity --calendar --title="Избор у календару" --text="Изаберите датум испод" --day=18 --month=4 --year=2003
		  then echo $?
		  else echo "Датум није изабран"
		fi
		</programlisting></para>

    <figure id="zenity-calendar-screenshot">
      <title>Пример прозорчета са календаром</title>
      <screenshot>
        <mediaobject>
          <imageobject>
              <imagedata fileref="figures/zenity-calendar-screenshot.png" format="PNG"/>
          </imageobject>
          <textobject>
              <phrase>Пример <application>Зенитовог</application> прозорчета са календаром</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
   </figure>
													  
  </sect1>

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

  <sect1 id="zenity-text-entry-options">
    <title>Прозорче за унос текста</title>

    <para>Користите <command>--entry</command> да направите прозорче за унос текста. <application>Зенит</application> враћа садржај уноса текста путем стандардног излаза за грешке.</para>	
    <para>Прозорче за унос текста подржава наредне опције:</para>

    <variablelist><varlistentry><term><varname>--text</varname>=ТЕКСТ</term><listitem><para>Наводи текст који се појављује у прозорчету за унос текста.</para></listitem></varlistentry><varlistentry><term><varname>--entry-text</varname>=ТЕКСТ</term><listitem><para>Наводи текст који се појављује у пољу за унос прозорчета за унос текста.</para></listitem></varlistentry><varlistentry><term><varname>--hide-text</varname></term><listitem><para>Наводи да текст у пољу за унос треба да буде сакривен у прозорчету за унос текста.</para></listitem></varlistentry></variablelist>

    <para>Следећа скрипта је пример употребе прозорчета за унос текста: <programlisting>
		#!/bin/sh

		if zenity --entry --title="Додај нови унос" --text="Унесите вашу _лозинку" --hide-text
		  then echo $?
		  else echo "Лозинка није унета"
		fi
		</programlisting></para>

    <figure id="zenity-entry-screenshot">
      <title>Пример прозорчета за унос текста</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/zenity-entry-screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Пример <application>Зенитовог</application> прозорчета за унос текста</phrase>
	  </textobject>
        </mediaobject>
      </screenshot>
    </figure>
  </sect1>

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

  <sect1 id="zenity-message-options">
    <title>Прозорче са поруком</title>

    <para><application>Зенит</application> може да образује четири врсте прозорчића са порукама. Користите опцију <command>--text</command> да поставите текст приказан у прозорчету.</para>
    <sect2 id="zenity-warning-dialog">
      <title>Прозорче са упозорењем</title>

      <para>Користите <command>--warning</command> да образујете прозорче са упозорењем.</para>

      <para>Наредна скрипта је пример употребе прозорчета са упозорењем: <programlisting>
		#!/bin/bash

		FILE_TYPE=$(file -b $NAUTILUS_SCRIPT_SELECTED_FILE_PATHS|awk '{ print $1}')

		if [ "$FILE_TYPE" != "PNG" ]; then
		  zenity --warning --text="Не могу да ротирам слику"
		fi
		</programlisting></para>

      <figure id="zenity-warning-screenshot">
        <title>Пример прозорчета са упозорењем</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/zenity-warning-screenshot.png" format="PNG"/>
	    </imageobject>
	    <textobject>
	      <phrase>Пример <application>Зенитовог</application> прозорчета са упозорењем</phrase>
	    </textobject>
          </mediaobject>
        </screenshot>
      </figure>
    </sect2>

    <sect2 id="zenity-error-dialog">
      <title>Прозорче за грешку</title>

      <para>Користите <command>--error</command> да образујете прозорче за грешку.</para>

      <figure id="zenity-error-screenshot">
        <title>Пример прозорчета за грешку</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/zenity-error-screenshot.png" format="PNG"/>
	    </imageobject>
	    <textobject>
	      <phrase>Пример <application>Зенитовог</application> прозорчета за грешку</phrase>
	    </textobject>
          </mediaobject>
        </screenshot>
      </figure>
    </sect2>

    <sect2 id="zenity-info-dialog">
      <title>Обавештајно прозорче</title>

      <para>Користите <command>--info</command> да образујете обавештајно прозорче.</para>

      <figure id="zenity-information-screenshot">
        <title>Пример обавештајног прозорчета</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/zenity-information-screenshot.png" format="PNG"/>
	    </imageobject>
	    <textobject>
	      <phrase>Пример <application>Зенитовог</application> обавештајног прозорчета</phrase>
	    </textobject>
          </mediaobject>
        </screenshot>
      </figure>
    </sect2>

    <sect2 id="zenity-question-dialog">
      <title>Прозорче са питањем</title>

      <para>Користите <command>--question</command> да образујете прозорче са питањем.</para>

      <figure id="zenity-question-screenshot">
        <title>Пример прозорчета са питањем</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/zenity-question-screenshot.png" format="PNG"/>
	    </imageobject>
	    <textobject>
	      <phrase>Пример <application>Зенитовог</application> прозорчета са питањем</phrase>
	    </textobject>
          </mediaobject>
        </screenshot>
      </figure>
    </sect2>

  </sect1>

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

  <sect1 id="zenity-file-selection-options">
    <title>Прозорче за избор датотеке</title>

    <para>Користите <command>--file-selection</command> да образујете прозорче за избор датотеке. <application>Зенит</application> враћа изабране датотеке или директоријуме путем стандардног излаза за грешке.</para>
    <para>Прозорче за избор датотека подржава наредне опције:</para>

    <variablelist><varlistentry><term><varname>--filename</varname>=ДАТОТЕКА</term><listitem><para>Наводи датотеку или директоријум који се означавају када се прозорче за избор датотека први пут прикаже.</para></listitem></varlistentry><varlistentry><term><varname>--multiple</varname></term><listitem><para>Дозвољава избор више датотека у прозорчету за избор датотека.</para></listitem></varlistentry><varlistentry><term><varname>--separator</varname>=РАЗДВАЈАЧ</term><listitem><para>Одређује ниску којом се раздваја враћени списак имена датотека.</para></listitem></varlistentry></variablelist>

    <para>Следећа скрипта је пример употребе прозорчета за избор датотека: <programlisting>
		#!/bin/sh

		FILE=`zenity --file-selection --title="Изаберите датотеку"'

		case $? in
		         0)
			  	echo "Изабрана је „$FILE“.";;
		         1)
			        echo "Датотека није изабрана.";;
			-1)
			        echo "Датотека није изабрана.";;
		esac
		</programlisting></para>

    <figure id="zenity-fileselection-screenshot">
      <title>Пример прозорчета за избор датотека</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/zenity-fileselection-screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Пример <application>Зенитовог</application> прозорчета за избор датотека</phrase>
	  </textobject>
        </mediaobject>
      </screenshot>
    </figure>

  </sect1>

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

  <sect1 id="zenity-list-options">
    <title>Прозорче за списак</title>

    <para>Користите <command>--list</command> за образовање прозорчета за списак. <application>Зенит</application> враћа уносе из прве колоне текста изабраних редова путем стандардног излаза за грешке.</para>

    <para>Свака колона се мора навести помоћу опције <command>--column</command>. Подаци за прозорче се морају навести једна-по-једна колона, и један-по-један ред. Подаци се могу проследити прозорчету путем стандардног улаза. Сваки унос мора бити раздвојен новим редом.</para>

    <para>Уколико користите опцију <command>--checklist</command> или <command>--radiolist</command>, сваки ред мора почети са или „TRUE“ или „FALSE“.</para>

    <para>Прозорче за списак подржава наредне опције:</para>

    <variablelist><varlistentry><term><varname>--column</varname>=КОЛОНА</term><listitem><para>Наводи заглавља колона која се појављују у прозорчету за списак. Морате проследити опцију <command>--column</command> за сваку колону коју желите да видите у прозорчету.</para></listitem></varlistentry><varlistentry><term><varname>--checklist</varname></term><listitem><para>Наводи да прва колона треба да садржи кућице за означавање у прозорчету за списак.</para></listitem></varlistentry><varlistentry><term><varname>--radiolist</varname></term><listitem><para>Наводи да прва колона треба да садржи радио кућице у прозорчету за списак.</para></listitem></varlistentry><varlistentry><term><varname>--editable</varname></term><listitem><para>Дозволи уређивање приказаних ставки.</para></listitem></varlistentry><varlistentry><term><varname>--seperator</varname>=РАЗДВАЈАЧ</term><listitem><para>Наводи ниску која се користи када прозорче за списак врати изабране вредности.</para></listitem></varlistentry></variablelist>

    <para>Наредна наредба је пример употребе прозорчета за списак: <programlisting>
		zenity --list --title="Изаберите грешке које желите да осмотрите" \
		       --column="Број грешке" --column="Тежина" --column="Опис" \
		       992383 Обична "GtkTreeView пуца на више избора" \
		       293823 Велика "Речник Гнома не подржава посредника" \
		       393823 Критична "Уређивање менија не ради у Гному 2.0"
		</programlisting></para>

    <figure id="zenity-list-screenshot">
      <title>Пример избора у прозорчету за списак</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/zenity-list-screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Пример <application>Зенитовог</application> прозорчета за списак</phrase>
	  </textobject>
        </mediaobject>
      </screenshot>
    </figure>

  </sect1>

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

  <sect1 id="zenity-progress-options">
    <title>Прозорче са напретком</title>

    <para>Користите <command>--progress</command> да образујете прозорче са напретком.</para>

    <para><application>Зенит</application> чита податке са стандардног улаза ред по ред. Ако ред почиње тарабом (#), текст се допуњава текстом из тог реда. Уколико ред садржи само број, постотак се допуњава за тај број.</para>
	
    <para>Прозорче са напретком подржава следеће опције:</para>

    <variablelist><varlistentry><term><varname>--text</varname>=ТЕКСТ</term><listitem><para>Наводи текст који се појављује у прозорчету са напретком.</para></listitem></varlistentry><varlistentry><term><varname>--percentage</varname>=ПОСТОТАК</term><listitem><para>Наводи почетни постотак који се поставља у прозорчету са напретком.</para></listitem></varlistentry><varlistentry><term><varname>--auto-close</varname></term><listitem><para>Затвара прозорче са напретком када се достигне 100%.</para></listitem></varlistentry><varlistentry><term><varname>--pulsate</varname></term><listitem><para>Наводи да прозорче са напретком треба да трепери док се не ишчита знак за крај датотеке са стандардног улаза.</para></listitem></varlistentry></variablelist>

    <para>Следећа скрипта представља пример употребе прозорчета са напретком: <programlisting>
		#!/bin/sh
		(
		echo "10" ; sleep 1
		echo "# Освежавам дневнике поште" ; sleep 1
		echo "20" ; sleep 1
		echo "# Препостављам заказане послове" ; sleep 1
		echo "50" ; sleep 1
		echo "Овај ред ће бити занемарен" ; sleep 1
		echo "75" ; sleep 1
		echo "# Ресетујем систем" ; sleep 1
		echo "100" ; sleep 1
		) |
		zenity --progress --title="Освежи системске дневнике" --text="Претражујем дневнике поште..." --percentage=0

		if [ "$?" = -1 ] ; then
			zenity --error --text="Освежавање обустављено."
		fi
		</programlisting></para>

    <figure id="zenity-progress-screenshot">
      <title>Пример прозорчета са напретком</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/zenity-progress-screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Пример <application>Зенитовог</application> прозорчета са напретком</phrase>
	  </textobject>
        </mediaobject>
      </screenshot>
    </figure>

  </sect1>

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

  <sect1 id="zenity-text-options">
    <title>Прозорче са текстуалним обавештењем</title>

    <para>Користите <command>--text-info</command> да направите прозорче са текстуалним обавештењем.</para>
	
    <para>Прозорче са текстуалним обавештењем подржава следеће опције:</para>

    <variablelist><varlistentry><term><varname>--filename</varname>=ДАТОТЕКА</term><listitem><para>Наводи датотеку која се учитава у прозорче са текстуалним обавештењем.</para></listitem></varlistentry><varlistentry><term><varname>--editable</varname></term><listitem><para>Дозвољава да се приказани текст уреди. Уређени текст се враћа путем стандардног излаза за грешке када се затвори прозорче.</para></listitem></varlistentry></variablelist>

    <para>Следећа скрипта је пример употребе прозорчета са текстуалним обавештењем: <programlisting>
		#!/bin/sh

		FILE=`zenity --file-selection --title="Изаберите датотеку"'

		case $? in
		         0)
			  	zenity --text-info --filename=$FILE --editable 2&gt;/tmp/tmp.txt
							
		         1)
			        echo "Датотека није изабрана.";;
			-1)
				echo "Датотека није изабрана.";;
		esac
		</programlisting></para>

    <figure id="zenity-text-screenshot">
      <title>Пример прозорчета са текстуалним обавештењем</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/zenity-text-screenshot.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase>Пример <application>Зенитовог</application> прозорчета са текстуалним обавештењем</phrase>
	  </textobject>
        </mediaobject>
      </screenshot>
    </figure>

  </sect1>

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

  <sect1 id="zenity-miscellaneous-options">
    <title>Разне опције</title>

    <para><application>Зенит</application> подржава следеће разне опције:</para>

    <variablelist><varlistentry><term><varname>--about</varname></term><listitem><para>Приказује нешто података о <application>Зениту</application>.</para></listitem></varlistentry><varlistentry><term><varname>--version</varname></term><listitem><para>Исписује издање <application>Зенита</application>.</para></listitem></varlistentry></variablelist>

  </sect1>

<!-- ================ Application License ================= -->
  <sect1 id="license">
	  <title>Лиценца</title>
	  <para>Овај програм је слободан софтвер; можете га расподељивати и/или мењати под условима <ulink type="help" url="gnome-help:gpl"><citetitle>Гнуове Опште јавне лиценце</citetitle></ulink> коју је објавила Задужбина за слободни софтвер; или 2. издања те Лиценце, или (према вашем избору) било којег новијег издања.</para>
	  <para>Овај програм се раздељује у нади да ће бити користан, али БЕЗ ИКАКВИХ ГАРАНЦИЈА; чак и без подразумеваних гаранција о СВРСИСХОДНОСТИ или ПОГОДНОСТИ ЗА ОДРЕЂЕНУ НАМЕНУ. Погледајте  <citetitle>Гнуову Општу јавну лиценцу</citetitle> за више детаља.</para>
	  <para>Примерак <citetitle>Гнуове Опште јавне лиценце</citetitle> је укључен као додатак <citetitle>Гномовом водичу за кориснике</citetitle>. Примерак <citetitle>Гнуове Опште јавне лиценце</citetitle> можете такође набавити од Задужбине за слободни софтвер посетом <ulink type="http" url="http://www.fsf.org"> њиховој веб страници </ulink> или писањем на <address>Free Software Foundation, Inc. <street>59 Temple Place</street> — Suite 330 <city>Boston</city>, <state>MA</state><postcode>02111-1307</postcode><country>USA</country></address></para>
  </sect1>

</article>