Initial import of extracted KDE i18n tarballs

1 files changed, 266 insertions, 0 deletions

diff --git a/tde-i18n-sv/docs/kdeedu/kturtle/translator-guide.docbook b/tde-i18n-sv/docs/kdeedu/kturtle/translator-guide.docbook
new file mode 100644
index 00000000000..370c9936756
--- /dev/null
+++ b/tde-i18n-sv/docs/kdeedu/kturtle/translator-guide.docbook
@@ -0,0 +1,266 @@
+<chapter id="translators">
+<title
+>Översättningsguide för &kturtle;</title>
+<para
+>Som du förmodligen redan vet, är det unika kännetecknet med programspråket &logo; att &logo;-kommandon ofta översätts till programmerarens språk. Det tar bort en barriär för att förstå programmeringens grunder för många elever. När &kturtle; översätts till ett nytt språk måste ytterligare några filer översättas i förutom de vanliga strängarna och dokumentationen. Dock skapas det mesta automatiskt av Rafael Beccars skript. Skripten finns i <userinput
+>kdeedu/kturtle/scripts</userinput
+>, och filerna som behöver översättas finns i <userinput
+>kdeedu/kturtle/data</userinput
+>. I dessa kataloger hittar du också README-filer som innehåller instruktioner om hur de används eller översätts. </para>
+ 
+<sect1 id="make_directory">
+<title
+>Skapa en katalog som ska innehålla de översatta filerna</title>
+<para
+>Först måste du skapa en katalog där de översatta filerna ska lagras. Skapa en katalog som heter <filename class="directory"
+>kde-i18n/<replaceable
+>kod</replaceable
+>/data/kdeedu/kturtle/</filename
+> i din KDE CVS-katalog, där <replaceable
+>kod</replaceable
+> är din landskod (2 eller 4 bokstävers <acronym
+>ISO</acronym
+>-kod). </para>
+<para
+>Kopiera filen <filename
+>Makefile.am</filename
+> från <filename class="directory"
+>kdeedu/kturtle/data/</filename
+> till den här katalogen. Öppna den med din favoriteditor, ersätt alla förekomster av <quote
+>en_US</quote
+> i filen med din landskod (den som används ovan), och spara filen. </para>
+</sect1>
+<sect1 id="commands_trans">
+<title
+>Hur &logo;-nyckelord (kommandon) ska översättas</title>
+<para>
+<itemizedlist>
+<listitem
+><para
+>Kopiera filen <filename
+>logokeywords.en_US.xml</filename
+> från <filename class="directory"
+>kdeedu/kturtle/data/</filename
+> till katalogen du just har skapat, och byt namn på den till <filename
+>logokeywords.<replaceable
+>kod</replaceable
+>.xml</filename
+>, där <replaceable
+>kod</replaceable
+> är din landskod (2 eller 4 bokstävers <acronym
+>ISO</acronym
+>-kod). </para>
+</listitem>
+<listitem
+><para
+>Översätt innehållet i taggen <sgmltag class="starttag"
+>keyword</sgmltag
+> till ditt eget språk (dvs. informationen mellan <sgmltag class="starttag"
+>keyword</sgmltag
+> och <sgmltag class="endtag"
+>keyword</sgmltag
+>) när det är möjligt, och innehållet i taggen <sgmltag class="starttag"
+>alias</sgmltag
+> (dvs. informationen mellan <sgmltag class="starttag"
+>alias</sgmltag
+> och <sgmltag class="endtag"
+>alias</sgmltag
+>). Deras innehåll hör ihop på så sätt att alias är en förkortning av keyword.</para>
+<para
+>Översätt till exempel <quote
+>while</quote
+> i <sgmltag class="starttag"
+>keyword</sgmltag
+>while<sgmltag class="endtag"
+>keyword</sgmltag
+> </para>
+<para
+>Var snäll översätt inte något annat och översätt inte engelska ord i <sgmltag class="starttag"
+>command name="engelskt_ord"</sgmltag
+>. De måste förbli på engelska. </para>
+<para
+>Till sist: ändra inte ordningen i filen, eftersom den behövs av Rafael Beccars skript för att skapa automatiska översättningar. </para>
+</listitem>
+<listitem
+><para
+>Spara filen som <acronym
+>UTF-8</acronym
+> (använd <guimenuitem
+>Spara som...</guimenuitem
+> i &kate; och byt till <guilabel
+>utf8</guilabel
+> i rutan till höger om filnamnet). </para>
+</listitem>
+<listitem
+><para
+>Arkivera filen (lägg till ditt filnamn i <filename
+>Makefile.am</filename
+>) eller skicka den till Anne-Marie. </para>
+</listitem>
+<listitem
+><para
+>Om det finns några tveksamheter, kontakta gärna Anne-Marie Mahfouf <email
+>annemarie.mahfouf@free.fr</email
+> för mer information.</para>
+</listitem>
+</itemizedlist>
+</para>
+</sect1>
+
+<sect1 id="examples_syntax">
+<title
+>Hur filerna för syntaxfärgläggning ska översättas</title>
+<para
+>Att översätta <filename
+>logohighlightstyle.en_US.xml</filename
+> är en lätt match när Rafael Beccars skript i <filename class="directory"
+>kdeedu/kturtle/data/</filename
+> används. Försäkra dig om att du läser README-filen i den katalogen. </para>
+<para
+>För att fungera för alla de som inte vill använda välsignelsen med perl-skripten som nämns i föregående stycke, beskrivs det gammalmodiga sättet att göra det här: <itemizedlist>
+<listitem
+><para
+>Kopiera filen <filename
+>logohighlightstyle.en_US.xml</filename
+> från <filename class="directory"
+>kdeedu/kturtle/data/</filename
+> till katalogen du skapade för att lagra den översatta nyckelordsfilen, och byt namn på den till <filename
+>logohighlightstyle.<replaceable
+>kod</replaceable
+>.xml</filename
+>, där <replaceable
+>kod</replaceable
+> är din landskod (2 eller 4 bokstävers <acronym
+>ISO</acronym
+>-kod). </para>
+</listitem>
+<listitem
+><para
+>På rad 4 i filen finns <sgmltag class="starttag"
+>language name="en_US"</sgmltag
+>..., här ändrar du <quote
+>en_US</quote
+> till <acronym
+>ISO</acronym
+>-koden för ditt språk (2 eller 4 bokstäver). </para
+></listitem>
+<listitem
+><para
+>Översätt innehållet i taggen <sgmltag class="starttag"
+>item</sgmltag
+> till ditt eget språk (dvs. informationen mellan <sgmltag class="starttag"
+>item</sgmltag
+> och <sgmltag class="endtag"
+>item</sgmltag
+>). Innehållet måste stämma med filen <filename
+>logokeyword</filename
+>. Översätt till exempel <quote
+>while</quote
+> i <sgmltag class="starttag"
+>item</sgmltag
+> while <sgmltag class="endtag"
+>item</sgmltag
+> och lämna mellanslagen som de är (ett i början och ett i slutet). Var snäll och översätt ingenting annat. </para
+></listitem>
+<listitem
+><para
+>Spara filen som <acronym
+>UTF-8</acronym
+> (använd <guimenuitem
+>Spara som...</guimenuitem
+> i &kate; och byt till <guilabel
+>utf8</guilabel
+> i rutan till höger om filnamnet). </para
+></listitem>
+<listitem
+><para
+>Arkivera filen (lägg till ditt filnamn i <filename
+>Makefile.am</filename
+>) eller skicka den till Anne-Marie. </para
+></listitem>
+<listitem
+><para
+>Om det finns några tveksamheter, kontakta gärna Anne-Marie Mahfouf <email
+>annemarie.mahfouf@free.fr</email
+> för mer information. </para
+></listitem>
+</itemizedlist>
+</para>
+</sect1>
+
+<sect1 id="examples_trans">
+<title
+>Hur exemplen ska översättas</title>
+<para
+>Återigen förenklas uppgiften en hel del av Rafael Beccars skript i <filename class="directory"
+>kdeedu/kturtle/data/</filename
+>.  Försäkra dig om att du läser README-filen i den katalogen, eftersom ett visst arbete fortfarande måste göras efter Logo-exempelfilerna har översatts automatiskt. </para>
+<para
+>Efter du följt instruktionerna som ges i README-filen som finns i katalogen scripts, är du nu nästan färdig. Glöm inte att testa den översatta Logo-exempelkoden du skapade, eftersom det är mycket vanligt att ett fel smyger sig in. Försäkra dig också om att <userinput
+>Makefile.am</userinput
+> i <filename class="directory"
+>kde-i18n/<replaceable
+>kod</replaceable
+>/data/kdeedu/kturtle/</filename
+> uppdateras enligt de nya filerna. För holländska ska <userinput
+>Makefile.am</userinput
+> se ut så här: <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
+>Här är en beskrivning av hur översättningen görs UTAN att använda Rafaels perl-skript: <itemizedlist>
+<listitem
+><para
+>Kopiera de engelska exemplen från <filename class="directory"
+>kdeedu/kturtle/data/</filename
+> till katalogen som används för att lagra de översatta nyckelorden och filerna för syntaxfärgläggning. Översätt filnamnen på exemplen i din katalog: Det gör det möjligt för användare att enkelt och snabbt förstå vad exemplen handlar om.</para>
+</listitem>
+<listitem
+><para
+>Översätt nyckelorden i exemplen, med de i <filename
+>logokeywords.xml</filename
+> till ditt språk. Nyckelordsfilen måste vara gjord först, innan exemplen översätts.</para>
+</listitem>
+<listitem
+><para
+>Spara filen som <acronym
+>UTF-8</acronym
+> (använd <guimenuitem
+>Spara som...</guimenuitem
+> i &kate; och byt till <guilabel
+>utf8</guilabel
+> i rutan till höger om filnamnet).</para>
+</listitem>
+<listitem
+><para
+>Arkivera katalogen (lägg till en <filename
+>Makefile.am</filename
+> i den) eller skicka den till Anne-Marie.</para>
+</listitem>
+<listitem
+><para
+>Om det finns några tveksamheter, kontakta gärna Anne-Marie Mahfouf, <email
+>annemarie.mahfouf@free.fr</email
+> för mer information.</para>
+</listitem>
+<listitem
+><para
+>Till sist, om du vill, kan du lägga till egna exempel i katalogen.</para>
+</listitem>
+</itemizedlist>
+</para>
+</sect1>
+
+</chapter>