From 9b58d35185905f8334142bf4988cb784e993aea7 Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Mon, 21 Nov 2011 02:23:03 -0600 Subject: Initial import of extracted KDE i18n tarballs --- tde-i18n-et/docs/kdeedu/kturtle/Makefile.am | 4 + tde-i18n-et/docs/kdeedu/kturtle/Makefile.in | 635 ++++++++ .../docs/kdeedu/kturtle/getting-started.docbook | 300 ++++ tde-i18n-et/docs/kdeedu/kturtle/glossary.docbook | 402 +++++ tde-i18n-et/docs/kdeedu/kturtle/index.cache.bz2 | Bin 0 -> 24375 bytes tde-i18n-et/docs/kdeedu/kturtle/index.docbook | 377 +++++ .../kdeedu/kturtle/programming-reference.docbook | 1721 ++++++++++++++++++++ .../docs/kdeedu/kturtle/translator-guide.docbook | 266 +++ .../docs/kdeedu/kturtle/using-kturtle.docbook | 1115 +++++++++++++ 9 files changed, 4820 insertions(+) create mode 100644 tde-i18n-et/docs/kdeedu/kturtle/Makefile.am create mode 100644 tde-i18n-et/docs/kdeedu/kturtle/Makefile.in create mode 100644 tde-i18n-et/docs/kdeedu/kturtle/getting-started.docbook create mode 100644 tde-i18n-et/docs/kdeedu/kturtle/glossary.docbook create mode 100644 tde-i18n-et/docs/kdeedu/kturtle/index.cache.bz2 create mode 100644 tde-i18n-et/docs/kdeedu/kturtle/index.docbook create mode 100644 tde-i18n-et/docs/kdeedu/kturtle/programming-reference.docbook create mode 100644 tde-i18n-et/docs/kdeedu/kturtle/translator-guide.docbook create mode 100644 tde-i18n-et/docs/kdeedu/kturtle/using-kturtle.docbook (limited to 'tde-i18n-et/docs/kdeedu/kturtle') diff --git a/tde-i18n-et/docs/kdeedu/kturtle/Makefile.am b/tde-i18n-et/docs/kdeedu/kturtle/Makefile.am new file mode 100644 index 00000000000..f6c3e2e278a --- /dev/null +++ b/tde-i18n-et/docs/kdeedu/kturtle/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = et +SUBDIRS = $(AUTODIRS) +KDE_DOCS = AUTO +KDE_MANS = AUTO diff --git a/tde-i18n-et/docs/kdeedu/kturtle/Makefile.in b/tde-i18n-et/docs/kdeedu/kturtle/Makefile.in new file mode 100644 index 00000000000..b8e9911e7cd --- /dev/null +++ b/tde-i18n-et/docs/kdeedu/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/kdeedu/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@ +kdeinitdir = @kdeinitdir@ +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 = et +#>- 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/kdeedu/kturtle/Makefile'; \ +#>- cd $(top_srcdir) && \ +#>- $(AUTOMAKE) --gnu docs/kdeedu/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/kdeedu/kturtle/Makefile'; \ + cd $(top_srcdir) && \ + $(AUTOMAKE) --gnu docs/kdeedu/kturtle/Makefile + cd $(top_srcdir) && perl ../scripts/admin/am_edit -p../scripts/admin docs/kdeedu/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/kdeedu/kturtle/Makefile'; \ + cd $(top_srcdir) && \ + $(AUTOMAKE) --gnu docs/kdeedu/kturtle/Makefile + cd $(top_srcdir) && perl ../scripts/admin/am_edit -p../scripts/admin docs/kdeedu/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-et/docs/kdeedu/kturtle/getting-started.docbook b/tde-i18n-et/docs/kdeedu/kturtle/getting-started.docbook new file mode 100644 index 00000000000..e9a03f43467 --- /dev/null +++ b/tde-i18n-et/docs/kdeedu/kturtle/getting-started.docbook @@ -0,0 +1,300 @@ + + +Alustamine +&kturtle;'i käivitamisel ilmub nähtavale midagi sellist: &kturtle; esmakäivitamisel &kturtle;'i peaaken Me eeldame siinses tutvustuses, et &logo; käskude keel on inglise keel. Kasutatavat keelt saab muuda seadistustedialoogi (Seadistused&kturtle; seadistamine...) keelesektsioonis. Arvesta aga, et keel, mille sa &kturtle;'ile valid, peab olema sama keel, milles sa &logo; käsud kirjutad. + + +Esimesed sammud &logo;s: tutvume Kilpkonnaga! +Ilmselt märkasid, et keset lõuendit tudub kilpkonn. Nüüd aga vaatame, kuidas teda koodiredaktoris kirjutatud käskudega liikuma panna. + + +Kilpkonna liikumine +Paneme nüüd kilpkonna liikuma. Ta võib liikuda kolme moodi: (1) edasi ja tagasi, (2) pöörata paremale ja vasakule ning (3) minna otse mingisse ekraanipunkti. Proovime näiteks nii: + +forward 100 +turnleft 90 + +Kirjuta see koodiredaktorisse või kopeeri ja aseta ning seejärel käivita käsud (FailKäivita käsud). + +Kui kirjutasid toodud käsud koodiredaktorisse ja käivitasid need, nägid ilmselt vähemalt üht järgmistest asjadest: + +Pärast käskude käivitamist liikus kilpkonn üles, joonistas sirge ja pööras siis oma liikumissuunaga risti vasakule. Seda põhjustasidki käsud forward ja turnleft. + + +Koodi värv muutus kirjutamisel. Seda nimetatakse intuitiivseks esiletõstmiseks — erinevat laadi käskudele antakse erinev värv. Nii on eriti suuremaid koodiblokke märksa lihtsam lugeda. Samuti leiab hõlpsamini üles vead, sest sellistele sõnadele värvi ei anta. + + +Kilpkonn joonistas peenikese musta joone. + + +Võis juhtuda ka, et said veateate. See tähendab üht kahest: tegid käskude kopeerimisel mingi vea või siis ei ole sul veel määratud &logo; käskude korrektne keel. Viimast saab teha seadistustedialoogi (Seadistused&kturtle; seadistamine...) keelesektsioonis. + + + +Igaks juhuks kordame üle: forward 100 andis kilpkonnale korralduse liikuda joont maha jättes edasi ning turnleft 90 käsu pöörata 90 kraadi vasakule. + +Palun uuri ka käskude kirjeldusi, mida tutvustame lähemalt käesolevas raamatus edaspidi: forward, backward, turnleft ja turnright. + + + +Veel näiteid +Esimene näide oli imelihtne, nii et vaatame nüüd edasi! + + + +canvassize 200,200 +canvascolor 0,0,0 +pencolor 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 + +Kirjuta taas toodud kood redaktorisse või kopeeri see siit või ava fail arrow.logo kataloogis Näidiste avamine ning käivita käsud (FailKäivita käsud). Edasistes näidetes me enam seda ei ütle, eeldades, et sa oled selle juba meelde jätnud... + +Nagu näed, on teises näites koodi märksa enam. Samuti on siin mitu uut käsku. Seletame need nüüd lühidalt lahti: + +canvassize 200,200 määrab lõuendi laiuseks ja kõrguseks 200 pikslit. Laius ja kõrgus on võrdsed, see tähendab, et lõuend on ruudukujuline. + +canvascolor 0,0,0 muudab lõuendi mustaks. 0,0,0 on RGB värvikood, milles kõik väärtused on 0, mis tähendabki kokkuvõttes musta. + +pencolor 255,0,0 määrab pliiatsi värviks punase. 255,0,0 on RGB värvikood, kus ainult punase väärtus on maksimaalne 255, teistel (rohelisel ja sinisel) aga 0, mis annab kokku erepunase. + +Kui sa ei ole kursis, mis on värviväärtused, loe kindlasti sõnastikust artiklit RGB värvikoodide kohta. + +penwidth 5 määrab pliiatsi laiuseks 5 pikslit. See tähendab, et siitpeale on kõik kilpkonna tõmmatavad jooned paksusega 5, kuni me anname penwidth väärtuseks midagi muud. + +clear puhastab lõuendi. + +go 20,20 annab kilpkonnale korralduse minna lõuendi kindlasse punkti. Ülemisest vasakust nurgast arvestades asub see koht lõuendi vasakust servast 20 piksli ning ka lõuendi ülaservast 20 piksli kaugusel. Pane tähele, et käsu go kasutamisel kilpkonn joont ei tõmba. + +direction 135 määrab kilpkonna suuna. Käsud turnleft ja turnright muudavad kilpkonna nurka selle praeguse suuna suhtes. Käsk direction muudab kilpkonna suunda alates nullist, see ei ole seotud kilpkonna varasema suunaga. + +Pärast käsku direction tuleb mitu käsku forward ja turnleft. Nendega käibki tegelik joonistamine. + +Uus go annab lõpuks kilpkonnale käsu eemale minna. + +Uuri kindlasti ka käskude seletusi, kus on kõik põhjalikult lahti seletatud. + + + + + + + + + + + diff --git a/tde-i18n-et/docs/kdeedu/kturtle/glossary.docbook b/tde-i18n-et/docs/kdeedu/kturtle/glossary.docbook new file mode 100644 index 00000000000..2c98851243f --- /dev/null +++ b/tde-i18n-et/docs/kdeedu/kturtle/glossary.docbook @@ -0,0 +1,402 @@ + + +Sõnastik + +Selles peatükis selgitame kõige ebatavalisemaid mõisteid, mida käsiraamat sisaldab. + + + +kraadid +Kraadid mõõdavad nurka ehk pöörde ulatust. Täispööre on 360 kraadi, järelikult poolpööre 180 ja veerandpööre 90 kraadi. Käskude turnleft, turnright ja direction sisend peab olema antud kraadides. + + + +käskude sisend ja väljund +Mõned käsud vajavad sisendit, mõned annavad väljundit, mõned vajavad sisendit ja annavad väljundit ning mõned ei vaja sisendit ega anna ka mingit väljundit. +Mõned näited ainult sisendiga käskudest: +forward 50 +pencolor 255,0,0 +print "tere!" + Käsk forward võtab sisendiks 50. forward vajab seda sisendit määramaks, mitu pikslit edasi liikuda. pencolor võtab sisendiks värvikoodi ja print stringi. Pane tähele, et sisend võib olla ka konteiner, nagu näha järgnevas näites: x = 50 +print x +str = "tere!" +print str + + +Nüüd mõned näited väljundit andvate käskude kohta: +x = inputwindow "palun kirjuta midagi ja vajuta OK... aitäh!" +r = random 1,100 + Käsk inputwindow võtab stringi sisendiks ja annab väljundiks sisestatud arvu või stringi. Nagu näha, on inputwindow väljund salvestatud konteineris x. Ka käsk random annab väljundi. Antud juhul on väljundiks number vahemikus 1 kuni 100. Ka see väljund on salvestatud konteinerisse, milleks siin on r. Pane tähele, et konteinereid x ja r ei ole kasutatud eespool toodud näidiskoodis. + +Mõned käsud ei vaja sisendit ega anna ka väljundit, näiteks: clear +penup +wrapon +hide + + + + + +intuitiivne esiletõstmine +See &kturtle;'i omadus muudab koodi kirjutamise veelgi kergemaks. Esiletõstmine annab kirjutatud koodi osadele erinevad värvid, mis märgivad seda, millist tüüpi koodiga kuskil tegemist on. Järgnevas tabelis on ära toodud erinevad kooditüübid ja värv, millega selliseid osi näitab koodiredaktor. +Erinevad kooditüübid ja nende esiletõstmise värv + + + +tavalised käsud +tumeroheline +Tavalisi käske kirjeldatakse siin. + + +täitmise kontrollerid +must (rasvane) +Nende spetsiaalsete käskude täitmist kontrollivate käskude kohta saab põhjalikumalt lugeda siit. + + +kommentaarid +tumekollane +Kommenteeritud ridade alguses seisab vastav sümbol (#). Neid ridu koodi täitmisel ignoreeritakse. Kommentaarid lubavad programmeerijal oma koodi selgitada või siis ajutiselt teatud koodiosa täitmata jätta. + + +nurksulud [, ] +heleroheline (rasvane) +Nurksulge kasutatakse koodiosade grupeerimiseks. Tihtipeale pruugitakse neid koos täitmise kontrolleritega. + + +käsk learn +heleroheline (rasvane) +Käsuga learn saab luua uusi käske. + + +numbrid +sinine +Numbrid on numbrid, mis nende kohta ikka rohkem öelda... + + +stringid +tumepunane +Ega ka (teksti)stringide kohta pole palju muud öelda, kui et nende alguses ja lõpus on alati topeltjutumärgid ("). + + +matemaatilised sümbolid +hall +Need on matemaatiliste tehete sümbolid: +, -, *, /, ( ja ). Loe nende kohta lähemalt siit. + + +küsimused +sinine (rasvane) +Küsimuste kohta loe lähemalt siit. + + +küsimuste ühendussõnad +roosa +Küsimuste ühendussõnade (and, or, not) kohta loe lähemalt siit. + + +tavaline tekst +must + + + + +
+ + + + +pikslid +Piksel on punkt ekraanil. Kui vaatad väga teraselt, näed, et kogu sinu monitori ekraan on piksleid täis. Kõik ekraanil olevad kujutised õigupoolest pikslitest koosnevadki. Piksel ongi kõige väiksem asi, mida saab ekraanile joonistada. +Paljud käsud vajavad sisendina pikslite arvu: forward, backward, go, gox, goy, canvassize ja penwidth. + + + +RGB värvikoodid +RGB värvikoodid tähistavad värve. R tähendab punast (inglise keeles red), G rohelist (green) ja B sinist (blue). RGB värvikood on näiteks 255,0,0, kus esimene ehk punane väärtus on 255 ja teised 0, mis kokku annab erepunase. Iga RGB värvikoodi väärtus peab olema vahemikus 0 kuni 255. Toome siin ära mõned sagedamini kasutust leidvad värvid: +Sagedasemad RGB värvikoodid + + + +0,0,0must +255,255,255valge +255,0,0punane +150,0,0tumepunane +0,255,0roheline +0,0,255sinine +0,255,255helesinine +255,0,255roosa +255,255,0kollane + + +
+ +RGB värvikoodi võimaldab imelihtsalt leida värvivalija. Selle saab avada menüükäsuga TööriistadVärvivalija. +Kaks käsku vajavad sisendina RGB värvikoodi: canvascolor ja pencolor. + + + +sprait +Sprait on väike pilt, mida saab ekraanil liigutada. Nii on näiteks ka meie armas pisike kilpkonnake sprait. +Märkus: &kturtle;'i praeguses versioonis saab sprait olla ainult kilpkonn, aga tulevastes versioonides on loodetavasti võimalik kilpkonn asendada just sulle meelepärase spraidiga. + + + +murdmine +Murdmist kasutatakse siis, kui kilpkonn joonistab midagi nii suurt, mis ei taha lõuendile ära mahtuda ning murdmine on sees. Murdmine näeb välja selline Murdmise näide Kui kilpkonn liigub üle lõuendi piiri, viiakse ta automaatselt lõuendi vastasservale, kus ta saab oma liikumist jätkata. Sel moel on kilpkonn liikudes alati ekraanil. +Murdmise saab sisse ja välja lülitada käskudega wrapon ja wrapoff. &kturtle;'i käivitamisel on murdmine vaikimisi sees. + + + + + \ No newline at end of file diff --git a/tde-i18n-et/docs/kdeedu/kturtle/index.cache.bz2 b/tde-i18n-et/docs/kdeedu/kturtle/index.cache.bz2 new file mode 100644 index 00000000000..26cdc835e84 Binary files /dev/null and b/tde-i18n-et/docs/kdeedu/kturtle/index.cache.bz2 differ diff --git a/tde-i18n-et/docs/kdeedu/kturtle/index.docbook b/tde-i18n-et/docs/kdeedu/kturtle/index.docbook new file mode 100644 index 00000000000..7f2aa9ee055 --- /dev/null +++ b/tde-i18n-et/docs/kdeedu/kturtle/index.docbook @@ -0,0 +1,377 @@ + + + + + + + + + + + +]> + + + + +&kturtle;'i käsiraamat + + +Cies Breijs
cies AT kde DOT nl
+ + +Anne-Marie Mahfouf
annma AT kde DOT org
+ + +Marek Laane
bald@starman.ee
Tõlge eesti keelde + + + + +2004 +Cies Breijs + + +&FDLNotice; + +2005-12-10 +0.6 + + +&kturtle; on haridusalane programmeerimiskeskkond, mis kasutab programmeerimiskeelt &logo;. LOGO unikaalseks omaduseks on see, et käske saab tõlkida ka programmeerija emakeelde. + + + +KDE +kdeedu +KTurtle +haridus +keel +loomulik +programmeerimine +kood +&logo; +juhised +kilpkonn + + + + + +Sissejuhatus + +&kturtle; on haridusalane programmeerimiskeskkond, mis kasutab programmeerimiskeelt &logo;. Rakenduse mõte on muuta programmeerimine nii lihtsaks ja arusaadavaks, kui vähegi võimalik. Nii sobib &kturtle; ka lastele matemaatika, geomeetria ja ... programmeerimise õpetamiseks. Rakenduses kasutatavad käsud sarnanevad stiililt programmeerimiskeele &logo; omadele. &logo; unikaalseks omaduseks on see, et käske saab tõlkida ka programmeerija emakeelde. + +&kturtle; on saanud nime ingliskeelse sõna turtle ehk kilpkonn järgi, sest just kilpkonnal on meie programmeerimiskeskkonnas keskne osa: kasutaja programmerib kilpkonna &logo; käskudega joonistama lõuendile vajalikku pilti. + + + + +&kturtle;'i omadused +&kturtle; pakub mitmeid vahvaid ja võimsaid omadusi, mis lubavad igaühel kerge vaevaga programmeerimisega tegelda. Mõned neist: +integreeritud &logo; interpretaator - ei mingit vajadust veel mõne programmi järele -, mis kasutab tõlgitud käskude jaoks &XML;-faile, toetab kasutaja määratud funktsioone ning dünaamilist lülitumist. +Käskude täitmist saab aeglustada, peatada või katkestada igal ajahetkel. +võimas redaktor, mis lubab &logo; käskude süntaksit esile tõsta, nummerdab ridu ja teeb veel palju muud toredat. +lõuendi võib salvestada pildina või välja trükkida. +lõuendil saab kasutada murdmist, mis ei lase kilpkonnal nii kergesti kaotsi minna. +kõigi &logo; käskude kontekstiabi - vajuta vaid F2. +&logo; käsud on täielikult tõlgitavad (praegu on toetatud Brasiilia portugali, hollandi, inglise, itaalia, prantsuse, rootsi, saksa, serbia (kirillitsa ja ladina) ja sloveeni keel). +veadialoog, mis seob veateated programmis esinevate vigadega. +lihtsustatud programmeerimisterminoloogia. +täisekraanirežiim. +hulk põimitud ja internatsionaliseeritud &logo; näidisprogramme, mis muudavad alustamise eriti lihtsaks. + + + + + +&using-kturtle; + +&getting-started; + +&programming-reference; + +&glossary; + +&translator-guide; + + + +Autorid ja litsents + +&kturtle; +Rakenduse autoriõigus 2003-2005: Cies Breijs cies AT kde DOT nl +Kaasautorid: +Koodiabi, redaktorikomponent: Anne-Marie Mahfouf &Anne-Marie.Mahfouf.mail; + +wsbasic (http://wsbasic.sourceforge.net) looja, mis on aluseks &kturtle;'i interpretaatorile: Walter Schreppers Walter DOT Schreppers AT ua DOT ac DOT be + +Saksa keele andmefailid: Matthias Meßmer bmlmessmer AT web DOT de + +Saksa keele andmefailid: Burkhard Lück lueck AT hube-lueck DOT de + +Rootsi keele andmefailid: Stefan Asserhäll stefan DOT asserhal AT telia DOT com + +Sloveeni keele andmefailid: Jure Repinc jlp@holodeck1.com + +Serbia keele (kirillitsa ja ladina) andmefailid: Chusslove Illich caslav.ilic@gmx.net + +Itaalia keele andmefailid: Pino Toscano toscano.pino@tiscali.it + +Briti inglise keele andmefailid: Andy Potter A.J.Potter@rhul.ac.uk + +Hispaania keele andmefailid: Rafael Beccar rafael.beccar@kdemail.net + +Brasiilia portugali keele andmefailid: Riverson Rios riverson@ccv.ufc.br + +Norra keele (nynorsk ja bokmål) andmefailid: Karl Ove Hufthammer karl@huftis.org + +Parseri kirillitsa toetus: Albert Astals Cid astals11@terra.es + + + + +Dokumentatsiooni autoriõigus 2004: +Cies Briej cies AT kde DOT nl +&Anne-Marie.Mahfouf; annma AT kde DOT org +Mõningane korrektuur: &Philip.Rodrigues; &Philip.Rodrigues.mail; + +Tõlkimise HOWTO uuendamine ja osaline korrektuur: Andrew Coles andrew_coles AT yahoo DOT co DOT uk + + + + +Tõlge eesti keelde: Marek Laane bald@starman.ee +&underFDL; &underGPL; + + + + +Paigaldamine + + +&kturtle;'i hankimine +&install.intro.documentation; + + +Kompileerimine ja paigaldamine +&install.compile.documentation; + + + +&documentation.index; + + diff --git a/tde-i18n-et/docs/kdeedu/kturtle/programming-reference.docbook b/tde-i18n-et/docs/kdeedu/kturtle/programming-reference.docbook new file mode 100644 index 00000000000..3f39ff48b5c --- /dev/null +++ b/tde-i18n-et/docs/kdeedu/kturtle/programming-reference.docbook @@ -0,0 +1,1721 @@ + + +&kturtle;'i &logo; käskude seletused +Käesolev osa selgitab &kturtle;'i &logo; keelt. Esmalt puudutame lühidalt erinevaid instruktsioonide tüüpe. Seejärel selgitame ükshaaval kõiki käske. Sellele järgnevad konteinereid, matemaatikat, küsimusi ja täitmise kontrollereid puudutavad selgitused. Lõpuks aga näitame, kuidas on võimalik luua omaenda käske käsuga learn. + + +Instruktsioonide tüübid +Nagu igal keelel, nii on ka LOGO-l mitut laadi sõnu ja sümboleid. Järgnevalt selgitame lühidalt nende tüüpide erinevusi. + + +Käsud +Just käskudega saab panna kilpkonna või &kturtle;'i midagi tegema. Osa käske eeldab sisendit, osa annab väljundi. # forward on käsk, mis vajab sisendit, antud juhul on selleks arv 100: +forward 100 + + +Täpsemalt kirjeldatakse kõiki käske, mida &kturtle; toetab, siin. + + + +Arvud +Arvatavasti oled juba koolis õppinud, mis asjad on arvud või mingil muul moel osanud selle välja uurida. &kturtle; kasutab arve üsna sarnaselt sellele, kuidas kasutatakse neid matemaatikas või kas või tavalises kõnepruugis. +Me kasutamine niinimetatud naturaalarve: 0, 1, 2, 3, 4, 5 jne. Samuti negatiivseid arve: -1, -2, -3 jne. Aga ka murdarve, näiteks: 0.1, 3,14, 33,3333, -5,05, -1,0. +Arve saab pruukida matemaatilistes arvutustes ja küsimustes. Neid saab lisada ka konteineritesse. +Arvud on koodiredaktoris esile tõstetud sinise värviga. + + + +Stringid +Kõigepealt näide: +print "Hei, mina olen string." + Selles näites on print käsk, "Hei, mina olen string." aga string. Stringide alguses ja lõpus seisab ", mille järgi &kturtle; tunneb ära, et tegemist on stringiga. +Stringe saab lisada konteineritele, kuid neid ei saa kasutada matemaatilistes arvutustes ega küsimustes. +Stringid on koodiredaktoris esile tõstetud tumepunase värviga. + + + + +Nimed +Programmeerimiskeelt &logo; kasutades on sul võimalik luua uusi asju. Mõnda programmi kirjutades läheb sageli tarvis konteinereid ning mõnigi kord tuleb uute käskude loomiseks tarvitada käsku learn. Luues konteinerit või uut käsku käsuga learn, tuleb määrata ka nimi. +Nime võib valida just sellise, nagu tahad - peaasi, et sel ei oleks juba tähendust. Nii ei saa näiteks anda konteinerile nimeks forward, sest seda kasutab juba üks käsk ja sellel on niisiis tähendus olemas. +# siin on forward kasutusel konteinerina, aga sel on juba tähendus, +# mistõttu tulemuseks on viga: +forward = 20 + +# aga nii läheb küll: +forward 20 + Nimed tohivad sisaldada ainult tähti, arve ja alakriipse (_), sealjuures peavad nad algama tähega. +Täpsemalt ja põhjalikumalt ning näidetega tutvu konteineritest ja käsust learn rääkivates osades. + + + +Omistamised +Omistamiseks kasutatakse sümbolit =. Programmeerimiskeeles ei ole ühekordne = mitte 'võrdub', vaid pigem 'saab'. Sõnale 'võrdub' vastab paremini sümbol ==, mis kujutab endast küsimust. +Omistamist kasutatakse peamiselt kahel eesmärgil: (1) sisu lisamiseks konteineritele ja (2) konteineri sisu muutmiseks. Näide: x = 10 +# konteiner x sisaldab nüüd arvu 10 +W = "Minu vanus on: " +# konteiner W sisaldab nüüd stringi "Minu vanus on: " +# järgmine käsk näitab konteinerite 'W' ja 'x' sisu lõuendil +print W + x + + +Rohkem näiteid leiab konteineritest kõnelevas osas. + + + +Matemaatikasümbolid +&kturtle; toetab kõiki põhilisi matemaatikasümboleid: liitmine (+), lahutamine (-), korrutamine (*), jagamine (/) ja sulud ( ning ). +Põhjalikuma seletuse ja rohkem näiteid leiab matemaatikast kõnelevas osas. + + + +Küsimused +Me võime esitada lihtsaid küsimusi, mille vastus saab olla kas 'tõene' või 'väär'. +Küsimuste kasutamist selgitab põhjalikult küsimustele pühendatud osa. + + + +Küsimuste ühendussõnad +Küsimusi saab ühendada niinimetatud ühendussõnadega. Sellisteks sõnadeks on and, or ja spetsiaalne ühendussõna not. +Küsimuste ühendussõnade kasutamist selgitab ühendussõnadele pühendatud osa. + + + + +Kommentaarid +Kommentaarid on sellised read, mille alguses seisab #. Näide: +# see on kommentaar! +print "see ei ole kommentaar" +# eelmine rida ei olnud kommentaar, aga järgmine on: +# print "see ei ole kommentaar" + Kommentaarireaga saame lisada kommentaare koodile iseenda või ka teiste jaoks, kes vähegi seda loevad. Kommentaare kasutatakse (1) programmile väikese kirjelduse lisamiseks, (2) koodiosa toimimise selgitamiseks, kui see võib tunduda veidi segasena, ning (3) selliste koodiridade 'väljakommenteerimiseks', mida tuleks (ajutiselt) ignoreerida (vaata toodud näite viimast rida). +Kommenteeritud read on koodiredaktoris esile tõstetud tumekollase värviga. + + + + + + +Käsud +Just käskudega saab panna kilpkonna või &kturtle;'i midagi tegema. Osa käske eeldab sisendit, osa annab väljundi. Selles osas kirjeldame kõiki käske, mida saab &kturtle;'is kasutada. Pane tähele, et kõik rakenduse poolt pakutavad käsud, mida me siin tutvustame, on koodiredaktoris esile tõstetud tumerohelise värviga, mis aitab neid paremini eristada. + + +Kilpkonna liigutamine +Kilpkonna saab lõuendil liigutada mitme käsuga. + + + forward (fw) + + + forward + forward X +forward paneb kilpkonna otse edasi liikuma X piksli võrra. Kui pliiats on sees, jätab kilpkonna ka jälje maha. forward asemel võib kasutada lühendit fw. + + + + + backward (bw) + + + backward + backward X +backward paneb kilpkonna otse tagasi liikuma X piksli võrra. Kui pliiats on sees, jätab kilpkonna ka jälje maha. backward asemel võib kasutada lühendit bw. + + + + + turnleft (tl) + + + turnleft + turnleft X +turnleft paneb kilpkonna X kraadi võrra vasakule pöörama. turnleft asemel võib kasutada lühendit tl. + + + + + turnright (tr) + + + turnright + turnright X +turnright paneb kilpkonna X kraadi võrra paremale pöörama. turnright asemel võib kasutada lühendit tr. + + + + + direction (dir) + + + direction + direction X +direction määrab kilpkonna suunaks X kraadi arvestades nullist, see ei ole seotud kilpkonna varasema suunaga. direction asemel võib kasutada lühendit dir. + + + + + center + + + center + center +center sunnib kilpkonna liikuma lõuendi keskpunkti. + + + + + go + + + go + go X,Y +go paneb kilpkonna liikuma lõuendi konkreetsesse punkti. See asub X piksli kaugusel lõuendi vasakust servast ja Y piksli kaugusel lõuendi ülaservast. Pane tähele, et käsu go kasutamisel kilpkonn joont ei tõmba. + + + + + gox + + + gox + gox X +gox paneb kilpkonna samal kõrgusel liikuma X piksli kaugusele lõuendi vasakust servast. + + + + + goy + + + goy + goy Y +goy paneb kilpkonna samal laiusel (kaugusel vasakust servast) liikuma Y piksli kaugusele lõuendi ülaservast. + + + + + + +Kilpkonn pliiatsiga +Kilpkonnal on pliiats, millega ta liikudes joont veab. Pliiatsit saab juhtida mitme käsuga, mida siin tutvustamegi. + + penup (pu) + + + penup + penup +penup tõstab pliiatsi lõuendilt ja kuni see on üleval, ei tõmba kilpkonn liikudes ühtki joont. Vaata ka pendown. penup asemel võib kasutada lühendit pu. + + + + + pendown (pd) + + + pendown + pendown +pendown surub pliiatsi lõuendi vastu ja kuni see on all, tõmbab kilpkonn liikudes joone. Vaata ka penup. pendown asemel võib kasutada ka lühendit pd. + + + + + penwidth (pw) + + + penwidth + penwidth X +penwidth määrab pliiatsi tõmmatava joone laiuseks X pikslit. penwidth asemel võib kasutada ka lühendit pw. + + + + + pencolor (pc) + + + pencolor + pencolor R,G,B +pencolor määrab pliitsi tõmmatava joone värvi. pencolor tahab saada sisendina RGB värvikoodi. pencolor asemel võib kasutada ka lühendit pc. + + + + + + +Lõuendiga seotud käsud +Lõuendi omadusi saab muuta mitme käsuga. + + canvassize (cs) + + + canvassize + canvassize X,Y +Käsk canvassize määrab lõuendi suuruse. Käsu sisendiks on X ja Y, kus X on uue lõuendi laius pikslites ja Y uue lõuendi kõrgus samuti pikslites. canvassize asemel võib kasutada lühendit cs. + + + + + canvascolor (cc) + + + canvascolor + canvascolor R,G,B +Käsk canvascolor määrab lõuendi värvi. canvascolor tahab saada sisendina RGB värvikoodi. canvascolor asemel võib kasutada ka lühendit cc. + + + + + wrapon + + + wrapon + wrapon +Käsk wrapon lubab lõuendil kasutada murdmist. Kui soovid täpsemalt teada, mis on murdmine, vaata sõnastikku. + + + + + wrapoff + + + wrapoff + wrapoff +Käsk wrapoff keelab lõuendil kasutada murdmist. See tähendab, et kilpkonn võib minna üle lõuendi piiri ja kaduda. Kui soovid täpsemalt teada, mis on murdmine, vaata sõnastikku. + + + + + + +Puhastamiskäsud +Kahe käsuga saab lõuendi puhastada sellest, mida sa sinna oled valmis meisterdanud. + + clear (cr) + + + clear + clear +Käsk clear puhastab lõuendilt kogu joonistatu. Muud asjad jäävad püsima: kilpkonna asukoht ja nurk, lõuendivärv, kilpkonna nähaolek ja lõuendi suurus. clear asemel võib kasutada ka lühendit cr. + + + + + reset + + + reset + reset +Käsk reset puhastab palju rohkem asju kui clear. Pärast käsku reset on kõik taas selline, nagu &kturtle;'i käivitamisel: kilpkonn on lõuendi keskel, lõuendi värv on valge ja kilpkonn hakkab liikudes vedama musta joont. + + + + + + +Kilpkonn on sprait +Vaevalt et paljud teavad, mis õieti on sprait, nii et ütleme siis saladuse välja: sprait on väike pilt, mida saab ekraanil liigutada. Täpsemalt vaata sõnastikust mõiste sprait kirjeldust. See tähendab, et meie kilpkonn on sprait! +Toome siin ära kõik käsud, mida saab spraidi puhul kasutada. +[&kturtle;'i praegune versioon toetab spraidina ainult kilpkonna kasutamist. Aga tulevikus võib olla vägagi võimalik, et võid kilpkonna oma soovi kohaselt millegi muuga asendada.] + + show + + + show (ss) + show +Käsk show muudab kilpkonna uuesti nähtavaks pärast tema peitmist. show asemel võib kasutada ka lühendit ss. + + + + + hide (sh) + + + hide + hide +hide peidab kilpkonna. Seda on mõtet kasutada siis, kui kilpkonn kohe kuidagi ei taha sinu joonistusele sobida. hide asemel võib kasutada ka lühendit sh. + + + + + + +Kas kilpkonnad oskavad ka kirjutada? +Õige vastus: jah, muidugi. Kilpkonn võib kirjutada küll, aga mõistagi pead sina talle ütlema, mida kirjutada. + + print + + + print + print X +print annab kilpkonnale käsu midagi lõuendile kirjutada. print sisendiks võivad olla nii numbrid kui stringid. Sümbolit + kasutades saab käsuga print lasta kirjutada mitmesuguseid numbreid ja stringe. Toome siin väikese näite: year = 2003 +author = "Cies" +print author + " alustas KTurtle'i projekti aastal " + year + " ja ta töötab endiselt rõõmuga selle kallal!" + + + + + + + fontsize + + + fontsize + fontsize X +fontsize määrab fondi suuruse, mida print kirjutamisel kasutab. fontsize sisend peab olema number. Suurus määratakse pikslites. + + + + + + +Õnnemängukäsk +Üks käsk nii-öelda veeretab sinu eest täringut. Selle nimi on random ja sellega saab igasuguseid vahvaid ning ootamatuid asju teha. + + + random + random X,Y +random on käsk, mis tahab saada sisendit ja annab kohe ka väljundi. Sisendiks on kaks arvu, milles üks (X) määrab minimaalse ja teine (Y) maksimaalse väljundi. Väljund on juhuslik arv, mis on miinimumiga võrdne või suurem ning maksimumiga võrdne või väiksem. Üks väike näide: +repeat 500 [ + x = random 1,20 + forward x + turnleft 10 - x +] + Selle käsuga saab oma programmi veidi kaootilisemaks muuta. + + + + + +Sisendi- ja tagasisidedialoogid +Dialoog on väike hüpikaken, mis annab teatud tagasisidet või soovib saada mingit sisendit. &kturtle; kasutab dialoogidele kaht käsku: message ja inputwindow. + + message + + + message + message X +Käsk message vajab sisendina stringi. See näitab hüpikdialoogi, mis sisaldab stringi teksti. year = 2003 +author = "Cies" +print author + " alustas KTurtle'i projekti aastal " + year + " ja ta töötab endiselt rõõmuga selle kallal!" + + + + + + + inputwindow + + + inputwindow + inputwindow X +Käsk inputwindow vajab sisendina stringi. See näitab hüpikdialoogi, mis sisaldab stringi nagu ka message. Kuid lisaks sellele on dialoogis ka sisendiväli. Selle abil saab kasutaja sisestada arvu või stringi, mis on võimalik salvestada konteinerisse. Näide: +in = inputwindow "Kui vana sa oled?" +out = 2003 - in +print "Aastal 2003 olid sa " + out + " aastat vana." + Kui kasutaja sulgeb sisenddialoogi või ei sisesta midagi, tühjendatakse vastav konteiner. + + + + + + + + + + +Konteinerid +Konteinerid on tähed või sõnad, mida programmeerija saab tarvitada arvu või teksti mahutamiseks. Arve sisaldavaid konteinereid nimetatakse muutujateks, teksti sisaldavaid stringideks. + +Konteinerid, mida veel ei kasutata, tähendavad vaikimisi 0. Näide: +print N + See ei näita mitte midagi. Kui me püüame matemaatikas kasutada tühje konteinereid, on tulemuseks vead. + + +Muutujad: arvukonteinerid +Toome taas näite: +x = 3 +print x + Esimesel real muudetakse täht x muutujaks (numbrikonteineriks). Nagu näed, antakse muutujale x väärtuseks 3. Teisel real antakse korraldus see väärtus kirja panna. +Pane tähele, et soovi korral panna kirja x, pidanuks me seda tegema nii: print "x" + + +See oli lihtne, aga võtame kohe raskema näite: +A = 2004 +B = 25 +C = A + B + +# järgmine käsk kirjutab "2029" +print C +backward 30 +# järgmine käsk kirjutab "2004 pluss 25" +print A + " plus " + B +backward 30 +# järgmine käsk kirjutab "1979" +print A - B + Esimesel kahel real määratakse muutujate A ja B väärtuseks 2004 ja 25. Kolmandal real määratakse muutuja C väärtuseks A + B ehk siis 2029. Ülejäänud osa näitest koosneb kolmest käsust print, mida eraldab käsk backward 30. backward 30 on siin selleks, et iga väljund oleks ikka uuel real. Toodud näites on ka näha, et muutujaid saab kasutada matemaatilisteks teheteks. + + + +Teksti (stringe) sisaldavad konteinerid +Programmeerimiskoodis algab ja lõpeb tavaline tekst enamasti jutumärkidega. Me juba nägime seda: +print "Hei programmeerija!" + Tavaline tekst on piiratud jutumärkidega. Sellist tavalise teksti juppi nimetamegi stringiks. +Stringe võib salvestada konteinerites täpselt samamoodi nagu arve. Stringid sarnanevad tublisti muutujatega. Suurim erinevus on see, et stringe ei saa kasutada matemaatilistes tehetes ega küsimustes. Näide stringide kasutamise kohta: +x = "Tere " +name = inputwindow "Palun sisesta oma nimi..." +print x + name + ", kuidas läheb? + Esimesel real määratakse stringi x väärtuseks Tere . Teisel real määratakse stringi name väärtuseks käsu inputwindow väljund. Kolmanda reaga antakse korraldus kirjutada lõuendile kolme stringi kombinatsioon. +Programm palub sul sisestada oma nime. Kui sa näiteks annad oma nimeks Paul, kirjutab programm Tere Paul, kuidas läheb? Pane tähele, et plussmärk (+) on ainus matemaatiline sümbol, mida saab stringide puhul kasutada. + + + + +Kas Kilpkonn ka matemaatikat oskab? +&kturtle;? Ikka oskab. Ta võib liita (+), lahutada (-), korrutada (*) ja jagada (/). Toome siin näite kõigi nende tehetega: +a = 20 - 5 +b = 15 * 2 +c = 30 / 30 +d = 1 + 1 +print "a: "+a+", b: "+b+", c: "+c+", d: "+d + Tead sa ikka, mis on a, b, c ja d väärtus? Pane tähele ka omistamise sümboli = kasutamist. +Kui soovid väga lihtsat tehet teha, siis see käib umbes nii: print 2004-12 + +Ja nüüd näide sulgudega: +print ( ( 20 - 5 ) * 2 / 30 ) + 1 + Sulgudes olevad tehted sooritatakse esimestena. + + + +Küsid küsimuse, saad vastuse... +if ja while on täitmise kontrollerid, mida me käsitleme järgmises osas. Siin kasutame käsku if küsimuste selgitamiseks. + +Küsimused +Lihtne näide küsimuse kohta: +x = 6 +if x > 5 [ + print "tere" +] + Selles näites on küsimuseks x > 5. Kui vastus sellele küsimusele on 'tõene', täidetakse nurksulgudes olev kood. Küsimused on programmeerimises päris tähtsal kohal ning neid kasutataksegi tihtipeale koos täitmise kontrolleritega, näiteks if. Kõiki arve ja muutujaid (arvukonteinereid) saab omavahel võrrelda küsimusi kasutades. +Toome siin ära kõik võimalikud küsimused: +Küsimuste tüübid + + + +a == b +võrdub +vastus on tõene, kui a võrdub b + + +a != b +ei võrdu +vastus on tõene, kui a ei võrdu b + + +a > b +suurem kui +vastus on tõene, kui a on suurem kui b + + +a < b +väiksem kui +vastus on tõene, kui a on väiksem kui b + + +a >= b +suurem kui või võrdub +vastus on tõene, kui a on suurem kui või võrdub b + + +a <= b +väiksem kui või võrdub +vastus on tõene, kui a on väiksem kui või võrdub b + + + +
+ +Küsimused on koodiredaktoris esile tõstetud sinise värviga. + + + +Küsimuste ühendussõnad +Küsimusi saab ka üksteisega siduda niinimetatud küsimusliimiga. Sellisel moel saab mitmest küsimusest luua ühe suure küsimuse. +a = 1 +b = 5 +if a < 5 and b == 5 [ + print "tere" +] + Selles näites kasutatakse ühendussõna and kahe küsimuse 'liimimiseks' (a < 5, b == 5). Kui üks and pooltest on väär, on kogu küsimuse vastus väär, sest ühendussõna and korral peab mõlema poole vastus olema tõene, et kogu vastus oleks tõene. Ja ära unusta panna küsimuste ümber sulge! + +Põgus ülevaade, millele järgneb põhjalikum seletus: +Küsimuste ühendussõnad + + + +and +Mõlemad pooled peavad olema 'tõesed', et vastus oleks 'tõene' + + +or +Kui üks pool on 'tõene', on vastus 'tõene' + + +not +Erijuhtum: kasutada ainult ühe küsimusega! Sooritab teisenduse 'tõene' -> 'väär' või 'väär' -> 'tõene'. + + + +
+ +Küsimuste ühendussõnad on koodiredaktoris esile tõstetud purpurse värviga. + + +and +Kui küsimused seotakse kokku sõnaga and, peavad mõlemad and pooled olema 'tõesed', et kogu tulemus oleks tõene. Näide: +a = 1 +b = 5 +if ((a < 10) and (b == 5)) and (a < b) [ + print "tere" +] + Toodud näites on kaks ühendatud küsimust koos ühendatud kolmandaga. + + + +or +Kui vähemalt üks sõnaga or ühendatud küsimustest on 'tõene', on 'tõene' ka tulemus. Näide: +a = 1 +b = 5 +if ((a < 10) or (b == 10)) or (a == 0) [ + print "tere" +] + Toodud näites on kaks ühendatud küsimust koos ühendatud kolmandaga. + + + +not +not on spetsiaalne ühendussõna, sest see käib korraga ainult ühe küsimuse kohta. not sooritab teisenduse 'tõene' -> 'väär' või 'väär' -> 'tõene'. Näide: +a = 1 +b = 5 +if not ((a < 10) and (b == 5)) [ + print "tere" +] +else +[ + print "ei ütle tere ;-)" +] + Toodud näites on ühendatud küsimus 'tõene', kuid not muudab selle 'vääraks'. Seepärast kirjutatakse lõuendile lõpuks "ei ütle tere ;-)". + + + + + + + +Täitmise kontrollimine +Täitmise kontrollerid lubavad — nagu nimetuski ütleb — kontrollida käsu täitmist. +Täitmise kontrollimise käsud on esile tõstetud tumerohelise rasvase kirjaga. Nurksulud, mida väga sageli koos täitmise kontrolleritega pruugitakse, on esile tõstetud helerohelise värviga. + + +Kilpkonna ootelejätmine +Kui oled juba natuke &kturtle;'iga harjutanud, paned tähele, et kilpkonn võib päris kiiresti joonistada. See käsk muudab tema tegevuse aga veidi aeglasemaks. + + + wait + wait X +wait paneb kilpkonna X sekundiks ootama. +repeat 36 [ + forward 5 + turnright 10 + wait 0.5 +] + Selle koodiga joonistatakse ringjoon, aga kilpkonn ootab igal sammul pool sekundit. See jätab mulje nii enam-vähem normaalse kiirusega liikuvast kilpkonnast - vähemalt kilpkonna kohta... + + + + + +Tingimuse "kui" (if) täitmine + + + if + if küsimus [ ...] +Kood, mis seisab ... asemel, täidetakse ainult siis, kui (if) vastus küsimusele on tõene. Loe palun küsimuste kohta täpsemalt küsimusi käsitlevast osast. +x = 6 +if x > 5 [ + print "x on suurem kui viis!" +] + Esimesel real määratakse x väärtuseks 6. Teisel real esitatakse küsimus x > 5. Et vastus sellele küsimusele on tõene, lubab täitmise kontroller if nurksulgudes oleva koodi täita. + + + + + +Silmus "while" + + + while + while küsimus [ ... ] +Täitmise kontroller while on üsna sarnane kontrolleriga if. Nende peamine erinevus seisab selles, et while kordab nurksulgudes olevat koodi seni, kuni vastus küsimusele on lõpuks väär. +x = 1 +while x < 5 [ + forward 10 + wait 1 + x = x + 1 +] + Esimesel real määratakse x väärtuseks 1. Teisel real esitatakse küsimus x < 5. Et vastus sellele küsimusele on tõene, alustab täitmise kontroller while nurksulgudes oleva koodi täitmist ja teeb seda seni, kuni vastus küsimusele on lõpuks väär. Antud juhul täidetakse nurksulgudes olev kood neli korda, sest iga viienda rea täitmisega suureneb x ühe võrra. + + + + + +Vastasel juhul ehk "else" + + + else + if küsimus [ ... ] else [ ... ] +Kontrollerit else saab kasutada koos kontrolleriga if. Kood, mis seisab nurksulgudes else järel, täidetakse ainult siis, kui vastus esitatud küsimusele on väär. +reset +x = 4 +if x > 5 [ + print "x on suurem kui viis!" +] else [ + print "x on väiksem kui kuus!" +] + Küsimus ootab vastuseks, kas x on suurem kui 5. Et x väärtuseks on esimesel real määratud 4, on vastuseks väär. See tähendab, et täidetakse kood, mis seisab nurksulgudes else järel. + + + + + +Arvestussilmus "for" + + + for + for alguspunkt to lõpp-punkt [ ... ] +for on arvestussilmus, mis teeb midagi teatud arv kordi. +for x = 1 to 10 [ + print x * 7 + forward 15 +] + Igal nurksulgudes oleva koodi täitmisel antakse x väärtus ühe võrra suuremana, kuni x võrdub lõpuks 10. Nurksulgudes olev kood antud juhul kirjutab tehte 'x korda 7' tulemuse. Kui programm on töö lõpetanud, on tulemuseks lõuendil ilutsev numbri 7 korrutustabelike. + + + + + + + + +Omaenda käskude loomine käsuga <quote +>learn</quote +> +Käsk learn on väga eriline, sest selle abil saab luua omaenda käske. Sinu loodud käsk võib kasutada nii sisendit kui anda väljundit. Vaatamegi nüüd, kuidas uus käsk luua. +learn ringjoon (x) [ + repeat 36 [ + forward x + turnleft 10 + ] +] + Uus käsk kannab nime ringjoon. ringjoon kasutab sisendina numbrit, mis määrab ringjoone suuruse. ringjoon ei tagasta mingit väljundit. Nüüd võime käsku ringjoon kasutada täiesti tavalise käsuna, nagu selles näites: learn ringjoon X [ + repeat 36 [ + forward X + turnleft 10 + ] +] + +go 30,30 +ringjoon 20 + +go 40,40 +ringjoon 50 + + +Järgmises näites aga loome väljundväärtusega käsu. +reset + +learn korrutaIseendaga n [ + r = n * 1 + r = n * n + return r +] +i = inputwindow "Palun sisesta arv ja vajuta OK" +print i + " korrutatud iseendaga on: " + korrutaIseendaga (i) + Selles näites on uue käsu nimeks korrutaIseendaga. Käsu sisend korrutatakse iseendaga ja tagastatakse käsuga return. Käsk return on meetod omaloodud funktsiooni väljundväärtuse saamiseks. + + + diff --git a/tde-i18n-et/docs/kdeedu/kturtle/translator-guide.docbook b/tde-i18n-et/docs/kdeedu/kturtle/translator-guide.docbook new file mode 100644 index 00000000000..f6b681f421e --- /dev/null +++ b/tde-i18n-et/docs/kdeedu/kturtle/translator-guide.docbook @@ -0,0 +1,266 @@ + +&kturtle; sinu emakeeles +Nagu juba mainitud, on programmeerimiskeele &logo; suur iseärasus see, et &logo; käske saab tõlkida mis tahes keelde. See muudab isegi väikesele lapsele käskude mõistmise päris lihtsaks - peaasi, et ta lugeda oskaks. &kturtle; tõlkimisel uude keelde tuleb lisaks tavapärastele rakenduse graafilise liidese stringidele ja dokumentatsioonile ära tõlkida veel mõned failid. Üldiselt saab need automaatselt luua tänu Rafael Beccari skriptidele. Skriptid leiab kataloogist kdeedu/kturtle/scripts, tõlkimist vajavad failid kataloogist kdeedu/kturtle/data. Neis kataloogides on ka README-failid, mis sisaldavad juhiseid, kuidas skripte kasutada ja faile tõlkida. + + +Tõlkefailide kataloogi loomine +Kõigepealt tuleb luua kataloog, kuhu tõlgitud failid paigutada. Loo oma KDE CVS-kataloogis alamkataloog kde-i18n/kood/data/kdeedu/kturtle/, kus kood on sinu keelekood (2- või 4-täheline ISO kood). +Kopeeri sellesse kataloogi kataloogist kdeedu/kturtle/data/ fail Makefile.am. Ava see tekstiredaktoris, asenda failis kõik en_US oma keelekoodiga (sama, mida kasutasid eespool) ning salvesta fail. + + +Kuidas tõlkida &logo; võtmesõnu (käske) + + +Kopeeri kataloogist kdeedu/kturtle/data/ fail logokeywords.en_US.xml äsja loodud kataloogi ja anna sellele nimeks logokeywords.kood.xml, kus kood on sinu riigi kood (2- või 4-täheline ISO kood). + +Tõlgi oma keelde sildi keyword sisu, &ie; info keyword ja keyword vahel kõikjal, kus vähegi võimalik, samuti sildi alias sisu, &ie; info alias ja alias vahel. Need tekstid on omavahel seotud, sest alias on võtmesõna viidaks. +Nii näiteks tõlgi sõna while sildis keywordwhilekeyword. +Palun ära tõlgi midagi muud ja ära tõlgi ka ingliskeelseid sõnu siltides command name="ingliskeelne_sõna". Need peavad jääma ingliskeelseks. +Ja lõpuks: ära muuda failisisest järjekorda - seda läheb vaja Rafael Beccari automaattõlkeskriptidele. + +Salvesta oma fail kodeeringus UTF-8 (näiteks &kate;s vali Salvesta kui... ja vali failinimest paremal asuvas kastis utf8). + +Kanna oma fail CVS-hoidlasse sisse (lisa oma faili nimi faili Makefile.am) või saada see Anne-Mariele. + +Kui sul tekib mingeid küsimusi, võta julgesti ühendust Anne-Marie Mahtoufiga annemarie.mahfouf@free.fr. + + + + + + +Kuidas tõlkida süntaksi esiletõstmise faile +Faili logohighlightstyle.en_US.xml tõlkimine on imelihtne tänu Rafael Beccari skriptile, mille leiad kataloogist kdeedu/kturtle/data/. Palun tutvu aga enne seda kindlasti samas kataloogis leiduva README-failiga. +Tagasiühilduvuse huvides ning kõigi nende inimeste rahuldamiseks, kes ei soovi kasutada äsjamainitud imepärast skripti, kirjeldame ka vana tõlkimismeetodit: +Kopeeri kataloogist kdeedu/kturtle/data/ fail logohighlightstyle.en_US.xml äsja loodud kataloogi ja anna sellele nimeks logokeywords.kood.xml, kus kood on sinu riigi kood (2- või 4-täheline ISO kood). + +Faili neljandal real seisab language name="en_US"...: vaheta siin en_US välja oma keele ISO koodiga (2 või 4 tähte). +Tõlgi oma keelde sildi item sisu, &ie; info item ja item vahel. See peab vastama failis logokeyword olevale sõnale. Näiteks tõlgi while sildis item while item ning jäta tühikud muutmata (üks alguses ja üks lõpus). Palun ära tõlgi midagi muud. +Salvesta oma fail kodeeringus UTF-8 (näiteks &kate;s vali Salvesta kui... ja vali failinimest paremal asuvas kastis utf8). +Kanna oma fail CVS-hoidlasse sisse (lisa oma faili nimi faili Makefile.am) või saada see Anne-Mariele. +Kui sul tekib mingeid küsimusi, võta julgesti ühendust Anne-Marie Mahtoufiga annemarie.mahfouf@free.fr. + + + + + +Kuidas tõlkida näidiseid +Ka siin muudab asja palju lihtsamaks Rafael Beccari skript, mille leiab kataloogist kdeedu/kturtle/data/. Palun loe aga kindlasti eelnevalt samas kataloogis leiduvat README-faili, sest näidisfailide automaattõlkimise järel on samuti vaja üht-teist ette võtta. +Kui järgisid skriptide kataloogis leiduvas README-failis toodud juhiseid, peaks su töö nüüd suurel määral valmis olema. Ära unusta siiski testimast loodud näidiste koodi, sest vead on väga kerged sisse hiilima. Kontrolli ka, et fail Makefile.am kataloogis kde-i18n/kood/data/kdeedu/kturtle/ arvestaks uute failidega. Näiteks hollandi keele puhul peaks Makefile.am välja nägema selline: txt_DATA = advertentie.logo driehoeken.logo krullen.logo tafels.logo \ +bloem.logo driehoek.logo logohighlightstyle.nl.xml pijl.logo vierkanten.logo \ +kleuren.logo logokeywords.nl.xml randomnaam.logo vierkant.logo +txtdir = $(kde_datadir)/kturtle/examples/nl + +xml_DATA = logohighlightstyle.nl.xml +xmldir = $(kde_datadir)/katepart/syntax + +keywords_DATA = logokeywords.nl.xml +keywordsdir = $(kde_datadir)/kturtle/data +EXTRA_DIST = $(txt_DATA) $(xml_DATA) $(keywords_DATA) + + +Kirjeldame siin ka seda, kuidas tõlkida ILMA Rafaeli Perli-skripti kasutamata: +Kopeeri kataloogist kdeedu/kturtle/data/ ingliskeelsed näidisefailid kataloogi, kus asuvad tõlgitud võtmesõna- ja esiletõstmise fail. Nimeta failid oma keelde tõlgituna ümber. See aitab kasutajatel taibata, millega on mingi faili puhul tegemist. + +Tõlgi näidiste võtmesõnad, kasutades eeskujuks neid, mis on tõlgitud sinu emakeelses failis logokeywords.xml. Võtmesõnade fail peab olema kindlasti tõlgitud enne näidiste tõlkimise kallale asumist. + +Salvesta oma fail kodeeringus UTF-8 (näiteks &kate;s vali Salvesta kui... ja vali failinimest paremal asuvas kastis utf8). + +Kanna oma kataloog sisse CVS hoidlasse (lisa sellesse Makefile.am) või saada Anne-Mariele. + +Kui sul tekib mingeid küsimusi, võta julgesti ühendust Anne-Marie Mahtoufiga annemarie.mahfouf@free.fr. + +Kui soovid, võid sellesse kataloogi lisada näidiseid ka omalt poolt. + + + + + + diff --git a/tde-i18n-et/docs/kdeedu/kturtle/using-kturtle.docbook b/tde-i18n-et/docs/kdeedu/kturtle/using-kturtle.docbook new file mode 100644 index 00000000000..ffb220dbae4 --- /dev/null +++ b/tde-i18n-et/docs/kdeedu/kturtle/using-kturtle.docbook @@ -0,0 +1,1115 @@ + + +&kturtle;'i kasutamine + + + &kturtle; tegevuses + + + + + + &kturtle;'i peaaken + + + + +&kturtle;'i peaaken koosneb kahest põhiosast: koodiredaktor (3) vasakul, kus saab kirja panna &logo; käsud, ja lõuend (4) paremal, kus need käsud täide viiakse. Lõuend on kilpkonna nii-öelda liivakast, kus ta omaette askeldades sinu soovitud pildi lõpuks valmis joonistab. Peaaknal on veel kolm osa: menüüriba (1), mis võimaldab kasutada kõiki saadaolevaid käske, tööriistariba (2), kus saab kiiresti valida sagedamini kasutatavate käskude seast, ja olekuriba (5), kus näeb &kturtle;'i tagasisidena rakenduse staatust. + + +Koodiredaktor +Koodiredaktor on koht, kus panna kirja &logo; käsud. See pakub kõiki võimalusi, mida üks tänapäevane redaktor ikka pakkuma peab. Enamik neist on kasutatavad menüüst Redigeerimine või Tööriistad. Koodiredaktori võib dokkida ükspuha millisele peaakna küljele või ka hoopis lahti haakida ja töölaual sootuks mujale asetada. +Koodi saab redaktorisse mitmel moel sisestada. Lihtsaim meetod on kasutada juba valmis tehtud näidiseid. Selleks vali FailAva näidised failimenüüs ja klõpsa vajalikul failil. Failinimi annab teada, mida näidis sisaldab (⪚ ruut.logo joonistab ruudu). Valitud fail avatakse koodiredaktoris, pärast mida saab käsuga FailKäivita käsud hakata seda ellu viima. +&logo; faile saab avada menüükäsuga FailAva... . +Kolmas võimalus on kirjutada kood ise redaktorisse või kopeerida ja asetada kood kuskilt mujalt, kas või käesolevast käsiraamatust. +Kursori asukohta näeb olekuriba paremas ääres, see on määratud rea ja veeru numbriga. + + + +Lõuend +Lõuend on ala, kus käsud visualiseeritakse, kus nendega joonistatakse pilt. Ehk siis - see on kilpkonna mängumaa. Kui oled sisestanud mingi koodi koodiredaktorisse ja selle käivitanud käsuga FailKäivita käsud , võib juhtuda üks kahest: 1) kood täidetakse edukalt ja sa näed midagi lõuendil muutumas või 2) koodis on viga ja ilmub teade, mis ütleb, millise veaga on tegemist. +See teade peaks aitama probleemi lahendada. +Joonistatud pildi võib salvestada pildina (FailSalvesta lõuend ) või ka kohe trükkida (FailTrüki... ). + + + +Menüüriba +Menüüribal leiad kõik toimingud, mida &kturtle;'is on võimalik kasutada. Need on jagatud järgmistesse rühmadesse: Fail, Redigeerimine, Vaade, Tööriistad, Seadistused ja Abi. Kirjeldame siin neid kõiki. + + +<guimenu +>Fail</guimenu +>imenüü + + +Uus + + + &Ctrl;N Fail Uus + Loob uue tühja &logo;-faili. + + + + +Ava + + + &Ctrl;O Fail Ava... + Avab &logo;-faili. + + + + +Ava hiljutine + + + Fail Ava hiljutine + Avab hiljuti kasutatud &logo;-faili. + + + + +Ava näidised + + + &Ctrl;E Fail Ava näidised + Avab &logo; näidisfailidega kataloogi. Need peaksid olema keeles, mis on määratud seadistustedialoogis (Seadistused&kturtle; seadistamine... ). + + + + +Salvesta + + + &Ctrl;S Fail Salvesta + Salvestab parajasti avatud &logo;-faili. + + + + +Salvesta kui + + + Fail Salvesta kui... + Salvestab parajasti avatud &logo;-faili uude asukohta või uue nimega. + + + + +Salvesta lõuend + + + Fail Salvesta lõuend + Salvestab lõuendil oleva joonistuse pildina. + + + + +Täitmise kiirus + + + Fail Täitmise kiirus + Näitab võimalikke täitmise kiirusi: täiskiirus, aeglane, aeglasem ja kõige aeglasem. Kui kiiruseks valida 'täiskiirus' (vaikeväärtus), on vaevu võimalik jälgida, mis toimub. Sageli on see kasulik, kuid vahel võib tekkida soov käskude täitmist üksikasjalikult jälgida. Sel juhul tuleks valida kiiruseks 'aeglane', aeglasem' või 'kõige aeglasem'. Mõne aeglase kiiruse valimisel näidatakse redaktoris täitmise hetkeasukohta. + + + + +Käivita + + + &Alt;Enter Fail Käivita käsud + Käivitab koodiredaktoris kirja pandud käsud. + + + + +Peata + + + Pause Fail Peata täitmine + Peatab käskude täitmise. Seda saab kasutada ainult siis, kui käske parajasti täidetakse. + + + + +Katkesta + + + Escape Fail Katkesta täitmine + Katkestab käskude täitmise. Seda saab kasutada ainult siis, kui käske parajasti täidetakse. + + + + +Trüki + + + &Ctrl;P Fail Trüki... + Trükib kas koodiredaktoris oleva koodi või lõuendil oleva joonistuse. + + + + +Välju + + + &Ctrl;Q Fail Välju + Lõpetab &kturtle;'i töö. + + + + + + + Menüü <guimenu +>Redigeerimine</guimenu +> + + + + &Ctrl;Z Redigeerimine Võta tagasi + Tühistab viimase koodi tehtud muudatuse. &kturtle; ei tunne tagasivõtmisel piire. + + + + + + &Ctrl;&Shift;Z Redigeerimine Tee uuesti + Taastab koodis tagasivõetud muudatuse. + + + + + + &Ctrl;X Redigeerimine Lõika + Lõikab koodiredaktoris valitud teksti ja asetab selle lõikepuhvrisse. + + + + + + &Ctrl;C Redigeerimine Kopeeri + Kopeerib koodiredaktoris valitud teksti lõikepuhvrisse. + + + + + + &Ctrl;V Redigeerimine Aseta + Asetab teksti lõikepuhvrist redaktorisse. + + + + + + &Ctrl;F Redigeerimine Otsi... + Selle käsuga saab koodis teatud sõna või väljendit otsida. + + + + + + F3 Redigeerimine Otsi järgmine + Sellega saab leida otsitava fraasi järgmise esinemiskorra. + + + + + + &Ctrl;R Redigeerimine Asenda... + Sellega saab koodis sõnu või väljendeid asendada. + + + + + + Menüü <guimenu +>Vaade</guimenu +> + + + + &Ctrl;&Shift;F Vaade Täisekraanirežiim + See lülitab täisekraanirežiimi. + Märkus: kui koodi täidetakse täisekraanirežiimis, on näha ainult lõuend. See lubab kirjutada &kturtle;'is ka täisekraan-programme. + + + + + + F11 Vaade Näita reanumbreid + Sellega saab lasta koodiredaktoris reanumbreid näidata. See on kasulik näiteks vigade leidmiseks. + + + + + + <guimenu +>Tööriistad</guimenu +>e menüü + + + + &Alt;C Tööriistad Värvivalija + Avab värvivalija. Selle abil saab hõlpsasti valida värvikoodi ja lisada selle koodiredaktorisse. + + + + + + &Ctrl;I Tööriistad Treppimine + See trepib valitud read (lisab nende algusse tühimärgi). Treppimise korralikul kasutamisel on koodi palju lihtsam lugeda. Kõik näidised kasutavad samuti treppimist, nii et palun tutvu nendega. + + + + + + &Ctrl;&Shift;I Tööriistad Tagasitreppimine + Sellega saab valitud read tagasi treppida, s.t. eemaldada ridade algusest tühimärgi. + + + + + + Tööriistad Eemalda treppimine + Sellega saab valitud read treppimisest puhastada, s.t. eemaldada ridade algusest kõik tühimärgid. + + + + + + &Ctrl;D Tööriistad Kommentaar + See lisab valitud ridadele kommentaarimärgid (#). Kommentaarimärgiga algavaid ridu koodi täitmisel ignoreeritakse. Kommentaarid lubavad programmeerijal näiteks jagada selgitusi koodi kohta või siis vältida ajutiselt koodi teatud osa täitmist. + + + + + + &Ctrl;&Shift;D Tööriistad Kommentaari eemaldamine + See eemaldab valitud ridadelt kommentaarimärgid. + + + + + + Menüü <guimenu +>Seadistused</guimenu +> + + + +Seadistused Tööriistariba näitamine/peitmine +Lülitab peamise tööriistariba näitamise sisse-välja. + + + + + +Seadistused Olekuriba näitamine/peitmine +Lülitab olekuriba näitamise sisse-välja. + + + + + + Seadistused Muud seadistused + Siin saab muuta selliseid asju, mida tavaliselt ei ole põhjust muuta. Alammenüüs Muud seadistusedon kolm kirjet: Redaktori seadistamine... (tavapärane &kate; redaktori seadistustedialoog), Kiirklahvide seadistamine... (tavapärane &kde; kiirklahvide seadistustedialoog) ja Tööriistaribade seadistamine... (tavapärane &kde; tööriistaribade seadistustedialoog). + + + + + + Seadistused &kturtle; seadistamine... + Avab &kturtle;'i seadistustedialoogi, kus saab muuta &logo; käskude keelt või määrata uue lõuendite algsuuruse. + + + + + + + <guimenu +>Abi</guimenu +>menüü + + + + F1 Abi &kturtle;'i käsiraamat + Avab käesoleva käsiraamatu. + + + + + + &Shift;F1 Abi Mis see on? + Pärast selle valimist muutub hiirekursor küsimärgikujuliseks. Sellega mõnel &kturtle;'i peaakna osal klõpsates näeb väikest kohtspikrit infoga antud osa kohta. + + + + + + F2 Abi Abi: ... + See on väga kasulik võimalus, näidates abi koodi selle koha kohta, kus parajasti asub kursor. Kui ⪚ kasutasid koodis käsku print, saad selle abil teada, mida käsiraamat vastava käsu kohta ütleb. Vii kursor käsu print peale ja vajuta F2. Seejärel näed käsiraamatus käsust print rääkivat kohta. + See on päris kasulik ja oluline programmeerimise õppimisel. + + + + + + Abi Saada vearaport... + Selle abil saab arendajatele teada anda &kturtle;'is esinevatest probleemidest. Kui arendajad neist teavad, saavad nad &kturtle;'i järgmisi versioone veelgi paremaks muuta. + + + + + + Abi &kturtle; info + Siin leiab infot &kturtle;'i kohta, näiteks selle autorid ja levitamise aluseks olev litsents. + + + + + + Abi &kde; info + Siin leiab infot &kde; kohta. Kui sa ei peaks veel teadma, mis &kde; on, siis ära seda küll vahele jäta. + + + + + + + +Tööriistariba +Siin saab kiiresti valida kõige sagedamini vajaminevaid toiminguid. Vaikimisi ongi siin just käsud, mida kõige enam vaja läheb, sealhulgas Käskude täitmine ja Täitmise peatamine. +Tööriistariba saab oma maitse järgi kohandada menüükäsuga SeadistusedMuud seadistusedTööriistaribade seadistamine... + + + +Olekuriba +Olekuribal annab &kturtle; sulle tagasisidet oma oleku kohta. Vasakul on näha viimane toiming. Paremal näeb kursori hetkeasukohta (rea ja veeru number). Keskel näeb, millist keelt käskude puhul parajasti kasutatakse. + + + -- cgit v1.2.1