diff options
Diffstat (limited to 'tde-i18n-it/docs/tdebase/kate')
| -rw-r--r-- | tde-i18n-it/docs/tdebase/kate/Makefile.am | 4 | ||||
| -rw-r--r-- | tde-i18n-it/docs/tdebase/kate/Makefile.in | 635 | ||||
| -rw-r--r-- | tde-i18n-it/docs/tdebase/kate/advanced.docbook | 2336 | ||||
| -rw-r--r-- | tde-i18n-it/docs/tdebase/kate/configuring.docbook | 2606 | ||||
| -rw-r--r-- | tde-i18n-it/docs/tdebase/kate/fundamentals.docbook | 1089 | ||||
| -rw-r--r-- | tde-i18n-it/docs/tdebase/kate/highlighting.docbook | 1380 | ||||
| -rw-r--r-- | tde-i18n-it/docs/tdebase/kate/index.cache.bz2 | bin | 0 -> 59582 bytes | |||
| -rw-r--r-- | tde-i18n-it/docs/tdebase/kate/index.docbook | 496 | ||||
| -rw-r--r-- | tde-i18n-it/docs/tdebase/kate/man-kate.1.docbook | 294 | ||||
| -rw-r--r-- | tde-i18n-it/docs/tdebase/kate/mdi.docbook | 366 | ||||
| -rw-r--r-- | tde-i18n-it/docs/tdebase/kate/menus.docbook | 2224 | ||||
| -rw-r--r-- | tde-i18n-it/docs/tdebase/kate/part.docbook | 988 | ||||
| -rw-r--r-- | tde-i18n-it/docs/tdebase/kate/plugins.docbook | 39 | ||||
| -rw-r--r-- | tde-i18n-it/docs/tdebase/kate/regular-expressions.docbook | 1216 |
14 files changed, 13673 insertions, 0 deletions
diff --git a/tde-i18n-it/docs/tdebase/kate/Makefile.am b/tde-i18n-it/docs/tdebase/kate/Makefile.am new file mode 100644 index 00000000000..aa6dfafb23e --- /dev/null +++ b/tde-i18n-it/docs/tdebase/kate/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = it +SUBDIRS = $(AUTODIRS) +KDE_DOCS = kate +KDE_MANS = AUTO diff --git a/tde-i18n-it/docs/tdebase/kate/Makefile.in b/tde-i18n-it/docs/tdebase/kate/Makefile.in new file mode 100644 index 00000000000..209e8327360 --- /dev/null +++ b/tde-i18n-it/docs/tdebase/kate/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/tdebase/kate +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 = it +#>- SUBDIRS = $(AUTODIRS) +#>+ 1 +SUBDIRS =. +KDE_DOCS = kate +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/tdebase/kate/Makefile'; \ +#>- cd $(top_srcdir) && \ +#>- $(AUTOMAKE) --gnu docs/tdebase/kate/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/tdebase/kate/Makefile'; \ + cd $(top_srcdir) && \ + $(AUTOMAKE) --gnu docs/tdebase/kate/Makefile + cd $(top_srcdir) && perl ../scripts/admin/am_edit -p../scripts/admin docs/tdebase/kate/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=fundamentals.docbook configuring.docbook Makefile.in man-kate.1.docbook plugins.docbook index.docbook part.docbook highlighting.docbook menus.docbook advanced.docbook regular-expressions.docbook Makefile.am mdi.docbook index.cache.bz2 + +#>+ 24 +index.cache.bz2: $(srcdir)/index.docbook $(KDE_XSL_STYLESHEET) regular-expressions.docbook man-kate.1.docbook part.docbook mdi.docbook index.docbook menus.docbook advanced.docbook fundamentals.docbook configuring.docbook plugins.docbook highlighting.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)/kate + @if test -f index.cache.bz2; then \ + echo $(INSTALL_DATA) index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/; \ + $(INSTALL_DATA) index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/; \ + elif test -f $(srcdir)/index.cache.bz2; then \ + echo $(INSTALL_DATA) $(srcdir)/index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/; \ + $(INSTALL_DATA) $(srcdir)/index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/; \ + fi + -rm -f $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/common + $(LN_S) $(kde_libs_htmldir)/$(KDE_LANG)/common $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/common + +uninstall-docs: + -rm -rf $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate + +clean-docs: + -rm -f index.cache.bz2 + + +#>+ 13 +install-nls: + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate + @for base in regular-expressions.docbook man-kate.1.docbook part.docbook mdi.docbook index.docbook menus.docbook advanced.docbook fundamentals.docbook configuring.docbook plugins.docbook highlighting.docbook ; do \ + echo $(INSTALL_DATA) $$base $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/$$base ;\ + $(INSTALL_DATA) $(srcdir)/$$base $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/$$base ;\ + done + +uninstall-nls: + for base in regular-expressions.docbook man-kate.1.docbook part.docbook mdi.docbook index.docbook menus.docbook advanced.docbook fundamentals.docbook configuring.docbook plugins.docbook highlighting.docbook ; do \ + rm -f $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/$$base ;\ + done + + +#>+ 5 +distdir-nls: + for file in regular-expressions.docbook man-kate.1.docbook part.docbook mdi.docbook index.docbook menus.docbook advanced.docbook fundamentals.docbook configuring.docbook plugins.docbook highlighting.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/tdebase/kate/Makefile'; \ + cd $(top_srcdir) && \ + $(AUTOMAKE) --gnu docs/tdebase/kate/Makefile + cd $(top_srcdir) && perl ../scripts/admin/am_edit -p../scripts/admin docs/tdebase/kate/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-it/docs/tdebase/kate/advanced.docbook b/tde-i18n-it/docs/tdebase/kate/advanced.docbook new file mode 100644 index 00000000000..e18f2f87914 --- /dev/null +++ b/tde-i18n-it/docs/tdebase/kate/advanced.docbook @@ -0,0 +1,2336 @@ +<chapter id="advanced-editing-tools"> +<chapterinfo> +<authorgroup> +<author +>&Anders.Lund; &Anders.Lund.mail;</author> +<author +>&Dominik.Haumann; &Dominik.Haumann.mail;</author> +<othercredit role="translator" +><firstname +>Nicola</firstname +> <surname +>Ruggero</surname +> <affiliation +><address +><email +>nicola@nxnt.org</email +></address +></affiliation +><contrib +>Traduzione della documentazione.</contrib +></othercredit +><othercredit role="translator" +><firstname +>Luciano</firstname +><surname +>Montanaro</surname +><affiliation +><address +><email +>mikelima@cirulla.net</email +></address +></affiliation +><contrib +>Aggiornamento per Kate 2.5.6</contrib +></othercredit +> +</authorgroup> +</chapterinfo> +<title +>Strumenti avanzati di modifica</title> + +<sect1 id="advanced-editing-tools-comment"> + +<title +>Commenta/Decommenta</title> + +<para +>I comandi Commenta e Decommenta, disponibili nel menu <guimenu +>Strumenti</guimenu +> permettono di aggiungere o rimuovere indicatori di commento alla selezione, o alla riga attuale del testo se non hai selezionato niente, a patto che i commenti facciano parte del formato di testo del documento.</para> + +<para +>Le regole su come è applicato il commento sono definite in base alla sintassi del testo che stai scrivendo, quindi se non hai selezionato una modalità di evidenziazione, non potrai usare Commenta/Decommenta. </para> + +<para +>Alcuni formati usano indicatori di commento per righe singole, altri usano indicatori per più righe consecutive di commento ed altri ancora entrambi i sistemi. Se i marcatori multiriga non sono disponibili, commentare una selezione che non comprenda completamente la'ultima riga non è possibile.</para> + +<para +>Se sono disponibili i marcatori per righe singole è preferibile usarli ogni volta che è possibile, perché ciò evita i problemi dei commenti nidificati.</para> + +<para +>Quando rimuovi gli indicatori di commento devi fare attenzione a non selezionare testo che non fa parte del commento. Quando rimuovi i commenti su più righe da una selezione, gli spazi vuoti al di fuori degli indicatori di commento sono ignorati.</para> + +<para +><indexterm +><primary +>commentare</primary +></indexterm +> Per inserire gli indicatori di commento, usa il comando <menuchoice +><guimenu +>Strumenti</guimenu +><guimenuitem +>Commenta</guimenuitem +></menuchoice +> oppure la relativa scorciatoria da tastiera, quella predefinita è <keycombo action="simul" +>&Ctrl;<keycap +>#</keycap +></keycombo +>.</para> + +<para +><indexterm +><primary +>decommentare</primary +></indexterm +> Per rimuovere gli indicatori di commento, usa il comando <menuchoice +><guimenu +>Strumenti</guimenu +><guimenuitem +>Decommenta</guimenuitem +></menuchoice +> oppure la relativa scorciatoia da tastiera; quella predefinita è <keycombo action="simul" +>&Ctrl;&Shift;<keycap +>#</keycap +></keycombo +>.</para> + +</sect1> + +<sect1 id="advanced-editing-tools-commandline"> +<title +>La riga di comando per il componente dell'editor</title> + +<para +>Il componente dell'editor di &kate; ha una riga di comando interna che permette di effettuare varie azioni da una GUI minima. La riga di comando è una casella di testo nella parte inferiore dell'area di modifica, per mostrarla seleziona <menuchoice +><guimenu +>Visualizza</guimenu +><guimenuitem +>Passa alla riga di comando</guimenuitem +></menuchoice +> o usa la scorciatoia (<keycombo action="simul" +><keycap +>F7</keycap +></keycombo +>). L'editor fornisce l'insieme di comandi documentati di seguito, e comandi aggiuntivi sono forniti con i plugin.</para> + +<para +>Per eseguire un comando, scrivilo e premi il tasto Invio. La riga di comando indicherà se ha avuto successo ed eventualmente mostrerà un messaggio. Se hai attivato la riga di comando premendo <keycap +>F7</keycap +>, verrà nascosta automaticamente dopo qualche secondo. Per pulire la riga ed inserire un nuovo comando, premi di nuovo <keycap +>F7</keycap +>.</para> + +<para +>La riga di comando ha un sistema di aiuto integrato, usa il comando <command +>help</command +> per iniziare. Per vedere un elenco di tutti i comandi disponibili usa <command +>help list</command +>, per vedere l'aiuto di un comando specifico usa <command +>help <replaceable +>comando</replaceable +></command +>.</para> + +<para +>La riga di comando si ricorda la cronologia dei comandi, per cui puoi riutilizzare i comandi che hai già inserito. Per scorrere la cronologia, usa i tasti <keycap +>Freccia su</keycap +> e <keycap +>Freccia giù</keycap +>. Quando vengono mostrati i comandi della cronologia, la parte degli argomenti del comando è selezionata, in modo da permetterti di sovrascrivere semplicemente gli argomenti.</para> + +<sect2 id="advanced-editing-tools-commandline-commands"> +<title +>I comandi standard della riga di comando</title> + +<sect3 id="advanced-editing-tools-commandline-commands-configure"> +<title +>Comandi per la configurazione dell'editor</title> + +<para +>Questi comandi sono forniti dal componente dell'editor e permettono di configurare solo il documento attivo e la vista. Sono utili se vuoi usare impostazioni diverse da quelle predefinite, ad esempio per i rientri. </para> + +<variablelist> +<title +>Tipi di argomento</title> + +<varlistentry> +<term +>BOOLEAN</term> +<listitem +><para +>Questo tipo è usato nei comandi che devono attivare o disattivare una caratteristica. I valori ammessi sono <userinput +>on</userinput +>, <userinput +>off</userinput +>, <userinput +>true</userinput +>, <userinput +>false</userinput +>, <userinput +>1</userinput +> o <userinput +>0</userinput +></para +></listitem> +</varlistentry> + +<varlistentry> +<term +>INTEGER</term> +<listitem +><para +>Un numero intero</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>STRING</term> +<listitem +><para +>Una stringa</para +></listitem> +</varlistentry> + +</variablelist> + +<variablelist> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-tab-width</command +><arg +>INTEGER ampiezza</arg +></cmdsynopsis +></term> +<listitem +><para +>Imposta l'ampiezza della tabulazione al numero <userinput +>ampiezza</userinput +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-indent-width</command +><arg +>INTEGER ampiezza</arg +></cmdsynopsis +></term> +<listitem +><para +>Imposta l'ampiezza dell'indentazione al numero <userinput +>ampiezza</userinput +>. È usata solo se stai indentando con gli spazi.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-word-wrap-column</command +><arg +>INTEGER ampiezza</arg +></cmdsynopsis +></term> +<listitem +><para +>Imposta l'ampiezza della riga al numero <userinput +>ampiezza</userinput +>. È usata se il testo deve andare a capo automaticamente.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-icon-border</command +><arg +>BOOLEAN abilitazione</arg +> </cmdsynopsis +></term> +<listitem +><para +>Imposta la visibilità del bordo per le icone.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-folding-markers</command +><arg +>BOOLEAN abilitazione</arg +></cmdsynopsis +></term> +<listitem +><para +>Imposta la visibilità del pannello per gli indicatori di raggruppamento.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-line-numbers</command +><arg +>BOOLEAN abilitazione</arg +></cmdsynopsis +></term> +<listitem +><para +>Imposta la visibilità del pannello per i numeri di riga.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-replace-tabs</command +><arg +>BOOLEAN abilitazione</arg +></cmdsynopsis +></term> +<listitem +><para +>Se è abilitata, le tabulazioni sono sostituiti con spazi durante l'inserimento. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-remove-trailing-space</command +><arg +>BOOLEAN abilitazione</arg +></cmdsynopsis +></term> +<listitem +><para +>Se è abilitata, gli spazi in fin di riga vengono rimossi quando il cursore lascia una riga.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-show-tabs</command +><arg +>BOOLEAN abilitazione</arg +></cmdsynopsis +></term> +<listitem +><para +>Se è abilitata, i caratteri Tab e gli spazi bianchi in fin di riga saranno evidenziati con dei puntini.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-indent-spaces</command +><arg +>BOOLEAN abilitazione</arg +></cmdsynopsis +></term> +<listitem +><para +>Se è abilitata, l'editor farà rientrare il testo di <option +>indent-width</option +> spazi ad ogni livello di rientro, invece che di un carattere di tabulazione.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-mixed-indent</command +><arg +>BOOLEAN abilitazione</arg +></cmdsynopsis +></term> +<listitem +><para +>Se abilitazione vale true, kate userà una miscela di Tab e spazi per i rientri delle righe. Ciascun livello di rientro sarà largo <option +>indent-width</option +>, e più livelli di rientro saranno ottimizzati usando il maggior numero possibile di caratteri Tab.</para> +<para +>Quando viene eseguito, questo comando inoltre abilita i rientri con gli spazi, e se l'ampiezza dei rientri non è specificata, sarà impostata alla metà di <option +>tab-width</option +> del documento al momento dell'esecuzione.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-word-wrap</command +><arg +>BOOLEAN abilitazione</arg +></cmdsynopsis +></term> +<listitem +><para +>Abilita o disabilita l'a capo automatico dinamico a seconda del parametro <userinput +>abilitazione</userinput +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-replace-tabs-save</command +><arg +>BOOLEAN abilitazione</arg +></cmdsynopsis +></term> +<listitem +><para +>Quando è attiva questa opzione, le tabulazioni verranno sostituite con spazi durante il salvataggio del documento.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-remove-trailing-space-save</command +><arg +>BOOLEAN abilitazione</arg +></cmdsynopsis +></term> +<listitem +><para +>Quando è attiva questa opzione, gli spazi alla fine delle righe saranno scartati durante il salvataggio del documento.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-indent-mode</command +><arg +>nome</arg +></cmdsynopsis +></term> +<listitem +><para +>Imposta la modalità di autoindentazione a <userinput +>nome</userinput +>. Se <userinput +>nome</userinput +> è sconosciuto, la modalità sarà impostata a "none". Le modalità valide sono 'cstyle', 'csands', 'xml', 'python', 'varindent' e 'none'.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-highlight</command +><arg +>evidenziazione</arg +></cmdsynopsis +></term> +<listitem +><para +>Seleziona il sistema di evidenziazione della sintassi per il documento. L'argomento deve essere un nome di evidenziazione valido, così come è mostrato nel menu <menuchoice +><guimenu +>Strumenti</guimenu +><guisubmenu +>Evidenziazione</guisubmenu +></menuchoice +>. Questo comando fornisce una lista per l'autocompletamento dell'argomento.</para +></listitem> +</varlistentry> + +</variablelist> + +</sect3> + +<sect3 id="advanced-editing-tools-commandline-commands-edit"> +<title +>Comandi per la modifica</title> + +<para +>Questi comandi servono a modificare il documento corrente.</para> + +<variablelist> +<varlistentry> +<term +><cmdsynopsis +><command +>indent</command +></cmdsynopsis +></term> +<listitem +><para +>Fa rientrare le righe selezionate o la riga attuale.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>unindent</command +></cmdsynopsis +></term> +<listitem +><para +>Elimina un passo di rientro delle righe selezionate o della riga attuale.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>cleanindent</command +></cmdsynopsis +></term> +<listitem +><para +>Riordina l'indentazione delle righe selezionate o della riga attuale secondo le impostazioni per l'indentazione del documento. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>comment</command +></cmdsynopsis +></term> +<listitem +><para +>Inserisce indicatori di commento per rendere la selezione o le righe selezionate o la riga attuale un commento secondo il formato di testo così com'è definito dalle regole di evidenziazione della sintassi del documento.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>uncomment</command +></cmdsynopsis +></term> +<listitem +><para +>Rimuove gli indicatori di commento dalla selezione o dalle righe selezionate o dalla riga attuale secondo il formato di testo così com'è definito dalle regole di evidenziazione della sintassi del documento.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>kill-line</command +></cmdsynopsis +></term> +<listitem +><para +>Elimina la riga attuale.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>replace</command +><arg +>modello</arg +><arg +>sostituzione</arg +></cmdsynopsis +></term> +<listitem +><para +>Sostituisce il testo corrispondente a <userinput +>modello</userinput +> con <userinput +>sostituzione</userinput +>. Se vuoi includere spazi bianchi nel <userinput +>modello</userinput +>, devi mettere le virgolette single o doppie attorno sia al modello, sia alla sostituzione. Se gli argomenti non sono tra virgolette,la prima parola è usata come <userinput +>modello</userinput +> ed il resto come <userinput +>sostituzione</userinput +>. Se la <userinput +>sostituzione</userinput +> è vuota, vengono rimosse le corrispondenze con il <userinput +>modello</userinput +>.</para> +<para +>Puoi impostare dei modificatori per configurare la ricerca aggiungendo un due punti, seguiti da una o più lettere rappresentanti la configurazione, data nella forma <userinput +>replace:opzioni modello sostituzione</userinput +>. Le opzioni disponibili sono: <variablelist> + +<varlistentry> +<term +><userinput +>b</userinput +></term> +<listitem +><para +>Cerca all'indietro.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>c</userinput +></term> +<listitem +><para +>Cerca dalla posizione del cursore.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>e</userinput +></term> +<listitem +><para +>Cerca solo all'interno della selezione.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>r</userinput +></term> +<listitem +><para +>Esegue la ricerca con un'espressione regolare. Se è impostata, puoi usare <userinput +>\N</userinput +>, dove N è un numero che rappresenta le catture nella stringa di sostituzione.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>s</userinput +></term> +<listitem +><para +>Esegue la ricerca facendo distinzione fra maiuscole e minuscole.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>p</userinput +></term> +<listitem +><para +>Chiede il permesso prima di effettuare la sostituzione.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>w</userinput +></term> +<listitem +><para +>Fa in modo che la ricerca consideri solo parole intere.</para +></listitem> +</varlistentry> + +</variablelist> + +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>date</command +><arg +>formato</arg +></cmdsynopsis +></term> +<listitem +><para +>Inserisce la stringa dell'ora/data come è specificato in <userinput +>formato</userinput +>, o nel formato <quote +>yyyy-MM-dd hh:mm:ss</quote +> se non ne è specificato nessuno. Le seguenti traduzioni sono effettuate nell'interpretazione di <userinput +>formato</userinput +>: <informaltable +> <tgroup cols="2" +> <tbody> +<row +><entry +><literal +>d</literal +></entry +><entry +>Il giorno in forma numerica senza zeri iniziali (1–31).</entry +></row> +<row +><entry +><literal +>dd</literal +></entry +><entry +>Il giorno in forma numerica con uno zero iniziale di allineamento (01–31).</entry +></row> +<row +><entry +><literal +>ddd</literal +></entry +><entry +>Il nome del giorno abbreviato in forma locale (cioè "lun" ... "dom").</entry +></row> +<row +><entry +><literal +>dddd</literal +></entry +><entry +>Il nome del giorno completo in forma locale (cioè "lunedì" ... "domenica").</entry +></row> +<row +><entry +><literal +>M</literal +></entry +><entry +>Il mese in forma numerica senza zeri iniziali (1–12).</entry +></row> +<row +><entry +><literal +>MM</literal +></entry +><entry +>Il mese in forma numerica con uno zero iniziale se necessario (01–12).</entry +></row> +<row +><entry +><literal +>MMM</literal +></entry +><entry +>Il nome del mese abbreviato in forma locale (cioè "gen" ... "dic").</entry +></row> +<row +><entry +><literal +>yy</literal +></entry +><entry +>Le ultime due cifre dell'anno (00–99).</entry +></row> +<row +><entry +><literal +>yyyy</literal +></entry +><entry +>L'anno come numero di quattro cifre (1752–8000).</entry +></row> +<row +><entry +><literal +>h</literal +></entry +><entry +>L'ora senza zero iniziali (0–23 o 1–12 se in modalità AM/PM).</entry +></row> +<row +><entry +><literal +>hh</literal +></entry +><entry +>L'ora con zero iniziali (00–23 o 01–12 se in modalità AM/PM).</entry +></row> +<row +><entry +><literal +>m</literal +></entry +><entry +>I minuti senza zero iniziali (0–59).</entry +></row> +<row +><entry +><literal +>mm</literal +></entry +><entry +>I minuti con zero iniziali (00–59).</entry +></row> +<row +><entry +><literal +>s</literal +></entry +><entry +>I secondi senza zero iniziali (0–59).</entry +></row> +<row +><entry +><literal +>ss</literal +></entry +><entry +>I secondi con zero iniziali (00–59).</entry +></row> +<row +><entry +><literal +>z</literal +></entry +><entry +>I millisecondi senza zeri iniziali (0–999).</entry +></row> +<row +><entry +><literal +>zzz</literal +></entry +><entry +>I millisecondi con zeri iniziali (000–999).</entry +></row> +<row +><entry +><literal +>AP</literal +></entry +><entry +>Usa modalità AM/PM. AP sarà sostituito da "AM" per le ore antimeridiane o "PM" per quelle pomeridiane.</entry +></row> +<row +><entry +><literal +>ap</literal +></entry +><entry +>Usa modalità am/pm. ap sarà sostituito da "am" per le ore antimeridiane o "pm" per quelle pomeridiane.</entry +></row> + +</tbody> +</tgroup> +</informaltable> + +</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>char</command +><arg +>identificatore</arg +></cmdsynopsis +></term> +<listitem> +<para +>Questo comando permette di inserire caratteri indicando il loro identificativo numerico, in decimale, ottale o esadecimale. Per usarlo apri la finestra di dialogo Comando di modifica e digita <userinput +>char: [numero]</userinput +> nel campo di inserimento, quindi fai clic su <guibutton +>OK</guibutton +>.</para> + +<example> +<title +>Esempi con il comando <command +>char</command +></title> + +<para +>Inserisci: <userinput +>char:234</userinput +></para> +<para +>Ottieni: <computeroutput +>ê</computeroutput +></para> +<para +>Inserisci: <userinput +>char:0x1234</userinput +></para> +<para +>Ottieni: <computeroutput +>ሴ</computeroutput +></para> +</example> + +</listitem> +</varlistentry> + +<varlistentry> +<term> +<indexterm +><primary +>sostituisci, come in sed</primary> +<secondary +>cerca, come in sed</secondary +></indexterm> +<command +>s///[ig]</command +> <command +>%s///[ig]</command +></term> + +<listitem> +<para +>Questo comando fa una ricerca/sostituzione nella riga di testo corrente o in tutto il file (<command +>%s///</command +>) in maniera del tutto simile a sed.</para> + +<para +>In breve, la ricerca viene effettuata in base a un <emphasis +>modello di ricerca</emphasis +>, a una espressione regolare compresa tra la prima e la seconda barra. Quando viene trovata una corrispondenza, la parte che corrisponde viene sostituita con l'espressione compresa tra la seconda e la terza barra. Le parentesi nel modello di ricerca creano dei <emphasis +>riferimenti all'indietro</emphasis +>, vale a dire che il comando ricorda quali parti della stringa di ricerca tra parentesi hanno trovato corrispondenza; queste stringhe possono essere riutilizzate per sostituire pattern riferiti a <userinput +>\1</userinput +> per il primo gruppo di parentesi, <userinput +>\2</userinput +> per il secondo e così via.</para> + +<para +>Per cercare precisamente il simbolo di parentesi <literal +>(</literal +> o <literal +>)</literal +>, devi <emphasis +>evitare</emphasis +> il problema usando la barra rovescia in questo modo: <userinput +>\(\)</userinput +></para> + +<para +>Se metti una <userinput +>i</userinput +> alla fine dell'espressione, la corrispondenza avverrà senza tener far distinzione fra maiuscole o minuscole. Se metti una <userinput +>g</userinput +>, verranno sostituite tutte le corrispondenze del modello, altrimenti verrà sostituita solo la prima.</para> + +<example> + +<title +>Sostituire del testo nella riga corrente</title> + +<para +>Il tuo caro vecchio compilatore ha appena finito di bloccarsi dicendoti che la classe <classname +>myClass</classname +> che compare nella riga 3902 del tuo file sorgente non è definita.</para> + +<para +>"Naturale!" pensi, sai benissimo che si scrive <classname +>MyClass</classname +>. Vai alla riga 3902 e, invece di provare a cercare la parola nel testo, apri la finestra di dialogo Comando di modifica, inserisci <userinput +>s/myclass/MyClass/i</userinput +>, premi <guibutton +>OK</guibutton +>, salvi il file e lo compili – con successo senza errori.</para> + +</example> + +<example> +<title +>Sostituire del testo nell'intero file</title> + +<para +>Immagina di avere un file, nel quale nomini <quote +>Miss Jensen</quote +> parecchie volte e arriva qualcuno che ti dice che si è appena sposata con <quote +>Mr Jones</quote +>. Naturalmente tu vuoi sostituire tutti i <quote +>Miss Jensen</quote +> con <quote +>Ms Jones</quote +>.</para> + +<para +>Lancia la finestra di dialogo Comando di modifica, digita nell'apposito campo <userinput +> %s/Miss Jensen/Ms Jones/</userinput +> e premi invio. Il gioco è fatto!</para> + +</example> + +<example> +<title +>Un esempio più avanzato</title> + +<para +>Questo esempio usa i <emphasis +>riferimenti all'indietro</emphasis +> e le <emphasis +>classi di carattere</emphasis +> (se non sai che cosa sono, leggi la relativa documentazione citata più in basso).</para> + +<para +>Immagina di avere la seguente riga: <programlisting +>void MyClass::DoStringOps( String &foo, String &bar String *p, int &a, int &b )</programlisting> +</para> +<para +>Ora ti rendi conto che il codice non va bene e decidi di usare la parola chiave <constant +>const</constant +> per tutti gli argomenti <quote +>reference</quote +>, quelli caratterizzati dall'operatore & posto davanti al nome dell'argomento. Inoltre vorresti semplificare lo spazio vuoto in modo che ci sia solo uno spazio tra ogni parola.</para> + +<para +>Apri la finestra di dialogo Comando di modifica e inserisci: <userinput +>s/\s+(\w+)\s+(&)/ const \1 \2/g</userinput +> e premi il pulsante <guibutton +>OK</guibutton +>. La <userinput +>g</userinput +> che si trova alla fine dell'espressione fa in modo che si ricompili un'espressione regolare, per ogni corrispondenza, da essere poi salvata come <emphasis +>riferimento all'indietro</emphasis +>.</para> + +<para +>Ottieni: <computeroutput +>void MyClass::DoStringOps( const String &foo, const String &bar String *p, const int &a, const int &b )</computeroutput +></para> + +<para +>Missione compiuta! Ora cos'è successo? Abbiamo cercato alcuni spazi vuoti (<literal +>\s+</literal +>) seguiti da alcuni caratteri alfabetici (<literal +>\w+</literal +>), seguiti da altri spazi vuoti (<literal +>\s+</literal +>), seguiti da una e commerciale e la porzione alfabetica con la e commerciale salvati nel processo per essere usati nell'operazione di sostituzione. Quindi abbiamo sostituito la parte corrispondente della nostra riga con uno spazio vuoto seguito da <quote +>const</quote +>, seguito da un altro spazio vuoto, seguito dalla porzione alfabetica (<literal +>\1</literal +>), seguito da uno spazio vuoto e infine seguito dalla e commerciale salvata (<literal +>\2</literal +>)</para> + +<para +>Ora, in alcuni casi la porzione alfabetica era una <quote +>String</quote +>. in altri <quote +>int</quote +>, quindi se usi <literal +>\w</literal +> e il quantificatore <literal +>+</literal +> sarà meglio.</para> + +</example> + +</listitem> + +</varlistentry> + +</variablelist> + +</sect3> + +<sect3 id="advanced-editing-tools-commandline-commands-navigation"> +<title +>Comandi per gli spostamenti</title> + +<variablelist> + +<varlistentry> +<term +><cmdsynopsis +><command +>goto</command +><arg +>INT riga</arg +></cmdsynopsis +></term> +<listitem +><para +>Questo comando sposta il cursore alla riga indicata.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>find</command +><arg +>modello</arg +></cmdsynopsis +></term> +<listitem +><para +>Questo comando si sposta alla prima corrispondenza del <userinput +>modello</userinput +> secondo la configurazione. Le corrispondenze successive possono essere trovate usando <menuchoice +><guimenu +>Modifica</guimenu +><guimenuitem +>Trova successivo</guimenuitem +></menuchoice +> (la scorciatoia predefinita è <keycap +>F3</keycap +>).</para> +<para +>Il comando find può essere configurato aggiungendo in fondo un due punti seguito da una o più opzioni, nella forma <userinput +>find:opzioni modello</userinput +>. Le seguenti opzioni sono disponibili: <variablelist> + +<varlistentry> +<term +><userinput +>b</userinput +></term> +<listitem +><para +>Cerca all'indietro.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>c</userinput +></term> +<listitem +><para +>Cerca dalla posizione del cursore.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>e</userinput +></term> +<listitem +><para +>Cerca solo all'interno della selezione.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>r</userinput +></term> +<listitem +><para +>Esegue la ricerca con un'espressione regolare. Se è impostata, puoi usare <userinput +>\N</userinput +>, dove N è un numero che rappresenta le catture nella stringa di sostituzione.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>s</userinput +></term> +<listitem +><para +>Esegue la ricerca facendo distinzione fra maiuscole e minuscole.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>w</userinput +></term> +<listitem +><para +>Fa in modo che la ricerca consideri solo parole intere.</para +></listitem> +</varlistentry> + +</variablelist> + +</para> + +</listitem> + +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>ifind</command +><arg +>modello</arg +></cmdsynopsis +></term> +<listitem +><para +>Questo comando fornisce la ricerca <quote +>mentre scrivi</quote +>. Puoi configurarne il comportamento aggiungendo in fondo un due punti seguito da una o più opzioni, nella forma <userinput +>ifind:opzioni modello</userinput +>. Le seguenti opzioni sono disponibili: <variablelist> +<varlistentry> +<term +><userinput +>b</userinput +></term> +<listitem +><para +>Cerca all'indietro.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>r</userinput +></term> +<listitem +><para +>Esegue la ricerca di un'espressione regolare.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>s</userinput +></term> +<listitem +><para +>Esegue la ricerca facendo distinzione fra maiuscole e minuscole.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>c</userinput +></term> +<listitem +><para +>Cerca dalla posizione del cursore.</para +></listitem> +</varlistentry> + +</variablelist> +</para +></listitem> +</varlistentry> + +</variablelist> + +</sect3> + +</sect2> + +</sect1> + +<sect1 id="advanced-editing-tools-code-folding"> +<title +>Uso del raggruppamento del codice</title> + +<para +>Il raggruppamento del codice permette di nascondere parti del documento nell'editor, rendendo più facile una panoramica di documenti di grandi dimensioni. In &kate; le regioni raggruppabili sono classificate usando le regole delle definizioni dell'evidenziazione della sintassi, e quindi sono disponibili solo in alcuni formati — tipicamente codice sorgente, annotazioni XML e simili. La maggior parte delle definizioni di evidenziazione che permettono il raggruppamento del codice permettono anche la definizione manuale di regioni raggruppabili, tipicamente con l'uso delle parole chiave <userinput +>BEGIN</userinput +> ed <userinput +>END</userinput +>.</para> + +<para +>Per usare la funzione di raggruppamento del codice, attiva gli indicatori di raggruppamento usando la voce <menuchoice +><guimenu +>Visualizza</guimenu +><guimenuitem +>Mostra segni di raggruppamento</guimenuitem +></menuchoice +> del menu se non sono già visibili. Il pannello degli indicatori di raggruppamento sul lato sinistro dello schermo mostra una vista grafica delle regioni raggruppabili, con segni +/- indicanti l'operazione possibile su una data regione: Un - indica che la regione è espansa, facendo clic sul - ridurrà la regione ad una sola riga, mentre un + la mostrerà completamente.</para> + +<para +>Sono forniti quattro comandi per manipolare lo stato delle regioni di raggruppamento del codice, vedi la <link linkend="view-code-folding" +>documentazione del menu</link +>. </para> + +<para +>Se non vuoi usare la funzione di raggruppamento del codice, puoi disabilitare l'opzione <guilabel +>Mostra segni di raggruppamento (se disponibile)</guilabel +> dalla <link linkend="config-dialog-editor-appearance" +>pagina Aspetto delle configurazioni dell'editor</link +>.</para> + +</sect1> + +<sect1 id="advanced-editing-tools-scripting"> + +<title +>Scripting del componente dell editor con JavaScript</title> + +<sect2 id="advanced-editing-tools-scripting-introduction"> + +<title +>Introduzione</title> + +<para +>Dalla versione 2.5, il componente dell'editor di &kate; gestisce gli script con ECMAScript, noto anche come JavaScript.</para> + +<para +>Gli script possono essere usati con la sola <link linkend="advanced-editing-tools-commandline" +>riga di comando integrata</link +>. I requisiti sono che lo script sia messo in una cartella dove &kate; possa trovarlo, assieme al file .desktop opzionale che ne definisce le proprietà associate. Le cartelle valide sono chiamate <filename +>katepart/scripts</filename +> nelle cartelle dei dati di &kde;. Puoi trovare le cartelle dei dati scrivendo <command +>kde-config <option +>--path</option +> <parameter +>data</parameter +></command +> Normalmente c'è almeno una cartella dei dati di sistema ed una personale. Naturalmente gli script nella cartella dei dati di sistema sono utilizzabili da tutti gli utenti, mentre quelli nella cartella personale lo possono essere usati solo da te.</para> + +<note +><para +>Questa funzione è sperimentale e probabilmente cambierà durante gli sviluppi futuri.</para> +<para +>Sappiamo che molti di voi saranno delusi perché non è possibile aggiungere script al menu o assegnarvi scorciatoie da tastiera. Molto probabilmente sarà possibile in futuro.</para> +<para +>Inoltre non è ancora possibile passare degli argomenti agli script. Sii paziente, e anche questo potrebbe essere aggiunto in futuro!</para> +</note> + +</sect2> + +<sect2 id="advanced-editing-tools-scripting-reference"> + +<title +>L'API JavaScript di Kate</title> + +<para +>Ecco elencata la raccolta completa di funzioni e proprietà disponibili per gli oggetti <type +>document</type +> e <type +>view</type +>. Inoltre sono disponibili naturalmente gli oggetti standard, come <type +>Math</type +>, <type +>String</type +>, <type +>Regexp</type +> e così via.</para> + +<para +>Quando viene eseguito uno script, l'oggetto <classname +>document</classname +> è il documento attuale, e l'oggetto <classname +>view</classname +> è la vista corrente.</para> + +<note +><para +>I tipi degli argomenti ovviamente non sono usati da JavaScript, al momento. Servono solo ad indicare qhe tipo di valori le funzioni si aspettino.</para +></note> + +<variablelist id="advanced-editing-tools-scripting-global"> +<title +>Funzioni globali</title> +<varlistentry> +<term +><function +>debug( <parameter +><replaceable +>stringa</replaceable +></parameter +>) [funzione]</function +></term> +<listitem> +<itemizedlist> +<title +>parametri</title> +<listitem +><para +><parameter +>stringa</parameter +> il messaggio da stampare</para> +</listitem> +</itemizedlist> +<para +>Stampa la stringa su <acronym +>STDERR</acronym +> usando la funzione <function +>kdDebug()</function +>. Un'area di output dedicata è usata per l'output, che sarà preceduto da <computeroutput +>Kate (KJS Scripts):</computeroutput +>. </para> +</listitem> +</varlistentry> +</variablelist> + +<variablelist id="advanced-editing-tools-scripting-document"> +<title +>L'API di <classname +>document</classname +></title> + +<varlistentry> +<term +><function +>document.attribute( <parameter +><replaceable +>riga</replaceable +> </parameter +>, <parameter +><replaceable +>colonna</replaceable +></parameter +> ); [funzione]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametri</title> +<listitem +><para +><parameter +>uint riga</parameter +> La riga della posizione per cui trovare l'attributo.</para +></listitem> +<listitem +><para +><parameter +>uint colonna</parameter +> La colonna della posizione per cui trovare l'attributo.</para +></listitem> +</itemizedlist> +<para +>Restituisce l'ID numerico dell'attributo per la posizione del documento 0<parameter +>riga</parameter +>, <parameter +>colonna</parameter +>]. L'attributo rappresenta l'aspetto o lo stile del testo, ed è anche usato per calcolare l'evidenziazione della sintassi per una parte specifica del testo in formati misti come l'HTML e il PHP.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.canBreakAt( <parameter +>Char c</parameter +>, <parameter +>uint attributo</parameter +> ); [funzione]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametri</title> +<listitem +><para +><parameter +>c</parameter +> Il carattere da verificare</para +></listitem> +<listitem +><para +><parameter +>attributo</parameter +> L'attributo alla posizione di <parameter +>c</parameter +>.</para +></listitem> +</itemizedlist> +<para +>Restituisce true se è permesso interrompere la riga al carattere c con l'attributo dato. Il risultato è determinato dall'interrogazione dell'evidenziazione che possiede l'attributo per sapere quali caratteri permettono l'interruzione della riga.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.canComment( <parameter +>uint attributo_inizio</parameter +>, <parameter +>uint attributo_fine</parameter +> ); [funzione]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametri</title> +<listitem +><para +><parameter +>attributo_inizio</parameter +> L'attributo dell'inizio dell'intervallo da tramutare in commento.</para +></listitem> +<listitem +><para +><parameter +>attributo_fine</parameter +> L'attributo della fine dell'intervallo da tramutare in commento.</para +></listitem> +</itemizedlist> +<para +>Controlla se attributo_inizio e attributo_fine appartengono allo stesso sistema di evidenziazione della sintassi. Se è così, va tutto bene. </para> +<example> +<title +>Uso di canComment</title> +<programlisting +>if ( document.canComment( document.attribute(1,0), document.attribute(5,0) ) ) { + // 1,0 e 5,0 appartengono allo stesso sistema di evidenziazione di sintassi +} +</programlisting> +</example> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.clear(); [funzione]</function +></term> +<listitem +><para +>Svuota il documento.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.commentStart( <parameter +>uint attributo</parameter +> ); [funzione]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametri</title> +<listitem +><para +><parameter +>attributo</parameter +> L'attributo del testo di cui ottenere la stringa di indicazione di inizio commento (commentStart).</para +></listitem> +</itemizedlist> +<para +>Restituisce la stringa richiesta per avviare un commento su più righe per il testo con l'attributo dato, o una stringa vuota se i commenti su più righe non sono disponibili per quel tipo di testo.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.commentMarker( <parameter +>uint attributo</parameter +> ); [funzione]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametri</title> +<listitem +><para +><parameter +>attributo</parameter +> L'attributo del testo di cui ottenere la stringa di indicazione commento (commentMarker).</para +></listitem> +</itemizedlist> +<para +>Restituisce la stringa usata per indicare che il resto della riga è un commento per un testo con l'attributo dato o una stringa vuota se i commenti su riga singola non sono disponibili per il testo dato.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.commentEnd( <parameter +>uint attributo</parameter +> ); [funzione]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametri</title> +<listitem +><para +><parameter +>attributo</parameter +> L'attributo del testo di cui ottenere la stringa di indicazione di fine commento (commentEnd).</para +></listitem> +</itemizedlist> +<para +>Restituisce la stringa richiesta per terminare un commento su più righe per il testo con l'attributo dato, o una stringa vuota se i commenti su più righe non sono disponibili per quel tipo di testo.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.editBegin(); [funzione]</function +></term> +<listitem> +<para +>Inizia un gruppo di modifiche. Tutte le azioni eseguite fino alla chiamata di editEnd() saranno raggruppate in una sola azione di annullamento.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.editEnd(); [funzione]</function +></term> +<listitem> +<para +>Termina un gruppo di modifiche.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.highlightMode; [proprietà:sola lettura]</function +></term> +<listitem> +<para +>IL nome dellla modalità di evidenziazione del documento, come JavaScript o C++. Se non è impostata nessuna modalità di evidenziazione per il documento, il valore è None. Nota che è necessario usare il nome inglese nei casi in cui sia diverso da quello tradotto.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.indentMode; [proprietà:sola lettura]</function +></term> +<listitem> +<para +>Il nome della modalità di indentazione del documento, come <literal +>normal</literal +> o <literal +>cstyle</literal +>. Ricorda che se non è impostata una modalità di indentazione, il valore è <literal +>none</literal +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.indentWidth; [proprietà:sola lettura]</function +></term> +<listitem> +<para +>L'ampiezza del rientro impostata per il dcumento. È usata se è attiva l'indentazione con gli spazi.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.insertLine( <parameter +>uint riga</parameter +>, <parameter +>string testo</parameter +> ); [funzione]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametri</title> +<listitem +><para +><parameter +>riga</parameter +> numero della riga del documento</para> +</listitem> +<listitem +><para +><parameter +>testo</parameter +> testo da inserire</para +></listitem> +</itemizedlist> +<para +>Inserisce una nuova riga di testo <parameter +>testo</parameter +> alla riga <parameter +>riga</parameter +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.insertText( <parameter +>uint riga</parameter +>, <parameter +>uint colonna</parameter +>, <parameter +>string testo</parameter +> ); [funzione]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametri</title> +<listitem +><para +><parameter +>riga</parameter +> numero della riga</para +></listitem> +<listitem +><para +><parameter +>colonna</parameter +> il numero della colonna</para +></listitem> +<listitem +><para +><parameter +>testo</parameter +> il testo da inserire</para +></listitem> +</itemizedlist> +<para +>Inserisce il testo <parameter +>testo</parameter +> alla riga <parameter +>riga</parameter +> e alla colonna <parameter +>colonna</parameter +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>document.length(); [funzione]</term> +<listitem> +<para +>Restituisce la dimensione del documento in byte.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.lines(); [funzione]</function +></term> +<listitem> +<para +>Restituisce il numero di righe del documento.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>document.mixedIndent; [proprietà:sola lettura]</term> +<listitem> +<para +>Un valore booleano che indica se la modalità mixed-indent è abilitata per il documento. Se è così, l'indentazione è ottimizzata per contenere una miscela di caratteri di tabulazione e spazi come fa l'editor Emacs.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>document.removeLine( <parameter +>uint numeroriga</parameter +> ); [funzione]</term> +<listitem> +<itemizedlist> +<title +>Parametri</title> +<listitem +><para +><parameter +>riga</parameter +> numero di riga</para +></listitem> +</itemizedlist> +<para +>Rimuove la riga numeroriga dal documento.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.removeText( <parameter +>uint rigaIniziale</parameter +>, <parameter +>uint colonnaIniziale</parameter +>, <parameter +>uint rigaFinale</parameter +>, <parameter +>uint colonnaFinale</parameter +> ); [funzione]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametri</title> +<listitem +><para +><parameter +>rigaIniziale</parameter +> indica la riga d'inizio</para +></listitem> +<listitem +><para +><parameter +>colonnaIniziale</parameter +> indica la colonna d'inizio</para +></listitem> +<listitem +><para +><parameter +>rigaFinale</parameter +> indica la riga di fine</para +></listitem> +<listitem +><para +><parameter +>colonnaFinale</parameter +> indica la colonna di fine</para +></listitem> +</itemizedlist> +<para +>Rimuove la sezione di testo che inizia da riga <parameter +>rigaIniziale</parameter +> e colonna <parameter +>colonnaIniziale</parameter +> fino a <parameter +>rigaFinale</parameter +> e colonna <parameter +>colonnaFinale</parameter +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.setText( <parameter +>string testo</parameter +> ); [funzione]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametri</title> +<listitem +><para +><parameter +>testo</parameter +> testo del documento</para +></listitem> +</itemizedlist> +<para +>Sostituisce il testo dell'intero documento con <parameter +>testo</parameter +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.spaceIndent; [proprietà:sola lettura]</function +></term> +<listitem> +<para +>Un valore booleano che indica se è abilitata l'indentazione con gli spazi per il documento. Se è così, il documento è indentato con indentWidth spazi per livello, altrimenti è di una tabulazione per livello.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.textFull(); [funzione]</function +></term> +<listitem> +<para +>Restituisce il testo completo del documento. Se il testo continua su più righe il carattere di separazione delle righe è <constant +>\n</constant +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.textLine( uint numeroRiga ); [funzione]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametri</title> +<listitem +><para +><parameter +>numeroRiga</parameter +> il numero della riga</para +></listitem> +</itemizedlist> +<para +>Restituisce il testo della riga <parameter +>numeroRiga</parameter +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.textRange( <parameter +>uint rigaIniziale</parameter +>, <parameter +>uint colonnaIniziale</parameter +>, <parameter +>uint rigaFinale</parameter +>, <parameter +>uint colonnaFinale</parameter +> ); [funzione]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametri</title> +<listitem +><para +><parameter +>rigaIniziale</parameter +> indica la riga d'inizio</para +></listitem> +<listitem +><para +><parameter +>colonnaIniziale</parameter +> indica la colonna d'inizio</para +></listitem> +<listitem +><para +><parameter +>rigaFinale</parameter +> indica la riga di fine</para> +</listitem> +<listitem +><para +><parameter +>colonnaFinale</parameter +> indica la colonna di fine</para +></listitem> +</itemizedlist> +<para +>Restituisce il testo dell'intervallo selezionato. Se il testo continua su più righe il carattere di separazione delle righe è <constant +>\n</constant +>.</para> +</listitem> +</varlistentry> + +</variablelist +><!--/ document API --> + +<variablelist id="advanced-editing-tools-scripting-view"> +<title +>L'API di <classname +>view</classname +></title> + +<varlistentry> +<term +><function +>view.clearSelection(); [funzione]</function +></term> +<listitem> +<para +>Deseleziona tutto il testo.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.cursorColumn(); [funzione]</function +></term> +<listitem> +<para +>Restituisce la colonna su cui si trova il cursore (i caratteri di tabulazione sono espansi).</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.cursorColumnReal(); [funzione]</function +></term> +<listitem> +<para +>Restituisce la colonna su cui si trova il cursore (i caratteri di tabulazione contano come uno).</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.cursorLine(); [funzione]</function +></term> +<listitem> +<para +>Restituisce il numero di riga attuale del cursore.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.hasSelection(); [funzione]</function +></term> +<listitem> +<para +>Restituisce <constant +>true</constant +> se la vista contiene del testo selezionato, altrimenti <constant +>false</constant +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.removeSelectedText(); [funzione]</function +></term> +<listitem> +<para +>Elimina il testo selezionato, se c'è una selezione nella vista.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.selectAll(); [funzione]</function +></term> +<listitem> +<para +>Seleziona tutto il testo.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.selection(); [funzione]</function +></term> +<listitem> +<para +>Restituisce il testo selezionato. Se la selezione è composta da più righe, il carattere di separazione delle righe è <constant +>\n</constant +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.selectionEndColumn; [proprietà:sola lettura]</function +></term> +<listitem> +<para +>Restituisce il numero di colonna della fine della selezione.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.selectionEndLine; [proprietà:sola lettura]</function +></term> +<listitem> +<para +>Restituisce il numero di riga della fine della selezione.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.selectionStartColumn; [proprietà:sola lettura]</function +></term> +<listitem> +<para +>Restituisce la colonna iniziale della selezione.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.selectionStartLine; [proprietà:sola lettura]</function +></term> +<listitem> +<para +>Restituisce la riga iniziale della selezione.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.setCursorPosition( <parameter +>uint riga</parameter +>, <parameter +>uint colonna</parameter +> ); [funzione]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametri</title> +<listitem +><para +><parameter +>riga</parameter +> Specifica la riga del cursore.</para +></listitem> +<listitem +><para +><parameter +>colonna</parameter +> Specifica la colonna del cursore.</para +></listitem> +</itemizedlist> +<para +>Sposta la posizione del cursore nella vista a [<parameter +>riga</parameter +>, <parameter +>colonna</parameter +>]. La posizione del cursore è calcolata in modo visuale, cioè i caratteri di tabulazione contano per <replaceable +>tabwidth</replaceable +> spazi, a seconda della posizione all'interno della riga. La posizione del cursore è resa visibile. Sia la riga che la colonna sono contate partendo da zero.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.setCursorPositionReal( <parameter +>uint riga</parameter +>, <parameter +>uint colonna</parameter +> ); [funzione]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametri</title> +<listitem +><para +><parameter +>riga</parameter +> Specifica la riga del cursore.</para +></listitem> +<listitem +><para +><parameter +>colonna</parameter +> Specifica la colonna del cursore.</para +></listitem> +</itemizedlist> +<para +>Sposta la posizione del cursore nella vista a [<parameter +>riga</parameter +>, <parameter +>colonna</parameter +>]. Questa funzione imposta la posizione nella stringa di caratterim cioè un carattere di tabulazione conta per uno. Sia la riga che la colonna sono contate partendo da zero.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.setSelection( <parameter +>uint rigaIniziale</parameter +>, <parameter +>uint colonnaIniziale</parameter +>, <parameter +>uint rigaFinale</parameter +>, <parameter +>uint colonnaFinale</parameter +> ); [funzione]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametri</title> +<listitem +><para +><parameter +>rigaIniziale</parameter +> indica la riga d'inizio</para +></listitem> +<listitem +><para +><parameter +>colonnaIniziale</parameter +> indica la colonna d'inizio</para +></listitem> +<listitem +><para +><parameter +>rigaFinale</parameter +> indica la riga di fine</para +></listitem> +<listitem +><para +><parameter +>colonnaFinale</parameter +> indica la colonna di fine</para +></listitem> +</itemizedlist> +<para +>Seleziona il testo da riga <parameter +>rigaIniziale</parameter +> e colonna <parameter +>colonnaIniziale</parameter +> fino a riga <parameter +>rigaFinale</parameter +> e colonna <parameter +>colonnaFinale</parameter +>.</para> +</listitem> +</varlistentry> + +</variablelist> + +<example id="advanced-editing-tools-scripting-example"> + +<title +>Uno script di esempio</title> +<para +>Come esempio, prepareremo un breve script che rende maiuscole tutte le lettere della selezione. È ovvio che dovremo prima controllare se esiste una selezione, quindi ottenere il testo, rendere ogni lettera maiuscola ed infine sostituire il vecchio testo col nuovo. Un'implementazione potrebbe essere questa:</para> + +<programlisting +>if ( view.hasSelection() ) +{ + // uppercase selection + column = view.selectionStartColumn; + line = view.selectionStartLine; + + selection = view.selection().toUpperCase(); + + document.editBegin(); + view.removeSelectedText(); + document.insertText( line, column, selection ); + document.editEnd(); +} +</programlisting> + +<para +>Per raggruppare queste azioni assieme i modo che siano annullate con una singola attivazione di <guimenuitem +>Annulla</guimenuitem +>, incapsuliamo le righe <programlisting +>view.removeSelectedText()</programlisting +> e <programlisting +>document.insertText()</programlisting +> con un <programlisting +>document.editBegin()</programlisting +> ed un <programlisting +>document.editEnd()</programlisting +>.</para> + +</example> + +<example id="advanced-editing-tools-desktop-example"> +<title +>Un esempio di file <filename +>.desktop</filename +></title> + +<para +>Ecco un esempio di file .desktop da associare allo script summenzionato.</para> + +<programlisting +># Example of a .desktop file +[Desktop Entry] +Encoding=UTF-8 +Name=Kate Part JavaScript Uppercase +Comment=Script to uppercase the selection +X-Kate-Command=uppercase-selection +X-Kate-Help=<p>Usage: <code>uppercase-selection</code></p> +</programlisting> + +<para +>Come puoi vedere è possibile definire la codifica, il nome, un commento, un testo di aiuto usando X-Kate-Help ed il nome per la riga di comando usando X-Kate-Command. Le voci Name, Comment e X-Kate-Help sono tradotte automaticamente in altre lingue dalle squadre di traduzione di KDE, se i file risiedono nel deposito SVN di KDE.</para> + +</example> + +<sect3> +<title +>Mettere tutto assieme</title> + +<para +>&kate; cercherà i file <filename +>*.js</filename +> nelle cartelle degli script (vedi <link linkend="advanced-editing-tools-scripting-introduction" +>sopra</link +>). Per ciascun file controlla se è presente un file <filename +>.desktop</filename +>; ad esempio, per <filename +>uppercase.js</filename +> cercherebbe un file <filename +>uppercase.desktop</filename +>. </para> +<para +>Se un file <filename +>.desktop</filename +> non è presente, lo script sarà registrato nella riga di comando di KatePart con il nome del file senza l'estensione .js, quindi nell'esempio, questo vuol dire <literal +>uppercase</literal +>. Se il nome del comando va bene e non ti servono le altre caratteristiche fornite dai file <filename +>.desktop</filename +>, non è affatto necessario creare il file. </para> +<para +>Se esiste un file <filename +>.desktop</filename +>, KatePart leggerà il nome sotto cui lo script sarà registrato dalla voce X-Kate-Command del file .desktop, ad esempio X-Kate-Command=uppercase-selection.</para> + +</sect3> + +</sect2> + +</sect1> + +</chapter> diff --git a/tde-i18n-it/docs/tdebase/kate/configuring.docbook b/tde-i18n-it/docs/tdebase/kate/configuring.docbook new file mode 100644 index 00000000000..cc6e89744cf --- /dev/null +++ b/tde-i18n-it/docs/tdebase/kate/configuring.docbook @@ -0,0 +1,2606 @@ +<chapter id="configuring-kate"> +<chapterinfo> +<authorgroup> +<author +>&Anders.Lund; &Anders.Lund.mail;</author> +<othercredit role="translator" +><firstname +>Nicola</firstname +> <surname +>Ruggero</surname +> <affiliation +><address +><email +>nicola@nxnt.org</email +></address +></affiliation +><contrib +>Traduzione della documentazione.</contrib +></othercredit +><othercredit role="translator" +><firstname +>Luciano</firstname +><surname +>Montanaro</surname +><affiliation +><address +><email +>mikelima@cirulla.net</email +></address +></affiliation +><contrib +>Aggiornamento della traduzione per &kate; 2.5.6</contrib +></othercredit +> +</authorgroup> +</chapterinfo> +<title +>Configurare &kate;</title> + +<sect1 id="configuring-overview"> +<title +>Panoramica</title> +<para> +<indexterm> +<primary +>configura</primary> +<secondary +>impostazioni</secondary> +<tertiary +>preferenze</tertiary +></indexterm> +<anchor id="find"/> <anchor id="find-again"/> <anchor id="replace"/> <anchor id="undo"/> <anchor id="redo"/> &kate; offre parecchi mezzi per adattare l'applicazione alle proprie esigenze. I più importanti sono: </para> + +<variablelist> +<varlistentry> +<term id="configure" +>La finestra di dialogo della Configurazione</term> +<listitem +><para +>Lo strumento principale di configurazione ti permette di configurare l'applicazione &kate;, i componenti dell'editor e l'uso dei plugin.</para +></listitem> +</varlistentry> +<varlistentry> +<term id="settings" +>Il menu <guimenu +>Impostazioni</guimenu +></term> +<listitem +><para +>Ti permette di cambiare le impostazioni usate più spesso e ti permette di aprire la finestra di dialogo della configurazione.</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Il menu <guimenu +>Visualizza</guimenu +></term> +<listitem +><para +>Ti permette di dividere la finestra in cui lavori, visualizzare le icone e visualizzare il pannello con la numerazione di riga per documento che stai modificando.</para +></listitem> +</varlistentry> +</variablelist> + +<para +>La &konsole; integrata sta usando la configurazione definita nel &kcontrolcenter;, e può essere riconfigurata facendo clic con il pulsante <mousebutton +>destro</mousebutton +> del mouse e scegliendo <guimenuitem +>Impostazioni</guimenuitem +> dal sotto menu.</para> + +</sect1> + +<sect1 id="configuring-kate-configdialog"> +<title +>La finestra principale di configurazione</title> + +<mediaobject> +<imageobject> +<imagedata format="PNG" fileref="configdialog01.png"/> +</imageobject> +</mediaobject> + +<para +>La finestra di dialogo di &kate; mostra un menu ad albero, con varie voci sulla sinistra e a destra la pagina di configurazione corrispondente alla voce di destra.</para> + +<para +>La configurazione è divisa in due gruppi, rispettivamente <itemizedlist> +<listitem +><para +><link linkend="config-dialog" +>Configurazione dell'applicazione</link> +</para +></listitem> +<listitem +><para +><link linkend="config-dialog-editor" +>Configurazione della componente dell'editor</link +></para +></listitem> + +</itemizedlist> + +</para> + +</sect1> + +<sect1 id="config-dialog"> +<title +>La configurazione dell'applicazione &kate;</title> +<para +>Questo gruppo contiene le pagine per configurare l'applicazione principale di &kate;</para> + +<sect2 id="config-dialog-general"> +<title +>La pagina Generale</title> +<para +>Questa sezione contiene alcune opzioni globali di &kate;</para> + +<variablelist> + +<varlistentry> +<term +><anchor id="config-dialog-general-show-full-path"/> +<guilabel +>Mostra l'intero percorso nel titolo</guilabel +></term> +<listitem +><para +>Se è abilitata, Kate mostrerà l'URL completo del documento attuale nell titolo della finestra, invece del solo nome.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="config-general-behavior"/> +<guilabel +>Comportamento</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term> +<anchor id="config-dialog-general-sync-konsole"/> +<guibutton +>Sincronizza l'emulatore di terminale con il documento attivo</guibutton +></term> +<listitem +><para +>Questa opzione farà in modo che la &konsole; integrata cambi directory con il comando <command +>cd</command +> in modo tale da posizionarsi nella stessa directory del documento attivo. Questa opzione ha effetto sia all'apertura di un documento sia quando un nuovo documento va in primo piano. Se l'opzione non è attivata, devi cambiare directory manualmente nella &konsole;. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="config-dialog-general-warn-mod"/> +<guilabel +>Avverti se un file è modificato da un processo estraneo</guilabel +></term> +<listitem +><para +>Se questa opzione è abilitata, &kate; ti avvertirà se dei file sono stati modificati al di fuori dell'applicazione quando la finestra principale è focalizzata. Potrai dover gestire più file modificati contemporaneamente, e potrai scegliere se ricaricare, salvare o scartare i file modificati in gruppi.</para> +<para +>Se non è abilitata, &kate; chiederà che cosa fare quando un file modificato dall'esterno riceve il fuoco nell'applicazione.</para> +</listitem> +</varlistentry> + +</variablelist> +</listitem> +</varlistentry +><!-- /behavior group --> + +<varlistentry> +<term +><anchor id="config-general-meta-data"/> +<guilabel +>Dati aggiuntivi</guilabel +></term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="config-general-keep-meta-information"/> +<guilabel +>Ricorda le meta-informazioni</guilabel +></term> +<listitem +><para +>Se questa opzione è abilitata &kate; memorizzerà i metadati come i segnalibri e la configurazione della sessione anche quando chiudi i documenti. I dati saranno usati se il documento non è stato cambiato prima di essere riaperto.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="config-general-delete-meta-information-after"/> +<guilabel +>Elimina meta informazioni inutilizzate dopo</guilabel +></term> +<listitem +><para +>Imposta il massimo numero di giorni per cui conservare le meta-informazioni per i file non aperti. Ciò permette di mantenere la base dati delle meta-informazioni entro dimensioni ragionevoli.</para +></listitem> +</varlistentry> + +</variablelist> + +</listitem> +</varlistentry +><!-- /meta data group --> + +</variablelist> +</sect2> + +<sect2 id="config-dialog-sessions"> +<title +>La pagina Sessioni</title> + +<para +>Questa sezione contiene opzioni relative all'<link linkend="fundamentals-using-sessions" +>uso delle sessioni</link +>.</para> + +<variablelist> + +<varlistentry> +<term +><anchor id="config-dialog-sessions-elements"/> +<guilabel +>Elementi delle sessioni</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Includi la configurazione della finestra</guilabel +></term> +<listitem +><para +>Se questa opzione è abilitata, &kate; salverà la configurazione della finestra con ogni sessione.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry +><!-- /elements of sessions --> + +<varlistentry> +<term +><anchor id="config-dialog-sessions-startup-behavior"/> +<guilabel +>Comportamento all'avvio dell'applicazione</guilabel +></term> +<listitem> +<para +>Seleziona il comportamento di &kate; all'avvio. Questa impostazione può essere annullata specificando che cosa fare dalla <link linkend="command-line-options" +>riga di comando</link +>.</para> +<variablelist> +<varlistentry> +<term +><guilabel +>Avvia nuova sessione</guilabel +></term> +<listitem +><para +>Con questa opzione, &kate; creerà una nuova sessione senza nome all'avvio.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Carica l'ultima sessione utilizzata</guilabel +></term> +<listitem +><para +>&kate; userà la sessione usata più di recente all'avvio. È comodo se vuoi usare sempre la stessa sessione o se la cambi raramente.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Scegli a mano una sessione</guilabel +></term> +<listitem +><para +>&kate; mostrerà una finestrella per la scelta della sessione preferita. Questo è il comportamento predefinito. Comodo se usi molte sessioni diverse di frequente.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry +><!-- /startup behavior --> + +<varlistentry> +<term +><anchor id="config-dialog-sessions-exit-behavior"/> +<guilabel +>Comportamento all'uscita dell'applicazione o al cambio di sessione</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Non salvare la sessione</guilabel +></term> +<listitem +><para +>e modifiche ai dati della sessione (i file aperti, e, se abilitata, la configurazione delle finestre) non saranno salvate. Naturalmente verrai interpellato se hai dei file non salvati. Con questa opzione, puoi configurare la sessione una volta ed evitare di dover chiudere i file extra che ha aperto per non vederli aperti al successivo uso della sessione.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Salva sessione</guilabel +></term> +<listitem +><para +>&kate; salverà i dati di sessione, a meno che la sessione sia senza nome. Con questa opzione, le sessioni sono sempre ripristinate come le hai lasciate. Questo è il comportamento predefinito. </para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Chiedi all'utente</guilabel +></term> +<listitem +><para +>Ti verrà chiesto se vuoi salvare la sessione ogni volta che una sessione che ha un nome viene chiusa.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry +><!-- /exit/switch behavior --> + +</variablelist> + +</sect2> + +<sect2 id="config-dialog-fileselector"> +<title +>La pagina <guilabel +>Selettore dei file</guilabel +></title> + +<variablelist> +<varlistentry> +<term +><guilabel +>Barra degli strumenti</guilabel +></term> +<listitem +><para +>Configura i pulsanti della barra del gestore dei file spostando quelli desiderati sulla lista <guilabel +>Azioni attuali</guilabel +>, ed ordinali usando i pulsanti con le frecce a lato della lista.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Sincronizzazione automatica</guilabel +></term> +<listitem +><para +>Puoi fare in modo che il navigatore del filesystem si posizioni automaticamente sulla directory contenente il documento attuale in caso di eventi particolari: <itemizedlist +><listitem +><para +>Quando un documento diventa quello attivo.</para +></listitem +> <listitem +><para +>Quando il browser del filesystem diventa visibile.</para +></listitem +></itemizedlist +> Anche se scegli di non usare questa funzione, puoi sincronizzare a mano il navigatore con il documento attuale premendo il pulsante <guilabel +>Sincronizza</guilabel +> della barra degli strumenti. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Ricorda gli indirizzi</guilabel +></term> +<listitem +><para +>Scegli quanto deve essere lunga la cronologia della navigazione. Il navigatore ricorda solo i percorsi individuali, i duplicati sono esclusi.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Ricorda i filtri</guilabel +></term> +<listitem +><para +>Scegli quanti filtri vuoi che siano ricordati. Vengono ricordati solo i filtri individuali, i duplicati sono esclusi.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Sessione</guilabel +></term> +<listitem> +<para +>Configura se il navigatore del file system debba ricordare le posizioni ed i filtri da una sessione all'altra.</para> +</listitem> +</varlistentry> + +</variablelist> + +</sect2> + +<sect2 id="config-dialog-documentlist"> +<title +>La pagina <guilabel +>Lista documenti</guilabel +></title> + +<variablelist> +<varlistentry> +<term +><guilabel +>Sfumature sfondo</guilabel +></term> +<listitem +><para +>Questa sezione permette di abilitare e disabilitare la visualizzazione dell'ombreggiatura dello sfondo delle tue attività recenti, e di scegliere quali colori usare se la abiliti. Vedi la sezione <link linkend="kate-mdi-tools-file-list" +>La lista dei documenti</link +> per maggiori informazioni su questa funzione.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Ordina per</guilabel +></term> +<listitem +><para +>Imposta il tipo di ordinamento da dare ai documenti. Può anche essere cambiato con il menu del &RMB; dalla lista dei documenti.</para +></listitem> +</varlistentry> +</variablelist> + +</sect2> + +<sect2 id="config-dialog-plugins"> +<title +>La pagina <guilabel +>Plugin</guilabel +></title> + +<para +>Questa pagina fornisce un elenco dei plugin installati in &kate;. Ciascun plugin è rappresentato con il nome ed una breve descrizione. Puoi marcare la casella di una voce per abilitare il plugin che rappresenta. </para> + +<para +>Se un plugin fornisce opzioni di configurazione apparirà una sezione per l'accesso ad esse.</para> + +</sect2> + + +<sect2 id="config-dialog-externaltools"> +<title +>Strumenti esterni</title> + +<para +>Nel menu <guimenu +>Strumenti</guimenu +> c'è un sottomenu chiamato <guisubmenu +>Strumenti esterni</guisubmenu +>. Questi strumenti invocano applicazioni esterne con i dati correlati al documento esterno, ad esempio il suo URL, la directory, il testo o la selezione. Questa pagina permette di gestire il menu e modificare, eliminare o aggiungere nuovi strumenti.</para> + +<para +>Ciascuno strumento esterno è un comando di shell che contiene delle macro rappresentanti i dati del documento. Quando viene attivato, le macro vengono sostituite dai dati del documento attivo.</para> + +<variablelist> +<title +>Proprietà degli strumenti esterni</title> +<varlistentry> +<term +>Etichetta</term> +<listitem +><para +>Un'etichetta amichevole per il menu degli strumenti esterni.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Script</term> +<listitem +><para +>Lo script da eseguire quando viene attivato lo strumento. Prima di passare lo script alla shell, vengono sostituite le seguenti macro: <variablelist> +<varlistentry> +<term +>%URL</term> +<listitem +><para +>L'URL completo del documento attuale, o una stringa vuota se il documento non è stato salvato.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>%URLS</term> +<listitem +><para +>Una lista separata da spazi degli URL dei documenti aperti (esclusi quelli non salvati).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>%directory</term> +<listitem +><para +>La parte della directory dell'URL del documento attuale, o una stringa vuota se il documento attuale non è stato salvato.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>%filename</term> +<listitem +><para +>il nome del file del documento corrente senza il percorso, o una stringa vuota se il documento corrente non è mai stato salvato.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>%line</term> +<listitem +><para +>Il numero di riga del cursore di inserimento nel documento attuale.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>%column</term> +<listitem +><para +>Il numero della colonna del cursore di inserimento nel documento attuale.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>%selection</term> +<listitem +><para +>Il testo selezionato nel documento attuale, o una stringa vuota se non c'è testo selezionato</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>%text</term> +<listitem +><para +>Il testo completo del documento attuale. Fai attenzione, perché potrebbe eccedere la lunghezza massima della riga di comando permessa sul tuo sistema. Da usare con prudenza.</para +></listitem> +</varlistentry> + +</variablelist> + +</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Eseguibile</term> +<listitem +><para +>L'eseguibile principale è lo script. Questo è obbligatorio, ed è usato per provare se il comando può essere eseguito. UN percorso completamente qualificato è ammesso nel caso in cui l'eseguibile non sia fra i percorsi della variabile <envar +>PATH</envar +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Tipi MIME</term> +<listitem +><para +>Una lista separata de punti e virgola dei tipi MIME per cui questo comando debba essere abilitato. Attualmente non è usata.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Salva</term> +<listitem +><para +>Puoi scegliere di far salvare il documento corrente o tutti prima di eseguire lo script, se lo desideri. Ciò è utile se il tuo script legge il file da disco.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Nome da riga di comando</term> +<listitem +><para +>Se compili questo campo, lo strumenti sarà disponibile dalla <link linkend="advanced-editing-tools-commandline" +>riga di comando dell'editor</link +> come <command +>exttool-<replaceable +>Nome da riga di comando</replaceable +></command +> (la stringa che hai immesso qui, preceduta da <quote +>exttool-</quote +>).</para +></listitem> +</varlistentry> + +</variablelist> + +</sect2> + +</sect1> + +<sect1 id="config-dialog-editor"> +<title +>Configurazione del componente dell'editor</title> +<para +>Questo gruppo contiene tutte le pagine collegate con il componente dell'editor di &kate;. Quasi tutte le impostazioni sono quelle predefinite, che vengono sovrascritte dalla <link linkend="config-dialog-editor-filetypes" +>definizione di un tipo di file</link +>, dalle <link linkend="config-variables" +>variabili dei documenti</link +> o cambiandole nel documento durante la sessione di modifica.</para> + + +<sect2 id="config-dialog-editor-appearance"> +<title +>Aspetto</title> + +<variablelist> +<varlistentry> +<term +><guilabel +>A capo automatico</guilabel +></term> +<listitem> +<variablelist> +<varlistentry id="appearance-settings"> +<term +><guilabel +>A capo automatico dinamico</guilabel +></term> +<listitem +><para +>Se quest'opzione è marcata, le righe proseguiranno a capo quando raggiungeranno il bordo della finestra.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Indicatori a capo automatico dinamico</guilabel +></term> +<listitem +><para +>Scegli se gli indicatori di andata a capo automatico dinamico debbano essere visualizzati. </para +></listitem +></varlistentry> +<varlistentry> +<term +><guilabel +>Allinea verticalmente le righe andate a capo dinamicamente alla profondità di indentazione: </guilabel +></term> +<listitem +><para +>Abilita l'inizio di una riga andata a capo dinamicamente allineato verticalmente con il livello di indentazione della prima riga. Ciò può aiutare a rendere il codice e la formattazione più leggibile.</para +><para +>Inoltre permette di impostare la massima larghezza dello schermo come percentuale, dopo la quale le righe andate a capo dinamicamente non saranno più allineate verticalmente. Ad esempio, a 50%, le righe il cui livello di indentazione è più profondo del 50% della larghezza dello schermo non avranno allineamento verticale applicato alle seguenti righe andate a capo automaticamente.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Raggruppamento codice</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Mostra gli indicatori di raggruppamento </guilabel +></term> +<listitem +><para +>Se questa opzione è attivata, la vista corrente mostrerà degli indicatori per il raggruppamento del codice, se il raggruppamento del codice è disponibile.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Bordi</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Mostra bordo per le icone </guilabel +></term> +<listitem +><para +>Se attivata, vedrai un bordo per le icone sul lato sinistro. Il bordo per le icone mostra, ad esempio, i marcatori dei segnalibri.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Mostra numeri di riga </guilabel +></term> +<listitem +><para +>Se attivata, vedrai i numeri di riga sul lato sinistro.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Mostra i segni nella barra di scorrimento </guilabel +></term> +<listitem +><para +>Se questa opzione è attivata la vista attuale mostrerà indicatori sulla barra di scorrimento verticale. Questi segni possono mostrare, ad esempio, i segnalibri.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Ordina il menu dei segnalibri </guilabel +></term> +<listitem +><para> +<variablelist> +<varlistentry> +<term +><guilabel +>Per posizione </guilabel +></term> +<listitem +><para +>I segnalibri saranno ordinati a seconda dei numeri di riga a cui sono collocati.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Per creazione </guilabel +></term> +<listitem +><para +>Ogni nuovo segnalibro verrà aggiunto in coda, indipendentemente da dove è collocato nel documento.</para +></listitem> +</varlistentry> +</variablelist> +</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Mostra righe di indentazione </guilabel +></term> +<listitem +><para +>Se attivato, l'editor mostrerà delle righe verticali per favorire l'identificazione delle righe indentate.</para +></listitem> +</varlistentry> +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-colors"> +<title +>Caratteri e colori</title> + +<para +>Questo sezione della finestra permette di configurare tutti i caratteri e i colori in qualsiasi schema di colori tu abbia, oltre a creare nuovi schemi o eliminare quelli esistenti. Ciascuno schema ha impostazioni per i colori, i tipi di carattere e per gli stili del testo normale ed evidenziato. </para> + +<para +>&kate; preselezionerà lo schema attualmente attivo, se vuoi lavorare su uno schema diverso inizia selezionandolo dalla casella combinata <guilabel +>Schema</guilabel +>.</para> + +<sect3 id="config-dialog-editor-colors-colors"> +<title +>Colori</title> + +<variablelist> +<varlistentry id="config-dialog-editor-colors-colors-text-background"> +<term +><guilabel +>Sfondo area del testo</guilabel +></term> +<listitem> + +<variablelist> + +<varlistentry id="config-dialog-editor-colors-normal-text"> +<term +><guilabel +>Testo normale</guilabel +></term> +<listitem +><para +>Questo è lo sfondo predefinito per l'area dell'editor, sarà il colore dominante dell'area principale.</para +></listitem> +</varlistentry> + +<varlistentry id="config-dialog-editor-colors-selected-text"> +<term +><guilabel +>Testo selezionato</guilabel +></term> +<listitem +><para +>Il colore di sfondo del testo selezionato. Il valore predefinito è il colore globale della selezione, così come è configurato dalle preferenze dei colori di &kde;. </para +></listitem> +</varlistentry> + +<varlistentry id="config-dialog-editor-colors-current-line"> +<term +><guilabel +>Riga corrente</guilabel +></term> +<listitem +><para +>Imposta il colore della riga corrente. Se è un po' diverso da quello del testo normale, permette di tenere a fuoco la riga. </para +></listitem> +</varlistentry> + +<varlistentry id="config-dialog-editor-colors-marks"> +<term +><guilabel +>Segnalibro</guilabel +></term> +<listitem +><para +>Questa casella permette di scegliere i colori da sovrapporre per i vari tipi di indicatori. Il colore è miscelato con quello di sfondo della riga indicata, in modo che le righe con più indicatori o una riga indicata che è quella corrente ha uno sfondo che è una miscela di più colori. I colori degli indicatori sono anche usati se abiliti la visualizzazione degli indicatori nella barra di scorrimento.</para +></listitem> +</varlistentry> + +</variablelist> +</listitem> +</varlistentry> + +<varlistentry id="config-dialog-editor-colors-colors-other-elements"> +<term +><guilabel +>Elementi aggiuntivi</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Sfondo bordo sinistro</guilabel +></term> +<listitem +><para +>Questo colore è usato per gli indicatori, i bordi per i numeri di riga e per gli indicatori di raggruppamento sul lato sinistro della vista dell'editor, quando sono mostrati. </para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Numeri di riga</guilabel +></term> +<listitem +><para +>Questo colore è usato per disegnare i numeri di riga sul lato sinistro della vista, quando sono mostrati.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Evidenziazione parentesi</guilabel +></term> +<listitem +><para +>Questo colore è usato per lo sfondo delle parentesi corrispondenti. </para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Indicatori a capo automatico</guilabel +></term> +<listitem +><para +>Questo colore è usato per disegnare un motivo sulla sinistra delle righe fatte andare a capo automaticamente quando vengono allineate verticalmente, ed anche per l'indicatore di a capo statico.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Marcatori di tabulazione</guilabel +></term> +<listitem +><para +>Questo colore è usato per gli indicatori di spazi bianchi, quando sono abilitati. </para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +</variablelist> +</sect3> + +<sect3 id="config-dialog-editor-colors-fonts"> +<title +>Tipi di carattere</title> +<para +>Qui puoi scegliere il tipo di carattere dello schema. Puoi scegliere fra tutti i tipi di carattere disponibili nel sistema, ed impostare la dimensione predefinita. Un testo di esempio è mostrato nella parte inferiore della finestra, per darti un'idea dell'effetto della tua scelta. </para> +</sect3> + +<sect3 id="config-dialog-editor-colors-normal-text-styles"> +<title +>Stili testo normale</title> +<para +>Lo stile di testo normale è ereditato dagli stili di evidenziazione del testo; ciò permette all'editor di presentare il testo in modo coerente, ad esempio, il testo dei commenti è uguale in quasi tutti i formati di testo che &kate; può evidenziare.</para> +<para +>Il nome della lista di stili usa lo stile configurato per tale elemento, fornendoti un'anteprima quando configuri lo stile. </para> +<para +>Ogni stile permette di selezionare degli attributi comuni oltre ai colori di sfondo e primo piano. Per rimuovere l'impostazione del colore di sfondo, fai clic con il tasto destro per usare il menu contestuale.</para> +</sect3> + +<sect3 id="config-dialog-editor-colors-highlighting-text-styles"> +<title +>Stili testo evidenziazione</title> +<para +>Qui puoi modificare gli stili del testo usati per una specifica definizione di evidenziazione. L'editor preseleziona l'evidenziazione usata per il documento attuale. Per lavorare con un'evidenziazione diversa, selezionane una dalla casella combinata <guilabel +>Evidenziazione</guilabel +> sopra l'elenco di stili. </para> +<para +>Il nome della lista di stili usa lo stile configurato per tale elemento, fornendoti un'anteprima quando configuri lo stile. </para> +<para +>Ciascuno stile permette di selezionare attributi comuni oltre ai colori di sfondo e primo piano. Per eliminare il colore di sfondo, fai clic con il tasto destro per usare il menu contestuale. Inoltre puoi vedere se uno stile è uguale a quello predefinito dell'elemento, ed assegnarlo ad esso se non lo è.</para> +<para +>Noterai che molte evidenziazioni contengono altre evidenziazioni rappresentate dai gruppi nell'elenco di stili. Ad esempio la maggior parte delle evidenziazioni importano l'evidenziazione Alert, e molte altre importano l'evidenziazione per Doxygen. La modifica dei colori di questi gruppi ha effetto solo sugli stili quando è usata nel formato di evidenziazione modificato. </para> +</sect3> + +</sect2> + +<sect2 id="config-dialog-editor-cursor-selection"> +<title +>Cursore e selezione</title> + +<variablelist> + +<varlistentry> +<term +><guilabel +>Spostamento cursore testo</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Home e Fine intelligenti</guilabel +></term> +<listitem> +<para +>Se questa casella è marcata, la pressione del tasto Home farà saltare al cursore gli spazi bianchi e lo farà posizionare all'inizio del testo della riga.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Cursore a capo</guilabel +></term> +<listitem> +<para +>Quando è attiva, l'uso dei tasti <emphasis role="bold" +>freccia a sinistra</emphasis +> e <emphasis role="bold" +> freccia a destra</emphasis +> sul cursore di inserimento ne causerà lo sposterà alla riga precedente/successiva all'inizio/fine della riga, come nella maggior parte degli editor.</para +><para +>Quando non è attiva, il cursore di inserimento non può essere spostato a sinistra dell'inizio di una riga, ma può esserlo oltre la fine di una riga, funzione molto comoda per i programmatori. Quando questa opzione viene scelta, spostare il cursore con il tasto freccia destra oltre la fine di una riga (a destra) lo farà saltare all'inizio della successiva.Allo stesso modo quando il cursore è mosso indietro oltre l'inizio di una riga (a sinistra) salterà alla fine della riga precedente. Quando questa opzione non è selezionata, spostare il cursore a destra dopo la fine della riga, lo farà soltanto continuare orizzontalmente sulla stessa riga e cercare di muoverlo a sinistra dell'inizio della riga non farà nulla.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>PaginaSu/PaginaGiù sposta il cursore</guilabel +></term> +<listitem> +<para +>Questa opzione cambia il comportamento del cursore quando l'utente preme il tasto <keycap +>PaginaSu</keycap +> o il tasto <keycap +>PaginaGiù</keycap +>. Se non è selezionato il cursore del testo manterrà la sua posizione relativamente al testo visibile in &kate;, quando del nuovo testo diventerà visibile come risultato dell'operazione. Così se il cursore è al centro del testo visibile, quando avviene l'operazione, rimarrà lì (eccetto quando si raggiunge l'inizio o la fine). Quando questa opzione è selezionata, il primo tasto premuto causerà lo spostamento del cursore alla cima o alla base del testo visibile non appena si visualizza una nuova pagina di testo.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Centramento automatico cursore (righe):</guilabel +></term> +<listitem> +<para +>Imposta il numero di righe che, se possibile, devono rimanere visibili sopra e sotto il cursore.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Modalità di selezione</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Normale</guilabel +></term> +<listitem> +<para +>Le selezioni vengono sovrascritte con il testo digitato e vanno perse quando si muove il cursore.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Permanente</guilabel +></term> +<listitem> +<para +>Le selezioni rimangono anche dopo lo spostamento del cursore e l'inserimento di testo.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-edit"> +<title +>Modifica</title> +<variablelist> + +<varlistentry> +<term +><guilabel +>Tabulazioni</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Inserisci spazi invece delle tabulazioni</guilabel +></term> +<listitem> +<para +>Quando questa opzione è abilitata, l'editor inserirà un numero appropriato di spazi a seconda della posizione del testo e dell'ampiezza delle tabulazioni (<option +>tab-width</option +>) quando premi il tasto <keycap +>Tab</keycap +>.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Mostra le tabulazioni</guilabel +></term> +<listitem> +<para +>Quando questa voce è abilitata, &kate; mostra un puntino come rappresentazione visibile di un carattere di tabulazione.</para> +<note +><para +>Mostra anche dei puntini per gli spazi bianchi in fondo alle riga. Ciò verrà corretto in una futura versione di &kate;</para +></note> +</listitem> +</varlistentry> +<varlistentry> +<term id="config-dialog-editor-tab-width" +>Larghezza tabulazioni</term +> <listitem +><para +>Se l'opzione <link linkend="config-dialog-editor-word-wrap" +><guilabel +>Inserisci spazi invece delle tabulazioni</guilabel +></link +> è selezionata questa casella determina il numero di spazi con cui l'editor sostituirà le tabulazioni.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term id="config-dialog-editor-word-wrap" +><guilabel +>A capo automatico statico</guilabel +></term> +<listitem +><para +>L'a capo automatico è una funzionalità che fa iniziare automaticamente all'editor una nuova riga di testo e sposta il cursore all'inizio di quella nuova riga. &kate; comincerà automaticamente una nuova riga di testo quando la riga corrente raggiungerà la lunghezza specificata dall'opzione <link linkend="config-dialog-editor-wrap-words-at" +>Colonna a cui andare a capo</link +>.</para> +<variablelist> +<varlistentry> +<term +><guilabel +>Abilita a capo automatico statico</guilabel +></term> +<listitem> +<para +>Attiva o disattiva l'a capo automatico statico.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Mostra indicatori a capo automatico statico (se possibile)</guilabel +></term> +<listitem> +<para +>Se questa opzione è selezionata, verrà disegnata una barra verticale sulla colonna di andata a capo definita in <menuchoice +> <guimenu +>Impostazioni</guimenu +> <guimenuitem +>Configura editor...</guimenuitem +></menuchoice +> nella scheda Modifica. Nota che l'indicatore di andata a capo sarà disegnato solo se utilizzi un font a spaziatura fissa.</para> +</listitem> +</varlistentry> +<varlistentry id="config-dialog-editor-wrap-words-at"> +<term +><guilabel +>Colonna a cui andare a capo:</guilabel +></term> +<listitem> +<para +>Se l'opzione <link linkend="config-dialog-editor-word-wrap" +>A capo automatico</link +> è selezionata questa casella determina la lunghezza (in caratteri) arrivata alla quale l'editor comincerà automaticamente una nuova riga.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Rimuovi gli spazi finali</guilabel +></term> +<listitem +><para +>&kate; eliminerà automaticamente gli spazi extra alla fine delle righe di testo.</para +></listitem +> </varlistentry> + +<varlistentry> +<term +><guilabel +>Parentesi automatiche</guilabel +></term +> <listitem +><para +>Quando l'utente scrive una parentesi aperta ([, ( o {) &kate; inserisce automaticamente la parentesi chiusa corrispondente (}, ) o ]) alla destra del cursore.</para +></listitem> +</varlistentry> + +<varlistentry +> <term +>Massimo numero di<link linkend="undo" +>annullamenti</link +>:</term> +<listitem +><para +>Qui l'utente può specificare il numero di azioni che &kate; terrà in memoria allo scopo di azioni di annulla. Ciò significa che più alto è il numero di azioni, più memoria &kate; userà per questo. Impostare questa voce a 10 significherebbe che l'utente sarebbe in grado di revocare le ultime dieci operazioni, cioè facendo clic 10 volte sul pulsante di <guibutton +>annulla</guibutton +> e ottenendo i risultati.</para +></listitem +> </varlistentry> + +<varlistentry +> <term +>Fonte del testo da cercare:</term> +<listitem +><para +>Questa opzione determina la fonte da cui &kate; prenderà il testo da cercare, cioè il testo inserito automaticamente nella finestra Trova testo: <itemizedlist +> <listitem +><para +><emphasis role="bold" +>Nessuna:</emphasis +> non indovinare il testo da cercare.</para +></listitem +> <listitem +><para +><emphasis role="bold" +>Solo la selezione:</emphasis +> usa il testo attualmente selezionato, se possibile.</para +></listitem +> <listitem +><para +><emphasis role="bold" +>La selezione, poi la parola attuale:</emphasis +> usa la selezione attuale se possibile, altrimenti usa la parola attuale.</para +></listitem +> <listitem +><para +><emphasis role="bold" +>Solo la parola attuale:</emphasis +> usa la parola su cui si trova il cursore, se possibile.</para +></listitem +> <listitem +><para +><emphasis role="bold" +>La parola attuale, poi la selezione:</emphasis +> usa la parola attuale se possibile, altrimenti usa la selezione attuale.</para +></listitem +> </itemizedlist +> Nota che, in tutte le modalità indicate, se non è possibile determinare una stringa di ricerca allora verrà usato l'ultimo testo cercato. </para +></listitem> +</varlistentry> +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-indent"> +<title +>Indentazione</title> +<variablelist> +<varlistentry> +<term +><guilabel +>Indentazione automatica</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Modalità di indentazione:</guilabel +></term> +<listitem> +<para +>Seleziona la modalità di indentazione automatica che vuoi utilizzare come predefinita. Si raccomanda caldamente di impostare <userinput +>Nessuno</userinput +> o <userinput +>Normale</userinput +> e di utilizzare le configurazioni specifiche per tipo di file per impostare altre modalità di indentazione per formati di testo come codice C/C++ o &XML;.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Inserisci un "*" iniziale per Doxygen durante la scrittura</guilabel +></term> +<listitem> +<para +>Inserisce automaticamente un "*" quando si scrive un commento in stile Doxygen. Questa impostazione è abilitata solo quando si applica alla situazione.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Indentazione con spazi</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Usa gli spazi invece delle tabulazioni per indentare</guilabel +></term> +<listitem> +<para +>Questo sostituisce le tabulazioni con il numero di spazi impostato in <guilabel +>Numero di spazi:</guilabel +> più sotto.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Modalità mista stile Emacs</guilabel +></term> +<listitem> +<para +>Usa una miscela di tabulazioni e caratteri di spazio per l'indentazione.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Numero di spazi:</guilabel +></term> +<listitem> +<para +>Imposta il numero di spazi da usare per l'indentazione per l'opzione <guilabel +>Usa gli spazi invece delle tabulazioni</guilabel +>.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Conserva il profilo di indentazione</guilabel +></term> +<listitem +><para +>Quando questa opzione è abilitata,l'editor non eliminerà ulteriormente l'indentazione dalle righe selezionate quando essa viene annullata dalla riga con indentazione minima. Se talvolta togli l'indentazione da blocchi di codice dove essa è presente, questa opzione può essere utile. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Conserva gli spazi extra</guilabel +></term> +<listitem +><para +>Le indentazioni maggiori del numero di spazi selezionato non saranno accorciate.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Tasti da usare</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Il tasto Tab indenta</guilabel +></term> +<listitem> +<para +>Permette di usare il tasto <keycombo action="simul" +><keycap +>Tab</keycap +></keycombo +> per indentare.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Il tasto Backspace indenta</guilabel +></term> +<listitem> +<para +>Permette di usare il tasto <keycombo action="simul" +><keycap +>Backspace</keycap +></keycombo +> per indentare.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Modalità tasto Tab in caso di assenza di selezione</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Inserisci carattere di indentazione</guilabel +></term> +<listitem> +<para +>Permette che <keycombo action="simul" +><keycap +>Tab</keycap +></keycombo +> inserisca caratteri di rientro.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Inserisci carattere di tabulazione</guilabel +></term> +<listitem> +<para +>Permette che <keycombo action="simul" +><keycap +>Tab</keycap +></keycombo +> inserisca caratteri di tabulazione.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Indenta la riga attuale</guilabel +></term> +<listitem> +<para +>Permette che <keycombo action="simul" +><keycap +>Tab</keycap +></keycombo +> indenti la riga attuale.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-open-save"> +<title +>Apri/Salva</title> + +<variablelist> + +<varlistentry> +<term +><guilabel +>Formato file</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Codifica:</guilabel +></term> +<listitem> +<para +>Imposta la codifica predefinita dei tuoi file.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Fine della riga:</guilabel +></term> +<listitem> +<para +>Sceglie la modalità di fine riga preferita per il documento attuale. Puoi scegliere tra &UNIX;, DOS/&Windows;o Macintosh.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Rilevazione automatica fine riga</guilabel +></term> +<listitem> +<para +>Marca la casella se vuoi che l'editor riconosca automaticamente il tipo di fine riga. Il primo tipo di fine riga incontrato verrà usato per tutto il file.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Uso della memoria</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Massimo blocchi caricati per file:</guilabel +></term> +<listitem> +<para +>L'editor caricherà in memoria il numero di blocchi di testo indicato (di circa 2048 righe); se la dimensione del file è più grande il resto dei blocchi saranno mantenuti sul disco e caricati in modo trasparente quando necessario.</para> +<para +>Questo può causare brevi ritardi quando ci si sposta nel documento; un numero di blocchi più grande migliora la velocità in cambio di un maggior uso della memoria. </para +><para +>Per un uso normale, scegli il numero di blocchi più alto possibile: metti un limite solo se hai problemi di uso della memoria.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Pulizia automatica al salvataggio/caricamento</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Rimuovi gli spazi finali</guilabel +></term> +<listitem> +<para +>L'editor eliminerà automaticamente gli spazi in eccesso alla fine delle righe di testo durante il caricamento/salvataggio del file.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Cartella file di configurazione</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Profondità di ricerca del file di configurazione:</guilabel +></term> +<listitem> +<para +>L'editor cercherà più in su nell'albero delle cartelle del numero di livelli indicato per trovare i file di configurazione di &kate; e caricare le impostazioni da esso.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Copia di sicurezza al salvataggio</guilabel +></term> +<listitem +><para +>La copia di sicurezza al salvataggio fa copiare a &kate; il file su disco in "<prefisso><nomefile>suffisso<" prima di salvare le modifiche. Il suffisso predefinito è <emphasis role="bold" +>~</emphasis +> ed il prefisso è vuoto. </para> +<variablelist> +<varlistentry> +<term +><guilabel +>File locali</guilabel +></term> +<listitem> +<para +>Marca la casella se vuoi una copia di sicurezza dei file locali quando salvi.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>File remoti</guilabel +></term> +<listitem> +<para +>Marca la casella se vuoi una copia di sicurezza dei file remoti quando salvi.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Prefisso</guilabel +></term> +<listitem> +<para +>Inserisci il prefisso per i nomi delle copie di sicurezza.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Suffisso</guilabel +></term> +<listitem> +<para +>Inserisci il suffisso per i nomi delle copie di sicurezza.</para> +</listitem> +</varlistentry> + +</variablelist> +</listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-highlighting"> +<title +>Evidenziazione</title> +<para +>Questo gruppo di opzioni è usato per personalizzare gli stili di evidenziazione per ogni tipo di linguaggio di programmazione. Qualsiasi cambiamento fatto in altre aree di questa finestra di dialogo si applica solamente a questo tipo.</para> + +<variablelist> +<varlistentry> +<term +><guilabel +>Evidenziazione:</guilabel +></term> +<listitem +><para +>È usata per scegliere il tipo di linguaggio da configurare.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Informazioni</guilabel +></term> +<listitem> +<para +>Mostra le proprietà delle regole di evidenziazione del linguaggio scelto: nome dell'autore e licenza. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Proprietà</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Estensioni file:</guilabel +></term> +<listitem +><para +>Questa è la lista delle estensioni dei file usata per determinare quali file evidenziare con la modalità di evidenziazione della sintassi attuale.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Tipi MIME:</guilabel +></term> +<listitem +><para +>Facendo clic sul pulsante della procedura guidata apparirà una finestra con la lista dei tipi MIME disponibili da cui scegliere.</para +><para +>Verrà modificata anche la voce <emphasis role="bold" +>Estensioni file</emphasis +>.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Priorità:</guilabel +></term> +<listitem +><para +>Imposta la priorità della regola di evidenziazione.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>Scarica...</guibutton +></term> +<listitem> +<para +>Fai clic su questo pulsante per scaricare descrizioni delle sintassi aggiornate dal sito Web di &kate;. </para> +</listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-filetypes"> +<title +>Tipi di file</title> +<para +>Questa pagina ti permette di modificare la configurazione predefinita per documenti aventi specifici tipi mime. Quando l'editor carica un documento, ne cerca la corrispondenza, tramite le maschere o i tipi mime, con un tipo di file conosciuto. Se viene trovata più di una corrispondenza verrà usata quella con la più alta priorità. </para> +<variablelist> +<varlistentry> +<term +><guilabel +>Tipo di file:</guilabel +></term> +<listitem +><para +>Il tipo di file con la priorità più alta è quello mostrato nella prima casella combinata. Se vengono trovati più tipi di file, verranno mostrati tutti.</para> +<variablelist> +<varlistentry> +<term +><guilabel +>Nuovo</guilabel +></term> +<listitem +><para +>Questo è usato per creare un nuovo tipo di file. Dopo aver fatto clic su questo pulsante, i campi sottostanti si svuotano e puoi riempire quelli appropriati per il nuovo tipo di file.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Elimina</guilabel +></term> +<listitem +><para +>Per eliminare un tipo di file esistente, selezionalo dalla casella combinata e premi il pulsante Elimina.</para +></listitem> +</varlistentry> +</variablelist> +</listitem +> </varlistentry> + +<varlistentry> +<term +><guilabel +>Proprietà del tipo di file attuale</guilabel +></term> +<listitem +><para +>Il tipo di file con la priorità più alta è quello mostrato nella prima casella combinata. Se vengono trovati più tipi di file, verranno mostrati tutti.</para> +<variablelist> +<varlistentry> +<term +><guilabel +>Nome:</guilabel +></term> +<listitem +><para +>Il nome del tipo di file sarà il testo della corrispondente voce del menu. Questo nome è mostrato in <menuchoice +><guimenu +>Strumenti</guimenu +><guimenuitem +>Tipi di file</guimenuitem +></menuchoice +></para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Sezione:</guilabel +></term> +<listitem +><para +>Il nome della sezione è usato per organizzare i tipi di file nei menu. Può essere anche usato nel menu <menuchoice +><guimenu +>Strumenti</guimenu +><guimenuitem +>tipi di file</guimenuitem +></menuchoice +>.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Variabili:</guilabel +></term> +<listitem +><para +>Questa stringa permette di configurare le impostazioni di &kate; per i file selezionati da questo tipo mime usando le variabili di &kate;. Puoi impostare quasi tutte le opzioni di configurazione, come l'evidenziazione, la modalità di indentazione, la codifica ecc.</para +><para +>Per un elenco completo delle variabili vedi il manuale.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Estensioni file:</guilabel +></term> +<listitem +><para +>La maschera per i caratteri jolly permette di selezionare i file per nome. Una tipica maschera usa un asterisco e l'estensione del file, ad esempio <filename +>*.txt; *.text</filename +>. La stringa è un elenco di maschere separato da punti e virgola.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Tipi MIME:</guilabel +></term> +<listitem +><para +>Mostra una procedura guidata che ti consente di scegliere facilmente i tipi MIME.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Priorità:</guilabel +></term> +<listitem +><para +>Imposta una priorità per questo tipo di file. Se più di un tipo di file seleziona uno stesso file, verrà utilizzato il tipo di file con priorità più alta.</para +></listitem> +</varlistentry> +</variablelist> +</listitem +> </varlistentry> + +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-shortcuts"> +<title +>Scorciatoie</title> +<para +>Puoi cambiare da qui la configurazione dei tasti scorciatoia. Seleziona un'azione e fai clic su <guilabel +>Personalizzata</guilabel +> se vuoi una scorciatoia diversa per questa azione.</para> +<para +>La riga di ricerca permette di cercare un'azione specifica e vedere la scorciatoia associata.</para> +</sect2> + +<sect2 id="config-dialog-editor-plugins"> +<title +>Plugin</title> +<para +>Questa scheda elenca tutti i plugin disponibili; puoi marcare tutti quelli che vuoi usare. Una volta che hai marcato un plugin, il pulsante <guibutton +>Configura</guibutton +> è abilitato e puoi fare clic su di esso per configurare il plugin evidenziato.</para> +</sect2> + +</sect1> + + + +<sect1 id="config-variables"> + +<title +>Configurazione con le variabili del documento</title> + +<para +>Le variabili di Kate rappresentano l'implementazione come componente KatePart delle variabili del documento, simili alle modeline di emacs e di vi. Nella componente KatePart le righe hanno la forma <userinput +>kate: NOMEVARIABILE VALORE; [ NOMEVARIABILE VALORE; ... ]</userinput +> le righe possono naturalmente essere in un commento, se il formato del file prevede i commenti. I nomi delle variabili sono costituiti da un'unica parola (senza spazi) ed ogni cosa fino al successivo punto e virgola è interpretato come valore. Il punto e virgola è necessario.</para> + +<para +>Ecco un esempio di riga di variabili, che forza le regole di rientro per i file C++, Java o JavaScript: <programlisting +>// kate: space-indent on; indent-width 4; mixedindent off; indent-mode cstyle;</programlisting> +</para> + +<note +><para +>Solo le prime e le ultime 10 righe di ogni file vengono controllate alla ricerca di righe di variabili.</para +></note> + +<para +>Ci sono variabili per gestire quasi tutte le configurazioni di un componente KatePart, e i plugin aggiuntivi possono usare le variabili, che in tal caso devono essere documentate nel manuale del plugin.</para> + +<sect2 id="config-variables-howto"> +<title +>Come kate usa le variabili</title> + +<para +>Quando legge la configurazione, la componente KatePart controlla nelle seguenti posizioni (nell'ordine): <itemizedlist +> <listitem +><para +>La configurazione globale.</para +></listitem +> <listitem +><para +>Valori opzionali di sessione.</para +></listitem +> <listitem +><para +>La configurazione "Tipi di file".</para +></listitem +> <listitem +><para +>Variabili del documento presenti nel documento stesso.</para +></listitem +> <listitem +><para +>Impostazioni modificate in fase di modifica da menu o da riga di comando.</para +></listitem +> </itemizedlist +> Come puoi ben capire le variabili del documento hanno la priorità più alta. Quando un documento viene salvato, le variabili corrispondenti verranno lette nuovamente e sovrascriveranno i cambiamenti fatti tramite voci di menu o riga di comando.</para> + +<para +>Le variabili non elencate qui sotto possono essere inserite nel documento e possono essere utilizzate da altri oggetti come i plugin, che possono usarle per i propri scopi. Ad esempio la modalità di indentazione variabile usa le variabili del documento per la propria configurazione.</para> + +<para +>Le variabili elencate qui documentano &kate; versione 2.4. Altre variabili potrebbero essere aggiunte in futuro. Ci sono tre possibili tipi di valori per le variabili, con le seguenti espressioni valide: <itemizedlist> +<listitem +><para +>BOOL - on|off|true|false|1|0</para +></listitem> +<listitem +><para +>INTEGER - un numero intero</para +></listitem> +<listitem +><para +>STRING - qualsiasi altra cosa</para +></listitem> +</itemizedlist> +</para> + +<variablelist> +<title +>Variabili disponibili</title> + +<varlistentry> +<term +><cmdsynopsis +><command +>auto-brackets</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Attiva o disattiva l'inserimento automatico delle parentesi.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>auto-center-lines</command +><arg +>INT</arg +></cmdsynopsis +></term> +<listitem +><para +>Imposta il numero di righe autocentranti.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>auto-insert-doxygen</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Attiva o disattiva l'inserimento dell'asterisco iniziale nei commenti doxygen. Non ha effetto se non si usa l'indentazione automatica in stile C. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>background-color</command +><arg +>STRING</arg +></cmdsynopsis +></term> +<listitem +><para +>Imposta il colore di sfondo del documento. Il valore deve essere qualcosa che venga valutato come un colore valido, come "#ff0000".</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>backspace-indents</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Abilita o disabilita l'indentazione alla pressione del tasto Backspace.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>block-selection</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Attiva o disattiva la selezione per blocchi.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>bracket-highlight-color</command +><arg +>STRING</arg +></cmdsynopsis +></term> +<listitem +><para +>Il colore per l'evidenziazione delle parentesi. Deve essere qualcosa che venga valutato come un colore valido, come "#ff0000" </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>current-line-color</command +><arg +>STRING</arg +></cmdsynopsis +></term> +<listitem +><para +>Il colore della riga corrente. Il valore deve essere qualcosa che venga valutato come un colore valido, come "#ff0000".</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>dynamic-word-wrap</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Attiva o disattiva l'a capo automatico dinamico.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>eol | end-of-line</command +><arg +>STRING</arg +></cmdsynopsis +></term> +<listitem +><para +>Imposta la modalità di fine riga. Le impostazioni valide sono <quote +>unix</quote +>, <quote +>mac</quote +> e <quote +>dos</quote +></para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>encoding</command +><arg +>STRING</arg +></cmdsynopsis +></term> +<listitem +><para +>Imposta la codifica del documento. Il valore deve essere un nome di codifica valida, come <quote +>utf-8</quote +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>font-size</command +><arg +>INT</arg +></cmdsynopsis +></term> +<listitem +><para +>Imposta la dimensione in punti del tipo di carattere del documento.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>font</command +><arg +>STRING</arg +></cmdsynopsis +></term> +<listitem +><para +>Imposta il nome del tipo di carattere del documento. Il valore deve essere un tipo di carattere valido, per esempio <quote +>courier</quote +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>icon-bar-color</command +><arg +>STRING</arg +></cmdsynopsis +></term> +<listitem +><para +>Imposta il colore della barra per le icone. Il valore deve essere qualcosa che venga valutato come un colore valido, come <literal +>#ff0000</literal +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>icon-border</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Attiva o disattiva la visualizzazione del bordo per le icone.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>folding-markers</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Attiva o disattiva la visualizzazione degli indicatori di raggruppamento.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>indent-mode</command +><arg +>STRING</arg +></cmdsynopsis +></term> +<listitem +><para +>Imposta la modalità di indentazione automatica. Sono riconosciute le opzioni <quote +>none</quote +>, <quote +>normal</quote +>, <quote +>cstyle</quote +>, <quote +>csands</quote +>, <quote +>python</quote +> e <quote +>xml</quote +>. Vedi la sezione <xref linkend="kate-part-autoindent"/> per i dettagli.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>indent-width</command +><arg +>INT</arg +></cmdsynopsis +></term> +<listitem +><para +>Imposta l'ampiezza dell'indentazione.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>keep-extra-spaces</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Imposta de devono essere tenuti gli spazi extra quando si calcolano le ampiezze dell'indentazione.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>keep-indent-profile</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Se assegni TRUE a questa variabile, viene impedito la disindentazione di un blocco se almeno una riga non ha indentazione.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>line-numbers</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Attiva o disattiva la visualizzazione del numero di riga.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>mixed-indent</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Attiva o disattiva l'indetazione mista in stile Emacs.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>overwrite-mode</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Attiva o disattiva la modalità sovrascrittura.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>persistent-selection</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Attiva o disattiva la selezione persistente.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>remove-trailing-space</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Attiva o disattiva la ripulitura dinamica a fi di riga.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>replace-tabs-save</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Attiva o disattiva la conversione di tabulazioni in spazi in fase di salvataggio.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>replace-tabs</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Attiva o disattiva la conversione dinamica di tabulazioni in spazi.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>replace-trailing-space-save</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Attiva o disattiva la ripulitura della fine della riga in fase di salvataggio.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>scheme</command +><arg +>STRING</arg +></cmdsynopsis +></term> +<listitem +><para +>Imposta lo schema di colori. La stringa deve essere il nome di uno schema di colori che esiste nella tua configurazione perché abbia effetto.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>selection-color</command +><arg +>STRING</arg +></cmdsynopsis +></term> +<listitem +><para +>Imposta il colore della selezione. Il valore deve essere qualcosa che venga valutato come un colore valido, ad esempio "#ff0000#".</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>show-tabs</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Attiva o disattiva il carattere di tabulazione visibile.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>smart-home</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Attiva o disattiva la modalità di navigazione intelligente verso l'inizio della riga.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>space-indent</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Attiva o disattiva l'indentazione con spazi.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>tab-indents</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Attiva o disattiva l'indentazione col tasto Tab.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>tab-width</command +><arg +>INT</arg +></cmdsynopsis +></term> +<listitem +><para +>Imposta la larghezza a schermo della tabulazione.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>undo-steps</command +><arg +>INT</arg +></cmdsynopsis +></term> +<listitem +><para +>Imposta il numero di passi di annullamento da ricordare.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>word-wrap-column</command +><arg +>INT</arg +></cmdsynopsis +></term> +<listitem +><para +>Imposta l'ampiezza per l'a capo forzato.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>word-wrap-marker-color</command +><arg +>STRING</arg +></cmdsynopsis +></term> +<listitem +><para +>Imposta il colore per l'indicatore di a capo. Il valore deve essere qualcosa che venga valutato come un colore valido, come "#ff0000".</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>word-wrap</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Attiva o disattiva l'a capo forzato.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>wrap-cursor</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Attiva o disattiva l'a capo automatico del cursore.</para +></listitem> +</varlistentry> + +</variablelist> + +</sect2> + +</sect1> + +</chapter> diff --git a/tde-i18n-it/docs/tdebase/kate/fundamentals.docbook b/tde-i18n-it/docs/tdebase/kate/fundamentals.docbook new file mode 100644 index 00000000000..2cf183f3311 --- /dev/null +++ b/tde-i18n-it/docs/tdebase/kate/fundamentals.docbook @@ -0,0 +1,1089 @@ +<chapter id="fundamentals"> +<chapterinfo> +<authorgroup> +<author +><personname +><firstname +></firstname +></personname +></author> +<othercredit role="translator" +><firstname +>Nicola</firstname +> <surname +>Ruggero</surname +> <affiliation +><address +><email +>nicola@nxnt.org</email +></address +></affiliation +><contrib +>Traduzione della documentazione.</contrib +></othercredit +> +</authorgroup> +</chapterinfo> +<title +>I Fondamenti</title> + +<para +>Se hai già usato un editor di testo, non avrai problemi usando &kate;. Nelle prossime due sezioni, <link linkend="starting-kate" +>Avvio di &kate;</link +> e <link linkend="working-with-kate" +>Lavorare con &kate;</link +>, ti mostreremo tutto quello che devi sapere per iniziare ad usarlo velocemente. </para> + +<sect1 id="starting-kate"> +<title +>Avvio di &kate;</title> + +<para +>Puoi avviare &kate; dal menu <guimenu +>K</guimenu +> o dalla riga di comando. </para> + +<sect2 id="starting-from-the-menu"> +<title +>Dal menu</title> +<para +>Apri il menu dei programmi di &kde; facendo clic sulla grossa <guiicon +>K</guiicon +> nel pannello in fondo a sinistra del tuo schermo. Questo ti farà raggiungere il <guimenu +>menu programmi</guimenu +>. Muovi il tuo cursore verso la voce <menuchoice +><guimenu +>Accessori</guimenu +> <guimenuitem +>Editor</guimenuitem +></menuchoice +>. Apparirà una lista degli editor disponibili. Scegli <guimenuitem +>&kate;</guimenuitem +>. </para> + +<para +>Finché non dici a &kate; di non farlo, caricherà l'ultimo file che hai modificato. Vedi <link linkend="configure" +>Configurare &kate;</link +> per imparare come attivare o disattivare questa caratteristica. </para> + +</sect2> + +<sect2 id="starting-from-the-command-line"> +<title +>Dalla riga di comando</title> + +<para +>Puoi avviare &kate; digitando il nome dalla riga di comando. Se gli scrivi accanto anche il nome di un file, come nell'esempio qui sotto, ti apre o ti crea quel file. </para> + +<informalexample> +<screen +><prompt +>%</prompt +><userinput +><command +>kate</command +> <option +><replaceable +>miofile.txt</replaceable +></option +></userinput +> +</screen> +</informalexample> + +<para +>Se hai una connessione attiva, e i permessi, puoi approfittare del vantaggio della trasparenza nella rete di &kde; per aprire file in internet. </para> + +<informalexample> +<screen +><prompt +>%</prompt +><userinput +><command +>kate</command +> <option +><replaceable +>ftp://ftp.kde.org/pub/kde/LEGGIMI</replaceable +></option +></userinput +> +</screen> +</informalexample> + +<sect3 id="command-line-options"> +<title +>Opzioni dalla riga di comando</title> +<para +>&kate; accetta le seguenti opzioni dalla riga di comando:</para> + +<variablelist> +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--help</option +></userinput +></term> +<listitem> +<para +>Questo elenca le opzioni di base più comuni disponibili dalla riga di comando. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--help-qt</option +></userinput +></term> +<listitem> +<para +>Questo elenca le opzioni disponibili per modificare il modo in cui &kate; interagisce con &Qt;. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--help-kde</option +></userinput +></term> +<listitem> +<para +>Questo elenca le opzioni disponibili per modificare il modo in cui &kate; interagisce con &kde;. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>-s</option +> <option +>--start</option +> <parameter +>nome</parameter +></userinput +></term> +<listitem> +<para +>Avvia kate con la sessione <parameter +>nome</parameter +>. La sessione è creata se non è già esistente. Se un'istanza di &kate; con la sessione specificata è già in esecuzione, i file specificati sono caricati in tale istanza. Quando è usata con l'opzione <option +>--use</option +>, verrà usata allo stesso modo un'istanza in esecuzione con questa sessione. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>-u</option +> <option +>--use</option +> <parameter +>URL</parameter +></userinput +></term> +<listitem> +<para +>Fa usare a &kate; un'istanza già esistente se ne esiste una. Se vuoi aprire tutti i documenti in una sola istanza di &kate;, puoi aggiungere questa opzione al comando predefinito nella configurazione delle applicazioni di &kde;, e puoi creare un alias per la shell, se il tuo interprete di comandi la supporta. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>-p</option +> <option +>--pid</option +> <parameter +>PID</parameter +></userinput +></term> +<listitem> +<para +>Riutilizza un'istanza con il PID specifico (ID del processo) Usala con l'opzione <option +>--use</option +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--encoding</option +> <parameter +>codifica</parameter +> <parameter +>URL</parameter +></userinput +></term> +<listitem +><para +>Usa la codifica specificata per il documento. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--line</option +> <parameter +>riga</parameter +> <parameter +>URL</parameter +></userinput +></term> +<listitem +><para +>Si posiziona alla riga specificata dopo aver aperto il documento. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--column</option +> <parameter +>colonna</parameter +> <parameter +>URL</parameter +></userinput +></term> +<listitem +><para +>Si posiziona alla colonna specificata dopo aver aperto il documento. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--stdin</option +></userinput +></term> +<listitem +><para +>Legge il contenuto del documento da STDIN. È simile all'opzione <option +>-</option +> comunemente usata in molti programmi da riga di comando, e permette di incanalare l'output di un comando in &kate;.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--tempfile</option +></userinput +></term> +<listitem +><para +>Da &kate; 2.5.1 questa opzione standard di &kde; è supportata. Quando è usata, i file specificati sono trattati come file temporanei e cancellati (se sono locali ed hai i permessi appropriati) quando vengono chiusi, a meno che non siano modificati da quando sono stati aperti.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--help-all</option +></userinput +></term> +<listitem> +<para +>Questo elenca tutte le opzioni disponibili dalla riga di comando. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--author</option +></userinput +></term> +<listitem> +<para +>Elenca gli autori di &kate; nella finestra del terminale. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>-v</option +> <option +>--version</option +></userinput +></term> +<listitem> +<para +>Elenca le informazioni sulla versione di &Qt;, &kde; e &kate;. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--license</option +></userinput +></term> +<listitem> +<para +>Mostra le informazioni sulla licenza. </para> +</listitem> +</varlistentry> +</variablelist> +</sect3> +</sect2> + +<sect2 id="drag-and-drop"> +<title +>Trascinamento</title> +<para +>&kate; usa il protocollo di trascinamento (drag and drop protocol) di &kde;. I file possono essere trascinati e rilasciati in &kate; dal Desktop, &konqueror; o da alcuni siti ftp aperti in più finestre di &konqueror;. </para> +</sect2> +</sect1> + +<sect1 id="working-with-kate"> +<title +>Lavorare con &kate;</title> +<para +><link linkend="quick-start" +>Avvio rapido</link +> ti mostrerà come modificare quattro semplici opzioni che ti consentiranno di configurare alcune della più potenti caratteristiche di &kate;. <link linkend="keystroke-commands" +>Scorciatoie</link +> visualizza alcune delle scorciatoie predefinite per le quali non è possibile o desiderabile usare il mouse. </para> + +<sect2 id="quick-start"> +<title +>Avvio rapido</title> + +<para +>Questa sezione descrive alcuni degli elementi presenti nel menu <guimenu +>Impostazioni</guimenu +> in modo che tu possa configurare rapidamente &kate; per lavorare nella maniera che desideri. </para> + +<para +>Avviando &kate; per la prima volta vedrai due finestre con lo sfondo bianco. Sopra le due finestre c'è una barra degli strumenti con le solite icone etichettate. E sopra a questa, la barra dei menu. </para> + +<para +>La finestra di sinistra è una barra laterale. Combina le finestre dei Documenti dei file e del Selettore dei file. Cambia da una finestra all'altra facendo clic sulle linguette a sinistra. </para> + +<para +>Se hai avviato &kate; con un file, la finestra a destra mostrerà il file che stai modificando ed il pannello Documenti nella barra laterale mostrerà il nome del file. Usa la finestra del Selettore dei file per aprire i file. </para> + +<para +>Puoi attivare o disattivare il pannello dei Documenti o del Selettore file dal menu <menuchoice +><guimenu +>Finestre</guimenu +><guimenu +>Viste accessorie</guimenu +></menuchoice +>. Questo menu offre una prima occhiata alle potenzialità e alla flessibilità di &kate;. In questa sezione tratteremo tre elementi: </para> + +<variablelist> + +<varlistentry> +<term> +<menuchoice> +<guimenuitem +>Mostra/Nascondi documenti</guimenuitem> +</menuchoice> +</term> +<listitem> +<para +>Attiva o disattiva i Documenti. Se la finestra Documenti/Selettore file non è aperta, &kate; apre la barra laterale come una finestra separata e non agganciata. Per agganciare la finestra afferra le due sottili linee parallele sopra le linguette facendo clic su esse con il &LMB; e mantenendo premuto il pulsante. Trascina la finestra nella finestra dell'editor di &kate; e rilascia il &LMB; quando hai posizionato la finestra Documenti/Selettore file dove preferisci. </para> + +<tip> +<para +>Se hai afferrato con successo le due linee parallele il tuo puntatore del mouse si trasformerà in due frecce incrociate fin tanto che trascini. </para> +</tip> + +</listitem> +</varlistentry> +<varlistentry> +<term +><menuchoice +><guimenuitem +>Mostra nascondi Browser del filesystem</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Attiva o disattiva il Selettore file. Questo elemento del menu è lo stesso di <guimenuitem +>Mostra Documenti</guimenuitem +> con una differenza. Attivandolo apri la finestra con i Documenti in primo piano. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenuitem +>Mostra/Nascondi terminale</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Attiva o disattiva la visualizzazione dell'emulatore di terminale nella parte bassa della finestra di &kate;. In altre parole, ti fornisce una riga di comando integrata nell'applicazione. </para> +</listitem> +</varlistentry> +</variablelist> +</sect2> + +<sect2 id="keystroke-commands"> +<title +>Scorciatoie</title> + +<para +>Molte scorciatoie di &kate; possono essere configurate attraverso il menu <link linkend="settings" +>Impostazioni</link +>. Le impostazioni predefinite di &kate; prevedono le seguenti associazioni di tasti. </para> + +<informaltable> +<tgroup cols="2"> +<tbody> + +<row +><entry +><para +><keycap +>inserisci</keycap +></para +></entry> +<entry +><para +>Cambia tra la modalità Inserisci e Sovrascrivi. Quando sei nella modalità Inserisci l'editor aggiunge al testo i caratteri digitati e spinge il testo già presente a sinistra del cursore. La modalità Sovrascrivi fa in modo che l'inserimento di ogni carattere elimini il carattere immediatamente a destra del cursore.</para +></entry> +</row> +<row> +<entry +><para +><keycombo +><keycap +>Freccia sinistra</keycap +></keycombo +></para +></entry> +<entry +><para +>Muove il cursore un carattere a sinistra </para +></entry> +</row> +<row> +<entry +><para +><keycombo +><keycap +>Freccia destra</keycap +></keycombo +></para +></entry> +<entry +><para +>Muove il cursore un carattere a destra </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Freccia su</keycap +></keycombo +></para +></entry> +<entry +><para +>Muove il cursore su di una riga </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Freccia giù</keycap +></keycombo +></para +></entry> +<entry +><para +>Muove il cursore giù di una riga </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Pagina su</keycap +></keycombo +></para +></entry> +<entry +><para +>Muove il cursore su di una pagina </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Pagina giù</keycap +></keycombo +></para +></entry> +<entry +><para +>Muove il cursore giù di una pagina </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Backspace</keycap +></keycombo +></para +></entry> +<entry +><para +>Cancella il carattere a sinistra del cursore </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Home</keycap +></keycombo +></para +></entry> +<entry +><para +>Muove il cursore all'inizio della riga </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Fine</keycap +></keycombo +></para +></entry> +<entry +><para +>Muove il cursore alla fine della riga </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Canc</keycap +></keycombo +></para +></entry> +<entry +><para +>Cancella il carattere a destra del cursore (o qualsiasi testo selezionato)</para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Shift;<keycap +>Freccia sinistra</keycap +></keycombo +></para +></entry> +<entry +><para +>Seleziona il testo un carattere a sinistra </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Shift;<keycap +>Freccia destra</keycap +></keycombo +></para +></entry> +<entry +><para +>Seleziona il testo un carattere a destra </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>F1</keycap +></keycombo +></para +></entry> +<entry +><para +>Aiuto</para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Shift;<keycap +>F1</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="whats-this" +>Che cos'è?</link +></para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>F</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="find" +>Trova</link +></para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>F3</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="find-again" +>Trova ancora</link +></para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>B</keycap +></keycombo +></para +></entry> +<entry +><para +>Imposta un segnalibro</para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>C</keycap +></keycombo +></para +></entry> +<entry +><para +>Copia il testo selezionato negli appunti. </para +></entry> +</row> + +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>N</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="new" +>Nuovo</link +> documento</para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>P</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="print" +>Stampa</link +> </para +></entry> +</row> +<row> + +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>Q</keycap +></keycombo +></para +></entry> +<entry +><para +>Esci - chiude la copia attiva dell'editor </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>R</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="replace" +>Sostituisci</link +></para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>S</keycap +></keycombo +></para +></entry> +<entry +><para +>Salva il file.</para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>V</keycap +></keycombo +></para +></entry> +<entry +><para +>Incolla.</para +></entry> +</row> + +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>X</keycap +></keycombo +></para +></entry> +<entry +><para +>Cancella il testo selezionato e lo copia negli appunti. </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>Z</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="undo" +>Annulla</link +></para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>Z</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="redo" +>Rifai</link +></para +></entry> +</row> +</tbody> +</tgroup> +</informaltable> +</sect2> + +</sect1> + +<sect1 id="fundamentals-using-sessions"> +<title +>Uso delle sessioni</title> + +<para +>Le sessioni sono il metodo che &kate; usa per raccogliere liste multiple di file e di configurazioni. Puoi avere tante sessioni con nome quante ne vuoi, e puoi usare le sessioni senza nome o anonime per i file che vuoi usare solo una volta. Attualmente &kate; può salvare la lista dei file aperti e la configurazione generale della finestra in una sessione; versioni future di &kate; potrebbero aggiungere altre caratteristiche memorizzabili nelle sessioni. Con l'introduzione delle sessioni, &kate; permette anche di aprire un numero a piacere di istanze dell'applicazione invece di una sola, come faceva normalmente prima.</para> + +<para +>Le sessioni sono utilizzate in tre aree: <itemizedlist> +<listitem +><para +><link linkend="command-line-options" +><emphasis +>Le opzioni da riga di comando</emphasis +></link +> che permettono di selezionare ed avviare sessioni quando si avvia kate dalla riga di comando.</para> +</listitem> +<listitem +><para +><link linkend="sessions-menu" +><emphasis +>Il menu Sessioni</emphasis +></link +> che permette di cambiare, salvare e gestire le sessioni.</para +></listitem> +<listitem +><para +><link linkend="config-dialog-sessions" +><emphasis +>Le opzioni di configurazione</emphasis +></link +> che permettono di decidere come debbano comportarsi generalmente le sessioni.</para +></listitem> +</itemizedlist> + +</para> + +<para +>Quando si avvia una nuova sessione viene caricata la configurazione della GUI della <guilabel +>Sessione predefinita</guilabel +>. Per salvare la configurazione della finestra come sessione predefinita, devi abilitare il salvataggio della configurazione della finestra nella pagina di configurazione delle sessioni della finestra di configurazione e poi caricare la sessione predefinita, impostare la finestra come preferisci e salvare nuovamente la sessione.</para> + +<para +>Quando viene caricata una sessione nominata, &kate; mostra il nome della sessione all'inizio del titolo, che quindi avrà la forma "<replaceable +>Nome sessione</replaceable +>: <replaceable +>Nome o &URL; del documento</replaceable +> - &kate;"</para> + +<para +>Aprendo i file da riga di comando con <option +>--start <replaceable +>nome</replaceable +></option +> o se selezioni una sessione dal selettore delle sessioni, la sessione specificata è caricata prima dei file specificati dalla riga di comando. Per aprire file dalla riga di comando in una sessione nuova e senza nome, configura kate per avviare una nuova sessione in modo predefinito dalla pagina delle sessioni della finestra di configurazione oppure usa l'opzione <option +>--start</option +> con una stringa vuota: <replaceable +>''</replaceable +>.</para> + +<para +>Da &kate; 2.5.1 il <acronym +>PID</acronym +> dell'istanza attuale è esportato alla variabile di ambiente <envar +>KATE_PID</envar +>. Quando vengono aperti dei file dal terminale integrato Kate selezionerà automaticamente l'istanza attuale se non viene indicato nient'altro sulla riga di comando.</para> + +<sect2 id="old-behavior"> +<title +>Ripristinare il comportamento delle vecchie versioni di &kate;</title> + +<para +>Quando ti sarai abituato all'uso delle sessioni, speriamo che tu le trovi un metodo semplice ed efficiente per lavorare in vari campi. Però se preferisci il vecchio comportamento di &kate; (un'istanza apre tutti i file), puoi facilmente ottenerlo seguendo questa semplice strategia: <itemizedlist> +<listitem +><para +>Fai in modo che &kate; sia avviato sempre con il parametro <option +>--use</option +>, aggiungendo l'opzione al comando fra le preferenze dell'applicazione, e aggiungendo un alias per la shell.</para +></listitem> +<listitem +><para +>Configura &kate; per caricare l'ultima sessione usata all'avvio.</para> +</listitem> +<listitem +><para +>Configura &kate; per salvare l'elenco dei file quando viene chiusa una sessione. </para +></listitem> +<listitem +><para +>Carica la sessione predefinita una volta</para +></listitem> +</itemizedlist> +</para> + +</sect2> + +</sect1> + +<sect1 id="fundamentals-getting-help"> + +<title +>Ricevere aiuto</title> + +<sect2> + +<title +>Con &kate;</title> +<variablelist> + +<varlistentry> +<term +>Questo manuale</term> + +<listitem> +<para +>Offre una documentazione dettagliata su tutti i comandi dei menu, opzioni di configurazione, strumenti, finestre di dialogo, plugin &etc; così come le descrizioni delle finestre di &kate;, l'editor e i vari concetti usati nell'applicazione.</para> + +<para +>Premi <keycap +>F1</keycap +> o usa il menu <menuchoice +><guimenu +>Aiuto</guimenu +></menuchoice +> <guisubmenu +>Manuale di Kate</guisubmenu +> per visualizzare questo manuale.</para +></listitem> + +</varlistentry> + +<varlistentry id="whats-this"> +<term +>Guida a Che cos'è?</term> +<listitem> +<para +>Che cos'è? offre un aiuto immediato con i singoli elementi delle finestre grafiche, come i pulsanti o altre aree della finestra.</para> + +<para +>Noi ci sforziamo di fornire l'aiuto Che cos'è? a tutti gli elementi per cui ha senso che esista. È disponibile nella finestra di dialogo della configurazione e in molte altre finestre di dialogo.</para> + +<para +>Per usare l'aiuto Che cos'è?, premi <keycombo +>&Shift;<keycap +>F1</keycap +></keycombo +> oppure usa il menu <menuchoice +><guimenu +>Aiuto</guimenu +><guimenuitem +>Che cos'è?</guimenuitem +></menuchoice +> per abilitare la modalità Che cos'è?. In questo caso il cursore si trasformerà in una freccia con un punto di domanda. Ora puoi fare clic su qualsiasi elemento della finestra e leggere l'aiuto Che cos'è? per quell'elemento (se disponibile).</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Pulsanti di aiuto nelle finestre di dialogo</term> +<listitem> +<para +>Alcune finestre di dialogo possiedono il pulsante <guibutton +>Aiuto</guibutton +>. Se lo premi aprirai il centro di &khelpcenter; e quindi la documentazione collegata.</para> +</listitem> +</varlistentry> +</variablelist> + +</sect2> + +<sect2> +<title +>Con i tuoi file di testo</title> + +<para +>&kate; non fornisce (non ancora!) tutti gli strumenti per leggere la documentazione relativa ai documenti. A seconda del file che stai modificando, puoi trovare utile la <link linkend="kate-mdi-tools-konsole" +>&konsole; integrata</link +> per vedere le pagine del manuale di &UNIX; o la documentazione di info, oppure puoi usare &konqueror;.</para> + +</sect2> + +</sect1> + +</chapter> diff --git a/tde-i18n-it/docs/tdebase/kate/highlighting.docbook b/tde-i18n-it/docs/tdebase/kate/highlighting.docbook new file mode 100644 index 00000000000..9ef12ca9233 --- /dev/null +++ b/tde-i18n-it/docs/tdebase/kate/highlighting.docbook @@ -0,0 +1,1380 @@ +<appendix id="highlight"> +<appendixinfo> +<authorgroup> +<author +><personname +><firstname +></firstname +></personname +></author> +<othercredit role="translator" +><firstname +>Luciano</firstname +><surname +>Montanaro</surname +><affiliation +><address +><email +>mikelima@cirulla.net</email +></address +></affiliation +><contrib +>Traduzione</contrib +></othercredit +> +</authorgroup> +</appendixinfo> +<title +>Lavorare con l'evidenziazione della sintassi</title> + +<sect1 id="highlight-overview"> + +<title +>Panoramica</title> + +<para +>L'evidenziazione della sintassi è ciò che rende l'editor capace di mostrare il testo in diversi stili e colori, a seconda della funzione delle stringhe per il tipo di file in fase di modifica. Nei sorgenti dei programmi, ad esempio, le istruzioni di controllo potrebbero essere rese in grassetto, mentre i tipi di dato ed i commenti potrebbero essere colorati diversamente dal resto del testo. Ciò migliora molto la leggibilità del testo, e quindi aiuta l'autore ad essere più efficiente e produttivo.</para> + +<mediaobject> +<imageobject +><imagedata format="PNG" fileref="highlighted.png"/></imageobject> +<textobject +><phrase +>Una funzione Perl, mostrata con l'evidenziazione della sintassi.</phrase +></textobject> +<caption +><para +>Una funzione Perl, mostrata con l'evidenziazione della sintassi.</para> +</caption> +</mediaobject> + +<mediaobject> +<imageobject +><imagedata format="PNG" fileref="unhighlighted.png"/></imageobject> +<textobject +><phrase +>La stessa funzione Perl, senza l'evidenziazione.</phrase +></textobject> +<caption +><para +>La stessa funzione Perl, senza l'evidenziazione.</para +></caption> +</mediaobject> + +<para +>Dei due esempi, qual è la più facile da leggere?</para> + +<para +>&kate; ha un sistema flessibile, configurabile e capace per eseguire l'evidenziazione della sintassi, e la distribuzione standard fornisce le definizioni per un'ampia gamma di linguaggi di programmazione, di script, di annotazione e per altri formati di file testuali. In più, puoi fornire le tue definizioni in semplici file &XML;.</para> + +<para +>&kate; riconosce automaticamente le regole di sintassi appropriate quando apre un file, in base al suo tipo &MIME;, determinato dall'estensione, o se non ne ha, dal contenuto. Se facesse una scelta sbagliata, puoi indicare a mano la sintassi da usare dal menu <menuchoice +><guimenu +>Strumenti</guimenu +><guisubmenu +>Evidenziazione</guisubmenu +></menuchoice +>.</para> + +<para +>Gli stile e colori usati da ciascuna definizione di evidenziazione della sintassi possono essere configurati usando la pagina <link linkend="config-dialog-editor-appearance" +>Aspetto</link +> della <link linkend="config-dialog" +>finestra di configurazione</link +>, mentre i tipi &MIME; per cui va usato sono gestiti dalla pagina di <link linkend="config-dialog-editor-highlighting" +>Evidenziazione</link +>.</para> + +<note> +<para +>L'evidenziazione della sintassi è fatta per migliorare la leggibilità di testo corretto, ma non puoi affidarti ad essa per la convalida del testo. Analizzare il testo per riconoscerne la sintassi è un compito difficile, per alcuni formati, e in qualche caso gli autori delle regole di riconoscimento sono orgogliosi quando riescono a rendere correttamente il 98% del testo, sebbene molto spesso devi usare uno stile molto raro per vedere il 2% scorretto.</para> +</note> + +<tip> +<para +>Puoi scaricare definizioni per l'evidenziazione della sintassi aggiornate o aggiuntive dal sito Web di &kate;, facendo clic sul pulsante <guibutton +>Scarica</guibutton +> dalla pagina <link linkend="config-dialog-editor-highlighting" +>Evidenziazione</link +> della <link linkend="config-dialog" +>finestra di configurazione</link +>.</para> +</tip> + +</sect1> + +<sect1 id="katehighlight-system"> + +<title +>Il sistema di evidenziazione della sintassi di &kate;</title> + +<para +>Questa sezione tratta del meccanismo di evidenziazione della sintassi di &kate; in maggior dettaglio. È per chi voglia saperne di più o per chi voglia creare o modificare le definizioni della sintassi.</para> + +<sect2 id="katehighlight-howitworks"> + +<title +>Come funziona</title> + +<para +>Quando apri un file, una delle prime attività svolte da &kate; è l'identificazione della definizione della sintassi da usare per tale file. Leggendo il testo del file, o quando tu lo immetti, il sistema di evidenziazione analizza il testo usando le regole definite dalle definizioni della sintassi e si segna dove i diversi contesti e stili iniziano e finiscono.</para> + +<para +>Quando scrivi nel documento, il nuovo testo è analizzato e catalogato al volo, quindi de elimini un carattere che è indicato come l'inizio o la fine di un contesto, lo stile del testo adiacente cambierà di conseguenza.</para> + +<para +>Le definizioni delle sintassi usate dal sistema di evidenziazione della sintassi di &kate; sono file &XML; contenenti <itemizedlist> +<listitem +><para +>Regole per identificare il ruolo del testo, organizzato in blocchi contestuali</para +></listitem> +<listitem +><para +>Elenco delle parole chiave</para +></listitem> +<listitem +><para +>Definizione degli elementi di stile</para +></listitem> +</itemizedlist> +</para> + +<para +>Quando viene analizzato il testo, le regole di identificazione sono valutate nell'ordine in cui sono definite, e se l'inizio della stringa attuale corrisponde ad una regola, il contesto correlato viene usato. Il punto iniziale del testo è spostato al punto finale in cui la regola corrisponde, e viene eseguito un nuovo ciclo sulle regole, iniziando nel contesto della regola applicata.</para> + +</sect2> + +<sect2 id="highlight-system-rules"> +<title +>Regole</title> + +<para +>Le regole di identificazione sono il cuore del sistema di evidenziazione. Una regola è una stringa, un carattere o una <link linkend="regular-expressions" +>espressione regolare</link +> da confrontare con il testo da analizzare. Contiene informazioni su quale stile usare per la parte del testo a cui corrisponde. Può cambiare il contesto di lavoro del sistema o ad un contesto esplicitamente menzionato o al precedente contesto usato dal testo.</para> + +<para +>Le regole sono organizzate in gruppi di contesti. Un gruppo di contesti è usato per i concetti principali del testo all'interno del formato, ad esempio stringhe di caratteri virgolettate o blocchi di commento nei sorgenti di programma. Ciò assicura che il sistema di evidenziazione non debba controllare tutte le regole quando non è necessario, e che alcune sequenze di caratteri possano essere trattate in modo diverso a seconda del contesto attuale. </para> + +<para +>I contesti possono essere generati dinamicamente per permettere l'uso di dati specifici per le istanze nelle regole.</para> + +</sect2> + +<sect2 id="highlight-context-styles-keywords"> +<title +>Stili del contesto e parole chiave</title> + +<para +>In alcuni linguaggi di programmazione i numeri interi sono trattati dal compilatore (il programma che converte il codice sorgente in eseguibile binario) in modo diverso dai numeri in virgola mobile, e ci possono essere caratteri con significati speciali all'interno delle stringhe fra virgolette. In questi casi, ha senso che vengano composti tipograficamente in modo diverso rispetto al testo circostante, in modo che siano riconoscibili facilmente. Quindi anche se non rappresentano un contesto speciale, possono essere visti in tal modo dal sistema di evidenziazione, perché possano essere resi in modo diverso.</para> + +<para +>Una definizione di sintassi può contenere tanti stili quanti sono richiesti per coprire i concetti del formato per cui è usata.</para> + +<para +>In molti formati, ci sono elenchi di parole che rappresentano un concetto specifico. Ad esempio nei linguaggi di programmazione, le istruzioni di controllo sono un concetto, i nomi dei tipi di dato sono un altro, le funzioni built-in di un linguaggio un terzo. Il sistema di evidenziazione di &kate; può usare questi elenchi per identificare ed indicare le parole del testo in modo da enfatizzare i concetti dei formati di testo.</para> + +</sect2> + +<sect2 id="kate-highlight-system-default-styles"> +<title +>Stili predefiniti</title> + +<para +>Se apri un file sorgente C++ o &Java; o un documento <acronym +>HTML</acronym +> in &kate;, vedrai che anche se i formati sono diversi, e quindi parole diverse sono scelte per un trattamento speciale, i colori usati sono gli stessi. Ciò è dovuto al fatto che &kate; ha un elenco di stili predefiniti che sono usati nelle varie definizioni di sintassi.</para> + +<para +>Ciò rende più semplice riconoscere concetti simili nei vari formati di testo. Ad esempio i commenti sono presenti in quasi tutti i linguaggi per la programmazione, gli script e l'annotazione, e se sono mostrati con lo stesso stile in tutti i linguaggi, non è necessario fermarsi a pensare per identificarli all'interno del testo.</para> + +<tip> +<para +>Tutti gli stili di una definizione di sintassi usano uno degli stili predefiniti. Alcune definizioni di sintassi usano più stili di quelli presenti fra i predefiniti, quindi se usi spesso un formato, può essere utile avviare la finestra di configurazione per vedere se alcuni concetti usano lo stesso stile. Ad esempio c'è un solo stile predefinito per le stringhe, ma poiché il linguaggio di programmazione Perl usa due tipi di stringhe distinti, puoi migliorare l'evidenziazione configurando i due tipi per avere un aspetto leggermente diverso. Tutti gli <link linkend="kate-highlight-default-styles" +>stili predefiniti disponibili</link +> sono spiegati in dettaglio in seguito.</para> +</tip> + +</sect2> + +</sect1> + +<sect1 id="katehighlight-xml-format"> +<title +>Il formato &XML; di definizione dell'evidenziazione</title> + +<sect2> +<title +>Panoramica</title> + +<para +>Questa sezione è una panoramica del formato &XML; di definizione dell'evidenziazione. Partendo da un breve esempio, descriverà le componenti principali ed il loro significato ed uso. La sezione successiva approfondirà i dettagli delle regole di identificazione per l'evidenziazione.</para> + +<para +>La definizione formale, anche nota come <acronym +>DTD</acronym +>, è memorizzata nel file <filename +>language.dtd</filename +> che dovrebbe essere installato sul tuo sistema nella cartella <filename +>$<envar +>KDEDIR</envar +>/share/apps/katepart/syntax</filename +>. </para> + +<variablelist> +<title +>Sezioni principali dei file di definizione dell'evidenziazione di &kate;</title> + +<varlistentry> +<term +>Un file di evidenziazione contiene un'intestazione che stabilisce la versione di XML ed il tipo di documento:</term> +<listitem> +<programlisting +><?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE language SYSTEM "language.dtd"> +</programlisting> +</listitem> +</varlistentry> + +<varlistentry> +<term +>La radice del file di definizione è l'elemento <userinput +>language</userinput +>. Gli attributi disponibili sono:</term> + +<listitem> +<para +>Attributi obbligatori:</para> +<para +><userinput +>name</userinput +> definisce il nome del linguaggio. Apparirà nei menu e nelle finestre di dialogo.</para> +<para +><userinput +>section</userinput +> specifica la categoria.</para> +<para +><userinput +>extensions</userinput +> definisce le estensioni dei file, come "*.cpp,*.h"</para> + +<para +>Attributi opzionali:</para> +<para +><userinput +>mimetype</userinput +> associa i file basati sui tipi &MIME;.</para> +<para +><userinput +>version</userinput +> specifica la versione attuale del file di definizione.</para> +<para +><userinput +>kateversion</userinput +> specifica l'ultima versione di &kate; supportata.</para> +<para +><userinput +>casesensitive</userinput +> specifica se le parole chiave fanno distinzione fra maiuscole e minuscole o no.</para> +<para +><userinput +>priority</userinput +> è un campo necessario se un altro file di evidenziazione usa la stessa estensione. Il file di definizioni che ha la priorità più alta vince.</para> +<para +><userinput +>author</userinput +> contiene il nome dell'autore ed il suo indirizzo di posta elettronica.</para> +<para +><userinput +>license</userinput +> contiene la licenza di distribuzione, solitamente LGPL, Artistic, GPL o altre.</para> +<para +><userinput +>hidden</userinput +> definisce se il nome debba apparire nei menu di &kate;.</para> +<para +>Quindi la successiva riga potrebbe assomigliare a questa:</para> +<programlisting +><language name="C++" version="1.00" kateversion="2.4" section="Sources" extensions="*.cpp;*.h" /> +</programlisting> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>Segue l'elemento <userinput +>highlighting</userinput +>, che contiene l'elemento opzionale <userinput +>list</userinput +>, e gli elementi obbligatori <userinput +>contexts</userinput +> e <userinput +>itemDatas</userinput +>.</term> +<listitem> +<para +>Gli elementi <userinput +>list</userinput +> contengono un elenco di parole chiave. In questo caso le parole chiave sono <emphasis +>class</emphasis +> e <emphasis +>const</emphasis +>. Puoi aggiungerne tante quante ne servono.</para> +<para +>L'elemento <userinput +>contexts</userinput +> contiene tutti i contesti. Quindi il primo contesto è normalmente quello iniziale per l'evidenziazione. Ci sono due regole nel contesto <emphasis +>Normal Text</emphasis +>, che corrisponde all'elenco di parole chiave con il nome <emphasis +>unnome</emphasis +> ed una regola che identifica le virgolette e cambia il contesto a <emphasis +>string</emphasis +>. Per approfondire la conoscenza delle regole vedi il prossimo capitolo.</para> +<para +>La terza parte è l'elemento <userinput +>itemDatas</userinput +>. Contiene tutti gli stili di colore e di tipo di carattere necessari al contesto e alle regole. In questo esempio, gli <userinput +>itemData</userinput +> <emphasis +>Normal Text</emphasis +>, <emphasis +>String</emphasis +> e <emphasis +>Keyword</emphasis +> sono usati. </para> +<programlisting +><highlighting> + <list name="somename"> + <item> class </item> + <item> const </item> + </list> + <contexts> + <context attribute="Normal Text" lineEndContext="#pop" name="Normal Text" > + <keyword attribute="Keyword" context="#stay" String="somename" /> + <DetectChar attribute="String" context="string" char="&quot;" /> + </context> + <context attribute="String" lineEndContext="#stay" name="string" > + <DetectChar attribute="String" context="#pop" char="&quot;" /> + </context> + </contexts> + <itemDatas> + <itemData name="Normal Text" defStyleNum="dsNormal" /> + <itemData name="Keyword" defStyleNum="dsKeyword" /> + <itemData name="String" defStyleNum="dsString" /> + </itemDatas> + </highlighting> +</programlisting> +</listitem> +</varlistentry> + +<varlistentry> +<term +>L'ultima parte della definizione dell'evidenziazione è l'opzionale sezione <userinput +>general</userinput +>. Può contenere informazioni sulle parole chiave, sul raggruppamento del codice, sui commenti e sull'indentazione.</term> + +<listitem> +<para +>La sezione <userinput +>comment</userinput +> definisce quale sequenza di caratteri introduce un commento su riga singola. Puoi definire anche commenti su più righe usando <emphasis +>multiLine</emphasis +> con l'attributo aggiuntivo <emphasis +>end</emphasis +>. Questo è usato se l'utente attiva le azioni per <emphasis +>commentare/decommentare</emphasis +>.</para> +<para +>La sezione <userinput +>keywords</userinput +> definisce se le liste di parole chiave fanno distinzione fra le maiuscole e le minuscole o no. Altri attributi saranno spiegati successivamente.</para> +<programlisting +><general> + <comments> + <comment name="singleLine" start="#"/> + </comments> + <keywords casesensitive="1"/> + </general> +</language> +</programlisting> +</listitem> +</varlistentry> + +</variablelist> + + +</sect2> + +<sect2 id="kate-highlight-sections"> +<title +>Le sezioni nel dettaglio</title> +<para +>Questa parte descrive tutti gli attributi disponibili per i tag contexts, itemData, keywords, comment, per le pieghe del codice e per l'indentazione.</para> + +<variablelist> +<varlistentry> +<term +>L'elemento <userinput +>context</userinput +> appartiene al gruppo <userinput +>contexts</userinput +>. Un contesto definisce le regole specifiche di un contesto, come che cosa debba succedere se il sistema di evidenziazione raggiunge un fine riga. Gli attributi disponibili sono:</term> + + +<listitem> +<para +><userinput +>name</userinput +> specifica il nome del contesto. Le regole useranno questo nome per specificare il contesto da usare se la regola corrisponde.</para> +<para +><userinput +>lineEndContext</userinput +> definisce il contesto che verrà usato dal sistema di evidenziazione quando raggiunge la fine di una riga. Ciò può essere il nome di un altro contesto, o <userinput +>#stay</userinput +> per non cambiare contesto (cioè non far niente) o <userinput +>#pop</userinput +> che causa l'uscita dal contesto attuale. È possibile usare per esempio <userinput +>#pop#pop#pop</userinput +> per risalire di tre livelli.</para> +<para +><userinput +>lineBeginContext</userinput +> definisce il contesto se l'inizio di una riga è incontrato. Valore predefinito: #stay.</para> +<para +><userinput +>falltrough</userinput +> definisce se il sistema di evidenziazione commuta sul contesto specificato in fallthroughContext in caso di nessuna corrispondenza con una regola. Valore predefinito: <emphasis +>false</emphasis +>.</para> +<para +><userinput +>fallthroughContext</userinput +> specifica il contesto successivo se nessuna regola corrisponde.</para> +<para +><userinput +>dynamic</userinput +> se vale <emphasis +>true</emphasis +> fa in modo che il contesto ricordi le stringhe/segnaposto salvati dalle regole dinamiche. Ciò è necessario per i documenti HERE, ad esempio. Valore predefinito: <emphasis +>false</emphasis +>.</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>L'elemento <userinput +>itemData</userinput +> è nel gruppo <userinput +>itemDatas</userinput +>. Definisce lo stile dei caratteri ed i colori. Quindi puoi definire stili e colori come preferisci, ma è buona norma usare gli stili predefiniti se possibile, in modo da usare gli stessi colori in linguaggi diversi. Però a volte non c'è altro modo ed è necessario cambiare gli attributi di colore e tipo di carattere. Gli attributi name e defStyleNum sono obbligatori, gli altri facoltativi. Gli attributi disponibili sono:</term> + +<listitem> +<para +><userinput +>name</userinput +> fornisce il nome dell'itemData. I contesti e le regole useranno tale nome nell'attributo <emphasis +>attribute</emphasis +> per riferirsi ad un itemData.</para> +<para +><userinput +>defStyleNum</userinput +> definisce quale stile predefinito usare. Gli stili predefiniti sono spiegati nel dettaglio più avanti.</para> +<para +><userinput +>color</userinput +> definisce un colore. I formati validi sono "#rrvvbb" o "#rvb".</para> +<para +><userinput +>selColor</userinput +> definisce il colore della selezione.</para> +<para +><userinput +>italic</userinput +> se vale <emphasis +>true</emphasis +>, il testo sarà in corsivo.</para> +<para +><userinput +>bold</userinput +> se è <emphasis +>true</emphasis +>, il testo sarà in grassetto.</para> +<para +><userinput +>underline</userinput +> se è <emphasis +>true</emphasis +>, il testo sarà sottolineato.</para> +<para +><userinput +>strikeout</userinput +> se è <emphasis +>true</emphasis +>, il testo sarà barrato.</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>L'elemento <userinput +>keywords</userinput +> nel gruppo <userinput +>general</userinput +> definisce le proprietà delle parole chiave. Gli attributi disponibili sono:</term> + +<listitem> +<para +><userinput +>casesensitive</userinput +> può esser <emphasis +>true</emphasis +> o <emphasis +>false</emphasis +>. Se è <emphasis +>true</emphasis +> tutte le parole chiave verranno confrontate facendo distinzione tra maiuscole e minuscole.</para> +<para +><userinput +>weakDeliminator</userinput +> è un elenco di caratteri che non si comportano come delimitatori di parole. Ad esempio il punto <userinput +>"."</userinput +> è un delimitatore di parola. Assumendo che una parola chiave contenga un punto, potrà corrispondere al testo solo se il punto viene definito come delimitatore debole.</para> +<para +><userinput +>additionalDeliminator</userinput +> definisce delimitatori aggiuntivi.</para> +<para +><userinput +>wordWrapDeliminator</userinput +> definisce i caratteri dopo i quali è ammissibile un a capo automatico.</para> +<para +>I delimitatori predefiniti ed i delimitatori di confine parola sono i caratteri <userinput +>.():!+,-<=>%&*/;?[]^{|}~\</userinput +>, spazio (<userinput +>' '</userinput +>) e tabulazione (<userinput +>'\t'</userinput +>).</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>L'elemento <userinput +>comment</userinput +> del gruppo <userinput +>comments</userinput +> definisce le proprietà dei commenti che sono usate per <menuchoice +><guimenu +>Strumenti</guimenu +><guimenuitem +>Commenta</guimenuitem +></menuchoice +> e <menuchoice +><guimenu +>Strumenti</guimenu +><guimenuitem +>Decommenta</guimenuitem +></menuchoice +>. Gli attributi disponibili sono:</term> + +<listitem> +<para +><userinput +>name</userinput +> è o <emphasis +>singleLine</emphasis +> o <emphasis +>multiLine</emphasis +>. Se scegli <emphasis +>multiLine</emphasis +> gli attributi <emphasis +>end</emphasis +> e <emphasis +>region</emphasis +> sono obbligatori.</para> +<para +><userinput +>start</userinput +> definisce la stringa usata per iniziare un commento. In C++ questa sarebbe "/*".</para> +<para +><userinput +>end</userinput +> definisce la stringa usata per chiudere un commento. In C++ essa sarebbe "*/".</para> +<para +><userinput +>region</userinput +> deve essere il nome del commento su più righe raggruppabile. Poniamo che tu abbia <userinput +>beginRegion="Comment"</userinput +> ... <emphasis +>endRegion="Comment"</emphasis +> fra le regole; in questo caso devi usare <emphasis +>region="Comment"</emphasis +>. Così decommentare è possibile anche senza selezionare tutto il testo del commento su più righe. Basta che il cursore sia all'interno del commento.</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>L'elemento <userinput +>folding</userinput +> del gruppo <userinput +>general</userinput +> definisce le proprietà del raggruppamento. Gli attributi disponibili sono:</term> + +<listitem> +<para +><userinput +>indentationsensitive</userinput +> se <emphasis +>true</emphasis +>, gli indicatori di raggruppamento del codice saranno aggiunti in base all'indentazione, come per il linguaggio per gli script Python. Di solito non è necessaria una dichiarazione esplicita, perché in assenza di dichiarazione, viene considerato <emphasis +>false</emphasis +>.</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>L'elemento <userinput +>indentation</userinput +> del gruppo <userinput +>general</userinput +> definisce quale algoritmo di indentazione verrà usato, ma si raccomanda fortemente di omettere questo elemento, perché l'indentatore verrà normalmente scelto o con la definizione di un tipo di file o con l'aggiunta di una variabile del documento nel file di testo. Se specifichi un indentatore invece, obbligherai l'utente ad usare un sistema di indentazione particolare, che potrebbe non gradire. Gli attributi disponibili sono:</term> + +<listitem> +<para +><userinput +>mode</userinput +> è il nome dell'indentatore. Gli indentatori disponibili attualmente sono: <emphasis +>normal, cstyle, csands, xml, python</emphasis +> e <emphasis +>varindent</emphasis +>.</para> +</listitem> +</varlistentry> + + +</variablelist> + + +</sect2> + +<sect2 id="kate-highlight-default-styles"> +<title +>Stili predefiniti disponibili</title> +<para +>Gli stili predefiniti sono stati <link linkend="kate-highlight-system-default-styles" +>già spiegati</link +>, ma riassumendo: gli stili predefiniti sono gli stili di colorazione e dei tipi di carattere.</para> +<variablelist> +<varlistentry> +<term +>Ecco quindi un elenco degli stili predefiniti disponibili:</term> +<listitem> +<para +><userinput +>dsNormal</userinput +>, usato per il testo normale.</para> +<para +><userinput +>dsKeyword</userinput +>, usato per le parole chiave.</para> +<para +><userinput +>dsDataType</userinput +>, usato per i tipi di dato.</para> +<para +><userinput +>dsDecVal</userinput +>, usato per i valori decimali.</para> +<para +><userinput +>dsBaseN</userinput +> usato per i valori con una base diversa da 10.</para> +<para +><userinput +>dsFloat</userinput +>, usato per i valori in virgola mobile.</para> +<para +><userinput +>dsChar</userinput +>, usato per i singoli caratteri.</para> +<para +><userinput +>dsString</userinput +>, usato per le stringhe.</para> +<para +><userinput +>dsComment</userinput +>, usato per i commenti.</para> +<para +><userinput +>dsOther</userinput +>, usato per "altre" cose.</para> +<para +><userinput +>dsAlert</userinput +>, usato per i messaggi di attenzione.</para> +<para +><userinput +>dsFunction</userinput +>, usato per le chiamate di funzione.</para> +<para +><userinput +>dsRegionMarker</userinput +>, usato per gli indicatori di regione.</para> +<para +><userinput +>dsError</userinput +>, usato per l'evidenziazione degli errori e per la sintassi sbagliata.</para> +</listitem> +</varlistentry> +</variablelist> + +</sect2> + +</sect1> + +<sect1 id="kate-highlight-rules-detailled"> +<title +>Regole per la determinazione dell'evidenziazione</title> + +<para +>Questa sezione descrive le regole per la determinazione dell'evidenziazione.</para> + +<para +>Ogni regola può corrispondere a zero o più caratteri all'inizio della stringa con cui sono confrontati. Se la regola corrisponde, ai caratteri corrispondenti è assegnato lo stile o l'<emphasis +>attributo</emphasis +> definito dalla regola, ed una regola può chiedere di cambiare il contesto attuale. </para> + +<para +>Una regola ha questo aspetto:</para> + +<programlisting +><RuleName attribute="(identificatore)" context="(identificatore)" [attributi specifici della regola] /></programlisting> + +<para +><emphasis +>attribute</emphasis +> identifica per nome lo stile da usare per i caratteri corrispondenti alla regola, e <emphasis +>context</emphasis +> identifica il contesto da usare da questo punto in poi.</para> + +<para +>Il <emphasis +>contesto</emphasis +> può essere identificato da:</para> + +<itemizedlist> +<listitem> +<para +>Un <emphasis +>identificatore</emphasis +>, che è il nome di un altro contesto.</para> +</listitem> +<listitem> +<para +>Un <emphasis +>ordine</emphasis +> che indica al motore di stare nel contesto attuale (<emphasis +>#stay</emphasis +>) o di tornare ad un contesto precedentemente usato nella stringa (<userinput +>#pop</userinput +>).</para> +<para +>Per tornare indietro di più di un passo, la parola chiave #pop può essere ripetuta: <userinput +>#pop#pop#pop</userinput +></para> +</listitem> +</itemizedlist> + +<para +>Alcune regole possono avere <emphasis +>regole figlie</emphasis +> che sono valutate solo se la regola madre corrisponde. All'intera stringa corrispondente sarà dato l'attributo della regola madre. Una regola con delle regole figlie ha questo aspetto:</para> + +<programlisting +><RuleName (attributes)> + <ChildRuleName (attributes) /> + ... +</RuleName> +</programlisting> + + +<para +>Gli attributi specifici di ogni regola variano e sono descritti nelle sezioni seguenti.</para> + + +<itemizedlist> +<title +>Attributi comuni</title> +<para +>Tutte le regole hanno i seguenti attributi in comune che sono disponibili ogni volta che appare <userinput +>attributi comuni)</userinput +>. <emphasis +>attribute</emphasis +> e <emphasis +>context</emphasis +> sono attributi obbligatori, gli altri sono facoltativi. </para> + +<listitem> +<para +><emphasis +>attribute</emphasis +>: un attributo si applica ad un <emphasis +>itemData</emphasis +> definito.</para> +</listitem> +<listitem> +<para +><emphasis +>context</emphasis +>: Specifica il contesto da usare nel caso in cui la regola corrisponda.</para> +</listitem> +<listitem> +<para +><emphasis +>beginRegion</emphasis +>: inizia un blocco di ripiegamento del codice. Valore predefinito: non impostato.</para> +</listitem> +<listitem> +<para +><emphasis +>endRegion</emphasis +>: chiude un blocco di ripiegamento del codice. Valore predefinito: non impostato.</para> +</listitem> +<listitem> +<para +><emphasis +>lookAhead</emphasis +> Se vale <emphasis +>true</emphasis +> il sistema di evidenziazione non processa la lunghezza combaciante. Valore predefinito: <emphasis +>false</emphasis +>.</para> +</listitem> +<listitem> +<para +><emphasis +>firstNonSpace</emphasis +>: corrisponde solo se la stringa è composta dai primi caratteri non bianchi di una riga. Valore predefinito: <emphasis +>false</emphasis +>.</para> +</listitem> +<listitem> +<para +><emphasis +>column</emphasis +>: Corrisponde solo se la colonna corrisponde. Valore predefinito: non impostato.</para> +</listitem> +</itemizedlist> + +<itemizedlist> +<title +>Regole dinamiche</title> +<para +>Alcune regole permettono l'uso dell'attributo <userinput +>dynamic</userinput +> di tipo booleano, con valore predefinito <emphasis +>false</emphasis +>. Se dynamic è <emphasis +>true</emphasis +>, una regola può usare segnaposto rappresentanti il testo corrispondente da una regola <emphasis +>espressione regolare</emphasis +> che cambia il contesto attuale nel suo attributo <userinput +>string</userinput +> o <userinput +>char</userinput +>. Se si usa <userinput +>string</userinput +>, il segnaposto <replaceable +>%N</replaceable +> (dove N è un numero) sarà sostituito con la corrispondente cattura <replaceable +>N</replaceable +> dell'espressione regolare. In un <userinput +>char</userinput +> il segnaposto deve essere un numero <replaceable +>N</replaceable +> e sarà sostituito con il primo carattere della corrispondente cattura <replaceable +>N</replaceable +> dell'espressione regolare chiamante. Quando una regola permette questo attributo, conterrà nella sinossi la dicitura <emphasis +>(dynamic)</emphasis +>.</para> + +<listitem> +<para +><emphasis +>dynamic</emphasis +> può essere <emphasis +>(true|false)</emphasis +>.</para> +</listitem> +</itemizedlist> + +<sect2 id="highlighting-rules-in-detail"> +<title +>Le regole nel dettaglio</title> + +<variablelist> +<varlistentry> +<term +>DetectChar</term> +<listitem> +<para +>Identifica un singolo carattere specifico. Usata comunemente per trovare ad esempio la fine di una stringa virgolettata.</para> +<programlisting +><DetectChar char="(carattere)" (attributi comuni) (dynamic) /></programlisting> +<para +>L'attributo <userinput +>char</userinput +> definisce il carattere che deve corrispondere.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Detect2Chars</term> +<listitem> +<para +>Identifica due caratteri specifici in un ordine stabilito.</para> +<programlisting +><Detect2Chars char="(carattere)" char1="(carattere)" (attributi comuni) (dynamic) /></programlisting> +<para +>L'attributo <userinput +>char</userinput +> definisce il primo carattere che deve corrispondere, <userinput +>char1</userinput +> il secondo.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>AnyChar</term> +<listitem> +<para +>Identifica un carattere appartenente ad uno specifico insieme di caratteri.</para> +<programlisting +><AnyChar String="(stringa)" (attributi comuni) /></programlisting> +<para +>L'attributo <userinput +>String</userinput +> definisce l'insieme di caratteri.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>StringDetect</term> +<listitem> +<para +>Identifica una stringa esattamente corrispondente.</para> +<programlisting +><StringDetect String="(stringa)" [insensitive="true|false"] (attributi comuni) (dynamic) /></programlisting> +<para +>L'attributo <userinput +>String</userinput +> definisce la stringa da confrontare. L'attributo <userinput +>insensitive</userinput +> vale false, se omesso, ed è passato alla funzione per la comparazione delle stringhe. Se il suo valore è <emphasis +>true</emphasis +>, verrà usata una comparazione senza distinzione fra maiuscole e maiuscole.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>RegExpr</term> +<listitem> +<para +>Corrispondenza con un'espressione regolare.</para> +<programlisting +><RegExpr String="(stringa)" [insensitive="true|false"] [minimal="true|false"] (attributi comuni) (dynamic) /></programlisting> +<para +>L'attributo <userinput +>String</userinput +> definisce l'espressione regolare.</para> +<para +><userinput +>insensitive</userinput +> vale <emphasis +>false</emphasis +> normalmente,ed è passato al motore delle espressioni regolari.</para> +<para +><userinput +>minimal</userinput +> vale <emphasis +>false</emphasis +> normalmente,ed è passato al motore delle espressioni regolari.</para> +<para +>Poiché le regole sono confrontate sempre con l'inizio della stringa corrente, un'espressione regolare che inizi con un carattere di accento circonflesso (<literal +>^</literal +>) indica che la regola debba combaciare solo all'inizio di una riga.</para> +<para +>Vedi la <link linkend="regular-expressions" +>sezione sulle espressioni regolari</link +> per maggiori informazioni a riguardo.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>keyword</term> +<listitem> +<para +>Rivela una parola chiave da un elenco specificato.</para> +<programlisting +><keyword String="(nome lista)" (attributi comuni) /></programlisting> +<para +>L'attributo <userinput +>String</userinput +> identifica la lista di parole chiave per nome. Deve essere presente una lista con tale nome.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Int</term> +<listitem> +<para +>Rivela un numero intero.</para> +<para +><programlisting +><Int (attributi comuni) (dynamic) /></programlisting +></para> +<para +>Questa regola non ha attributi specifici. Le regole figlie di solito si usano per trovare combinazioni di <userinput +>L</userinput +> e <userinput +>U</userinput +> dopo un numero, per indicare il tipo di intero nel codice di un programma. In effetti tutte le regole sono ammesse come regole figlie, anche se il <acronym +>DTD</acronym +> permette solo la regola figlia <userinput +>StringDetect</userinput +>.</para> +<para +>L'esempio seguente corrisponde ai numeri interi seguiti dal carattere "L". <programlisting +><Int attribute="Decimal" context="#stay" > + <StringDetect attribute="Decimal" context="#stay" String="L" insensitive="true"/> +</Int> +</programlisting +></para> + +</listitem> +</varlistentry> + +<varlistentry> +<term +>Float</term> +<listitem> +<para +>Rivela un numero in virgola mobile.</para> +<para +><programlisting +><Float (attributi comuni) /></programlisting +></para> +<para +>Questa regola non ha attributi specifici. <userinput +>AnyChar</userinput +> è ammesso come regola figlia ed è tipicamente usata per identificare le combinazioni, vedi la regola <userinput +>Int</userinput +> come riferimento.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>HlCOct</term> +<listitem> +<para +>Rivela la rappresentazione ottale di un numero.</para> +<para +><programlisting +><HlCOct (attributi comuni) /></programlisting +></para> +<para +>Questa regola non ha attributi specifici.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>HlCHex</term> +<listitem> +<para +>Rivela la rappresentazione esadecimale di un numero.</para> +<para +><programlisting +><HlCHex (attributi comuni) /></programlisting +></para> +<para +>Questa regola non ha attributi specifici.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>HlCStringChar</term> +<listitem> +<para +>Rivela una sequenza di escape.</para> +<para +><programlisting +><HlCStringChar (attributi comuni) /></programlisting +></para> +<para +>Questa regola non ha attributi specifici.</para> + +<para +>Corrisponde a rappresentazioni letterali di caratteri comunemente usati nel codice dei programmi, come ad esempio <userinput +>\n</userinput +> (nuova riga) o <userinput +>\t</userinput +> (TAB).</para> + +<para +>Corrisponde ai seguenti caratteri se seguono una barra inversa (<literal +>\</literal +>): <userinput +>abefnrtv"'?\</userinput +>. In più, corrisponde alle sequenze di escape con i numeri esadecimali come <userinput +>\xff</userinput +> e con i numeri ottali, come <userinput +>\033</userinput +>.</para> + +</listitem> +</varlistentry> + +<varlistentry> +<term +>HlCChar</term> +<listitem> +<para +>Rivela un carattere C.</para> +<para +><programlisting +><HlCChar (attributi comuni) /></programlisting +></para> +<para +>Questa regola non ha attributi specifici.</para> + +<para +>Corrisponde ai caratteri C racchiusi fra apici singoli (Esempio: <userinput +>'c'</userinput +>). Quindi fra gli apici può trovarsi un carattere semplice o un carattere preceduto da un carattere di escape. Vedi HlCStringChar per sapere quali sequenze di escape siano contemplate.</para> + +</listitem> +</varlistentry> + +<varlistentry> +<term +>RangeDetect</term> +<listitem> +<para +>Identifica una stringa con dei caratteri di inizio e fine definiti.</para> +<programlisting +><RangeDetect char="(carattere)" char1="(carattere)" (attributi comuni) /></programlisting> +<para +><userinput +>char</userinput +> definisce il carattere che inizia la sequenza, <userinput +>char1</userinput +> il carattere che termina la sequenza.</para> +<para +>È utile per trovare ad esempio brevi stringhe racchiuse fra virgolette o simili, ma nota che poiché il motore di evidenziazione funziona ad una riga per volta, questa regola non può trovare stringhe che continuano su più di una riga.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>LineContinue</term> +<listitem> +<para +>Corrisponde alla fine di una riga.</para> +<programlisting +><LineContinue (attributi comuni) /></programlisting> +<para +>Questa regola non ha attributi specifici.</para> +<para +>Questa regola è utile per cambiare contesto alla fine di una riga, se l'ultimo carattere è una barra inversa (<userinput +>'\'</userinput +>). Ciò è necessario ad esempio in C/C++ per continuare le macro o le stringhe.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>IncludeRules</term> +<listitem> +<para +>Include regole di un altro contesto o di un altro linguaggio o file.</para> +<programlisting +><IncludeRules context="linkAContesto" [includeAttrib="true|false"] /></programlisting> + +<para +>L'attributo <userinput +>context</userinput +> definisce quale contesto includere.</para> +<para +>Se è una semplice stringa, include tutte le regole definite nel contesto attuale, ad esempio: <programlisting +><IncludeRules context="unAltroContesto" /></programlisting +></para> + +<para +>Se la stringa comincia con <userinput +>##</userinput +> il sistema di evidenziazione cercherà un'altra definizione di linguaggio con il nome dato, ad esempio: <programlisting +><IncludeRules context="##C++" /></programlisting +></para> +<para +>Se l'attributo <userinput +>includeAttrib</userinput +> è <emphasis +>true</emphasis +>, cambia l'attributo di destinazione a quello del sorgente. Ciò è necessario, ad esempio, per far funzionare i commenti, se il testo a cui corrisponde il contesto incluso è di evidenziazione diversa da quello del contesto ospite. </para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>DetectSpaces</term> +<listitem> +<para +>Rileva gli spazi bianchi.</para> +<programlisting +><DetectSpaces (attributi comuni) /></programlisting> + +<para +>Questa regola non ha attributi specifici.</para> +<para +>Usa questa regola se sai che si possono incontrare molti spazi bianchi, ad esempio all'inizio di righe indentate. La regola salta tutti gli spazi in una volta, invece di provare più regole e saltarne uno per volta per mancanza di corrispondenza.</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>DetectIdentifier</term> +<listitem> +<para +>Rivela le stringhe degli identificatori (come espressione regolare: [a-zA-Z_][a-zA-Z0-9_]*).</para> +<programlisting +><DetectIdentifier (attributi comuni) /></programlisting> + +<para +>Questa regola non ha attributi specifici.</para> +<para +>Usa questa regola per saltare una stringa di caratteri di parola in una volta, invece di provare più regole per saltare un carattere per volta per mancanza di corrispondenza.</para> +</listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2> +<title +>Suggerimenti e trucchi</title> + +<itemizedlist> +<para +>Quando avrai capito come funziona il cambio di contesto sarà facile scrivere le tue definizioni. Però devi stare attento a quali regole scegli in quale situazione. Le espressioni regolari sono potenti, ma sono lente in confronto alle altre regole. Quindi ti conviene seguire i seguenti consigli. </para> + +<listitem> +<para +>Se devi confrontare solo due caratteri, usa <userinput +>Detect2Chars</userinput +> invece di <userinput +>StringDetect</userinput +>. Lo stesso si applica a <userinput +>DetectChar</userinput +>.</para> +</listitem> +<listitem> +<para +>Le espressioni regolari sono comode ma spesso c'è un modo molto più veloce per ottenere lo stesso risultato. Considera di volere una corrispondenza co il carattere <userinput +>'#'</userinput +> se è il primo carattere di una riga. Una soluzione basata sulle espressioni regolari avrà questo aspetto: <programlisting +><RegExpr attribute="Macro" context="macro" String="^\s*#" /></programlisting +> Puoi ottenere lo stesso effetto molto più rapidamente usando: <programlisting +><DetectChar attribute="Macro" context="macro" char="#" firstNonSpace="true" /></programlisting +> Se vuoi una corrispondenza con l'espressione regolare<userinput +>'^#'</userinput +> puoi comunque usare <userinput +>DetectChar</userinput +> con l'attributo <userinput +>column="0"</userinput +>. L'attributo <userinput +>column</userinput +> conta le colonne in base ai caratteri, quindi un tabulatore è ancora un solo carattere. </para> +</listitem> +<listitem> +<para +>Puoi cambiare contesto senza processare caratteri. Poniamo che tu voglia cambiare contesto quando incontri la stringa <userinput +>*/</userinput +>, ma che debba processare la stringa nel prossimo contesto. La regola seguente corrisponderà, e l'attributo <userinput +>lookAhead</userinput +> farà mantenere all'evidenziatore la stringa corrispondente per il prossimo contesto. <programlisting +><Detect2Chars attribute="Comment" context="#pop" char="*" char1="/" lookAhead="true" /></programlisting> +</para> +</listitem> +<listitem> +<para +>Usa <userinput +>DetectSpaces</userinput +> se sai che capitano molti spazi bianchi.</para> +</listitem> +<listitem> +<para +>Usa <userinput +>DetectIdentifier</userinput +> invece dell'espressione regolare <userinput +>'[a-zA-Z_]\w*'</userinput +>.</para> +</listitem> +<listitem> +<para +>Usa gli stili predefiniti ogni volta che puoi. In questo modo l'utente si troverà in un ambiente familiare.</para> +</listitem> +<listitem> +<para +>Esamina gli altri file XML per vedere come altri hanno implementato regole complesse.</para> +</listitem> +<listitem> +<para +>Puoi convalidare tutti i file XML usando il comando <command +>xmllint --dtdvalid language.dtd miaSintassi.xml</command +>.</para> +</listitem> +<listitem> +<para +>Se usi più volte delle espressioni regolari complesse, puoi usare le <emphasis +>ENTITÀ</emphasis +>. Esempio:</para> +<programlisting +><?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE language SYSTEM "language.dtd" +[ + <!ENTITY myref "[A-Za-z_:][\w.:_-]*"> +]> +</programlisting> +<para +>Ora puoi usare <emphasis +>&myref;</emphasis +> invece dell'espressione regolare.</para> +</listitem> +</itemizedlist> +</sect2> + +</sect1> + +</appendix> diff --git a/tde-i18n-it/docs/tdebase/kate/index.cache.bz2 b/tde-i18n-it/docs/tdebase/kate/index.cache.bz2 Binary files differnew file mode 100644 index 00000000000..3f7a5dcdbf6 --- /dev/null +++ b/tde-i18n-it/docs/tdebase/kate/index.cache.bz2 diff --git a/tde-i18n-it/docs/tdebase/kate/index.docbook b/tde-i18n-it/docs/tdebase/kate/index.docbook new file mode 100644 index 00000000000..686e24f3548 --- /dev/null +++ b/tde-i18n-it/docs/tdebase/kate/index.docbook @@ -0,0 +1,496 @@ +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" +"dtd/kdex.dtd" [ + <!ENTITY kappname "&kate;"> + <!ENTITY package "tdebase"> + <!ENTITY configuring-chapter SYSTEM "configuring.docbook"> + <!ENTITY highlighting-appendix SYSTEM "highlighting.docbook"> + <!ENTITY advanced-chapter SYSTEM "advanced.docbook"> + <!ENTITY fundamentals-chapter SYSTEM "fundamentals.docbook"> + <!ENTITY mdi-chapter SYSTEM "mdi.docbook"> + <!ENTITY menu-chapter SYSTEM "menus.docbook"> + <!ENTITY part-chapter SYSTEM "part.docbook"> + <!ENTITY plugins-chapter SYSTEM "plugins.docbook"> + <!ENTITY regexp-appendix SYSTEM "regular-expressions.docbook"> + <!ENTITY % addindex "IGNORE"> + <!ENTITY % Italian "INCLUDE" +><!-- change language only here --> +]> + +<book lang="&language;"> +<title +>Manuale di &kate;</title> + +<bookinfo> +<authorgroup> +<author +>&Anders.Lund; &Anders.Lund.mail;</author> +<author +>&Seth.Rothberg; &Seth.Rothberg.mail;</author> +<author +>&Dominik.Haumann; &Dominik.Haumann.mail;</author> +<othercredit role="translator" +><firstname +>Nicola</firstname +> <surname +>Ruggero</surname +> <affiliation +><address +><email +>nicola@nxnt.org</email +></address +></affiliation +><contrib +>Traduzione della documentazione.</contrib +></othercredit +><othercredit role="translator" +><firstname +>Luciano</firstname +> <surname +>Montanaro</surname +> <affiliation +><address +><email +>mikelima@cirulla.net</email +></address +></affiliation +><contrib +>Traduzione della documentazione.</contrib +></othercredit +><othercredit role="translator" +><firstname +>Luigi</firstname +> <surname +>Toscano</surname +> <affiliation +><address +><email +>luigi.toscano@tiscali.it</email +></address +></affiliation +><contrib +>Traduzione della documentazione.</contrib +></othercredit +> +</authorgroup> + +<copyright> +<year +>2000</year> +<year +>2001</year> +<holder +>&Seth.Rothberg;</holder> +</copyright> +<copyright> +<year +>2002</year +><year +>2003</year +><year +>2005</year> +<holder +>&Anders.Lund;</holder> +</copyright> +<copyright> +<year +>2005</year> +<holder +>&Dominik.Haumann;</holder> +</copyright> + +<legalnotice +>&FDLNotice;</legalnotice> + +<date +>2005-12-29</date> +<releaseinfo +>2.5.0</releaseinfo> + +<abstract> +<para +>&kate; è un editor avanzato di testi per &kde; 2.2 e superiore.</para> + +<para +>Questo manuale si riferisce alla versione 2.5.0 di &kate;</para> +</abstract> + +<keywordset> +<keyword +>KDE</keyword> +<keyword +>tdebase</keyword> +<keyword +>Kate</keyword> +<keyword +>testo</keyword> +<keyword +>editor</keyword> +<keyword +>programmatore</keyword> +<keyword +>programmazione</keyword> +<keyword +>progetti</keyword> +<keyword +>MDI</keyword> +<keyword +>Multi</keyword> +<keyword +>Document</keyword> +<keyword +>Interface</keyword> +<keyword +>terminale</keyword> +<keyword +>console</keyword> +</keywordset> + +</bookinfo> + +<chapter id="introduction"> +<title +>Introduzione</title> + +<para +>Benvenuto in &kate;, un editor avanzato di testi per &kde; versione 2.2 e superiore. Alcune delle caratteristiche di &kate; comprendono: la capacità di configurare la evidenziazione della sintassi per linguaggi che vanno dal C e C++ all'<acronym +>HTML</acronym +> e agli script di bash, la possibilità di creare e gestire progetti, possedere una interfaccia <acronym +>MDI</acronym +> (multiple document interface) e un terminale della console integrato. </para> + +<para +>Ma &kate; è molto di più di editor avanzato di testi. La sua capacità di aprire diversi file contemporaneamente è ideale per modificare molti file di configurazione di &UNIX;. Questa documentazione, per esempio, è stata scritta con &kate;! </para> + +<para> +<mediaobject> +<imageobject +><imagedata format="PNG" fileref="kate.png"/></imageobject> +<caption +><para +>Scrittura di questo manuale...</para +></caption> +</mediaobject> +</para> + +</chapter> + +&fundamentals-chapter; + +&mdi-chapter; + +&part-chapter; + +&plugins-chapter; + +&advanced-chapter; + +&menu-chapter; + +&configuring-chapter; + +<chapter id="credits"> + +<title +>Riconoscimenti e licenza</title> + +<para +>&kate;. Copyright 2000, 2001, 2002 - 2005 - La squadra di sviluppo di &kate;. </para> + +<variablelist> +<title +>La squadra di &kate;:</title> +<varlistentry> +<term +>&Christoph.Cullmann; &Christoph.Cullmann.mail;</term> +<listitem +><para +>Responsabile progetto & sviluppatore principale</para +></listitem> +</varlistentry> +<varlistentry> +<term +>&Anders.Lund; &Anders.Lund.mail;</term> +<listitem +><para +>Sviluppatore principale, evidenziazione del linguaggio Perl, documentazione</para +></listitem> +</varlistentry> +<varlistentry> +<term +>&Joseph.Wenninger; &Joseph.Wenninger.mail;</term> +<listitem +><para +>Sviluppatore principale, Modalità di evidenziazione</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Michael Bartl <email +>michael.bartl1@chello.at</email +></term> +<listitem +><para +>Sviluppatore principale</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Phlip <email +>phlip_cpp@my-deja.com</email +></term> +<listitem +><para +>Compilatore del progetto</para +></listitem> +</varlistentry> +<varlistentry> +<term +>&Waldo.Bastian; &Waldo.Bastian.mail;</term> +<listitem +><para +>L'ingegnoso sistema di buffer</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Matt Newell <email +>newellm@proaxis.com</email +></term> +<listitem +><para +>Prove...</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Michael McCallum <email +>gholam@xtra.co.nz</email +></term> +<listitem +><para +>Sviluppatore principale</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Jochen Wilhemly <email +>digisnap@cs.tu-berlin.de</email +></term> +<listitem +><para +>Autori di KWrite</para +></listitem> +</varlistentry> +<varlistentry> +<term +>&Michael.Koch; &Michael.Koch.mail;</term> +<listitem +><para +>Port di KWrite su KParts</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Christian Gebauer <email +>gebauer@bigfoot.com</email +></term> +<listitem +><para +>Altro</para +></listitem> +</varlistentry> +<varlistentry> +<term +>&Simon.Hausmann; &Simon.Hausmann.mail;</term> +<listitem +><para +>Altro</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Glen Parker <email +>glenebob@nwlink.com</email +></term> +<listitem +><para +>Sistema di Annulla/Rifai con elenco azioni, integrazione con KSpell</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Scott Manson <email +>sdmanson@alltel.net</email +></term> +<listitem +><para +>Supporto per l'evidenziazione dei file XML in KWrite</para +></listitem> +</varlistentry> +<varlistentry> +<term +>&John.Firebaugh; &John.Firebaugh.mail;</term> +<listitem +><para +>Varie patch</para +></listitem> +</varlistentry> +<varlistentry> +<term +>&Dominik.Haumann; &Dominik.Haumann.mail;</term> +<listitem +><para +>Sviluppatore, procedura guidata evidenziazione</para +></listitem> +</varlistentry> +</variablelist> + +<variablelist> +<title +>Molta altra gente che ha contribuito:</title> +<varlistentry> +<term +>Matteo Merli <email +>merlim@libero.it</email +></term> +<listitem +><para +>Evidenziazione dei file RPM Spec, Diff e altro</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Rocky Scaletta <email +>rocky@purdue.edu</email +></term> +<listitem +><para +>Evidenziazione dei file VHDL</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Yury Lebedev </term> +<listitem +><para +>Evidenziazione dei file SQL</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Chris Ross</term> +<listitem +><para +>Evidenziazione dei file Ferite</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Nick Roux</term> +<listitem +><para +>Evidenziazione dei file ILERPG</para +></listitem> +</varlistentry> +<varlistentry> +<term +>John Firebaugh</term> +<listitem +><para +>Evidenziazione del Java e molto di più</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Carsten Niehaus</term> +<listitem +><para +>Evidenziazione per i file LaTeX</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Per Wigren</term> +<listitem +><para +>Evidenziazione dei Makefiles e Python</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Jan Fritz</term> +<listitem +><para +>Evidenziazione del Python</para +></listitem> +</varlistentry> +<varlistentry> +<term +>&Daniel.Naber;</term> +<listitem +><para +>Piccole correzioni bug, plugin XML</para +></listitem> +</varlistentry> +</variablelist> + +<para +>Documentazione Copyright 2000,2001 &Seth.Rothberg; &Seth.Rothberg.mail;</para> + +<para +>Documentazione Copyright 2002, 2003, 2005 &Anders.Lund; &Anders.Lund.mail;</para> + +<para +>Documentazione tradotta da: Nicola Ruggero <email +>nicola@nxnt.org</email +></para +> +&underFDL; &underGPL; </chapter> + +&highlighting-appendix; + +®exp-appendix; + +<appendix id="installation"> +<title +>Installazione</title> + +&install.intro.documentation; + +&install.compile.documentation; + +</appendix> + +&documentation.index; + +<!-- +Index Word List: +menu - context - syntax - markup - shortcuts - highlighting +embedded terminal - editing - search - replace - regexp -> Regular Expression +split window - selection - insert overwrite - selection - +configure/customize/preferences - insert/overwrite - non-printing characters +font - unicode - wordwrap/linewrap - project - bookmarks - docks - plugins +block selection / rectangles - view - indenting - editor - word processor +copy - paste - find - spelling - language (both kinds) - encoding - +pretty printing - formatting - line numbers - icon border - +folding - insert time - sed + +done +comment / uncomment +configure / settings / preferences + +--> + +</book> + +<!-- +Local Variables: +mode: sgml +sgml-namecase-general: t +sgml-namecase-entity: nil +sgml-general-insert-case: lower +sgml-minimize-attributes: nil +sgml-omittag: nil +End: +--> diff --git a/tde-i18n-it/docs/tdebase/kate/man-kate.1.docbook b/tde-i18n-it/docs/tdebase/kate/man-kate.1.docbook new file mode 100644 index 00000000000..e9c3500301e --- /dev/null +++ b/tde-i18n-it/docs/tdebase/kate/man-kate.1.docbook @@ -0,0 +1,294 @@ +<?xml version="1.0" ?> +<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ +<!ENTITY % Italian "INCLUDE"> +]> + +<refentry lang="&language;"> +<refentryinfo> +<title +>Manuale utente di KDE</title> +<author +>&Lauri.Watts; &Lauri.Watts.mail;</author> +<date +>7 giugno 2005</date +> <productname +>Ambiente desktop K</productname +> </refentryinfo> + +<refmeta> +<refentrytitle +><command +>kate</command +></refentrytitle> +<manvolnum +>1</manvolnum> +</refmeta> + +<refnamediv> +<refname +><command +>kate</command +></refname> +<refpurpose +>Editor di testo avanzato per &kde;</refpurpose> +</refnamediv> + +<refsynopsisdiv> +<cmdsynopsis +><command +>kate</command +> <group choice="opt" +><option +>-s, --start</option +> <replaceable +> nome</replaceable +> </group +> <group choice="opt" +><option +>-u, --use</option +></group +> <group choice="opt" +><option +>-p, --pid</option +><replaceable +> pid</replaceable +></group +> <group choice="opt" +><option +>-e, --encoding</option +> <replaceable +> nome</replaceable +></group +> <group choice="opt" +><option +>-l, --line</option +> <replaceable +> riga</replaceable +></group +> <group choice="opt" +><option +>-c, --column</option +> <replaceable +> colonna</replaceable +></group +> <group choice="opt" +><option +>-i, --stdin</option +></group +> <arg choice="opt" +>Opzioni generiche di KDE</arg +> <arg choice="opt" +>Opzioni generiche di Qt</arg +> </cmdsynopsis> +</refsynopsisdiv> + +<refsect1> +<title +>Descrizione</title> +<para +>&kate; è l'editor di testo avanzato per &kde;. </para +> +<para +>&kate; fornisce anche il componente per la modifica del testo di varie applicazioni, con il nome di &kwrite;.</para> +<para +>Alcune delle molte funzioni di &kate; includono l'evidenziazione della sintassi configurabile per molti linguaggi da C e C++ a <acronym +>HTML</acronym +>, a script bash, all'abilità di creare e fare manutenzione su progetti, un'interfaccia basata su documenti multipli (<acronym +>MDI</acronym +>), ed un emulatore di terminale a sé stante. </para> + +<para +>Ma &kate; è molto più di un editor avanzato di testi. La sua capacità di aprire diversi file contemporaneamente è ideale per modificare i molti file di configurazione di &UNIX;. Questo documento, ad esempio, è stato scritto con &kate;! </para> + + +</refsect1> + +<refsect1> +<title +>Opzioni</title> + +<variablelist> +<varlistentry> +<term +><option +>-s</option +>, <option +>--start</option +> <replaceable +>nome</replaceable +></term> + +<listitem +><para +>Avvia &kate; con una sessione data.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><option +>-u, --use</option +></term> +<listitem +><para +>Usa un'istanza di &kate; già in esecuzione</para +></listitem> +</varlistentry> +<varlistentry> +<term +><option +>-p, --pid</option +> <replaceable +> pid</replaceable +></term> +<listitem +><para +>Prova a riutilizzare solo l'istanza di kate con questo <replaceable +>pid</replaceable +></para +></listitem> +</varlistentry> +<varlistentry> +<term +><option +>-e, --encoding</option +> <replaceable +> nome</replaceable +></term> +<listitem +><para +>Imposta la codifica per il file da aprire</para +><para +>Puoi usare questa opzione per costringere l'apertura di un file con la codifica utf-8, ad esempio (Il comando <command +>iconv -l</command +> fornisce un elenco delle codifiche che possono esserti utili).</para +></listitem> +</varlistentry> +<varlistentry> +<term +><option +>-l, --line</option +> <replaceable +> riga</replaceable +></term> +<listitem +><para +>Spostati a questa riga</para +></listitem> +</varlistentry> +<varlistentry> +<term +><option +> column</option +><replaceable +> colonna</replaceable +></term> +<listitem +><para +>Spostati a questa colonna</para +></listitem> +</varlistentry> +<varlistentry> +<term +><option +>-i, --stdin</option +></term> +<listitem +><para +>Leggi il contenuto di <filename +>stdin</filename +></para +></listitem> +</varlistentry> +</variablelist> + +</refsect1> + +<refsect1> +<title +>Vedi anche</title> + +<para +>kwrite(1)</para> + +<para +>Documentazione per l'utente più dettagliata è disponibile usando <ulink url="help:/kate" +>help:/kate</ulink +> (inserisci questo <acronym +>URL</acronym +> in &konqueror; o avvia <userinput +><command +>khelpcenter</command +> <parameter +>help:/kate</parameter +></userinput +>).</para> + +<para +>Ulteriori informazioni sono inoltre disponibili presso <ulink url="http://kate.kde.org/" +>il sito web di &kate;</ulink +>.</para> +</refsect1> + +<refsect1> +<title +>Esempi</title> + +<para +>Per aprire un file dal nome <filename +>sorgente.cpp</filename +> alla colonna 15 della riga 25 in una finestra esistente di &kate; potresti usare:</para> +<screen +><userinput +><command +>kate</command +> <option +>-c 15</option +> <option +>-l +25</option +> <option +>-u</option +> <filename +>sorgente.cpp</filename +></userinput +> </screen> + +<para +>Se hai una connessione internet attiva puoi sfruttare la trasparenza alla rete di &kde; per aprire un file da un sito FTP. Se non hai i permessi di scrittura sul server remoto, il file sarà aperto in modalità di sola lettura e ti verrà chiesto un nome per il file locale da usare per salvare le tue eventuali modifiche. Se hai i permessi di scrittura, le modifiche saranno salvate in modo trasparente sulla rete.</para> +<screen +><userinput +><command +>kate</command +> <option +><replaceable +>ftp://ftp.kde.org/pub/kde/README_FIRST</replaceable +></option +></userinput +></screen> + +<!-- FIXME: Some more useful examples would be cool, how about this snagged --> +<!-- from a mail of anders (slightly edited /line/l to remove the double --> +<!-- dashes: +> /some/file/path/file.name:lineno + +> it would rock if Kate could understand that and not only open up file.name, + +> but jump to lineno after the file is opened. + +How bad is it to have to convert that into +-l lineno /some/file/path/file.name + +sed s,([^:]*):(\d+),-l \2 \1, + +will do that, for example.--> + +</refsect1> + +<refsect1> +<title +>Autori</title> +<para +>Il responsabile di &kate; è &Christoph.Cullmann; &Christoph.Cullmann.mail;. Un elenco completo degli autori e dei collaboratori è disponibile nel manuale per l'utente completo summenzionato.</para> +</refsect1> + +</refentry> diff --git a/tde-i18n-it/docs/tdebase/kate/mdi.docbook b/tde-i18n-it/docs/tdebase/kate/mdi.docbook new file mode 100644 index 00000000000..2a708a0b3da --- /dev/null +++ b/tde-i18n-it/docs/tdebase/kate/mdi.docbook @@ -0,0 +1,366 @@ +<chapter id="kate-mdi"> +<chapterinfo> +<authorgroup> +<author +>&Anders.Lund; &Anders.Lund.mail;</author> +<othercredit role="translator" +><firstname +>Nicola</firstname +> <surname +>Ruggero</surname +> <affiliation +><address +><email +>nicola@nxnt.org</email +></address +></affiliation +><contrib +>Traduzione della documentazione.</contrib +></othercredit +> +</authorgroup> +</chapterinfo> +<title +>Lavorare con &kate; <acronym +>MDI</acronym +></title> + +<sect1 id="kate-mdi-overview"> +<title +>Panoramica</title> + +<para +>Finestra, Vista, Documento, Cornice, Editor... Che cosa sono tutti queste voci nella terminologia di &kate;, e come ottenerne il massimo? Questo capitolo spiegherà tutte queste cose e molto di più.</para> + +<sect2 id="kate-mdi-overview-mainwindow"> + +<title +>La finestra principale</title> + +<para +><indexterm +><primary +>Finestra principale</primary +></indexterm +> La finestra principale di &kate; è una finestra standard di &kde; con l'aggiunta di barre laterali contenenti viste degli strumenti. Possiede una barra dei menu con tutti i menu più comuni e qualcun altro, e infine una barra degli strumenti che fornisce l'accesso ai comandi usati più comunemente.</para> + +<para +>La parte più importante della finestra è l'area dell'editor che, per impostazione predefinita, visualizza un solo componente dell'editor di testo, nel quale puoi lavorare con i tuoi documenti.</para> + +<para +>La capacità di agganciarsi del pannello è usata per i pannelli degli strumenti:</para> + +<itemizedlist> +<listitem +><para +><link linkend="kate-mdi-tools-file-list" +>La lista dei file</link +></para +></listitem> +<listitem +><para +><link linkend="kate-mdi-tools-file-selector" +>Il selettore file</link +></para +></listitem> +<listitem +><para +><link linkend="kate-mdi-tools-konsole" +>Il Terminale integrato</link +></para +></listitem> +</itemizedlist> + +<para +>E forse altri pannelli di strumenti, per esempio forniti da un plugin.</para> + +<para +>Le viste degli strumenti possono essere posizionate in una barra laterale; per muovere uno strumento fai clic sul suo pulsante dalla barra e selezionalo dal menu &RMB;.</para> + +<para +>La vista di uno strumento può essere indicata come <emphasis +>persistente</emphasis +> dal menu del &RMB;. La barra laterale può contenere più strumenti per volta, in modo che quando uno strumento è persistente gli altri possono essere mostrati in contemporanea.</para> + +</sect2> + + +</sect1> + +<sect1 id="kate-mdi-editor"> + +<title +>L'Area dell'editor</title> + +<para +><indexterm +><primary +>Area dell'editor</primary +></indexterm +> &kate; ha la capacità di avere più di un documento aperto allo stesso tempo, e inoltre di dividere l'area dell'editor in qualsiasi numero di finestre, in maniera simile a &konqueror; o al popolare <application +>emacs</application +>. In questa maniera puoi vedere diversi documenti allo stesso tempo, o più istanze dello stesso documento, per esempio se il tuo documento contiene definizioni all'inizio e le vuoi vedere spesso per riferimento. Oppure puoi vedere l'header del sorgente di un programma in una finestra, mentre modifichi il file di implementazione in un'altra.</para> + +<para +>Quando un documento è disponibile in più di un editor, i cambiamenti effettuati su uno degli editor saranno immediatamente riflessi negli altri. Questo include la selezione e la modifica del testo. Le operazioni di ricerca o i movimenti del cursore si rifletteranno solo nell'editor corrente.</para> + +<para +>Attualmente non è possibile avere più istanze aperte dello stesso documento, nel senso che in una istanza compaiono le modifiche che si stanno facendo mentre nell'altra no.</para> + +<para +>Quando dividi l'editor in due finestre, è diviso in due finestre della stessa dimensione. Entrambe le finestre visualizzano il documento corrente su cui stai lavorando. La nuove finestra sarà in basso (nel caso in cui dividi orizzontalmente) o a destra (quando dividi verticalmente). La nuova finestra sarà resa attiva e si noterà da un piccolo led verde.</para> + +</sect1> + +<sect1 id="kate-mdi-tools-file-list"> +<title +>L'elenco dei documenti</title> + +<para +><indexterm +><primary +>Lista dei file</primary +></indexterm +> La lista dei file mostra una lista di tutti i documenti attualmente aperti in &kate;. Il file modificati avranno una piccola icona di un <guiicon +>Dischetto</guiicon +> a sinistra che indica il loro stato.</para> + +<para +>Se due o più file con lo stesso nome (situati in cartelle diverse) sono aperti, al nome del secondo e successivi verrà aggiunto un <quote +><2></quote +> e così via. Il suggerimento del file mostrerà il suo nome e percorso completo, permettendoti di scegliere quello che desideri.</para +> <para +>Per visualizzare un documento nella finestra attiva, fai clic sul nome del documento nella lista.</para> + +<para +>Puoi ordinare l'elenco in alcuni modi diversi facendo clic con il tasto destro e selezionando una voce dal menu <guisubmenu +>Ordina per</guisubmenu +>. Le opzioni sono: <variablelist> + +<varlistentry> +<term +><guimenuitem +>Ordine di apertura</guimenuitem +></term> +<listitem +><para +>Elenca i documenti nell'ordine di apertura</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guimenuitem +>Nome documento</guimenuitem +></term> +<listitem +><para +>Elenca i documenti alfabeticamente per nome.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guimenuitem +>URL</guimenuitem +></term> +<listitem +><para +>Elenca i documenti alfabeticamente per URL.</para +></listitem> +</varlistentry> + +</variablelist> + +</para> + +<para +>L'elenco dei documenti normalmente mostra la cronologia ombreggiando il colore di sfondo delle voci dei documenti più recenti. Se il documento viene modificato, vene miscelato un altro colore. I documenti più recenti hanno colori più vivi, quindi è facile trovare i document su cui stai lavorando. Questa funzione può essere disabilitata dalla <link linkend="config-dialog-documentlist" +>pagina Lista documenti</link +> del pannello di configurazione.</para> + +<para +>La posizione standard nella finestra di &kate; è a sinistra dell'area dell'editor.</para> +</sect1> + +<sect1 id="kate-mdi-tools-file-selector"> +<title +>Il selettore file</title> + +<para +><indexterm +><primary +>Selettore file</primary +></indexterm +> Il Selettore file è un visualizzatore delle cartelle che permette di aprire i file da una cartella aperta nella riquadro attuale.</para> + +<para +>Dall'alto al basso, il selettore file è composto dai seguenti elementi:</para> + +<variablelist> +<varlistentry> +<term +>Una barra degli strumenti</term> +<listitem> +<para +>Questa contiene pulsanti standard per la navigazione:</para> +<variablelist> +<varlistentry> +<term +><guibutton +>Home</guibutton +></term> +<listitem +><para +>Premendolo farai in modo che la visualizzazione della cartella si posizioni con un <command +>cd</command +> nella tua home directory.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guibutton +>Su</guibutton +></term> +<listitem +><para +>Questo fa in modo che la cartella si posizioni, con un <command +>cd</command +>, nella cartella di livello immediatamente superiore alla cartella visualizzata. Ovviamente se questo è possibile.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guibutton +>Indietro</guibutton +></term> +<listitem +><para +>Fa in modo che la vista della cartella si sposti, con un <command +>cd</command +>, alla precedente cartella visualizzata in ordine cronologico. Questo pulsante è disabilitato se non c'è un elemento precedente in cronologia.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guibutton +>Avanti</guibutton +></term> +<listitem +><para +>Provoca lo spostamento della vista cartella, tramite comando <command +>cd</command +>, alla cartella successiva nella cronologia. Questo pulsante è disattivato se non esiste una cartella successiva nella cronologia.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guibutton +>Sincronizza</guibutton +></term> +<listitem +><para +>Questo pulsante provoca lo spostamento della vista cartella, tramite comando <command +>cd</command +>, alla cartella che contiene il documento che è attualmente attivo (se possibile). Questo pulsante è disabilitato se il documento attivo è un nuovo file che non è ancora stato salvato oppure se la cartella in cui risiede non è individuabile.</para +></listitem> +</varlistentry> +</variablelist> + +</listitem> +</varlistentry> + +<varlistentry> +<term +>Il campo &URL;</term> +<listitem> +<para +>Qui puoi digitare il percorso di una cartella da sfogliare. Il campo &URL; mantiene una lista di tutti i percorsi precedentemente inseriti. Per sceglierne uno usa il pulsante con la freccia a destra del campo.</para> +<tip +><para +>Il campo &URL; ha il completamento automatico dei nomi delle cartelle. Il metodo di completamento può essere impostato utilizzando il menu &RMB; del campo di inserimento.</para +></tip> +</listitem> +</varlistentry> + +<varlistentry> +<term +>La Vista cartelle</term> +<listitem +><para +>Questa è una vista cartelle standard di &kde;.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Il campo Filtro</term> +<listitem> +<para +>Il campo Filtro ti permette di definire un filtro per i file visualizzati nella vista cartella. Il filtro usa pattern standard. Ognuno di essi deve essere separato da uno spazio vuoto. Esempio: <userinput +>*.cpp *.h *.moc</userinput +></para> +<para +>Per visualizzare tutti i file, inserisci un asterisco singolo <userinput +>*</userinput +>.</para> +<para +>Il campo filtro salva gli ultimi 10 filtri inseriti durante la sessione. Per usarne uno fai clic sul pulsante con la freccia a destra del campo di inserimento e seleziona il filtro che desideri.</para> +</listitem> +</varlistentry> + +</variablelist> + +</sect1> + + +<sect1 id="kate-mdi-tools-konsole"> +<title +>Il terminale integrato</title> + +<para +><indexterm +><primary +>Terminale integrato</primary +></indexterm +> Il terminale integrato è una copia della &konsole;: il terminale di &kde;, per tua comodità. È disponibile dal menu <menuchoice +><guimenu +>Impostazioni</guimenu +><guimenuitem +>Mostra terminale</guimenuitem +></menuchoice +> oppure premendo il tasto <keycombo action="simul" +><keycap +>F7</keycap +></keycombo +>. Appena viene visualizzato la sua finestra diviene attiva. Inoltre, se l'opzione <link linkend="config-dialog-general-sync-konsole" +>Sincronizza &konsole; con il documento attivo</link +> è abilitata, il terminale cambia directory per posizionarsi, se possibile, in quella del documento corrente; quando è visualizzato oppure quando il documento cambia.</para> + +<para +>La posizione standard nella finestra di &kate; è in basso, sotto l'area dell'editor.</para> + +<para +>Puoi configurare la &konsole; usando il suo menu &RMB;. Per ulteriori informazioni vedi il manuale di &konsole;.</para> + +</sect1> + +<sect1 id="kate-mdi-tools-externaltools"> +<title +>Strumenti esterni</title> + +<para +>Nel menu <guimenu +>Strumenti</guimenu +> troverai un sottomenu chiamato <guisubmenu +>Strumenti esterni</guisubmenu +>. Questi strumenti invocano applicazioni esterne con i dati relativi al documento attuale, ad esempio il suo URL, la sua directory o il testo selezionato.</para> + +<para +>Gli strumenti esterni sono definibili dall'utente; puoi aggiungerli, modificarli o rimuoverli usando il <link linkend="config-dialog-externaltools" +>pannello di configurazione Strumenti esterni</link +>. </para> + +</sect1> + +</chapter> diff --git a/tde-i18n-it/docs/tdebase/kate/menus.docbook b/tde-i18n-it/docs/tdebase/kate/menus.docbook new file mode 100644 index 00000000000..4d3aab7f698 --- /dev/null +++ b/tde-i18n-it/docs/tdebase/kate/menus.docbook @@ -0,0 +1,2224 @@ +<chapter id="menu-entries"> +<chapterinfo> +<authorgroup> +<author +><personname +><firstname +></firstname +></personname +></author> +<othercredit role="translator" +><firstname +>Luciano</firstname +><surname +>Montanaro</surname +><affiliation +><address +><email +>mikelima@cirulla.net</email +></address +></affiliation +><contrib +>Traduzione</contrib +></othercredit +> +</authorgroup> +</chapterinfo> +<title +>Voci del Menu</title> + +<sect1 id="file-menu"> +<title +>Il menu <guimenu +>File</guimenu +></title> + +<variablelist> +<varlistentry> +<term> +<anchor id="new"/> +<menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>N</keycap +></keycombo +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>Nuovo</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Questo comando <action +>crea un nuovo documento</action +> nella finestra di modifica. Nella lista <guibutton +>Documenti</guibutton +> sulla sinistra il nuovo file è indicato come <emphasis +>Senza titolo</emphasis +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="open"/> +<menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>O</keycap +></keycombo +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>Apri...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Apre la finestra di dialogo di apertura file di &kde; per permetterti di aprire uno o più file. </para> + +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="open-recent"/> +<menuchoice +><guimenu +>File</guimenu +> <guimenuitem +>Apri recenti</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Permette di <action +>aprire un file</action +> da un sottomenu contenente una lista di file modificati di recente. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="open-with"/> +<menuchoice +><guimenu +>File</guimenu +><guimenuitem +>Apri con</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Questo sottomenu presenta una lista di applicazioni in grado di gestire il tipo MIME del documento attuale. Attivando una voce verrà aperto il documento attuale con l'applicazione relativa.</para> +<para +>Inoltre, la voce <guimenuitem +>Altro...</guimenuitem +> apre una finestra di dialogo per <action +>selezionare un'altra applicazione per l'apertura del file attivo</action +>. Il file resterà aperto anche in &kate;. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="save"/> +<menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>S</keycap +></keycombo +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>Salva</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Questo comando <action +>salva il file</action +>. Usalo spesso. Se il file è <emphasis +>senza titolo</emphasis +>, allora <guimenuitem +>Salva</guimenuitem +> si comporta come <guimenuitem +>Salva con nome...</guimenuitem +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="save-as"/> +<menuchoice +><guimenu +>File</guimenu +> <guimenuitem +>Salva con nome...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +><action +>Dai un nome o rinomina i file</action +> con questo comando. Apre la finestra di salvataggio dei file. La finestra funziona in modo simile a quella di apertura dei file. Puoi usarla per muoverti all'interno del filesystem, per vedere l'anteprima di file esistenti o filtrare la vista con delle maschere. </para> + +<para +>Scrivi il nome che vuoi dare al file che stai per salvare nella casella combinata <guilabel +>Indirizzo</guilabel +> e premi il pulsante <guibutton +>OK</guibutton +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="save-all"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +> L</keycap +></keycombo +></shortcut +><guimenu +>File</guimenu +><guimenuitem +>Salva tutto</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Questo comando <action +>salva tutti i file aperti</action +> che sono stati modificati. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="reload"/> +<menuchoice +><shortcut +> <keycombo action="simul" +><keycap +>F5</keycap +></keycombo +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>Ricarica</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +><action +>Ricarica il file attivo</action +>. Questa azione è utile se un altro programma ha cambiato il file mentre lo hai aperto in &kate; </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="print"/> +<menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>P</keycap +></keycombo +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>Stampa...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +><action +>Stampa il file attivo</action +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term id="export-as-html"> +<menuchoice +><guimenu +>File</guimenu +> <guimenuitem +>Esporta come HTML...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Esporta il file nel formato HTML in modo che possa essere visualizzato come una pagina web. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term id="mail"> +<menuchoice +><guimenu +>File</guimenu +> <guimenuitem +>Spedisci...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Apre il client di posta elettronica ed allega il file al messaggio. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="close"/> +<menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>W</keycap +></keycombo +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>Chiudi</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Questa voce <action +>chiude il file attivo</action +>. Se hai fatto delle modifiche senza salvarle, ti verrà chiesto se salvare le modifiche prima che &kate; lo chiuda. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="close-all"/> +<menuchoice +><guimenu +>File</guimenu +> <guimenuitem +>Chiudi tutto</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Questo comando <action +>chiude tutti i file che hai aperto</action +> in &kate;. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="quit"/> +<menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>Q</keycap +></keycombo +> </shortcut +> <guimenu +>File</guimenu +> <guimenuitem +>Esci</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Questo comando <action +>chiude &kate;</action +> e tutti i file che stavi modificando. Se hai delle modifiche non salvate in uno o più file, ti verrà chiesto se vuoi salvarle. </para> +</listitem> +</varlistentry> +</variablelist> +</sect1> + +<sect1 id="edit-menu"> +<title +>Il menu <guimenu +>Modifica</guimenu +></title> +<para +>Il menu <guimenu +>Modifica</guimenu +> contiene un numero di azioni che operano tutte sul documento attualmente attivo.</para> + +<variablelist> +<title +>Voci del Menu</title> +<varlistentry> +<term> +<anchor id="edit-undo"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>Z</keycap +></keycombo +></shortcut +> <guimenu +>Modifica</guimenu +> <guimenuitem +>Annulla</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Annulla l'ultima azione di modifica (inserimento di testo, copia, taglio ecc.)</para> +<note +><para +>Se l'annullamento raggruppato è attivo, verranno annullati più comandi di modifica dello stesso tipo, come l'inserimento di caratteri.</para +></note> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-redo"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>Z</keycap +></keycombo +></shortcut +> <guimenu +>Modifica</guimenu +> <guimenuitem +>Rifai</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Rifa l'ultimo passo di annullamento.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-cut"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>X</keycap +></keycombo +></shortcut +> <guimenu +>Modifica</guimenu +> <guimenuitem +>Taglia</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Rimuove il testo selezionato, se c'è una selezione attiva, e ne mette una copia negli appunti di sistema.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-copy"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>C</keycap +></keycombo +></shortcut +> <guimenu +>Modifica</guimenu +> <guimenuitem +>Copia</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Copia il testo selezionato negli appunti.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-copy-as-html"/> +<menuchoice +><guimenu +>Modifica</guimenu +><guimenuitem +>Copia come HTML</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Copia il testo selezionato con l'evidenziazione della sintassi come testo HTML.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-paste"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>V</keycap +></keycombo +></shortcut +> <guimenu +>Modifica</guimenu +> <guimenuitem +>Incolla</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Copia la prima voce degli appunti nell'editor alla posizione del cursore.</para> +<note +><para +>Se l'opzione Sovrascrivi selezione è attiva, il testo incollato sovrascriverà la selezione, se è presente.</para +></note> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-select-all"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>A</keycap +></keycombo +></shortcut +> <guimenu +>Modifica</guimenu +> <guimenuitem +>Seleziona tutto</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Seleziona tutto il testo nell'editor.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-deselect"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>A</keycap +></keycombo +></shortcut +><guimenu +>Modifica</guimenu +><guimenuitem +>Deseleziona</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Deseleziona il testo selezionato nell'editor, se è presente.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-toggle-block-selection"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +> Shift</keycap +><keycap +> B</keycap +></keycombo +></shortcut +><guimenu +>Modifica</guimenu +><guimenuitem +>Modalità selezione a blocchi</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Cambia modalità di selezione. Quando la modalità di selezione è <quote +>BLOCCO</quote +>, puoi fare selezioni verticali, cioè selezionare le colonne dalla 5 alla 10 e le righe dalla 9 alla 15.</para> +<para +>La barra di stato mostra lo stato attuale della modalità di selezione, o <quote +>NORM</quote +> o <quote +>BLO</quote +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-find"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>F</keycap +></keycombo +></shortcut +> <guimenu +>Modifica</guimenu +> <guimenuitem +>Trova...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Apre la finestra Trova per permetterti di cercare del testo nel documento che stai modificando.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-find-next"/> +<menuchoice +><shortcut +><keycombo action="simul" +><keycap +>F3</keycap +></keycombo +></shortcut +><guimenu +>Modifica</guimenu +><guimenuitem +>Trova successivo</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Va alla corrispondenza successiva più vicina dell'ultimo testo o espressione regolare che hai cercato, iniziando dalla posizione del cursore</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-find-previous"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Shift;<keycap +></keycap +></keycombo +></shortcut +><guimenu +> Modifica</guimenu +><guimenuitem +>Trova precedente</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Va alla corrispondenza precedente più vicina dell'ultimo testo o espressione regolare che hai cercato, iniziando dalla posizione del cursore</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-replace"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>R</keycap +></keycombo +></shortcut +> <guimenu +>Modifica</guimenu +> <guimenuitem +>Sostituisci...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Apre la finestra Sostituisci per sostituire una o più volte un certo testo con dell'altro.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-go-to-line"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>G</keycap +></keycombo +></shortcut +> <guimenu +>Modifica</guimenu +><guimenuitem +>Va alla riga</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Apre la finestra Va alla riga, in modo da permettere di inserire un numero di riga da trovare nel documento</para> +</listitem> +</varlistentry> + +</variablelist> + +</sect1> + +<sect1 id="document-menu"> +<title +>Il menu <guimenu +>Documento</guimenu +></title> +<para +>Il menu Documento ha una voce per ciascun documento aperto. Un clic sulla voce corrispondente porta in primo piano il documento richiesto. Se hai aperti più riquadri, il documento selezionato verrà mostrato nel riquadro attivo.</para> +<para +>Inoltre sono presenti comandi per navigare fra i documenti aperti: <variablelist> +<title +>Voci del menu</title> + +<varlistentry> +<term> +<anchor id="document-back"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Alt;<keycap +>Sinistra</keycap +></keycombo +></shortcut +><guimenu +>Documento</guimenu +><guimenuitem +>Indietro</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Porta il fuoco al documento precedente della pila. Se hai più riquadri aperti, il documento viene mostrato nel riquadro attivo.</para +> <para +>L'ordine usato è quello in cui i documenti sono stati aperti, invece della cronologia logica. Questo comportamento potrebbe cambiare in future versioni di &kate;.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="document-forward"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Alt;<keycap +>Destra</keycap +></keycombo +></shortcut +><guimenu +>Documento</guimenu +><guimenuitem +>Avanti</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Porta il fuoco al documento successivo della pila. Se hai più riquadri aperti, il documento viene mostrato nel riquadro attivo.</para> +<para +>L'ordine usato è quello in cui i documenti sono stati aperti, invece della cronologia logica. Questo comportamento potrebbe cambiare in future versioni di &kate;.</para> +</listitem> +</varlistentry> +</variablelist> +</para> +</sect1> + +<sect1 id="view-menu"> +<title +>Il menu <guimenu +>Visualizza</guimenu +></title> + +<para +>Il menu <guimenu +>Visualizza</guimenu +> permette di gestire le impostazioni specifiche per l'editor corrente e di gestire i riquadri.</para> + +<variablelist> +<title +>Voci del menu</title> + +<varlistentry> +<term +><menuchoice +><shortcut +><keycap +></keycap +></shortcut +><guimenu +>Visualizza</guimenu +><guimenuitem +>Passa alla riga di comando</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Questo comando commuta la visualizzazione della <link linkend="advanced-editing-tools-commandline" +>riga di comando integrata</link +>. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Visualizza</guimenu +><guisubmenu +>Schema</guisubmenu +> </menuchoice +></term> +<listitem +><para +>Questo menu mostra tutti gli schemi disponibili. Puoi cambiare schema per la vista corrente da qui, per cambiare lo schema devi usare la <link linkend="config-dialog-editor-colors" +>finestra di configurazione.</link +></para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +><keycap +>F10</keycap +> </keycombo +></shortcut +> <guimenu +>Visualizza</guimenu +><guimenuitem +>A capo automatico dinamico</guimenuitem +></menuchoice> +</term> +<listitem +><para +>Attiva o disattiva l'a capo automatico della vista attuale. L'a capo automatico rende tutto il testo di una vista visibile senza usare lo scorrimento orizzontale, perché mostra una riga di testo effettivo su una o più righe, se è necessario.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Visualizza</guimenu +><guimenuitem +>Mostra/nascondi indicatore a capo statico</guimenuitem +></menuchoice +></term> +<listitem +><para +>Attiva o disattiva la visualizzazione della riga verticale che indica l'ampiezza della pagina come configurata nella <link linkend="config-dialog-editor-wrap-words-at" +>finestra di configurazione</link +>. Questa funzione è disponibile solo se si usa un tipo di carattere a spaziatura fissa.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="view-show-icon-border"/> +<menuchoice +><shortcut +><keycombo action="simul" +><keycap +>F6</keycap +></keycombo +></shortcut +> <guimenu +>Visualizza</guimenu +> <guimenuitem +>Mostra/Nascondi il bordo per le icone</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Questa è una voce di commutazione. Sarà rispettivamente reso visibile o nascosto il bordo per le icone sul lato sinistro dell'editor attivo.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="view-show-line-numbers"/> +<menuchoice +><shortcut +><keycombo action="simul" +><keycap +>F11</keycap +></keycombo +></shortcut +> <guimenu +>Visualizza</guimenu +> <guimenuitem +>Mostra/Nascondi i numeri di riga</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Questo è un elemento alternato. Attivandolo verrà riservato dello spazio sul bordo sinistro dell'editor attivo per visualizzare i numeri di riga del documento, Disattivandolo, i numeri di riga verranno nascosti.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Visualizza</guimenu +><guimenuitem +>Mostra/nascondi segni nella barra di scorrimento</guimenuitem +></menuchoice +></term> +<listitem +><para +>Attiva o disattiva la visualizzazione dei segnalibri (ed altri segni) sulla barra di scorrimento. Quando è attiva, gli indicatori sono rappresentati da sottili righe nel colore di evidenziazione sulla barra di scorrimento, un clic col tasto centrale del mouse farà scorrere la vista ad una posizione prossima all'indicatore.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +><keycap +>F9</keycap +> </keycombo +></shortcut +> <guimenu +>Visualizza</guimenu +><guimenuitem +>Mostra/Nascondi segni di raggruppamento</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Attiva e disattiva la visualizzazione del pannello degli indicatori di raggruppamento sul lato sinistro della vista. Vedi <link linkend="advanced-editing-tools-code-folding" +>Uso del raggruppamento del codice</link +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="view-code-folding"/> +<menuchoice> +<guimenuitem +>Raggruppamento codice</guimenuitem> +</menuchoice> +</term> + +<listitem> +<variablelist> +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl; <keycap +>Shift</keycap +><keycap +>-</keycap +></keycombo +></shortcut +> <guimenuitem +>Contrai livello superiore</guimenuitem +></menuchoice> +</term> +<listitem +><para +>Contrae tutte le regioni di livello superiore nel documento.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>Shift</keycap +><keycap +>+</keycap +></keycombo +></shortcut +> <guimenuitem +>Espandi livello superiore</guimenuitem +></menuchoice> +</term> +<listitem +><para +>Espande tutte le regioni di livello superiore nel documento.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl; <keycap +>-</keycap +></keycombo +></shortcut +> <guimenuitem +>Contrai un livello locale</guimenuitem +></menuchoice> +</term> +<listitem +><para +>Contrae la regione più vicina al cursore.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl; <keycap +>+</keycap +></keycombo +></shortcut +> <guimenuitem +>Espandi un livello locale</guimenuitem +></menuchoice> +</term> +<listitem +><para +>Espande la regione più vicina al cursore.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> + +</varlistentry> + +</variablelist> + +</sect1> + +<sect1 id="bookmarks-menu"> +<title +>Il menu <guimenu +>Segnalibri</guimenu +></title> + +<para +>Il menu <guimenu +>Segnalibri</guimenu +> permette di lavorare con segnalibri nel documento attualmente attivo.</para> + +<para +>Sotto le voci qui descritte, una voce per ciascun segnalibro nel documento attivo sarà disponibile. Il testo sarà composto dalle prime parole della riga indicata. Scegli una voce per spostare il cursore all'inizio della riga corrispondente. L'editor scorrerà il testo di quanto è necessario per rendere la riga visibile.</para> + +<variablelist> + +<title +>Voci del menu</title> + +<varlistentry> +<term> +<anchor id="bookmarks-toggle-bookmark"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>B</keycap +></keycombo +></shortcut +> <guimenu +>Segnalibri</guimenu +> <guimenuitem +>Metti/Pulisci segnalibro</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Imposta o rimuove un segnalibro nella riga attuale del documento attivo (Se c'è un segnalibro viene rimosso, altrimenti viene impostato).</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="bookmarks-clear-bookmarks"/> +<menuchoice +><guimenu +>Segnalibri</guimenu +> <guimenuitem +>Pulisci tutti i segnalibri</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Pulisce (elimina) tutti i segnalibri del documento attivo.</para> +</listitem> +</varlistentry> + +<varlistentry id="bookmarks-previous"> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Alt; <keycap +>Pagina Su</keycap +></keycombo +></shortcut +><guimenu +>Segnalibri</guimenu +><guimenuitem +> Precedente</guimenuitem +></menuchoice> +</term> +<listitem +><para +>Ciò sposterà il cursore all'inizio della prima riga in alto che abbia un segnalibro. Il testo dell'elemento nel menu include il numero di riga ed un primo pezzo del testo nella riga. Questo elemento è disponibile solo quando esiste un segnalibro in una riga sopra al cursore.</para +></listitem> +</varlistentry> + +<varlistentry id="bookmarks-next"> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Alt;<keycap +>Pagina giù</keycap +></keycombo +></shortcut +><guimenu +>Segnalibri</guimenu +><guimenuitem +> Successivo</guimenuitem +></menuchoice +></term> +<listitem +><para +>Ciò sposterà il cursore all'inizio della prossima riga a cui è associato un segnalibro. La voce nel menu conterrà il numero della riga ed il frammento iniziale del testo della riga. Questa voce è disponibile quando esiste almeno un segnalibro in una delle righe sotto al cursore.</para +></listitem> +</varlistentry> + +</variablelist> + +</sect1> + +<sect1 id="tools-menu"> + +<title +>Il menu <guimenu +>Strumenti</guimenu +></title> + +<variablelist> + +<varlistentry> +<term +><menuchoice +><guimenu +>Strumenti</guimenu +><guimenuitem +>Manda alla console</guimenuitem +></menuchoice +></term> +<listitem +><para +>Invia il testo selezionato all'emulatore di terminale integrato. Non viene aggiunto alcun carattere di a capo dopo il testo.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Strumenti</guimenu +><guisubmenu +>Strumenti esterni</guisubmenu +></menuchoice +></term> +<listitem +><para +>Questo sottomenu contiene tutti gli <link linkend="kate-mdi-tools-externaltools" +>strumenti esterni</link +> configurati.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-read-only"/><menuchoice +><guimenu +>Strumenti</guimenu +> <guimenuitem +>Modalità sola lettura</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Imposta il documento corrente in Modalità sola lettura. Ciò impedisce qualsiasi inserimento di testo o modifica della formattazione del documento.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-filetype"/><menuchoice +><guimenu +>Strumenti</guimenu +><guimenuitem +>Tipo di file</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Scegli lo schema per il tipo di file che preferisci per il documento attivo. Questo sovrascrive la modalità del <link linkend="config-dialog-editor-filetypes" +>tipo di file</link +> globale impostata da <menuchoice +><guimenu +>Impostazioni</guimenu +> <guimenuitem +>Configura &kate;...</guimenuitem +></menuchoice +> nella scheda Tipi di file per il solo documento corrente.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-highlighting"/><menuchoice +><guimenu +>Strumenti</guimenu +><guimenuitem +>Evidenziazione</guimenuitem +></menuchoice +></term> + <listitem> +<para +>Scegli lo schema di evidenziazione che preferisci per il documento attivo. Questo sovrascrive la modalità di evidenziazione globale impostata da <menuchoice +><guimenu +>Impostazioni</guimenu +> <guimenuitem +>Configura &kate;...</guimenuitem +></menuchoice +> per il solo documento corrente.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-indentation"/><menuchoice +><guimenu +>Strumenti</guimenu +><guimenuitem +>Indentazione</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Scegli lo <link linkend="kate-part-autoindent" +>stile di indentazione</link +> che preferisci per il documento attivo. Questo sovrascrive la modalità di indentazione globale impostata da <menuchoice +><guimenu +>Impostazioni</guimenu +> <guimenuitem +>Configura &kate;...</guimenuitem +></menuchoice +> per il solo documento corrente.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-encoding"/><menuchoice +><guimenu +>Strumenti</guimenu +><guimenuitem +>Codifica</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Puoi sovrascrivere l'impostazione di codifica predefinita in <menuchoice +> <guimenu +>Impostazioni</guimenu +> <guimenuitem +>Configura editor...</guimenuitem +></menuchoice +> nella scheda <guilabel +>Apri/Salva</guilabel +> per impostare una differente codifica per il documento corrente. La codifica impostata qui sarà valida unicamente per il documento corrente.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-end-of-line"/><menuchoice +><guimenu +>Strumenti</guimenu +> <guimenuitem +>Fine riga</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Scegli lo stile di fine riga che preferisci per il documento attivo. Questo sovrascrive la modalità di indentazione globale impostata da <menuchoice +><guimenu +>Impostazioni</guimenu +> <guimenuitem +>Configura &kate;...</guimenuitem +></menuchoice +> per il solo documento corrente.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-spelling"/><menuchoice +><guimenu +>Strumenti</guimenu +><guimenuitem +>Ortografia...</guimenuitem +></menuchoice> +</term> + +<listitem +><para +><action +>Lancia il programma di controllo ortografico - un programma dedicato ad aiutare l'utente a scovare e correggere gli errori di scrittura.</action +> Facendo clic su questa voce comincerà il controllo e verrà aperta la finestra di dialogo del correttore, attraverso la quale l'utente può controllare il processo. Ci sono quattro impostazioni allineate verticalmente al centro della finestra con alla loro sinistra l'etichetta corrispondente. A partire dall'alto abbiamo:</para> + +<variablelist> +<varlistentry> +<term +><guilabel +>Parola sconosciuta:</guilabel +></term> +<listitem +><para +>Qui, il controllo ortografico indica la parola in esame. Questo accade quando si incontra una parola non contenuta nel dizionario - un file che contiene una lista di parole corrette ortograficamente che vengono comparate con tutte quelle presenti nell'editor.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Sostituisci con:</guilabel +></term> +<listitem +><para +>Se il controllo ha qualche parola simile nel dizionario, la prima viene inclusa qui. L'utente può accettare il suggerimento, scrivere la propria correzione, o scegliere un differente suggerimento dalla prossima casella.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Suggerimenti:</guilabel +></term> +<listitem +><para +>Il controllo può inserire qui una lista di possibili sostituzioni per la parola presa in considerazione. Facendo clic su qualsiasi suggerimento questo va a sostituire la parola nella casella <guilabel +>Sostituzioni:</guilabel +>, in alto.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Lingua:</guilabel +></term> +<listitem +><para +>Se hai installato diversi dizionari, qui puoi scegliere quale dizionario/lingua debba essere usato.</para +></listitem> +</varlistentry> +</variablelist> + +<para +>Sul lato destro della finestra di dialogo ci sono cinque pulsanti che permettono all'utente di controllare il processo di controllo ortografico. Questi sono:</para> + +<variablelist> +<varlistentry> +<term +><guibutton +>Aggiungi al dizionario</guibutton +></term> +<listitem +><para +>Premendo questo pulsante si aggiungerà la <guilabel +>Parola sbagliata:</guilabel +> al dizionario del correttore. Questo significa che in futuro il controllo considererà questa parola ortograficamente corretta.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guibutton +>Sostituisci</guibutton +></term> +<listitem +><para +>Questo pulsante ha il compito di sostituire la parola in esame nel documento con la parola nella casella <guilabel +>Sostituzioni:</guilabel +>.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guibutton +>Sostituisci tutto</guibutton +></term> +<listitem +><para +>Questo pulsante fa sì che il controllo rimpiazzi non solo la corrente <guilabel +>Parola sconosciuta:</guilabel +> ma automaticamente faccia la stessa sostituzione per ogni altra occorrenza di questa <guilabel +>Parola scorretta:</guilabel +> nel documento.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guibutton +>Ignora</guibutton +></term> +<listitem +><para +>Attivando questo pulsante il controllo proseguirà oltre senza applicare cambiamenti.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guibutton +>Ignora tutti</guibutton +></term> +<listitem +><para +>Questo pulsante comunica al controllo di ignorare questa <guilabel +>Parola sconosciuta</guilabel +> ed ignorare altre occorrenze della stessa parola.</para +> <note +><para +>Ciò si applica solo al controllo corrente. Se il controllo sarà riavviato in un secondo momento, si fermerà su questa stessa parola.</para +></note +></listitem> +</varlistentry> +</variablelist> + +<para +>Altri tre pulsanti sono localizzati lungo la base della finestra del controllo ortografico. Essi sono:</para> + +<variablelist> +<varlistentry> +<term +><guibutton +>Aiuto</guibutton +></term> +<listitem +><para +>Invoca il sistema di aiuto di &kde; con le pagine di aiuto di &kate; caricate (questo documento).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>Finito</guibutton +></term> +<listitem +><para +>Questo pulsante ferma il processo di correzione e riporta al documento.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>Annulla</guibutton +></term> +<listitem +><para +>Questo pulsante annulla il processo di controllo ortografico, tutte le modifiche sono annullate e si ritornerà al proprio documento.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> + +<variablelist> +<varlistentry> +<term +><anchor id="tools-spelling-from-cursor"/><menuchoice +><guimenu +>Strumenti</guimenu +><guimenuitem +>Correzione ortografica (dal cursore)...</guimenuitem +></menuchoice +></term> + <listitem> +<para +>Ciò avvierà il programma di correzione ortografica iniziando dalla posizione corrente del cursore invece che dall'inizio del documento.</para> + </listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-spellcheck-selection"/><menuchoice +><guimenu +>Strumenti</guimenu +><guimenuitem +>Controllo ortografico selezione...</guimenuitem +></menuchoice +></term> + <listitem> +<para +>Esegue il controllo ortografico sulla selezione corrente.</para> + </listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="indent"/><menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>I</keycap +></keycombo +> </shortcut +> <guimenu +>Strumenti</guimenu +><guimenuitem +>Indenta</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Aumenta il rientro del paragrafo di un passo. La dimensione del passo dipende dalle <link linkend="config-dialog-editor-indent" +>impostazioni dell'indentazione</link +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-unindent"/><menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;&Shift;<keycap +>I</keycap +></keycombo +> </shortcut +> <guimenu +>Strumenti</guimenu +><guimenuitem +>Annulla indentazione</guimenuitem +></menuchoice +></term> + +<listitem> +<para +>Riduce il rientro del paragrafo di un passo. La dimensione del passo dipende dalle <link linkend="config-dialog-editor-indent" +>impostazioni dell'indentazione</link +>.</para> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-cleanindent"/><menuchoice +><guimenu +>Strumenti</guimenu +><guimenuitem +>Pulisci indentazione</guimenuitem +></menuchoice +></term +> <listitem> +<para +>Pulisce l'indentazione per la selezione corrente o per la linea su cui si trova al momento il cursore. Pulire l'indentazione garantisce che tutto il tuo testo selezionato segue la modalità di indentazione che hai scelto.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-align"/><menuchoice +><guimenu +>Strumenti</guimenu +><guimenuitem +>Allinea</guimenuitem +> </menuchoice +></term> +<listitem> +<para +>Provoca un riallineamento della riga corrente o delle righe selezionate utilizzando la modalità di indentazione e le impostazioni di indentazione del documento.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-comment"/><menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>D</keycap +></keycombo +> </shortcut +> <guimenu +>Strumenti</guimenu +> <guimenuitem +>Commenta</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Aggiunge uno spazio all'inizio della linea dove è posizionato il cursore del testo o all'inizio di ciascuna linea selezionata.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-uncomment"/><menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;&Shift;<keycap +>D</keycap +></keycombo +> </shortcut +> <guimenu +>Strumenti</guimenu +> <guimenuitem +>Decommenta</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Rimuove uno spazio (se esiste) dall'inizio della riga dove è posizionato il cursore testo o dall'inizio di ciascuna riga selezionata.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-uppercase"/><menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>U</keycap +></keycombo +> </shortcut +> <guimenu +>Strumenti</guimenu +> <guimenuitem +>Maiuscolo</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Trasforma il testo selezionato o la lettera che segue il cursore in maiuscolo.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-lowercase"/><menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;&Shift;<keycap +>U</keycap +></keycombo +> </shortcut +> <guimenu +>Strumenti</guimenu +> <guimenuitem +>Minuscolo</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Trasforma il testo selezionato o la lettera che segue il cursore in minuscolo.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-capitalize"/><menuchoice +><shortcut +> <keycombo action="simul" +>&Alt;&Ctrl;<keycap +>U</keycap +></keycombo +> </shortcut +> <guimenu +>Strumenti</guimenu +> <guimenuitem +>Iniziali maiuscole</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Trasforma le iniziali in maiuscole nel testo selezionato o nella parola corrente.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-join-lines"/><menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>J</keycap +></keycombo +> </shortcut +> <guimenu +>Strumenti</guimenu +> <guimenuitem +>Unisci righe</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Unisce le righe selezionate, o la riga corrente e quella successiva con un carattere di spazio come separatore. Gli spazi bianchi iniziali o finali nelle righe unificate saranno rimossi dalle estremità coinvolte.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-word-wrap-document"/><menuchoice +><guimenu +>Strumenti</guimenu +> <guimenuitem +>A capo documento</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Applica l'a capo statico sull'intero documento. Ciò significa che verrà creata una nuova riga di testo automaticamente quando la riga corrente supererà la lunghezza specificata dall'opzione Colonna a cui andare a capo: nella scheda Modifica in <menuchoice +><guimenu +>Impostazioni</guimenu +><guimenuitem +>Configura editor...</guimenuitem +></menuchoice +></para +></listitem> +</varlistentry> + +</variablelist> + + +</sect1> + +<sect1 id="sessions-menu"> +<title +>Il menu <guimenu +>Sessioni</guimenu +></title> + +<para +>Questo menu contiene voci per l'uso e la gestione delle sessioni di &kate;. Per maggiori informazioni, vedi <link linkend="fundamentals-using-sessions" +>Uso delle sessioni</link +>.</para> + +<variablelist> + +<varlistentry id="sessions-new"> +<term +><menuchoice +><guimenu +>Sessioni</guimenu +><guimenuitem +>Nuovo</guimenuitem +></menuchoice +></term> +<listitem +><para +>Crea una nuova sessione vuota. Tutti i file attualmente aperti saranno chiusi.</para +></listitem> + +</varlistentry> + +<varlistentry id="sessions-open"> +<term +><menuchoice +><guimenu +>Sessioni</guimenu +><guimenuitem +>Apri...</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Apri una sessione esistente. La finestra di scelta della sessione è mostrata per permetterti la scelta.</para +></listitem> +</varlistentry> + +<varlistentry id="sessions-quick-open"> +<term +><menuchoice +><guimenu +>Sessioni</guimenu +><guisubmenu +>Apertura rapida</guisubmenu +> </menuchoice +></term> +<listitem +><para +>Questo sottomenu permette di aprire una sessione esistente.</para> +</listitem> +</varlistentry> + +<varlistentry id="sessions-save"> +<term +><menuchoice +><guimenu +>Sessioni</guimenu +><guimenuitem +>Salva</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Salva la sessione attuale. Se la sessione è anonima, ti verrà chiesto di scegliere un nome.</para +></listitem> +</varlistentry> + +<varlistentry id="sessions-save-as"> +<term +><menuchoice +><guimenu +>Sessioni</guimenu +><guimenuitem +>Salva con nome...</guimenuitem +></menuchoice +></term> +<listitem +><para +>Salva la sessione attuale con un nuovo nome. Ti verrà chiesto il nome da usare.</para +></listitem> +</varlistentry> + +<varlistentry id="sessions-manage"> +<term +><menuchoice +><guimenu +>Sessioni</guimenu +><guimenuitem +>Gestisci...</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Mostra la finestra di gestione delle sessioni che permette di rinominare e cancellare le sessioni.</para +></listitem> +</varlistentry> + + +</variablelist> + +</sect1> + +<sect1 id="settings-menu"> + +<title +>Il menu <guimenu +>Impostazioni</guimenu +></title> + +<para +>Il menu <guimenu +>Impostazioni</guimenu +> permette di cambiare le proprietà della finestra principale, come la visualizzazione delle barre degli strumenti, e fornisce l'accesso alle finestre di configurazione.</para> + +<variablelist> + +<varlistentry> +<term> +<anchor id="settings-toolbars"/> +<menuchoice +><guimenu +>Impostazioni</guimenu +><guisubmenu +>Barre degli strumenti</guisubmenu +> </menuchoice> +</term> +<listitem> +<para +>Questo sottomenu elenca le barre di strumenti disponibili, ciascuna voce mostra o nasconde la barra di strumenti associata.</para> +</listitem> +</varlistentry> + +<varlistentry id="settings-fullscreen"> +<term +><menuchoice +><guimenu +>Impostazioni</guimenu +><guimenuitem +>Modalità a tutto schermo</guimenuitem +></menuchoice +></term> +<listitem +><para +>Attiva o disattiva la modalità a tutto schermo.</para> +<note +><para +>Questo comando sarà spostato al menu Finestra in una futura versione di &kate;</para +></note> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="settings-configure-shortcuts"/> +<menuchoice +><guimenu +>Impostazioni</guimenu +> <guimenuitem +>Configura le scorciatoie...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Mostra la familiare finestra di dialogo per la configurazione delle scorciatoie di &kde;.</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term> +<anchor id="settings-configure-toolbars"/> +<menuchoice +><guimenu +>Impostazioni</guimenu +> <guimenuitem +>Configura le barre degli strumenti...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Mostra la familiare finestra di dialogo per la configurazione delle barre di strumenti di &kde;.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="settings-configure-kate"/> +<menuchoice +><guimenu +>Impostazioni</guimenu +><guimenuitem +>Configura &kate;...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Apre la <link linkend="config-dialog" +>finestra di configurazione principale</link +></para> +</listitem> +</varlistentry> + +</variablelist> + +</sect1> + +<sect1 id="window-menu"> +<title +>Il menu <guimenu +>Finestra</guimenu +></title> + +<variablelist> +<varlistentry> +<term> +<anchor id="window-new"/> +<menuchoice +><guimenu +>Finestra</guimenu +><guimenuitem +>Nuova finestra</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +><action +>Apre una nuova istanza di &kate;</action +>. La nuova istanza sarà identica a quella precedente. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="window-split-vertical"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>L</keycap +></keycombo +></shortcut +> <guimenu +>Finestra</guimenu +><guimenuitem +> Dividi verticalmente</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Divide il riquadro (che può essere l'intera area di lavoro) in due riquadri di dimensione analoga, quello nuovo a destra del precedente. Il riquadro nuovo è focalizzato, e mostra lo stesso documento di quello vecchio.</para> +<para +>Vedi anche <link linkend="kate-mdi" +>Lavorare con l'MDI di &kate;</link +></para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="window-split-horizontal"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>T</keycap +></keycombo +></shortcut +> <guimenu +>Finestra</guimenu +><guimenuitem +> Dividi orizzontalmente</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Divide il riquadro (che può essere l'intera area di lavoro) in due riquadri di dimensione analoga, quello nuovo al di sotto del precedente. Il riquadro nuovo è focalizzato, e mostra lo stesso documento di quello vecchio.</para> +<para +>Vedi anche <link linkend="kate-mdi" +>Lavorare con l'MDI di &kate;</link +></para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="window-close-current"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +> R</keycap +></keycombo +></shortcut +><guimenu +> Finestra</guimenu +><guimenuitem +> Chiudi la vista corrente</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Chiude il riquadro corrente. Se c'è solo un riquadro (l'area di modifica principale), questa voce è disabilitata.</para +> <para +>Nessun documento viene chiuso con la chiusura di un riquadro – i documenti saranno ancora disponibili nel menu <link linkend="document-menu" +><guimenu +>Documenti</guimenu +></link +> oltre che nella Lista dei file.</para +> <para +>Vedi anche <link linkend="kate-mdi" +>Lavorare con l'MDI di &kate;</link +></para> +</listitem> +</varlistentry> + +<varlistentry id="window-next-view"> +<term +><menuchoice +><shortcut +><keycombo action="simul" +><keycap +>F8</keycap +> </keycombo +></shortcut +><guimenu +>Finestra</guimenu +><guimenuitem +>Vista successiva</guimenuitem +></menuchoice +></term> +<listitem +><para +>Focalizza la successiva vista del documento, se hai suddiviso l'area di lavoro in più viste.</para +></listitem> +</varlistentry> + +<varlistentry id="window-previous-view"> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Shift;<keycap +>F8</keycap +> </keycombo +></shortcut +><guimenu +>Finestra</guimenu +><guimenuitem +>Vista precedente</guimenuitem +></menuchoice +></term> +<listitem +><para +>Focalizza la precedente vista del documento, se hai suddiviso l'area di lavoro in più viste.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Finestra</guimenu +><guisubmenu +>Viste accessorie</guisubmenu +> </menuchoice +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><anchor id="window-toolviews-show-sidebars"/> +<menuchoice +><guimenu +>Finestra</guimenu +><guisubmenu +>Viste accessorie</guisubmenu +> <guimenuitem +>Mostra/Nascondi barre laterali</guimenuitem +></menuchoice +></term> +<listitem +><para +>Attiva o disattiva la barra dei pulsanti della barra laterale. Questo comando non ha effetto sulla visualizzazione dei controlli del contenuto della barra laterale, una barra che sia visibile resterà visibile, e se hai assegnato delle scorciatoie ai comandi sottostanti questi continueranno a funzionare normalmente.</para +></listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="window-toolviews-show-filelist"/> +<menuchoice +><guimenu +>Finestra</guimenu +><guisubmenu +>Viste accessorie</guisubmenu +><guimenuitem +>Mostra Documenti</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Attiva o disattiva la visualizzazione della lista dei documenti di &kate;</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="window-toolviews-show-fileselector"/> +<menuchoice +><guimenu +>Finestra</guimenu +><guisubmenu +>Viste accessorie</guisubmenu +><guimenuitem +>Mostra/Nascondi Browser del filesystem</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Mostra o nasconde il navigatore del filesystem di &kate;</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="window-toolviews-greptool"/> +<menuchoice +><guimenu +>Finestra</guimenu +><guisubmenu +>Viste accessorie</guisubmenu +><guimenuitem +>Mostra/Nascondi Cerca nel file</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Mostra o nasconde lo strumento <guilabel +>Cerca nel file</guilabel +> di &kate;. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="window-toolviews-show-konsole"/> +<menuchoice +><guimenu +>Finestra</guimenu +><guisubmenu +>Viste accessorie</guisubmenu +><guimenuitem +> Mostra/Nascondi terminale</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Commuta la visualizzazione dell'emulatore di terminale integrato.</para> +<para +>Quando è attivata la prima volta, il terminale verrà creato.</para> +<para +>Quando l'emulatore di terminale è mostrato, verrà messo a fuoco, in modo che tu possa cominciare a scrivere i comandi immediatamente. Se l'opzione <link linkend="config-dialog-general-sync-konsole" +>Sincronizza l'emulatore di terminale con il documento attivo</link +> è abilitata nella pagina <link linkend="config-dialog-general" +>Generale</link +> della <link linkend="config-dialog" +>finestra di configurazione principale</link +>, la sessione di shell si posizionerà sulla directory del documento corrente, se è un file locale.</para> +</listitem> +</varlistentry> + +</variablelist> + +</listitem> +</varlistentry> + +</variablelist> + +</sect1> + +<sect1 id="help-menu"> + +<title +>Il menu <guimenu +>Aiuto</guimenu +></title> + +<para +>A parte le voci del menu <guimenu +>Aiuto</guimenu +> di &kde; descritti sotto, ci saranno voci di menu per mostrare i manuali per l'utente dei plugin installati.</para> +&help.menu.documentation; </sect1> + +</chapter> diff --git a/tde-i18n-it/docs/tdebase/kate/part.docbook b/tde-i18n-it/docs/tdebase/kate/part.docbook new file mode 100644 index 00000000000..fbc3ec459a8 --- /dev/null +++ b/tde-i18n-it/docs/tdebase/kate/part.docbook @@ -0,0 +1,988 @@ +<chapter id="kate-part"> +<chapterinfo> +<authorgroup> +<author +>&Anders.Lund; &Anders.Lund.mail;</author> +<othercredit role="translator" +><firstname +>Luigi</firstname +><surname +>Toscano</surname +><affiliation +><address +><email +>luigi.toscano@tiscali.it</email +></address +></affiliation +><contrib +></contrib +></othercredit +> +</authorgroup> +</chapterinfo> +<title +>Lavorare con l'editor &kate;</title> + +<sect1 id="kate-part-overview"> + +<title +>Panoramica</title> + +<para +>L'editor &kate; è l'area modificabile della finestra di &kate;. Questo editor è utilizzato anche da &kwrite; e può essere usato in &konqueror; per mostrare file di testo presenti nel tuo computer o in rete.</para> + +<para +>L'editor è costituito dai seguenti componenti:</para> + +<variablelist> + +<varlistentry> +<term +>L'area di modifica</term> +<listitem +><para +>Qui si trova il testo del documento.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Le barre di scorrimento</term> +<listitem> +<para +>Le barre di scorrimento indicano la posizione della parte visibile del testo del documento e possono essere utilizzate per spostarsi nel documento. L'operazione di trascinamento delle barre di scorrimento non modifica la posizione del cursore di inserimento.</para> +<para +>Le barre di scorrimento sono mostrate e nascoste secondo necessità.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Il bordo per le icone</term> +<listitem> +<para +>Il bordo per le icone è un piccolo pannello alla sinistra dell'editor che mostra una piccola icona in corrispondenza delle righe marcate.</para> +<para +>Puoi impostare o rimuovere un <link linkend="kate-part-bookmarks" +>segnalibro</link +> in una riga visibile facendo clic con il &LMB; nel bordo per le icone in corrispondenza di tale riga.</para> +<para +>La visualizzazione del bordo per le icone può essere attivata o disattivata tramite la voce di menu <menuchoice +><guimenu +>Visualizza</guimenu +> <guimenuitem +>Mostra bordo per le icone</guimenuitem +></menuchoice +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Il pannello per numeri di riga</term> +<listitem> +<para +>Il pannello per i numeri di riga mostra i numeri di riga di tutte le righe visibili nel documento.</para> +<para +>La visualizzazione del pannello per i numeri di riga può essere attivata o disattivata tramite la voce di menu <menuchoice +><guimenu +>Visualizza</guimenu +> <guimenuitem +>Mostra i numeri di riga</guimenuitem +></menuchoice +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Il pannello di raggruppamento</term> +<listitem> +<para +>Il pannello di raggruppamento ti consente di richiudere o espandere i blocchi raggruppabili di righe. Le regioni richiudibile vengono determinate in base alle regole specificate nelle definizioni di evidenziazione della sintassi per il documento.</para> +</listitem> +</varlistentry> + +</variablelist> + +<itemizedlist> +<title +>Altri argomenti in questo capitolo:</title> +<listitem +><para +><link linkend="kate-part-navigation" +>Navigare nel testo</link +> </para +></listitem> +<listitem +><para +><link linkend="kate-part-selection" +>Lavorare con la selezione</link +></para +></listitem> +<listitem +><para +><link linkend="kate-part-copy-and-paste" +>Copiare ed incollare testo</link +></para +></listitem> +<listitem +><para +><link linkend="kate-part-find-replace" +>Trovare e sostituire testo</link +></para +></listitem> +<listitem +><para +><link linkend="kate-part-bookmarks" +>Usare i segnalibri</link +></para +></listitem> +<listitem +><para +><link linkend="kate-part-auto-wrap" +>Andare a capo automaticamente</link +></para +></listitem> +<listitem +><para +><link linkend="kate-part-autoindent" +>Usare l'indentazione automatica</link +></para +></listitem> +</itemizedlist> + +</sect1> + +<sect1 id="kate-part-navigation"> +<title +>Navigare nel testo</title> + +<para +>Lo spostamento nel testo in &kate; avviene come nella maggior parte degli editor di testo grafici. Puoi spostare il cursore tramite i tasti freccia ed i tasti <keycap +>Pag Su</keycap +>, <keycap +>Pag Giù</keycap +>, <keycap +>Home</keycap +> e <keycap +>Fine</keycap +> in combinazione con i modificatori <keycap +>Ctrl</keycap +> e <keycap +>Shift</keycap +>. Il tasto <keycap +>Shift</keycap +> viene sempre utilizzato per generare una selezione, mentre <keycap +>Ctrl</keycap +> provoca effetti diversi a seconda del tasto: <itemizedlist> +<listitem +><para +>Per i tasti <keycap +>Su</keycap +> e <keycap +>Giù</keycap +> significa scorrimento invece di spostamento del cursore.</para +></listitem> +<listitem +><para +>Per i tasti <keycap +>Sinistra</keycap +> e <keycap +>Destra</keycap +> significa saltare parole invece di caratteri.</para +></listitem> +<listitem +><para +>Per i tasti <keycap +>Freccia Su</keycap +> e <keycap +>Frecci Giù</keycap +> significa spostare il cursore ai limiti della vista invece di navigare nel testo.</para> +</listitem> +<listitem +><para +>Per i tasti <keycap +>Home</keycap +> e <keycap +>Fine</keycap +> significa spostare il cursore all'inizio o alla fine del documento invece che all'inizio o alla fine della riga.</para +></listitem> +</itemizedlist> +</para> + +<para +>&kate; mette anche a disposizione un modo per saltare rapidamente alla parentesi corrispondente: posiziona il cursore all'interno di una parentesi e premi <keycombo +><keycap +>Ctrl</keycap +><keycap +>6</keycap +></keycombo +> per saltare alla parentesi corrispondente.</para> + +<para +>Inoltre puoi utilizzare i <link linkend="kate-part-bookmarks" +>segnalibri</link +> per saltare rapidamente a delle posizioni che puoi definire a tua scelta.</para> + +</sect1> + +<sect1 id="kate-part-selection"> +<title +>Lavorare con la selezione</title> + +<para +>Ci sono due metodi di base per selezionare del testo in &kate;: tramite l'uso rispettivamente del mouse e della tastiera.</para> + +<para +>Per selezionare usando il mouse, tieni premuto il &LMB; mentre trascini il cursore del mouse dal punto iniziale della selezione fino al punto finale. Il testo sarà selezionato mentre trascini.</para> + +<para +>Facendo doppio clic su una parola, questa verrà selezionata.</para> + +<para +>Facendo clic triplo su una riga, questa verrà interamente selezionata.</para> + +<para +>Se il tasto &Shift; viene tenuto premuto mentre si fa clic, il testo sarà selezionato:</para> + +<itemizedlist> +<listitem +><para +>Se non è stato ancora selezionato alcun testo, dalla posizione del cursore del testo alla posizione del cursore del mouse.</para +></listitem> +<listitem +><para +>Se è già attiva una selezione, a partire e includendo tale selezione fino alla posizione del cursore del mouse</para +></listitem> +</itemizedlist> + +<note> +<para +>Quando selezioni il testo tramite trascinamento del mouse, il testo selezionato viene copiato negli appunti e può essere incollato tramite un clic del pulsante centrale del mouse nell'editor o in qualunque altra applicazione in cui vuoi incollarlo. </para> +</note> + +<para +>Per selezionare usando la tastiera, tieni premuto il tasto &Shift; mentre utilizzi i tasti di navigazione (i tasti freccia, <keycap +>Pag Su</keycap +>, <keycap +>Pag Giù</keycap +>, <keycap +>Home</keycap +> e <keycap +>Fine</keycap +>, possibilmente in combinazione con &Ctrl; per estendere il movimento del cursore di testo).</para> + +<para +>Vedi anche la sezione <link linkend="kate-part-navigation" +>Navigare nel testo</link +> in questo capitolo.</para> + +<para +>Per <action +>Copiare</action +> la selezione corrente usa la voce di menu <menuchoice +><guimenu +>Modifica</guimenu +> <guimenuitem +>Copia</guimenuitem +></menuchoice +> o la scorciatoia di tastiera (quella predefinita è <keycombo action="simul" +>&Ctrl;<keycap +>C</keycap +></keycombo +>).</para> + +<para +>Per <action +>deselezionare</action +> la selezione corrente usa la voce di menu <menuchoice +><guimenu +>Modifica</guimenu +> <guimenuitem +>Deseleziona</guimenuitem +></menuchoice +>, o la scorciatoia di tastiera (quella predefinita è <keycombo action="simul" +>&Ctrl;&Shift;<keycap +>A</keycap +></keycombo +>), o fai clic con il &LMB; nell'editor.</para> + +<sect2 id="kate-part-selection-block"> +<title +>Usare la selezione a blocchi</title> + +<para +>Quando la selezione a blocchi è attiva puoi effettuare <quote +>selezioni verticali</quote +> nel testo, cioé selezionare colonne ben definite da righe differenti. Questo è comodo ad esempio per lavorare con righe con dati separati da tabulazioni.</para> + +<para +>La selezione a blocchi può essere attivata o disattivata tramite la voce di menu <menuchoice +><guimenu +>Modifica</guimenu +> <guimenuitem +>Modalità selezione a blocchi</guimenuitem +></menuchoice +>. La scorciatoia di tastiera predefinita è <keycap +>F4</keycap +></para> + +</sect2> + +<sect2 id="kate-part-seleciton-overwrite"> + +<title +>Usare l'opzione Sovrascrivi selezione</title> + +<para +>Se l'opzione Sovrascrivi selezione è attiva, il testo presente nella selezione verrà sostituito se si scrive o si incolla del testo nella selezione. Se non è attiva il nuovo testo verrà aggiunto alla posizione del cursore di testo.</para> + +<para +>L'opzione Sovrascrivi selezione è attiva come impostazione predefinita.</para> + +<para +>Per cambiare l'impostazione di questa opzione, usa la <link linkend="config-dialog-editor-cursor-selection" +>pagina di selezione</link +> della <link linkend="config-dialog" +>finestra di configurazione</link +>.</para> + +</sect2> + +<sect2 id="kate-part-selection-persistent"> + +<title +>Usare la selezione permanente</title> + +<para +>Quando la selezione permanente è attiva, la selezione corrente non verrà annullata se si digitano caratteri o si muove il cursore. Questo vuol dire che puoi spostare il cursore dalla selezione e continuare a digitare.</para> + +<para +>La selezione permanente è disattivata come impostazione predefinita.</para> + +<para +>La selezione permanente può essere abilitata tramite la <link linkend="config-dialog-editor-cursor-selection" +>pagina di selezione</link +> della <link linkend="config-dialog" +>finestra di configurazione</link +>.</para> + +<warning> +<para +>Se la selezione permanente e Sovrascrivi selezione sono entrambe attive, digitare o incollare del testo quando il cursore di testo è all'interno della selezione farà sì che questa venga annullata e il testo contenuto sostituito.</para> +</warning> + +</sect2> + +</sect1> + +<sect1 id="kate-part-copy-and-paste"> + +<title +>Copiare ed incollare testo</title> + +<para +>Per copiare del testo, selezionalo ed usa la voce di menu <menuchoice +><guimenu +>Modifica</guimenu +> <guimenuitem +>Copia</guimenuitem +></menuchoice +>.Inoltre, se si seleziona del testo con il mouse, questo verrà copiato nella selezione di X.</para> + +<para +>Per incollare il testo presente negli appunti, usa la voce di menu <menuchoice +><guimenu +>Modifica</guimenu +><guimenuitem +>Incolla</guimenuitem +></menuchoice +>.</para> + +<para +>Inoltre il testo selezionato tramite il mouse può essere incollato facendo clic con il pulsante <mousebutton +>centrale</mousebutton +> del mouse nella posizione desiderata.</para> + +<tip> +<para +>Se utilizzi l'ambiente desktop &kde;, puoi riprendere da una qualsiasi applicazione il testo copiato precedentemente tramite l'icona di &klipper; presente nel vassoio di sistema di &kicker;.</para> +</tip> + +</sect1> + +<sect1 id="kate-part-find-replace"> +<title +>Trovare e sostituire testo</title> + +<sect2 id="find-replace-dialog"> +<title +>Le finestre di dialogo <guilabel +>Trova testo</guilabel +> e <guilabel +>Sostituisci testo</guilabel +></title> + + +<para +>Le finestre di dialogo Trova e Sostituisci testo sono molto simili, con la differenza che quella di sostituzione dà la possibilità di inserire la nuova stringa insieme ad alcune opzioni aggiuntive.</para> + +<para +>Le finestre di dialogo presentano le seguenti opzioni comuni:</para> + +<variablelist> + +<varlistentry> +<term +><guilabel +>Testo da trovare</guilabel +></term> +<listitem +><para +>Qui va inserita la stringa di ricerca. L'interpretazione della stringa dipende da alcune delle opzioni descritte più avanti.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Espressione regolare</guilabel +></term> +<listitem> +<para +>Se marcata, la stringa da cercare viene interpretata come un'espressione regolare. Verrà attivato un pulsante per lanciare uno strumento grafico per creare o modificare l'espressione.</para> +<para +>Vedi la sezione <link linkend="regular-expressions" +>Espressioni regolari</link +> per maggiori informazioni.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Ignora maiuscole/minuscole</guilabel +></term> +<listitem> +<para +>Se attivo, la ricerca non terrà conto della distinzione tra maiuscole e minuscole.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Solo parole intere</guilabel +></term> +<listitem> +<para +>Se marcata, la ricerca avrà successo solo se c'è un delimitatore di parola ad entrambi gli estremi della stringa trovata, intendendo con questo non un carattere alfanumerico - né un carattere visualizzabile o un fine riga.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Dal cursore</guilabel +></term> +<listitem> +<para +>Se marcata, la ricerca partirà dalla posizione del cursore, altrimenti partirà dall'inizio della prima riga del documento.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Trova all'indietro</guilabel +></term> +<listitem> +<para +>Se marcata, la ricerca controllerà la prima corrispondenza sopra il punto di partenza, sia esso la posizione del cursore o l'inizio del documento se l'opzione <guilabel +>Dall'inizio</guilabel +> è attiva.</para> +</listitem> +</varlistentry> + +</variablelist> + +<para +>La finestra di dialogo <guilabel +>Sostituisci testo</guilabel +> mette a disposizione alcune opzioni addizionali:</para> + +<variablelist> + +<varlistentry> +<term +><guilabel +>Sostituisci con</guilabel +></term> +<listitem +><para +>Qui va inserita la stringa di sostituzione.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Testo selezionato</guilabel +></term> +<listitem> +<para +>Questa opzione è disabilitata se non è stato selezionato alcun testo o se l'opzione <guilabel +>Chiedi prima di sostituire</guilabel +> è attiva. Se marcata, tutte le corrispondenze della stringa di ricerca con il testo selezionato verranno rimpiazzate dalla stringa di sostituzione.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Chiedi prima di sostituire</guilabel +></term> +<listitem +><para +>Se marcata, una piccola finestra di dialogo ti chiederà cosa fare ogni volta che viene trovata una corrispondenza. Mette a disposizione le seguenti opzioni: <variablelist> + +<varlistentry> +<term +><guibutton +>Sì</guibutton +></term> +<listitem +><para +>Attiva questa per rimpiazzare la corrispondenza corrente (selezionata nell'editor).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>No</guibutton +></term> +<listitem +><para +>Attivare per saltare la corrispondenza corrente e cercarne un'altra.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>Tutti</guibutton +></term> +<listitem +><para +>Attivare per non chiedere ulteriormente e sostituire tutte le corrispondenze.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>Chiudi</guibutton +></term> +<listitem +><para +>Attiva questa per saltare la corrispondenza corrente e terminare la ricerca.</para +></listitem> +</varlistentry> + +</variablelist> + +</para +></listitem> +</varlistentry> + +</variablelist> + +<note> +<para +>Al momento non è possibile impostare una corrispondenza minimale quando si utilizza un'espressione regolare per cercare. Questa funzione verrà aggiunta nelle versioni future di &kate;</para> +</note> + +</sect2> + +<sect2 id="finding-text"> +<title +>Trovare del testo</title> + +<para +>Per trovare del testo, lancia la finestra di dialogo <guilabel +>Trova testo</guilabel +> con <keycombo action="simul" +>&Ctrl;<keycap +>F</keycap +></keycombo +> oppure tramite la voce di menu <menuchoice +><guimenu +>Modifica</guimenu +> <guimenuitem +>Trova...</guimenuitem +></menuchoice +>, inserisci la stringa di ricerca, imposta le <link linkend="find-replace-dialog" +>opzioni</link +> come preferisci e premi <guibutton +>Ok</guibutton +>. Se la ricerca è partita dalla posizione del cursore e non è stata trovata alcuna corrispondenza prima della fine del documento (o dell'inizio se è una ricerca inversa), ti verrà richiesto se ricercare da capo (o dal fondo). </para> + +<para +>Se viene trovata una corrispondenza, questa verrà selezionata e la finestra di dialogo <guilabel +>Trova testo</guilabel +> nascosta, ma niente paura, è facile trovare ulteriori corrispondenze:</para> + +<para +>Per cercare la successiva occorrenza nella direzione impostata per la ricerca, utilizza il comando <menuchoice +><guimenu +>Modifica</guimenu +> <guimenuitem +>Trova successivo</guimenuitem +></menuchoice +> o premi <keycap +>F3</keycap +>.</para> + +<para +>Per cercare la successiva occorrenza nella direzione opposta, utilizza il comando <menuchoice +><guimenu +>Modifica</guimenu +> <guimenuitem +>Trova precedente</guimenuitem +></menuchoice +> o premi <keycombo action="simul" +>&Shift;<keycap +>F3</keycap +></keycombo +>.</para> + +<para +>Se non è stata trovata alcuna corrispondenza prima della fine del documento (o dell'inizio se è una ricerca inversa), ti verrà richiesto se ricercare da capo (o dal fondo). </para> + +</sect2> + +<sect2> +<title +>Sostituire il testo</title> + +<para +>Per sostituire del testo, lancia la finestra di dialogo <guilabel +>Sostituisci testo</guilabel +> tramite il comando <menuchoice +><guimenu +>Modifica</guimenu +> <guimenuitem +>Sostituisci...</guimenuitem +></menuchoice +> oppure tramite la scorciatoia di tastiera <keycombo action="simul" +>&Ctrl;<keycap +>R</keycap +></keycombo +>, inserisci la stringa di ricerca e opzionalmente una stringa di sostituzione (se questa è vuota, il testo di ogni corrispondenza sarà cancellato), imposta le <link linkend="find-replace-dialog" +>opzioni</link +> come preferisci e premi <guibutton +>Ok</guibutton +>.</para> + +<tip> +<para +>Se usi un'espressione regolare per trovare il testo da sostituire puoi utilizzare i riferimenti all'indietro per riutilizzare il testo catturato tra parentesi nel sottomodello dell'espressione.</para> +<para +>Vedi <xref linkend="regular-expressions"/> per maggiori informazioni sull'argomento.</para> +</tip> + +<tip +><para +>Puoi usare i comandi <command +>find</command +>, <command +>replace</command +> e <command +>ifind</command +> (ricerca incrementale) dalla <link linkend="advanced-editing-tools-commandline" +>riga di comando</link +>.</para> +</tip> + +</sect2> + +</sect1> + +<sect1 id="kate-part-bookmarks"> +<title +>Usare i segnalibri</title> + +<para +>I segnalibri ti consentono di marcare alcune riga per poterle ritrovare successivamente in modo semplice.</para> + +<para +>Puoi impostare o rimuovere un segnalibro in una riga in due modi:</para> + +<itemizedlist> +<listitem> +<para +>spostando il cursore di inserimento nella riga e usando il comando <menuchoice +><guimenu +>Segnalibri</guimenu +><guimenuitem +>Metti segnalibro</guimenuitem +></menuchoice +> (<keycombo action="simul" +>&Ctrl;<keycap +>B</keycap +></keycombo +>).</para> +</listitem> +<listitem> +<para +>facendo clic sul bordo per le icone in corrispondenza della riga.</para> +</listitem> +</itemizedlist> + + +<para +>I segnalibri sono raggiungibili dal menu <guimenu +>Segnalibri</guimenu +>.Ognuno di essi è disponibile come voce di menu, etichettata con il numero di riga a cui è associato il segnalibro e i primi caratteri del testo di tale riga. Per spostare il cursore di inserimento all'inizio di una riga con segnalibro, apri il menu e seleziona il segnalibro.</para> + +<para +>Per spostarti rapidamente tra i segnalibri o andare al segnalibro successivo/precedente, usa rispettivamente le voci di menu <menuchoice +><guimenu +>Segnalibri</guimenu +><guimenuitem +>Successivo</guimenuitem +> </menuchoice +> (<keycombo action="simul" +><keycap +>Ctrl</keycap +> <keycap +>Pag Giù</keycap +></keycombo +>) o <menuchoice +> <guimenu +>Segnalibri</guimenu +><guimenuitem +>Precedente</guimenuitem +></menuchoice +> (<keycombo action="simul" +><keycap +>Ctrl</keycap +><keycap +>Pag Su</keycap +> </keycombo +>).</para> + +</sect1> + +<sect1 id="kate-part-auto-wrap"> + +<title +>Andare a capo automaticamente</title> + +<para +>Questa funzione ti consente di formattare il testo in modo semplice: il testo andrà a capo automaticamente in modo che nessuna riga possa contenere più di un determinato numero di caratteri, a meno che non ci sia una stringa più lunga senza spazi.</para> + +<para +>Per attivarla/disattivarla, marca/smarca la casella <guibutton +>A capo automatico</guibutton +> nella <link linkend="config-dialog-editor-edit" +>pagina di modifica</link +> della <link linkend="config-dialog" +>finestra di configurazione</link +>.</para> + +<para +>Per impostare la lunghezza massima di una riga (numero massimo di caratteri per riga) usa l'opzione <link linkend="config-dialog-editor-wrap-words-at" +><guibutton +>Colonna a cui andare a capo:</guibutton +></link +> nella <link linkend="config-dialog-editor-edit" +>pagina di modifica</link +> della <link linkend="config-dialog" +>finestra di configurazione</link +>.</para> + +<para +>Se attivo ha i seguenti effetti: <itemizedlist> +<listitem +><para +>Mentre digiti l'editor automaticamente interrompe la riga dopo l'ultimo carattere separatore presente in posizione precedente al raggiungimento della dimensione massima per la riga.</para +></listitem> +<listitem +><para +>In fase di caricamento di un documento, l'editor manderà a capo il testo in modo analogo, facendo sì che non ci siano righe più lunghe della massima dimensione consentita se contengono dei caratteri separatori che lo consentono.</para +></listitem> +</itemizedlist> + +</para> + +<note +><para +>Non c'è modo al momento di impostare l'a capo automatico per tipo di documento, e neppure di abilitarlo o disabilitarlo a livello di documento. Questo problema sarà risolto in una futura versione di &kate;</para +></note> + +</sect1> + +<sect1 id="kate-part-autoindent"> +<title +>Usare l'indentazione automatica</title> + +<para +>Il componente editor di &kate; supporta differenti modalità di autoindentazione progettate per differenti formati di testo. Puoi scegliere tra le modalità disponibili tramite la voce di menu <menuchoice +><guimenu +>Strumenti</guimenu +><guisubmenu +>Indentazione</guisubmenu +></menuchoice +>. Il modulo di autoindentazione mette a disposizione la funzione <menuchoice +><guimenu +>Strumenti</guimenu +><guimenuitem +>Allinea</guimenuitem +></menuchoice +> che ricalcola l'indentazione della riga selezionata o di quella corrente. In questo modo puoi indentare nuovamente il documento selezionando tutto il testo e attivando tale azione.</para> + +<para +>Tutte le modalità di indentazione usano le impostazioni relative all'indentazione per il documento corrente.</para> + +<tip +><para +>Puoi impostare tutti i tipi di variabili di configurazione, comprese quelle relative all'indentazione, tramite le <link linkend="config-variables" +>variabili dei documenti</link +> e i <link linkend="config-dialog-editor-filetypes" +>tipi di file</link +>.</para +></tip> + +<variablelist> + +<title +>Modalità di autoindentazione disponibili</title> + +<varlistentry> +<term +>Nessuno</term> +<listitem +><para +>Questa modalità disabilita completamente l'indentazione.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Normale</term> +<listitem +><para +>Questa modalità si limita a mantenere l'indentazione simile a quella della riga precedente con contenuto diverso da spazi e separatori. Puoi combinarne l'utilizzo con quello delle azioni di indentazione e di rimozione dell'indentazione per indentare come meglio credi. </para +></listitem> +</varlistentry> + +<varlistentry +><term +>Stile C</term> +<listitem +><para +>Un sistema d'indentazione per il linguaggio C ed altri linguaggi analoghi come C++, C#, Java, JavaScript e così via. Questo sistema non funziona per linguaggi di scripting come Perl o PHP.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Stile C SS</term> +<listitem +><para +>Un sistema d'indentazione alternativo per il linguaggio C ed altri linguaggi simili, con gli stessi vincoli.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Stile Python</term> +<listitem +><para +>Un sistema d'indentazione specifico per il linguaggio di scripting Python. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +>XML</term> +<listitem +><para +>Un indentatore automatico molto interessante per XML. Per quanto sia allettante, non cercare di utilizzarlo con dialetti HTML diversi da XHTML, perché fallisce con i tag HTML vecchio stile (tag aperti come ad esempio <br>)</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Indentatore variabile</term> +<listitem> + +<note> +<para +>L'indentatore variabile è sperimentale, e potrebbe cambiare il suo comportamento o sparire in una prossima versione.</para> +</note> + +<para +>L'indentatore variabile è speciale nel senso che può essere configurato tramite le variabili del documento (o la configurazione del tipo di file). Vengono lette le seguenti variabili: <variablelist> +<varlistentry> +<term +>var-indent-indent-after</term> +<listitem> +<para +>Un'espressione regolare che fa sì che una riga sia indentata di una unità, se la prima riga tra le successive non composta di soli spazi bianchi e separatori corrisponde. var-indent-indent: Un'espressione regolare che fa sì che la riga che corrisponde sia indentata di una unità.</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>var-indent-unindent</term> +<listitem> +<para +>Un'espressione regolare che fa sì che venga tolta l'indentazione di una unità dalla riga che corrisponde.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>var-indent-triggerchars</term> +<listitem> +<para +>Una lista di caratteri che, se digitati, causa il ricalcolo immediato dell'indentazione.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>var-indent-handle-couples</term> +<listitem> +<para +>Una lista di insiemi di parentesi da gestire. Ogni combinazione di parentesi tonde, quadre o graffe. Ogni tipo di insieme è gestito nel seguente modo: se ve ne sono istanze aperte non corrispondenti nella riga precedente, viene aggiunta un'unità di indentazione; se vi sono delle istanze chiuse non corrispondenti nella riga corrente, viene rimossa un'unità di indentazione.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><literal +>var-indent-couple-attribute</literal +></term> +<listitem> +<para +>Quando vengono cercate coppie aperte/chiuse non corrispondenti, sono considerati solo i caratteri con questo attributo. Il valore deve essere il nome dell'attributo del file di sintassi xml, ad esempio "Symbol". Se non è specificato, verrà usato l'attributo 0 (normalmente 'Normal Text').</para> +</listitem> +</varlistentry> + +</variablelist> + +</para +></listitem> +</varlistentry> + +</variablelist> + +</sect1> + +</chapter> diff --git a/tde-i18n-it/docs/tdebase/kate/plugins.docbook b/tde-i18n-it/docs/tdebase/kate/plugins.docbook new file mode 100644 index 00000000000..67de00c2bf8 --- /dev/null +++ b/tde-i18n-it/docs/tdebase/kate/plugins.docbook @@ -0,0 +1,39 @@ +<chapter id="plugins"> + +<chapterinfo> +<authorgroup> +<author +>&Anders.Lund; &Anders.Lund.mail;</author> +<othercredit role="translator" +><firstname +>Nicola</firstname +> <surname +>Ruggero</surname +> <affiliation +><address +><email +>nicola@nxnt.org</email +></address +></affiliation +><contrib +>Traduzione della documentazione.</contrib +></othercredit +> +</authorgroup> +</chapterinfo> + +<title +>Lavorare con i plugin</title> + +<para +>Kate usa due forme diverse di plugin: i plugin per l'applicazione &kate; e i plugin per il componente dell'editor di &kate;. Quest'ultimi sono disponibili per qualsiasi applicazione faccia uso del componente dell'editor, come KDevelop, Quanta, Kile, Kwrite e molte altre. I plug per l'applicazione invece sono specifici per l'applicazione &kate;.</para> + +<para +>Puoi abilitare entrambi i tipi di plugin nella <link linkend="configuring-kate-configdialog" +>finestra di configurazione</link +>, che fornisce inoltre l'accesso alle opzioni di configurazione aggiuntive per i plugin che le richiedano.</para> + +<para +>Ci sono vari plugin per diversi scopi disponibili nel modulo tdeaddons e puoi trovarne degli altri cercando nel web. Alcuni di questi sono distribuiti assieme al componente dell'editor. Ad esempio: il completamento parole, i segnalibri automatici, l'inserimento file, i sinonimi, il controllo ortografico e la ricerca incrementale.</para> + +</chapter> diff --git a/tde-i18n-it/docs/tdebase/kate/regular-expressions.docbook b/tde-i18n-it/docs/tdebase/kate/regular-expressions.docbook new file mode 100644 index 00000000000..df033ac45b8 --- /dev/null +++ b/tde-i18n-it/docs/tdebase/kate/regular-expressions.docbook @@ -0,0 +1,1216 @@ +<appendix id="regular-expressions"> +<appendixinfo> +<authorgroup> +<author +>&Anders.Lund; &Anders.Lund.mail;</author> +<othercredit role="translator" +><firstname +>Luciano</firstname +><surname +>Montanaro</surname +><affiliation +><address +><email +>mikelima@cirulla.net</email +></address +></affiliation +><contrib +>Traduzione</contrib +></othercredit +> +</authorgroup> +</appendixinfo> + +<title +>Le espressioni regolari</title> + +<synopsis +>Questa appendice contiene un'essenziale introduzione al mondo delle <emphasis +>espressioni regolari</emphasis +>. Documenta le espressioni regolari nella froma disponibile in &kate;, che non è compatibile con quella di perl né con quella disponibile, per esempio, in <command +>grep</command +>.</synopsis> + +<sect1> + +<title +>Introduzione</title> + +<para +>Le <emphasis +>espressioni regolari</emphasis +> forniscono un modo di descrivere il contenuto richiesto di una stringa di testo in modo comprensibile dal software, al fine di verificare se una sequenza di testo corrisponde al modello fornito, e, nel caso di applicazioni avanzate, permettono di memorizzare parti del testo corrispondenti.</para> + +<para +>Un esempio: diciamo che vuoi cercare nel testo tutti i paragrafi che iniziano per uno dei nomi <quote +>Henrik</quote +> o <quote +>Pernille</quote +> seguito da qualche forma del verbo <quote +>say</quote +>.</para> + +<para +>Con una ricerca normale, cominceresti con la ricerca del primo nome, <quote +>Henrik</quote +>, magari seguito da <quote +>sa</quote +>, così: <userinput +>Henrik sa</userinput +>, ed esaminando le corrispondenze, dovresti scartare tutte quelle in cui non si trovano all'inizio di un paragrafo, oltre a quelle in cui le parole che iniziano per <quote +>sa</quote +> non sono né <quote +>says</quote +> né <quote +>said</quote +>. E tutto ciò dovrà essere ripetuto con l'altro nome...</para> + +<para +>Con le espressioni regolari questo compito può essere svolto con una sola ricerca, e con una precisione più elevata.</para> + +<para +>Per farlo, le espressioni regolari definiscono regole per esprimere nel dettaglio una generalizzazione di una stringa da confrontare. Il nostro esempio, che potremmo esprimere in questo modo: <quote +>Una riga che inizia con <quote +>Henrik</quote +> o <quote +>Pernille</quote +> (forse preceduti da fino a quattro caratteri di spazio o tabulazione) seguiti da un carattere di spaziatura seguito da <quote +>sa</quote +> e poi o <quote +>ys</quote +> o <quote +>id</quote +></quote +>, può essere espresso con la seguente espressione regolare:</para +> <para +><userinput +>^[ \t]{0,4}(Henrik|Pernille) sa(ys|id)</userinput +></para> + +<para +>L'esempio appena introdotto dimostra i quattro concetti alla base delle espressioni regolari moderne, cioè:</para> + +<itemizedlist> +<listitem +><para +>I modelli</para +></listitem> +<listitem +><para +>Le asserzioni</para +></listitem> +<listitem +><para +>I quantificatori</para +></listitem> +<listitem +><para +>I riferimenti all'indietro</para +></listitem> +</itemizedlist> + +<para +>Il carattere di accento circonflesso (<literal +>^</literal +>) che appare all'inizio dell'espressione è un'asserzione, che è vera solo se il resto della stringa da confrontare è all'inizio di una riga.</para> + +<para +>Le stringhe <literal +>[ \t]</literal +> e <literal +>(Henrik|Pernille) sa(ys|id)</literal +> sono modelli. Il primo è una <emphasis +>classe di caratteri</emphasis +> che corrisponde un carattere di spazio o di tabulazione (orizzontale); l'altro modello contiene prima un sotto-modello che corrisponde a <literal +>Henrik</literal +> <emphasis +>o</emphasis +> <literal +>Pernille</literal +>, poi un gruppo di caratteri che corrisponde letteralmente a <literal +> sa</literal +> ed infine un sotto-modello che corrisponde a <literal +>ys</literal +> <emphasis +>o</emphasis +> <literal +>id</literal +></para> + +<para +>La sequenza <literal +>{0,4}</literal +> è un quantificatore che indica <quote +>da zero a quattro ripetizioni dell'espressione precedente</quote +>.</para> + +<para +>Poiché il software per le espressioni regolari che gestisce il concetto di <emphasis +>riferimento all'indietro</emphasis +> salva l'intera sequenza di caratteri che corrisponde al modello, oltre ai sottomodelli racchiusi fra parentesi, se ci fosse modo di accedere a tali riferimenti, potremmo mettere le mani sull'intero testo corrispondente al modello (in caso di ricerca di un'espressione regolare in un editor di testo, la corrispondenza è indicata come selezionata) oppure il nome trovato, o l'ultima parte del verbo.</para> + +<para +>Nell'insieme, l'espressione corrisponderà a quello che vogliamo, e solo a quello.</para> + +<para +>Le sezioni seguenti descriveranno in dettaglio come costruire e usare i modelli, le classi di caratteri, le asserzioni, i quantificatori ed i riferimenti all'indietro, e la sezione finale fornirà qualche utile esempio.</para> + +</sect1> + +<sect1 id="regex-patterns"> + +<title +>I modelli</title> + +<para +>I modelli consistono di sequenze di caratteri letterali e di classi di caratteri. I modelli possono contenere sotto-modelli, che sono modelli racchiusi fra parentesi.</para> + +<sect2> +<title +>I caratteri speciali</title> + +<para +>Nei modelli così come nelle classi di caratteri, alcuni caratteri hanno un significato speciale. Perché corrispondano letteralmente ad uno di questi caratteri bisogna indicarne l'interpretazione letterale al software di gestione delle espressioni regolari.</para> + +<para +>Ciò si fa inserendo come prefisso del carattere una barra inversa (<literal +>\</literal +>).</para> + + +<para +>Il software di gestione delle espressioni regolari ignora in silenzio l'uso di un carattere di escape prima di un carattere senza particolari significati, quindi se viene anteposto, ad esempio, a <quote +>j</quote +> (<userinput +>\j</userinput +>) non è dannoso. Se hai dei dubbi sul fatto che un dato carattere possa avere significati speciali, puoi anteporvi il carattere di escape per sicurezza.</para> + +<para +>Per inserire un carattere di barra inversa devi ripetere il carattere stesso, scrivendo <userinput +>\\</userinput +>.</para> + +</sect2> + +<sect2> +<title +>Classi di caratteri e abbreviazioni</title> + +<para +>Una <emphasis +>classe di caratteri</emphasis +> è un'espressione regolare che corrisponde ad uno di un gruppo di caratteri particolare. Nelle espressioni regolari, le classi di caratteri sono definite inserendo i caratteri legali per la classe fra parentesi quadre, <literal +>[]</literal +>, o usando una delle classi predefinite descritte più avanti.</para> + +<para +>Classi di caratteri semplici contengono solo uno o più caratteri letterali, come ad esempio <userinput +>[abc]</userinput +> (che corrisponde ad una delle lettere <quote +>a</quote +>, <quote +>b</quote +> o <quote +>c</quote +>) o <userinput +>[0123456789]</userinput +> (che corrisponde ad una delle cifre decimali).</para> + +<para +>Poiché le lettere e i numeri hanno un ordine logico, puoi abbreviare le definizioni delle classi che li contengono specificando degli intervalli: <userinput +>[a-c]</userinput +> è equivalente a <userinput +>[abc] e </userinput +>[0-9] equivale a scrivere <userinput +>[0123456789]</userinput +>. Sono ammesse anche le combinazioni di questi costrutti, ad esempio, <userinput +>[a-fynot1-38]</userinput +> corrisponde ad un carattere fra <quote +>a</quote +>, <quote +>b</quote +>, <quote +>c</quote +>, <quote +>d</quote +>, <quote +>e</quote +>, <quote +>f</quote +>, <quote +>y</quote +>, <quote +>n</quote +>, <quote +>o</quote +>, <quote +>t</quote +>, <quote +>1</quote +>, <quote +>2</quote +>,<quote +>3</quote +> e <quote +>8</quote +>.</para> + +<para +>Poiché le lettere maiuscole vengono distinte da quelle minuscole, per creare una classe di caratteri che corrisponda ad <quote +>a</quote +> o <quote +>b</quote +> senza distinguere fra maiuscole e minuscole devi scrivere <userinput +>[aAbB]</userinput +>.</para> + +<para +>È anche possibile creare una classe di caratteri <quote +>negativa</quote +>, che corrisponde dove un qualunque carattere tranne quelli elencati è presente. Per far ciò inserisci un carattere di accento circonflesso <quote +>^</quote +> all'inizio della classe: </para> + +<para +><userinput +>[^abc]</userinput +> corrisponderà ad un carattere qualsiasi <emphasis +>che non sia</emphasis +> <quote +>a</quote +>, <quote +>b</quote +> o <quote +>c</quote +>.</para> + +<para +>Oltre ai caratteri letterali sono definite alcune abbreviazioni che rendono la vita un po' più semplice: <variablelist> + +<varlistentry> +<term +><userinput +>\a</userinput +></term> +<listitem +><para +>Questo corrisponde al carattere <quote +>campanella</quote +> <acronym +>ASCII</acronym +> (BEL, 0x07).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\f</userinput +></term> +<listitem +><para +>Corrisponde al carattere di avanzamento carta <acronym +>ASCII</acronym +> (FF, 0x0C).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\n</userinput +></term> +<listitem +><para +>Corrisponde al carattere <acronym +>ASCII</acronym +> di avanzamento riga (LF, 0x0A, newline in Unix).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\r</userinput +></term> +<listitem +><para +>Corrisponde al carattere <acronym +>ASCII</acronym +> ritorno carrello (CR, 0x0D).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\t</userinput +></term> +<listitem +><para +>Corrisponde ad un carattere <acronym +>ASCII</acronym +> di tabulazione orizzontale (HT, 0x09).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\v</userinput +></term> +<listitem +><para +>Corrisponde ad un carattere <acronym +>ASCII</acronym +> di tabulazione verticale (VT, 0x0B).</para +></listitem> +</varlistentry> +<varlistentry> +<term +><userinput +>\xhhhh</userinput +></term> + +<listitem +><para +>Questo corrisponde ad un carattere Unicode che ha la rappresentazione esadecimale hhhh (tra 0x0000 e 0xFFFF). \Oooo (&ie; \zero ooo) corrisponde al carattere <acronym +>ASCII</acronym +>/Latin-1 rappresentato dal numero ottale 000 (compreso tra 0 e 0377).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>.</userinput +> (punto)</term> +<listitem +><para +>Corrisponde ad un carattere qualsiasi (anche ad un <quote +>nuova riga</quote +>).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\d</userinput +></term> +<listitem +><para +>Questo corrisponde ad una cifra decimale. È lo stesso di <literal +>[0-9]</literal +></para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\D</userinput +></term> +<listitem +><para +>Corrisponde ad un carattere non numerico. Equivale a <literal +>[^0-9]</literal +> o <literal +>[^\d]</literal +></para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\s</userinput +></term> +<listitem +><para +>Corrisponde ad un carattere di spaziatura. Equivale a <literal +>[ \t\n\r]</literal +></para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\S</userinput +></term> +<listitem +><para +>Corrisponde ad un carattere che non è di spaziatura. Equivale a <literal +>[^ \t\n\r]</literal +> ed è uguale a <literal +>[^\s]</literal +></para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\w</userinput +></term> +<listitem +><para +>Corrisponde ad un <quote +>carattere di parola</quote +> - in questo caso a qualsiasi lettera o numero. Nota che il carattere di sottolineatura (<literal +>_</literal +>) non viene considerato un carattere di parola, come succede nelle espressioni regolari di perl. È uguale a <literal +>[a-zA-Z0-9]</literal +></para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\W</userinput +></term> +<listitem +><para +>Corrisponde ad un <quote +>carattere di non-parola</quote +> - qualsiasi carattere che non sia una lettera o un numero. Equivale a <literal +>[^a-zA-Z0-9]</literal +> o a <literal +>[^\w]</literal +></para +></listitem> +</varlistentry> + + +</variablelist> + +</para> + +<para +>Le classi abbreviate possono essere inserite all'interno di classi personalizzate, ad esempio per richiedere la corrispondenza di n carattere di parola, di uno spazio o di un punto, puoi scrivere <userinput +>[\w \.]</userinput +></para +> + +<note +> <para +>La notazione POSIX per le classi, <userinput +>[:<nomeclasse>]</userinput +> non è al momento supportata.</para +> </note> + +<sect3> +<title +>Caratteri con un significato speciale all'interno delle classi di caratteri</title> + +<para +>I seguenti caratteri hanno un significato particolare all'interno del costrutto <quote +>[]</quote +> delle classi di caratteri, e devono essere preceduti dal carattere di escape per essere inclusi letteralmente in una classe:</para> + +<variablelist> +<varlistentry> +<term +><userinput +>]</userinput +></term> +<listitem +><para +>Termina la classe di caratteri. Deve essere preceduto dal carattere di escape a meno che non sia esattamente il primo della classe (può seguire un carattere <quote +>^</quote +>, che indica la negazione della classe)</para +></listitem> +</varlistentry> +<varlistentry> +<term +><userinput +>^</userinput +> (simbolo di accento circonflesso)</term> +<listitem +><para +>Denota una classe negativa, se è il primo carattere. Deve essere preceduto dal carattere di escape se deve corrispondere letteralmente se è il primo carattere della classe.</para +></listitem +> +</varlistentry> +<varlistentry> +<term +><userinput +>-</userinput +> (trattino)</term> +<listitem +><para +>Denota un intervallo logico di caratteri. Deve sempre essere preceduto dal carattere di escape per essere interpretato alla lettera in una classe di caratteri.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><userinput +>\</userinput +> (barra inversa)</term> +<listitem +><para +>Il carattere di escape. Deve sempre essere raddoppiato per essere interpretato letteralmente.</para +></listitem> +</varlistentry> + +</variablelist> + +</sect3> + +</sect2> + +<sect2> + +<title +>Alternative: corrispondenza del tipo <quote +>uno fra</quote +></title> + +<para +>Se vuoi controllare se il testo corrisponde ad uno fra una serie di modelli alternativi, puoi separare ciascuna alternativa con un carattere <literal +>|</literal +> (barra verticale).</para> + +<para +>Ad esempio, per trovare uno fra <quote +>John</quote +> ed <quote +>Harry</quote +>, devi usare l'espressione <userinput +>John|Harry</userinput +>.</para> + +</sect2> + +<sect2> + +<title +>I sotto-modelli</title> + +<para +>I <emphasis +>sotto-modelli</emphasis +> sono modelli racchiusi fra parentesi, ed hanno molti usi nel mondo delle espressioni regolari.</para> + +<sect3> + +<title +>Specificare delle alternative</title> + +<para +>Puoi usare un sotto-modello per raggruppare un insieme di alternative all'interno di un modello più grande. Le alternative sono separate dal carattere <quote +>|</quote +> (barra verticale).</para> + +<para +>Ad esempio per cercare una parola fra <quote +>int</quote +>, <quote +>float</quote +> e <quote +>double</quote +>, puoi usare il modello <userinput +>int|float|double</userinput +>. Se vuoi trovare la parole solo se è seguita da un po' di spazi e delle lettere, inserisci le alternative in un sotto-modello: <userinput +>(int|float|double)\s+\w+</userinput +>.</para> + +</sect3> + +<sect3> + +<title +>Cattura del testo corrispondente (riferimenti all'indietro)</title> + +<para +>Se vuoi usare un riferimento all'indietro, usa un sotto-modello per fare in modo che la sezione che ti interessa del modello sia ricordata.</para> + +<para +>Per esempio, se vuoi trovare due ripetizioni della stessa parola separate da una virgola ed eventualmente da qualche spazio bianco, puoi scrivere <userinput +>(\w+),\s*\1</userinput +>. Il sottomodello <userinput +>\w+</userinput +> troverà una sequenza di caratteri di parola, e l'intera espressione corrisponderà se gli stessi caratteri saranno seguiti da una virgola, zero o più caratteri di spaziatura, e da un'identica sequenza di caratteri di parola (La stringa <literal +>\1</literal +> si riferisce al <emphasis +>primo sottomodello racchiuso fra parentesi</emphasis +>).</para> + +<!-- <para +>See also <link linkend="backreferences" +>Back references</link +>.</para +> --> + +</sect3> + +<sect3 id="lookahead-assertions"> +<title +>Asserzioni di lookahead</title> + +<para +>Un'asserzione di lookahead è un sotto-modello che inizia con <literal +>?=</literal +> o <literal +>?!</literal +>.</para> + +<para +>Per esempio per trovare la stringa letterale <quote +>Bill</quote +> ma solo se non è seguita da <quote +> Gates</quote +>, puoi usare questa espressione: <userinput +>Bill(?! Gates)</userinput +>. Verrà trovato <quote +>Bill Clinton</quote +> ed anche <quote +>Billy the kid</quote +>, ma verranno ignorate silenziosamente le altre corrispondenze.)</para> + +<para +>I sotto-modelli usati per le asserzioni non sono catturati.</para> + +<para +>Vedi anche <link linkend="assertions" +>Le asserzioni</link +></para> + +</sect3> + +</sect2> + +<sect2 id="special-characters-in-patterns"> +<title +>Caratteri con un significato speciali in un modello</title> + +<para +>I seguenti caratteri hanno un significato all'interno di un modello, e devi farli precedere da un carattere di escape se devi controllarne la presenza letterale: <variablelist> + +<varlistentry> +<term +><userinput +>\</userinput +> (barra inversa)</term> +<listitem +><para +>Il carattere di escape.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>^</userinput +> (simbolo di accento circonflesso)</term> +<listitem +><para +>Asserisce l'inizio della stringa.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>$</userinput +></term> +<listitem +><para +>Asserisce la fine della stringa.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>()</userinput +> (parentesi aperta e chiusa)</term> +<listitem +><para +>Denotano un sotto-modello.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>{}</userinput +> (parentesi graffe aperta e chiusa)</term> +<listitem +><para +>Denotano quantificatori numerici.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>[]</userinput +> (parentesi quadre aperta e chiusa)</term> +<listitem +><para +>Denotano classi di caratteri.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>|</userinput +> (barra verticale)</term> +<listitem +><para +>OR logico. Separa le alternative.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>+</userinput +> (segno più)</term> +<listitem +><para +>Quantificatore, uno o più.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>*</userinput +> (asterisco)</term> +<listitem +><para +>Quantificatore, zero o più.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>?</userinput +> (punto interrogativo)</term> +<listitem +><para +>Carattere facoltativo. Può essere interpretato come un quantificatore, zero o uno.</para +></listitem> +</varlistentry> + +</variablelist> + +</para> + +</sect2> + +</sect1> + +<sect1 id="quantifiers"> +<title +>Quantificatori</title> + +<para +>I <emphasis +>quantificatori</emphasis +> permettono a un'espressione regolare di corrispondere ad un numero specificato di caratteri o di caratteri di una classe, o di sotto-modelli.</para> + +<para +>I quantificatori sono racchiusi da parentesi graffe (<literal +>{</literal +> e <literal +>}</literal +>) ed hanno la forma generale <literal +>{[ripetizioni-minime][,[ripetizioni-massime]]}</literal +> </para> + +<para +>L'uso è spiegato meglio con degli esempi: <variablelist> + +<varlistentry> +<term +><userinput +>{1}</userinput +></term> +<listitem +><para +>Esattamente una ripetizione</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>{0,1}</userinput +></term> +<listitem +><para +>Zero o una ripetizione</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>{,1}</userinput +></term> +<listitem +><para +>La stessa cosa, ma con meno lavoro...</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>{5,10}</userinput +></term> +<listitem +><para +>Almeno cinque ripetizioni, ma meno di dieci.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>{5,}</userinput +></term> +<listitem +><para +>Almeno cinque ripetizioni, nessun massimo.</para +></listitem> +</varlistentry> + +</variablelist> + +</para> + +<para +>Inoltre esistono alcune abbreviazioni: <variablelist> + +<varlistentry> +<term +><userinput +>*</userinput +> (asterisco)</term> +<listitem +><para +>simile a <literal +>{0,}</literal +>, trova un numero qualsiasi di ripetizioni.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>+</userinput +> (segno più)</term> +<listitem +><para +>simile a <literal +>{1,}</literal +>, almeno una presenza.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>?</userinput +> (punto interrogativo)</term> +<listitem +><para +>simile a <literal +>{0,1}</literal +>, presente al massimo una volta.</para +></listitem> +</varlistentry> + +</variablelist> + +</para> + +<sect2> + +<title +>Ingordigia</title> + +<para +>Quando si usano quantificatori senza massimo, le espressioni regolari cercano normalmente di adattarsi all'estensione più lunga di caratteri della stringa esaminata, comportamento normalmente noto come <emphasis +>ingordigia</emphasis +>.</para> + +<para +>IL software per le espressioni regolari moderno fornisce dei metodi per <quote +>eliminare l'ingordigia</quote +>, sebbene in un ambiente grafico dipende dall'interfaccia il metodo di accesso a questa funzione. Per esempio una finestra di ricerca che permette l'uso di espressioni regolari, potrebbe avere una casella marcata <quote +>Corrispondenza minimale</quote +>, e dovrebbe indicare se l'ingordigia è il comportamento predefinito.</para> + +</sect2> + +<sect2> +<title +>Esempi in contesto</title> + +<para +>Ecco alcuni esempi che usano quantificatori</para> + +<variablelist> + +<varlistentry> +<term +><userinput +>^\d{4,5}\s</userinput +></term> +<listitem +><para +>Corrisponde ai numeri in <quote +>1234 vai</quote +> e <quote +>12345 ora</quote +>, ma non a <quote +>567 undici</quote +> né a <quote +>223459 qualcosa</quote +></para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\s+</userinput +></term> +<listitem +><para +>Corrisponde ad uno o più caratteri di spaziatura</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>(bla){1,}</userinput +></term> +<listitem +><para +>Corrisponde a tutta la stringa <quote +>blablabla</quote +> e a <quote +>bla</quote +> in <quote +>blasone</quote +> o <quote +>cablato</quote +></para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>/?></userinput +></term> +<listitem +><para +>Corrisponde a <quote +>/></quote +> in <quote +><closeditem/></quote +> ed anche a <quote +>></quote +> in <quote +><openitem></quote +>.</para +></listitem> +</varlistentry> + +</variablelist> + +</sect2> + +</sect1> + +<sect1 id="assertions"> +<title +>Le asserzioni</title> + +<para +>Le <emphasis +>asserzioni</emphasis +> permettono ad un'espressione regolare di corrispondere solo a certe condizioni.</para> + +<para +>Un'asserzione non corrisponde necessariamente a un carattere, piuttosto impone delle restrizioni sulle condizioni della possibile corrispondenza prima di riconoscerla. Ad esempio l'asserzione <emphasis +>confine parola</emphasis +> non cerca di trovare un carattere non-parola di fianco ad uno di parola, si assicura solo che non ci sia un carattere parola. Quindi l'asserzione corrisponde dove non c'è un carattere, &ie; alla fine della stringa in esame.</para> + +<para +>Alcune asserzioni hanno effettivamente modelli da confrontare, ma la parte di stringa a cui corrispondono non faranno parte del risultato del confronto dell'espressione regolare intera.</para> + +<para +>Le espressioni regolari qui documentate permettono di usare le seguenti asserzioni: <variablelist> + +<varlistentry +> +<term +><userinput +>^</userinput +> (caret: inizio stringa)</term +> +<listitem +><para +>Corrisponde all'inizio della stringa vagliata.</para +> <para +>L'espressione <userinput +>^Peter</userinput +> corrisponderà a <quote +>Peter</quote +> Nella stringa <quote +>Peter, hey!</quote +> ma non in <quote +>Hey, Peter!</quote +> </para +> </listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>$</userinput +> (fine della stringa)</term> +<listitem +><para +>Corrisponde alla fine della stringa vagliata.</para> + +<para +>L'espressione <userinput +>you\?$</userinput +> corrisponde all'ultimo you della frase <quote +>You didn't do that, did you?</quote +> man non a <quote +>You didn't do that, right?</quote +></para> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\b</userinput +> (confine parola)</term> +<listitem +><para +>Corrisponde se c'è un carattere di parola su un lato ed un carattere che non fa parte di una parola sull'altro.</para> +<para +>È utile per trovare le estremità di una parola. Come esempio, all'espressione <userinput +>\bin\b</userinput +> corrisponde l'<quote +>in</quote +> in <quote +>He came in through the window</quote +>, ma non l'<quote +>in</quote +> di <quote +>window</quote +>.</para +></listitem> + +</varlistentry> + +<varlistentry> +<term +><userinput +>\B</userinput +> (non confine parola)</term> +<listitem +><para +>Corrisponde a tutto quello che non corrisponde a <quote +>\b</quote +>.</para> +<para +>Ciò significa che corrisponderà ad esempio all'interno di parole: L'espressione <userinput +>\Bin\B</userinput +> corrisponde in <quote +>window</quote +> ma non in <quote +>integer</quote +> o in <quote +>I'm in love</quote +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>(?=MODELLO)</userinput +> (Lookahead positivo)</term> +<listitem +><para +>Un'asserzione di lookahead controlla la parte della stringa che segue una potenziale corrispondenza. Il lookahead positivo impedirà che la stringa corrisponda se il testo che segue non corrisponde al <emphasis +>MODELLO</emphasis +> dell'asserzione, ma il testo a cui corrisponde non sarà incluso nel risultato.</para> +<para +>L'espressione <userinput +>handy(?=\w)</userinput +> corrisponderà a <quote +>handy</quote +> in <quote +>handyman</quote +> ma non in <quote +>That came in handy!</quote +></para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>(?!MODELLO)</userinput +> (Lookahead negativo)</term> + +<listitem +><para +>Il lookahead negativo impedisce una potenziale corrispondenza se la parte seguente della stringa in esame non corrisponde al <emphasis +>MODELLO</emphasis +>.</para> +<para +>L'espressione <userinput +>const \w+\b(?!\s*&)</userinput +> corrisponde a <quote +>const char</quote +> nella stringa <quote +>const char* foo</quote +> mentre non corrisponde a <quote +>const QString</quote +> in <quote +>const QString& bar</quote +> perché <quote +>&</quote +> corrisponde al modello dell'asserzione di lookahead negativo.</para> +</listitem> +</varlistentry> + +</variablelist> + +</para> + +</sect1> + +<!-- TODO sect1 id="backreferences"> + +<title +>Back References</title> + +<para +></para> + +</sect1 --> + +</appendix> |