zenity/help/sr/zenity.xml

470 lines
30 KiB
XML
Raw Normal View History

<?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>--text-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>