From f7e7a923aca8be643f9ae6f7252f9fb27b3d2c3b Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Sat, 3 Dec 2011 11:05:10 -0600 Subject: Second part of prior commit --- tde-i18n-pt_BR/docs/tdeedu/kturtle/Makefile.am | 4 + tde-i18n-pt_BR/docs/tdeedu/kturtle/Makefile.in | 635 +++++++ .../docs/tdeedu/kturtle/getting-started.docbook | 298 ++++ .../docs/tdeedu/kturtle/glossary.docbook | 404 +++++ tde-i18n-pt_BR/docs/tdeedu/kturtle/index.cache.bz2 | Bin 0 -> 24607 bytes tde-i18n-pt_BR/docs/tdeedu/kturtle/index.docbook | 371 +++++ .../tdeedu/kturtle/programming-reference.docbook | 1737 ++++++++++++++++++++ .../docs/tdeedu/kturtle/translator-guide.docbook | 262 +++ .../docs/tdeedu/kturtle/using-kturtle.docbook | 1107 +++++++++++++ 9 files changed, 4818 insertions(+) create mode 100644 tde-i18n-pt_BR/docs/tdeedu/kturtle/Makefile.am create mode 100644 tde-i18n-pt_BR/docs/tdeedu/kturtle/Makefile.in create mode 100644 tde-i18n-pt_BR/docs/tdeedu/kturtle/getting-started.docbook create mode 100644 tde-i18n-pt_BR/docs/tdeedu/kturtle/glossary.docbook create mode 100644 tde-i18n-pt_BR/docs/tdeedu/kturtle/index.cache.bz2 create mode 100644 tde-i18n-pt_BR/docs/tdeedu/kturtle/index.docbook create mode 100644 tde-i18n-pt_BR/docs/tdeedu/kturtle/programming-reference.docbook create mode 100644 tde-i18n-pt_BR/docs/tdeedu/kturtle/translator-guide.docbook create mode 100644 tde-i18n-pt_BR/docs/tdeedu/kturtle/using-kturtle.docbook (limited to 'tde-i18n-pt_BR/docs/tdeedu/kturtle') diff --git a/tde-i18n-pt_BR/docs/tdeedu/kturtle/Makefile.am b/tde-i18n-pt_BR/docs/tdeedu/kturtle/Makefile.am new file mode 100644 index 00000000000..babf802f3a2 --- /dev/null +++ b/tde-i18n-pt_BR/docs/tdeedu/kturtle/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = pt_BR +SUBDIRS = $(AUTODIRS) +KDE_DOCS = AUTO +KDE_MANS = AUTO diff --git a/tde-i18n-pt_BR/docs/tdeedu/kturtle/Makefile.in b/tde-i18n-pt_BR/docs/tdeedu/kturtle/Makefile.in new file mode 100644 index 00000000000..6001de8bcc2 --- /dev/null +++ b/tde-i18n-pt_BR/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 = pt_BR +#>- 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-pt_BR/docs/tdeedu/kturtle/getting-started.docbook b/tde-i18n-pt_BR/docs/tdeedu/kturtle/getting-started.docbook new file mode 100644 index 00000000000..e25d64dd8ab --- /dev/null +++ b/tde-i18n-pt_BR/docs/tdeedu/kturtle/getting-started.docbook @@ -0,0 +1,298 @@ + + +Começando +Quando você inicia o &kturtle; você irá ver algo semelhante a isto: Aqui está uma imagem do &kturtle; quando o inicia pela primeira vez Janela principal do &kturtle; Neste guia introdutório, iremos assumir que o idioma dos comandos é o Inglês. Você poderá mudar este idioma em ConfiguraçõesConfigurar o &kturtle;..., mais precisamente na seção Idioma. Observe que o idioma que definir para o &kturtle; precisa ser o mesmo idioma que usa para digitar os comandos de &logo;. + + +Primeiros passos no &logo;: apresentamos a Tartaruga! +Você já deve ter reparado que a tartaruga está no meio da área de desenho: você está agora prestes a aprender como controlá-la, usando os comandos no editor de código. + + +A Tartaruga se Move +Vamos começar colocando a tartaruga para andar. A nossa tartaruga tem 3 tipos de movimentos: (1) pode ir para a frente e para trás, (2) pode virar à esquerda ou à direita e (3) poderá ir diretamente para uma posição da tela. Tente isto, por exemplo: + +forward 100 +turnleft 90 + +Digita ou copie e cole o código no editor e execute-o (usando o ArquivoExecutar Comandos) para ver o resultado. + +Quando tiver digitado e executado os comandos acima no editor de código, você irá reparar em uma ou mais das seguintes coisas: + +Que — depois de executar os comandos — a tartaruga vai mover-se, desenhar uma linha e depois dar um quarto de volta para a esquerda. Isto acontece porque você usou os comandos forward e turnleft. + + +Que a cor do código mudou à medida que o foi digitando; este recurso chama-se realce intuitivo — os diferentes tipos de comandos são realçados de forma diferente. Isto torna a leitura de grandes blocos de código mais fácil. + + +Que a tartaruga desenha uma linha preta fina. + + +Talvez tenha obtido uma mensagem de erro. Isto poderá simplesmente significar duas coisas: você poderá ter cometido um erro ao copiar os comandos, ou você precisa de definir o idioma correto para os comandos de &logo; (o que você pode fazer isso escolhendo ConfiguraçõesConfigurar o &kturtle; na seção Idioma). + + + +Você irá da mesma forma perceber que o forward 100 mandou a tartaruga andar em frente, deixando uma linha, e que o turnleft 90 disse à tartaruga para virar 90 graus à esquerda. + +Por favor, veja as seguintes referências para o manual para uma explicação completa dos comandos inseridos: forward, backward, turnleft e turnright. + + + +Mais exemplos +O primeiro exemplo foi muito simples, por isso vamos continuar! + + + +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 + +Mais uma vez, você deverá digitar ou copiar e colar o código para o editor ou abrir o arquivo arrow.logo na pasta Abrir exemplos e executá-lo (usando a opção ArquivoExecutar Comandos) para ver o resultado. Nos próximos exemplos, iremos considerar que você já sabe a mecânica do assunto. + +Você já deve ter notado que este segundo exemplo usa muito mais código. Você deve ter visto também um conjunto de comandos novos. Aqui está uma breve explicação de todos os comandos novos: + +O canvassize 200,200 configura a largura e a altura da área de desenho para 200 pontos. A largura e a altura são iguais em tamanho, o que significa que a área de desenho deverá ser agora um quadrado. + +O canvascolor 0,0,0 deixa a área de desenho em preto. O 0,0,0 é uma combinação RGB onde todos os valores ficam iguais a 0, o que corresponde a preto. + +O pencolor 255,0,0 deixa a cor do traço em vermelho. O 255,0,0 é uma combinação RGB em que só o valor do 'vermelho' fica igual a 255 enquanto que os outros (verde e azul) ficam a 0, o que resulta num tom claro de vermelho. + +Se não compreender os valores das cores, tente por favor ler o glossário sobre as combinações RGB + +O penwidth 5 configura a espessura (ou tamanho) do traço a 5 pontos. A partir de agora, todas as linhas que a tartaruga desenhar irão ter uma espessura de 5 pontos, até que se mude o penwidth para outra coisa qualquer. + +O clear limpa a área de desenho, e é tudo o que faz. + +O go 20,20 manda a tartaruga ir para um determinado lugar da área de desenho. A contar do canto superior esquerdo, este lugar fica a 20 pontos a contar da esquerda e a 20 pontos da parte superior. Lembre-se que, ao usar o comando go, a tartaruga não irá desenhar uma linha. + +O direction 135 define a direção da tartaruga. O turnleft e o turnright mudam o ângulo da tartaruga a partir da direção atual dela. O direction muda o ângulo da tartaruga a partir do zero e, como tal, não é relativo à posição anterior da tartaruga. + +Depois do comando de direção, segue-se um conjunto de comandos forward e turnleft. Estes comandos fazem, de fato, o desenho. + +Por fim, é usado outro comando go para mover a tartaruga para o lado. + +Certifique-se de seguir as referências. Elas explicam cada comando em mais detalhes. + + + + + + + + + + + \ No newline at end of file diff --git a/tde-i18n-pt_BR/docs/tdeedu/kturtle/glossary.docbook b/tde-i18n-pt_BR/docs/tdeedu/kturtle/glossary.docbook new file mode 100644 index 00000000000..05ae1138c16 --- /dev/null +++ b/tde-i18n-pt_BR/docs/tdeedu/kturtle/glossary.docbook @@ -0,0 +1,404 @@ + + +Glossário + +Neste capítulo, você irá obter uma explicação para a maioria das palavras pouco comuns que são usadas no manual. + + + +graus +Os graus são uma unidade para medir ângulos ou voltas. Uma volta completa corresponde a 360 graus, uma meia-volta corresponde a 180 graus e um quarto-de-volta a 90 graus. Os comandos turnleft, turnright e direction necessitam de um parâmetro em graus. + + + +parâmetros e resultado dos comandos +Alguns comandos recebem parâmetros, outros devolvem resultados, outros fazem ambas as coisas e finalmente existem outros que não fazem nenhuma delas. +Alguns exemplos de comandos que só recebem parâmetros são: +forward 50 +pencolor 255,0,0 +print "olá!" + O comando forward recebe o 50 como parâmetro, porque o forward precisa deste parâmetro para saber quantos pontos deverá andar em frente. O pencolor recebe um parâmetro e o print recebe uma cadeia de caracteres com parâmetro. Lembre-se que o parâmetro também poderá ser um recipiente. O próximo exemplo ilustra isto: x = 50 +print x +texto = "olá!" +print texto + + +Agora alguns exemplos de comandos que devolvam resultados: +x = inputwindow "por favor digite algo e pressione OK... obrigado!" +r = random 1,100 + O comando inputwindow recebe um texto como parâmetro e devolve o número ou o texto que é introduzido. Como poderá ver, o resultado do inputwindow é guardado no recipiente x. O comando random também devolve um resultado. Neste caso, devolve um número entre 1 e 100. O resultado do random é de novo guardado num recipiente, chamado r. Lembre-se que os recipientes x e r não são usados no código de exemplo acima. + +Também existem alguns comandos que não precisam de parâmetros nem devolvem nada. Alguns exemplos: clear +penup +wrapon +hide + + + + + +realce intuitivo +Este é um recurso do &kturtle; que torna a codificação ainda mais simples. Com o realce intuitivo, o código que você escrever ganha uma cor que indica qual tipo de código é. Na próxima lista, você irá encontrar os diferentes tipos de código e a cor que obtém no editor de código. +Os diferentes tipos de código e a sua cor de realce + + + +comandos normais +verde escuro +Os comandos normais estão descritos aqui. + + +controladores de execução +preto (negrito) +Os comandos especiais que controlam a execução; você poderá ler mais sobre eles aqui. + + +comentários +amarelo escuro +As linhas que estão comentadas começam por caracteres de comentário (#); estas linhas são ignoradas quando o código é executado. Os comentários permitem ao programador explicar um pouco do seu código ou podem ser usadas para evitar temporariamente que um pedaço de código seja executado. + + +colchetes [, ] +verde claro (negrito) +Os colchetes são usados para agrupar pedaços de código. Os colchetes são usados normalmente com os controladores de execução. + + +o comando learn +verde claro (negrito) +O comando learn é usado para criar comandos novos. + + +números +azul +Números, bem não temos muita coisa para falar sobre eles. + + +texto +vermelho escuro +Também não há muito a dizer sobre o texto nas cadeias de caracteres, a não ser que começam e terminam com aspas ("). + + +caracteres matemáticos +cinza +Estes são os caracteres matemáticos: +, -, *, /, (, e ). Leia mais sobre eles aqui. + + +caracteres das perguntas +azul (negrito) +Leia mais sobre as perguntas aqui. + + +palavras de colagem das perguntas +cor de rosa +Leia mais sobre as palavras de colagem de perguntas ('and', 'or' e 'not') aqui. + + +texto normal +preto + + + + +
+ + + + +pontos +Um ponto é um ponto na tela. Se você olhar muito de perto para o que vê na tela do seu monitor, irá constatar que ela usa pontos. Todas as imagens da tela são criadas com estes pontos. Um ponto é a menor coisa que poderá ser desenhada na tela. +Existem vários comandos que precisam de uma quantidade de pontos como parâmetro, e são: o forward, backward, go, gox, goy, canvassize e o penwidth. + + + +Combinações de RGB (códigos de cores) +As combinações de RGB são usadas para descrever cores. O R vem de red (vermelho), o G de green (verde) e o B de blue (azul). Um exemplo de uma combinação RGB é o 255,0,0, onde o valor da componente vermelha é 255 e as outras são 0, o que resulta num tom claro de vermelho. Cada valor de uma combinação RGB terá que estar no intervalo entre 0 e 255. Aqui está uma lista com as cores mais usadas: +Combinações RGB mais usadas + + + +0,0,0preto +255,255,255branco +255,0,0vermelho +150,0,0vermelho escuro +0,255,0verde +0,0,255azul +0,255,255azul claro +255,0,255cor de rosa +255,255,0amarelo + + +
+ +Para descobrir facilmente as combinações RGB de uma cor, você deverá experimentar o extrator de cores! Você poderá encontrá-lo aqui: FerramentasExtrator de Cor. +Dois comandos necessitam de uma combinação RGB como parâmetro, e são eles: o canvascolor e o pencolor. + + + +imagem móvel +Uma imagem móvel é uma pequena imagem que pode ser movida pela tela. A nossa tartaruga é uma imagem móvel, por exemplo. +Nota: com esta versão do &kturtle;, a imagem móvel não consegue ser alterada de uma tartaruga para outra coisa. As versões futuras do &kturtle; serão capazes de fazer isso. + + + +envolvência +A envolvência é o que acontece quando a tartaruga desenha algo que é muito grande para caber na área de desenho e a envolvência está ativa Isto é o que acontece quando a envolvência está ligada Um exemplo de envolvência Quando a tartaruga passa para fora de um extremo da área de desenho ele vai passar para o extremo imediatamente oposto para que possa continuar o seu movimento. Deste modo, a tartaruga irá estar sempre na tela, enquanto se move. +A envolvência poderá ser ativada e desativada com os comandos wrapon e wrapoff. Quando o &kturtle; inicia, a envolvência está ativa por padrão. + + + + + \ No newline at end of file diff --git a/tde-i18n-pt_BR/docs/tdeedu/kturtle/index.cache.bz2 b/tde-i18n-pt_BR/docs/tdeedu/kturtle/index.cache.bz2 new file mode 100644 index 00000000000..c7daecbcc36 Binary files /dev/null and b/tde-i18n-pt_BR/docs/tdeedu/kturtle/index.cache.bz2 differ diff --git a/tde-i18n-pt_BR/docs/tdeedu/kturtle/index.docbook b/tde-i18n-pt_BR/docs/tdeedu/kturtle/index.docbook new file mode 100644 index 00000000000..b1df1d63a12 --- /dev/null +++ b/tde-i18n-pt_BR/docs/tdeedu/kturtle/index.docbook @@ -0,0 +1,371 @@ + + + + + + + + + + + + + +]> + + + + +O Manual do &kturtle; + + +Cies Breijs
cies AT kde DOT nl
+ + +Anne-Marie Mahfouf
annma AT kde DOT org
+ + + + +MarcusGama
marcus_gama@uol.com.br
Tradução + + +2004 +Cies Breijs + + +&FDLNotice; + +2004-11-8 +0.6 + + +O &kturtle; é um ambiente de programação educativo que usa a linguagem de programação &logo;. A qualidade única do LOGO é que os comandos de programação são traduzidos para o idioma do 'programador', para que ele possa programar no seu idioma nativo. + + + +KDE +tdeedu +KTurtle +educação +idioma +nativo +programação +código +Logo +instruções +tartaruga + + + + + +Introdução + +O &kturtle; é um ambiente educativo de programação utilizando a linguagem de programação &logo;. Ele tenta manter a programação tão acessível quanto possível. Isto torna o &kturtle; adequado para ensinar às crianças matemática, geometria e... programação. Os comandos usados para programar são do estilo da linguagem de programação &logo;. Um recurso único do &logo; é que os comandos são normalmente traduzidos para o idioma falado pelo programador. + +O &kturtle; tem o nome com base na tartaruga que desempenha um papel central no ambiente de programação. O usuário programa a tartaruga, usando os comandos do &logo;, para desenhar uma imagem na área de desenho. + + + + +Recursos do &kturtle; +O &kturtle; possui alguns recursos legais que tornam a introdução à programação uma leve brisa. Veja aqui alguns dos detalhes dos recursos do &kturtle;: +Um interpretador de &logo; integrado (sem dependências extras) que usa arquivos em XML para as traduções dos comandos, suporta as funções definidas pelo usuário e a mudança dinâmica de tipos. +A execução pode ser tornada mais lenta, pausada ou interrompida a qualquer momento. +Um editor poderoso para os comandos de &logo; com um realce de sintaxe intuitivo, com numeração de linhas, entre outras coisas. +A área de desenho pode ser gravada como uma imagem ou impressa. +A área de desenho tem um modo de envolvência (ativo por padrão), para que a tartaruga não se perca assim tão facilmente. +A ajuda de contexto para todos os comandos do &logo;, basta para isso pressionar F2. +Os comandos de &logo; são completamente traduzíveis (no momento da escrita deste documento são suportados o Português do Brasil, o Holandês e o Francês, o Alemão, Italiano, Esloveno, o Sérvio (Cirílico e Latim), Espanhol e Sueco no &kde;). +Um diálogo de erros que associa as mensagens de erro aos erros propriamente ditos no programa. +Uma terminologia de programação simplificada. +Modo de tela cheia. +Vários programas exemplo em &logo; integrados facilitam o início. + + + + + +&using-kturtle; + +&getting-started; + +&programming-reference; + +&glossary; + +&translator-guide; + + + +Créditos e Licença + +&kturtle; +Direitos autorais do programa 2003-2005 Cies Breijs cies AT kde DOT nl +Contribuições: +Ajuda na codificação, componente de edição: Anne-Marie Mahfouf annma AT kde DOT org + +Autor do WSBASIC (wsbasic.sourceforge.net), a base para o interpretador do &kturtle;: Walter Schreppers Walter DOT Schreppers AT ua DOT ac DOT be + +Arquivo de Dados em Alemão: Matthias Meßmer bmlmessmer AT web DOT de + +Arquivo de Dados em Alemão: Burkhard Lück lueck AT hube-lueck DOT de + +Arquivo de Dados em Sueco: Stefan Asserhäll stefan DOT asserhal AT telia DOT com + +Arquivos de Dados em Esloveno: Jure Repinc jlp@holodeck1.com + +Arquivos de Dados em Sérvio (Cirílico e Latim): Chusslove Illich caslav.ilic@gmx.net + +Arquivos de Dados em Italiano: Pino Toscano toscano.pino@tiscali.it + +Arquivos de Dados em Inglês Britânico: Andy Potter A.J.Potter@rhul.ac.uk + +Arquivo de Dados em Sueco: Stefan Asserhäll stefan DOT asserhal AT telia DOT com + +Arquivos de Dados em Português do Brasil: Riverson Rios riverson@ccv.ufc.br + +Suporte do processador de cirílico: Albert Astals Cid astals11@terra.es + + + + +Direitos autorais da documentação 2004 +Cies Briej cies AT showroommama DOT nl +Anne-Marie Mahfouf annma AT kde DOT org +Algumas alterações de correção do texto por &Philip.Rodrigues; &Philip.Rodrigues.mail; + +Ajuda de tradução atualizada e algumas mudanças de verificação editorial de Andrew Coles andrew_coles AT yahoo DOT co DOT uk + + + + +Tradução de Marcus Gamamarcus_gama@uol.com.br +&underFDL; &underGPL; + + + + +Instalação + + +Como obter o &kturtle; +&install.intro.documentation; + + +Compilação e Instalação +&install.compile.documentation; + + + +&documentation.index; + + diff --git a/tde-i18n-pt_BR/docs/tdeedu/kturtle/programming-reference.docbook b/tde-i18n-pt_BR/docs/tdeedu/kturtle/programming-reference.docbook new file mode 100644 index 00000000000..bf7ab38eb04 --- /dev/null +++ b/tde-i18n-pt_BR/docs/tdeedu/kturtle/programming-reference.docbook @@ -0,0 +1,1737 @@ + + +Referência de Programação em &logo; do &kturtle; +Esta é a referência para o &logo; do &kturtle;. Neste capítulo iremos abordar brevemente todos os tipos de instruções diferentes. Depois, serão explicados os comandos, um por um. Em seguida, serão explicados os recipientes, a matemática, as questões e os controladores de execução. Por último, será mostrado como criar os seus próprios comandos com o learn. + + +Tipos Diferentes de Instruções +Como em qualquer linguagem, o LOGO possui diferentes tipos de palavras e símbolos. Aqui as diferenças entre os tipos serão brevemente explanadas. + + +Comandos +Usando comandos, você diz à tartaruga ou ao &kturtle; para fazer algo. Alguns comandos precisam de dados de entrada, enquanto outros fornecem resultados ou dados de saída. # o 'forward' é um comando que necessita de dados de entrada, neste caso o número 100: +forward 100 + + +Para uma idéia geral de todos os comandos que o &kturtle; suporta, vá para aqui. + + + +Números +Muito provavelmente você já conhece alguma coisa sobre os números. A forma como eles são usados no &kturtle; não é muito diferente do idioma falado ou da matemática. +Temos então os números conhecidos por naturais: 0, 1, 2, 3, 4, 5, etc. Os números negativos: -1, -2, -3, etc. Finalmente, os números decimais ou fracionários, como por exemplo: 0.1, 3.14, 33.3333, -5.05, -1.0. +Os números podem ser usados em cálculos matemáticos e perguntas. Eles também podem ser colocados em recipientes. +Os números ficam realçados em azul no editor de código. + + + +Cadeias de caracteres +Primeiro um exemplo: +print "Olá, sou uma cadeia de caracteres." + Neste exemplo, o print é um comando, enquanto o "Olá, sou uma cadeia de caracteres." é, de fato, uma cadeia de caracteres. Elas começam e terminam com o símbolo "; através destes símbolos, o &kturtle; sabe que é uma cadeia de caracteres. +As cadeias de caracteres podem ser colocadas em recipientes. Porém, não podem ser usadas em cálculos matemáticos nem em questões. +As cadeias de caracteres ficam realçadas em vermelho escuro no editor de código. + + + + +Nomes +Ao usar a linguagem de programação &logo;, você pode criar coisas novas. Se criar um programa irá necessitar normalmente de recipientes e, em alguns casos, do learn para criar novos comandos. Ao criar um recipiente ou um novo comando com o learn, você terá que especificar um nome. +Você poderá escolher qualquer nome, desde que ele não tenha já algum significado. Por exemplo, não poderá chamar um recipiente de forward, uma vez que esse nome já é usado para um comando e, assim, já tem um significado. +# Aqui o forward é usado como recipiente, mas já tem um significado +# assim irá produzir um erro: +forward = 20 + +# isto funciona: +forward 20 + Os nomes só poderão conter letras, números e sublinhados (_). De qualquer forma, devem começar por uma letra. +Por favor, leia a documentação sobre os recipientes e o comando learn para uma melhor explicação e mais exemplos. + + + +Atribuições +As atribuições são feitas com o símbolo =. Nas linguagens de programação é melhor ler o = simples não como um 'é igual a' mas sim como um 'ficar igual a'. O termo 'é igual a' é mais apropriado para o ==, que é uma pergunta. +As atribuições são usadas normalmente por duas razões, (1) para adicionar conteúdo aos recipientes e (2) para modificar o conteúdo de um recipiente. Por exemplo: x = 10 +# o recipiente 'x' contém agora o número 10 +W = "A minha idade é: " +# o recipiente W contém agora o texto "A minha idade é: " +# isto imprime o conteúdo dos recipientes 'W' e 'x' na área de desenho +print W + x + + +Para mais exemplos, veja a seção que explica os recipientes. + + + +Símbolos Matemáticos +O &kturtle; suporta todos os símbolos matemáticos básicos: a adição (+), a substração (-), a multiplicação (*), a divisão (/) e os parênteses ( e ). +Para uma explicação completa e mais exemplos, veja a seção de matemática. + + + +Perguntas +Nós podem fazer perguntas simples onde a respostar será 'true' (verdadeiro) ou 'false' (falso). +O uso de perguntas é extensivamente explicado na seção perguntas. + + + +Palavras de Colagem de Perguntas +As perguntas podem ser coladas juntas com o que se denomina por 'cola das perguntas'. As palavas de colagem são o and (e), o or (ou) e uma palavra especial: a not (não). +A utilização da colagem de perguntas é explicada na seção de Colagem de Perguntas. + + + + +Comentários +Comentários são linhas que iniciam com um #. Por exemplo: +# isto é um comentário! +print "isto não é um comentário" +# a linha anterior não é um comentário, mas a próxima é: +# print "isto não é um comentário" + Nós podemos adicionar comentários ao código para nós mesmos ou para que alguém os leia. Comentários são usados para: (1) adicionar uma pequena descrição ao programa, (2) explanar como um pedaço do código funciona se ele for um pouco complicado, e (3) para 'comentar' linhas de código que devem ser (temporariamente) ignoradas (veja a última linha do exemplo). +As linhas comentadas ficam realçadas em amarelo escuro no editor de código. + + + + + + +Comandos +Ao usar os comandos, você diz à tartaruga ou ao &kturtle; para fazer algo. Alguns comandos precisam de dados de entrada, enquanto outros fornecem resultados ou dados de saída. Nesta seção iremos explicar todos os comandos que podem ser usados no &kturtle;. Observe que todos os comandos incorporados ficam realçados em verde escuro no editor de código, para que possa ajudar a distinguí-los. + + +Movendo a tartaruga +Existem vários comandos para mover a tartaruga pela tela. + + + forward (fw) + + + forward + forward X +O forward move a tartaruga para a frente X pixels. Quando o traço está em baixo, a tartaruga irá deixar um rastro. O forward pode ser abreviado para fw + + + + + backward (bw) + + + backward + backward X +O backward move a tartaruga para trás X pixels. Quando o traço está em baixo, a tartaruga irá deixar um rastro. O backward pode ser abreviado para bw. + + + + + turnleft (tl) + + + turnleft + turnleft X +O turnleft diz à tartaruga para se virar X graus para a esquerda. O turnleft pode ser abreviado para tl. + + + + + turnright (tr) + + + turnright + turnright X +O turnright diz à tartaruga para se virar X graus para a direita. O turnright pode ser abreviado para tr. + + + + + direction (dir) + + + direction + direction X +O direction configura a direção da tartaruga para um ângulo de X graus a contar do zero, e isto não é relativo à direção anterior da tartaruga. O direction pode ser abreviado para dir. + + + + + center + + + center + center +O center move a tartaruga para o centro da área de desenho. + + + + + go + + + go + go X,Y +O go manda a tartaruga ir para um determinado local da área de desenho. Este local está a X pixels do lado esquerdo da área de desenho e a Y pixels do topo da área. Lembre-se que, ao usar o comando go, a tartaruga não irá desenhar nenhuma linha. + + + + + gox + + + gox + gox X +Ao usar o comando gox, a tartaruga irá mover-se X pixels a partir da esquerda da área de desenho, mantendo-se na mesma altura. + + + + + goy + + + goy + goy Y +Ao usar o comando goy, a tartaruga irá mover-se Y pixels a partir do topo da área de desenho, mantendo-se na mesma distância do lado esquerdo da área de desenho. + + + + + + +A tartaruga tem um traço +A tartaruga tem um traço e vai desenhando uma linha à medida que a tartaruga se move. Existem alguns comandos para controlar o traço. Nesta seção iremos explicar estes comandos. + + penup (pu) + + + penup + penup +O penup levanta o traço da área de desenho. Quando o traço está em cima, não é desenhada nenhuma linha à medida que a tartaruga se move. Veja também o pendown. O penup pode ser abreviado para pu. + + + + + pendown (pd) + + + pendown + pendown +O pendown pressiona o traço para baixo na área de desenho. Quando o traço está em baixo, é desenhada uma linha à medida que a tartaruga se move. Veja também o penup. O pendown pode ser abreviado para pd. + + + + + penwidth (pw) + + + penwidth + penwidth X +O penwidth configura a espessura do traço para X pixels. O penwidth pode ser abreviado para pw. + + + + + pencolor (pc) + + + pencolor + pencolor R,G,B +O pencolor configura a cor do traço. O pencolor recebe uma combinação de RGB como parâmetro. O pencolor pode ser abreviado para pc. + + + + + + +Comandos para controlar a área de desenho +Existem vários comandos para controlar a área de desenho. + + canvassize (cs) + + + canvassize + canvassize X,Y +Com o comando canvassize você poderá alterar o tamanho da área de desenho. Ele recebe dois parâmetros (X e Y) de entrada, em que o X é a nova largura da área de desenho em pixels, e o Y é a nova altura da mesma área em pixels. O canvassize pode ser abreviado para cs. + + + + + canvascolor (cc) + + + canvascolor + canvascolor R,G,B +O canvascolor define a cor da área de desenho. O canvascolor recebe uma combinação RGB como parâmetro. O canvascolor pode ser abreviado para cc. + + + + + wrapon + + + wrapon + wrapon +Com o comando wrapon você poderá ativar a envolvência para a área de desenho. Por favor veja o glossário para saber o que é a envolvência. + + + + + wrapoff + + + wrapoff + wrapoff +Com o comando wrapoff você poderá desativar a envolvência para a área de desenho. Isto significa que a tartaruga poderá mover-se para fora da área de desenho e perder-se. Por favor veja o glossário se quiser saber o que é a envolvência. + + + + + + +Comandos para limpar +Existem dois comandos para limpar a área de desenho, depois de você ter deixado tudo bagunçado. + + clear (cr) + + + clear + clear +Com o clear, você poderá limpar todos os desenhos da área de desenho. Todo o resto permanece igual: a posição e o ângulo da tartaruga, a cor da área de trabalho, a visibilidade da tartaruga e o tamanho da área de desenho. O clear pode ser abreviado para cr. + + + + + reset + + + reset + reset +O reset limpa tudo de forma mais abrangente que o comando clear. Depois de um comando reset, tudo fica como estava quando você iniciou o &kturtle;. A tartaruga é posicionada no meio do tela, a cor da área de desenho é branca e a tartaruga irá desenhar uma linha preta na área de desenho. + + + + + + +A tartaruga é uma imagem móvel +Muitas pessoas não sabem o que são as imagens móveis ('sprites'), daí uma breve explicação: as imagens móveis são pequenas imagens que podem percorrer o tela (para mais informações, veja o glossário sobre as imagens móveis). +A seguir você irá encontrar uma apresentação completa de todos os comandos que lidam com imagens móveis. +[A versão atual do &kturtle; não suporta ainda o uso de imagens móveis além da tartaruga. Nas versões futuras, você poderá mudar a tartaruga para outra coisa que desejar] + + show + + + show (ss) + show +O show torna a tartaruga visível de novo depois de ter ficado escondida. O show pode ser abreviado para ss. + + + + + hide (sh) + + + hide + hide +O hide esconde a tartaruga. Isto pode ser usado se a tartaruga não couber no seu desenho. O hide pode ser abreviado para sh. + + + + + + +Será que as tartarugas sabem escrever? +A resposta é: sim. A tartaruga sabe escrever e pode escrever tudo o que lhe disser para escrever. + + print + + + print + print X +O comando print é usado para dizer à tartaruga para escrever algo na área de desenho. O print recebe números e texto como parâmetros. Você poderá executar o print para vários parâmetros com o sinal +. Veja aqui um pequeno exemplo: ano = 2004 +autor = "Ze" +print "O " + autor + " iniciou o projeto do KTurtle em " + ano + " e ainda continua gostando de trabalhar nele!" + + + + + + + fontsize + + + fontsize + fontsize X +O fontsize configura o tamanho da letra que é usado pelo print. O fontsize recebe um parâmetro que deverá ser um número. O tamanho é definido em pixels. + + + + + + +Um comando que joga aos dados para você +Existe um comando que lança os dados para você, que se chama random; ele é muito útil para alguns resultados inesperados. + + + random + random X,Y +O random é um comando que recebe parâmetros e devolve resultados. Como parâmetros são necessários dois números, onde o primeiro define o resultado mínimo (X) e o segundo o máximo (Y). O resultado é um número escolhido aleatoriamente que é maior ou igual ao mínimo e menor ou igual ao máximo. Aqui está um pequeno exemplo: + repeat 500 [ + x = random 1,20 + forward x + turnleft 10 - x + ] + Com o comando 'random', você poderá adicionar um pouco de confusão ao seu programa. + + + + + +Entrada de dados e reação através de janelas +Uma janela poderá pedir alguma alguma reação em especial ou a introdução de determinados dados. O &kturtle; tem dois comandos para janelas, nomeadamente o message e o inputwindow + + message + + + message + message X +O comando message recebe uma cadeia de caracteres como entrada. Mostra então uma janela que contém o texto da cadeia de caracteres. ano = 2004 +autor = "Ze" +print "O " + autor + " iniciou o projeto do KTurtle em " + ano + " e ainda continua gostando de trabalhar nele!" + + + + + + + inputwindow + + + inputwindow + inputwindow X +O inputwindow recebe uma cadeia de caracteres como entrada. Mostra uma janela que contém o texto da cadeia de caracteres, tal como acontece no message. Contudo, além disso, também mostra um campo de texto na janela. Através deste campo, o usuário poderá introduzir um número ou uma cadeia de caracteres que poderá ser guardada num recipiente. Por exemplo +in = inputwindow "Que idade você tem?" +out = 2003 - in +print "Em 2003, você tinha " + out + " anos em determinado momento." + Quando um usuário cancelar a janela ou não inserir nenhuma informação, o recipiente fica vazio. + + + + + + + + + + +Recipientes +Os recipientes são letras ou palavras que podem ser usadas pelo programador para guardar algum número ou algum texto. Os recipientes que contém um número chamam-se variáveis, enquanto que os que contém texto chamam-se cadeias de caracteres. + +Os recipientes que não são usados não contém nada. Por exemplo, um: +print N + Isto não irá imprimir nada. Se tentar fazer operações matemáticas com recipientes vazios, irá obter erros. + + +Variáveis: recipientes de números +Vamos começar com um exemplo: +x = 3 +print x + Na primeira linha, a letra x passou a ser uma variável (um recipiente de números). Como você pode ver, o valor da variável x passou para 3. Na segunda linha, o valor é impresso. +Lembre-se que, se quisermos imprimir um x, então devemos escrever print "x" + + +Isso foi fácil, mas agora há um exemplo um pouco mais difícil: +A = 2004 +B = 25 +C = A + B + +# o próximo comando imprime "2029" +print C +backward 30 +# o próximo comando imprime "2004 mais 25" +print A + " mais " + B +backward 30 +# o próximo comando imprime "1979" +print A - B + Nas duas primeiras linhas, as variáveis A e B são configuradas como sendo iguais a 2004 e 25. Na terceira linha, a variável C fica igual a A + B, o que dá 2029. O resto do exemplo consiste em 3 comandos print com backward 30 no meio. O backward 30 está lá para garantir que cada resultado fica numa linha diferente. Neste exemplo, você vê também que as variáveis podem ser usadas nos cálculos matemáticos. + + + +Recipientes de texto (cadeias de caracteres) +No código do programa, o texto normal é iniciado e termina normalmente com aspas. Como já foi visto: +print "Olá programador!" + O texto fica delimitado com as aspas. Estes pedaços de texto normal são chamados então de cadeias de caracteres. +As cadeias de caracteres são bastante parecidas com as variáveis. A maior diferença é que as cadeias de caracteres não podem ser usadas em cálculos matemáticos e perguntas. Um exemplo da utilização das cadeias de caracteres: +x = "Olá " +nome = inputwindow "por favor insira o seu nome..." +print x + nome + ", como está? + Na segunda linha, a cadeia de caracteres x fica igual a Olá . Na segunda linha, a cadeia de caracteres nome é configurada como o resultado do comando inputwindow. Na terceira linha, o programa imprime uma composição de três cadeias de caracteres na área de desenho. +Este programa pede para inserir o seu nome. Quando você, por exemplo, inserir o nome José, o programa irá imprimir Olá José, como está?. Lembre-se que o sinal de mais (+) é o único símbolo matemático que você poderá usar com as cadeias de caracteres. + + + + +Será que a Tartaruga sabe fazer contas? +Sim, o &kturtle; sabe fazer contas para você. Você poderá somar (+), subtrair (-), multiplicar (*) e dividir (/). Aqui está um exemplo no qual iremos usar todas as operações: +a = 20 - 5 +b = 15 * 2 +c = 30 / 30 +d = 1 + 1 +print "a: "+a+", b: "+b+", c: "+c+", d: "+d + Será que você sabe o valor de 'a', 'b', 'c' e 'd'? Repare por favor no uso do símbolo = de atribuição. +Se você somente queria fazer um cálculo simples, você poderá fazer algo semelhante a isto: print 2004-12 + +Agora, um exemplo com parênteses: +print ( ( 20 - 5 ) * 2 / 30 ) + 1 + O que estiver entre parênteses será calculado em primeiro lugar. Neste exemplo, o 20-5 será calculado, depois será multiplicado por 2, dividido por 30 e depois é adicionado 1 (o que dá 2). + + + +Fazendo perguntas, obtendo respostas... +O if e o while são controladores de execução que iremos discutir na próxima seção. Nesta seção iremos usar o comando if para explicar as perguntas. + +Perguntas +Um exemplo simples de pergunta: +x = 6 +if x > 5 [ + print "olá" +] + Neste exemplo, a pergunta é x > 5, se a resposta a esta pergunta for true (verdadeira), o código entre colchetes será executado. As perguntas são uma parte importante da programação e são usadas normalmente em conjunto com os controladores de execução, como o if. Todos os números e variáveis (recipientes de números) poderão ser comparados uns com os outros nas perguntas. +Aqui estão todas as perguntas possíveis: +Tipos de perguntas + + + +a == b +é igual a +a resposta é true (verdadeira) se o a for igual ao b + + +a != b +é diferente de +a resposta é true (verdadeira) se o a não for igual ao b + + +a > b +maior que +a resposta é true (verdadeira) se o a for maior que o b + + +a < b +menor que +a resposta é true (verdadeira) se o a for menor que o b + + +a >= b +maior ou igual a +a resposta é true (verdadeira) se o a for maior ou igual ao b + + +a <= b +menor ou igual a +a resposta é true (verdadeira) se o a for menor ou igual ao b + + + +
+ +As perguntas ficam realçadas em azul claro no editor de código. + + + +Colagem de Perguntas +As perguntas também podem ser coladas umas às outras com palavras de colagem de perguntas onde, desta forma, algumas perguntas tornam-se uma pergunta maior. +a = 1 +b = 5 +if (a < 5) and (b == 5) [ + print "olá" +] + Neste exemplo, a palavra de colagem and é usada para colar 2 perguntas (a < 5, b == 5) juntas. Se um lado do and der uma resposta false (falsa), a pergunta toda irá responder false, porque, com a palavra de colagem and, ambos os lados precisam ser true para que a resposta seja true (verdadeira). Por favor não se esqueça de usar os parênteses ao redor das perguntas! + +Aqui está uma visão esquemática, bem como uma explicação mais detalhada: +Palavras de colagem de perguntas + + + +and +ambos os lados têm que ser true (verdadeiros) para a resposta ser true (verdadeira) + + +or +se um dos lados for true (verdadeiros) a resposta é true (verdadeira) + + +not +Caso especial: só funciona com uma pergunta! Muda o 'true' para 'false' e o 'false' para 'true'. + + + +
+ +As palavras de colagem ficam realçadas em púrpura no editor de código. + + +and +Quando são coladas duas perguntas juntas com o and, ambos os lados do and terão que ser 'true' para que o resultado também seja 'true' (verdadeiro). Por exemplo: +a = 1 +b = 5 +if ((a < 10) and (b == 5)) and (a < b) [ + print "olá" +] + Nestes exemplo, você poderá ver uma pergunta colada a outra pergunta também colada. + + + +or +Se uma das duas perguntas coladas juntas com o or for 'true' (verdadeira), o resultado será também 'true'. Por exemplo: +a = 1 +b = 5 +if ((a < 10) or (b == 10)) or (a == 0) [ + print "olá" +] + Neste exemplo, irá ver uma pergunta colada a outra pergunta, que também está colada. + + + +not +O not é uma palavra de colagem especial porque somente funciona com uma pergunta de cada vez. not muda 'true' para 'false' e 'false' para 'true'. Um exemplo: +a = 1 +b = 5 +if not ((a < 10) and (b == 5)) [ + print "olá" +] +else +[ + print "adeus ;-)" +] + Neste exemplo a pergunta colada é 'true' ainda que o not mude-a para 'false'. Assim, no final, "adeus ;-)" é impresso na área de desenho. + + + + + + + +Controlando a execução +Os controladores de execução permitem-lhe — como o nome deles indica — controlar a execução. +Os comandos de controle de execução são realçados em verde escuro e negrito. Os colchetes são frequentemente usados juntamente com os controladores de execução e eles são realçados em verde claro. + + +Fazendo a tartaruga esperar +Se você já tentou programar um pouco no &kturtle;, você já poderá ter reparado que a tartaruga pode ser bastante rápida desenhando. Este comando faz a tartaruga andar um pouco mais devagar. + + + wait + wait X +O wait faz a tartaruga esperar X segundos. +repeat 36 [ + forward 5 + turnright 10 + wait 0.5 +] + Este código irá desenhar uma circunferência, mas a tartaruga irá esperar meio segundo a cada passo. Isto dá a noção de uma tartaruga vagarosa. + + + + + +Executar o "if" + + + + if + if pergunta [ ... ] +O código que é colocado no ... só será executado se (if) a resposta à pergunta for true (verdadeira). Por favor leia, para obter mais informações sobre perguntas, a seção de perguntas. +x = 6 +if x > 5 [ + print "O x é maior que cinco!" +] + Na primeira linha, o x é inicializado com 6. Na segunda linha, a pergunta x > 5 é feita. Uma vez que a resposta a esta pergunta é verdadeira, o controlador de execução if irá permitir que o código entre colchetes seja executado + + + + + +O ciclo "while" + + + + while + while pergunta [ ... ] +O controlador de execução while é um pouco parecido com o if. A diferença é que o while fica repetindo (em ciclo) o código entre os colchetes até que a resposta à pergunta seja false. +x = 1 +while x < 5 [ + forward 10 + wait 1 + x = x + 1 +] + Na primeira linha o x é inicializado com 1. Na segunda linha a pergunta x < 5 é feita. Uma vez que a resposta é verdadeiro o controlador de execução while inicia a execução do código entre colchetes até que a resposta à pergunta seja falso. Neste caso o código entre colchetes será executado 4 vezes, porque cada vez que a quinta linha é executada o x é aumentado de 1. + + + + + +Se não, em outras palavras: "else" + + + + else + if pergunta [ ... ] else [ ... ] +O else pode ser usado em adição ao controlador de execução if. O código entre colchetes após o else só é executado se a resposta à pergunta feita é respondida como falso. +reset +x = 4 +if x > 5 [ + print "x é maior que cinco!" +] +else +[ + print "x é menor que seis!" +] + A pergunta feita é se x é maior que 5. Uma vez que x é inicializado com 4 na primeira linha a resposta à questão é falso. Isto significa que o código entre colchetes após o else será executado. + + + + + +O ciclo "for", um ciclo de contagem + + + + for + for ponto inicial a ponto final [ ... ] +O ciclo for é um ciclo de contagem, ou seja, faz um contador para você. +for x = 1 to 10 [ + print x * 7 + forward 15 +] + Cada vez que o código entre parênteses é executado, o x é incrementado de uma unidade, até que o valor do x chegue a 10. O código entre parênteses imprime o valor de x multiplicado por 7. Depois de este programa terminar a sua execução, você irá ver a tabuada dos 7 na área de desenho. + + + + + + + + +Crie os seus próprios comandos com o <quote +>learn</quote +> +O learn é um comando muito especial, porque ele é usado para criar seus próprios comandos. O comando que você criar pode ter valores de entrada e retornar valores de saída. Vamos dar uma olhada em como um novo comando é criado: +learn circulo x [ + repeat 36 [ + forward x + turnleft 10 + ] +] + O novo comando é chamado circulo. circulo recebe um valore de entrada, um número, para configurar o tamanho do círculo. circulo não retorna nenhum valor de saída. O comando circulo pode agora ser usado como um comando normal no resto do código. Veja este exemplo: learn circulo (x) [ + repeat 36 [ + forward x + turnleft 10 + ] +] + +go 30,30 +circulo 20 + +go 40,40 +circulo 50 + + +No próximo exemplo, um comando com valor de retorno é criado. +reset + +learn multPorSi n [ + r = n * 1 + r = n * n + return r +] +i = inputwindow "Por favor insira um número e pressione OK" +print i + " multiplicado por ele mesmo é: " + multPorSi i + Neste exemplo um novo comando chamado multPorSi é criado. A entrada deste comando é multiplicada por ela mesmo e então retornada, usando o comando return. O comando return é a maneira de retornar um valor a partir de uma função que você criou. + + + diff --git a/tde-i18n-pt_BR/docs/tdeedu/kturtle/translator-guide.docbook b/tde-i18n-pt_BR/docs/tdeedu/kturtle/translator-guide.docbook new file mode 100644 index 00000000000..edd163205f7 --- /dev/null +++ b/tde-i18n-pt_BR/docs/tdeedu/kturtle/translator-guide.docbook @@ -0,0 +1,262 @@ + +Guia do Tradutor do &kturtle; +Como você já deverá saber, o recurso único da linguagem de programação &logo; é que os seus comandos são muitas vezes traduzidos para o idioma do programador. Isto remove uma barreira para alguns que aprendizes obtenham os fundamentos da programação. Ao traduzir o &kturtle; para um novo idioma, deverão ser traduzidos mais alguns arquivos, além das mensagens e documentação normais. Contudo, a maior parte disto é gerado automaticamente pelos programas de Rafael Beccar. Estes programas poderão ser encontrados em tdeedu/kturtle/scripts, enquanto os arquivos que necessitam de traduções poderão ser encontrados em tdeedu/kturtle/data; nestas pastas também irá encontrar os arquivos README que contêm as instruções para os usar/traduzir. + + +Criando um Dicionário para Guardar os Arquivos Traduzidos +Primeiro, você precisa criar uma pasta para guardar os arquivos traduzidos. Crie uma pasta chamada tde-i18n/código/data/tdeedu/kturtle/ na sua pasta de CVS do KDE, onde o código é o código do seu país (o código ISO de 2 ou 4 letras). +Copie o arquivo Makefile.am de tdeedu/kturtle/data/ para esta pasta. Abra-o com o seu editor de texto favorito, substitua todas as instâncias de en_US no arquivo pelo seu código de país (o que é usado acima) e grave o arquivo. + + +Como Traduzir as Palavras-Chave (Comandos) do &logo; + + +Copie o arquivo logokeywords.en_US.xml, mudando o seu nome para logokeywords.codigo.xml em que o codigo é o código do seu país (para o Brasil, é o br). + +Traduza para o seu próprio idioma o conteúdo da marca keyword, &ie; a informação entre o keyword e o keyword sempre que possível e o conteúdo da marca alias, &ie; a informação entre o alias e o alias. Estas informações estão relacionadas, uma vez que o conteúdo do 'alias' é um nome alternativo ou atalho para a palavra-chave. +Por exemplo, o while traduz-se em português para: keywordenquantokeyword. +Por favor não traduza mais nada e não traduza as palavras em inglês no command name="palavra_em_ingles". Estas terão que permanecer em Inglês. +Última coisa: não altere a ordem deste arquivo, uma vez que ela é necessária para os programas de geração automática das traduções do Rafael Beccar. + +Salve o seu arquivo como UTF-8 (no &kate;, use o Salvar Como... e mude para UTF-8 na lista à direita do nome do arquivo). + +Envie o seu arquivo por CVS (adicione o nome do seu arquivo ao Makefile.am) ou envie-o para a Anne-Marie. + +Em caso de qualquer dúvida, por favor contacte a Anne-Marie Mahfouf annemarie.mahfouf@free.fr para mais informações. + + + + + + +Como Traduzir os Arquivos de Realce de Sintaxe +A tradução do arquivo logohighlightstyle.en_US.xml é bastante fácil, se usar o programa do Rafael Beccar em tdeedu/kturtle/data/. Certifique-se de ler antes o arquivo README nessa pasta. +Por uma razão de compatibilidade com todas as pessoas que não desejam a benção programada em Perl mencionada no parágrafo anterior, existe ainda a maneira à antiga de fazer isso: +Copie o arquivo logohighlightstyle.en_US.xml, mudando o nome dele para logohighlightstyle.codigo.xml em que o codigo é o código de 2 ou 4 letras ISO do seu país (no caso do Brasil, é o 'br'). + +A linha 4 do arquivo, tem um language name="en_US" ..., o qual você deverá alterar para o código ISO do seu idioma (pt_BR, para o Português do Brasil). +Traduza para o seu próprio idioma o conteúdo da marca item i.e a informação entre o item e o item. Este conteúdo deverá ter uma correspondência ao arquivo logokeyword. Por exemplo, traduza o while para: item enquanto item e deixe os espaços tal como estão (um no início e um no fim). Por favor não traduza mais nada. +Salve o seu arquivo como UTF-8 (no &kate;, use o Salvar Como... e mude para UTF-8 na lista à direita do nome do arquivo). +Envie o seu arquivo por CVS (adicione o nome do seu arquivo ao Makefile.am) ou envie-o para a Anne-Marie. +Em caso de qualquer dúvida, por favor contacte a Anne-Marie Mahfouf annemarie.mahfouf@free.fr para mais informações. + + + + + +Como Traduzir os Exemplos +Mais uma vez, esta tarefa é bastante simplficada pelo programa do Rafael Beccar em tdeedu/kturtle/data/. Certifique-se por favor de ler o arquivo README nessa pasta, uma vez que ainda é necessário fazer algum trabalho, após os arquivos de exemplo em Logo serem traduzidos automaticamente. +Quando seguir as instruções indicadas no arquivo README que encontrou na pasta do programa, já deverá ter tudo pronto. Não se esqueça por favor de testar o código em Logo traduzido que criou, uma vez que é muito fácil inserir alguns erros. Garanta também por favor que o arquivo Makefile.am no tde-i18n/código/data/tdeedu/kturtle/ está atualizao de acordo com os arquivos novos. Para o Holandês, o arquivo Makefile.am deverá ficar semelhante ao seguinte: 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) + + +Aqui está uma descrição de como fazer a tradução SEM utilizar os programas em Perl do Rafael: +Copie os exemplos em Inglês da pasta tdeedu/kturtle/data/ e mude os nomes dos arquivos de acordo com a tradução para o seu idioma: isto permitirá aos usuários perceberem rápida e facilmente o objetivo do exemplo. + +Traduza as palavras-chave nos exemplos, usando as do logokeywords.xml para o seu idioma. O arquivo de palavras-chave deverá estar terminado, em primeiro lugar, antes de traduzir os exemplos. + +Salve o seu arquivo como utf-8 (no &kate;, use o Salvar Como... e mude para UTF-8 na lista à direita do nome do arquivo) + +Envie a sua pasta (adicione um Makefile.am dentro dela) ou envie-a para a Anne-Marie. + +Em caso de alguma dúvida, por favor contacte a Anne-Marie Mahfouf, annemarie.mahfouf@free.fr para mais informações. + +Finalmente, se você quiser, poderá adicionar os seus próprios exemplos nesta pasta. + + + + + + diff --git a/tde-i18n-pt_BR/docs/tdeedu/kturtle/using-kturtle.docbook b/tde-i18n-pt_BR/docs/tdeedu/kturtle/using-kturtle.docbook new file mode 100644 index 00000000000..e98011582a3 --- /dev/null +++ b/tde-i18n-pt_BR/docs/tdeedu/kturtle/using-kturtle.docbook @@ -0,0 +1,1107 @@ + + +Usando o &kturtle; + + + Aqui está uma imagem do &kturtle; em ação + + + + + + Janela Principal do &kturtle; + + + + +A janela principal do &kturtle; tem dois componentes principais, o editor de código (3) à esquerda, onde você escreve os comandos de &logo; e a área de desenho (4) à direita, onde as instruções são visualizadas. A área de desenho é a área de recreio da tartaruga; é na área de desenho que a tartaruga se move e desenha. Os três outros locais da janela principal são: o menu (1) onde todas as ações podem ser acessadas, a barra de ferramentas (4) que lhe permite selecionar rapidamente as ações mais utilizadas e a barra de estado (5) onde você irá encontrar algumas informações sobre o estado do &kturtle;. + + +O Editor de Código +No editor de código, você poderá escrever os comandos de &logo;. Ele tem todos os recursos que você poderia esperar num editor moderno. A maioria dos seus recursos são encontrados nos menus Editar e Ferramentas. O editor de código pode ser acoplado a qualquer um dos lados da janela principal ou poderá ser destacado e colocado em qualquer local da sua tela. +Você dispõe de várias formas de obter algum código no editor. A forma mais fácil é usar um exemplo já feito. Você escolhe o ArquivoAbrir Exemplos no menu Arquivo, onde poderá clicar num arquivo. O nome do arquivo lhe dirá algo sobre o que é o exemplo (por exemplo, o 'square.logo' vai desenhar um quadrado ('square'). O arquivo que escolher será aberto no editor de código, você poderá ir então a ArquivoExecutar Comandos para rodar o código se desejar. +Você poderá abrir os arquivos de &logo; escolhendo ArquivoAbrir. +A terceira forma é escrever diretamente o seu código no editor ou copiar/colar algum código deste guia do usuário. +A posição do cursor é indicada na barra de estado à direita, com o número da Linha e da Coluna. + + + +A Área de Desenho +A área de desenho é a área onde os comandos são visualizados, ou seja, onde eles desenham uma imagem. Em outras palavras, é o espaço de recreio da tartaruga. Depois de introduzir algum código no editor de código e de executá-lo com ArquivoExecutar Comandos, duas coisas poderão acontecer: ou o código se executa com perfeição e você poderá ver algo mudando na área de desenho, ou você tem um erro no seu código e existirá uma mensagem que lhe dirá qual o erro que você cometeu. +Esta mensagem deverá ajudá-lo a resolver o erro. +A imagem que é desenhada pode ser gravada num arquivo (usando o ArquivoSalvar a Área de Desenho) ou impressa (usando o ArquivoImprimir...). + + + +A Barra de Menu +No menu, você irá encontrar todas as ações do &kturtle;. Elas estão nos seguintes grupos: Arquivo, Editar, Ver, Ferramentas, Configurações e Ajuda. Esta seção descreve todas estas opções. + + +O Menu <guimenu +>Arquivo</guimenu +> + + +Novo + + + &Ctrl;N Arquivo Novo + Cria um arquivo de &logo; novo, vazio. + + + + +Abrir + + + &Ctrl;O Arquivo Abrir... + Abre um arquivo de &logo;. + + + + +Abrir Recente + + + Arquivo Abrir Recente + Abre um arquivo de &logo; que foi aberto recentemente. + + + + +Abrir Exemplos + + + &Ctrl;E Arquivo Abrir Exemplos + Mostra a pasta com os programas de exemplo do &logo;. Os exemplos deverão estar no seu idioma favorito, que poderá ser escolhdio em ConfiguraçõesConfigurar o &kturtle;.... + + + + +Executar + + + &Alt;Return Arquivo Executar Comandos + Inicia a execução dos comandos no editor de código. + + + + +Salvar + + + &Ctrl;S Arquivo Salvar + Salva o arquivo de &logo; aberto atualmente. + + + + +Salvar Como + + + Arquivo Salvar Como... + Salva o arquivo de &logo; aberto atualmente num local especificado. + + + + +Salvar a Área de Desenho + + + Arquivo Salvar Área de Desenho + Salva a imagem desenhada na área de desenho num arquivo. + + + + +Pausa + + + Pause Arquivo Pausar a Execução + Coloca a execução em pausa. Esta ação só fica ativa quando os comandos estiverem de fato sendo executados. + + + + +Parar + + + Escape Arquivo Parar Execução + Pára a execução; esta ação só fica ativa quando os comandos estiverem de fato sendo executados. + + + + +Velocidade de Execução + + + Arquivo Velocidade de Execução + Apresenta uma lista com as velocidades de execução possíveis, consistindo em: Toda Velocidade, Lento, Mais Lento e Lentíssimo. Quando a velocidade é igual a 'Toda Velocidade' (padrão), você poderá não conseguir ver o que está acontecendo. Em alguns dos casos este comportamento poderá ser o desejado, mas noutros casos você poderá querer ter uma idéia da execução. No último caso, poderá desejar configurar a velocidade da execução como 'Lento', 'Mais Lento' e 'Lentíssimo'. Quando um dos modos lentos for selecionado, a posição atual de execução será mostrada no editor. + + + + +Imprimir + + + &Ctrl;P Arquivo Imprimir... + Imprime o código atual no editor ou então o desenho gerado na área de desenho. + + + + +Sair + + + &Ctrl;Q Arquivo Sair + Sai do &kturtle;. + + + + + + + O Menu <guimenu +>Editar</guimenu +> + + + + &Ctrl;Z Editar Desfazer + Anula a última alteração ao código. O &kturtle; pode fazer anulações de forma ilimitada. + + + + + + &Ctrl;&Shift;Z Editar Refazer + Refaz uma alteração anulada ao código. + + + + + + &Ctrl;X Editar Cortar + Corta o texto selecionado do editor de código para a área de transferência. + + + + + + &Ctrl;C Editar Copiar + Copia o texto selecionado do editor de código para a área de transferência. + + + + + + &Ctrl;V Editar Colar + Cola o texto na área de transferência no editor. + + + + + + &Ctrl;F Editar Procurar... + Com esta ação, você poderá procurar frases no código. + + + + + + F3 Editar Procurar Próximo + Use isto para procurar a próxima ocorrência da frase. + + + + + + &Ctrl;R Editar Substituir... + Com esta ação, você poderá substituir frases no código. + + + + + + O Menu <guimenu +>Ver</guimenu +> + + + + &Ctrl;&Shift;F Ver Modo Tela Cheia + Com esta ação, você ativa ou desativa o modo de tela cheia. + Nota: Quando o código é executado, estando no modo de tela cheia, tudo exceto a área de desenho fica escondido. Isto torna possível criar programas de tela cheia no &kturtle;. + + + + + + F11 Ver Mostrar Números de Linha + Com esta ação, você poderá mostrar os números de linha no editor de código. Isto poderá ser útil para procurar um erro. + + + + + + O Menu <guimenu +>Ferramentas</guimenu +> + + + + &Alt;C Ferramentas Extrator de Cor + Esta ação abre o extrator de cores. Com este extrator, você poderá selecionar facilmente um código de cores e inserí-lo no editor de código. + + + + + + &Ctrl;I Ferramentas Indentar + Esta ação indenta (adiciona espaços em branco) as linhas que estão selecionadas. Quando a 'indentação' é usada convenientemente, isto poderá tornar o código muito mais fácil de ler. Todos os exemplos usam indentação, por isso veja-os, por favor. + + + + + + &Ctrl;&Shift;I Ferramentas Desindentar + Esta ação desindenta (remove os espaços em branco no início) as linhas que estão selecionadas. + + + + + + Ferramentas Limpar Indentação + Est ação limpa a indentação (remove todos os espaços em branco no início) das linhas que estão selecionadas. + + + + + + &Ctrl;D Ferramentas Comentar + Esta ação adiciona caracteres de comentário (#) ao início das linhas que são selecionadas. As linhas que começam com um carácter de comentário são ignoradas quando o código é executado. Os comentários permitem ao programador explicar um pouco o seu código ou podem ser usadas para evitar temporariamente que um determinado pedaço de código seja executado. + + + + + + &Ctrl;&Shift;D Ferramentas Descomentar + Esta ação remove os caracteres de comentários das linhas selecionadas. + + + + + + O Menu <guimenu +>Configurações</guimenu +> + + + +Configurações Mostrar/Ocultar Barra de Ferramentas +Ativa ou desativa a Barra Principal + + + + + +Configurações Mostrar/Ocultar Barra de Estado +Alterna a Barra de Estado + + + + + + Configurações Configurações Avançadas + Aqui você poderá alterar as coisas que você normalmente não necessita mudar. O sub-menu da Configurações Avançadas possui três itens: Configurar o Editor... (a janela de configuração padrão do editor &kate;), Configurar os Atalhos... (a janela de configuração de atalhos padrão do &kde;) e a Configurar as Barras de Ferramentas... (a janela de configuração da barra de ferramentas do &kde;). + + + + + + Configurações Configurar o &kturtle;... + Isto é usado para configurar o &kturtle;. Aqui você poderá mudar o idioma dos comandos de &logo; ou definir um novo tamanho inicial para a área de desenho. + + + + + + + O Menu <guimenu +>Ajuda</guimenu +> + + + + Ajuda Manual do &kturtle; + Esta ação mostra o manual que você está atualmente lendo. + + + + + + &Shift;F1 Ajuda O Que É Isto? + Depois de ativar esta ação, a seta do cursor irá mudar para uma seta com ponto de interrogação. Este novo tipo de seta é usado para clicar em partes da janela principal do &kturtle;, aparecerá uma descrição da componente em particular. + + + + + + F2 Ajuda Ajuda sobre: ... + Esta é uma função bastante útil; ela fornece ajuda sobre o código sobre o qual o cursor se encontra. Por isso, por exemplo, você poderá usar o comando print no seu código, e poderá querer ler para saber o que o manual diz sobre este comando. Você poderá mover o cursor para cima do comando print e clicar em F2. O manual irá então mostrar toda a informação sobre o comando print. + Esta função é muito importante durante a aprendizagem da programação. + + + + + + Ajuda Comunicar um Erro... + Use isto para comunicar um problema no &kturtle; para os programadores. Estes relatórios podem ser usados para tornar as versões futuras do &kturtle; melhores. + + + + + + Ajuda Sobre o &kturtle; + Aqui você poderá encontrar informações sobre o &kturtle;, como os seus autores e a licença em que ele se baseia. + + + + + + Ajuda Sobre o &kde; + Aqui você poderá encontrar informações sobre o &kde;. Se não souber ainda o que é o &kde;, este é um local que você não poderá perder. + + + + + + + +A Barra de Ferramentas +Aqui você poderá acessar rapidamente às funções mais usadas. Por padrão, você irá encontrar aqui todos os comandos mais úteis, terminando nos ícones Executar os Comandos e o Parar a Execução. +Você poderá configurar a barra de ferramentas usando o menu ConfiguraçõesConfigurações AvançadasConfigurar Barra de Ferramentas... + + + +A Barra de Estado +Na barra de estado você poderá saber o estado do &kturtle;. Do lado esquerdo, ela fornece o resultado sobre a última ação. Do lado direito, você encontra a localização atual do cursor (os números da linha e da coluna). No meio da barra de estado é indicado idioma usado para os comandos. + + + -- cgit v1.2.1