summaryrefslogtreecommitdiffstats
path: root/tde-i18n-pl/docs/tdeedu/kturtle/getting-started.docbook
diff options
context:
space:
mode:
Diffstat (limited to 'tde-i18n-pl/docs/tdeedu/kturtle/getting-started.docbook')
-rw-r--r--tde-i18n-pl/docs/tdeedu/kturtle/getting-started.docbook300
1 files changed, 300 insertions, 0 deletions
diff --git a/tde-i18n-pl/docs/tdeedu/kturtle/getting-started.docbook b/tde-i18n-pl/docs/tdeedu/kturtle/getting-started.docbook
new file mode 100644
index 00000000000..96e89dc01b2
--- /dev/null
+++ b/tde-i18n-pl/docs/tdeedu/kturtle/getting-started.docbook
@@ -0,0 +1,300 @@
+<!--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>
+
+<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>
+
+<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>
+<para>
+<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>
+
+<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>
+<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>
+</listitem>
+<listitem>
+<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>
+</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
+>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>
+
+<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
+kolor_tła 0,0,0
+kolor_pisaka 255,0,0
+ustaw_grubość_pisaka 5
+czyść
+
+idź 20,20
+kierunek 135
+
+naprzód 200
+obróć_w_lewo 135
+naprzód 100
+obróć_w_lewo 135
+naprzód 141
+obróć_w_lewo 135
+naprzód 100
+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>
+
+<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
+>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
+>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
+>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
+>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
+>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>
+
+
+</sect2>
+</sect1>
+
+
+
+<!-- EXTRA SECTIONS CAN BE ADDED TO THE "GETTING STARTED"
+
+<sect1 id="calculations">
+<title
+>Simple Calculations</title>
+<para>
+Not yet written
+</para>
+</sect1>
+<sect1 id="using_variables">
+<title
+>Using Variables: creating 'number containers'</title>
+<para>
+Not yet written
+</para>
+</sect1>
+<sect1 id="using_strings">
+<title
+>Using strings: creating 'text containers'</title>
+<para>
+Not yet written
+</para>
+</sect1>
+<sect1 id="logic">
+<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>
+<para>
+Draw a maze for example
+</para>
+</sect1>
+-->
+
+
+</chapter>