Beautify docbook files

1 files changed, 36 insertions, 201 deletions

diff --git a/tde-i18n-ru/docs/tdeedu/kturtle/getting-started.docbook b/tde-i18n-ru/docs/tdeedu/kturtle/getting-started.docbook
index d603707e93f..566bd97b89c 100644
--- a/tde-i18n-ru/docs/tdeedu/kturtle/getting-started.docbook
+++ b/tde-i18n-ru/docs/tdeedu/kturtle/getting-started.docbook
@@ -1,129 +1,49 @@
 <!--Dear translator: please NEVER translate the id or anything inside the tags as they are needed in english by the application
      Thanks a lot in advance.-->
 <chapter id="getting-started">
-<title
->Начало работы</title>
-<para
->Когда вы запустите &kturtle;, вы увидите нечто подобное: <screenshot
-> <screeninfo
->Главное окно &kturtle;</screeninfo
-> <mediaobject
-> <imageobject
-> <imagedata fileref="mainwindow.png" format="PNG"/> </imageobject
-> <textobject
-> <phrase
->&kturtle;</phrase
-> </textobject
-> </mediaobject
-> </screenshot
->В данном руководстве мы будем использовать команды на русском языке. Вы можете поменять язык команд &logo; в разделе <guilabel
->Язык</guilabel
-> диалога  <menuchoice
-><guimenu
->Настройки</guimenu
-><guimenuitem
->Настроить &kturtle;...</guimenuitem
-></menuchoice
->. Только выбранный язык может применяться для ввода команд.</para>
+<title>Начало работы</title>
+<para>Когда вы запустите &kturtle;, вы увидите нечто подобное: <screenshot> <screeninfo>Главное окно &kturtle;</screeninfo> <mediaobject> <imageobject> <imagedata fileref="mainwindow.png" format="PNG"/> </imageobject> <textobject> <phrase>&kturtle;</phrase> </textobject> </mediaobject> </screenshot>В данном руководстве мы будем использовать команды на русском языке. Вы можете поменять язык команд &logo; в разделе <guilabel>Язык</guilabel> диалога  <menuchoice><guimenu>Настройки</guimenu><guimenuitem>Настроить &kturtle;...</guimenuitem></menuchoice>. Только выбранный язык может применяться для ввода команд.</para>
 
 <sect1 id="first-steps">
-<title
->Первые шаги в &logo;: встречаем Черепашку!</title>
-<para
->Вы, наверное, уже заметили Черепашку в центре холста, осталось только научиться, как управлять ею, используя команды в редакторе кода.</para>
+<title>Первые шаги в &logo;: встречаем Черепашку!</title>
+<para>Вы, наверное, уже заметили Черепашку в центре холста, осталось только научиться, как управлять ею, используя команды в редакторе кода.</para>
 
 <sect2 id="the-turtle-moves">
-<title
->Движения Черепашки</title>
-<para
->Давайте начнём с изучения движений. Наша Черепашка может перемещаться тремя способами: (1) передвигаться вперёд и назад, (2) поворачивать направо или налево или (3)перескочить сразу к определённой точке холста. Попробуйте, например, это:</para>
+<title>Движения Черепашки</title>
+<para>Давайте начнём с изучения движений. Наша Черепашка может перемещаться тремя способами: (1) передвигаться вперёд и назад, (2) поворачивать направо или налево или (3)перескочить сразу к определённой точке холста. Попробуйте, например, это:</para>
 <para>
-<screen
->вперёд 100
+<screen>вперёд 100
 налево 90 
 </screen>
-Введите эти строчки в редакторе кода или просто скопируйте отсюда, а потом вставьте в редактор (обратите внимание на использование буквы <quote
->ё</quote
->). После этого запустите на код исполнение (<link linkend="file-execute"
-><menuchoice
-><guimenu
->Файл</guimenu
-><guimenuitem
->Выполнить сценарий</guimenuitem
-></menuchoice
-></link
->) и посмотрите результат.</para>
+Введите эти строчки в редакторе кода или просто скопируйте отсюда, а потом вставьте в редактор (обратите внимание на использование буквы <quote>ё</quote>). После этого запустите на код исполнение (<link linkend="file-execute"><menuchoice><guimenu>Файл</guimenu><guimenuitem>Выполнить сценарий</guimenuitem></menuchoice></link>) и посмотрите результат.</para>
 
-<para
->После ввода и запуска команд, подобных приведённым выше, вы можете наблюдать следующее:</para>
+<para>После ввода и запуска команд, подобных приведённым выше, вы можете наблюдать следующее:</para>
 <orderedlist>
-<listitem
-><para
->После запуска команд на выполнение Черепашка продвинулась вверх, рисуя линию, и затем повернулась на 90 градусов влево. Это произошло потому, что мы использовали команды <link linkend="forward"
-><userinput
->вперёд</userinput
-></link
-> и <link linkend="turnleft"
-><userinput
->налево</userinput
-></link
->.</para>
+<listitem><para>После запуска команд на выполнение Черепашка продвинулась вверх, рисуя линию, и затем повернулась на 90 градусов влево. Это произошло потому, что мы использовали команды <link linkend="forward"><userinput>вперёд</userinput></link> и <link linkend="turnleft"><userinput>налево</userinput></link>.</para>
 </listitem>
 <listitem>
-<para
->Как вы могли заметить, при вводе кода его цвет меняется &mdash; это называется <emphasis
->подсветка кода</emphasis
-> (разные типы команд подсвечиваются по-разному). Подсветка делает чтение блоков кода удобнее.</para>
+<para>Как вы могли заметить, при вводе кода его цвет меняется &mdash; это называется <emphasis>подсветка кода</emphasis> (разные типы команд подсвечиваются по-разному). Подсветка делает чтение блоков кода удобнее.</para>
 </listitem>
 <listitem>
-<para
->Черепашка рисовала тонкой чёрной линией.</para>
+<para>Черепашка рисовала тонкой чёрной линией.</para>
 </listitem>
 <listitem>
-<para
->Может быть, вы получили сообщение об ошибке. Скорее всего, произошло одно из двух: вы совершили ошибку при копировании команд или же не выставили правильный язык ввода команд &logo; (вы можете сделать это в меню <menuchoice
-><guimenu
->Настройки</guimenu
-><guimenuitem
->Настроить &kturtle;...</guimenuitem
-></menuchoice
->, <guilabel
->Язык</guilabel
->).</para>
+<para>Может быть, вы получили сообщение об ошибке. Скорее всего, произошло одно из двух: вы совершили ошибку при копировании команд или же не выставили правильный язык ввода команд &logo; (вы можете сделать это в меню <menuchoice><guimenu>Настройки</guimenu><guimenuitem>Настроить &kturtle;...</guimenuitem></menuchoice>, <guilabel>Язык</guilabel>).</para>
 </listitem>
 </orderedlist>
 
-<para
->Как вы могли понять, команда <userinput
->вперёд 90</userinput
-> указала Черепашке на то, что ей необходимо двигаться вперёд, оставляя за собой линию, а команда <userinput
->налево</userinput
-> &mdash; повернуть на 90 <glossterm linkend="degrees"
->градусов</glossterm
-> влево.</para>
+<para>Как вы могли понять, команда <userinput>вперёд 90</userinput> указала Черепашке на то, что ей необходимо двигаться вперёд, оставляя за собой линию, а команда <userinput>налево</userinput> &mdash; повернуть на 90 <glossterm linkend="degrees">градусов</glossterm> влево.</para>
 
-<para
->Обратитесь к справочнику Logo для полного описания следующих команд: <userinput
->вперёд</userinput
->, <userinput
->назад</userinput
->, <userinput
->налево</userinput
-> и <userinput
->направо</userinput
->.</para>
+<para>Обратитесь к справочнику Logo для полного описания следующих команд: <userinput>вперёд</userinput>, <userinput>назад</userinput>, <userinput>налево</userinput> и <userinput>направо</userinput>.</para>
 </sect2>
 
 <sect2 id="more-examples">
-<title
->Ещё примеры</title>
-<para
->Первый пример был совсем простенький. Продолжаем.</para>
+<title>Ещё примеры</title>
+<para>Первый пример был совсем простенький. Продолжаем.</para>
 
 <para>
 <!--translators: if it's not already there, you can copy/paste the translated code below and save it in arrow.logo in your examples folder: tde-i18n/language-code/data/tdeedu/kturtle/ -->
-<screen
->нов_размер_холста 200,200
+<screen>нов_размер_холста 200,200
 нов_цвет_холста 0,0,0
 нов_цвет_пера 255,0,0
 нов_ширина_пера 5
@@ -143,111 +63,31 @@
 
 иди 40, 100
 </screen>
-Вы можете набрать этот код вручную, либо скопировать его в редактор отсюда, либо открыть файл <filename
->arrow.logo</filename
-> в папке примеров, выбрав пункт <guimenu
->Открыть пример</guimenu
-> меню Файл. Запустите пример (<link linkend="file-execute"
-><menuchoice
-><guimenu
->Файл</guimenu
-><guimenuitem
->Выполнить сценарий</guimenuitem
-></menuchoice
-></link
->) и посмотрите результат.</para>
+Вы можете набрать этот код вручную, либо скопировать его в редактор отсюда, либо открыть файл <filename>arrow.logo</filename> в папке примеров, выбрав пункт <guimenu>Открыть пример</guimenu> меню Файл. Запустите пример (<link linkend="file-execute"><menuchoice><guimenu>Файл</guimenu><guimenuitem>Выполнить сценарий</guimenuitem></menuchoice></link>) и посмотрите результат.</para>
 
-<para
->Как вы могли заметить, второй пример содержит гораздо больше кода. Также появилась пара новых команд. Ниже дано краткое описание новых команд:</para>
+<para>Как вы могли заметить, второй пример содержит гораздо больше кода. Также появилась пара новых команд. Ниже дано краткое описание новых команд:</para>
 
-<para
-><userinput
->нов_размер_холста 200,200</userinput
-> устанавливает ширину и высоту холста в 200 <glossterm linkend="pixels"
->пикселей</glossterm
->. Ширина и высота одинаковы, холст будет квадратным.</para>
+<para><userinput>нов_размер_холста 200,200</userinput> устанавливает ширину и высоту холста в 200 <glossterm linkend="pixels">пикселей</glossterm>. Ширина и высота одинаковы, холст будет квадратным.</para>
 
-<para
-><userinput
->нов_цвет_холста 0,0,0</userinput
-> задаёт чёрный цвет холста. <userinput
->0,0,0</userinput
-> &mdash; это комбинация <glossterm linkend="rgb"
->красной, зелёной и синей (по-английски: red, green, blue, или сокращённо RGB)</glossterm
-> составляющих цвета, если  все значения установлены в <userinput
->0</userinput
->, получится чёрный цвет.</para>
+<para><userinput>нов_цвет_холста 0,0,0</userinput> задаёт чёрный цвет холста. <userinput>0,0,0</userinput> &mdash; это комбинация <glossterm linkend="rgb">красной, зелёной и синей (по-английски: red, green, blue, или сокращённо RGB)</glossterm> составляющих цвета, если  все значения установлены в <userinput>0</userinput>, получится чёрный цвет.</para>
 
-<para
-><userinput
->нов_цвет_пера 255,0,0</userinput
-> устанавливает красный цвет для пера. <userinput
->255,0,0</userinput
-> &mdash; это комбинация <glossterm linkend="rgb"
->красной, зелёной и синей</glossterm
-> составляющих цвета, где красная составляющая равна <userinput
->255</userinput
->, а все остальные &mdash; <userinput
->0</userinput
->. Результатом будет красный цвет.</para>
+<para><userinput>нов_цвет_пера 255,0,0</userinput> устанавливает красный цвет для пера. <userinput>255,0,0</userinput> &mdash; это комбинация <glossterm linkend="rgb">красной, зелёной и синей</glossterm> составляющих цвета, где красная составляющая равна <userinput>255</userinput>, а все остальные &mdash; <userinput>0</userinput>. Результатом будет красный цвет.</para>
 
-<para
->Если вы не разбираетесь в задании значений цвета, обратитесь к разделу глоссария «<glossterm linkend="rgb"
->Коды цветов</glossterm
->».</para>
+<para>Если вы не разбираетесь в задании значений цвета, обратитесь к разделу глоссария «<glossterm linkend="rgb">Коды цветов</glossterm>».</para>
 
-<para
-><userinput
->нов_ширина_пера 5</userinput
-> устанавливает толщину (размер) пера в <userinput
->5</userinput
-> <glossterm linkend="pixels"
->пикселей</glossterm
->. С этого момента Черепашка будет рисовать линию толщиной <userinput
->5</userinput
-> до тех пор, пока мы не зададим другую толщину пера.</para>
+<para><userinput>нов_ширина_пера 5</userinput> устанавливает толщину (размер) пера в <userinput>5</userinput> <glossterm linkend="pixels">пикселей</glossterm>. С этого момента Черепашка будет рисовать линию толщиной <userinput>5</userinput> до тех пор, пока мы не зададим другую толщину пера.</para>
 
-<para
-><userinput
->очисти</userinput
-> очищает холст.</para>
+<para><userinput>очисти</userinput> очищает холст.</para>
 
-<para
-><userinput
->иди 20,20</userinput
-> указывает Черепашке перескочить в определённое место холста. Отсчитывается от верхнего левого угла, в данном случае Черепашка должна перескочить на 20 <glossterm linkend="pixels"
->пикселей</glossterm
-> влево от левой границы холста и на 20 <glossterm linkend="pixels"
->пикселей</glossterm
-> вниз от верхней границы холста. Примечание: при использовании этой команды, Черепашка не рисует линию.</para>
+<para><userinput>иди 20,20</userinput> указывает Черепашке перескочить в определённое место холста. Отсчитывается от верхнего левого угла, в данном случае Черепашка должна перескочить на 20 <glossterm linkend="pixels">пикселей</glossterm> влево от левой границы холста и на 20 <glossterm linkend="pixels">пикселей</glossterm> вниз от верхней границы холста. Примечание: при использовании этой команды, Черепашка не рисует линию.</para>
 
-<para
-><userinput
->направление 135</userinput
-> задаёт направление Черепашки. Команды <userinput
->налево</userinput
-> и <userinput
->направо</userinput
-> изменяют направление Черепашки на заданный угол относительно текущей позиции. Команда <userinput
->направление</userinput
-> изменяет направление Черепашки на заданный угол относительно 0 и не обращает внимание на предыдущее направление.</para>
+<para><userinput>направление 135</userinput> задаёт направление Черепашки. Команды <userinput>налево</userinput> и <userinput>направо</userinput> изменяют направление Черепашки на заданный угол относительно текущей позиции. Команда <userinput>направление</userinput> изменяет направление Черепашки на заданный угол относительно 0 и не обращает внимание на предыдущее направление.</para>
 
-<para
->После команды <userinput
->направление</userinput
-> следует множество команд <userinput
->вперёд</userinput
-> и <userinput
->налево</userinput
->. Эти команды выполняют рисование.</para>
+<para>После команды <userinput>направление</userinput> следует множество команд <userinput>вперёд</userinput> и <userinput>налево</userinput>. Эти команды выполняют рисование.</para>
 
-<para
->В конце используется ещё одна команда <userinput
->иди</userinput
-> для отвода Черепашки в сторону.</para>
+<para>В конце используется ещё одна команда <userinput>иди</userinput> для отвода Черепашки в сторону.</para>
 
-<para
->Прочитайте, пожалуйста, описание всех этих команд в справочнике. Там они объяснены более подробно.</para>
+<para>Прочитайте, пожалуйста, описание всех этих команд в справочнике. Там они объяснены более подробно.</para>
 
 
 </sect2>
@@ -258,36 +98,31 @@
 <!--        EXTRA SECTIONS CAN BE ADDED TO THE "GETTING STARTED"
 
 <sect1 id="calculations">
-<title
->Simple Calculations</title>
+<title>Simple Calculations</title>
 <para>
 Not yet written
 </para>
 </sect1>
 <sect1 id="using_variables">
-<title
->Using Variables: creating 'number containers'</title>
+<title>Using Variables: creating 'number containers'</title>
 <para>
 Not yet written
 </para>
 </sect1>
 <sect1 id="using_strings">
-<title
->Using strings: creating 'text containers'</title>
+<title>Using strings: creating 'text containers'</title>
 <para>
 Not yet written
 </para>
 </sect1>
 <sect1 id="logic">
-<title
->Logic: asking the computer simple questions</title>
+<title>Logic: asking the computer simple questions</title>
 <para>
 Not yet written
 </para>
 </sect1>
 <sect1 id="recursion">
-<title
->Recursion: the Turtle is using itself</title>
+<title>Recursion: the Turtle is using itself</title>
 <para>
 Draw a maze for example
 </para>