<!-- The introduction chapter contains a brief introduction for the
application that explains what it does and where to report
problems. Basically a long version of the abstract. Don't include a
revision history. (see installation appendix comment) -->
<para
>&kgeography; — программа KDE для изучения географии. Она позволяет изучать карту мира или административно-территориальное деление некоторых стран (административные единицы, их столицы, флаги, если имеются). </para>
<para
>Карты, доступные в текущей версии: Австрия, Азия, Африка, Бразилия, Германия, Европа, Испания, Италия, Италия с провинциями, Канада, Китай, Норвегия, Польша, Северная и Центральная Америки, США, Франция, Южная Америка и карта мира. </para>
</chapter>
<chapter id="quick-start">
<title
>Начало работы</title>
<para
>При первом запуске &kgeography; вас спросят с какой карты вы хотите начать. <screenshot>
>После того, как вы закончите со всеми вопросами, будут выведены результаты, в которых будут сообщено о правильных и неправильных ответах. <screenshot>
>Столицы: угадайте столицу страны или региона. Даётся четыре варианта ответа и вы должны выбрать правильный. Как и в предыдущем случае, в конце будут сообщены результаты </para>
<para
>Флаг страны: вам показывается флаг, а вы должны найти на карте соответствующую ему страну или регион. <screenshot>
> вы можете найти программу, созданную Янном Верлеем (Yann Verley), которая помогла ему при созданием карты Франции. Чтобы понять, как его использовать, просто запустите программу и прочтите справку. Программа создаёт файл <literal role="extension"
>.kgm</literal
> из обычного текстового файла и записывает файл с цветами, ассоциированными для каждой из областей на карте.</para>
</sect1>
<sect1 id="description-file">
<title
>Файл с описанием</title>
<para
>Файл с описанием является обязательным, он имеет расширение <literal role="extension"
>.kgm</literal
>. Файл должен начинаться с тега <sgmltag class="starttag"
>map</sgmltag
> и заканчиваться на <sgmltag class="endtag"
>map</sgmltag
>. </para>
<para
>Между этими тегами должны быть указаны: <itemizedlist>
<listitem>
<para
>В тегах <sgmltag class="starttag"
>mapFile</sgmltag
> и <sgmltag class="endtag"
>mapFile</sgmltag
> — имя файла (без пути к нему), содержащему изображение карты, например, <quote
>europe.png</quote
>.</para>
</listitem>
<listitem>
<para
>В тегах <sgmltag class="starttag"
>name</sgmltag
> и <sgmltag class="endtag"
>name</sgmltag
> — название карты, например, <quote
>Европа</quote
>.</para>
</listitem>
<listitem>
<para
>Несколько тегов <sgmltag class="starttag"
>division</sgmltag
> и <sgmltag class="endtag"
>division</sgmltag
> с информацией обо всех странах или регионах на карте.</para>
</listitem>
</itemizedlist>
</para>
<para
>Для каждой страны или региона должны быть указаны следующие теги: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>name</sgmltag
> и <sgmltag class="endtag"
>name</sgmltag
> — название страны или региона, например, <quote
>Албания</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>capital</sgmltag
> и <sgmltag class="endtag"
>capital</sgmltag
> — столица, например, <quote
>Тирана</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>ignore</sgmltag
> и <sgmltag class="endtag"
>ignore</sgmltag
>: значения могут быть <userinput
>yes</userinput
>, <userinput
>allowClickMode</userinput
> и <userinput
>no</userinput
>Если тег имеет значение <userinput
>yes</userinput
>, то такая область будет проигнорирована при запросе областей на карте. Так, будто данной области не существует в режиме тестирования &kgeography;. Если значение <userinput
>allowClickMode</userinput
>, то &kgeography; будет запрашивать область в режиме <guibutton
>Найти на карте...</guibutton
>, но не в других режимах тестирования. Значение <userinput
>no</userinput
> означает, что область будет представлена во всех режимах (просмотр и тестирование). Тег является необязательным. Когда тега <sgmltag class="starttag"
>ignore</sgmltag
> нет, подразумевается, что его значение установлено в <userinput
>no</userinput
>. Пример: <quote
>Алжир</quote
> имеет тег, установленный в <userinput
>yes</userinput
> для карты <quote
>Европа</quote
>, что означает, что <quote
>Алжир</quote
> не будет частью любого теста с картой <quote
>Европа</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>flag</sgmltag
> и <sgmltag class="endtag"
>flag</sgmltag
> — имя файла (без указания пути) с флагом страны или региона, например, <quote
>albania.png</quote
>. Этот тег не нужен для областей, у которых тег <sgmltag class="starttag"
>ignore</sgmltag
> установлен в <userinput
>yes</userinput
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>color</sgmltag
> и <sgmltag class="endtag"
>color</sgmltag
> — цвет, которым будет закрашена страна или регион на карте.</para>
</listitem>
</itemizedlist>
</para>
<para
>Цвет задаётся с помощью трёх тегов: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>red</sgmltag
> и <sgmltag class="endtag"
>red</sgmltag
> — красный компонент цвета. Допустимы значения между 0 и 255.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>green</sgmltag
> и <sgmltag class="endtag"
>green</sgmltag
> — зелёный компонент цвета. Допустимы значения между 0 и 255.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>blue</sgmltag
> и <sgmltag class="endtag"
>blue</sgmltag
> — синий компонент цвета. Допустимы значения между 0 и 255.</para>
</listitem>
</itemizedlist>
</para>
<tip>
<para
>Часто бывает удобно создать две или три ложных страны или региона, таких как <quote
>Вода</quote
>, <quote
>Граница</quote
> и <quote
>Побережье</quote
> и указать для них тег<sgmltag class="starttag"
>ignore</sgmltag
> со значением <userinput
>yes</userinput
>. </para>
</tip>
<important>
<para
>Все названия (столицы, страны и регионы) должны быть на английском.</para>
</important>
</sect1>
<sect1 id="map-file">
<title
>Файл карты</title>
<para
>Файл карты довольно прост, но трудоёмок в изготовлении. Он должен быть в формате <acronym
>PNG</acronym
>. Несколько карт для преобразования можно найти на сайте <ulink url="https://www.cia.gov/library/publications/the-world-factbook/docs/refmaps.html"
>Cia Reference Maps</ulink
>. Если ни одна из карт не подойдёт, вы можете загрузить <ulink url="https://www.cia.gov/library/publications/the-world-factbook/reference_maps/pdf/political_world.pdf"
>мировую политическую карту</ulink
> и дальше работать со снимком. Каждая область на карте должна иметь один и только один цвет. Для достижения этого вы можете использовать программы обработки изображений, такие как <application
>Gimp</application
> и <application
>Kolourpaint</application
>. </para>
</sect1>
<sect1 id="flags">
<title
>Флаги</title>
<para
>Если вы использовали тег <sgmltag class="starttag"
>flag</sgmltag
>, то должны указать файл с флагом в формате <acronym
>PNG</acronym
> (лучше использовать размер 300x200 пикселов) и файл <acronym
>SVG</acronym
> для него. Получить флаги в формате <acronym
>SVG</acronym
> почти для всех стран и некоторых административных единиц можно <ulink url="http://www.sodipodi.com/index.php3?section=clipart/flags"
>в коллекции флагов Sodipodi</ulink
>. </para>
</sect1>
<sect1 id="how-to-test">
<title
>Как проверять карты</title>
<para
>Перед отсылкой карты Альберту на <email
>tsdgeos@terra.es</email
>, вы должны проверить её на отсутствие ошибок. Для этого сделайте следующее: <itemizedlist
> <listitem
> <para
>Поместите описание карты и файлы изображений с картой в <filename class="directory"
>Возможно ли создавать физические карты? Да! <screenshot>
<screeninfo
>Пример создания физической карты</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="river.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Пример создания физической карты</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
<para
>Разумеется, концепция стран/регионов может быть расширена на реки и горы. При создании карты имейте в виду, что в большинстве случаев река или гора будет меньше, чем область для нажатия, которую вы сможете задать. В данном примере река будет иметь такую область и цвет <20,76,34> для подсказки с идентификатором. </para>
</sect1>
</chapter>
<chapter id="commands">
<title
>Справочник команд</title>
<!-- (OPTIONAL, BUT RECOMMENDED) This chapter should list all of the
application windows and their menubar and toolbar commands for easy reference.
Also include any keys that have a special function but have no equivalent in the
menus or toolbars. This may not be necessary for small apps or apps with no tool