diff options
Diffstat (limited to 'doc/kturtle/index.docbook')
| -rw-r--r-- | doc/kturtle/index.docbook | 243 |
1 files changed, 243 insertions, 0 deletions
diff --git a/doc/kturtle/index.docbook b/doc/kturtle/index.docbook new file mode 100644 index 00000000..79477b3c --- /dev/null +++ b/doc/kturtle/index.docbook @@ -0,0 +1,243 @@ +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" +"dtd/kdex.dtd" [ + <!ENTITY kappname "&kturtle;"> + <!ENTITY package "kdeedu"> + <!ENTITY logo "Logo"> + <!ENTITY % addindex "IGNORE"> + <!ENTITY % English "INCLUDE"><!-- change language only here --> + <!ENTITY using-kturtle SYSTEM "using-kturtle.docbook"> + <!ENTITY getting-started SYSTEM "getting-started.docbook"> + <!ENTITY programming-reference SYSTEM "programming-reference.docbook"> + <!ENTITY translator-guide SYSTEM "translator-guide.docbook"> + <!ENTITY glossary SYSTEM "glossary.docbook"> +]> + +<book lang="&language;"> + +<bookinfo> +<title>The &kturtle; Handbook</title> + +<authorgroup> +<author> +<firstname>Cies</firstname> +<surname>Breijs</surname> +<affiliation> +<address><email>cies AT kde DOT nl</email></address> +</affiliation> +</author> +<author> +<firstname>Anne-Marie</firstname> +<surname>Mahfouf</surname> +<affiliation> +<address><email>annma AT kde DOT org</email></address> +</affiliation> +</author> +<!-- TRANS:ROLES_OF_TRANSLATORS --> +</authorgroup> + + +<copyright> +<year>2004</year> +<holder>Cies Breijs</holder> +</copyright> + +<legalnotice>&FDLNotice;</legalnotice> + +<date>2005-12-10</date> +<releaseinfo>0.6</releaseinfo> + +<abstract> +<para> +&kturtle; is an educational programming environment using the &logo; programming language. The unique quality of LOGO is that the programming commands are translated to the language of the 'programmer' so he/she can program in his/her native language. +</para> +</abstract> + +<keywordset> +<keyword>KDE</keyword> +<keyword>kdeedu</keyword> +<keyword>KTurtle</keyword> +<keyword>education</keyword> +<keyword>language</keyword> +<keyword>native</keyword> +<keyword>programming</keyword> +<keyword>code</keyword> +<keyword>&logo;</keyword> +<keyword>instructions</keyword> +<keyword>turtle</keyword> +</keywordset> + +</bookinfo> + +<chapter id="introduction"> +<title>Introduction</title> + +<para>&kturtle; is an educational programming environment using the +<link linkend="what-is-logo">&logo;</link> programming language. The goal of &kturtle; is to make programming as easy and accessible as possible. This makes &kturtle; suitable for teaching kids the basics of math, geometry and... programming. The commands used to program are in the style of the &logo; programming language. The unique feature of the &logo; programming language is that the commands are often translated into the speaking language of the programmer.</para> + +<para>&kturtle; is named after <quote>the turtle</quote> that plays a central role in the programming environment. The user programs the turtle, using the &logo; commands, to draw a picture on <link linkend="the-canvas">the canvas</link>.</para> + +<sect1 id="what-is-logo"> +<title>What is &logo;?</title> +<para>The first version &logo; programming language was created by Seymour +Papert of MIT Artificial Intelligence Laboratory in 1967 as an offshoot of the +LISP programming language. From then many versions of &logo; have been released. +By 1980 &logo; was gaining momentum, with versions for MSX, Commodore, Atari, +Apple II and IBM PC systems. These versions were mainly for educational +purposes. LCSI released <application>&Mac;&logo;</application> in 1985 as a tool +for professional programmers, but it never caught on. MIT is still maintaining a +site on &logo; which can be found on <ulink +url="http://el.media.mit.edu/logo-foundation/">http://el.media.mit.edu/logo- +foundation/</ulink>.</para> + +<para>Today there are several versions of &logo; around which can easily be found on <ulink url="http://el.media.mit.edu/logo-foundation/">MIT's &logo; site</ulink> and by a simple <ulink url="http://www.google.com/search?q=logo+programming+kids">Google search</ulink>. This version of &logo; (&kturtle;) is only focused on the educational qualities of the programming language and will not try to suit professional programmers' needs.</para> +</sect1> + +<sect1 id="features-of-kturtle"> +<title>Features of &kturtle;</title> +<para>&kturtle; has some nice features that make starting to program a breeze. See here some of the highlights of &kturtle; feature set: +<itemizedlist> +<listitem><para> +An integrated &logo; interpreter (no extra dependencies) that uses &XML; files for the command translations, supports user defined functions and dynamic type switching. +</para></listitem> +<listitem><para> +The execution can be slown down, paused or stopped at any time. +</para></listitem> +<listitem><para> +A powerful editor for the &logo; commands with intuitive syntax highlighting, line numbering and more. +</para></listitem> +<listitem><para> +<link linkend="the-canvas">The canvas</link> can be saved as an image or printed. +</para></listitem> +<listitem><para> +<link linkend="the-canvas">The canvas</link> has a wrapping mode (which is on by default) so the turtle cannot get lost too easily. +</para></listitem> +<listitem><para> +Context help for all &logo; commands: Just press <keysym>F2</keysym>. +</para></listitem> +<listitem><para> +The &logo; commands are fully translatable (at the moment of writing Brazilian Portuguese, Dutch, French, German, Italian, Slovenian, Serbian (Cyrillic and Latin), Spanish and Swedish are in &kde;). +</para></listitem> +<listitem><para> +An error dialog that links the error messages to the mistakes in the program. +</para></listitem> +<listitem><para> +Simplified programming terminology. +</para></listitem> +<listitem><para> +Full-screen mode. +</para></listitem> +<listitem><para> +Many integrated, internationalized example &logo; programs make it easy to get started. +</para></listitem> +</itemizedlist> +</para> +</sect1> +</chapter> + +&using-kturtle; + +&getting-started; + +&programming-reference; + +&glossary; + +&translator-guide; + +<chapter id="credits"> + +<title>Credits and License</title> + +<para> +&kturtle; +</para> +<para>Program copyright 2003-2005 Cies Breijs <email>cies AT kde DOT nl</email></para> +<para> +Contributors: +<itemizedlist> +<listitem><para>Coding help, editor part: &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;</para> +</listitem> +<listitem><para>Author of <application>WSBASIC</application> (<ulink url="http://wsbasic.sourceforge.net">http://wsbasic.sourceforge.net</ulink>) which is the base for the interpreter of &kturtle;: Walter Schreppers <email>Walter DOT Schreppers AT ua DOT ac DOT be</email></para> +</listitem> +<listitem><para>German Data Files: Matthias Meßmer <email>bmlmessmer AT web DOT de</email></para> +</listitem> +<listitem><para>German Data Files: Burkhard Lück <email>lueck AT hube-lueck DOT de</email></para> +</listitem> +<listitem><para>Swedish Data Files: Stefan Asserhäll <email>stefan DOT asserhal AT telia DOT com</email></para> +</listitem> +<listitem><para>Slovenian Data Files: Jure Repinc <email>jlp@holodeck1.com</email></para> +</listitem> +<listitem><para>Serbian (Cyrillic and Latin) Data Files: Chusslove Illich <email>caslav.ilic@gmx.net</email></para> +</listitem> +<listitem><para>Italian Data Files: Pino Toscano <email>toscano.pino@tiscali.it</email></para> +</listitem> +<listitem><para>English GB Data Files: Andy Potter <email>A.J.Potter@rhul.ac.uk</email></para> +</listitem> +<listitem><para>Spanish Data Files: Rafael Beccar <email>rafael.beccar@kdemail.net</email></para> +</listitem> +<listitem><para>Brazilian Portuguese Data Files: Riverson Rios <email>riverson@ccv.ufc.br</email></para> +</listitem> +<listitem><para>Norwegian Nynorsk and BokmÃ¥l Data Files: Karl Ove Hufthammer <email>karl@huftis.org</email></para> +</listitem> +<listitem><para>Parser Cyrillic support: Albert Astals Cid <email>astals11@terra.es</email></para> +</listitem> +</itemizedlist> +</para> + +<para> +Documentation copyright 2004 +<itemizedlist> +<listitem><para> +Cies Breijs <email>cies AT kde DOT nl</email> +</para></listitem> +<listitem><para> +&Anne-Marie.Mahfouf; <email>annma AT kde DOT org</email> +</para></listitem> +<listitem><para>Some proofreading changes by &Philip.Rodrigues; &Philip.Rodrigues.mail;</para> +</listitem> +<listitem><para>Updated translation how-to and some proofreading changes by Andrew Coles <email>andrew_coles AT yahoo DOT co DOT uk</email></para> +</listitem> + +</itemizedlist> +</para> +<!-- TRANS:CREDIT_FOR_TRANSLATORS --> + +&underFDL; + +&underGPL; <!-- GPL License --> + +</chapter> + + + +<appendix id="installation"> +<title>Installation</title> + +<sect1 id="getting-kturtle"> +<title>How to obtain &kturtle;</title> + +&install.intro.documentation; + +</sect1> + +<sect1 id="compilation"> +<title>Compilation and Installation</title> + +&install.compile.documentation; + +</sect1> + +</appendix> + +&documentation.index; +</book> +<!-- +Local Variables: +mode: sgml +sgml-minimize-attributes:nil +sgml-general-insert-case:lower +sgml-indent-step:0 +sgml-indent-data:nil +End: +--> |