diff options
Diffstat (limited to 'tde-i18n-en_GB/docs/tdeedu/kturtle')
| -rw-r--r-- | tde-i18n-en_GB/docs/tdeedu/kturtle/Makefile.am | 4 | ||||
| -rw-r--r-- | tde-i18n-en_GB/docs/tdeedu/kturtle/Makefile.in | 635 | ||||
| -rw-r--r-- | tde-i18n-en_GB/docs/tdeedu/kturtle/getting-started.docbook | 292 | ||||
| -rw-r--r-- | tde-i18n-en_GB/docs/tdeedu/kturtle/glossary.docbook | 406 | ||||
| -rw-r--r-- | tde-i18n-en_GB/docs/tdeedu/kturtle/index.cache.bz2 | bin | 0 -> 18760 bytes | |||
| -rw-r--r-- | tde-i18n-en_GB/docs/tdeedu/kturtle/index.docbook | 305 | ||||
| -rw-r--r-- | tde-i18n-en_GB/docs/tdeedu/kturtle/programming-reference.docbook | 1209 | ||||
| -rw-r--r-- | tde-i18n-en_GB/docs/tdeedu/kturtle/translator-guide.docbook | 223 | ||||
| -rw-r--r-- | tde-i18n-en_GB/docs/tdeedu/kturtle/using-kturtle.docbook | 1025 |
9 files changed, 4099 insertions, 0 deletions
diff --git a/tde-i18n-en_GB/docs/tdeedu/kturtle/Makefile.am b/tde-i18n-en_GB/docs/tdeedu/kturtle/Makefile.am new file mode 100644 index 00000000000..f781297a70f --- /dev/null +++ b/tde-i18n-en_GB/docs/tdeedu/kturtle/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = en_GB +SUBDIRS = $(AUTODIRS) +KDE_DOCS = AUTO +KDE_MANS = AUTO diff --git a/tde-i18n-en_GB/docs/tdeedu/kturtle/Makefile.in b/tde-i18n-en_GB/docs/tdeedu/kturtle/Makefile.in new file mode 100644 index 00000000000..babf86aed97 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdeedu/kturtle/Makefile.in @@ -0,0 +1,635 @@ +# Makefile.in generated by automake 1.10.1 from Makefile.am. +# KDE tags expanded automatically by am_edit - $Revision: 483858 $ +# @configure_input@ + +# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, +# 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. +# This Makefile.in is free software; the Free Software Foundation +# gives unlimited permission to copy and/or distribute it, +# with or without modifications, as long as this notice is preserved. + +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY, to the extent permitted by law; without +# even the implied warranty of MERCHANTABILITY or FITNESS FOR A +# PARTICULAR PURPOSE. + +@SET_MAKE@ +VPATH = @srcdir@ +pkgdatadir = $(datadir)/@PACKAGE@ +pkglibdir = $(libdir)/@PACKAGE@ +pkgincludedir = $(includedir)/@PACKAGE@ +am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd +install_sh_DATA = $(install_sh) -c -m 644 +install_sh_PROGRAM = $(install_sh) -c +install_sh_SCRIPT = $(install_sh) -c +INSTALL_HEADER = $(INSTALL_DATA) +transform = $(program_transform_name) +NORMAL_INSTALL = : +PRE_INSTALL = : +POST_INSTALL = : +NORMAL_UNINSTALL = : +PRE_UNINSTALL = : +POST_UNINSTALL = : +subdir = docs/tdeedu/kturtle +DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in +ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 +am__aclocal_m4_deps = $(top_srcdir)/acinclude.m4 \ + $(top_srcdir)/configure.in +am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ + $(ACLOCAL_M4) +mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs +CONFIG_HEADER = $(top_builddir)/config.h +CONFIG_CLEAN_FILES = +SOURCES = +DIST_SOURCES = +#>- RECURSIVE_TARGETS = all-recursive check-recursive dvi-recursive \ +#>- html-recursive info-recursive install-data-recursive \ +#>- install-dvi-recursive install-exec-recursive \ +#>- install-html-recursive install-info-recursive \ +#>- install-pdf-recursive install-ps-recursive install-recursive \ +#>- installcheck-recursive installdirs-recursive pdf-recursive \ +#>- ps-recursive uninstall-recursive +#>+ 7 +RECURSIVE_TARGETS = all-recursive check-recursive dvi-recursive \ + html-recursive info-recursive install-data-recursive \ + install-dvi-recursive install-exec-recursive \ + install-html-recursive install-info-recursive \ + install-pdf-recursive install-ps-recursive install-recursive \ + installcheck-recursive installdirs-recursive pdf-recursive \ + ps-recursive uninstall-recursive nmcheck-recursive bcheck-recursive +RECURSIVE_CLEAN_TARGETS = mostlyclean-recursive clean-recursive \ + distclean-recursive maintainer-clean-recursive +ETAGS = etags +CTAGS = ctags +DIST_SUBDIRS = $(SUBDIRS) +#>- DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) +#>+ 1 +DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) $(KDE_DIST) +ACLOCAL = @ACLOCAL@ +AMTAR = @AMTAR@ +ARTSCCONFIG = @ARTSCCONFIG@ +AUTOCONF = @AUTOCONF@ +AUTODIRS = @AUTODIRS@ +AUTOHEADER = @AUTOHEADER@ +AUTOMAKE = @AUTOMAKE@ +AWK = @AWK@ +CONF_FILES = @CONF_FILES@ +CYGPATH_W = @CYGPATH_W@ +DCOPIDL = @DCOPIDL@ +DCOPIDL2CPP = @DCOPIDL2CPP@ +DCOPIDLNG = @DCOPIDLNG@ +DCOP_DEPENDENCIES = @DCOP_DEPENDENCIES@ +DEFS = @DEFS@ +ECHO_C = @ECHO_C@ +ECHO_N = @ECHO_N@ +ECHO_T = @ECHO_T@ +GMSGFMT = @GMSGFMT@ +INSTALL = @INSTALL@ +INSTALL_DATA = @INSTALL_DATA@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_SCRIPT = @INSTALL_SCRIPT@ +INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +KCFG_DEPENDENCIES = @KCFG_DEPENDENCIES@ +KCONFIG_COMPILER = @KCONFIG_COMPILER@ +KDECONFIG = @KDECONFIG@ +KDE_EXTRA_RPATH = @KDE_EXTRA_RPATH@ +KDE_RPATH = @KDE_RPATH@ +KDE_XSL_STYLESHEET = @KDE_XSL_STYLESHEET@ +LIBOBJS = @LIBOBJS@ +LIBS = @LIBS@ +LN_S = @LN_S@ +LTLIBOBJS = @LTLIBOBJS@ +MAKEINFO = @MAKEINFO@ +MAKEKDEWIDGETS = @MAKEKDEWIDGETS@ +MCOPIDL = @MCOPIDL@ +MEINPROC = @MEINPROC@ +MKDIR_P = @MKDIR_P@ +MSGFMT = @MSGFMT@ +PACKAGE = @PACKAGE@ +PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ +PACKAGE_NAME = @PACKAGE_NAME@ +PACKAGE_STRING = @PACKAGE_STRING@ +PACKAGE_TARNAME = @PACKAGE_TARNAME@ +PACKAGE_VERSION = @PACKAGE_VERSION@ +PATH_SEPARATOR = @PATH_SEPARATOR@ +SET_MAKE = @SET_MAKE@ +SHELL = @SHELL@ +STRIP = @STRIP@ +TOPSUBDIRS = @TOPSUBDIRS@ +VERSION = @VERSION@ +XGETTEXT = @XGETTEXT@ +XMLLINT = @XMLLINT@ +X_RPATH = @X_RPATH@ +abs_builddir = @abs_builddir@ +abs_srcdir = @abs_srcdir@ +abs_top_builddir = @abs_top_builddir@ +abs_top_srcdir = @abs_top_srcdir@ +am__leading_dot = @am__leading_dot@ +am__tar = @am__tar@ +am__untar = @am__untar@ +#>- bindir = @bindir@ +#>+ 2 +DEPDIR = .deps +bindir = @bindir@ +build_alias = @build_alias@ +builddir = @builddir@ +datadir = @datadir@ +datarootdir = @datarootdir@ +docdir = @docdir@ +dvidir = @dvidir@ +exec_prefix = @exec_prefix@ +host_alias = @host_alias@ +htmldir = @htmldir@ +includedir = @includedir@ +infodir = @infodir@ +install_sh = @install_sh@ +kde_appsdir = @kde_appsdir@ +kde_bindir = @kde_bindir@ +kde_confdir = @kde_confdir@ +kde_datadir = @kde_datadir@ +kde_htmldir = @kde_htmldir@ +kde_icondir = @kde_icondir@ +kde_kcfgdir = @kde_kcfgdir@ +kde_libs_htmldir = @kde_libs_htmldir@ +kde_libs_prefix = @kde_libs_prefix@ +kde_locale = @kde_locale@ +kde_mimedir = @kde_mimedir@ +kde_moduledir = @kde_moduledir@ +kde_servicesdir = @kde_servicesdir@ +kde_servicetypesdir = @kde_servicetypesdir@ +kde_sounddir = @kde_sounddir@ +kde_styledir = @kde_styledir@ +kde_templatesdir = @kde_templatesdir@ +kde_wallpaperdir = @kde_wallpaperdir@ +kde_widgetdir = @kde_widgetdir@ +tdeinitdir = @tdeinitdir@ +libdir = @libdir@ +libexecdir = @libexecdir@ +localedir = @localedir@ +localstatedir = @localstatedir@ +mandir = @mandir@ +mkdir_p = @mkdir_p@ +oldincludedir = @oldincludedir@ +pdfdir = @pdfdir@ +prefix = @prefix@ +program_transform_name = @program_transform_name@ +psdir = @psdir@ +sbindir = @sbindir@ +sharedstatedir = @sharedstatedir@ +srcdir = @srcdir@ +sysconfdir = @sysconfdir@ +target_alias = @target_alias@ +top_builddir = @top_builddir@ +top_srcdir = @top_srcdir@ +xdg_appsdir = @xdg_appsdir@ +xdg_directorydir = @xdg_directorydir@ +xdg_menudir = @xdg_menudir@ +KDE_LANG = en_GB +#>- SUBDIRS = $(AUTODIRS) +#>+ 1 +SUBDIRS =. +KDE_DOCS = AUTO +KDE_MANS = AUTO +#>- all: all-recursive +#>+ 1 +all: docs-am all-recursive + +.SUFFIXES: +$(srcdir)/Makefile.in: $(srcdir)/Makefile.am $(am__configure_deps) +#>- @for dep in $?; do \ +#>- case '$(am__configure_deps)' in \ +#>- *$$dep*) \ +#>- cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \ +#>- && exit 0; \ +#>- exit 1;; \ +#>- esac; \ +#>- done; \ +#>- echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu docs/tdeedu/kturtle/Makefile'; \ +#>- cd $(top_srcdir) && \ +#>- $(AUTOMAKE) --gnu docs/tdeedu/kturtle/Makefile +#>+ 12 + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \ + && exit 0; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu docs/tdeedu/kturtle/Makefile'; \ + cd $(top_srcdir) && \ + $(AUTOMAKE) --gnu docs/tdeedu/kturtle/Makefile + cd $(top_srcdir) && perl ../scripts/admin/am_edit -p../scripts/admin docs/tdeedu/kturtle/Makefile.in +.PRECIOUS: Makefile +Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status + @case '$?' in \ + *config.status*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ + *) \ + echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ + esac; + +$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +$(top_srcdir)/configure: $(am__configure_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(ACLOCAL_M4): $(am__aclocal_m4_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +# This directory's subdirectories are mostly independent; you can cd +# into them and run `make' without going through this Makefile. +# To change the values of `make' variables: instead of editing Makefiles, +# (1) if the variable is set in `config.status', edit `config.status' +# (which will cause the Makefiles to be regenerated when you run `make'); +# (2) otherwise, pass the desired values on the `make' command line. +$(RECURSIVE_TARGETS): + @failcom='exit 1'; \ + for f in x $$MAKEFLAGS; do \ + case $$f in \ + *=* | --[!k]*);; \ + *k*) failcom='fail=yes';; \ + esac; \ + done; \ + dot_seen=no; \ + target=`echo $@ | sed s/-recursive//`; \ + list='$(SUBDIRS)'; for subdir in $$list; do \ + echo "Making $$target in $$subdir"; \ + if test "$$subdir" = "."; then \ + dot_seen=yes; \ + local_target="$$target-am"; \ + else \ + local_target="$$target"; \ + fi; \ + (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \ + || eval $$failcom; \ + done; \ + if test "$$dot_seen" = "no"; then \ + $(MAKE) $(AM_MAKEFLAGS) "$$target-am" || exit 1; \ + fi; test -z "$$fail" + +$(RECURSIVE_CLEAN_TARGETS): + @failcom='exit 1'; \ + for f in x $$MAKEFLAGS; do \ + case $$f in \ + *=* | --[!k]*);; \ + *k*) failcom='fail=yes';; \ + esac; \ + done; \ + dot_seen=no; \ + case "$@" in \ + distclean-* | maintainer-clean-*) list='$(DIST_SUBDIRS)' ;; \ + *) list='$(SUBDIRS)' ;; \ + esac; \ + rev=''; for subdir in $$list; do \ + if test "$$subdir" = "."; then :; else \ + rev="$$subdir $$rev"; \ + fi; \ + done; \ + rev="$$rev ."; \ + target=`echo $@ | sed s/-recursive//`; \ + for subdir in $$rev; do \ + echo "Making $$target in $$subdir"; \ + if test "$$subdir" = "."; then \ + local_target="$$target-am"; \ + else \ + local_target="$$target"; \ + fi; \ + (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \ + || eval $$failcom; \ + done && test -z "$$fail" +tags-recursive: + list='$(SUBDIRS)'; for subdir in $$list; do \ + test "$$subdir" = . || (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) tags); \ + done +ctags-recursive: + list='$(SUBDIRS)'; for subdir in $$list; do \ + test "$$subdir" = . || (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) ctags); \ + done + +ID: $(HEADERS) $(SOURCES) $(LISP) $(TAGS_FILES) + list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ + unique=`for i in $$list; do \ + if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ + done | \ + $(AWK) '{ files[$$0] = 1; nonemtpy = 1; } \ + END { if (nonempty) { for (i in files) print i; }; }'`; \ + mkid -fID $$unique +tags: TAGS + +TAGS: tags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ + $(TAGS_FILES) $(LISP) + tags=; \ + here=`pwd`; \ + if ($(ETAGS) --etags-include --version) >/dev/null 2>&1; then \ + include_option=--etags-include; \ + empty_fix=.; \ + else \ + include_option=--include; \ + empty_fix=; \ + fi; \ + list='$(SUBDIRS)'; for subdir in $$list; do \ + if test "$$subdir" = .; then :; else \ + test ! -f $$subdir/TAGS || \ + tags="$$tags $$include_option=$$here/$$subdir/TAGS"; \ + fi; \ + done; \ + list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ + unique=`for i in $$list; do \ + if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ + done | \ + $(AWK) '{ files[$$0] = 1; nonempty = 1; } \ + END { if (nonempty) { for (i in files) print i; }; }'`; \ + if test -z "$(ETAGS_ARGS)$$tags$$unique"; then :; else \ + test -n "$$unique" || unique=$$empty_fix; \ + $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \ + $$tags $$unique; \ + fi +ctags: CTAGS +CTAGS: ctags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ + $(TAGS_FILES) $(LISP) + tags=; \ + list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ + unique=`for i in $$list; do \ + if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ + done | \ + $(AWK) '{ files[$$0] = 1; nonempty = 1; } \ + END { if (nonempty) { for (i in files) print i; }; }'`; \ + test -z "$(CTAGS_ARGS)$$tags$$unique" \ + || $(CTAGS) $(CTAGSFLAGS) $(AM_CTAGSFLAGS) $(CTAGS_ARGS) \ + $$tags $$unique + +GTAGS: + here=`$(am__cd) $(top_builddir) && pwd` \ + && cd $(top_srcdir) \ + && gtags -i $(GTAGS_ARGS) $$here + +distclean-tags: + -rm -f TAGS ID GTAGS GRTAGS GSYMS GPATH tags + +#>- distdir: $(DISTFILES) +#>+ 1 +distdir: distdir-nls $(DISTFILES) + @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + list='$(DISTFILES)'; \ + dist_files=`for file in $$list; do echo $$file; done | \ + sed -e "s|^$$srcdirstrip/||;t" \ + -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \ + case $$dist_files in \ + */*) $(MKDIR_P) `echo "$$dist_files" | \ + sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \ + sort -u` ;; \ + esac; \ + for file in $$dist_files; do \ + if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ + if test -d $$d/$$file; then \ + dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \ + if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ + cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \ + fi; \ + cp -pR $$d/$$file $(distdir)$$dir || exit 1; \ + else \ + test -f $(distdir)/$$file \ + || cp -p $$d/$$file $(distdir)/$$file \ + || exit 1; \ + fi; \ + done + list='$(DIST_SUBDIRS)'; for subdir in $$list; do \ + if test "$$subdir" = .; then :; else \ + test -d "$(distdir)/$$subdir" \ + || $(MKDIR_P) "$(distdir)/$$subdir" \ + || exit 1; \ + distdir=`$(am__cd) $(distdir) && pwd`; \ + top_distdir=`$(am__cd) $(top_distdir) && pwd`; \ + (cd $$subdir && \ + $(MAKE) $(AM_MAKEFLAGS) \ + top_distdir="$$top_distdir" \ + distdir="$$distdir/$$subdir" \ + am__remove_distdir=: \ + am__skip_length_check=: \ + distdir) \ + || exit 1; \ + fi; \ + done +check-am: all-am +check: check-recursive +all-am: Makefile +installdirs: installdirs-recursive +installdirs-am: +install: install-recursive +install-exec: install-exec-recursive +install-data: install-data-recursive +#>- uninstall: uninstall-recursive +#>+ 1 +uninstall: uninstall-docs uninstall-nls uninstall-recursive + +install-am: all-am + @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am + +installcheck: installcheck-recursive +install-strip: + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + `test -z '$(STRIP)' || \ + echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install +mostlyclean-generic: + +clean-generic: + +distclean-generic: + -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + +maintainer-clean-generic: + @echo "This command is intended for maintainers to use" + @echo "it deletes files that may require special tools to rebuild." +#>- clean: clean-recursive +#>+ 1 +clean: kde-rpo-clean clean-recursive + +#>- clean-am: clean-generic mostlyclean-am +#>+ 1 +clean-am: clean-docs clean-bcheck clean-generic mostlyclean-am + +distclean: distclean-recursive + -rm -f Makefile +distclean-am: clean-am distclean-generic distclean-tags + +dvi: dvi-recursive + +dvi-am: + +html: html-recursive + +info: info-recursive + +info-am: + +#>- install-data-am: +#>+ 1 +install-data-am: install-docs install-nls + +install-dvi: install-dvi-recursive + +install-exec-am: + +install-html: install-html-recursive + +install-info: install-info-recursive + +install-man: + +install-pdf: install-pdf-recursive + +install-ps: install-ps-recursive + +installcheck-am: + +maintainer-clean: maintainer-clean-recursive + -rm -f Makefile +maintainer-clean-am: distclean-am maintainer-clean-generic + +mostlyclean: mostlyclean-recursive + +mostlyclean-am: mostlyclean-generic + +pdf: pdf-recursive + +pdf-am: + +ps: ps-recursive + +ps-am: + +uninstall-am: + +.MAKE: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) install-am \ + install-strip + +.PHONY: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) CTAGS GTAGS \ + all all-am check check-am clean clean-generic ctags \ + ctags-recursive distclean distclean-generic distclean-tags \ + distdir dvi dvi-am html html-am info info-am install \ + install-am install-data install-data-am install-dvi \ + install-dvi-am install-exec install-exec-am install-html \ + install-html-am install-info install-info-am install-man \ + install-pdf install-pdf-am install-ps install-ps-am \ + install-strip installcheck installcheck-am installdirs \ + installdirs-am maintainer-clean maintainer-clean-generic \ + mostlyclean mostlyclean-generic pdf pdf-am ps ps-am tags \ + tags-recursive uninstall uninstall-am + +# Tell versions [3.59,3.63) of GNU make to not export all variables. +# Otherwise a system limit (for SysV at least) may be exceeded. +.NOEXPORT: + +#>+ 2 +KDE_DIST=index.docbook programming-reference.docbook getting-started.docbook glossary.docbook index.cache.bz2 translator-guide.docbook Makefile.in using-kturtle.docbook Makefile.am + +#>+ 24 +index.cache.bz2: $(srcdir)/index.docbook $(KDE_XSL_STYLESHEET) glossary.docbook index.docbook using-kturtle.docbook programming-reference.docbook getting-started.docbook translator-guide.docbook + @if test -n "$(MEINPROC)"; then echo $(MEINPROC) --check --cache index.cache.bz2 $(srcdir)/index.docbook; $(MEINPROC) --check --cache index.cache.bz2 $(srcdir)/index.docbook; fi + +docs-am: index.cache.bz2 + +install-docs: docs-am install-nls + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kturtle + @if test -f index.cache.bz2; then \ + echo $(INSTALL_DATA) index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kturtle/; \ + $(INSTALL_DATA) index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kturtle/; \ + elif test -f $(srcdir)/index.cache.bz2; then \ + echo $(INSTALL_DATA) $(srcdir)/index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kturtle/; \ + $(INSTALL_DATA) $(srcdir)/index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kturtle/; \ + fi + -rm -f $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kturtle/common + $(LN_S) $(kde_libs_htmldir)/$(KDE_LANG)/common $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kturtle/common + +uninstall-docs: + -rm -rf $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kturtle + +clean-docs: + -rm -f index.cache.bz2 + + +#>+ 13 +install-nls: + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kturtle + @for base in glossary.docbook index.docbook using-kturtle.docbook programming-reference.docbook getting-started.docbook translator-guide.docbook ; do \ + echo $(INSTALL_DATA) $$base $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kturtle/$$base ;\ + $(INSTALL_DATA) $(srcdir)/$$base $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kturtle/$$base ;\ + done + +uninstall-nls: + for base in glossary.docbook index.docbook using-kturtle.docbook programming-reference.docbook getting-started.docbook translator-guide.docbook ; do \ + rm -f $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kturtle/$$base ;\ + done + + +#>+ 5 +distdir-nls: + for file in glossary.docbook index.docbook using-kturtle.docbook programming-reference.docbook getting-started.docbook translator-guide.docbook ; do \ + cp $(srcdir)/$$file $(distdir); \ + done + +#>+ 15 +force-reedit: + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \ + && exit 0; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu docs/tdeedu/kturtle/Makefile'; \ + cd $(top_srcdir) && \ + $(AUTOMAKE) --gnu docs/tdeedu/kturtle/Makefile + cd $(top_srcdir) && perl ../scripts/admin/am_edit -p../scripts/admin docs/tdeedu/kturtle/Makefile.in + + +#>+ 21 +clean-bcheck: + rm -f *.bchecktest.cc *.bchecktest.cc.class a.out + +bcheck: bcheck-recursive + +bcheck-am: + @for i in ; do \ + if test $(srcdir)/$$i -nt $$i.bchecktest.cc; then \ + echo "int main() {return 0;}" > $$i.bchecktest.cc ; \ + echo "#include \"$$i\"" >> $$i.bchecktest.cc ; \ + echo "$$i"; \ + if ! $(CXX) $(DEFS) -I. -I$(srcdir) -I$(top_builddir) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(KDE_CXXFLAGS) --dump-class-hierarchy -c $$i.bchecktest.cc; then \ + rm -f $$i.bchecktest.cc; exit 1; \ + fi ; \ + echo "" >> $$i.bchecktest.cc.class; \ + perl $(top_srcdir)/admin/bcheck.pl $$i.bchecktest.cc.class || { rm -f $$i.bchecktest.cc; exit 1; }; \ + rm -f a.out; \ + fi ; \ + done + + +#>+ 3 +final: + $(MAKE) all-am + +#>+ 3 +final-install: + $(MAKE) install-am + +#>+ 3 +no-final: + $(MAKE) all-am + +#>+ 3 +no-final-install: + $(MAKE) install-am + +#>+ 3 +kde-rpo-clean: + -rm -f *.rpo + +#>+ 3 +nmcheck: +nmcheck-am: nmcheck diff --git a/tde-i18n-en_GB/docs/tdeedu/kturtle/getting-started.docbook b/tde-i18n-en_GB/docs/tdeedu/kturtle/getting-started.docbook new file mode 100644 index 00000000000..fb4e5045d03 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdeedu/kturtle/getting-started.docbook @@ -0,0 +1,292 @@ +<chapter id="getting-started"> +<title +>Getting Started</title> +<para +>When you start &kturtle; you will see something like this: <screenshot +> <screeninfo +>Here is a screenshot of &kturtle; when you start it for the first time</screeninfo +> <mediaobject +> <imageobject +> <imagedata fileref="mainwindow.png" format="PNG"/> </imageobject +> <textobject +> <phrase +>&kturtle; Main window</phrase +> </textobject +> </mediaobject +> </screenshot +> In this Getting Started guide we assume that the language of the &logo; commands is English. You can change this language in <menuchoice +><guimenu +>Settings</guimenu +><guimenuitem +>Configure &kturtle;...</guimenuitem +></menuchoice +> in the <guilabel +>Language</guilabel +> section. Be aware that the language you set here for &kturtle; is the one you use to type the &logo; commands.</para> + +<sect1 id="first-steps"> +<title +>First steps with &logo;: meet the Turtle!</title> +<para +>You must have noticed the turtle is in the middle of the canvas: you are just about to learn how to control it using commands in the code editor.</para> + +<sect2 id="the-turtle-moves"> +<title +>The Turtle Moves</title> +<para +>Let us start by getting the turtle moving. Our turtle can do 3 types of moves, (1) it can go forwards and backwards, (2) it can turn left and right and (3) it can go directly to a position on the screen. Try this for example:</para> +<para> +<screen +>forward 90 +turnleft 90 +</screen> +Type or copy-paste the code to the code editor and execute it (using <link linkend="file-execute" +><menuchoice +><guimenu +>File</guimenu +><guimenuitem +>Execute Commands</guimenuitem +></menuchoice +></link +>) to see the result.</para> + +<para +>When you typed and executed the commands like above in the code editor you might have noticed one or more of the following things:</para> +<orderedlist> +<listitem +><para +>That — after executing the commands — the turtle moves up, draws a line, and then turns a quarter turn to the left. This because you have used the <link linkend="forward" +><userinput +>forward</userinput +></link +> and the <link linkend="turnleft" +><userinput +>turnleft</userinput +></link +> commands.</para> +</listitem> +<listitem> +<para +>That the colour of the code changed while you where typing it: this feature is called <emphasis +>intuitive highlighting</emphasis +> — different types of commands are highlighted differently. This makes reading large blocks of code more easy.</para> +</listitem> +<listitem> +<para +>That the turtle draws a thin black line.</para> +</listitem> +<listitem> +<para +>Maybe you got an error message. This could simply mean two things: you could have made a mistake while copying the commands, or you should still set the correct language for the &logo; commands (you can do that by choosing <menuchoice +><guimenu +>Settings</guimenu +><guimenuitem +>Configure &kturtle;...</guimenuitem +></menuchoice +>, in the <guilabel +>Language</guilabel +> section).</para> +</listitem> +</orderedlist> + +<para +>You will likely understand that <userinput +>forward 90</userinput +> commanded the turtle to move forward leaving a line, and that <userinput +>turnleft 90</userinput +> commanded the turtle to turn 90 <glossterm linkend="degrees" +>degrees</glossterm +> to the left.</para> + +<para +>Please see the following links to the reference manual for a complete explanation of the new commands: <userinput +>forward</userinput +>, <userinput +>backward</userinput +>, <userinput +>turnleft</userinput +>, and <userinput +>turnright</userinput +>.</para> +</sect2> + +<sect2 id="more-examples"> +<title +>More examples</title> +<para +>The first example was very simple, so let us go on!</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 +>canvassize 200,200 +canvascolour 0,0,0 +pencolour 255,0,0 +penwidth 5 +clear + +go 20,20 +direction 135 + +forward 200 +turnleft 135 +forward 100 +turnleft 135 +forward 141 +turnleft 135 +forward 100 +turnleft 45 + +go 40, 100 +</screen> +Again you can type or copy-paste the code to the code editor or open the <filename +>arrow.logo</filename +> file in the <guimenu +>Open examples</guimenu +> folder and execute it (using <link linkend="file-execute" +><menuchoice +><guimenu +>File</guimenu +><guimenuitem +>Execute Commands</guimenuitem +></menuchoice +></link +>) to see the result. In the next examples you are expected to know the drill.</para> + +<para +>You might have noticed that this second example uses a lot more code. You have also seen a couple of new commands. Here a short explanation of all the new commands:</para> + +<para +><userinput +>canvassize 200,200</userinput +> sets the canvas width and height to 200 <glossterm linkend="pixels" +>pixels</glossterm +>. The width and the height are equal, so the canvas will be a square.</para> + +<para +><userinput +>canvascolour 0,0,0</userinput +> makes the canvas black. <userinput +>0,0,0</userinput +> is an <glossterm linkend="rgb" +>RGB-combination</glossterm +> where all values are set to <userinput +>0</userinput +>, which results in black.</para> + +<para +><userinput +>pencolor 255,0,0</userinput +> sets the color of the pen to red. <userinput +>255,0,0</userinput +> is an <glossterm linkend="rgb" +>RGB-combination</glossterm +> where only the red value is set to <userinput +>255</userinput +> (fully on) while the others (green and blue) are set to <userinput +>0</userinput +> (fully off). This results in a bright shade of red.</para> + +<para +><userinput +>penwidth 5</userinput +> sets the width (the size) of the pen to <userinput +>5</userinput +> <glossterm linkend="pixels" +>pixels</glossterm +>. From now on every line the turtle draw will have a thickness of <userinput +>5</userinput +>, until we change the <userinput +>penwidth</userinput +> to something else.</para> + +<para +><userinput +>clear</userinput +> clear the canvas, that is all it does.</para> + +<para +><userinput +>go 20,20</userinput +> commands the turtle to go to a certain place on the canvas. Counted from the upper left corner, this place is 20 <glossterm linkend="pixels" +>pixels</glossterm +> across from the left, and 20 <glossterm linkend="pixels" +>pixels</glossterm +> down from the top of the canvas. Note that using the <userinput +>go</userinput +> command the turtle will not draw a line.</para> + +<para +><userinput +>direction 135</userinput +> set the turtle's direction. The <userinput +>turnleft</userinput +> and <userinput +>turnright</userinput +> commands change the turtle's angle starting from its current direction. The <userinput +>direction</userinput +> command changes the turtle's angle from zero, and thus is not relative to the turtle previous direction.</para> + +<para +>After the <userinput +>direction</userinput +> command a lot of <userinput +>forward</userinput +> and <userinput +>turnleft</userinput +> commands follow. These command do the actual drawing.</para> + +<para +>At last another <userinput +>go</userinput +> command is used to move the turtle aside.</para> + +<para +>Make sure you follow the links to the reference. The reference explains each command more thoroughly.</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>
\ No newline at end of file diff --git a/tde-i18n-en_GB/docs/tdeedu/kturtle/glossary.docbook b/tde-i18n-en_GB/docs/tdeedu/kturtle/glossary.docbook new file mode 100644 index 00000000000..22af4ab935a --- /dev/null +++ b/tde-i18n-en_GB/docs/tdeedu/kturtle/glossary.docbook @@ -0,0 +1,406 @@ +<chapter id="Glossary"> +<title +>Glossary</title> + +<para +>In this chapter you will find an explanation of most of the <quote +>uncommon</quote +> words that are used in the handbook.</para> + +<glosslist> +<glossentry id="degrees"> +<glossterm +>degrees</glossterm> +<glossdef +><para +>Degrees are units to measure angles or turns. A full turn is 360 degrees, a half turn 180 degrees and a quarter turn 90 degrees. The commands <userinput +>turnleft</userinput +>, <userinput +>turnright</userinput +> and <userinput +>direction</userinput +> need an input in degrees.</para +></glossdef> +</glossentry> + +<glossentry id="input-output"> +<glossterm +>input and output of commands</glossterm> +<glossdef +><para +>Some commands take input, some commands give output, some commands take input <emphasis +>and</emphasis +> give output and some commands neither take input nor give output.</para> +<para +>Some examples of commands that only take input are: <screen> +forward 50 +pencolour 255,0,0 +print "Hello!" +</screen +> The <userinput +>forward</userinput +> command takes <userinput +>50</userinput +> as input. <userinput +>forward</userinput +> needs this input to know how many <glossterm linkend="pixels" +>pixels</glossterm +> it should go forward. <userinput +>pencolor</userinput +> takes a colour as input and <userinput +>print</userinput +> takes a string (a piece of text) as input. Please note that the input can also be a container. The next example illustrates this: <screen +>x = 50 +print x +str = "hello!" +print str +</screen +></para> + +<para +>Now some examples of commands that give output: <screen> +x = inputwindow "Please type something and press OK... thanks!" +r = random 1,100 +</screen +> The <userinput +>inputwindow</userinput +> command takes a string as input, and outputs the number or string that is entered. As you can see, the output of <userinput +>inputwindow</userinput +> is stored in the container <userinput +>x</userinput +>. The <userinput +>random</userinput +> command also gives output. In this case it outputs a number between 1 and 100. The output of the random is again stored in a container, named <userinput +>r</userinput +>. Note that the containers <userinput +>x</userinput +> and <userinput +>r</userinput +> are not used in the example code above.</para> + +<para +>There are also commands that neither need input nor give output. Here are some examples: <screen +>clear +penup +wrapon +hide +</screen> +</para +></glossdef> +</glossentry> + +<glossentry id="intuitive-highlighting"> +<glossterm +>intuitive highlighting</glossterm> +<glossdef +><para +>This is a feature of &kturtle; that makes coding even easier. With intuitive highlighting the code that you write gets a colour that indicates what type of code it is. In the next list you will find the different types of code and the colour they get in <link linkend="the-code-editor" +>the code editor</link +>. <table> +<title +>Different types of code and their highlight colour</title> +<tgroup cols="3"> +<tbody> +<row> +<entry +>regular commands</entry> +<entry +>dark green</entry> +<entry +>The regular commands are described <link linkend="commands" +>here</link +>.</entry> +</row> +<row> +<entry +>execution controllers</entry> +<entry +>black (bold)</entry> +<entry +>The special commands control execution, read more on them <link linkend="controlling-execution" +>here</link +>.</entry> +</row> +<row> +<entry +>comments</entry> +<entry +>dark yellow</entry> +<entry +>Lines that are commented start with a comment characters (#). These lines are ignored when the code is executed. Comments allow the programmer to explain a bit about his code or can be used to temporarily prevent a certain piece of code from executing.</entry> +</row> +<row> +<entry +>brackets [, ]</entry> +<entry +>light green (bold)</entry> +<entry +>Brackets are used to group portions of code. Brackets are often used together with <link linkend="controlling-execution" +>execution controllers</link +>.</entry> +</row> +<row> +<entry +>the <link linkend="learn" +>learn</link +> command</entry> +<entry +>light green (bold)</entry> +<entry +>The <link linkend="learn" +>learn</link +> command is used to create new commands.</entry> +</row> +<row> +<entry +>numbers</entry> +<entry +>blue</entry> +<entry +>Numbers, well not much to say about them.</entry> +</row> +<row> +<entry +>strings</entry> +<entry +>dark red</entry> +<entry +>Not much to say about (text) strings either, except that they always start and end with the double quotes (").</entry> +</row> +<row> +<entry +>mathematical characters</entry> +<entry +>grey</entry> +<entry +>These are the mathematical characters: +, -, *, /, (, and ). Read more about them <link linkend="math" +>here</link +>.</entry> +</row> +<row> +<entry +>questions characters</entry> +<entry +>blue (bold)</entry> +<entry +>Read more about questions <link linkend="questions" +>here</link +>.</entry> +</row> +<row> +<entry +>question glue-words</entry> +<entry +>pink</entry> +<entry +>Read more about the question glue-words (and, or, not) <link linkend="question-glue" +>here</link +>.</entry> +</row> +<row> +<entry +>regular text</entry> +<entry +>black</entry> +<entry +></entry> +</row> +</tbody> +</tgroup> +</table> +</para +></glossdef> +</glossentry> + +<glossentry id="pixels"> +<glossterm +>pixels</glossterm> +<glossdef +><para +>A pixel is a dot on the screen. If you look very close you will see that the screen of your monitor uses pixels. All images on the screen are built with these pixels. A pixel is the smallest thing that can be drawn on the screen.</para> +<para +>A lot of commands need a number of pixels as input. These commands are: <userinput +>forward</userinput +>, <userinput +>backward</userinput +>, <userinput +>go</userinput +>, <userinput +>gox</userinput +>, <userinput +>goy</userinput +>, <userinput +>canvassize</userinput +> and <userinput +>penwidth</userinput +>.</para +></glossdef> +</glossentry> + +<glossentry id="rgb"> +<glossterm +>RGB combinations (colour codes)</glossterm> +<glossdef +><para +>RGB combinations are used to describe colours. The <quote +>R</quote +> stand for <quote +>red</quote +>, the <quote +>G</quote +> stands for <quote +>green</quote +> and the <quote +>B</quote +> stands for <quote +>blue</quote +>. An example of an RGB combination is <userinput +>255,0,0</userinput +>: the first value (<quote +>red</quote +>) is 255 and the others are 0, so this represents a bright shade of red. Each value of an RGB combination has to be in the range 0 to 255. Here a small list of some often used colours: <table frame="none"> +<title +>Often used RGB combinations</title> +<tgroup cols="2" colsep="5" rowsep="1"> +<colspec colname="c1"/> +<tbody> +<row +><entry +><userinput +>0,0,0</userinput +></entry +><entry +>black</entry +></row> +<row +><entry +><userinput +>255,255,255</userinput +></entry +><entry +>white</entry +></row> +<row +><entry +><userinput +>255,0,0</userinput +></entry +><entry +>red</entry +></row> +<row +><entry +><userinput +>150,0,0</userinput +></entry +><entry +>dark red</entry +></row> +<row +><entry +><userinput +>0,255,0</userinput +></entry +><entry +>green</entry +></row> +<row +><entry +><userinput +>0,0,255</userinput +></entry +><entry +>blue</entry +></row> +<row +><entry +><userinput +>0,255,255</userinput +></entry +><entry +>light blue</entry +></row> +<row +><entry +><userinput +>255,0,255</userinput +></entry +><entry +>pink</entry +></row> +<row +><entry +><userinput +>255,255,0</userinput +></entry +><entry +>yellow</entry +></row> +</tbody> +</tgroup> +</table> +</para> +<para +>To easily find the RGB combinations of a colour you should try the colour picker! You can open the colour picker using <link linkend="tools-color-picker" +><menuchoice +><guimenu +>Tools</guimenu +><guimenuitem +>Colour Picker</guimenuitem +></menuchoice +></link +>.</para> +<para +>Two commands need an RGB combination as input: these commands are <userinput +>canvascolour</userinput +> and <userinput +>pencolour</userinput +>.</para +></glossdef> +</glossentry> + +<glossentry id="sprite"> +<glossterm +>sprite</glossterm> +<glossdef +><para +>A sprite is a small picture that can be moved around the screen. Our beloved turtle, for instance, is a sprite.</para> +<para +>Note: with this version of &kturtle; the sprite cannot be changed from a turtle into something else. Future versions of &kturtle; will be able to do this.</para +></glossdef> +</glossentry> + +<glossentry id="wrapping"> +<glossterm +>wrapping</glossterm> +<glossdef +><para +>Wrapping is what happens when the turtle draws something that is to big to fix in on the canvas and wrapping is set <quote +>on</quote +>. <screenshot +> <screeninfo +>This is what happens when wrapping is <quote +>on</quote +></screeninfo +> <mediaobject +> <imageobject +> <imagedata fileref="wrapping.png" format="PNG"/> </imageobject +> <textobject +> <phrase +>An example of wrapping</phrase +> </textobject +> </mediaobject +> </screenshot +> When the turtle moves off a border of the canvas it is instantly taken to the opposite border so it can continue its move. This way the turtle will always stay on the screen while it moves. This happens when wrapping is on.</para> +<para +>Wrapping can be turned on and off with the <userinput +>wrapon</userinput +> and <userinput +>wrapoff</userinput +> commands. When &kturtle; starts wrapping is turned on by default.</para +></glossdef> +</glossentry> + +</glosslist> + +</chapter>
\ No newline at end of file diff --git a/tde-i18n-en_GB/docs/tdeedu/kturtle/index.cache.bz2 b/tde-i18n-en_GB/docs/tdeedu/kturtle/index.cache.bz2 Binary files differnew file mode 100644 index 00000000000..966f31c3551 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdeedu/kturtle/index.cache.bz2 diff --git a/tde-i18n-en_GB/docs/tdeedu/kturtle/index.docbook b/tde-i18n-en_GB/docs/tdeedu/kturtle/index.docbook new file mode 100644 index 00000000000..4a23baed449 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdeedu/kturtle/index.docbook @@ -0,0 +1,305 @@ +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ + <!ENTITY kturtle "KTurtle"> + <!ENTITY kapp "&kturtle;" +><!-- replace kturtle here --> + <!ENTITY kappname "&kturtle;"> + <!ENTITY package "tdeedu"> + <!ENTITY logo "Logo"> + <!ENTITY % addindex "IGNORE"> + <!ENTITY % British-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 # showroommama ! nl</email +></address> +</affiliation> +</author> +<author +><firstname +>Anne-Marie</firstname +> <surname +>Mahfouf</surname +> <affiliation +> <address +><email +>annma@kde.org</email +></address> +</affiliation> +</author> +</authorgroup> + +<othercredit role="translator" +><firstname +>Andrew</firstname +><surname +>Coles</surname +><affiliation +><address +><email +>andrew_coles@yahoo.co.uk</email +></address +></affiliation +><contrib +>Conversion to British English</contrib +></othercredit +> + +<copyright> +<year +>2004</year> +<holder +>Cies Breijs</holder> +</copyright> + +<legalnotice +>&FDLNotice;</legalnotice> + +<date +>2004-10-5</date> +<releaseinfo +>0.2.1</releaseinfo> + +<abstract> +<para +>&kturtle; is an educational programming environment using the &logo; programming language. </para> +</abstract> + +<keywordset> +<keyword +>KDE</keyword> +<keyword +>tdeedu</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 &logo; programming language. It tries to make programming as easy and accessible as possible. This makes &kturtle; suitable for teaching kids the basics of maths, geometry and... programming. The commands used to program are in the style of the &logo; programming language. The unique feature of &logo; 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 +>MacLogo</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, so no need to download any other program. </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 +>Context help for all &logo; commands: Just press <keysym +>F1</keysym +>. </para +></listitem> +<listitem +><para +>The &logo; commands are fully translatable (currently only English, Dutch, French, German and Swedish are supported). </para +></listitem> +<listitem +><para +>Full-screen mode. </para +></listitem> +<listitem +><para +>Many integrated, internationalised 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 Licence</title> + +<para +>&kturtle; </para> +<para +>Program copyright 2003-2004 Cies Breijs <email +>cies # showroommama ! nl</email +></para> +<para +>Contributors: <itemizedlist> +<listitem +><para +>Coding help, editor part: Anne-Marie Mahfouf <email +>annma@kde.org</email +></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.Schreppers@ua.ac.be</email +></para> +</listitem> +<listitem +><para +>German Data Files: Matthias Meßmer <email +>bmlmessmer@web.de</email +></para> +</listitem> +<listitem +><para +>Swedish Data Files: Stefan Asserhäll <email +>stefan.asserhal@telia.com</email +></para> +</listitem> +</itemizedlist> +</para> + +<para +>Documentation copyright 2004 <itemizedlist> +<listitem +><para +>Cies Briej <email +>cies # showroommama ! nl</email +> </para +></listitem> +<listitem +><para +>Anne-Marie Mahfouf <email +>annma@kde.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@yahoo.co.uk</email +></para> +</listitem> + +</itemizedlist> +</para> +<para +>Andrew Coles<email +>andrew_coles@yahoo.co.uk</email +></para +> +&underFDL; &underGPL; </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: +-->
\ No newline at end of file diff --git a/tde-i18n-en_GB/docs/tdeedu/kturtle/programming-reference.docbook b/tde-i18n-en_GB/docs/tdeedu/kturtle/programming-reference.docbook new file mode 100644 index 00000000000..5e459b562f1 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdeedu/kturtle/programming-reference.docbook @@ -0,0 +1,1209 @@ +<chapter id="reference"> +<title +>&kturtle;'s &logo; Programming Reference</title> + +<sect1 id="commands"> +<title +>Commands</title> +<para +>Using commands you tell the turtle or &kturtle; to do something. Some commands need input, some give output. In this section we explain all the commands that can be used in &kturtle;.</para> + +<sect2 id="moving-the-turtle"> +<title +>Moving the turtle</title> +<para +>There are several commands to move the turtle over the screen.</para> + + <variablelist> + <anchor id="forward"/> + <varlistentry> + <term +>forward</term> + <listitem +><para +><screen +>forward X</screen> +<userinput +>forward</userinput +> moves the turtle forward by the amount of X pixels. When the pen is down the turtle will leave a trail. <userinput +>forward</userinput +> can be abbreviated to <userinput +>fw</userinput +></para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="backward"/> + <varlistentry> + <term +>backward</term> + <listitem +><para +><screen +>backward X</screen> +<userinput +>backward</userinput +> moves the turtle backward by the amount of X pixels. When the pen is down the turtle will leave a trail. <userinput +>backward</userinput +> can be abbreviated to <userinput +>bw</userinput +>.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="turnleft"/> + <varlistentry> + <term +>turnleft</term> + <listitem +><para +><screen +>turnleft X</screen> +<userinput +>turnleft</userinput +> commands the turtle to turn an amount of X degrees to the left. <userinput +>turnleft</userinput +> can be abbreviated to <userinput +>tl</userinput +>.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="turnright"/> + <varlistentry> + <term +>turnright</term> + <listitem +><para +><screen +>turnright X</screen> +<userinput +>turnright</userinput +>the turtle to turn an amount of X degrees to the right. <userinput +>turnright</userinput +> can be abbreviated to <userinput +>tr</userinput +>.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="direction"/> + <varlistentry> + <term +>direction</term> + <listitem +><para +><screen +>direction X</screen> +<userinput +>direction</userinput +> set the turtle's direction to an amount of X degrees counting from zero, and thus is not relative to the turtle's previous direction. <userinput +>direction</userinput +> can be abbreviated to <userinput +>dir</userinput +>.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="center"/> + <varlistentry> + <term +>centre</term> + <listitem +><para +><screen +>centre</screen> +<userinput +>centre</userinput +> moves the turtle to the centre on the canvas.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="go"/> + <varlistentry> + <term +>go</term> + <listitem +><para +><screen +>go X,Y</screen> +<userinput +>go</userinput +> commands the turtle to go to a certain place on the canvas. This place is X <glossterm linkend="pixels" +>pixels</glossterm +> from the left of the canvas, and Y <glossterm linkend="pixels" +>pixels</glossterm +> form the top of the canvas. Note that using the <userinput +>go</userinput +> command the turtle will not draw a line.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="gox"/> + <varlistentry> + <term +>gox</term> + <listitem +><para +><screen +>gox X</screen> +<userinput +>gox</userinput +> using this command the turtle will move to X <glossterm linkend="pixels" +>pixels</glossterm +> from the left of the canvas whilst staying at the same height.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="goy"/> + <varlistentry> + <term +>goy</term> + <listitem +><para +><screen +>goy Y</screen> +<userinput +>gox</userinput +> using this command the turtle will move to Y <glossterm linkend="pixels" +>pixels</glossterm +> from the top of the canvas whilst staying at the same distance from the left border of the canvas.</para +></listitem> + </varlistentry> + </variablelist> +</sect2> + +<sect2 id="pen"> +<title +>The turtle has a pen</title> +<para +>The turtle has a pen that draws a line when the turtle moves. There are a few commands to control the pen. In this section we explain these commands.</para> + <variablelist> + <anchor id="penup"/> + <varlistentry> + <term +>penup</term> + <listitem +><para +><screen +>penup</screen> +<userinput +>penup</userinput +> lifts the pen from the canvas. When the pen is <quote +>up</quote +> no line will be drawn when the turtle moves. See also <userinput +>pendown</userinput +>. <userinput +>penup</userinput +> can be abbreviated to <userinput +>pu</userinput +>.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="pendown"/> + <varlistentry> + <term +>pendown</term> + <listitem +><para +><screen +>pendown</screen> +<userinput +>pendown</userinput +> presses the pen down on the canvas. When the pen is press <quote +>down</quote +> on the canvas a line will be drawn when the turtle moves. See also <userinput +>penup</userinput +>.<userinput +>pendown</userinput +> can be abbreviated to <userinput +>pd</userinput +>.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="penwidth"/> + <varlistentry> + <term +>penwidth</term> + <listitem +><para +><screen +>penwidth X</screen> +<userinput +>penwidth</userinput +> sets the width of the pen (the line width) to an amount of X <glossterm linkend="pixels" +>pixels</glossterm +>. <userinput +>penwidth</userinput +> can be abbreviated to <userinput +>pw</userinput +>.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="pencolor"/> + <varlistentry> + <term +>pencolour</term> + <listitem +><para +><screen +>pencolour R,G,B</screen> +<userinput +>pencolor</userinput +> sets the color of the pen. <userinput +>pencolor</userinput +> takes an <glossterm linkend="rgb" +>RGB combination</glossterm +> as input. <userinput +>pencolor</userinput +> can be abbreviated to <userinput +>pc</userinput +>.</para +></listitem> + </varlistentry> + </variablelist> +</sect2> + +<sect2 id="canvas"> +<title +>Commands to control the canvas</title> +<para +>There are several commands to control the canvas.</para> + <variablelist> + <anchor id="canvassize"/> + <varlistentry> + <term +>canvassize</term> + <listitem +><para +><screen +>canvassize X,Y</screen> +With the <userinput +>canvassize</userinput +> command you can set the size of the canvas. It takes X and Y as input, where X is the new canvas width in <glossterm linkend="pixels" +>pixels</glossterm +>, and Y is the new height of the canvas in <glossterm linkend="pixels" +>pixels</glossterm +>. <userinput +>canvassize</userinput +> can be abbreviated to <userinput +>cs</userinput +>.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="canvascolor"/> + <varlistentry> + <term +>canvascolour</term> + <listitem +><para +><screen +>canvascolour R,G,B</screen> +<userinput +>canvascolor</userinput +> set the color of the canvas. <userinput +>canvascolor</userinput +> takes an <glossterm linkend="rgb" +>RGB combination</glossterm +> as input. <userinput +>canvascolor</userinput +> can be abbreviated to <userinput +>cc</userinput +>.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="wrapon"/> + <varlistentry> + <term +>wrapon</term> + <listitem +><para +><screen +>wrapon</screen> +With the <userinput +>wrapon</userinput +> command you can set <glossterm linkend="wrapping" +>wrapping</glossterm +> <quote +>on</quote +> for the canvas. Please see the glossary if you want to know what <glossterm linkend="wrapping" +>wrapping</glossterm +> is.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="wrapoff"/> + <varlistentry> + <term +>wrapoff</term> + <listitem +><para +><screen +>wrapoff</screen> +With the <userinput +>wrapoff</userinput +> command you can set <glossterm linkend="wrapping" +>wrapping</glossterm +> <quote +>off</quote +> for the canvas: this means the turtle can move off the canvas and can get <quote +>lost</quote +>. Please see the glossary if you want to know what <glossterm linkend="wrapping" +>wrapping</glossterm +> is.</para +></listitem> + </varlistentry> + </variablelist> +</sect2> + +<sect2 id="clean"> +<title +>Commands to clean up</title> +<para +>There are two commands to clean up the canvas after you have made a mess.</para> + <variablelist> + <anchor id="clear"/> + <varlistentry> + <term +>clear</term> + <listitem +><para +><screen +>clear</screen> +With <userinput +>clear</userinput +> you can clean all drawings from the canvas. All other things remain: the position and angle of the turtle, the canvascolor, the visibility of the turtle, and the canvas size. <userinput +>clear</userinput +> can be abbreviated to <userinput +>ccl</userinput +>.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="reset"/> + <varlistentry> + <term +>reset</term> + <listitem +><para +><screen +>reset</screen> +<userinput +>reset</userinput +> cleans much more thoroughly than the <userinput +>clear</userinput +> command. After a <userinput +>reset</userinput +> command everything is like is was when you had just started &kturtle;. The turtle is positioned at the middle of the screen, the canvas color is white, and the turtle draws a black line on the canvas.</para +></listitem> + </varlistentry> + </variablelist> +</sect2> + +<sect2 id="sprites"> +<title +>The turtle is a sprite</title> +<para +>Many people do not know what sprites are, so here a short explanation: sprites are small pictures that can be moved around the screen. (for more info see the glossary on <glossterm linkend="sprites" +>sprites</glossterm +>). So the turtle is a sprite.</para> +<para +>Next you will find a full overview on all commands to work with sprites.</para> +<para +>[The current version of &kturtle; does not yet support the use of sprites other than the turtle. With future versions you will be able to change the turtle into something of your own design]</para> + <variablelist> + <anchor id="show"/> + <varlistentry> + <term +>show</term> + <listitem +><para +><screen +>show</screen> +<userinput +>show</userinput +> makes the turtle visible again after it has been hidden.<userinput +>show</userinput +> can be abbreviated to <userinput +>ss</userinput +>.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="hide"/> + <varlistentry> + <term +>hide</term> + <listitem +><para +><screen +>hide</screen> +<userinput +>hide</userinput +> hides the turtle. This can be used if the turtle does not fit in your drawing.<userinput +>hide</userinput +> can be abbreviated to <userinput +>sh</userinput +>.</para +></listitem> + </varlistentry> + </variablelist> +</sect2> + +<sect2 id="writing"> +<title +>Can the turtles write text?</title> +<para +>The answer is: <quote +>yes</quote +>. The turtle can write: it writes just about everything you command it to.</para> + <variablelist> + <anchor id="print"/> + <varlistentry> + <term +>print</term> + <listitem +><para +><screen +>print X</screen> +The <userinput +>print</userinput +> command is used to command the turtle to write something on the canvas. <userinput +>print</userinput +> takes numbers and strings as input. You can <userinput +>print</userinput +> various numbers and strings using the <quote +>+</quote +> symbol. See here a small example: <screen +>year = 2004 +author = "Cies" +print "KTurtle was made in " + year + " by " + author +</screen> + </para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="fontsize"/> + <varlistentry> + <term +>fontsize</term> + <listitem +><para +><screen +>fontsize X</screen> +<userinput +>fontsize</userinput +> sets the size of the font that is used by <userinput +>print</userinput +>. <userinput +>fontsize</userinput +> takes one input which should be a number. The size is set in <glossterm linkend="pixels" +>pixels</glossterm +>.</para +></listitem> + </varlistentry> + </variablelist> +</sect2> + +<sect2 id="dice"> +<title +>A command that rolls a dice for you</title> +<para +>There is one command that rolls a dice for you</para> + <variablelist> + <anchor id="random"/> + <varlistentry> + <term +>random</term> + <listitem +><para +><screen +>random X,Y</screen> +<userinput +>random</userinput +> is a command that takes input and gives output. As input are required two numbers, the first (X) sets the minimum output, the second (Y) sets the maximum. The output is a randomly chosen number that is equal or greater then the minimum and equal or smaller than the maximum. Here a small example: <screen> +repeat 500 [ + x = random 1,20 + forward x + turnleft 10 - x +] +</screen +> Using the <userinput +>random</userinput +> command you can add a bit of chaos to your program.</para +></listitem> + </varlistentry> + </variablelist> +</sect2> +</sect1> + +<sect1 id="containers"> +<title +>Containers</title> +<para +>Containers are letters or words that can be used by the programmer to store a number or a text. Containers that contain a number are called <link linkend="variables" +>variables</link +>, containers that can contain text are called <link linkend="strings" +>strings</link +>.</para> + +<para +>Containers that are not used yet are 0 by default. An example: <screen> +print N +</screen +> This will print a 0. </para> + +<sect2 id="variables"> +<title +>Variables: number containers</title> +<para +>Let us start with an example: <screen> +x = 3 +print x +</screen +> In the first line the letter <userinput +>x</userinput +> made into a variable (number container). As you see the value of the variable <userinput +>x</userinput +> is set to 3. On the second line the value is printed.</para> +<para +>Note that if we wanted to print an <quote +>x</quote +> that we should have written <screen +>print "x" +</screen> +</para> +<para +>That was easy, now a bit harder example: <screen> +A = 2004 +B = 25 +AB = A + B + +# the next command prints "2029" +print AB +backward 30 +# the next command prints "2004 plus 25" +print "" + A + " plus " + B +backward 30 +# the next command prints "1979" +print A - B +</screen +> In the first two lines the variables <userinput +>A</userinput +> and <userinput +>B</userinput +> are set to 2004 and 25. On the third line the variable <userinput +>AB</userinput +> is set to <userinput +>A + B</userinput +>, which is 2029. The rest of the example consists of 3 <userinput +>print</userinput +> commands with <userinput +>backward 30</userinput +> in between. The <userinput +>backward 30</userinput +> is there to make sure every output is on a new line. In this example you also see that variables can be used in <link linkend="math" +>mathematical calculations</link +>.</para> +</sect2> + +<sect2 id="strings"> +<title +>Strings: text containers</title> +<para +>Strings are a lot like variables. The biggest difference is that strings cannot be used in <link linkend="math" +>mathematical calculations</link +> and <link linkend="questions" +>questions</link +>. An example of the use of strings: <screen> +x = "Hello " +name = inputwindow "Please enter your name..." +print x + name + ", how are you?" +</screen +> On the first line the string <userinput +>x</userinput +> is set to <quote +>Hello </quote +>. On the second line the string <userinput +>name</userinput +> is set to the output of the <userinput +>inputwindow</userinput +> command. On the third line the program prints a composition of three strings on the canvas.</para> +<para +>This program ask you to enter your name. When you, for instance, enter the name <quote +>Paul</quote +>, the program prints <quote +>Hello Paul, how are you?</quote +>. Please note that the plus (+) is the only math symbol that you can use with strings.</para> +</sect2> +</sect1> + +<sect1 id="math"> +<title +>Can the Turtle do maths?</title> +<para +>Yes, &kturtle; will do your math. You can add (+), substract (-), multiply (*), and divide (/). Here is an example in which we use all of them: <screen> +a = 20 - 5 +b = 15 * 2 +c = 30 / 30 +d = 1 + 1 +print "a: "+a+", b: "+b+", c: "+c+", d: "+d +</screen +> Do you know what value a, b, c and d have?</para> +<para +>If you just want a simple calculation to be done you can do something like this: <screen +>print 2004-12 +</screen +></para> +<para +>Now an example with brackets: <screen> +print ( ( 20 - 5 ) * 2 / 30 ) + 1 +</screen +> The expressions inside brackets will be calculated first. In this example, 20-5 will be calculated, then multiplied by 2, divided by 30, and then 1 is added (giving 2).</para> +</sect1> + +<sect1 id="questions"> +<title +>Asking questions, getting answers...</title> +<para +><link linkend="if" +><userinput +>if</userinput +></link +> and <link linkend="while" +><userinput +>while</userinput +></link +> are <link linkend="controlling-execution" +>execution controllers</link +> that we will discuss in the next section. In this section we use the <userinput +>if</userinput +> command to explain questions.</para> +<para +>A simple example of questions: <screen> +x = 6 +if x > 5 [ + print "hello" +] +</screen +> In this example the question is the <userinput +>x > 5</userinput +> part. If the answer to this question is <quote +>true</quote +> the code between the brackets will be executed. Questions are an important part of programming and often used together with <link linkend="controlling-execution" +>execution controllers</link +>, like <link linkend="if" +><userinput +>if</userinput +></link +>. All numbers and <link linkend="variables" +>variables</link +> (number containers) can be compared to each other with questions.</para> +<para +>Here are all possible questions: <table> +<title +>Types of questions</title> +<tgroup cols="3"> +<tbody> +<row> +<entry +><userinput +>a == b</userinput +></entry> +<entry +>equals</entry> +<entry +>answer is <quote +>true</quote +> if <userinput +>a</userinput +> equals <userinput +>b</userinput +></entry> +</row> +<row> +<entry +><userinput +>a != b</userinput +></entry> +<entry +>not-equal</entry> +<entry +>answer is <quote +>true</quote +> if <userinput +>a</userinput +> does not equal <userinput +>b</userinput +></entry> +</row> +<row> +<entry +><userinput +>a > b</userinput +></entry> +<entry +>greater than</entry> +<entry +>answer is <quote +>true</quote +> if <userinput +>a</userinput +> is greater than <userinput +>b</userinput +></entry> +</row> +<row> +<entry +><userinput +>a < b</userinput +></entry> +<entry +>smaller than</entry> +<entry +>answer is <quote +>true</quote +> if <userinput +>a</userinput +> is smaller than <userinput +>b</userinput +></entry> +</row> +<row> +<entry +><userinput +>a >= b</userinput +></entry> +<entry +>greater than or equals</entry> +<entry +>answer is <quote +>true</quote +> if <userinput +>a</userinput +> is greater than or equals <userinput +>b</userinput +></entry> +</row> +<row> +<entry +><userinput +>a <= b</userinput +></entry> +<entry +>smaller than or equals</entry> +<entry +>answer is <quote +>true</quote +> if <userinput +>a</userinput +> is smaller than or equals <userinput +>b</userinput +></entry> +</row> +</tbody> +</tgroup> +</table> +</para> +<para +>Questions can also be glued to each other with <quote +>question glue</quote +>, this way a few questions can become one big question. <screen> +a = 1 +b = 5 +if a < 5 and b == 5 [ + print "hello" +] +</screen +> <anchor id="question-glue"/>In this example the glue-word <userinput +>and</userinput +> is used to glue 2 questions (<userinput +>a < 5</userinput +>, <userinput +>b == 5</userinput +>) together. If one side of the <userinput +>and</userinput +> would answer <quote +>false</quote +> the whole question would answer <quote +>false</quote +>, because with the glue-word <userinput +>and</userinput +> both sides need to be <quote +>true</quote +> in order to answer <quote +>true</quote +>.</para> +<para +><userinput +>and</userinput +> is not the only glue-word there are two others. They are all in the next table: <table> +<title +>Question glue-words</title> +<tgroup cols="2"> +<tbody> +<row> +<entry +><userinput +>and</userinput +></entry> +<entry +>both sides need to be <quote +>true</quote +> in order to answer <quote +>true</quote +></entry> +</row> +<row> +<entry +><userinput +>or</userinput +></entry> +<entry +>if one of the sides is <quote +>true</quote +> the answer is <quote +>true</quote +></entry> +</row> +<row> +<entry +><userinput +>not</userinput +></entry> +<entry +>only if both of the sides are <quote +>false</quote +> the answer is <quote +>false</quote +></entry> +</row> +</tbody> +</tgroup> +</table> +</para> +</sect1> + +<sect1 id="controlling-execution"> +<title +>Controlling execution</title> +<para +>The execution controllers enable you — as their name implies — to control execution.</para> + +<sect2 id="easy"> +<title +>Have the turtle wait</title> +<para +>If you have done some programming in &kturtle; you have might noticed that the turtle can be very quick at drawing. This command makes the turtle wait for a given amount of time.</para> + <variablelist> + <anchor id="wait"/> + <varlistentry> + <term +>wait</term> + <listitem +><para +><screen +>wait X</screen> +<userinput +>wait</userinput +> makes the turtle wait for X seconds. <screen> +repeat 36 [ + forward 5 + turnright 10 + wait 0.5 +] +</screen +> This code draws a circle, but the turtle will wait half a second after each step. This gives the impression of a slow-moving turtle.</para +></listitem> + </varlistentry> + </variablelist> +</sect2> + +<sect2 id="execute-if"> +<title +>Execute "if"</title> +<para +></para> + <variablelist> + <anchor id="if"/> + <varlistentry> + <term +>if</term> + <listitem +><para +><screen +>if <link linkend="questions" +>question</link +> [ ... ]</screen> +The code that is placed between the brackets will only be executed <userinput +>if</userinput +> the answer to the <link linkend="questions" +>question</link +> is <quote +>true</quote +>. Please read for more information on <link linkend="questions" +>questions</link +> in the <link linkend="questions" +>question section</link +>. <screen> +x = 6 +if x > 5 [ + print "x is greater than five!" +] +</screen +> On the first line <userinput +>x</userinput +> is set to 6. On the second line the <link linkend="questions" +>question</link +> <userinput +>x > 5</userinput +> is asked. Since the answer to this question is <quote +>true</quote +> the execution controller <userinput +>if</userinput +> will allow the code between the brackets to be executed</para +></listitem> + </varlistentry> + </variablelist> +</sect2> + +<sect2 id="execute-while"> +<title +>Execute "while"</title> +<para +></para> + <variablelist> + <anchor id="while"/> + <varlistentry> + <term +>while</term> + <listitem +><para +><screen +>while <link linkend="questions" +>question</link +> [ ... ]</screen> +The execution controller <userinput +>while</userinput +> is a lot like <link linkend="if" +><userinput +>if</userinput +></link +>. The difference is that <userinput +>while</userinput +> keeps repeating the code between the brackets till the answer to the <link linkend="questions" +>question</link +> is <quote +>false</quote +>. <screen> +x = 1 +while x < 5 [ + forward 10 + wait 1 + x = x + 1 +] +</screen +> On the first line <userinput +>x</userinput +> is set to 1. On the second line the <link linkend="questions" +>question</link +> <userinput +>x < 5</userinput +> is asked. Since the answer to this question is <quote +>true</quote +> the execution controller <userinput +>while</userinput +> starts executing the code between the brackets till the answer to the <link linkend="questions" +>question</link +> is <quote +>false</quote +>. In this case the code between the brackets will be executed 4 times, because every time the fifth line is executed <userinput +>x</userinput +> increases by 1..</para +></listitem> + </varlistentry> + </variablelist> +</sect2> + +<sect2 id="if-else"> +<title +>If not, in other words: "else"</title> +<para +></para> + <variablelist> + <anchor id="else"/> + <varlistentry> + <term +>else</term> + <listitem +><para +><screen +>if question [ ... ] else [ ... ]</screen> +<userinput +>else</userinput +> can be used in addition to the execution controller <link linkend="if" +><userinput +>if</userinput +></link +>. The code between the brackets after <userinput +>else</userinput +> is only executed if the answer to the <link linkend="questions" +>question</link +> that is asked is <quote +>false</quote +>. <screen> +x = 4 +if x > 5 [ + print "x is greater than five!" +] else [ + print "x is smaller than six!" +] +</screen +> The <link linkend="questions" +>question</link +> asks if <userinput +>x</userinput +> is greater than 5. Since <userinput +>x</userinput +> is set to 4 on the first line the answer to the question is <quote +>false</quote +>. This means the code between the brackets after <userinput +>else</userinput +> gets executed.</para +></listitem> + </varlistentry> + </variablelist> +</sect2> + +<sect2 id="for-loop"> +<title +>The "for" loop</title> +<para +></para> + <variablelist> + <anchor id="for"/> + <varlistentry> + <term +>for</term> + <listitem +><para +><screen +>for <userinput +>start point</userinput +> to <userinput +>end point</userinput +> [ ... ]</screen> +The <userinput +>for</userinput +> loop is a <quote +>counting loop</quote +>, &ie; it keeps count for you. <screen> +for x = 1 to 10 [ + print x * 7 + forward 15 +] +</screen +> Every time the code between the brackets is executed the <userinput +>x</userinput +> is increased by 1, till <userinput +>x</userinput +> reaches the value of 10. The code between the brackets prints the <userinput +>x</userinput +> multiplied by 7. After this program finishes its execution you will see the times table of 7 on the canvas.</para +></listitem> + </varlistentry> + </variablelist> +</sect2> + +</sect1> + + +<sect1 id="learn"> +<title +>Create your own commands</title> +<para +><userinput +>learn</userinput +> is a very special command, because it is used to create your own commands. The command you create can take <glossterm linkend="input-output" +>input</glossterm +> and return <glossterm linkend="input-output" +>output</glossterm +>. Let us take a look at how a new command is created: <screen> +learn circle (x) [ + repeat 36 [ + forward x + turnleft 10 + ] +] +</screen +> The new command is called <userinput +>circle</userinput +>. <userinput +>circle</userinput +> takes one <glossterm linkend="input-output" +>input</glossterm +>, a number, to set the size of the circle. <userinput +>circle</userinput +> returns no <glossterm linkend="input-output" +>output</glossterm +>. The <userinput +>circle</userinput +> command can now be used like a normal command in the rest of the code. See this example: <screen +>learn circle (x) [ + repeat 36 [ + forward x + turnleft 10 + ] + ] + + go 30,30 + circle(20) + + go 40,40 + circle(50) +</screen> +</para> +<para +>In the next example a command with a return value is created. <screen> +reset + +learn multiplyBySelf (n) [ + r = n * 1 + r = n * n + return r +] +i = inputwindow "Please enter a number and press OK" +print i + " multiplied by itself is: " + multiplyBySelf (i) +</screen +> In this example a new command called <userinput +>multiplyBySelf</userinput +> is created. The input of this command is multiplied by it self and then returned, using the <anchor id="return"/><userinput +>return</userinput +> command. The <userinput +>return</userinput +> command is the way to output a value from a function you have created. </para> +</sect1> + +</chapter> diff --git a/tde-i18n-en_GB/docs/tdeedu/kturtle/translator-guide.docbook b/tde-i18n-en_GB/docs/tdeedu/kturtle/translator-guide.docbook new file mode 100644 index 00000000000..3676f91bfc3 --- /dev/null +++ b/tde-i18n-en_GB/docs/tdeedu/kturtle/translator-guide.docbook @@ -0,0 +1,223 @@ +<chapter id="translators"> +<title +>Translator's Guide to &kturtle;</title> +<para +>As you know, one of the great features of &logo; is that the &logo; commands can be translated in your own language. This makes it easier for a child to understand the commands. For a new language, there are 3 files to translate: first the keywords file (or commands) then the logo-highlight-style file and finally the examples. </para> +<sect1 id="make_directory"> +<title +>Creating a Directory to hold the Translated Files</title> +<para +>First, you need to create a directory to store the translated files. Create a directory called <filename class="directory" +>tde-i18n/<replaceable +>code</replaceable +>/data/tdeedu/kturtle/</filename +> in your KDE CVS directory, where <replaceable +>code</replaceable +> is your country code (the 2- or 4- letter <acronym +>ISO</acronym +> code). </para> +<para +>Copy the <filename +>Makefile.am</filename +> file from <filename class="directory" +>tdeedu/kturtle/data/</filename +> into this directory. Open it using your favorite text editor, replace all instances of <quote +>en_US</quote +> in the file with your country code (the one used above), and save the file. </para> +</sect1> +<sect1 id="commands_trans"> +<title +>How To Translate the &logo; Keywords (commands)</title> +<para> +<itemizedlist> +<listitem +><para +>Copy the <filename +>logokeywords.en_US.xml</filename +> file from <filename class="directory" +>tdeedu/kturtle/data/</filename +> to the directory you have just created, and rename it to <filename +>logokeywords.<replaceable +>code</replaceable +>.xml</filename +> where <replaceable +>code</replaceable +> is your country code (the 2- or 4- letter <acronym +>ISO</acronym +> code). </para> +</listitem> +<listitem +><para +>Translate the contents of the <sgmltag class="starttag" +>keyword</sgmltag +> tag (&ie; the information between <sgmltag class="starttag" +>keyword</sgmltag +> and <sgmltag class="endtag" +>keyword</sgmltag +>) into your own language wherever possible. Also, translate the contents of the <sgmltag class="starttag" +>alias</sgmltag +> tag, (&ie; the information between the <sgmltag class="starttag" +>alias</sgmltag +> and <sgmltag class="endtag" +>alias</sgmltag +>): these are used as shortcuts for the keyword.</para> +<para +>For example, translate <quote +>while</quote +> in: <sgmltag class="starttag" +>keyword</sgmltag +>while<sgmltag class="endtag" +>keyword</sgmltag +> </para> +<para +>Please do not translate anything else and do not translate the English words in <sgmltag class="starttag" +>command name="english_word"</sgmltag +>: these must stay in English. </para> +</listitem> +<listitem +><para +>Save your file as <acronym +>UTF-8</acronym +> (in &kate;, use <guimenuitem +>Save As...</guimenuitem +> and change to <guilabel +>utf8</guilabel +> in the box on the right of the file name). </para> +</listitem> +<listitem +><para +>Commit your file (add your filename in the <filename +>Makefile.am</filename +>) or send it to Anne-Marie. </para> +</listitem> +<listitem +><para +>In case of any doubt, please contact Anne-Marie Mahfouf <email +>annemarie.mahfouf@free.fr</email +> for more information.</para> +</listitem> +</itemizedlist> +</para> +</sect1> + +<sect1 id="examples_syntax"> +<title +>How To Translate the Syntax Highlighting Files</title> +<para> +<itemizedlist> +<listitem +><para +>Copy the <filename +>logohighlightstyle.en_US.xml</filename +> file from <filename class="directory" +>tdeedu/kturtle/data/</filename +> to the directory you created to store the translated keywords file, and rename it to <filename +>logohighlightstyle.<replaceable +>code</replaceable +>.xml</filename +> where <replaceable +>code</replaceable +> is your country code (the 2- or 4- letter <acronym +>ISO</acronym +> code). </para> +</listitem> +<listitem +><para +>In line 4 of the file, there is <sgmltag class="starttag" +>language name="en_US"</sgmltag +>...: here you change <quote +>en_US</quote +> to your language's <acronym +>ISO</acronym +> code (2 or 4 letters). </para +></listitem> +<listitem +><para +>Translate into your own language the content of the <sgmltag class="starttag" +>item</sgmltag +> tag (&ie; the information between <sgmltag class="starttag" +>item</sgmltag +> and <sgmltag class="endtag" +>item</sgmltag +>). This content must match the <filename +>logokeyword</filename +> file. For example, translate <quote +>while</quote +> in: <sgmltag class="starttag" +>item</sgmltag +> while <sgmltag class="endtag" +>item</sgmltag +> and leave the spaces as they are (one at the beginning and one at the end). Please do not translate anything else. </para +></listitem> +<listitem +><para +>Save your file as <acronym +>UTF-8</acronym +> (in &kate;, use <guimenuitem +>Save As...</guimenuitem +> and change to <guilabel +>utf8</guilabel +> in the box on the right of the file name). </para +></listitem> +<listitem +><para +>Commit your file (add your filename in the <filename +>Makefile.am</filename +>) or send it to Anne-Marie. </para +></listitem> +<listitem +><para +>In case of any doubt, please contact Anne-Marie Mahfouf <email +>annemarie.mahfouf@free.fr</email +> for more information. </para +></listitem> +</itemizedlist> +</para> +</sect1> + +<sect1 id="examples_trans"> +<title +>How To Translate the Examples</title> +<itemizedlist> +<listitem +><para +>Copy the English example files from <filename class="directory" +>tdeedu/kturtle/data/</filename +> to the directory used to store the translated keyword and hilighting files. Translate the filenames of the examples in your directory: this will allow users to easily and quickly understand what the example is about.</para> +</listitem> +<listitem +><para +>Translate the keywords in the examples, using those in the <filename +>logokeywords.xml</filename +> for your language. The keywords file file must be done, first, before translating the examples.</para> +</listitem> +<listitem +><para +>Save your file as <acronym +>UTF-8</acronym +> (in &kate;, use <guimenuitem +>Save As...</guimenuitem +> and change to <guilabel +>utf8</guilabel +> in the box on the right of the file name)</para> +</listitem> +<listitem +><para +>Commit your folder (add a <filename +>Makefile.am</filename +> inside) or send it to Anne-Marie.</para> +</listitem> +<listitem +><para +>In case of any doubt, please contact Anne-Marie Mahfouf, <email +>annemarie.mahfouf@free.fr</email +> for more information.</para> +</listitem> +<listitem +><para +>Finally, if you want, you can add your own examples in this folder.</para> +</listitem> +</itemizedlist> +</sect1> + +</chapter> diff --git a/tde-i18n-en_GB/docs/tdeedu/kturtle/using-kturtle.docbook b/tde-i18n-en_GB/docs/tdeedu/kturtle/using-kturtle.docbook new file mode 100644 index 00000000000..e250da7f1ba --- /dev/null +++ b/tde-i18n-en_GB/docs/tdeedu/kturtle/using-kturtle.docbook @@ -0,0 +1,1025 @@ +<chapter id="using-kturtle"> +<title +>Using &kturtle;</title> + +<screenshot> + <screeninfo +>Here is a screenshot of &kturtle; in action</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="mainwindow_flower_nrs.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>&kturtle; Main Window</phrase> + </textobject> + </mediaobject> +</screenshot> + +<para +>The main window of &kturtle; has two main parts: <link linkend="the-code-editor" +>the code editor</link +> (3) on the left where you type the &logo; commands, and <link linkend="the-canvas" +>the canvas</link +> (4) on the right where the instructions are visualized. <link linkend="the-canvas" +>The canvas</link +> is the turtle's playground: it is on the canvas that the turtle actually moves and draws. The three other places on the main window are: <link linkend="the-menubar" +>the menu bar</link +> (1) from where all the actions can be reached, <link linkend="the-toolbar" +>the toolbar</link +> (4) that allows you to quickly select the most used actions, and <link linkend="the-statusbar" +>the statusbar</link +> (5) where you will find feedback on the state of &kturtle;.</para> + +<sect1 id="the-code-editor"> +<title +>The Code Editor</title> +<para +>In the code editor you type the &logo; commands. It has all of the features you would expect from a modern editor. Most of its features are found in the <link linkend="the-edit-menu" +>Edit</link +> and the <link linkend="the-tools-menu" +>Tools</link +> menus. The code editor can be docked on each border of the main window or it can be detached and placed anywhere on your desktop.</para> +<para +>You have several ways to get some code in the editor. The easiest way is to use an already-made example: choose <menuchoice +><guimenu +>File</guimenu +><guimenuitem +>Open Examples</guimenuitem +> </menuchoice +> in the <link linkend="the-file-menu" +>File menu</link +> and click on a file. The filename will tell you what the example is about (⪚ <filename +>square.logo</filename +> will draw a square). The file you choose will be opened in the <link linkend="the-code-editor" +>the code editor</link +>, you can then use <menuchoice +><guimenu +>File</guimenu +><guimenuitem +>Execute Commands</guimenuitem +> </menuchoice +> to run the code if you like.</para> +<para +>You can open &logo; files by choosing <menuchoice +><guimenu +>File</guimenu +><guimenuitem +>Open...</guimenuitem +> </menuchoice +>.</para> +<para +>The third way is to directly type your own code in the editor or to copy/paste some code from this user guide. </para> +<para +>The cursor position is indicated in <link linkend="the-statusbar" +>the statusbar</link +>, on the right with the Line number and Column number. </para> +</sect1> + +<sect1 id="the-canvas"> +<title +>The Canvas</title> +<para +>The canvas is the area where the commands are visualized, where the commands <quote +>draw</quote +> a picture. In other words, it is the turtle's playground. After getting some code in the <link linkend="the-code-editor" +>the code editor</link +>, and executing it using <menuchoice +><guimenu +>File</guimenu +><guimenuitem +>Execute Commands</guimenuitem +> </menuchoice +>, two things can happen: either the code executes fine, and will you most likely see something change on the canvas; or you have made an error in your code and there will be a message telling you what error you made.</para> +<para +>This message should help you to resolve the error.</para> +<para +>The picture that is drawn can be saved as an image (using <menuchoice +><guimenu +>File</guimenu +><guimenuitem +>Save Canvas</guimenuitem +> </menuchoice +>) or printed (using <menuchoice +><guimenu +>File</guimenu +><guimenuitem +>Print...</guimenuitem +> </menuchoice +>).</para> +</sect1> + +<sect1 id="the-menubar"> +<title +>The Menubar</title> +<para +>In the menu bar you find all the actions of &kturtle;. They are in the following groups: <guimenu +>File</guimenu +>, <guimenu +>Edit</guimenu +>, <guimenu +>View</guimenu +>, <guimenu +>Tools</guimenu +>, <guimenu +>Settings</guimenu +>, and <guimenu +>Help</guimenu +>. This section describes them all.</para> + +<sect2 id="the-file-menu"> +<title +>The <guimenu +>File</guimenu +> Menu</title> + <variablelist> + <varlistentry> + <term +><menuchoice +><shortcut +> <keycombo +>&Ctrl;<keycap +>N</keycap +></keycombo +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>New</guimenuitem +> </menuchoice +></term> + <listitem +><para +>Creates a new, empty &logo; file.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <varlistentry> + <term +><menuchoice +><shortcut +> <keycombo +>&Ctrl;<keycap +>O</keycap +></keycombo +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>Open...</guimenuitem +> </menuchoice +></term> + <listitem +><para +>Opens a &logo; file.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <varlistentry> + <term +><menuchoice +><guimenu +>File</guimenu +> <guimenuitem +>Open Recent</guimenuitem +> </menuchoice +></term> + <listitem +><para +>Opens a &logo; file that has been opened recently.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <varlistentry> + <term +><menuchoice +><shortcut +> <keycombo +>&Ctrl;<keycap +>E</keycap +></keycombo +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>Open Examples</guimenuitem +> </menuchoice +></term> + <listitem +><para +>Show the folder with examples &logo; programs. The examples should be in your favorite language that you can choose in <menuchoice +><guimenu +>Settings</guimenu +><guimenuitem +>Configure &kturtle;...</guimenuitem +> </menuchoice +>.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="file-execute"/> + <varlistentry> + <term +><menuchoice +><shortcut +> <keycombo +>&Alt;<keysym +>Return</keysym +></keycombo +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>Execute Commands</guimenuitem +> </menuchoice +></term> + <listitem +><para +>Starts the execution of the commands in the code editor.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="file-stop"/> + <varlistentry> + <term +><menuchoice +><shortcut +> <keycombo +><keysym +>Escape</keysym +></keycombo +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>Stop Execution</guimenuitem +> </menuchoice +></term> + <listitem +><para +>Stops the execution. This action is only enabled when the commands are actually executing.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="file-save"/> + <varlistentry> + <term +><menuchoice +><shortcut +> <keycombo +>&Ctrl;<keycap +>S</keycap +></keycombo +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>Save</guimenuitem +> </menuchoice +></term> + <listitem +><para +>Saves the currently opened &logo; file.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="file-save-as"/> + <varlistentry> + <term +><menuchoice +><guimenu +>File</guimenu +> <guimenuitem +>Save As...</guimenuitem +> </menuchoice +></term> + <listitem +><para +>Saves the currently opened &logo; file on a specified location.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="file-save-canvas"/> + <varlistentry> + <term +><menuchoice +><guimenu +>File</guimenu +> <guimenuitem +>Save Canvas</guimenuitem +> </menuchoice +></term> + <listitem +><para +>Saves the current drawing on canvas into an image.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="file-print"/> + <varlistentry> + <term +><menuchoice +><shortcut +> <keycombo +>&Ctrl;<keycap +>P</keycap +></keycombo +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>Print...</guimenuitem +> </menuchoice +></term> + <listitem +><para +>Prints either the current code in the editor or the current drawing on the canvas.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="file-quit"/> + <varlistentry> + <term +><menuchoice +><shortcut +> <keycombo +>&Ctrl;<keycap +>Q</keycap +></keycombo +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>Quit</guimenuitem +> </menuchoice +></term> + <listitem +><para +>Quits &kturtle;.</para +></listitem> + </varlistentry> + </variablelist> +</sect2> + +<sect2 id="the-edit-menu"> + <title +>The <guimenu +>Edit</guimenu +> Menu</title> + <variablelist> + <anchor id="edit-undo"/> + <varlistentry> + <term +><menuchoice +><shortcut +> <keycombo +>&Ctrl;<keycap +>Z</keycap +></keycombo +> </shortcut +> <guimenu +>Edit</guimenu +> <guimenuitem +>Undo</guimenuitem +> </menuchoice +></term> + <listitem +><para +>Undoes the last change to code. &kturtle; has unlimited undos.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="edit-redo"/> + <varlistentry> + <term +><menuchoice +><shortcut +> <keycombo +>&Ctrl;&Shift;<keycap +>Z</keycap +></keycombo +> </shortcut +> <guimenu +>Edit</guimenu +> <guimenuitem +>Redo</guimenuitem +> </menuchoice +></term> + <listitem +><para +>Redoes an undone change to the code.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="edit-cut"/> + <varlistentry> + <term +><menuchoice +><shortcut +> <keycombo +>&Ctrl;<keycap +>X</keycap +></keycombo +> </shortcut +> <guimenu +>Edit</guimenu +> <guimenuitem +>Cut</guimenuitem +> </menuchoice +></term> + <listitem +><para +>Cuts the selected text from the code editor to the clipboard.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="edit-copy"/> + <varlistentry> + <term +><menuchoice +><shortcut +> <keycombo +>&Ctrl;<keycap +>C</keycap +></keycombo +> </shortcut +> <guimenu +>Edit</guimenu +> <guimenuitem +>Copy</guimenuitem +> </menuchoice +></term> + <listitem +><para +>Copies the selected text from the code editor to the clipboard.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="edit-paste"/> + <varlistentry> + <term +><menuchoice +><shortcut +> <keycombo +>&Ctrl;<keycap +>V</keycap +></keycombo +> </shortcut +> <guimenu +>Edit</guimenu +> <guimenuitem +>Paste</guimenuitem +> </menuchoice +></term> + <listitem +><para +>Pastes the text from the clipboard to the editor.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="edit-find"/> + <varlistentry> + <term +><menuchoice +><shortcut +> <keycombo +>&Ctrl;<keycap +>F</keycap +></keycombo +> </shortcut +> <guimenu +>Edit</guimenu +> <guimenuitem +>Find...</guimenuitem +> </menuchoice +></term> + <listitem +><para +>With this action you can find phrases in the code.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="edit-find-next"/> + <varlistentry> + <term +><menuchoice +><shortcut +> <keycombo +><keysym +>F3</keysym +></keycombo +> </shortcut +> <guimenu +>Edit</guimenu +> <guimenuitem +>Find Next</guimenuitem +> </menuchoice +></term> + <listitem +><para +>Use this to find the next occurrence of the phrase.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="edit-replace"/> + <varlistentry> + <term +><menuchoice +><shortcut +> <keycombo +>&Ctrl;<keycap +>R</keycap +></keycombo +> </shortcut +> <guimenu +>Edit</guimenu +> <guimenuitem +>Replace...</guimenuitem +> </menuchoice +></term> + <listitem +><para +>With this action you can replace phrases in the code.</para +></listitem> + </varlistentry> + </variablelist> +</sect2> + +<sect2 id="the-view-menu"> + <title +>The <guimenu +>View</guimenu +> Menu</title> + <variablelist> + <anchor id="view-fullscreen"/> + <varlistentry> + <term +><menuchoice +><shortcut +> <keycombo +>&Ctrl;&Shift;<keycap +>F</keycap +></keycombo +> </shortcut +> <guimenu +>View</guimenu +> <guimenuitem +>Full Screen Mode</guimenuitem +> </menuchoice +></term> + <listitem +><para +>With this action you toggle the full screen mode.</para> + <para +>Note: When code is executed while in full screen mode everything but the canvas is hidden. This makes it possible to write <quote +>full screen</quote +> programs in &kturtle;.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="view-linenumbers"/> + <varlistentry> + <term +><menuchoice +><shortcut +> <keycombo +><keysym +>F11</keysym +></keycombo +> </shortcut +> <guimenu +>View</guimenu +> <guimenuitem +>Show Line Numbers</guimenuitem +> </menuchoice +></term> + <listitem +><para +>With this action you can show the line numbers in the code editor. This can be handy for finding errors.</para +></listitem> + </varlistentry> + </variablelist> +</sect2> + +<sect2 id="the-tools-menu"> + <title +>The <guimenu +>Tools</guimenu +> Menu</title> + <variablelist> + <anchor id="tools-color-picker"/> + <varlistentry> + <term +><menuchoice +><shortcut +> <keycombo +>&Alt;<keycap +>C</keycap +></keycombo +> </shortcut +> <guimenu +>Tools</guimenu +> <guimenuitem +>Colour Picker</guimenuitem +> </menuchoice +></term> + <listitem +><para +>This action opens the colour picker. Using the colour picker you can easily select a <glossterm linkend="rgb" +>colour code</glossterm +> and insert it in <link linkend="the-code-editor" +>the code editor</link +>.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="tools-indent"/> + <varlistentry> + <term +><menuchoice +><shortcut +> <keycombo +>&Ctrl;<keycap +>I</keycap +></keycombo +> </shortcut +> <guimenu +>Tools</guimenu +> <guimenuitem +>Indent</guimenuitem +> </menuchoice +></term> + <listitem +><para +>This action <quote +>indents</quote +> (adds white space at the beginning of) the lines that are selected. When <quote +>indentation</quote +> is used properly this can make code much easier to read. All examples use indentation, please check them out.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="tools-unindent"/> + <varlistentry> + <term +><menuchoice +><shortcut +> <keycombo +>&Ctrl;&Shift;<keycap +>I</keycap +></keycombo +> </shortcut +> <guimenu +>Tools</guimenu +> <guimenuitem +>Unindent</guimenuitem +> </menuchoice +></term> + <listitem +><para +>This action <quote +>unindents</quote +> (removes the white space at the beginning of) the lines that are selected.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="tools-clean-indent"/> + <varlistentry> + <term +><menuchoice +><guimenu +>Tools</guimenu +> <guimenuitem +>Clean Indentation</guimenuitem +> </menuchoice +></term> + <listitem +><para +>This action cleans <quote +>indentation</quote +> (removes all the white space at the beginning of) the lines that are selected.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="tools-comment"/> + <varlistentry> + <term +><menuchoice +><shortcut +> <keycombo +>&Ctrl;<keycap +>D</keycap +></keycombo +> </shortcut +> <guimenu +>Tools</guimenu +> <guimenuitem +>Comment</guimenuitem +> </menuchoice +></term> + <listitem +><para +>This action add comment characters (#) in from of the lines that are selected. Lines that start with a comment character are ignored when the code is executed. Comments allow the programmer to explain a bit about his code or they can be used to temporarily prevent a certain piece of code from being executed.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="tools-uncomment"/> + <varlistentry> + <term +><menuchoice +><shortcut +> <keycombo +>&Ctrl;&Shift;<keycap +>D</keycap +></keycombo +> </shortcut +> <guimenu +>Tools</guimenu +> <guimenuitem +>Uncomment</guimenuitem +> </menuchoice +></term> + <listitem +><para +>This action removes the comment characters from the selected lines.</para +></listitem> + </varlistentry> + </variablelist> +</sect2> + +<sect2 id="the-setting-menu"> + <title +>The <guimenu +>Settings</guimenu +> Menu</title> + <variablelist> + <anchor id="toggle-toolbar"/> + <varlistentry> +<term +><menuchoice +><guimenu +>Settings</guimenu +> <guimenuitem +>Show/Hide Toolbar</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Toggle</action +> the Main Toolbar</para +></listitem> +</varlistentry> + </variablelist +> + <variablelist> + <anchor id="toggle-statusbar"/> + <varlistentry> +<term +><menuchoice +><guimenu +>Settings</guimenu +> <guimenuitem +>Show/Hide Statusbar</guimenuitem +> </menuchoice +></term> +<listitem +><para +><action +>Toggle</action +> the Statusbar</para +></listitem> +</varlistentry> + </variablelist> + <variablelist> + <anchor id="tools-advanced"/> + <varlistentry> + <term +><menuchoice +><guimenu +>Settings</guimenu +> <guisubmenu +>Advanced Settings</guisubmenu +> </menuchoice +></term> + <listitem +><para +>Here you can change things you normally do not need to change. The <guisubmenu +>Advanced Settings</guisubmenu +> submenu has three items: <guimenuitem +>Configure Editor...</guimenuitem +> (the standard &kate; editor settings dialog), <guimenuitem +>Configure Shortcuts...</guimenuitem +> (the standard &kde; shortcut settings dialog), and <guimenuitem +>Configure Toolbars...</guimenuitem +> (the standard &kde; toolbars setting dialog).</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="settings-configure"/> + <varlistentry> + <term +><menuchoice +><guimenu +>Settings</guimenu +> <guimenuitem +>Configure &kturtle;...</guimenuitem +> </menuchoice +></term> + <listitem +><para +>This is used to configure &kturtle;. Here you can change the language of the &logo; commands or set a new initial canvas size.</para +></listitem> + </varlistentry> + </variablelist> + +</sect2> + +<sect2 id="the-help-menu"> + <title +>The <guimenu +>Help</guimenu +> Menu</title> + <variablelist> + <anchor id="help-handbook"/> + <varlistentry> + <term +><menuchoice +><guimenu +>Help</guimenu +> <guimenuitem +>&kturtle; Handbook</guimenuitem +> </menuchoice +></term> + <listitem +><para +>This action shows the handbook that you are currently reading.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="help-whats-this"/> + <varlistentry> + <term +><menuchoice +><shortcut +> <keycombo +>&Shift;<keysym +>F1</keysym +></keycombo +> </shortcut +> <guimenu +>Help</guimenu +> <guimenuitem +>What's This?</guimenuitem +> </menuchoice +></term> + <listitem +><para +>After activating this action the mouse arrow will be changed into a <quote +>question mark arrow</quote +>. When this arrow is used to click on parts of &kturtle; main window, a description of the particular part pops-up.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="help-context-help"/> + <varlistentry> + <term +><menuchoice +><shortcut +> <keycombo +><keysym +>F1</keysym +></keycombo +> </shortcut +> <guimenu +>Help</guimenu +> <guimenuitem +>Help on: ...</guimenuitem +> </menuchoice +></term> + <listitem +><para +>This is a very useful function: it provides help on the code where the cursor in the code editor is at. So, ⪚, you have used the <userinput +>print</userinput +> command in your code, and you want to read and to know what the handbook says on this command. You just move your cursor so it is in the <userinput +>print</userinput +> command and you press <keysym +>F1</keysym +>. The handbook will then show all info on the <userinput +>print</userinput +> command.</para> + <para +>This function is very important while learning programming.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="help-report-bug"/> + <varlistentry> + <term +><menuchoice +><guimenu +>Help</guimenu +> <guimenuitem +>Report Bug...</guimenuitem +> </menuchoice +></term> + <listitem +><para +>Use this to report a problem with &kturtle; to the developers. These reports can be used to make future versions of &kturtle; even better.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="help-about-kturtle"/> + <varlistentry> + <term +><menuchoice +><guimenu +>Help</guimenu +> <guimenuitem +>About &kturtle;</guimenuitem +> </menuchoice +></term> + <listitem +><para +>Here you find information on &kturtle;, like the authors and the license it comes with.</para +></listitem> + </varlistentry> + </variablelist> + <variablelist> + <anchor id="help-about-kde"/> + <varlistentry> + <term +><menuchoice +><guimenu +>Help</guimenu +> <guimenuitem +>About &kde;</guimenuitem +> </menuchoice +></term> + <listitem +><para +>Here you can find information on &kde;. If you do not know yet what &kde; is, this is a place you should not miss.</para +></listitem> + </varlistentry> + </variablelist> +</sect2> + +</sect1> + +<sect1 id="the-toolbar"> +<title +>The Toolbar</title> +<para +>Here you can quickly reach the most used actions. By default, you will find here all main useful commands ending with the <guiicon +>Execute Commands</guiicon +> and <guiicon +>Stop Execution</guiicon +> icons.</para> +<para +>You can configure the toolbar using <menuchoice +><guimenu +>Settings</guimenu +><guimenuitem +>Advanced Settings</guimenuitem +><guimenuitem +>Configure Toolbar...</guimenuitem +></menuchoice +></para> +</sect1> + +<sect1 id="the-statusbar"> +<title +>The Statusbar</title> +<para +>On the statusbar you get feedback of the state of &kturtle;. On the left side it shows the feedback on the last action. On the right side you find the current location of the cursor (line and column numbers). In the middle of the Statusbar is indicated the current language used for the commands.</para> +</sect1> + +</chapter> |