Initial import of extracted KDE i18n tarballs

1 files changed, 266 insertions, 0 deletions

diff --git a/tde-i18n-pl/docs/kdeedu/kturtle/translator-guide.docbook b/tde-i18n-pl/docs/kdeedu/kturtle/translator-guide.docbook
new file mode 100644
index 00000000000..8f6443b45d8
--- /dev/null
+++ b/tde-i18n-pl/docs/kdeedu/kturtle/translator-guide.docbook
@@ -0,0 +1,266 @@
+<chapter id="translators">
+<title
+>Podręcznik tłumacza &kturtle;</title>
+<para
+>Jak już prawdopodobnie wiesz, szczególną cechą języka programowania &logo; jest to, że polecenia &logo; są często tłumaczone na język programisty. Usuwa to barierę dla niektórych uczących się osób, która utrudnia zrozumienie programowania. Przy tłumaczeniu &kturtle; na nowy język, należy przetłumaczyć niektóre dodatkowe pliki poza ciągami i dokumentacją. Większość jest generowana automatycznie przez skrypty Rafaela Beccar'a. Skrypty te można odnaleźć w <userinput
+>kdeedu/kturtle/scripts</userinput
+>, natomiast pliki, które wymagają tłumaczenia można odnaleźć w <userinput
+>kdeedu/kturtle/data</userinput
+>. W tych katalogach odnajdziesz także pliki README, które zawierają instrukcje dotyczące korzystania z nich. </para>
+ 
+<sect1 id="make_directory">
+<title
+>Tworzenie katalogu na przetłumaczone pliki</title>
+<para
+>Najpierw, należy utworzyć katalog do przechowywania przetłumaczonych plików. Utwórz katalog o nazwie <filename class="directory"
+>kde-i18n/<replaceable
+> kod</replaceable
+>/data/kdeedu/kturtle/</filename
+> w swoim katalogu CVS KDE, gdzie <replaceable
+>kod</replaceable
+> jest kodem kraju (litera 2- lub 4- kod <acronym
+>ISO</acronym
+>). </para>
+<para
+>Skopiuj do tego katalogu plik <filename
+>Makefile.am</filename
+> z <filename class="directory"
+>kdeedu/kturtle/data/</filename
+>. Otwórz go za pomocą dowolnego edytora tekstów, zamień każdą pozycję, w której występuje <quote
+>en_US</quote
+> na kod Twojego kraju (ten pokazany powyżej). Następnie zapisz pliku. </para>
+</sect1>
+<sect1 id="commands_trans">
+<title
+>Jak tłumaczyć słowa kluczowe &logo; (polecenia)</title>
+<para>
+<itemizedlist>
+<listitem
+><para
+>Skopiuj plik <filename
+>logokeywords.en_US.xml</filename
+> z <filename class="directory"
+>kdeedu/kturtle/data/</filename
+> do katalogu, który właśnie stworzyłeś, a następnie zmień nazwę pliku na <filename
+>logokeywords.<replaceable
+>kod</replaceable
+>.xml</filename
+>, gdzie <replaceable
+>kod</replaceable
+> jest kodem Twojego kraju (litera 2- lub 4- kod <acronym
+>ISO</acronym
+>). </para>
+</listitem>
+<listitem
+><para
+>Przetłumacz zawartość tagu <sgmltag class="starttag"
+>keyword</sgmltag
+> (&ie; informacje pomiędzy <sgmltag class="starttag"
+>keyword</sgmltag
+>, a <sgmltag class="endtag"
+>keyword</sgmltag
+>) na własny język gdziekolwiek to tylko możliwe. Również, przetłumacz zawartość tagu <sgmltag class="starttag"
+>alias</sgmltag
+>, (&ie; informacje pomiędzy <sgmltag class="starttag"
+>alias</sgmltag
+>, a <sgmltag class="endtag"
+>alias</sgmltag
+>): są one używane jako skróty dla słowa kluczowego.</para>
+<para
+>Na przykład, przetłumacz <quote
+>while</quote
+> w: <sgmltag class="starttag"
+>keyword</sgmltag
+>while<sgmltag class="endtag"
+>keyword</sgmltag
+> </para>
+<para
+>Pamiętaj, aby nie tłumaczyć czego innego oraz nie tłumaczyć angielskich słów w <sgmltag class="starttag"
+>command name="angielskie_słowo"</sgmltag
+>: muszą one pozostać w języku angielskim. </para>
+<para
+>Ostatnia uwaga: nie zmieniaj kolejności tego pliku, jest on potrzebny do skryptów generacji automatycznych tłumaczeń Rafael'a Beccar'a. </para>
+</listitem>
+<listitem
+><para
+>Zapisz swoje pliki jako <acronym
+>UTF-8</acronym
+> (w &kate;, wykorzystaj <guimenuitem
+>Zapisz jako...</guimenuitem
+> i zmień na <guilabel
+>utf8</guilabel
+> w polu po prawej stronie nazwy pliku). </para>
+</listitem>
+<listitem
+><para
+>Dołącz swój plik (dodaj nazwę swojego pliku do <filename
+>Makefile.am</filename
+>) lub wyślij go do Anne-Marie. </para>
+</listitem>
+<listitem
+><para
+>W razie jakichkolwiek wątpliwości, skontaktuj się z Anne-Marie Mahfouf <email
+>annemarie.mahfouf@free.fr</email
+>, aby uzyskać dalsze informacje.</para>
+</listitem>
+</itemizedlist>
+</para>
+</sect1>
+
+<sect1 id="examples_syntax">
+<title
+>Jak tłumaczyć pliki składni</title>
+<para
+>Tłumaczenie <filename
+>logohighlightstyle.en_US.xml</filename
+> jest bardzo proste przy korzystaniu ze skryptu Rafael'a Beccar'a w <filename class="directory"
+>kdeedu/kturtle/data/</filename
+>. Pamiętaj o przeczytaniu pliku README w tym katalogu. </para>
+<para
+>Dla pełnej kompatybilności z wszystkimi ludźmi, którzy nie chcą korzystać ze skryptów perla wspomnianych w poprzednim paragrafie, oda starsza metoda na wykonanie tej samej czynności: <itemizedlist>
+<listitem
+><para
+>Skopiuj plik <filename
+>logohighlightstyle.en_US.xml</filename
+> z <filename class="directory"
+>kdeedu/kturtle/data/</filename
+> do katalogu, który utworzyłeś do przechowywania przetłumaczonych plików słów kluczowych, a następnie zmień jego nazwę na <filename
+>logohighlightstyle.<replaceable
+>kod</replaceable
+>.xml</filename
+>, gdzie <replaceable
+>kod</replaceable
+> jest kodem Twojego kraju (litera 2- lub 4- kod <acronym
+>ISO</acronym
+>). </para>
+</listitem>
+<listitem
+><para
+>We wierszu 4 pliku, znajduje się <sgmltag class="starttag"
+>language name="en_US"</sgmltag
+>...: tutaj zmieniasz <quote
+>en_US</quote
+> na kod <acronym
+>ISO</acronym
+> Twojego języka (litery 2 lub 4). </para
+></listitem>
+<listitem
+><para
+>Przetłumacz na swój język zawartość tagu <sgmltag class="starttag"
+>item</sgmltag
+> (&ie; informacje pomiędzy <sgmltag class="starttag"
+>item</sgmltag
+> oraz <sgmltag class="endtag"
+>item</sgmltag
+>). Ta zawartość musi pasować do pliku <filename
+>logokeyword</filename
+>. Na przykład, przetłumacz <quote
+>while</quote
+> w: <sgmltag class="starttag"
+>item</sgmltag
+> while <sgmltag class="endtag"
+>item</sgmltag
+> i pozostaw spacje na swoim miejscu (jedną na początku i jedną na końcu). Nie tłumacz niczego innego. </para
+></listitem>
+<listitem
+><para
+>Zapisz swoje pliki jako <acronym
+>UTF-8</acronym
+> (w &kate;, wykorzystaj <guimenuitem
+>Zapisz jako...</guimenuitem
+> i zmień na <guilabel
+>utf8</guilabel
+> w polu po prawej stronie nazwy pliku). </para
+></listitem>
+<listitem
+><para
+>Dołącz swój plik (dodaj nazwę swojego pliku do <filename
+>Makefile.am</filename
+>) lub wyślij go do Anne-Marie. </para
+></listitem>
+<listitem
+><para
+>W razie jakichkolwiek wątpliwości, skontaktuj się z Anne-Marie Mahfouf <email
+>annemarie.mahfouf@free.fr</email
+>, aby uzyskać dalsze informacje. </para
+></listitem>
+</itemizedlist>
+</para>
+</sect1>
+
+<sect1 id="examples_trans">
+<title
+>Przykłady tłumaczeń</title>
+<para
+>Podobnie i to zadanie jest w znacznym stopniu uproszczone dzięki skryptowi Rafael'a Beccar'a w <filename class="directory"
+>kdeedu/kturtle/data/</filename
+>. Pamiętaj, aby przeczytać plik w tym katalogu, ponieważ część pracy w dalszym ciągu musi zostać wykonana po tym jak pliki logo zostaną automatycznie przetłumaczone. </para>
+<para
+>Jeżeli zastosowałeś się do instrukcji podanych w pliku README, który znalazłeś w katalogu skryptów, powinieneś być prawie gotowy. Pamiętaj, aby sprawdzić przetłumaczony przykładowy kod logo, który utworzyłeś, ponieważ często zdarza się, że wkrada się błąd. Upewnij się również, że plik <userinput
+>Makefile.am</userinput
+> w <filename class="directory"
+>kde-i18n/<replaceable
+>kod</replaceable
+>/data/kdeedu/kturtle/</filename
+> jest zaktualizowany zgodnie z nowymi plikami. W przypadku języka holenderskiego, plik <userinput
+>Makefile.am</userinput
+> powinien wyglądać następująco: <screen
+>txt_DATA = advertentie.logo driehoeken.logo krullen.logo tafels.logo \
+bloem.logo driehoek.logo logohighlightstyle.nl.xml pijl.logo vierkanten.logo \
+kleuren.logo logokeywords.nl.xml randomnaam.logo vierkant.logo
+txtdir = $(kde_datadir)/kturtle/examples/nl
+
+xml_DATA = logohighlightstyle.nl.xml
+xmldir = $(kde_datadir)/katepart/syntax
+
+keywords_DATA = logokeywords.nl.xml
+keywordsdir = $(kde_datadir)/kturtle/data
+EXTRA_DIST = $(txt_DATA) $(xml_DATA) $(keywords_DATA)
+</screen
+> 
+</para>
+<para
+>Oto jak wykonać tłumaczenie BEZ korzystania ze skryptów Rafael'a: <itemizedlist>
+<listitem
+><para
+>Skopiuj przykłady angielskich plików z <filename class="directory"
+>kdeedu/kturtle/data/</filename
+> do katalogu wykorzystywanego do przechowywania przetłumaczonych słów kluczowych i plików skryptów. Przetłumacz nazwy plików przykładów w swoim katalogu: pozwoli to użytkownikom na łatwe i szybkie zrozumienie tego, czego dotyczy przykład.</para>
+</listitem>
+<listitem
+><para
+>Przetłumacz słowa kluczowe w przykładach, korzystając z tych w pliku <filename
+>logokeywords.xml</filename
+> dla Twojego języka. Plik słów kluczowych musi zostać zrobiony przed tłumaczeniem przykładów.</para>
+</listitem>
+<listitem
+><para
+>Zachowaj swój plik jako <acronym
+>UTF-8</acronym
+> (w &kate;, wykorzystaj <guimenuitem
+>Zapisz jako...</guimenuitem
+> i zmień na <guilabel
+>utf8</guilabel
+> w polu po prawej stronie nazwy pliku)</para>
+</listitem>
+<listitem
+><para
+>Dołącz swój folder (dodaj <filename
+>Makefile.am</filename
+>) lub wyślij go do Anne-Marie.</para>
+</listitem>
+<listitem
+><para
+>W przypadku jakichkolwiek wątpliwości, skontaktuj się z Anne-Marie Mahfouf, <email
+>annemarie.mahfouf@free.fr</email
+>.</para>
+</listitem>
+<listitem
+><para
+>Wreszcie, jeżeli chcesz, dodaj swoje własne przykłady do tego folderu.</para>
+</listitem>
+</itemizedlist>
+</para>
+</sect1>
+
+</chapter>