Beautify docbook files

1 files changed, 36 insertions, 203 deletions

diff --git a/tde-i18n-pl/docs/tdeedu/kturtle/getting-started.docbook b/tde-i18n-pl/docs/tdeedu/kturtle/getting-started.docbook
index 96e89dc01b2..fe313be9352 100644
--- a/tde-i18n-pl/docs/tdeedu/kturtle/getting-started.docbook
+++ b/tde-i18n-pl/docs/tdeedu/kturtle/getting-started.docbook
@@ -1,127 +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
->Rozpoczęcie pracy</title>
-<para
->Gdy uruchomisz program &kturtle; zobaczysz następujące okno: <screenshot
-> <screeninfo
->Oto zrzut ekranu programu &kturtle;, gdy jest on uruchamiany po raz pierwszy</screeninfo
-> <mediaobject
-> <imageobject
-> <imagedata fileref="mainwindow.png" format="PNG"/> </imageobject
-> <textobject
-> <phrase
->Główne okno &kturtle;</phrase
-> </textobject
-> </mediaobject
-> </screenshot
-> W tym podręczniku przyjmujemy, że językiem poleceń &logo; jest polski. Język możesz zmienić w menu <menuchoice
-><guimenu
->Ustawienia</guimenu
-><guimenuitem
->Konfiguracja &kturtle;...</guimenuitem
-></menuchoice
-> w dziale <guilabel
->Język</guilabel
->. Pamiętaj, że język, który ustawisz tutaj będzie musiał być wykorzystywany do wpisywania poleceń &logo;.</para>
+<title>Rozpoczęcie pracy</title>
+<para>Gdy uruchomisz program &kturtle; zobaczysz następujące okno: <screenshot> <screeninfo>Oto zrzut ekranu programu &kturtle;, gdy jest on uruchamiany po raz pierwszy</screeninfo> <mediaobject> <imageobject> <imagedata fileref="mainwindow.png" format="PNG"/> </imageobject> <textobject> <phrase>Główne okno &kturtle;</phrase> </textobject> </mediaobject> </screenshot> W tym podręczniku przyjmujemy, że językiem poleceń &logo; jest polski. Język możesz zmienić w menu <menuchoice><guimenu>Ustawienia</guimenu><guimenuitem>Konfiguracja &kturtle;...</guimenuitem></menuchoice> w dziale <guilabel>Język</guilabel>. Pamiętaj, że język, który ustawisz tutaj będzie musiał być wykorzystywany do wpisywania poleceń &logo;.</para>
 
 <sect1 id="first-steps">
-<title
->Pierwsze kroki z &logo;: poznaj Żółwia!</title>
-<para
->Musiałeś już zauważyć żółwia w samym środku okna: dowiesz się teraz jak nim sterować za pomocą poleceń wpisywanych do edytora kodu.</para>
+<title>Pierwsze kroki z &logo;: poznaj Żółwia!</title>
+<para>Musiałeś już zauważyć żółwia w samym środku okna: dowiesz się teraz jak nim sterować za pomocą poleceń wpisywanych do edytora kodu.</para>
 
 <sect2 id="the-turtle-moves">
-<title
->Poruszanie żółwiem</title>
-<para
->Rozpocznijmy od wprawienia żółwia w ruch. Nasz żółw może się poruszać na trzy sposoby, (1) może się poruszać w przód i w tył, (2) możesz skręcać w lewo i w prawo oraz (3) może iść bezpośrednio do miejsca wskazanego na ekranie. Spróbuj na przykład:</para>
+<title>Poruszanie żółwiem</title>
+<para>Rozpocznijmy od wprawienia żółwia w ruch. Nasz żółw może się poruszać na trzy sposoby, (1) może się poruszać w przód i w tył, (2) możesz skręcać w lewo i w prawo oraz (3) może iść bezpośrednio do miejsca wskazanego na ekranie. Spróbuj na przykład:</para>
 <para>
-<screen
->naprzód 100
+<screen>naprzód 100
 obróć_w_lewo 90 
 </screen>
-Wpisz lub skopiuj i wklej kod do edytora kodów, a następnie go wykonaj (korzystając z menu <link linkend="file-execute"
-><menuchoice
-><guimenu
->Plik</guimenu
-><guimenuitem
->Wykonaj rozkaz</guimenuitem
-></menuchoice
-></link
->), aby zobaczyć rezultat.</para>
+Wpisz lub skopiuj i wklej kod do edytora kodów, a następnie go wykonaj (korzystając z menu <link linkend="file-execute"><menuchoice><guimenu>Plik</guimenu><guimenuitem>Wykonaj rozkaz</guimenuitem></menuchoice></link>), aby zobaczyć rezultat.</para>
 
-<para
->Po wpisaniu i wykonaniu podanych wyżej poleceń mogłeś zaobserwować następujące zdarzenia:</para>
+<para>Po wpisaniu i wykonaniu podanych wyżej poleceń mogłeś zaobserwować następujące zdarzenia:</para>
 <orderedlist>
-<listitem
-><para
->Po wykonaniu polecenia, żółw przesuną się do góry, narysował linię, a następnie zrobił jedną czwartą obrotu w lewo. Stało się tak, ponieważ wprowadziłeś polecenia <link linkend="forward"
-><userinput
->naprzód</userinput
-></link
-> oraz <link linkend="turnleft"
-><userinput
->obróć_w_lewo</userinput
-></link
->.</para>
+<listitem><para>Po wykonaniu polecenia, żółw przesuną się do góry, narysował linię, a następnie zrobił jedną czwartą obrotu w lewo. Stało się tak, ponieważ wprowadziłeś polecenia <link linkend="forward"><userinput>naprzód</userinput></link> oraz <link linkend="turnleft"><userinput>obróć_w_lewo</userinput></link>.</para>
 </listitem>
 <listitem>
-<para
->Kolor kodu zmieniał się w miarę jak go pisałeś: opcja ta nazywana jest <emphasis
->intuicyjnym podświetlaniem</emphasis
-> &mdash; różne rodzaju poleceń są podświetlane w różny sposób. Ułatwia to czytanie dużych bloków tekstu.</para>
+<para>Kolor kodu zmieniał się w miarę jak go pisałeś: opcja ta nazywana jest <emphasis>intuicyjnym podświetlaniem</emphasis> &mdash; różne rodzaju poleceń są podświetlane w różny sposób. Ułatwia to czytanie dużych bloków tekstu.</para>
 </listitem>
 <listitem>
-<para
->Żółw narysował cienką czarną linię.</para>
+<para>Żółw narysował cienką czarną linię.</para>
 </listitem>
 <listitem>
-<para
->Być może pojawił się komunikat błędu. Może to zwyczajnie oznaczać dwie rzeczy: mogłeś popełnić błąd podczas kopiowania poleceń, albo napisałeś polecenia w innym języku niż ten, który został zdefiniowany dla poleceń &logo; (język możesz zmienić wybierając <menuchoice
-><guimenu
->Ustawienia</guimenu
-><guimenuitem
->Konfiguracja &kturtle;...</guimenuitem
-></menuchoice
->, a następnie dział <guilabel
->Język</guilabel
->).</para>
+<para>Być może pojawił się komunikat błędu. Może to zwyczajnie oznaczać dwie rzeczy: mogłeś popełnić błąd podczas kopiowania poleceń, albo napisałeś polecenia w innym języku niż ten, który został zdefiniowany dla poleceń &logo; (język możesz zmienić wybierając <menuchoice><guimenu>Ustawienia</guimenu><guimenuitem>Konfiguracja &kturtle;...</guimenuitem></menuchoice>, a następnie dział <guilabel>Język</guilabel>).</para>
 </listitem>
 </orderedlist>
 
-<para
->Prawdopodobnie zauważyłeś, że polecenie <userinput
->naprzód 100</userinput
-> spowodowało przesunięcie żółwia do przodu i pozostawienie linii, a polecenie <userinput
->obróć_w_lewo 90</userinput
-> obrót o 90 <glossterm linkend="degrees"
->stopni</glossterm
-> w lewo.</para>
+<para>Prawdopodobnie zauważyłeś, że polecenie <userinput>naprzód 100</userinput> spowodowało przesunięcie żółwia do przodu i pozostawienie linii, a polecenie <userinput>obróć_w_lewo 90</userinput> obrót o 90 <glossterm linkend="degrees">stopni</glossterm> w lewo.</para>
 
-<para
->Sprawdź następujące odnośniki do podręcznika użytkownika, aby uzyskać informacje na temat nowych poleceń: <userinput
->naprzód</userinput
->, <userinput
->wstecz</userinput
->, <userinput
->obróć_w_lewo</userinput
->, oraz <userinput
->obróć_w_prawo</userinput
->.</para>
+<para>Sprawdź następujące odnośniki do podręcznika użytkownika, aby uzyskać informacje na temat nowych poleceń: <userinput>naprzód</userinput>, <userinput>wstecz</userinput>, <userinput>obróć_w_lewo</userinput>, oraz <userinput>obróć_w_prawo</userinput>.</para>
 </sect2>
 
 <sect2 id="more-examples">
-<title
->Dodatkowe przykłady</title>
-<para
->Pierwszy przykład był bardzo prosty, więc ruszajmy dalej!</para>
+<title>Dodatkowe przykłady</title>
+<para>Pierwszy przykład był bardzo prosty, więc ruszajmy dalej!</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
->przeskaluj_tło 200,200
+<screen>przeskaluj_tło 200,200
 kolor_tła 0,0,0
 kolor_pisaka 255,0,0
 ustaw_grubość_pisaka 5
@@ -141,115 +63,31 @@ obróć_w_lewo 45
 
 idź 40, 100
 </screen>
-Podobnie i tutaj możesz wpisać lub skopiować i wkleić kod do edytora kodów lub otworzyć plik <filename
->arrow.logo</filename
-> za pomocą menu <guimenu
->Otwórz przykłady</guimenu
->, a następnie go wykonać (korzystając z menu <link linkend="file-execute"
-><menuchoice
-><guimenu
->Plik</guimenu
-><guimenuitem
->Wykonaj rozkaz</guimenuitem
-></menuchoice
-></link
->), aby zobaczyć rezultat. Po następnych przykładach będziesz już wiedział dokładnie o co chodzi.</para>
+Podobnie i tutaj możesz wpisać lub skopiować i wkleić kod do edytora kodów lub otworzyć plik <filename>arrow.logo</filename> za pomocą menu <guimenu>Otwórz przykłady</guimenu>, a następnie go wykonać (korzystając z menu <link linkend="file-execute"><menuchoice><guimenu>Plik</guimenu><guimenuitem>Wykonaj rozkaz</guimenuitem></menuchoice></link>), aby zobaczyć rezultat. Po następnych przykładach będziesz już wiedział dokładnie o co chodzi.</para>
 
-<para
->Jak widać, drugi przykład zawiera zdecydowanie więcej kodu. Zauważyłeś na pewno kilka nowych poleceń. Oto ich krótkie wyjaśnienie:</para>
+<para>Jak widać, drugi przykład zawiera zdecydowanie więcej kodu. Zauważyłeś na pewno kilka nowych poleceń. Oto ich krótkie wyjaśnienie:</para>
 
-<para
-><userinput
->przeskaluj_tło 200,200</userinput
-> ustawia wysokość i szerokość obszaru na 200 <glossterm linkend="pixels"
->pikseli</glossterm
->. Wysokość i szerokość są sobie równe, tak więc obszar będzie kwadratem.</para>
+<para><userinput>przeskaluj_tło 200,200</userinput> ustawia wysokość i szerokość obszaru na 200 <glossterm linkend="pixels">pikseli</glossterm>. Wysokość i szerokość są sobie równe, tak więc obszar będzie kwadratem.</para>
 
-<para
-><userinput
->kolor_tła 0,0,0</userinput
-> koloruje krawędzie na czarno. <userinput
->0,0,0</userinput
-> jest <glossterm linkend="rgb"
->kombinacją RGB</glossterm
->, w której wszystkie wartości są ustawione na <userinput
->0</userinput
->, co daje kolor czarny.</para>
+<para><userinput>kolor_tła 0,0,0</userinput> koloruje krawędzie na czarno. <userinput>0,0,0</userinput> jest <glossterm linkend="rgb">kombinacją RGB</glossterm>, w której wszystkie wartości są ustawione na <userinput>0</userinput>, co daje kolor czarny.</para>
 
-<para
-><userinput
->kolor_pisaka 255,0,0</userinput
-> ustawia kolor pióra na czerwony. <userinput
->255,0,0</userinput
-> jest <glossterm linkend="rgb"
->kombinacją RGB</glossterm
->, w której tylko wartość czerwona została ustawiona na <userinput
->255</userinput
-> (w pełni włączona) podczas gdy inne (zielona i niebieska) zostały ustawione na <userinput
->0</userinput
-> (w pełni wyłączone). Rezultatem jest ostry kolor czerwony.</para>
+<para><userinput>kolor_pisaka 255,0,0</userinput> ustawia kolor pióra na czerwony. <userinput>255,0,0</userinput> jest <glossterm linkend="rgb">kombinacją RGB</glossterm>, w której tylko wartość czerwona została ustawiona na <userinput>255</userinput> (w pełni włączona) podczas gdy inne (zielona i niebieska) zostały ustawione na <userinput>0</userinput> (w pełni wyłączone). Rezultatem jest ostry kolor czerwony.</para>
 
-<para
->Jeżeli nie rozumiesz wartości kolorów, to przeczytaj w słowniczku objaśnienie <glossterm linkend="rgb"
->kombinacji RGB</glossterm
-></para>
+<para>Jeżeli nie rozumiesz wartości kolorów, to przeczytaj w słowniczku objaśnienie <glossterm linkend="rgb">kombinacji RGB</glossterm></para>
 
-<para
-><userinput
->ustaw_grubość_pisaka 5</userinput
-> ustawia szerokość (rozmiar) pióra na <userinput
->5</userinput
-> <glossterm linkend="pixels"
->pikseli</glossterm
->. Od teraz, każda linia rysowana przez żółwia będzie miała szerokość <userinput
->5</userinput
->-ciu pikseli, aż do momentu zmiany wartości parametru <userinput
->ustaw_grubość_pisaka</userinput
-> na inną.</para>
+<para><userinput>ustaw_grubość_pisaka 5</userinput> ustawia szerokość (rozmiar) pióra na <userinput>5</userinput> <glossterm linkend="pixels">pikseli</glossterm>. Od teraz, każda linia rysowana przez żółwia będzie miała szerokość <userinput>5</userinput>-ciu pikseli, aż do momentu zmiany wartości parametru <userinput>ustaw_grubość_pisaka</userinput> na inną.</para>
 
-<para
-><userinput
->czyść</userinput
-> usuwa linie ograniczenia obszaru.</para>
+<para><userinput>czyść</userinput> usuwa linie ograniczenia obszaru.</para>
 
-<para
-><userinput
->idź 20,20</userinput
-> powoduje, że żółw przemieszcza się w określone miejsce obszaru. Pozycja jest obliczana od lewego górnego rogu, więc miejsce docelowe znajduje się 20 <glossterm linkend="pixels"
->pikseli</glossterm
-> na lewo i 20 <glossterm linkend="pixels"
->pikseli</glossterm
-> w dół. Pamiętaj, że po poleceniu <userinput
->go</userinput
-> żółw nie będzie rysował linii.</para>
+<para><userinput>idź 20,20</userinput> powoduje, że żółw przemieszcza się w określone miejsce obszaru. Pozycja jest obliczana od lewego górnego rogu, więc miejsce docelowe znajduje się 20 <glossterm linkend="pixels">pikseli</glossterm> na lewo i 20 <glossterm linkend="pixels">pikseli</glossterm> w dół. Pamiętaj, że po poleceniu <userinput>go</userinput> żółw nie będzie rysował linii.</para>
 
-<para
-><userinput
->kierunek 135</userinput
-> ustawia kierunek żółwia. Polecenia <userinput
->obróć_w_lewo</userinput
-> oraz <userinput
->obróć_w_prawo</userinput
-> zmieniają kąt położenia rozpoczynając od bieżącego kierunku. Polecenie <userinput
->kierunek</userinput
-> zmienia kąt żółwia z pozycji zero, czyli nie ma znaczenia w jakiej pozycji znajdował się żółw przed zmianą konta położenia.</para>
+<para><userinput>kierunek 135</userinput> ustawia kierunek żółwia. Polecenia <userinput>obróć_w_lewo</userinput> oraz <userinput>obróć_w_prawo</userinput> zmieniają kąt położenia rozpoczynając od bieżącego kierunku. Polecenie <userinput>kierunek</userinput> zmienia kąt żółwia z pozycji zero, czyli nie ma znaczenia w jakiej pozycji znajdował się żółw przed zmianą konta położenia.</para>
 
-<para
->Po poleceniu <userinput
->kierunek</userinput
-> następuje wiele poleceń <userinput
->naprzód</userinput
-> i <userinput
->obróć_w_lewo</userinput
->. Te polecenia powodują rysowanie.</para>
+<para>Po poleceniu <userinput>kierunek</userinput> następuje wiele poleceń <userinput>naprzód</userinput> i <userinput>obróć_w_lewo</userinput>. Te polecenia powodują rysowanie.</para>
 
-<para
->Wreszcie kolejne polecenie <userinput
->idź</userinput
-> powoduje przesunięcie żółwia na bok.</para>
+<para>Wreszcie kolejne polecenie <userinput>idź</userinput> powoduje przesunięcie żółwia na bok.</para>
 
-<para
->Pamiętaj, że odnośniki do poleceń kierują do wyjaśnień każdego z poleceń.</para>
+<para>Pamiętaj, że odnośniki do poleceń kierują do wyjaśnień każdego z poleceń.</para>
 
 
 </sect2>
@@ -260,36 +98,31 @@ Podobnie i tutaj możesz wpisać lub skopiować i wkleić kod do edytora kodów
 <!--        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>