diff options
Diffstat (limited to 'tde-i18n-pl/docs/tdebase/kate')
20 files changed, 13667 insertions, 0 deletions
diff --git a/tde-i18n-pl/docs/tdebase/kate/Makefile.am b/tde-i18n-pl/docs/tdebase/kate/Makefile.am new file mode 100644 index 00000000000..6ed9a8a7d37 --- /dev/null +++ b/tde-i18n-pl/docs/tdebase/kate/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = pl +SUBDIRS = $(AUTODIRS) +KDE_DOCS = kate +KDE_MANS = AUTO diff --git a/tde-i18n-pl/docs/tdebase/kate/Makefile.in b/tde-i18n-pl/docs/tdebase/kate/Makefile.in new file mode 100644 index 00000000000..6ba9ef26641 --- /dev/null +++ b/tde-i18n-pl/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 = pl +#>- 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 unhighlighted.png index.docbook part.docbook highlighting.docbook menus.docbook configdialog01.png advanced.docbook regular-expressions.docbook highlighted.png Makefile.am kate.png mdi.docbook mimetypechooser.png index.cache.bz2 configdialog02.png + +#>+ 24 +index.cache.bz2: $(srcdir)/index.docbook $(KDE_XSL_STYLESHEET) configdialog02.png regular-expressions.docbook highlighted.png man-kate.1.docbook configdialog01.png part.docbook mdi.docbook index.docbook menus.docbook kate.png advanced.docbook mimetypechooser.png fundamentals.docbook configuring.docbook unhighlighted.png 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 configdialog02.png regular-expressions.docbook highlighted.png man-kate.1.docbook configdialog01.png part.docbook mdi.docbook index.docbook menus.docbook kate.png advanced.docbook mimetypechooser.png fundamentals.docbook configuring.docbook unhighlighted.png 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 configdialog02.png regular-expressions.docbook highlighted.png man-kate.1.docbook configdialog01.png part.docbook mdi.docbook index.docbook menus.docbook kate.png advanced.docbook mimetypechooser.png fundamentals.docbook configuring.docbook unhighlighted.png plugins.docbook highlighting.docbook ; do \ + rm -f $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/$$base ;\ + done + + +#>+ 5 +distdir-nls: + for file in configdialog02.png regular-expressions.docbook highlighted.png man-kate.1.docbook configdialog01.png part.docbook mdi.docbook index.docbook menus.docbook kate.png advanced.docbook mimetypechooser.png fundamentals.docbook configuring.docbook unhighlighted.png 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-pl/docs/tdebase/kate/advanced.docbook b/tde-i18n-pl/docs/tdebase/kate/advanced.docbook new file mode 100644 index 00000000000..7ac203ee660 --- /dev/null +++ b/tde-i18n-pl/docs/tdebase/kate/advanced.docbook @@ -0,0 +1,2320 @@ +<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 +>Suse</firstname +><surname +>Polska</surname +><affiliation +><address +><email +>suse@suse.pl</email +></address +></affiliation +><contrib +>Polskie tłumaczenie</contrib +></othercredit +> <othercredit role="translator" +><firstname +>Krzysztof</firstname +><surname +>Woźniak</surname +><affiliation +><address +><email +>wozniakk@ceti.pl</email +></address +></affiliation +><contrib +>Polskie tłumaczenie</contrib +></othercredit +> +</authorgroup> +</chapterinfo> +<title +>Zaawansowane narzędzia edycyjne</title> + +<sect1 id="advanced-editing-tools-comment"> + +<title +>Komentarz/Odkomentuj</title> + +<para +>Polecenia Komentarz i Odkomentuj dostępne z menu <guimenu +>Narzędzia</guimenu +> pozwalają na dodanie znaczników komentarza do zaznaczonego fragmentu tekstu (lub do bieżącego wiersza, gdy brak zaznaczenia). Bieżący format dokumentu musi obsługiwać możliwość komentowania tekstu.</para> + +<para +>Sposób komentowania jest określony w definicji reguł podświetlania składni. Jeżeli podświetlanie składni jest wyłączone, to polecenia Komentarz i Odkomentuj są nieaktywne. </para> + +<para +>Dla pewnych formatów dokumentów zdefiniowane są znaczniki komentowania wiersza, inne zaś zawierają znaczniki komentarzy jedno- i wielowierszowych. Jeżeli znaczniki komentarza wielowierszowego są niedostępne, to nie będzie się dało skomentować zaznaczenia nie zawierającego w sobie całości ostatniego wiersza.</para> + +<para +>Gdy dostępny jest znacznik komentarza dla całego wiersza kodu, to jego użycie jest preferowane, gdyż pozwala na uniknięcie problemów w przypadku zagnieżdżonych komentarzy.</para> + +<para +>Podczas usuwania znaczników komentarza nie należy zaznaczać tekstu nie będącego komentarzem. Jeżeli usuwany jest komentarz wielowierszowy z zaznaczenia, to wszystkie spacje znajdujące się poza znacznikami komentarza są ignorowane.</para> + +<para +><indexterm +><primary +>komentuj</primary +></indexterm +> Aby skomentować fragment tekstu należy użyć menu <menuchoice +><guimenu +>Narzędzia</guimenu +><guimenuitem +>Komentarz</guimenuitem +></menuchoice +>, lub skrótu klawiszowego <keycombo action="simul" +>&Ctrl;<keycap +>D</keycap +></keycombo +>.</para> + +<para +><indexterm +><primary +>odkomentuj</primary +></indexterm +> Aby usunąć znaczniki komentarza z wybranego fragmentu tekstu, należy użyć menu <menuchoice +><guimenu +>Narzędzia</guimenu +><guimenuitem +>Odkomentuj</guimenuitem +></menuchoice +>, lub skrótu klawiszowego <keycombo action="simul" +>&Ctrl; &Shift;<keycap +>D</keycap +></keycombo +>.</para> + +</sect1> + +<sect1 id="advanced-editing-tools-commandline"> +<title +>Linia poleceń edytora</title> + +<para +>Komponent edytora w &kate; zawiera wbudowaną linię poleceń, pozwalającą na sterowanie pracą bez pośrednictwa graficznego interfejsu użytkownika. Linia poleceń znajduje sią w dolnej części okna edytora, aby ją włączyć należy wybrać z menu: <menuchoice +><guimenu +>Widok</guimenu +><guimenuitem +>Przełącz do linii poleceń</guimenuitem +></menuchoice +> lub skorzystać ze skrótu klawiszowego (domyślnie jest to <keycombo action="simul" +><keycap +>F7</keycap +></keycombo +>). Zestaw poleceń dostępnych w linii poleceń edytora opisany został poniżej. Może on ulec rozszerzeniu przez zastosowanie wtyczek.</para> + +<para +>Naciśnięcie klawisza ENTER uruchamia wprowadzone polecenie. Komunikat wyświetlony w linii poleceń pokaże informacje o wynikach polecenia lub ewentualnym błędzie. Jeżeli linia poleceń została wyświetlona za pomocą klawisza <keycap +>F7</keycap +>, to schowa się ona automatycznie po kilku sekundach. Ponowne naciśnięcie klawisza <keycap +>F7</keycap +> usuwa komunikat i pozwala na wprowadzenie następnego polecenia.</para> + +<para +>Linia poleceń zawiera wbudowany system pomocy uruchamiany poleceniem <command +>help</command +>. Aby wyświetlić listę wszystkich dostępnych poleceń należy wpisać <command +>help list</command +>. Pomoc dotycząca wybranego polecenia dostępna jest po wpisaniu: <command +>help <replaceable +>polecenie</replaceable +></command +>.</para> + +<para +>Linia poleceń przechowuje historię poleceń pozwalając na ponowne użycie poleceń wcześniej już wpisanych. Dostęp i nawigacja w historii linii poleceń odbywa się za pomocą klawiszy strzałek <keycap +>w górę</keycap +> oraz <keycap +>w dół</keycap +>. Argumenty wywołanych z historii poleceń będą zaznaczone, pozwalając na łatwą ich zmianę.</para> + +<sect2 id="advanced-editing-tools-commandline-commands"> +<title +>Polecenia standardowe</title> + +<sect3 id="advanced-editing-tools-commandline-commands-configure"> +<title +>Polecenia konfiguracyjne edytora</title> + +<para +>Polecenia opisane poniżej dotyczą wbudowanego edytora i pozwalają na konfigurację bieżącego widoku i dokumentu. Może to być przydatne, gdy użytkownik chce wykorzystać ustawienia inne niż domyślne, np. dla automatycznych wcięć. </para> + +<variablelist> +<title +>Typy argumentów</title> + +<varlistentry> +<term +>BOOLEAN</term> +<listitem +><para +>Stosowane dla poleceń, które włączają lub wyłączają jakąś funkcję. Dopuszczalne wartości takiego argumentu to:<userinput +>on</userinput +>, <userinput +>off</userinput +>, <userinput +>true</userinput +>, <userinput +>false</userinput +>, <userinput +>1</userinput +> lub <userinput +>0</userinput +></para +></listitem> +</varlistentry> + +<varlistentry> +<term +>INTEGER</term> +<listitem +><para +>Liczba całkowita</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>STRING</term> +<listitem +><para +>Napis</para +></listitem> +</varlistentry> + +</variablelist> + +<variablelist> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-tab-width</command +><arg +>INTEGER szerokość</arg +></cmdsynopsis +></term> +<listitem +><para +>Ustawia szerokość tabulacji (w znakach) na wartość określoną przez argument <userinput +>szerokość</userinput +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-indent-width</command +><arg +>INTEGER szerokość</arg +></cmdsynopsis +></term> +<listitem +><para +>Ustawia szerokość wcięcia na wartość określoną przez argument <userinput +>szerokość</userinput +>. Polecenie odnosi się do trybu wcięć dokonywanych za pomocą znaku spacji.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-word-wrap-column</command +><arg +>INTEGER szerokość</arg +></cmdsynopsis +></term> +<listitem +><para +>Ustawia liczbę znaków w wierszu dla funkcji statycznego zawijania wyrazów na wartość określoną przez argument <userinput +>szerokość</userinput +>. Działa jedynie w przypadku włączonego automatycznego zawijania wyrazów.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-icon-border</command +><arg +>BOOLEAN włącz</arg +> </cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza wyświetlanie paska ikon.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-folding-markers</command +><arg +>BOOLEAN włącz</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza wyświetlanie paska znaczników zwijania kodu.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-line-numbers</command +><arg +>BOOLEAN włącz</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza wyświetlanie paska z numerami wierszy.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-replace-tabs</command +><arg +>BOOLEAN włącz</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza zastępowanie znaków tabulacji znakami spacji w trakcie pisania. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-remove-trailing-space</command +><arg +>BOOLEAN włącz</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza usuwanie spacji końcowych po przejściu kursorem do innego wiersza.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-show-tabs</command +><arg +>BOOLEAN włącz</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza wyświetlanie małej kropki w miejscu znaków tabulacji oraz spacji kończących wiersz.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-indent-spaces</command +><arg +>BOOLEAN włącz</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza generowanie wcięć za pomocą zdefiniowanej przez parametr <option +>indent-width</option +> liczby spacji, dla każdego poziomu wcięcia. Wyłączenie opcji przywraca stosowanie znaku tabulacji do generowania wcięć.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-mixed-indent</command +><arg +>BOOLEAN włącz</arg +></cmdsynopsis +></term> +<listitem +><para +>Włączenie tej opcji pozwala na jednoczesne użycie znaków tabulacji i spacji do generowania wcięć przez &kate;. Poziomy wcięć będą określane zgodnie z ustawieniami opcji <option +>indent-width</option +>, zaś wcięcia wielopoziomowe będą generowane za pomocą największej możliwej liczby znaków tabulacji.</para> +<para +>Po wykonaniu tego polecenia, dodatkowo włączona zostanie funkcja wcięć za pomocą spacji, a jeżeli szerokość wcięcia jest nieokreślona, to zostanie ustawiona na połowę wartości parametru <option +>tab-width</option +> określonego dla bieżącego dokumentu.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-word-wrap</command +><arg +>BOOLEAN włącz</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza funkcję dynamicznego zawijania wyrazów</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-replace-tabs-save</command +><arg +>BOOLEAN włącz </arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza zamienianie znaków tabulacji na spacje przed zapisaniem dokumentu.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-remove-trailing-space-save</command +><arg +>BOOLEAN włącz</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza usuwanie spacji kończących wiersze przed jego zapisaniem.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-indent-mode</command +><arg +>nazwa</arg +></cmdsynopsis +></term> +<listitem +><para +>Określa tryb automatycznych wcięć, możliwe <userinput +>nazwy</userinput +> trybów to: 'cstyle', 'csands', 'xml', 'python', 'varindent' oraz 'none'. Jeżeli wprowadzona nazwa jest nieznana to przyjęta zostanie wartość 'none'.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-highlight</command +><arg +>nazwa</arg +></cmdsynopsis +></term> +<listitem +><para +>Wybiera zestaw reguł podświetlania składni dla dokumentu. Argument musi określać nazwę istniejącej reguły podświetlania. Dostępne nazwy widoczne są w menu: <menuchoice +><guimenu +>Narzędzia</guimenu +><guisubmenu +>Podświetlenie</guisubmenu +></menuchoice +>. W trakcie wprowadzania polecenia, pojawi się pomocnicza lista automatycznego dopełniania nazwy.</para +></listitem> +</varlistentry> + +</variablelist> + +</sect3> + +<sect3 id="advanced-editing-tools-commandline-commands-edit"> +<title +>Polecenia edycyjne</title> + +<para +>Ich wykonanie modyfikuje bieżący dokument.</para> + +<variablelist> +<varlistentry> +<term +><cmdsynopsis +><command +>indent</command +></cmdsynopsis +></term> +<listitem +><para +>Generuje wcięcie w wybranych wierszach lub w bieżącym wierszu.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>unindent</command +></cmdsynopsis +></term> +<listitem +><para +>Usuwa wcięcie z zaznaczonego fragmentu lub bieżącego wiersza.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>cleanindent</command +></cmdsynopsis +></term> +<listitem +><para +>Wyrównuje wcięcia dla zaznaczonego fragmentu tekstu lub dla bieżącego wiersza, zgodnie z ustawionymi dla dokumentu regułami wcięć. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>comment</command +></cmdsynopsis +></term> +<listitem +><para +>Wprowadza znaczniki komentarza dla zaznaczonego fragmentu tekstu lub dla bieżącego wiersza, zgodnie z definicją reguł podświetlania składni wybraną dla bieżącego dokumentu.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>uncomment</command +></cmdsynopsis +></term> +<listitem +><para +>Usuwa znaczniki komentarza z zaznaczonego fragmentu tekstu lub bieżącego wiersza, zgodnie z definicją reguł podświetlania składni wybraną dla bieżącego dokumentu.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>kill-line</command +></cmdsynopsis +></term> +<listitem +><para +>Usuwa bieżący wiersz.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>replace</command +><arg +>wzorzec</arg +><arg +>zastąpienie</arg +></cmdsynopsis +></term> +<listitem +><para +>Zamienia tekst pasujący do napisu: <userinput +>wzorzec</userinput +> tekstem określonym w: <userinput +>zastąpienie</userinput +>. Jeżeli wzorzec lub zastąpienie zawiera spację, to oba argumenty należy podać w cudzysłowach (pojedynczych lub podwójnych). Jeżeli argument nie jest zamknięty w cudzysłowie, to pierwsze słowo traktowane jest jako <userinput +>wzorzec</userinput +>, a reszta tekstu jako <userinput +>zastąpienie</userinput +>. Jeżeli tekst <userinput +>zastąpienie</userinput +> nie zostanie podany, to każde wystąpienie <userinput +>wzorca</userinput +> zostanie usunięte.</para> +<para +>Parametry działania polecenia zamień mogą być dostosowywane poprzez dodanie dwukropka i jednej z dostępnych opcji. Polecenie przyjmuje wówczas postać: <userinput +>replace:opcja wzorzec zastąpienie</userinput +>. Dostępne są następujące opcje: <variablelist> + +<varlistentry> +<term +><userinput +>b</userinput +></term> +<listitem +><para +>Szuka tekstu wstecz.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>c</userinput +></term> +<listitem +><para +>Szuka począwszy od pozycji kursora.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>e</userinput +></term> +<listitem +><para +>Szuka w ramach zaznaczonego fragmentu.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>r</userinput +></term> +<listitem +><para +>Wykonuje polecenie szukania za pomocą wyrażenia regularnego. W przypadku użycia tej opcji, można w argumencie "zastąpienie" użyć parametru <userinput +>\N</userinput +>, gdzie N jest numerem podwyrażenia, które zostanie wstawione w zastępowanym tekście.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>s</userinput +></term> +<listitem +><para +>Szuka zwracając uwagę na wielkość liter.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>p</userinput +></term> +<listitem +><para +>Pyta się przed zastąpieniem kolejnego wystąpienia.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>w</userinput +></term> +<listitem +><para +>Szuka dopasowując tylko całe wyrazy.</para +></listitem> +</varlistentry> + +</variablelist> + +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>date</command +><arg +>format</arg +></cmdsynopsis +></term> +<listitem +><para +>Wprowadza do dokumentu bieżący czas i datę w formacie określonym przez: <userinput +>format</userinput +> lub w formacie <quote +>yyyy-MM-dd hh:mm:ss</quote +> gdy brak jest argumentu. Interpretacja treści argumentu <userinput +>format</userinput +> jest następująca: <informaltable +> <tgroup cols="2" +> <tbody> +<row +><entry +><literal +>d</literal +></entry +><entry +>Dzień podany jako liczba bez wiodącego zera (1-31).</entry +></row> +<row +><entry +><literal +>dd</literal +></entry +><entry +>Dzień podany jako liczba z wiodącym zerem (01-31).</entry +></row> +<row +><entry +><literal +>ddd</literal +></entry +><entry +>Skrót zlokalizowanej nazwy dnia (np. 'Pon'..'Nie').</entry +></row> +<row +><entry +><literal +>dddd</literal +></entry +><entry +>Pełna zlokalizowana nazwa dnia (np.: 'Poniedziałek'..'Niedziela').</entry +></row> +<row +><entry +><literal +>M</literal +></entry +><entry +>Miesiąc jako liczba bez wiodącego zera (1-12).</entry +></row> +<row +><entry +><literal +>MM</literal +></entry +><entry +>Miesiąc jako liczba z wiodącym zerem (01-12).</entry +></row> +<row +><entry +><literal +>MMM</literal +></entry +><entry +>Skrót zlokalizowanej nazwy miesiąca (np. 'Sty'..'Gru').</entry +></row> +<row +><entry +><literal +>yy</literal +></entry +><entry +>Rok - dwucyfrowo (00-99).</entry +></row> +<row +><entry +><literal +>yyyy</literal +></entry +><entry +>Rok zapisany jako 4 cyfry (1752-8000).</entry +></row> +<row +><entry +><literal +>h</literal +></entry +><entry +>Godzina, zapisana bez wiodącego zera (0..23 lub 1..12 przy wyświetlanym AM/PM).</entry +></row> +<row +><entry +><literal +>hh</literal +></entry +><entry +>Godzina, zapisana z wiodącym zerem (00..23 lub 01..12 przy wyświetlanym AM/PM).</entry +></row> +<row +><entry +><literal +>m</literal +></entry +><entry +>Minuta, bez wiodącego zera (0..59).</entry +></row> +<row +><entry +><literal +>mm</literal +></entry +><entry +>Minuta z wiodącym zerem (00..59).</entry +></row> +<row +><entry +><literal +>s</literal +></entry +><entry +>Sekunda bez wiodącego zera (0..59).</entry +></row> +<row +><entry +><literal +>ss</literal +></entry +><entry +>Sekunda z wiodącym zerem (00..59).</entry +></row> +<row +><entry +><literal +>z</literal +></entry +><entry +>Milisekunda bez wiodącego zera (0..999).</entry +></row> +<row +><entry +><literal +>zzz</literal +></entry +><entry +>Milisekunda z wiodącym zerem (000..999).</entry +></row> +<row +><entry +><literal +>AP</literal +></entry +><entry +>Wyświetla symbol "AM" lub "PM" w zależności od pory dnia.</entry +></row> +<row +><entry +><literal +>ap</literal +></entry +><entry +>Wyświetla symbol "am" lub "pm" w zależności od pory dnia.</entry +></row> + +</tbody> +</tgroup> +</informaltable> + +</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>char</command +><arg +>kod_znaku</arg +></cmdsynopsis +></term> +<listitem> +<para +>Polecenie pozwala na wstawianie do treści dokumentu znaku określonego przez wartość numeryczną w formie dziesiętnej, ósemkowej lub szesnastkowej.</para> + +<example> +<title +>Polecenie <command +>char</command +>, przykłady</title> + +<para +>Wpisanie: <userinput +>char 234</userinput +></para> +<para +>Wprowadzi do tekstu znak: <computeroutput +>ê</computeroutput +></para> +<para +>Wpisanie: <userinput +>char 0x1234</userinput +></para> +<para +>Wprowadzi do tekstu znak: <computeroutput +>ሴ</computeroutput +></para> +</example> + +</listitem> +</varlistentry> + +<varlistentry> +<term> +<indexterm +><primary +>zamień, w formacie "sed"</primary> +<secondary +>szukaj, w formacie "sed"</secondary +></indexterm> +<command +>s///[ig]</command +> <command +>%s///[ig]</command +></term> + +<listitem> +<para +>To polecenie wykonuje operację znajdź/zamień analogicznie jak program "sed". Polecenie działa dla bieżącego wiersza lub dla całego dokumentu (<command +>%s///</command +>).</para> + +<para +>Działanie polecenia polega na wyszukaniu w tekście <emphasis +>wzorca wyszukiwania</emphasis +> (określonego przez wyrażenie regularne pomiędzy pierwszym i drugim ukośnikiem). Po znalezieniu wzorca dopasowany tekst jest zamieniany na wyrażenie zawarte pomiędzy środkową i ostatnią częścią polecenia. Nawiasy we wzorcu wyszukiwania określają tzw.<emphasis +>odwołania zwrotne</emphasis +>, co oznacza iż program zapamiętuje wyszukany napis, który następnie może być użyty w definicji wyrażenia zastępującego. Odwołanie do zapamiętanego napisu odbywa się przez użycie <userinput +>\1</userinput +> dla pierwszego zestawu nawiasów, <userinput +>\2</userinput +> dla drugiego i tak dalej.</para> + +<para +>Wyszukiwanie w tekście nawiasów <literal +>(</literal +> lub <literal +>)</literal +> wymaga zastosowania sekwencji specjalnych, z użyciem znaku odwrotnego ukośnika. Nawiasy będą reprezentowane przez napisy: <userinput +>\(</userinput +> oraz <userinput +>\)</userinput +></para> + +<para +>Użycie znaku <userinput +>i</userinput +> na końcu wyrażenia spowoduje, iż przy wyszukiwaniu nie będzie uwzględniana wielkość liter. Jeżeli na końcu wyrażenia wprowadzone zostanie <userinput +>g</userinput +> spowoduje to zamienienie wszystkich wystąpień poszukiwanego wzorca (w innym wypadku zamienione zostanie tylko pierwsze wystąpienie).</para> + +<example> + +<title +>Zastępowanie tekstu w bieżącym wierszu</title> + +<para +>Wyobraźmy sobie komunikat kompilatora informujący o następującym błędzie w wierszu 3902 edytowanego kodu programu: Klasa: <classname +>myClass</classname +> nie jest zdefiniowana.</para> + +<para +>Zamiast przeszukiwania i edycji wiersza 3902, celem zamienienia złej nazwy klasy na poprawną (<classname +>MyClass</classname +>), wystarczy uruchomić linię poleceń, uruchomić polecenie <userinput +>s/myclass/MyClass/i</userinput +>, zapisać plik, a następnie już bez błędów skompilować program.</para> + +</example> + +<example> +<title +>Zastępowanie tekstu w całym dokumencie</title> + +<para +>Wyobraźmy sobie sytuację, że w trakcie edycji dokumentu, w którym często występuje napis <quote +>Pani Nowak</quote +> ktoś przychodzi i mówi, iż osoba ta wyszła za mąż za pana <quote +>Kowalskiego</quote +>. Należy oczywiście zamienić wszystkie wystąpienia <quote +>Pani Nowak</quote +> na <quote +>Pani Kowalska</quote +>.</para> + +<para +>W linii poleceń wystarczy wprowadzić:<userinput +>%s/Pani Nowak/Pani Kowalska/</userinput +> i po naciśnięciu ENTER wszystko już będzie w porządku.</para> + +</example> + +<example> +<title +>Przykłady zaawansowane</title> + +<para +>W tym przykładzie zastosowano <emphasis +>odwołanie zwrotne</emphasis +> oraz mechanizm <emphasis +>klas znaków</emphasis +> (więcej informacji na ten temat znajduje się we wspomnianej poniżej dokumentacji).</para> + +<para +>Dokument zawiera następujący wiersz kodu: <programlisting +>void MyClass::DoStringOps( String &foo, String &bar, String *p, int &a, int &b )</programlisting> +</para> +<para +>Konieczne jest dodanie operatora <constant +>const</constant +> do wszystkich argumentów określonych przez <quote +>referencję</quote +> (reprezentowanych przez znak & na początku nazwy argumentu). Dodatkowo trzeba ujednolicić odstępy między słowami tak, aby była to tylko jedna spacja).</para> + +<para +>Po uruchomieniu linii poleceń, należy wpisać: <userinput +>s/\s+(\w+)\s+(&)/ const \1 \2/g</userinput +> i nacisnąć ENTER. Znak <userinput +>g</userinput +> na końcu wyrażenia wymusza ponowną kompilacją wyrażenia regularnego po każdym dopasowaniu wyrażenia w tekście, co jest wymagane do poprawnego działania mechanizmu <emphasis +>odwołań zwrotnych</emphasis +>.</para> + +<para +>Po wykonaniu polecenia wiersz przyjmie postać: <computeroutput +>void MyClass::DoStringOps( const String &foo, const String &bar, String *p, const int &a, const int &b )</computeroutput +></para> + +<para +>Interpretacja opisanego wyrażenia jest następujące. Najpierw wyszukuje ono spacje (<literal +>\s+</literal +>) po których wystąpił jeden lub więcej znaków alfanumerycznych (<literal +>\w+</literal +>) zakończonych kolejną spacją (<literal +>\s+</literal +>), za którą znajduje się znak &. Pełna treść tego dopasowania zostaje zachowana do dalszego wykorzystania przy wykonaniu zastąpienia tekstu. W drugiej części dopasowany fragment zostaje zastąpiony spacją i napisem <quote +>const</quote +>, po którym następuje kolejna spacja i zachowany wcześniej fragment tekstu (<literal +>\1</literal +>), a dalej spacja i kolejny fragment dopasowany po znaku & (<literal +>\2</literal +>)</para> + +<para +>W powyższym przykładzie pierwszy dopasowany fragment mógł zawierać napis <quote +>String</quote +> lub też <quote +>int</quote +>, dlatego też zastosowanie klasy znakowej <literal +>\w</literal +> i operatora <literal +>+</literal +> dało wymagany efekt.</para> + +</example> + +</listitem> + +</varlistentry> + +</variablelist> + +</sect3> + +<sect3 id="advanced-editing-tools-commandline-commands-navigation"> +<title +>Komendy stosowane do nawigacji w tekście</title> + +<variablelist> + +<varlistentry> +<term +><cmdsynopsis +><command +>goto</command +><arg +>INT wiersz</arg +></cmdsynopsis +></term> +<listitem +><para +>Powoduje przejście do podanego numeru wiersza.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>find</command +><arg +>wzorzec</arg +></cmdsynopsis +></term> +<listitem +><para +>Spowoduje przejście do pierwszego wystąpienia napisu <userinput +>wzorzec</userinput +> zgodnie z bieżącą konfiguracją funkcji wyszukiwania. Kolejne wystąpienia mogą zostać wyszukane za pomocą menu <menuchoice +><guimenu +>Edycja</guimenu +><guimenuitem +>Znajdź następne</guimenuitem +></menuchoice +> (domyślny skrót klawiszowy to <keycap +>F3</keycap +>).</para> +<para +>Polecenie "find" może być skonfigurowane poprzez dodanie jednej lub więcej opcji po dwukropku w postaci: <userinput +>find:opcje wzorzec</userinput +>. Dostępne są następujące opcje: <variablelist> + +<varlistentry> +<term +><userinput +>b</userinput +></term> +<listitem +><para +>Szuka tekstu wstecz.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>c</userinput +></term> +<listitem +><para +>Szuka począwszy od pozycji kursora.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>e</userinput +></term> +<listitem +><para +>Szuka w ramach zaznaczonego fragmentu.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>r</userinput +></term> +<listitem +><para +>Wykonuje polecenie szukania za pomocą wyrażenia regularnego. W przypadku użycia tej opcji, można w argumencie "zastąpienie" użyć parametru <userinput +>\N</userinput +>, gdzie N jest numerem podwyrażenia, które zostanie wstawione w zastępowanym tekście.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>s</userinput +></term> +<listitem +><para +>Szuka zwracając uwagę na wielkość liter.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>w</userinput +></term> +<listitem +><para +>Szuka dopasowując tylko całe wyrazy.</para +></listitem> +</varlistentry> + +</variablelist> + +</para> + +</listitem> + +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>ifind</command +><arg +>wzorzec</arg +></cmdsynopsis +></term> +<listitem +><para +>Polecenie wyszukuje tekst <quote +>w trakcie pisania</quote +>. Dodatkowo można skonfigurować zachowanie za pomocą opcji podanych po dwukropku w postaci: <userinput +>ifind:opcje wzorzec</userinput +>. Dostępne są następujące opcje: <variablelist> +<varlistentry> +<term +><userinput +>b</userinput +></term> +<listitem +><para +>Szuka tekstu wstecz.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>r</userinput +></term> +<listitem +><para +>Wyszukaj za pomocą wyrażenia regularnego.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>s</userinput +></term> +<listitem +><para +>Szuka zwracając uwagę na wielkość liter.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>c</userinput +></term> +<listitem +><para +>Szuka począwszy od pozycji kursora.</para +></listitem> +</varlistentry> + +</variablelist> +</para +></listitem> +</varlistentry> + +</variablelist> + +</sect3> + +</sect2> + +</sect1> + +<sect1 id="advanced-editing-tools-code-folding"> +<title +>Korzystanie ze zwijania kodu źródłowego</title> + +<para +>Zwijanie kodu, pozwala na ukrywanie wydzielonych części tekstu, dzięki czemu łatwiej jest przeglądać duże fragmenty edytowanego kodu źródłowego. &kate; określa możliwość zwinięcia danej części na podstawie reguł określonych w definicji podświetlania składni. Zwijanie jest dostępne tylko dla niektórych formatów dokumentów, zwykle są to pliki XML, kod źródłowy, itp. Większość definicji podświetlania, obsługujących funkcję zwijania kodu, pozwala też na ręczne definiowanie zwijalnych fragmentów tekstu, zwykle za pomocą słów kluczowych <userinput +>BEGIN</userinput +> oraz <userinput +>END</userinput +>.</para> + +<para +>Aby włączyć funkcję zwijania kodu, należy skorzystać z menu <menuchoice +><guimenu +>Widok</guimenu +><guimenuitem +>Pokaż znaczniki zwijania</guimenuitem +></menuchoice +> (jeżeli nie były one wcześniej widoczne). Pasek znaczników zwijania, widoczny po lewej stronie okna edycji menu, wyświetla graficzną reprezentację zwijalnych fragmentów kodu wraz ze znakami +/- wskazującymi na możliwe do wykonania na nim operacje. Naciśnięcie znaku "-" zwija dotyczący go fragment, zaś "+" rozwija go.</para> + +<para +>W menu dostępne są cztery dodatkowe polecenia pozwalające na manipulację zwiniętymi częściami tekstu, więcej informacji na ten temat dostępne jest w <link linkend="view-code-folding" +>dokumentacji menu</link +>. </para> + +<para +>Jeżeli użytkownik nie chce korzystać z funkcji zwijania kodu, to może wyłączyć opcję <guilabel +>Pokaż znaczniki zwijania (jeżeli dostępne)</guilabel +> w karcie <link linkend="config-dialog-editor-appearance" +>Edytor -> Wygląd</link +> w oknie konfiguracji.</para> + +</sect1> + +<sect1 id="advanced-editing-tools-scripting"> + +<title +>Wykorzystanie Javascript do sterowania pracą edytora</title> + +<sect2 id="advanced-editing-tools-scripting-introduction"> + +<title +>Wprowadzenie</title> + +<para +>Począwszy od wersji 2.5, edytor &kate; umożliwia tworzenie skryptów w standardzie ECMA, znanym również jako JavaScript.</para> + +<para +>Ze skryptów można korzystać tylko za pomocą <link linkend="advanced-editing-tools-commandline" +>wbudowanej linii poleceń</link +>. Skrypt musi być zlokalizowany w katalogu, w którym &kate; może go odszukać wraz z opcjonalnym plikiem .desktop definiującym jego dodatkowe właściwości. Domyślnym katalogiem dla skryptów jest podkatalog <filename +>katepart/scripts</filename +> znajdujący się w katalogu z danymi środowiska &kde;. Ścieżka dostępu do katalogu z danymi środowiska jest wyświetlana za pomocą polecenia <command +>kde-config <option +>--path</option +> <parameter +>data</parameter +></command +>. Zwykle podczas instalacji systemu operacyjnego tworzone są katalogi danych: systemowy i użytkownika. Skrypty umieszczone w katalogu systemowym są dostępne dla wszystkich użytkowników, zaś w katalogu użytkownika dostępne są tylko dla tego użytkownika.</para> + +<note +><para +>Ta funkcja programu ma charakter eksperymentalny i jej działanie może się zmienić w przyszłych wersjach programu.</para> +<para +>W chwili obecnej nie jest możliwe dodawanie skryptów do menu lub przypisywanie im skrótów klawiszowych. W przyszłości ta możliwość może się pojawić.</para> +<para +>Nie jest jeszcze możliwe przekazywanie do uruchamianego skryptu żadnych argumentów. Ta możliwość również w przyszłości się pojawi ;)</para> +</note> + +</sect2> + +<sect2 id="advanced-editing-tools-scripting-reference"> + +<title +>Interfejs programisty (API) dla JavaScript w &kate;</title> + +<para +>Poniżej przedstawiono pełny zestaw funkcji i właściwości dostępnych dla obiektów <type +>document</type +> oraz <type +>view</type +>. Oczywiście możliwe jest korzystanie z innych obiektów standardowych Javascript takich jak np.: <type +>Math</type +>, <type +>String</type +> <type +>Regex</type +>, itd.</para> + +<para +>Podczas działania skryptu, obiekt <classname +>document</classname +> odnosi się do bieżącego dokumentu, a obiekt <classname +>view</classname +> odnosi się do bieżącego widoku.</para> + +<note +><para +>Typy argumentów nie są w chwili obecnej stosowane w JavaScript, przedstawione są tylko dla zilustrowania jakiego rodzaju wartości dana funkcja oczekuje.</para +></note> + +<variablelist id="advanced-editing-tools-scripting-global"> +<title +>Funkcje globalne</title> +<varlistentry> +<term +><function +>debug( <parameter +><replaceable +>string</replaceable +></parameter +>) [funkcja]</function +></term> +<listitem> +<itemizedlist> +<title +>parametry</title> +<listitem +><para +><parameter +>string</parameter +> napis do wypisania</para> +</listitem> +</itemizedlist> +<para +>Przekazuje napis na standardowe wyjście <acronym +>STDERR</acronym +> wykorzystując funkcję <function +>kdDebug()</function +>. Wykorzystywany jest specjalnie przydzielony obszar do wyświetlania komunikatów, oznaczony przedrostkiem <computeroutput +>Kate (KJS Scripts):</computeroutput +> </para> +</listitem> +</varlistentry> +</variablelist> + +<variablelist id="advanced-editing-tools-scripting-document"> +<title +>Charakterystyka interfejsu programisty (API) dla klasy <classname +>document</classname +></title> + +<varlistentry> +<term +><function +>document.attribute( <parameter +><replaceable +>wiersz</replaceable +> </parameter +>, <parameter +><replaceable +>kolumna</replaceable +></parameter +> ); [funkcja]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametry</title> +<listitem +><para +><parameter +>uint wiersz</parameter +> Numer wiersza, dla którego będzie wyszukiwany atrybut.</para +></listitem> +<listitem +><para +><parameter +>uint kolumna</parameter +> Numer kolumny, dla której będzie poszukiwany atrybut.</para +></listitem> +</itemizedlist> +<para +>Zwraca kod ID atrybutu znajdującego się w określonej pozycji dokumentu [<parameter +>wiersz</parameter +>,<parameter +>kolumna</parameter +>]. Atrybut reprezentuje wygląd tekstu lub styl tekstu, i wykorzystywany jest do podświetlania składni określonego fragmentu tekstu, co jest wykorzystywane w formatach mieszanych takich jak np.: HTML lub PHP.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.canBreakAt( <parameter +>Char c</parameter +>, <parameter +>uint atrybut</parameter +> ); [funkcja]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametry</title> +<listitem +><para +><parameter +>c</parameter +> Znak do sprawdzenia</para +></listitem> +<listitem +><para +><parameter +>atrybut</parameter +> Atrybut w pozycji znaku <parameter +>c</parameter +>.</para +></listitem> +</itemizedlist> +<para +>Zwraca informację, dotyczącą możliwości łamania wiersza dla znaku "c" i atrybutu "atrybut". Wynik działania funkcji zależy od reguł podświetlania, określających możliwość łamania wiersza dla danego znaku i atrybutu.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.canComment( <parameter +>uint atrybut_początkowy</parameter +>, <parameter +>uint atrybut_końcowy</parameter +> ); [funkcja]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametry</title> +<listitem +><para +><parameter +>atrybut_początkowy</parameter +> Atrybut rozpoczynający obszar określony do przekształcenia w komentarz.</para +></listitem> +<listitem +><para +><parameter +>atrybut_końcowy</parameter +> Atrybut kończący obszar określony do przekształcenia w komentarz.</para +></listitem> +</itemizedlist> +<para +>Zwraca informację o tym, czy atrybut_początkowy i atrybut_końcowy są zgodne z bieżącymi regułami podświetlania składni. Jeżeli tak, to możliwe jest wtedy przekształcenie tego fragmentu w komentarz. </para> +<example> +<title +>Wykorzystanie funkcji canComment</title> +<programlisting +>if ( document.canComment( document.attribute(1,0), document.attribute(5,0) ) ) { + // 1,0 oraz 5,0 należą do tego samego systemu reguł podświetlania składni +} +</programlisting> +</example> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.clear(); [funkcja]</function +></term> +<listitem +><para +>Usuwa zawartość dokumentu.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.commentStart( <parameter +>uint atrybut</parameter +> ); [funkcja]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametry</title> +<listitem +><para +><parameter +>atrybut</parameter +> Atrybut tekstu, dla którego zostanie zwrócony napis rozpoczęcia komentarza.</para +></listitem> +</itemizedlist> +<para +>Zwraca napis wymagany do rozpoczęcia wielowierszowego komentarza dla tekstu o określonym atrybucie, lub napis pusty, jeżeli komentarze wielowierszowe nie są obsługiwane dla tego typu dokumentu.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.commentMarker( <parameter +>uint atrybut</parameter +> ); [funkcja]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametry</title> +<listitem +><para +><parameter +>atrybut</parameter +> Atrybut tekstu, dla którego zostanie pobrany znacznik komentarza</para +></listitem> +</itemizedlist> +<para +>Zwraca napis, wykorzystywany do komentowania wiersza dokumentu, lub pusty napis jeżeli komentarze dla całych wierszy nie są dostępne dla tego typu dokumentu.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.commentEnd( <parameter +>uint atrybut</parameter +> ); [funkcja]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametry</title> +<listitem +><para +><parameter +>atrybut</parameter +> Atrybut tekstu, dla którego zostanie zwrócony napis zakończenia komentarza</para +></listitem> +</itemizedlist> +<para +>Zwraca napis wymagany do zakończenia wielowierszowego komentarza dla tekstu o określonym atrybucie, lub napis pusty, jeżeli komentarze wielowierszowe nie są obsługiwane dla tego typu dokumentu.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.editBegin(); [funkcja]</function +></term> +<listitem> +<para +>Rozpoczyna grupę operacji edycyjnych. Wszystkie działania wykonane do momentu uruchomienia funkcji editEnd() będą zgrupowane w jedną operację cofania.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.editEnd(); [funkcja]</function +></term> +<listitem> +<para +>Kończy grupę operacji edycyjnych.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.highlightMode; [właściwość:tylko do odczytu]</function +></term> +<listitem> +<para +>Zawiera nazwę trybu reguł podświetlania dla bieżącego dokumentu (np. "JavaScript" lub "C++"). Jeżeli dokument nie ma zdefiniowanego trybu podświetlania składni, zostanie zwrócona wartość "None". Konieczne jest korzystanie z nazwy w języku angielskim, w przypadkach gdy różni się ona od nazwy przetłumaczonej.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.indentMode; [właściwość:tylko do odczytu]</function +></term> +<listitem> +<para +>Nazwa trybu automatycznych wcięć dla bieżącego dokumentu (np.:<literal +>normal</literal +> lub <literal +>cstyle</literal +>). Jeżeli tryb automatycznych wcięć jest wyłączony, to zwrócona zostanie wartość <literal +>none</literal +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.indentWidth; [właściwość:tylko do odczytu]</function +></term> +<listitem> +<para +>Szerokość wcięć ustawiona dla dokumentu, wykorzystywana jeżeli włączone są wcięcia za pomocą znaku spacji.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.insertLine( <parameter +>uint wiersz</parameter +>, <parameter +>string tekst</parameter +> ); [funkcja]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametry</title> +<listitem +><para +><parameter +>wiersz</parameter +> numer wiersza dokumentu</para> +</listitem> +<listitem +><para +><parameter +>tekst</parameter +> tekst do wprowadzenia</para +></listitem> +</itemizedlist> +<para +>Wstawia nowy wiersz o zawartości <parameter +>tekst</parameter +> w wierszu o numerze <parameter +>wiersz</parameter +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.insertText( <parameter +>uint wiersz</parameter +>, <parameter +>uint kolumna</parameter +>, <parameter +>string tekst</parameter +> ); [funkcja]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametry</title> +<listitem +><para +><parameter +>wiersz</parameter +> numer wiersza dokumentu</para +></listitem> +<listitem +><para +><parameter +>kolumna</parameter +> numer kolumny w dokumencie</para +></listitem> +<listitem +><para +><parameter +>tekst</parameter +> tekst do wprowadzenia</para +></listitem> +</itemizedlist> +<para +>Wstawia do dokumentu <parameter +>tekst</parameter +> w wierszu <parameter +>wiersz</parameter +> i kolumnie <parameter +>kolumna</parameter +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>document.length(); [funkcja]</term> +<listitem> +<para +>Zwraca rozmiar dokumentu w bajtach.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.lines(); [funkcja]</function +></term> +<listitem> +<para +>Zwraca liczbę wierszy w dokumencie.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>document.mixedIndent; [właściwość:tylko do odczytu]</term> +<listitem> +<para +>Wartość prawda/fałsz informująca czy tryb mieszanych wcięć dla dokumentu jest włączony. Jeżeli tak, to wcięcia są optymalizowane, tak że zawierają mieszankę znaków tabulacji i spacji (podobnie jak w edytorze Emacs).</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>document.removeLine( <parameter +>uint wiersz</parameter +> ); [funkcja]</term> +<listitem> +<itemizedlist> +<title +>Parametry</title> +<listitem +><para +><parameter +>wiersz</parameter +> numer wiersza dokumentu</para +></listitem> +</itemizedlist> +<para +>Usuwa wiersz z dokumentu.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.removeText( <parameter +>uint wiersz_początku</parameter +>, <parameter +>uint kolumna_początku</parameter +>, <parameter +>uint wiersz_końca</parameter +>, <parameter +>uint kolumna_końca</parameter +> ); [funkcja]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametry</title> +<listitem +><para +><parameter +>wiersz_początku</parameter +> określa początkowy wiersz dokumentu</para +></listitem> +<listitem +><para +><parameter +>kolumna_początku</parameter +> określa początkową kolumnę dokumentu</para +></listitem> +<listitem +><para +><parameter +>wiersz_końca</parameter +> określa ostatni wiersz</para +></listitem> +<listitem +><para +><parameter +>kolumna_końca</parameter +> określa ostatnią kolumnę</para +></listitem> +</itemizedlist> +<para +>Usuwa tekst w dokumencie od wiersza <parameter +>wiersz_początku</parameter +> i kolumny <parameter +>kolumna_początku</parameter +> do wiersza<parameter +>wiersz_końca</parameter +> i kolumny <parameter +>kolumna_końca</parameter +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.setText( <parameter +>string tekst</parameter +> ); [funkcja]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametry</title> +<listitem +><para +><parameter +>tekst</parameter +> treść dokumentu</para +></listitem> +</itemizedlist> +<para +>Ustawia zawartość całego dokumentu na <parameter +>tekst</parameter +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.spaceIndent; [właściwość:tylko do odczytu]</function +></term> +<listitem> +<para +>Wartość prawda/fałsz określająca czy tryb wcinania spacjami jest włączony. Jeżeli tak, to wcięcia w dokumencie są generowane odpowiednią, zdefiniowaną przez "indentWidth", liczbą spacji. W przeciwnym wypadku, wcięcia dokonywane są za pomocą znaków tabulacji (jeden znak na jeden poziom wcięcia).</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.textFull(); [funkcja]</function +></term> +<listitem> +<para +>Zwraca pełną zawartość dokumentu. Jeżeli dokument zawiera wiele wierszy, to rozdzielane są one znakiem końca wiersza: <constant +>\n</constant +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.textLine( uint wiersz ); [funkcja]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametry</title> +<listitem +><para +><parameter +>wiersz</parameter +> numer wiersza</para +></listitem> +</itemizedlist> +<para +>Zwraca tekst wiersza o numerze <parameter +>wiersz</parameter +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.textRange( <parameter +>uint wiersz_początku</parameter +>, <parameter +>uint kolumna_początku</parameter +>, <parameter +>uint wiersz_końca</parameter +>, <parameter +>uint kolumna_końca</parameter +> ); [funkcja]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametry</title> +<listitem +><para +><parameter +>wiersz_początku</parameter +> określa początkowy wiersz dokumentu</para +></listitem> +<listitem +><para +><parameter +>kolumna_początku</parameter +> określa początkową kolumnę dokumentu</para +></listitem> +<listitem +><para +><parameter +>wiersz_końca</parameter +> określa ostatni wiersz</para> +</listitem> +<listitem +><para +><parameter +>kolumna_końca</parameter +> określa ostatnią kolumnę</para +></listitem> +</itemizedlist> +<para +>Zwraca zdefiniowany zakres tekstu dokumentu. Jeżeli zawiera on wiele wierszy, to rozdzielane są one znakiem końca wiersza: <constant +>\n</constant +>.</para> +</listitem> +</varlistentry> + +</variablelist +><!--/ document API --> + +<variablelist id="advanced-editing-tools-scripting-view"> +<title +>Interfejs programisty (API) dla klasy <classname +>view</classname +></title> + +<varlistentry> +<term +><function +>view.clearSelection(); [funkcja]</function +></term> +<listitem> +<para +>Usuwa zaznaczenie z tekstu.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.cursorColumn(); [funkcja]</function +></term> +<listitem> +<para +>Zwraca numer kolumny, w której znajduje się kursor (znaki tabulacji są rozwijane do odpowiedniej liczby spacji).</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.cursorColumnReal(); [funkcja]</function +></term> +<listitem> +<para +>Zwraca rzeczywisty numer kolumny, w której znajduje się kursor (znaki tabulacji traktowane są jako jeden znak).</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.cursorLine(); [funkcja]</function +></term> +<listitem> +<para +>Zwraca numer wiersza, w którym znajduje się kursor.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.hasSelection(); [funkcja]</function +></term> +<listitem> +<para +>Zwraca wartość <constant +>true</constant +> (logiczna prawda), jeżeli widok zawiera zaznaczenie, lub <constant +>false</constant +> (logiczny fałsz), gdy w widoku brak zaznaczenia.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.removeSelectedText(); [funkcja]</function +></term> +<listitem> +<para +>Usuwa zaznaczony fragment, w przypadku gdy zaznaczenie w tekście istnieje.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.selectAll(); [funkcja]</function +></term> +<listitem> +<para +>Zaznacza cały dokument.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.selection(); [funkcja]</function +></term> +<listitem> +<para +>Zwraca zaznaczony fragment. Jeżeli zawiera on wiele wierszy, to rozdzielane są one znakiem końca wiersza: <constant +>\n</constant +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.selectionEndColumn; [właściwość:tylko do odczytu]</function +></term> +<listitem> +<para +>Zwraca numer ostatniej kolumny zaznaczenia.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.selectionEndLine; [właściwość:tylko do odczytu]</function +></term> +<listitem> +<para +>Zwraca numer ostatniego wiersza zaznaczenia.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.selectionStartColumn; [właściwość:tylko do odczytu]</function +></term> +<listitem> +<para +>Zwraca numer pierwszej kolumny zaznaczenia.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.selectionStartLine; [właściwość:tylko do odczytu]</function +></term> +<listitem> +<para +>Zwraca numer pierwszego wiersza zaznaczenia.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.setCursorPosition( <parameter +>uint wiersz</parameter +>, <parameter +>uint kolumna</parameter +> ); [funkcja]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametry</title> +<listitem +><para +><parameter +>wiersz</parameter +> numer wiersza pozycji kursora.</para +></listitem> +<listitem +><para +><parameter +>kolumna</parameter +> numer kolumny pozycji kursora.</para +></listitem> +</itemizedlist> +<para +>Ustawia kursor w widoku w pozycji [<parameter +>wiersz</parameter +>, <parameter +>kolumna</parameter +>]. Pozycja zostaje ustalona wizualnie, czyli znaki tabulacji rozwijane są na odpowiednią (określoną przez <replaceable +>tabwidth</replaceable +>) liczbę spacji w zależności od pozycji w wierszu. Kursor staje się widoczny. Parametry wiersz i kolumna rozpoczynają się od zera.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.setCursorPositionReal( <parameter +>uint wiersz</parameter +>, <parameter +>uint kolumna</parameter +> ); [funkcja]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametry</title> +<listitem +><para +><parameter +>wiersz</parameter +> numer wiersza pozycji kursora.</para +></listitem> +<listitem +><para +><parameter +>kolumna</parameter +> numer kolumny pozycji kursora.</para +></listitem> +</itemizedlist> +<para +>Ustawia kursora w pozycji podanej przez <parameter +>wiersz</parameter +> i <parameter +>kolumnę</parameter +>. Argumenty określają pozycję w tekście, czyli znaki tabulacji traktowane są jako jeden znak. Kursor stanie się widoczny. Numery wiersza i kolumny rozpoczynają się od zera.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.setSelection( <parameter +>uint wiersz_początku</parameter +>, <parameter +>uint kolumna_początku</parameter +>, <parameter +>uint wiersz_końca</parameter +>, <parameter +>uint kolumna_końca</parameter +> ); [funkcja]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametry</title> +<listitem +><para +><parameter +>wiersz_początku</parameter +> określa początkowy wiersz dokumentu</para +></listitem> +<listitem +><para +><parameter +>kolumna_początku</parameter +> określa początkową kolumnę dokumentu</para +></listitem> +<listitem +><para +><parameter +>wiersz_końca</parameter +> określa ostatni wiersz</para +></listitem> +<listitem +><para +><parameter +>kolumna_końca</parameter +> określa ostatnią kolumnę</para +></listitem> +</itemizedlist> +<para +>Zaznacza fragment tekstu począwszy od wiersza <parameter +>wiersz_początku</parameter +> i kolumny <parameter +>kolumna_początku</parameter +> do wiersza <parameter +>wiersz_końca</parameter +> i kolumny <parameter +>kolumna_końca</parameter +>.</para> +</listitem> +</varlistentry> + +</variablelist> + +<example id="advanced-editing-tools-scripting-example"> + +<title +>Przykładowy skrypt</title> +<para +>Przedstawiony poniżej skrypt, przerabia wszystkie litery w zaznaczonym fragmencie na duże. Pierwszym krokiem jest sprawdzenie istnienia zaznaczenia, następnie pobranie zaznaczonego tekstu, zamienienie wielkości znaków oraz wstawienie zmienionego tekstu do dokumentu. Zapis programu wygląda następująco:</para> + +<programlisting +>if ( view.hasSelection() ) +{ + // zmień na duże litery + column = view.selectionStartColumn; + line = view.selectionStartLine; + + selection = view.selection().toUpperCase(); + + document.editBegin(); + view.removeSelectedText(); + document.insertText( line, column, selection ); + document.editEnd(); +} +</programlisting> + +<para +>Zgrupowanie poleceń edycyjnych tak, aby można je było wycofać jednym poleceniem <guimenuitem +>Cofnij</guimenuitem +>, polega na objęciu poleceń<programlisting +>view.removeSelectedText()</programlisting +> i <programlisting +>document.insertText()</programlisting +> poleceniami <programlisting +>document.editBegin()</programlisting +> oraz <programlisting +>document.editEnd()</programlisting +>.</para> + +</example> + +<example id="advanced-editing-tools-desktop-example"> +<title +>Przykładowy plik <filename +>.desktop</filename +></title> + +<para +>Poniżej przedstawiono zawartość przykładowego pliku .desktop powiązanego z powyższym skryptem.</para> + +<programlisting +># Example of a .desktop file +[Desktop Entry] +Encoding=UTF-8 +Name=Kate Part JavaScript Uppercase +Comment=Skrypt zamieniający treść zaznaczenia na duże litery +X-Kate-Command=uppercase-selection +X-Kate-Help=<p>Pomoc: <code>uppercase-selection</code></p> +</programlisting> + +<para +>W pliku tym, możliwe jest zdefiniowanie kodowania znaków (Encoding), nazwy skryptu (Name), komentarza (Comment), tekstu pomocy (X-Kate-Help) i polecenia linii poleceń (X-Kate-Command). Jeżeli plik .desktop znajdzie się w repozytoriach SVN środowiska KDE, to parametry: Name, Comment i X-Kate-Help będą automatycznie tłumaczone na inne języki przez zespoły tłumaczy KDE.</para> + +</example> + +<sect3> +<title +>Wykorzystanie skryptów</title> + +<para +>Program &kate; przeszuka katalogi ze skryptami (patrz <link linkend="advanced-editing-tools-scripting-introduction" +>wyżej</link +>) w poszukiwaniu plików o nazwie <filename +>*.js</filename +>. Dla każdego znalezionego pliku sprawdzane jest istnienie odpowiadającego mu pliku <filename +>.desktop</filename +> (np. dla skryptu: uppercase.js, poszukiwany będzie plik uppercase.desktop). </para> +<para +>Jeżeli plik <filename +>.desktop</filename +> nie zostanie znaleziony, to skrypt zostanie zarejestrowany przez linię poleceń edytora pod nazwą pliku bez rozszerzenia .js. W opisywanym przykładzie będzie to <literal +>uppercase</literal +>. Jeżeli taka nazwa skryptu odpowiada użytkownikowi oraz nie ma potrzeby korzystania z innych możliwości, jakie daje plik <filename +>.desktop</filename +>, to wtedy użycie pliku <filename +>.desktop</filename +> nie jest wymagane. </para> +<para +>Jeżeli istnieje plik <filename +>.desktop</filename +>, edytor odczyta nazwę skryptu z tego pliku z pozycji X-Kate-Command, na przykład: X-Kate-Command=uppercase-selection.</para> + +</sect3> + +</sect2> + +</sect1> + +</chapter> diff --git a/tde-i18n-pl/docs/tdebase/kate/configdialog01.png b/tde-i18n-pl/docs/tdebase/kate/configdialog01.png Binary files differnew file mode 100644 index 00000000000..1d5ab05ff52 --- /dev/null +++ b/tde-i18n-pl/docs/tdebase/kate/configdialog01.png diff --git a/tde-i18n-pl/docs/tdebase/kate/configdialog02.png b/tde-i18n-pl/docs/tdebase/kate/configdialog02.png Binary files differnew file mode 100644 index 00000000000..23f1358090c --- /dev/null +++ b/tde-i18n-pl/docs/tdebase/kate/configdialog02.png diff --git a/tde-i18n-pl/docs/tdebase/kate/configuring.docbook b/tde-i18n-pl/docs/tdebase/kate/configuring.docbook new file mode 100644 index 00000000000..8e6aef668c3 --- /dev/null +++ b/tde-i18n-pl/docs/tdebase/kate/configuring.docbook @@ -0,0 +1,2604 @@ +<chapter id="configuring-kate"> +<chapterinfo> +<authorgroup> +<author +>&Anders.Lund; &Anders.Lund.mail;</author> +<othercredit role="translator" +><firstname +>Suse</firstname +><surname +>Polska</surname +><affiliation +><address +><email +>suse@suse.pl</email +></address +> </affiliation +><contrib +>Polskie tłumaczenie</contrib +></othercredit +> <othercredit role="translator" +><firstname +>Krzysztof</firstname +><surname +>Woźniak</surname +><affiliation +><address +><email +>wozniakk@ceti.pl</email +></address +></affiliation +><contrib +>Polskie tłumaczenie</contrib +></othercredit +> +</authorgroup> +</chapterinfo> +<title +>Konfiguracja &kate;</title> + +<sect1 id="configuring-overview"> +<title +>Przegląd</title> +<para> +<indexterm> +<primary +>konfiguracja</primary> +<secondary +>ustawienia</secondary> +<tertiary +>właściwości</tertiary +></indexterm> +<anchor id="find"/> <anchor id="find-again"/> <anchor id="replace"/> <anchor id="undo"/> <anchor id="redo"/> Program &kate; udostępnia kilka narzędzi dostosowania swojego zachowania do wymagań użytkownika. Do najważniejszych należą: </para> + +<variablelist> +<varlistentry> +<term id="configure" +>Okno konfiguracji</term> +<listitem +><para +>Podstawowe narzędzie konfiguracji programu &kate;, komponentu edytora i zainstalowanych wtyczek.</para +></listitem> +</varlistentry> +<varlistentry> +<term id="settings" +>Menu <guimenu +>Ustawienia</guimenu +></term> +<listitem +><para +>Pozwala na zmianę często używanych ustawień oraz wywołuje okna konfiguracji.</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Menu <guimenu +>Widok</guimenu +></term> +<listitem +><para +>Pozwala użytkownikowi podzielić aktywną ramkę oraz włącza i wyłącza wyświetlenie paska ikon oraz numerów wierszy dla bieżącego dokumentu.</para +></listitem> +</varlistentry> +</variablelist> + +<para +>Wbudowany program &konsole; korzysta z parametrów konfiguracji ustawionych w &kcontrolcenter-miejscownik;, ale można je zmienić naciskając <mousebutton +>prawy</mousebutton +> przycisk myszy i wybierając <guimenuitem +>Ustawienia</guimenuitem +> z menu kontekstowego.</para> + +</sect1> + +<sect1 id="configuring-kate-configdialog"> +<title +>Główne okno konfiguracji</title> + +<mediaobject> +<imageobject> +<imagedata format="PNG" fileref="configdialog01.png"/> +</imageobject> +</mediaobject> + +<para +>Okno konfiguracji &kate; wyświetla listę dostępnych tematów konfiguracyjnych po lewej stronie, a karty konfiguracji odpowiadające wybranym tematom po prawej stronie.</para> + +<para +>Tematy konfiguracji dzielą się na dwie grupy <itemizedlist> +<listitem +><para +><link linkend="config-dialog" +>Konfiguracja programu</link> +</para +></listitem> +<listitem +><para +><link linkend="config-dialog-editor" +>Konfiguracja edytora</link +></para +></listitem> + +</itemizedlist> + +</para> + +</sect1> + +<sect1 id="config-dialog"> +<title +>Konfiguracja programu &kate;</title> +<para +>Ta grupa zawiera parametry konfiguracyjne dotyczące samego zachowania programu &kate;.</para> + +<sect2 id="config-dialog-general"> +<title +>Karta: Ustawienia ogólne</title> +<para +>W karcie tej umieszczone są globalne ustawienia programu &kate;.</para> + +<variablelist> + +<varlistentry> +<term +><anchor id="config-dialog-general-show-full-path"/> +<guilabel +>Wyświetl pełną ścieżkę w tytule</guilabel +></term> +<listitem +><para +>Jeżeli opcja jest włączona, to &kate; wyświetli pełną ścieżkę dostępu do bieżącego dokumentu w pasku tytułowym okna (w przeciwnym wypadku wyświetlona zostanie tylko nazwa pliku).</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="config-general-behavior"/> +<guilabel +>Zachowanie</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term> +<anchor id="config-dialog-general-sync-konsole"/> +<guibutton +>Synchronizuj konsolę z aktywnym dokumentem</guibutton +></term> +<listitem +><para +>Włączenie tej opcji spowoduje, iż wbudowany program &konsole; będzie automatycznie zmieniał katalog roboczy (poleceniem systemowym <command +>cd</command +>) na ten, w którym znajduje się edytowany dokument. Zmiana będzie następować zawsze przy wczytaniu nowego lub zmianie bieżącego dokumentu. Jeżeli opcja ta jest wyłączona, to zmiana katalogu będzie wymagała działania użytkownika. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="config-dialog-general-warn-mod"/> +<guilabel +>Ostrzegaj o plikach zmienionych przez zewnętrzne procesy</guilabel +></term> +<listitem +><para +>W przypadku włączenia tej opcji program &kate; poinformuje użytkownika w przypadku, gdy edytowany plik został zmieniony przez inny program. Sprawdzenie tego faktu odbywa się przy każdym aktywowaniu okna programu &kate;. Możliwe jest dokonywanie wybranych operacji na wielu zmodyfikowanych dokumentach: można je wczytać ponownie, zapisać lub porzucić zmiany.</para> +<para +>Jeżeli opcja jest wyłączona, to &kate; nie będzie pytać o reakcję w przypadku, gdy plik zostanie zmodyfikowany przez inny program.</para> +</listitem> +</varlistentry> + +</variablelist> +</listitem> +</varlistentry +><!-- /behavior group --> + +<varlistentry> +<term +><anchor id="config-general-meta-data"/> +<guilabel +>Dodatkowe informacje</guilabel +></term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="config-general-keep-meta-information"/> +<guilabel +>Zachowaj dodatkowe informacje między sesjami</guilabel +></term> +<listitem +><para +>Jeżeli opcja jest aktywna, to &kate; będzie zapisywać dane dodatkowe takie jak np. ustawione zakładki, dane konfiguracji sesji, itp., kiedy dokumenty są zamykane. Dane te będą wykorzystane przy ponownym otwarciu dokumentu.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="config-general-delete-meta-information-after"/> +<guilabel +>Usuń nieużywane dodatkowe informacje po</guilabel +></term> +<listitem +><para +>Określa maksymalną liczbę dni, przez którą &kate; będzie przechowywać informacje dotyczące nieotwieranych plików. Pozwala to na utrzymywanie rozsądnych rozmiarów bazy informacji dodatkowych.</para +></listitem> +</varlistentry> + +</variablelist> + +</listitem> +</varlistentry +><!-- /meta data group --> + +</variablelist> +</sect2> + +<sect2 id="config-dialog-sessions"> +<title +>Karta: Sesje</title> + +<para +>Poniższa sekcja zawiera informacje dotyczące <link linkend="fundamentals-using-sessions" +>korzystania z sesji</link +>.</para> + +<variablelist> + +<varlistentry> +<term +><anchor id="config-dialog-sessions-elements"/> +<guilabel +>Elementy sesji</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Dołącz konfigurację okien</guilabel +></term> +<listitem +><para +>Jeżeli opcja jest włączona to &kate; zapisze wraz z informacją o sesji także bieżącą konfigurację okien.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry +><!-- /elements of sessions --> + +<varlistentry> +<term +><anchor id="config-dialog-sessions-startup-behavior"/> +<guilabel +>Zachowanie przy starcie programu</guilabel +></term> +<listitem> +<para +>Pozwala na określenie zachowania programu &kate; po uruchomieniu. Ten parametr może zostać unieważniony poprzez uruchomienie &kate; z odpowiednimi parametrami <link linkend="command-line-options" +>w linii poleceń</link +>.</para> +<variablelist> +<varlistentry> +<term +><guilabel +>Uruchom nową sesję</guilabel +></term> +<listitem +><para +>Jeżeli ta opcja jest aktywna, to &kate; po uruchomieniu utworzy nową, nienazwaną sesję.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Wczytaj ostatnią sesję</guilabel +></term> +<listitem +><para +>Program &kate; wczyta ostatnio wykorzystywaną sesję. Opcja ta jest bardzo przydatna, jeżeli użytkownik rzadko zmienia sesje i zwykle korzysta z jednego zestawu edytowanych plików.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Wybierz sesję ręcznie</guilabel +></term> +<listitem +><para +>Program &kate; wyświetli okno dialogowe pozwalające wybrać pożądaną w danej chwili sesję. Jest to zachowanie domyślne, korzystne w przypadku, gdy użytkownik często korzysta z wielu różnych sesji.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry +><!-- /startup behavior --> + +<varlistentry> +<term +><anchor id="config-dialog-sessions-exit-behavior"/> +<guilabel +>Zachowanie przy wyjściu z programu lub przy zmianie sesji</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Nie zapisuj sesji</guilabel +></term> +<listitem +><para +>Zmiana ustawień sesji (listy otwartych plików, konfiguracja okien) nie będzie zapisywana. Jednakże użytkownik będzie pytany o reakcję w przypadku niezapisanych plików. Dzięki tej opcji można raz skonfigurować sesję i później nie martwić się o zamykanie dodatkowych otwartych plików, których nie powinno być przy następnym otwarciu sesji.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Zapisz sesję</guilabel +></term> +<listitem +><para +>Program &kate; zapisze dane dotyczące sesji, z wyjątkiem sytuacji, gdy sesja jest nienazwana. Jeżeli opcja ta jest włączona, to sesje zawsze będą przywracane do stanu z chwili ich zamknięcia. Jest to zachowanie domyślne. </para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Zapytaj użytkownika</guilabel +></term> +<listitem +><para +>Zostanie wyświetlone pytanie o zapisanie sesji za każdym razem, gdy nazwana sesja będzie zamykana.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry +><!-- /exit/switch behavior --> + +</variablelist> + +</sect2> + +<sect2 id="config-dialog-fileselector"> +<title +>Karta: <guilabel +>Wybór plików</guilabel +></title> + +<variablelist> +<varlistentry> +<term +><guilabel +>Pasek narzędzi</guilabel +></term> +<listitem +><para +>Pozwala na skonfigurowanie przycisków widocznych na pasku narzędzi przeglądarki plików. Z listy dostępnych akcje należy przenieść odpowiednie ikony na listę <guilabel +>Zaznaczone akcje</guilabel +>, a następnie ustawić je we właściwej kolejności za pomocą przycisków strzałek.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Automatyczna synchronizacja</guilabel +></term> +<listitem +><para +>Włączenie tej opcji powoduje, iż przeglądarka systemu plików będzie automatycznie zmieniać wyświetlany katalog na katalog bieżącego dokumentu. Dzieje się to w następujących sytuacjach: <itemizedlist +> <listitem +><para +>Przy zmianie aktywnego dokumentu.</para +></listitem +> <listitem +><para +>Po wyświetleniu przeglądarki systemu plików.</para +></listitem +> </itemizedlist +> Jeżeli ta opcja nie zostanie włączona, to użytkownik może szybko przejść do katalogu bieżącego dokumentu za pomocą przycisku <guilabel +>Bieżący katalog dokumentu</guilabel +>, znajdującego się na pasku narzędzi. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Zapamiętane lokalizacje</guilabel +></term> +<listitem +><para +>Pozwala określić liczbę pozycji w historii przeglądanych katalogów. Powtarzające się wpisy nie są zapamiętywane.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Zapamiętane filtry</guilabel +></term> +<listitem +><para +>Pozwala określić liczbę pozycji w historii wykorzystywanych filtrów. Filtry powtarzające się nie są zapamiętywane.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Sesja</guilabel +></term> +<listitem> +<para +>Określa czy przeglądarka systemu plików ma zapamiętywać bieżący katalog i filtry plików podczas przełączania pomiędzy sesjami.</para> +</listitem> +</varlistentry> + +</variablelist> + +</sect2> + +<sect2 id="config-dialog-documentlist"> +<title +>Karta: <guilabel +>Lista dokumentów</guilabel +></title> + +<variablelist> +<varlistentry> +<term +><guilabel +>Cieniowanie tła</guilabel +></term> +<listitem +><para +>Pozwala na włączenie lub wyłączenie funkcji cieniowania tła dla ostatnio używanych dokumentów oraz na określenie koloru cieniowania. Więcej informacji na ten temat znajduje się w sekcji <link linkend="kate-mdi-tools-file-list" +>Lista dokumentów</link +>.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Sortuj wg</guilabel +></term> +<listitem +><para +>Określa kolejność sortowania dla listy dokumentów. Zmiana porządku sortowania jest możliwa za pomocą menu kontekstowego dostępnego po naciśnięciu prawego przycisku myszy na liście dokumentów.</para +></listitem> +</varlistentry> +</variablelist> + +</sect2> + +<sect2 id="config-dialog-plugins"> +<title +>Karta: <guilabel +>Wtyczki</guilabel +></title> + +<para +>Ta karta pokazuje listę zainstalowanych w programie &kate; wtyczek. Zawiera ona nazwę i krótki opis każdej dostępnej wtyczki oraz pole opcji pozwalające na włączenie lub wyłączenie wtyczki. </para> + +<para +>Jeżeli wtyczka posiada możliwość konfiguracji, to wyświetlone zostanie okno podrzędne z odpowiednimi polami do wypełnienia.</para> + +</sect2> + + +<sect2 id="config-dialog-externaltools"> +<title +>Narzędzia zewnętrzne</title> + +<para +>W menu <guimenu +>Narzędzia</guimenu +> dostępne jest podmenu <guisubmenu +>Narzędzia zewnętrzne</guisubmenu +>. Są to programy operujące na danych związanych z bieżącym dokumentem, np: jego nazwą, katalogiem, tekstem lub zaznaczonym fragmentem. Ta karta pozwala na zarządzanie narzędziami zewnętrznymi.</para> + +<para +>Każde narzędzie zewnętrzne to polecenie powłoki zawierające w wywołaniu makra reprezentujące dane dotyczące bieżącego dokumentu. Podczas uruchomiania narzędzia makra te są zamieniane na dane dotyczące dokumentu.</para> + +<variablelist> +<title +>Właściwości narzędzi zewnętrznych</title> +<varlistentry> +<term +>Etykieta</term> +<listitem +><para +>Etykieta narzędzia, która wyświetli się w menu Narzędzia zewnętrzne.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Skrypt</term> +<listitem +><para +>Skrypt powłoki uruchamiany przy wywoływaniu narzędzia. Podczas uruchamiania skryptu przekazywane są do niego następujące makra: <variablelist> +<varlistentry> +<term +>%URL</term> +<listitem +><para +>Pełna ścieżka dostępu dla bieżącego dokumentu lub pusty napis, jeżeli dokument nie został jeszcze zapisany.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>%URLS</term> +<listitem +><para +>Rozdzielana spacjami lista ścieżek dostępu do wszystkich otwartych dokumentów (z wyjątkiem dokumentów nie zapisanych).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>%directory</term> +<listitem +><para +>Katalog, w którym znajduje się bieżący dokument lub pusty napis, jeżeli nie został on jeszcze zapisany.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>%filename</term> +<listitem +><para +>Nazwa pliku bieżącego dokumentu (bez ścieżki dostępu do katalogu) lub pusty napis, jeżeli nie został on jeszcze zapisany.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>%line</term> +<listitem +><para +>Numer wiersza bieżącego dokumentu, w którym znajduje się kursor.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>%column</term> +<listitem +><para +>Numer kolumny bieżącego dokumentu, w której znajduje się kursor.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>%selection</term> +<listitem +><para +>Zaznaczony fragment tekstu z bieżącego dokumentu lub pusty napis, jeżeli nic nie zostało zaznaczone</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>%text</term> +<listitem +><para +>Pełny tekst bieżącego dokumentu. Należy korzystać uważnie z tego makra, gdyż tekst może przekroczyć maksymalną dopuszczalną długość wywołania polecenia w systemie.</para +></listitem> +</varlistentry> + +</variablelist> + +</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Program</term> +<listitem +><para +>Program wykonywalny używany jako skrypt. Parametr ten jest wymagany i wykorzystywany podczas sprawdzania, czy dane polecenie jest dostępne w systemie. Dopuszczalne jest podanie pełnej ścieżki dostępu do programu, jeżeli nie znajduje się on w katalogu określonym przez zmienną środowiskową <envar +>PATH</envar +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Typy MIME</term> +<listitem +><para +>Rozdzielana średnikami lista typów MIME, dla których dane polecenie może być wykonane. Aktualnie nie jest wykorzystywana.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Zapisz</term> +<listitem +><para +>Powoduje, iż program &kate; zapisze bieżący lub wszystkie otwarte dokumenty przed uruchomieniem skryptu. Jest to przydatne w sytuacji gdy skrypt bezpośrednio przetwarza dane znajdujące się w edytowanym pliku.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Nazwa linii poleceń</term> +<listitem +><para +>Wypełnienie tego pola powoduje, iż narzędzie staje się dostępne <link linkend="advanced-editing-tools-commandline" +>w linii poleceń edytora</link +> jako <command +>exttool-<replaceable +>Nazwa linii poleceń</replaceable +></command +> (nazwa tu wprowadzona musi być poprzedzona napisem: <quote +>exttool-</quote +>) w wywołaniu linii poleceń.</para +></listitem> +</varlistentry> + +</variablelist> + +</sect2> + +</sect1> + +<sect1 id="config-dialog-editor"> +<title +>Konfiguracja edytora</title> +<para +>Ta grupa ustawień zawiera karty dotyczące konfiguracji komponentu edytora &kate;. Większość parametrów w nich określonych ma wartość domyślną, która może zostać zmieniona poprzez <link linkend="config-dialog-editor-filetypes" +>definicje typu pliku</link +>, <link linkend="config-variables" +>zmienne dokumentu</link +> lub przez ich zmianę w czasie edycji dokumentu.</para> + + +<sect2 id="config-dialog-editor-appearance"> +<title +>Wygląd</title> + +<variablelist> +<varlistentry> +<term +><guilabel +>Zawijanie wyrazów</guilabel +></term> +<listitem> +<variablelist> +<varlistentry id="appearance-settings"> +<term +><guilabel +>Dynamiczne zawijanie wyrazów</guilabel +></term> +<listitem +><para +>Powoduje, iż wiersze będą zawijane na krawędzi okna.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Znaczniki dynamicznego zawijania wyrazów</guilabel +></term> +<listitem +><para +>Wybiera sposób wyświetlania znaczników dynamicznego zawijania wyrazów. </para +></listitem +></varlistentry> +<varlistentry> +<term +><guilabel +>Wyrównaj pionowo dynamicznie zawijane wiersze do głębokości wcięć: </guilabel +></term> +<listitem +><para +>Włącza automatyczne wyrównywanie dynamicznie zawiniętych wierszy do aktualnego poziomu wcięcia tekstu. Zwiększa to czytelność kodu.</para +><para +>Dodatkowo użytkownik może ustawić procent maksymalnej szerokości ekranu, przy której dynamicznie zawijane wiersze nie będą wyrównywane w pionie. Na przykład ustawienie parametru na 50% spowoduje że poziom wcięcia głębszy niż 50% szerokości ekranu nie będzie automatycznie wyrównywany w pionie dla dynamicznie zawijanych wierszy.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Zwijanie kodu</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Pokaż znaczniki zwijania (jeśli dostępne) </guilabel +></term> +<listitem +><para +>Włączenie tej opcji spowoduje pokazanie w aktualnie edytowanym dokumencie znaczników zwijania kodu (jeżeli opcja zwijania kodu jest włączona).</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Paski boczne</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Pokaż pasek ikon </guilabel +></term> +<listitem +><para +>Włącza wyświetlanie paska ikon po lewej stronie okna edytora. Na pasku ikon widoczne są np. znaczniki zakładek.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Pokaż numery wierszy </guilabel +></term> +<listitem +><para +>Włącza pokazywanie numerów wierszy po lewej stronie okna edytora.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Pokaż znaki na pasku przewijania </guilabel +></term> +<listitem +><para +>Zaznaczenie opcji powoduje wyświetlenie znaczników na pionowym pasku przewijania. Znaczniki te wskazują m.in. na miejsce wstawienia zakładki w tekście.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Sortuj menu zakładek </guilabel +></term> +<listitem +><para> +<variablelist> +<varlistentry> +<term +><guilabel +>Według położenia </guilabel +></term> +<listitem +><para +>Zakładki zostaną posortowane w kolejności numerów wierszy, dla których zostały ustawione.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Według utworzenia </guilabel +></term> +<listitem +><para +>Każda nowa zakładka zostanie dodana na końcu listy niezależnie od miejsca jej położenia w dokumencie.</para +></listitem> +</varlistentry> +</variablelist> +</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Pokaż linie wcięć </guilabel +></term> +<listitem +><para +>Zaznaczenie tej opcji spowoduje uwidocznienie w oknie edytora linii pomagających zidentyfikować poszczególne poziomy wcięcia tekstu.</para +></listitem> +</varlistentry> +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-colors"> +<title +>Czcionki i kolory</title> + +<para +>Ta karta pozwala na konfigurację ustawień czcionek i kolorów dla poszczególnych schematów wyświetlania oraz definiowanie nowych i usuwanie istniejących schematów. Każdy schemat zawiera ustawienia dotyczące kolorów i czcionek oraz style dla tekstu normalnego i dla podświetlania składni. </para> + +<para +>Program &kate; pokaże w karcie aktywny w danym momencie schemat wyświetlania. Zmiana schematu na inny możliwa jest za pomocą rozwijanej listy <guilabel +>Schemat</guilabel +>.</para> + +<sect3 id="config-dialog-editor-colors-colors"> +<title +>Kolory</title> + +<variablelist> +<varlistentry id="config-dialog-editor-colors-colors-text-background"> +<term +><guilabel +>Tło tekstu</guilabel +></term> +<listitem> + +<variablelist> + +<varlistentry id="config-dialog-editor-colors-normal-text"> +<term +><guilabel +>Normalny tekst</guilabel +></term> +<listitem +><para +>Kolor domyślny dla tła obszaru edycyjnego. Będzie to kolor wyraźnie dominujący w oknie edytora.</para +></listitem> +</varlistentry> + +<varlistentry id="config-dialog-editor-colors-selected-text"> +<term +><guilabel +>Zaznaczony tekst</guilabel +></term> +<listitem +><para +>Tło dla zaznaczonego fragmentu tekstu. Wartości domyślne są pobierane z ustawień globalnych środowiska &kde;. </para +></listitem> +</varlistentry> + +<varlistentry id="config-dialog-editor-colors-current-line"> +<term +><guilabel +>Bieżący wiersz</guilabel +></term> +<listitem +><para +>Kolor edytowanego wiersza. Jeżeli będzie on choć trochę inny od koloru tła, to pozwoli on skupić uwagę na aktualnie edytowanym wierszu tekstu. </para +></listitem> +</varlistentry> + +<varlistentry id="config-dialog-editor-colors-marks"> +<term +><guilabel +>Zakładki</guilabel +></term> +<listitem +><para +>Rozwijana lista wyboru pozwalająca określić kolory dla różnych rodzajów zakładek. Kolor jest mieszany z kolorem tła dla zaznaczonego wiersza, tak więc bieżący wiersz, lub wiersz z kilkoma zakładkami, ma tło będące efektem zmieszania kilku kolorów. Kolor zakładek jest również wykorzystywany dla znaczników, wyświetlanych na bocznym pasku przewijania.</para +></listitem> +</varlistentry> + +</variablelist> +</listitem> +</varlistentry> + +<varlistentry id="config-dialog-editor-colors-colors-other-elements"> +<term +><guilabel +>Dodatkowe elementy</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Tło lewej krawędzi</guilabel +></term> +<listitem +><para +>Kolor wykorzystywany dla tła paska ikon, numerów wierszy i znaczników zwijania po lewej stronie edytora (jeżeli jest on widoczny). </para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Numery wierszy</guilabel +></term> +<listitem +><para +>Kolor wykorzystywany dla wyświetlania numerów wierszy na pasku po lewej stronie okna edycyjnego (jeżeli są widoczne).</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Podświetlanie nawiasów</guilabel +></term> +<listitem +><para +>Kolor wykorzystywany do podświetlania tła par odpowiadających sobie wzajemnie nawiasów w kodzie programu. </para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Znaczniki zawijanego tekstu</guilabel +></term> +<listitem +><para +>Kolor wyświetlania wzoru po lewej stronie dynamicznie zawiniętych wierszy, które zostały automatycznie wcięte i wyrównane pionowo jak również wyświetlania znacznika statycznego zawijania wyrazów.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Znaczniki tabulacji</guilabel +></term> +<listitem +><para +>W kolorze tym wyświetlane są znaczniki tabulacji. </para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +</variablelist> +</sect3> + +<sect3 id="config-dialog-editor-colors-fonts"> +<title +>Czcionka</title> +<para +>Można tutaj ustawić czcionkę dla konfigurowanego schematu. Dostępna jest lista wszystkich czcionek zainstalowanych w systemie oraz możliwość ustawienia jej stylu oraz rozmiaru. W dolnej części wyświetlany jest przykładowy tekst z użyciem wybranej czcionki, aby pokazać efekt dokonanego wyboru. </para> +</sect3> + +<sect3 id="config-dialog-editor-colors-normal-text-styles"> +<title +>Style normalnego tekstu</title> +<para +>Parametry stylu normalnego tekstu są dziedziczone przez style podświetlania składni. Pozwala to na prezentację tekstu w zwarty i przejrzysty sposób. Przykładowo tekst komentarza zawsze będzie miał ten sam kolor i wygląd we wszystkich formatach tekstowych, które można wybrać dla podświetlania składni w edytorze.</para> +<para +>Pozycja na liście stylów wyświetlania pokazana jest z użyciem skonfigurowanych kolorów i wyglądu czcionki, co pozwala na natychmiastowy podgląd stylu. </para> +<para +>Każdy styl pozwala na wybór wspólnych atrybutów dotyczących zarówno koloru tła, jak i koloru tekstu. Aby usunąć ustawienie dla koloru tła należy nacisnąć prawy przycisk myszki i skorzystać z menu kontekstowego.</para> +</sect3> + +<sect3 id="config-dialog-editor-colors-highlighting-text-styles"> +<title +>Style podświetlania tekstu</title> +<para +>Ta karta pozwala na ustawienie stylów tekstu używanych przez określoną regułę podświetlania składni. Program automatycznie wybiera regułę związaną z aktualnie edytowanym dokumentem. Aby wybrać inną regułę, należy skorzystać z listy rozwijanej <guilabel +>Podświetlenie</guilabel +> widocznej w górnej części okna. </para> +<para +>Pozycja na liście stylów wyświetlania pokazana jest z użyciem skonfigurowanych kolorów i wyglądu czcionki, co pozwala na natychmiastowy podgląd stylu. </para> +<para +>Każdy styl pozwala na wybór wspólnych atrybutów dotyczących zarówno koloru tła jak i koloru tekstu. Aby usunąć ustawienie koloru tła należy nacisnąć prawy przycisk myszki i skorzystać z menu kontekstowego. Dodatkowo dostępna jest informacja o tym, czy aktualne ustawienie jest zgodne z ustawieniem domyślnym oraz możliwość ewentualnej zmiany tego ustawienia na wartości domyślne.</para> +<para +>Reguła podświetlania może zawierać w sobie inne reguły podświetlania, co jest reprezentowane jako grupa na liście stylów podświetlania. Na przykład większość reguł podświetlania składni dziedziczy pozycję "Alert", a reguły podświetlania dla kodu źródłowego programów dziedziczą ustawienia dla formatu Doxygen. Zmiana kolorów w tych grupach dotyczy tylko stylów używanych w konfigurowanej regule podświetlania składni. </para> +</sect3> + +</sect2> + +<sect2 id="config-dialog-editor-cursor-selection"> +<title +>Kursor i zaznaczanie</title> + +<variablelist> + +<varlistentry> +<term +><guilabel +>Ruch kursora tekstu</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Sprytny klawisz Home</guilabel +></term> +<listitem> +<para +>Wybranie pozycji powoduje, iż naciśnięcie klawisza "Home" przesuwa kursor na początek tekstu w wierszu, pomijając ewentualne znaki wcięcia.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Zawijaj kursor</guilabel +></term> +<listitem> +<para +>Podczas przesuwania kursora za pomocą <emphasis role="bold" +>lewego</emphasis +> i <emphasis role="bold" +>prawego</emphasis +> klawisza strzałki będzie on przechodził na początek poprzedniego/następnego wiersza po osiągnięciu początku/końca wiersza, podobnie jak w innych edytorach tekstu.</para +><para +>Włączenie tej opcji spowoduje, iż przesuwanie kursora klawiszami strzałek poza koniec wiersza (po prawej stronie) przeniesie go w dół na początek następnego wiersza. Podobnie kiedy kursor jest przesuwany przed początek wiersza (po lewej stronie), to przeniesie się na koniec wiersza znajdującego się powyżej. Kiedy opcja ta nie jest wybrana to przesunięcie kursora w prawo spowoduje kontynuację pracy w tym samym wierszu, natomiast przesunięcie w lewo na początku wiersza jest niemożliwe. Ten tryb pracy może być użyteczny podczas pisania programów.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>PageUp/PageDown przenosi kursor</guilabel +></term> +<listitem> +<para +>Opcja ta zmienia zachowanie kursora w przypadku naciśnięcia klawiszy <keycap +>Page Up</keycap +> lub <keycap +>Page Down</keycap +>. Gdy nie jest ona zaznaczona, to kursor zachowuje względną wizualnie pozycję w oknie dokumentu &kate;. Jeżeli więc kursor znajduje się w środku okna, to po naciśnięciu tych klawiszy dalej będzie widoczny w środku okna (chyba że osiągnięty zostanie początek lub koniec dokumentu). Jeżeli opcja jest wybrana, to naciśnięcie klawiszy przesunie kursor na początek, bądź na koniec, nowo wyświetlonej w oknie strony dokumentu.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Automatycznie centruj kursor (wiersze):</guilabel +></term> +<listitem> +<para +>Określa liczbę wierszy, które program stara się pokazywać powyżej i poniżej aktualnej pozycji kursora.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Tryb zaznaczania</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Normalny</guilabel +></term> +<listitem> +<para +>Zaznaczony fragment zostanie zastąpiony przez wprowadzany tekst zaś przesunięcie kursora zlikwiduje zaznaczenie tekstu.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Trwałe zaznaczenia</guilabel +></term> +<listitem> +<para +>Zaznaczenie pozostanie aktywne nawet po przesunięciu kursora, czy też wprowadzeniu nowego tekstu.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-edit"> +<title +>Edycja</title> +<variablelist> + +<varlistentry> +<term +><guilabel +>Tabulatory</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Wstaw spacje zamiast tabulatorów</guilabel +></term> +<listitem> +<para +>Zaznaczenie tej opcji spowoduje, iż po naciśnięciu klawisza <keycap +>TAB</keycap +> edytor będzie wstawiał do tekstu określoną liczbę spacji, w zależności od pozycji oraz ustawienia parametru: <option +>Szerokość tabulacji i wcięcia</option +>.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Pokaż tabulatory</guilabel +></term> +<listitem> +<para +>Włączenie opcji spowoduje wyświetlanie przez &kate; małej kropki w miejscu występowania znaków tabulacji.</para> +<note +><para +>Opcja powoduje również wyświetlanie kropki dla znaków spacji na końcu wiersza. Zachowanie to zostanie zmienione w przyszłych wersjach &kate;.</para +></note> +</listitem> +</varlistentry> +<varlistentry> +<term id="config-dialog-editor-tab-width" +>Szerokość tabulacji i wcięcia</term +> <listitem +><para +>Jeśli włączona jest opcja <link linkend="config-dialog-editor-word-wrap" +><guilabel +>Zamień tabulacje na spacje</guilabel +></link +>, wtedy to pole określa liczbę spacji, na które edytor automatycznie zamieni każdy znak tabulacji.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term id="config-dialog-editor-word-wrap" +><guilabel +>Statyczne zawijanie wyrazów</guilabel +></term> +<listitem +><para +>Zawijania wyrazów to funkcja powodująca, iż edytor automatycznie rozpoczyna nowy wiersz tekstu i przenosi (zawija) kursor na jego początek. Program &kate; automatycznie rozpocznie nowy wiersz tekstu, jeżeli liczba znaków w bieżącym wierszu osiągnie wielkość zdefiniowaną w polu: <link linkend="config-dialog-editor-wrap-words-at" +>Zawijaj wyrazy na:</link +>.</para> +<variablelist> +<varlistentry> +<term +><guilabel +>Włącz statyczne zawijanie wyrazów</guilabel +></term> +<listitem> +<para +>Opcja włącza lub wyłącza statyczne zawijanie wyrazów.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Pokaż znaczniki statycznego zawijania wyrazów</guilabel +></term> +<listitem> +<para +>Zaznaczenie tej opcji spowoduje wyświetlanie pionowej linii w miejscu określonym przez parametr "kolumna zawijania" w menu <menuchoice +> <guimenu +>Ustawienia</guimenu +> <guimenuitem +>Konfiguracja &kate;...</guimenuitem +></menuchoice +> (w karcie: "Edycja"). Znacznik zawijania wyrazów jest wyświetlany tylko w przypadku stosowania czcionki o stałej szerokości.</para> +</listitem> +</varlistentry> +<varlistentry id="config-dialog-editor-wrap-words-at"> +<term +><guilabel +>Zawijaj wyrazy na:</guilabel +></term> +<listitem> +<para +>Jeśli opcja <link linkend="config-dialog-editor-word-wrap" +>Zawijanie wyrazów</link +> jest wybrana, to w tym polu określa się liczbę znaków, przy której edytor automatycznie rozpocznie nowy wiersz.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Usuń spacje na końcu wiersza</guilabel +></term> +<listitem +><para +>Włączenie tej opcji powoduje, że &kate; automatycznie usunie dodatkowe spacje na końcu wiersza tekstu.</para +></listitem +> </varlistentry> + +<varlistentry> +<term +><guilabel +>Automatyczne nawiasy</guilabel +></term +> <listitem +><para +>Włączenie tej opcji powoduje, że po wpisaniu lewego nawiasu ([, (, lub {) &kate; automatycznie doda prawy nawias (odpowiednio: }, ), lub ]) po prawej stronie kursora.</para +></listitem> +</varlistentry> + +<varlistentry +> <term +>Liczba operacji <link linkend="undo" +>cofnięć</link +>:</term> +<listitem +><para +>Ta opcja określa liczbę możliwych w programie &kate; operacji wycofania pisania tekstu lub innych działań. Im większa liczba, tym więcej pamięci program przeznaczy na przechowywanie historii operacji. Ustawienie opcji na 10 spowoduje, iż użytkownik będzie mógł wycofać 10 poprzednich operacji naciskając dziesięciokrotnie przycisk <guibutton +>Cofnij</guibutton +>.</para +></listitem +> </varlistentry> + +<varlistentry +> <term +>Sprytne wyszukiwanie tekstu od:</term> +<listitem +><para +>Pozwala na określenie źródła tekstu, który &kate; wstawi automatycznie w oknie dialogowym wyszukiwania. Dostępne są następujące opcje:<itemizedlist +> <listitem +><para +><emphasis role="bold" +>Nigdzie:</emphasis +> Żaden tekst nie zostanie wstawiony.</para +></listitem +> <listitem +><para +><emphasis role="bold" +>Tylko zaznaczenie:</emphasis +> Używa zaznaczonego fragmentu jako tekstu wyszukiwanego. </para +></listitem +> <listitem +><para +><emphasis role="bold" +>Zaznaczenie, potem bieżące słowo:</emphasis +> Używa zaznaczonego fragmentu (jeżeli dostępny), w przeciwnym wypadku wprowadza bieżące słowo. </para +></listitem +> <listitem +><para +><emphasis role="bold" +>Tylko bieżące słowo:</emphasis +> Używa słowa, na którym aktualnie znajduje się kursor. </para +></listitem +> <listitem +><para +><emphasis role="bold" +>Bieżące słowo, potem zaznaczenie:</emphasis +> Używa bieżącego słowa, a jeśli brak słowa w pozycji kursora to zaznaczenia. </para +></listitem +> </itemizedlist +> Dla wszystkich powyższych trybów, jeżeli program nie może ustalić poszukiwanego tekstu, to w oknie dialogowym wyszukiwania pojawi się poprzednio wyszukiwany tekst (zachowanie domyślne). </para +></listitem> +</varlistentry> +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-indent"> +<title +>Wcięcia</title> +<variablelist> +<varlistentry> +<term +><guilabel +>Automatyczne wcięcia</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Tryb wcięć:</guilabel +></term> +<listitem> +<para +>Pozwala na określenie domyślnie stosowanego trybu wcięć. Zalecane jest ustawienie tutaj <userinput +>Brak</userinput +> lub <userinput +>Normalny</userinput +> i ustawienie reguł wcięć w konfiguracji typów plików dla takich formatów jak kod programu w C/C++ czy &XML;.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Wstaw otwierający znak Doxygen "*" w czasie pisania</guilabel +></term> +<listitem> +<para +>Automatycznie wstawia otwierający znak Doxygen "*" w czasie pisania komentarzy w formacie Doxygena. Opcja jest aktywna tylko jeśli ma zastosowanie.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Wcięcia spacjami</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Używa znaków spacji zamiast znaków Tab do generowania wcięć</guilabel +></term> +<listitem> +<para +>Powoduje zamianę znaku tabulacji na zdefiniowaną poniżej <guilabel +>Liczbę spacji:</guilabel +>.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Tryb mieszany w stylu Emacsa</guilabel +></term> +<listitem> +<para +>Powoduje użycie zarówno znaków tabulacji, jak i spacji dla wcięć.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Liczba spacji:</guilabel +></term> +<listitem> +<para +>Pozwala na ustawienie liczby spacji używanych do generowania wcięć przy włączonej opcji <guilabel +>Użyj spacji zamiast znaków Tab do wcięć</guilabel +>.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Utrzymuj profil wcięć</guilabel +></term> +<listitem +><para +>Zaznaczenie tej opcji powoduje, że program nie będzie usuwał wcięć w zaznaczonym fragmencie tekstu, jeżeli najmniej wcięty wiersz znajdzie się na początku wiersza (bez wcięcia). Może to być przydatne w przypadku usuwania wcięć w dużych fragmentach kodu programu. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Pozostaw dodatkowe spacje</guilabel +></term> +<listitem +><para +>Wcięcie większe niż wybrana liczba spacji nie będzie zmniejszone.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Klawisze do użycia</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Wcięcie tabulatorami</guilabel +></term> +<listitem> +<para +>Pozwala na użycie klawisza <keycombo action="simul" +><keycap +>Tab</keycap +></keycombo +> do wstawiania wcięć.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Wcięcia Backspace'm</guilabel +></term> +<listitem> +<para +>Pozwala na użycie klawisza <keycombo action="simul" +><keycap +>Backspace</keycap +></keycombo +> do zmniejszania wcięć.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Tryb klawisza Tab jeżeli nic nie jest wybrane</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Wstaw znaki wcięcia</guilabel +></term> +<listitem> +<para +>Powoduje iż naciśnięcie klawisza <keycombo action="simul" +><keycap +>Tab</keycap +></keycombo +> wprowadza znaki wcięcia.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Wstaw znak tabulacji</guilabel +></term> +<listitem> +<para +>Powoduje iż naciśnięcie klawisza <keycombo action="simul" +><keycap +>Tab</keycap +></keycombo +> wprowadza znaki tabulacji.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Wysuń bieżący wiersz</guilabel +></term> +<listitem> +<para +>Powoduje iż naciśnięcie klawisza <keycombo action="simul" +><keycap +>Tab</keycap +></keycombo +> wcina bieżący wiersz.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-open-save"> +<title +>Otwórz/Zapisz</title> + +<variablelist> + +<varlistentry> +<term +><guilabel +>Format pliku</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Kodowanie:</guilabel +></term> +<listitem> +<para +>Ustawia domyślne kodowanie znaków dla plików.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Koniec wiersza:</guilabel +></term> +<listitem> +<para +>Konfiguruje sposób zapisywania znaków końca wiersza w aktywnym dokumencie. Dostępny jest wybór pomiędzy trybami: &UNIX;, DOS/&Windows; i Macintosh.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Automatyczne wykrywanie końca wiersza</guilabel +></term> +<listitem> +<para +>Włączenie tej opcji powoduje, iż edytor będzie automatycznie wykrywał sposób kodowania końca wiersza. Pierwszy znaleziony w dokumencie znak końca wiersza będzie wykorzystany dla całego dokumentu.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Zużycie pamięci</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Najwięcej załadowanych bloków na plik:</guilabel +></term> +<listitem> +<para +>Program załaduje określoną przez ten parametr liczbę bloków (po około 2048 wierszy każdy) tekstu do pamięci. Jeżeli rozmiar pliku jest większy od ustawionej tu wartości, to pozostałe bloki zostaną zapisane na dysk i załadowane później w razie potrzeby.</para> +<para +>Może to powodować opóźnienia w trakcie poruszania się po dokumencie. Większa liczba bloków zwiększa szybkość kosztem zużycia pamięci. </para +><para +>W większości przypadków wybranie największej możliwej wartości jest ustawieniem optymalnym. Należy ją zmniejszyć w przypadku problemów z brakiem pamięci.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Automatyczne czyszczenie przy zapisie/odczycie</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Usuń spacje na końcu wiersza</guilabel +></term> +<listitem> +<para +>&kate; automatycznie usunie dodatkowe spacje na końcu wierszy w całym tekście podczas operacji zapisu lub odczytu pliku.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Plik konfiguracyjny katalogu</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Głębokość szukania pliku konfiguracyjnego:</guilabel +></term> +<listitem> +<para +>Program będzie sprawdzał podaną liczbę katalogów nadrzędnych w celu znalezienia pliku konfiguracji &kate; i wczytania znajdujących się w nim ustawień.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Kopia zapasowa przy zapisie</guilabel +></term> +<listitem +><para +>Funkcja ta spowoduje, iż &kate; skopiuje plik oryginalny przed zapisaniem dokonanych zmian w tekście. Nazwa pliku kopii będzie ustalona w sposób następujący: '<przedrostek><nazwapliku><przyrostek>'. Przedrostek domyślnie nie jest określony, zaś domyślny przyrostek to <emphasis role="bold" +>~</emphasis +>. </para> +<variablelist> +<varlistentry> +<term +><guilabel +>Pliki lokalne</guilabel +></term> +<listitem> +<para +>Włącza tworzenia kopii zapasowej dla plików lokalnych.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Zdalne pliki</guilabel +></term> +<listitem> +<para +>Włącza tworzenie kopii zapasowej dla plików zdalnych.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Przedrostek</guilabel +></term> +<listitem> +<para +>Tekst dodany przed nazwą pliku oryginalnego przy tworzeniu kopii zapasowej.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Przyrostek</guilabel +></term> +<listitem> +<para +>Tekst dodany do nazwy pliku oryginalnego przy tworzeniu kopii zapasowej.</para> +</listitem> +</varlistentry> + +</variablelist> +</listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-highlighting"> +<title +>Podświetlenie</title> +<para +>Poniższe ustawienia stosowane są do konfiguracji reguł podświetlania składni dla różnych rodzajów dokumentu. Zmiany dokonane w tej karcie dotyczą jedynie jednego wybranego typu dokumentu.</para> + +<variablelist> +<varlistentry> +<term +><guilabel +>Podświetlenie:</guilabel +></term> +<listitem +><para +>Pole listy rozwijanej pozwalające wybrać rodzaj dokumentu/języka programowania,dla którego dokonywana jest zmiana ustawień.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Informacje</guilabel +></term> +<listitem> +<para +>Wyświetla informacje o wybranej regule podświetlania: nazwisko autora oraz rodzaj licencji. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Właściwości</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Rozszerzenia nazw pliku:</guilabel +></term> +<listitem +><para +>Pozwala na określenie rozszerzeń nazw plików związanych z daną regułą podświetlania składni, co pozwala na automatyczny wybór reguły w momencie otwierania pliku.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Typy MIME:</guilabel +></term> +<listitem +><para +>Naciśnięcie przycisku po prawej stronie pola wyboru otwiera okno dialogowe asystenta, pozwalające wybrać typy MIME z listy dostępnych typów.</para +><para +>Pole <emphasis role="bold" +>Rozszerzenia nazw plików</emphasis +> będzie automatycznie uzupełnione zgodnie z wybranymi typami MIME.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Priorytet:</guilabel +></term> +<listitem +><para +>Ustawia priorytet dla danej reguły podświetlania.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>Pobierz...</guibutton +></term> +<listitem> +<para +>Naciśnięcie tego przycisku pozwala na pobranie nowych lub zaktualizowanych reguł podświetlania składni ze strony WWW programu &kate;. </para> +</listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-filetypes"> +<title +>Typy plików</title> +<para +>Ta karta pozwala na modyfikację konfiguracji domyślnej dla dokumentu, w zależności od typu MIME pliku. Kiedy program wczyta dokument, to przeszuka maski filtra plików lub listę typów MIME w poszukiwaniu zdefiniowanego rodzaju pliku, a następnie zmieni konfigurację zgodnie z wprowadzonymi zmiennymi. Jeżeli dopasowane zostanie kilka typów, to wybierany jest ten o najwyższym priorytecie. </para> +<variablelist> +<varlistentry> +<term +><guilabel +>Typ pliku:</guilabel +></term> +<listitem +><para +>Typ pliku dla którego ustawiono najwyższy priorytet wyświetla się na pierwszym miejscu rozwijanej listy. Jeżeli istnieje więcej typów, to również są one wyświetlane.</para> +<variablelist> +<varlistentry> +<term +><guilabel +>Nowy</guilabel +></term> +<listitem +><para +>Pozwala na utworzenie nowego typu pliku. Po naciśnięciu przycisku wartości w polach znajdujących się poniżej zostają usunięte i można w nich wprowadzić ustawienia związane z nowo tworzonym typem pliku.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Usuń</guilabel +></term> +<listitem +><para +>Aby usunąć zdefiniowany wcześniej typ pliku należy wybrać go korzystając z listy rozwijanej, a następnie nacisnąć przycisk Usuń.</para +></listitem> +</varlistentry> +</variablelist> +</listitem +> </varlistentry> + +<varlistentry> +<term +><guilabel +>Właściwości wybranego typu pliku</guilabel +></term> +<listitem +><para +>Typ pliku dla którego ustawiono najwyższy priorytet wyświetla się na pierwszym miejscu rozwijanej listy. Jeżeli istnieje więcej typów, to również są one wyświetlane.</para> +<variablelist> +<varlistentry> +<term +><guilabel +>Nazwa:</guilabel +></term> +<listitem +><para +>Nazwa typu pliku, która pojawia się jako pozycja w menu <menuchoice +><guimenu +>Narzędzia</guimenu +><guimenuitem +>Typ pliku</guimenuitem +> </menuchoice +></para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Sekcja:</guilabel +></term> +<listitem +><para +>Nazwa sekcji pozwala na właściwą organizację wyświetlania typów plików w menu. Jest wykorzystywana do wyświetlania menu <menuchoice +> <guimenu +>Narzędzia</guimenu +> <guimenuitem +>Typy plików</guimenuitem +> </menuchoice +>.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Zmienne:</guilabel +></term> +<listitem +><para +>Pole pozwala na dostosowanie konfiguracji &kate; do określonego typu MIME. Możliwe jest określenie dowolnej opcji konfiguracyjnej takiej jak np. podświetlanie, reguły wcięć, kodowanie, itp.</para +><para +>Pełna lista dostępnych zmiennych konfiguracyjnych dostępna jest w podręczniku.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Rozszerzenia nazw pliku:</guilabel +></term> +<listitem +><para +>Maska filtra plików pozwala otwierać pliki z użyciem tylko nazwy. Typowa maska wykorzystuje gwiazdkę oraz rozszerzenie nazwy, przykładowo: <filename +>*.txt; *.text</filename +>. W polu tym wprowadza się listę masek rozdzieloną średnikami.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Typy MIME:</guilabel +></term> +<listitem +><para +>Naciśnięcie przycisku asystenta po prawej stronie pola wyboru wyświetla okno dialogowe pozwalające na łatwy wybór typów MIME.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Priorytet:</guilabel +></term> +<listitem +><para +>Konfiguruje priorytet dla danego typu pliku. Jeżeli do danego pliku można dopasować kilka typów, to wybierany jest ten o najwyższym priorytecie.</para +></listitem> +</varlistentry> +</variablelist> +</listitem +> </varlistentry> + +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-shortcuts"> +<title +>Skróty klawiszowe</title> +<para +>Możliwa jest tutaj zmiana konfiguracji skrótów klawiszowych. Wybranie tego polecenia i zaznaczenie pola opcji: <guilabel +>Własny</guilabel +> powoduje otwarcie okna, w którym użytkownik definiuje własną kombinację klawiszy dla danego polecenia.</para> +<para +>Pole wyszukiwania pozwala na szybkie odszukanie polecenia i sprawdzenie jego skrótu klawiszowego.</para> +</sect2> + +<sect2 id="config-dialog-editor-plugins"> +<title +>Wtyczki</title> +<para +>W tej karcie pojawi się lista wszystkich dostępnych wtyczek. Można je w tym oknie włączyć. Po włączeniu wtyczki przycisk <guibutton +>Konfiguruj</guibutton +> staje się aktywny dzięki czemu można skonfigurować wybraną wtyczkę.</para> +</sect2> + +</sect1> + + + +<sect1 id="config-variables"> + +<title +>Konfiguracja programu za pomocą zmiennych</title> + +<para +>Mechanizm zmiennych dokumentu w &kate; oparty jest na mechanizmie wierszy konfiguracyjnych znanym z programów Emacs i vi. W &kate; format wiersza konfiguracyjnego ma postać: <userinput +>kate: NAZWAZMIENNEJ WARTOŚĆ; [ NAZWAZMIENNEJ WARTOŚĆ; ... ]</userinput +>. Ich treść może być oczywiście umieszczona w linii komentarza zgodnym z formatem edytowanego pliku. Nazwy zmiennych określane są jednym słowem (bez spacji) zaś cała treść do średnika stanowi wartość dla tej zmiennej. Średnik jest wymagany.</para> + +<para +>Poniżej znajduje się przykładowy wiersz zawierający zmienne konfiguracyjne zmieniający ustawienia wcięć dla pliku C++, Java lub Javascript: <programlisting +>// kate: space-indent on; indent-width 4; mixedindent off; indent-mode cstyle;</programlisting> +</para> + +<note +><para +>Program sprawdza tylko pierwsze 10 lub ostatnie 10 wierszy dokumentu w poszukiwaniu zmiennych konfiguracyjnych.</para +></note> + +<para +>Zmienne dokumentu odnoszą się do niemal wszystkich parametrów konfiguracji komponentu edytora. Dodatkowe zmienne mogą być wykorzystywane przez wtyczki, jednak w takim wypadku informacje na ich temat powinny być dostępne w dokumentacji wtyczek.</para> + +<sect2 id="config-variables-howto"> +<title +>Jak program &kate; wykorzystuje zmienne</title> + +<para +>Komponent edytora poszukuje parametrów konfiguracyjnych w następujących miejscach (i w podanej kolejności): <itemizedlist +> <listitem +><para +>Konfiguracja ogólna.</para +></listitem +> <listitem +><para +>Opcjonalne dane sesji.</para +></listitem +> <listitem +><para +>Konfiguracja typów pliku.</para +></listitem +> <listitem +><para +>Zmienne dokumentu znajdujące się w pliku.</para +></listitem +> <listitem +><para +>Zmiany konfiguracji z menu lub linii poleceń.</para +></listitem +> </itemizedlist +>Wynika z tego, iż zmienne dokumentu mają drugi z kolei poziom ważności. Kiedykolwiek dokument jest zapisywany to zmienne dokumentu są wczytywane ponownie i unieważniają zmiany ustawień dokonane w menu lub z linii poleceń.</para> + +<para +>Wszystkie pozostałe, nie opisane poniżej, zmienne zapisane w dokumencie mogą być odczytywane przez wtyczki i wykorzystywane do ich celów. Na przykład tryby wcięć na podstawie zmiennych wykorzystuje zmienne dokumentu do konfiguracji.</para> + +<para +>Poniżej opisane zmienne dotyczą programu &kate; w wersji 2.4. W przyszłości mogą zostać dodane kolejne zmienne. Wartości zapisywane do zmiennych mogą być następujące: <itemizedlist> +<listitem +><para +>BOOL - przyjmuje wartości: on|off|true|false|1|0</para +></listitem> +<listitem +><para +>INTEGER - dowolna liczba całkowita</para +></listitem> +<listitem +><para +>STRING - wszystkie inne napisy</para +></listitem> +</itemizedlist> +</para> + +<variablelist> +<title +>Dostępne zmienne konfiguracyjne</title> + +<varlistentry> +<term +><cmdsynopsis +><command +>auto-brackets</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza automatyczne wstawianie nawiasów.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>auto-center-lines</command +><arg +>INT</arg +></cmdsynopsis +></term> +<listitem +><para +>Określa liczbę wierszy, które program stara się pokazywać powyżej i poniżej aktualnej pozycji kursora.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>auto-insert-doxygen</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Automatycznie wstawia otwierający znak Doxygen "*" w czasie pisania komentarzy w formacie Doxygena. Opcja ta działa tylko w przypadku użycia trybu "cstyle" dla automatycznych wcięć. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>background-color</command +><arg +>STRING</arg +></cmdsynopsis +></term> +<listitem +><para +>Ustawia kolor tła. Wartość musi w poprawny sposób określać kolor, np.: "#ff0000".</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>backspace-indents</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza zmniejszanie wcięć klawiszem Backspace.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>block-selection</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza tryb zaznaczania bloku.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>bracket-highlight-color</command +><arg +>STRING</arg +></cmdsynopsis +></term> +<listitem +><para +>Ustawia kolor dla podświetlanych nawiasów. Wartość musi w poprawny sposób określać kolor, np.: "#ff0000" </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>current-line-color</command +><arg +>STRING</arg +></cmdsynopsis +></term> +<listitem +><para +>Ustawia kolor wyświetlania bieżącego wiersza. Wartość musi w poprawny sposób określać kolor, np.: "#ff0000".</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>dynamic-word-wrap</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza dynamiczne zawijanie wyrazów.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>eol | end-of-line</command +><arg +>STRING</arg +></cmdsynopsis +></term> +<listitem +><para +>Ustawia tryb kodowania końca wiersza. Dostępne ustawienia to: <quote +>unix</quote +>, <quote +>mac</quote +> oraz <quote +>dos</quote +></para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>encoding</command +><arg +>STRING</arg +></cmdsynopsis +></term> +<listitem +><para +>Ustawia kodowanie znaków w dokumencie. Wartość musi zawierać poprawną nazwę kodowania, np.: <quote +>utf-8</quote +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>font-size</command +><arg +>INT</arg +></cmdsynopsis +></term> +<listitem +><para +>Określa rozmiar czcionki dla dokumentu w punktach.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>font</command +><arg +>STRING</arg +></cmdsynopsis +></term> +<listitem +><para +>Ustawia rodzaj czcionki dla wyświetlania dokumentu. Wartość musi zawierać poprawną nazwę czcionki np.: <quote +>courier</quote +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>icon-bar-color</command +><arg +>STRING</arg +></cmdsynopsis +></term> +<listitem +><para +>Ustawia kolor dla paska ikon. Wartość musi w poprawny sposób określać kolor, np.: "#ff0000".</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>icon-border</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza wyświetlanie paska ikon.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>folding-markers</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza wyświetlanie znaczników zwijania kodu.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>indent-mode</command +><arg +>STRING</arg +></cmdsynopsis +></term> +<listitem +><para +>Ustawia tryb automatycznych wcięć. Rozpoznawane tryby wcięć to: <quote +>none</quote +>, <quote +>normal</quote +>, <quote +>cstyle</quote +>, <quote +>csands</quote +>, <quote +>python</quote +>, <quote +>xml</quote +> Więcej informacji na temat automatycznych wcięć w sekcji <xref linkend="kate-part-autoindent"/>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>indent-width</command +><arg +>INT</arg +></cmdsynopsis +></term> +<listitem +><para +>Ustawia szerokość wcięć.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>keep-extra-spaces</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza pozostawianie dodatkowych spacji podczas obliczania szerokości wcięcia.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>keep-indent-profile</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Zabezpiecza przez usunięciem wcięcia dla bloku jeżeli jest w nim nawet jeden wiersz bez wcięcia.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>line-numbers</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza wyświetlanie numerów wierszy.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>mixed-indent</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza mieszane wcięcia w stylu Emacsa.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>overwrite-mode</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza tryb zastępowania.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>persistent-selection</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza funkcję trwałego zaznaczenia.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>remove-trailing-space</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza dynamiczne czyszczenia końca wiersza.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>replace-tabs-save</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza konwersję znaków tabulacji na spacje przy zapisywaniu pliku.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>replace-tabs</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza dynamiczną konwersję tabulacji na spacje.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>replace-trailing-space-save</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza funkcję czyszczenia końców wierszy przy zapisywaniu pliku.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>scheme</command +><arg +>STRING</arg +></cmdsynopsis +></term> +<listitem +><para +>Ustawia zestaw kolorów. Parametr musi określać istniejący zestaw kolorów, w przeciwnym wypadku nic się nie zmieni.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>selection-color</command +><arg +>STRING</arg +></cmdsynopsis +></term> +<listitem +><para +>Ustawia kolor dla zaznaczenia. Wartość musi w poprawny sposób określać kolor, np.: "#ff0000".</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>show-tabs</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza wyświetlanie znaku tabulacji.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>smart-home</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza nawigację za pomocą sprytnego klawisza Home.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>space-indent</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza tworzenie wcięć za pomocą spacji.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>tab-indents</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza tworzenie wcięć za pomocą klawisza tabulacji.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>tab-width</command +><arg +>INT</arg +></cmdsynopsis +></term> +<listitem +><para +>Ustawia szerokość wyświetlania znaku tabulacji.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>undo-steps</command +><arg +>INT</arg +></cmdsynopsis +></term> +<listitem +><para +>Ustawia liczbę zapamiętanych operacji dla polecenia "Cofnij".</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>word-wrap-column</command +><arg +>INT</arg +></cmdsynopsis +></term> +<listitem +><para +>Ustawia liczbę znaków po której nastąpi statyczne zawinięcie wyrazów.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>word-wrap-marker-color</command +><arg +>STRING</arg +></cmdsynopsis +></term> +<listitem +><para +>Ustawia kolor znacznika zawijania wyrazów. Wartość musi w poprawny sposób określać kolor, np.: "#ff0000".</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>word-wrap</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza statyczne zawijanie wyrazów.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>wrap-cursor</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Włącza lub wyłącza zawijanie kursora.</para +></listitem> +</varlistentry> + +</variablelist> + +</sect2> + +</sect1> + +</chapter> diff --git a/tde-i18n-pl/docs/tdebase/kate/fundamentals.docbook b/tde-i18n-pl/docs/tdebase/kate/fundamentals.docbook new file mode 100644 index 00000000000..4e87fe0dbec --- /dev/null +++ b/tde-i18n-pl/docs/tdebase/kate/fundamentals.docbook @@ -0,0 +1,1099 @@ +<chapter id="fundamentals"> +<chapterinfo> +<authorgroup> +<author +><personname +><firstname +></firstname +></personname +></author> +<othercredit role="translator" +><firstname +>Suse</firstname +><surname +>Polska</surname +><affiliation +><address +><email +>suse@suse.pl</email +></address +></affiliation +><contrib +>Polskie tłumaczenie</contrib +></othercredit +> <othercredit role="translator" +><firstname +>Krzysztof</firstname +><surname +>Woźniak</surname +><affiliation +><address +><email +>wozniakk@ceti.pl</email +></address +></affiliation +><contrib +>Polskie tłumaczenie</contrib +></othercredit +> +</authorgroup> +</chapterinfo> +<title +>Podstawy</title> + +<para +>Użytkownik, który kiedykolwiek korzystał z innego edytora tekstu nie powinien mieć problemów przy korzystaniu z &kate;. W dwóch kolejnych sekcjach: <link linkend="starting-kate" +> Uruchamianie &kate;</link +> i <link linkend="working-with-kate" +> Korzystanie z &kate;</link +> przedstawione są najważniejsze informacje niezbędne do szybkiego rozpoczęcia pracy z programem. </para> + +<sect1 id="starting-kate"> +<title +>Uruchamianie &kate;</title> + +<para +>Program &kate; można uruchomić korzystając z <guimenu +>Menu KDE</guimenu +> lub linii poleceń. </para> + +<sect2 id="starting-from-the-menu"> +<title +>Uruchamianie z menu</title> +<para +>Kliknięcie na główne menu środowiska &kde; (ikona <guiicon +>dużej litery K</guiicon +> na pasku zadań na dole po lewej stronie ekranu) spowoduje wyświetlenie zainstalowanych w systemie <guimenu +> programów</guimenu +>. Następnie należy przesunąć kursor na pozycję <guimenu +>Narzędzia</guimenu +> i z wyświetlonej listy wybrać pozycję <guimenuitem +>&kate; (Zaawansowany edytor tekstu)</guimenuitem +>. </para> + +<para +>Po uruchomieniu &kate; wczytane zostaną ostatnio używane pliki. Można wyłączyć takie zachowanie. Więcej informacji na ten temat dostępne jest w sekcji <link linkend="configure" +>Konfiguracja &kate;</link +>. </para> + +</sect2> + +<sect2 id="starting-from-the-command-line"> +<title +>Uruchamianie z linii poleceń</title> + +<para +>Program można uruchomić wpisując jego nazwę w linii poleceń. Jeśli dodatkowo podana zostanie nazwa pliku to program otworzy wskazany plik lub utworzy nowy (jeżeli ten plik nie istnieje). Poniżej przedstawiono przykładowe wywołanie programu &kate; w linii poleceń. </para> + +<informalexample> +<screen +><prompt +>%</prompt +><userinput +><command +>kate</command +> <option +><replaceable +>mój_plik.txt</replaceable +></option +></userinput +> +</screen> +</informalexample> + +<para +>Jeżeli dostępne jest połączenie sieciowe i użytkownik posiada odpowiednie uprawnienia to można wykorzystać mechanizm przezroczystości sieciowej środowiska &kde; do otwierania plików w sieci Internet. Poniżej przykładowe wywołanie otwierające zdalny plik w sieci. </para> + +<informalexample> +<screen +><prompt +>%</prompt +><userinput +><command +>kate</command +> <option +><replaceable +>ftp://ftp.kde.org/pub/kde/README_FIRST</replaceable +></option +></userinput +> +</screen> +</informalexample> + +<sect3 id="command-line-options"> +<title +>Opcje linii poleceń</title> +<para +>Program &kate; obsługuje następujące opcje w linii poleceń:</para> + +<variablelist> +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--help</option +></userinput +></term> +<listitem> +<para +>Wyświetla listę dostępnych podstawowych opcji uruchamiania. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--help-qt</option +></userinput +></term> +<listitem> +<para +>Lista dostępnych opcji dotyczących współpracy &kate; z biblioteką &Qt;. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--help-kde</option +></userinput +></term> +<listitem> +<para +>Lista dostępnych opcji dotyczących zachowania &kate; w środowisku &kde;. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>-s</option +> <option +>--start</option +> <parameter +>nazwa_sesji</parameter +></userinput +></term> +<listitem> +<para +>Uruchamia &kate; otwierając określoną w poleceniu sesję. Jeżeli podana sesja nie istnieje to zostanie utworzona. Jeżeli aktywna jest instancja &kate;, w której uruchomiona jest określona w poleceniu sesja to podane pliki zostaną wczytane przez tę instancję. Jeżeli podano opcję <option +>--use</option +> to również zostanie użyta instancja zawierająca sesję o podanej nazwie (patrz opis opcji <option +>--use</option +>). </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>-u</option +> <option +>--use</option +> <parameter +>URL</parameter +></userinput +></term> +<listitem> +<para +>Powoduje użycie aktywnej instancji programu &kate;. Jeżeli chcesz otwierać wszystkie dokumenty w jednej instancji &kate;, to możesz takie zachowanie określić w konfiguracji programu, jak również można utworzyć odpowiedni alias dla polecenia w powłoce tekstowej (jeżeli powłoka daje takie możliwości). </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>-p</option +> <option +>--pid</option +> <parameter +>PID</parameter +></userinput +></term> +<listitem> +<para +>Powoduje użycie aktywnej instancji programu &kate; ale tylko o podanym numerze procesu <replaceable +>PID</replaceable +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--encoding</option +> <parameter +>encoding</parameter +> <parameter +>URL</parameter +></userinput +></term> +<listitem +><para +>Określa sposób kodowania znaków dla otwieranego pliku. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--line</option +> <parameter +>wiersz</parameter +> <parameter +>URL</parameter +></userinput +></term> +<listitem +><para +>Powoduje przejście do podanego wiersza po otwarciu dokumentu. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--column</option +> <parameter +>kolumna</parameter +> <parameter +>URL</parameter +></userinput +></term> +<listitem +><para +>Powoduje przejście do podanej kolumny po otwarciu dokumentu. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--stdin</option +></userinput +></term> +<listitem +><para +>Pobiera tekst dokumentu ze standardowego wejścia <filename +>STDIN</filename +>. Jest to mechanizm używany przez wiele programów uruchamianych z linii poleceń, który pozwala przekierowywać wyjście innych programów do &kate;.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--tempfile</option +></userinput +></term> +<listitem +><para +>Począwszy od wersji 2.5.1 programu &kate; dostępna jest ta standardowa dla środowiska &kde; opcja. Użycie jej spowoduje traktowanie otwieranych plików jako tymczasowych i ich kasowanie przy zamykaniu (ale tylko jeżeli są lokalne, a użytkownik posiada odpowiednie uprawnienia). Plik nie będzie kasowany, jeżeli został zmodyfikowany po otworzeniu.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--help-all</option +></userinput +></term> +<listitem> +<para +>Wyświetla listę wszystkich opcji dostępnych w linii poleceń. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--author</option +></userinput +></term> +<listitem> +<para +>Wyświetli listę autorów programu &kate;. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>-v</option +> <option +>--version</option +></userinput +></term> +<listitem> +<para +>Wyświetla informacje o numerze wersji bibliotek &Qt;, &kde;, oraz &kate;. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--license</option +></userinput +></term> +<listitem> +<para +>Pokazuje licencję programu. </para> +</listitem> +</varlistentry> +</variablelist> +</sect3> +</sect2> + +<sect2 id="drag-and-drop"> +<title +>Przeciągnij i upuść</title> +<para +>Program &kate; używa standardowego protokołu przeciągnij i upuść środowiska &kde;. Pliki mogą być przenoszone i upuszczane bezpośrednio do &kate; z pulpitu, z programu &konqueror; lub serwera FTP otwartego w programie &konqueror;. </para> +</sect2> +</sect1> + +<sect1 id="working-with-kate"> +<title +>Korzystanie z &kate;</title> +<para +>W części <link linkend="quick-start" +>Szybki start</link +> przedstawiono jak włączyć cztery proste opcje pozwalające skonfigurować najważniejsze funkcje &kate;. W sekcji: <link linkend="keystroke-commands" +>Skróty klawiszowe</link +> omówiono podstawowe skróty klawiszowe przydatne dla osób, które nie chcą korzystać z myszy. </para> + +<sect2 id="quick-start"> +<title +>Szybki start</title> + +<para +>W tej części opisano niektóre pozycje z menu <guimenu +>Ustawienia</guimenu +> pozwalające na konfigurację &kate; i dostosowanie programu do wymagań użytkownika. </para> + +<para +>Po uruchomieniu &kate; wyświetlane są dwa okna z białym tłem. Nad tymi oknami znajduje się pasek narzędzi, a powyżej pasek menu. </para> + +<para +>Okno po lewej to tak zwany pasek boczny zawierający listę dokumentów i przeglądarkę systemu plików. Przełączanie pomiędzy listą dokumentów i przeglądarką plików odbywa się za pomocą zakładek znajdujących się po lewej stronie okna. </para> + +<para +>Po otwarciu pliku, w prawym oknie pokaże się jego zawartość, a na liście dokumentów w lewym oknie nazwa tego pliku. Korzystając z przeglądarki systemu plików można otwierać następne pliki do edycji. </para> + +<para +>Możliwe jest chowanie i pokazywanie okna listy dokumentów i przeglądarki systemu plików za pomocą menu <menuchoice +><guimenu +>Okno</guimenu +> <guisubmenu +>Widoki narzędzi</guisubmenu +></menuchoice +>. To menu daje także pogląd na inne możliwości &kate; i pokazuje elastyczność programu. W tym rozdziale omówione zostaną następujące elementy: </para> + +<variablelist> + +<varlistentry> +<term> +<menuchoice> +<guimenuitem +>Pokaż/Ukryj panel Dokumenty</guimenuitem> +</menuchoice> +</term> +<listitem> +<para +>Włącza i wyłącza widok listy dokumentów. Jeżeli lista dokumentów lub przeglądarka systemu plików nie są widoczne, to &kate; wyświetli boczny pasek jako osobne niezadokowane okno. Aby zadokować okno należy nacisnąć i przytrzymać lewy klawisz myszki na dwóch równoległych liniach obok paska narzędzi, przesunąć okno nad obszar edycyjny i puścić klawisz myszki po ustawieniu okna w wymaganej pozycji. </para> + +<tip> +<para +>Poprawne przyciśnięcie równoległych linii dla operacji przeciągnij i upuść sygnalizowane jest zmianą kształtu kursora na dwie skrzyżowane strzałki. </para> +</tip> + +</listitem> +</varlistentry> +<varlistentry> +<term +><menuchoice +><guimenuitem +>Pokaż/Ukryj panel Przeglądarka systemu plików</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Włącza i wyłącza widok przeglądarki systemu plików. Działanie tego polecenia jest niemal identyczne jak <guimenuitem +>Pokaż/Ukryj dokumenty</guimenuitem +>. Jedyną różnicą jest to iż otworzy się okno z przeglądarką systemu plików na wierzchu. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenuitem +>Pokaż/Ukryj panel Konsola</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Włącza i wyłącza okno konsoli usytuowane poniżej okna edycyjnego &kate;. Funkcja ta pozwala na wprowadzanie poleceń systemu operacyjnego bez wychodzenia z programu. </para> +</listitem> +</varlistentry> +</variablelist> +</sect2> + +<sect2 id="keystroke-commands"> +<title +>Skróty klawiszowe</title> + +<para +>Skróty klawiszowe w &kate; można skonfigurować korzystając z menu <link linkend="settings" +>Ustawienia</link +>. Domyślnie przez &kate; wykorzystywane są następujące klawisze. </para> + +<informaltable> +<tgroup cols="2"> +<tbody> + +<row +><entry +><para +><keycap +>Insert</keycap +></para +></entry> +<entry +><para +>Klawisz powoduje przełączenie pomiędzy trybem wstawiania i zastępowania. W trybie wstawiania edytor dodaje każdy kolejny znak do tekstu na prawo od kursora. W trybie zastępowania każdy znak na prawo od kursora zostaje zastąpiony wprowadzonym znakiem.</para +></entry> +</row> +<row> +<entry +><para +><keycombo +><keycap +>Strzałka w lewo</keycap +></keycombo +></para +></entry> +<entry +><para +>Przesuwa kursor w lewo </para +></entry> +</row> +<row> +<entry +><para +><keycombo +><keycap +>Strzałka w prawo</keycap +></keycombo +></para +></entry> +<entry +><para +>Przesuwa kursor w prawo </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Strzałka do góry</keycap +></keycombo +></para +></entry> +<entry +><para +>Przesuwa kursor w górę </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Strzałka w dół</keycap +></keycombo +></para +></entry> +<entry +><para +>Przesuwa kursor w dół </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Page Up</keycap +></keycombo +></para +></entry> +<entry +><para +>Przesuwa kursor o jedną stronę do góry </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Page Down</keycap +></keycombo +></para +></entry> +<entry +><para +>Przesuwa kursor o jedną stronę w dół </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Backspace</keycap +></keycombo +></para +></entry> +<entry +><para +>Usuwa znak na lewo od kursora </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Home</keycap +></keycombo +></para +></entry> +<entry +><para +>Przesuwa kursor na początek wiersza </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>End</keycap +></keycombo +></para +></entry> +<entry +><para +>Przesuwa kursor na koniec wiersza </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Delete</keycap +></keycombo +></para +></entry> +<entry +><para +>Usuwa znak na prawo od kursora (lub cały zaznaczony fragmentu tekstu)</para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Shift;<keycap +>Lewa strzałka</keycap +></keycombo +></para +></entry> +<entry +><para +>Zaznacza tekst o jeden znak w lewo </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Shift;<keycap +>Prawa strzałka</keycap +></keycombo +></para +></entry> +<entry +><para +>Zaznacza tekst o jeden znak w prawo </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>F1</keycap +></keycombo +></para +></entry> +<entry +><para +>Wyświetla Pomoc</para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Shift;<keycap +>F1</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="whats-this" +>Uruchamia pomoc "Co to jest ?"</link +></para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>F</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="find" +>Wyświetla okno "Znajdź"</link +></para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>F3</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="find-again" +>Kontynuuje szukanie</link +></para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>B</keycap +></keycombo +></para +></entry> +<entry +><para +>Ustawia zakładkę</para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>C</keycap +></keycombo +></para +></entry> +<entry +><para +>Kopiuje zaznaczony tekst do schowka. </para +></entry> +</row> + +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>N</keycap +></keycombo +></para +></entry> +<entry +><para +>Otwiera <link linkend="new" +>nowy</link +> dokument</para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>P</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="print" +>Drukuje dokument</link +> </para +></entry> +</row> +<row> + +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>Q</keycap +></keycombo +></para +></entry> +<entry +><para +>Zamyka aktywne okno edytora </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>R</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="replace" +>Otwiera okno zastępowania</link +></para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>S</keycap +></keycombo +></para +></entry> +<entry +><para +>Zapisuje plik</para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>V</keycap +></keycombo +></para +></entry> +<entry +><para +>Wkleja zawartość schowka do edytora</para +></entry> +</row> + +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>X</keycap +></keycombo +></para +></entry> +<entry +><para +>Kasuje zaznaczony tekst, jednocześnie kopiując go do schowka </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>Z</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="undo" +>Wycofuje ostatnią operację</link +></para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>Z</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="redo" +>Ponawia ostatnio wycofaną operację</link +></para +></entry> +</row> +</tbody> +</tgroup> +</informaltable> +</sect2> + +</sect1> + +<sect1 id="fundamentals-using-sessions"> +<title +>Korzystanie z sesji</title> + +<para +>Mechanizm sesji pozwala na przechowywanie wielu różnych zestawów dokumentów i konfiguracji interfejsu użytkownika &kate;. Można stworzyć dowolną liczbę nazwanych sesji dla najczęściej używanych plików oraz skorzystać z sesji nienazwanych (anonimowych) dla plików używanych sporadycznie. W chwili obecnej program w konfiguracji sesji zapisuje listę otwartych plików oraz konfigurację okien w obszarze edycyjnym. Kolejne wersje &kate; umożliwią zapisywanie w sesji innych ustawień. Wraz z mechanizmem sesji &kate; oferuje możliwość uruchamiania wielu instancji programu jednocześnie.</para> + +<para +>Mechanizm sesji jest obsługiwany przez: <itemizedlist> +<listitem +><para +><link linkend="command-line-options" +><emphasis +>Opcje linii poleceń</emphasis +></link +>, pozwalające na wybranie sesji przy uruchamianiu programu &kate; z linii poleceń.</para> +</listitem> +<listitem +><para +>Menu <link linkend="sessions-menu" +><emphasis +>Sesje</emphasis +></link +>, pozwalające na przełączanie, zapisywanie, uruchamianie i zarządzanie sesjami</para +></listitem> +<listitem +><para +><link linkend="config-dialog-sessions" +><emphasis +>Parametry konfiguracyjne</emphasis +></link +> decydujące o zachowaniu się mechanizmu sesji w programie &kate;.</para +></listitem> +</itemizedlist> + +</para> + +<para +>Podczas tworzenia nowej sesji wczytywane są ustawienia interfejsu użytkownika zdefiniowane dla <guilabel +>Domyślnej sesji</guilabel +>. Aby zapisać bieżące ustawienia okien jako sesję domyślną, należy włączyć opcję zapisywania konfiguracji okien w sesjach (w karcie "Sesje" okna konfiguracji). Następnie należy otworzyć sesję domyślną, dokonać odpowiednich zmian w ustawieniu okien i zapisać sesję.</para> + +<para +>W przypadku wczytania nazwanej sesji &kate; wyświetli jej nazwę na początku paska tytułowego okna. Napis w pasku tytułowym przyjmie postać: "<replaceable +>Nazwa sesji</replaceable +>: <replaceable +>Nazwa lub &URL; dokumentu</replaceable +> - &kate;"</para> + +<para +>Podczas otwierania pliku w linii poleceń z opcją <option +>--start <replaceable +>nazwa_sesji</replaceable +></option +> lub jeżeli została skonfigurowana sesja startowa, to zostanie ona wczytana przed wczytaniem plików wskazanych w linii poleceń. Aby otworzyć podane pliki w nowej nienazwanej sesji należy skonfigurować program do uruchamiania nowej sesji podczas uruchamiania lub użyć polecenia <option +>--start</option +> z pustym tekstem jako nazwą sesji: <replaceable +>''</replaceable +>.</para> + +<para +>Od wersji 2.5.1. programu &kate; numer procesu <acronym +>PID</acronym +> uruchomionej instancji programu jest zapisywany w zmiennej środowiskowej <envar +>KATE_PID</envar +>. Podczas otwierania plików z pomocą wbudowanej konsoli &kate; automatycznie otworzy je w bieżącej instancji chyba, że w wywołaniu została wskazana inna instancja.</para> + +<sect2 id="old-behavior"> +<title +>Przywracanie starego sposobu działania &kate;</title> + +<para +>Mechanizm sesji jest bardzo prostym i pożytecznym narzędziem pracy przydatnym w wielu sytuacjach. Jeżeli jednak użytkownik preferuje stare zachowanie &kate; (tzn. jedna instancja otwiera wszystkie pliki) to można to zrobić w następujący sposób: <itemizedlist> +<listitem +><para +>Należy spowodować, aby program &kate; zawsze uruchamiał się z opcją <option +>--use</option +> np. poprzez określenie sposobu uruchamiania w konfiguracji programu lub wykorzystując mechanizm aliasów w systemie.</para +></listitem> +<listitem +><para +>Skonfigurować &kate; do przywracania ostatnio używanej sesji przy uruchomieniu.</para> +</listitem> +<listitem +><para +>Włączyć opcję zapisywania listy plików przy zamykaniu sesji. </para +></listitem> +<listitem +><para +>Wczytać raz domyślną sesję</para +></listitem> +</itemizedlist> +</para> + +</sect2> + +</sect1> + +<sect1 id="fundamentals-getting-help"> + +<title +>Gdzie szukać pomocy</title> + +<sect2> + +<title +>Pomoc dotycząca korzystania z &kate;</title> +<variablelist> + +<varlistentry> +<term +>Niniejszy podręcznik</term> + +<listitem> +<para +>Zawiera opis wszystkich poleceń menu, opcji konfiguracyjnych, narzędzi, okien, wtyczek, &etc; jak też charakterystykę pracy edytora i pozostałych funkcji programu.</para> + +<para +>Wciśnięcie <keycap +>F1</keycap +> lub wybranie menu <menuchoice +><guimenu +>Pomoc</guimenu +></menuchoice +> <guisubmenu +>Podręcznik Kate</guisubmenu +> otwiera okno z niniejszym podręcznikiem.</para +></listitem> + +</varlistentry> + +<varlistentry id="whats-this"> +<term +>Pomoc - Co to jest?</term> +<listitem> +<para +>Pomoc "Co to jest?" oferuje natychmiastową pomoc dotyczącą wybranych elementów i obszarów okna dialogowego.</para> + +<para +>Autorzy dokładają wielu starań, aby pomoc "Co to jest?" była dostępna dla wszystkich elementów, dla których ma sens. W tym momencie działa ona dla okna konfiguracji i dla wielu innych okien dialogowych.</para> + +<para +>Aby skorzystać z pomocy "Co to jest?", należy wcisnąć <keycombo +>&Shift;<keycap +>F1</keycap +></keycombo +> lub skorzystać z menu <menuchoice +><guimenu +>Pomoc</guimenu +><guimenuitem +>Co to jest?</guimenuitem +></menuchoice +>. Po wykonaniu tych operacji kursor zmieni się w znak zapytania, którym można kliknąć na dowolny element w oknie i uzyskać krótką informację na jego temat (jeżeli jest dostępna).</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Przycisk "Pomoc" w oknach dialogowych</term> +<listitem> +<para +>Niektóre okna posiadają przycisk <guibutton +>Pomoc</guibutton +>, którego wciśnięcie powoduje uruchomienie &khelpcenter-dopelniacz; i otworzenie odpowiedniej sekcji dokumentacji.</para> +</listitem> +</varlistentry> +</variablelist> + +</sect2> + +<sect2> +<title +>Pomoc dotycząca formatu edytowanych plików</title> + +<para +>Program &kate; nie umożliwia (jeszcze!) dostępu do dokumentacji związanej z edytowanymi plikami. W zależności od pliku jaki został otworzony informację na jego temat można odszukać za pomocą wbudowanej <link linkend="kate-mdi-tools-konsole" +>Konsoli</link +> (np.: czytając strony "man" systemu &UNIX;) lub też można skorzystać z programu &konqueror;.</para> + +</sect2> + +</sect1> + +</chapter> diff --git a/tde-i18n-pl/docs/tdebase/kate/highlighted.png b/tde-i18n-pl/docs/tdebase/kate/highlighted.png Binary files differnew file mode 100644 index 00000000000..1869100f465 --- /dev/null +++ b/tde-i18n-pl/docs/tdebase/kate/highlighted.png diff --git a/tde-i18n-pl/docs/tdebase/kate/highlighting.docbook b/tde-i18n-pl/docs/tdebase/kate/highlighting.docbook new file mode 100644 index 00000000000..4ceee5fb142 --- /dev/null +++ b/tde-i18n-pl/docs/tdebase/kate/highlighting.docbook @@ -0,0 +1,1378 @@ +<appendix id="highlight"> +<appendixinfo> +<authorgroup> +<author +><personname +><firstname +></firstname +></personname +></author> +<othercredit role="translator" +><firstname +>Krzysztof</firstname +><surname +>Woźniak</surname +><affiliation +><address +><email +>wozniakk@ceti.pl</email +></address +></affiliation +><contrib +>Polskie tłumaczenie</contrib +></othercredit +> +</authorgroup> +</appendixinfo> +<title +>Praca z podświetlaniem składni</title> + +<sect1 id="highlight-overview"> + +<title +>Wprowadzenie</title> + +<para +>System podświetlania składni służy do wyświetlania określonych fragmentów tekstu w różnych stylach czcionki i kolorach, w zależności od funkcji tego tekstu w strukturze edytowanego pliku. Na przykład jeżeli jest to kod źródłowy jakiegoś programu, to instrukcje kontrolne mogą być pogrubione, zaś typu zmiennych i komentarze mogą być wyróżnione kolorem innym od reszty tekstu. To znacznie podnosi czytelność tekstu, dzięki czemu tworzenie programów jest bardziej efektywne i produktywne.</para> + +<mediaobject> +<imageobject +><imagedata format="PNG" fileref="highlighted.png"/></imageobject> +<textobject +><phrase +>Fragment programu w języku Perl wyświetlonego z wykorzystaniem podświetlania składni.</phrase +></textobject> +<caption +><para +>Fragment programu w języku Perl wyświetlonego z wykorzystaniem podświetlania składni.</para> +</caption> +</mediaobject> + +<mediaobject> +<imageobject +><imagedata format="PNG" fileref="unhighlighted.png"/></imageobject> +<textobject +><phrase +>Ten sam fragment pokazany bez podświetlania</phrase +></textobject> +<caption +><para +>Ten sam fragment pokazany bez podświetlania.</para +></caption> +</mediaobject> + +<para +>Który z dwóch powyższych przykładów jest bardziej czytelny?</para> + +<para +>Edytor &kate; ma zintegrowany potężny, elastyczny i w pełni konfigurowalny system podświetlania składni, zaś domyślna instalacja programu zawiera wiele definicji dla różnych języków programowania, języków skryptowych, języków opartych na znacznikach oraz innych plików tekstowych. Dodatkowo użytkownik może tworzyć własne definicje podświetlania składni w plikach &XML; o stosunkowo prostej strukturze.</para> + +<para +>Podczas otwierania pliku tekstowego, &kate; automatycznie wykryje odpowiednią dla tego pliku definicję podświetlania składni na podstawie przypisanego dla niego typu &MIME;. Typ pliku określany jest na podstawie rozszerzenia nazwy pliku, a jeżeli plik nie ma rozszerzenia. to na podstawie jego zawartości. Jeżeli typ pliku został wykryty niepoprawnie, to można ręcznie zmienić definicję podświetlania składni za pomocą menu <menuchoice +><guimenu +>Narzędzia</guimenu +><guisubmenu +>Typ pliku</guisubmenu +></menuchoice +>.</para> + +<para +>Styl i kolor tekstu dla wszystkich reguł podświetlania może zostać zdefiniowany w karcie <link linkend="config-dialog-editor-appearance" +>Czcionki i kolory</link +> <link linkend="config-dialog" +> Okna konfiguracji</link +> natomiast typy &MIME;, dla których powinny być stosowane określone reguły konfigurowane są w karcie <link linkend="config-dialog-editor-highlighting" +>Podświetlenie</link +>.</para> + +<note> +<para +>Podświetlanie składni ma na celu zwiększenie czytelności treści dokumentu, ale nie należy zbyt polegać na jego możliwościach wskazywania błędów w kodzie programu. Algorytmy rozpoznawania składni mogą być skomplikowane i zależy to od używanego formatu dokumentu. Autorzy reguł podświetlania składni mogą się pochwalić 98% skutecznością stosowanych algorytmów rozpoznawania składni, jednak często jest ona wyższa i tylko naprawdę rzadko stosowane definicje reguł podświetlania powodują 2% błędnych podświetleń.</para> +</note> + +<tip> +<para +>Ze strony WWW programu &kate; można pobrać nowe i zaktualizowane bieżące definicje reguł podświetlania składni. Można to zrobić naciskając przycisk <guibutton +>Pobierz...</guibutton +> w karcie <link linkend="config-dialog-editor-highlighting" +>Podświetlenie</link +> okna dialogowego <link linkend="config-dialog" +>Konfiguracji</link +>.</para> +</tip> + +</sect1> + +<sect1 id="katehighlight-system"> + +<title +>System podświetlania składni programu &kate;</title> + +<para +>Poniższa sekcja zawiera bardziej szczegółowe omówienie mechanizmów podświetlania składni w programie &kate;. Jest ona przeznaczona dla użytkowników chcących dodawać lub modyfikować istniejące reguły podświetlania, lub dla osób chcących się czegoś więcej na ten temat dowiedzieć.</para> + +<sect2 id="katehighlight-howitworks"> + +<title +>Jak to działa?</title> + +<para +>Przy każdej operacji otwierania pliku program &kate; próbuje wykryć odpowiednią dla niego regułę podświetlania składni. Podczas wyświetlania pliku i w trakcie jego edycji system podświetlania składni będzie analizował tekst za pomocą reguł określonych w definicji podświetlania składni oraz zaznaczać miejsca, w których poszczególne konteksty treści i style tekstu rozpoczynają się i kończą.</para> + +<para +>Podczas edycji dokumentu nowo wprowadzany tekst jest analizowany i oznaczany na bieżąco, jeżeli więc użytkownik usunie znak będący początkiem lub końcem jakiegoś kontekstu to styl otaczającego ten znak tekstu zmieni się zgodnie z wymaganiami bieżącej reguły podświetlania składni.</para> + +<para +>Definicje reguł podświetlania składni w &kate; to pliki zapisane w standardzie &XML; zawierające: <itemizedlist> +<listitem +><para +>Zasady opisujące rolę spełnianą przez określone fragmenty tekstu zorganizowane w odpowienie bloki kontekstowe</para +></listitem> +<listitem +><para +>Listy słów kluczowych</para +></listitem> +<listitem +><para +>Definicje elementów stylu</para +></listitem> +</itemizedlist> +</para> + +<para +>Podczas analizy składni reguły są sprawdzane w kolejności ich wystąpienia w pliku. Jeżeli początek bieżącego tekstu zostaje dopasowany do danej reguły to następuje przełączenie na wskazany kontekst. Punkt przetwarzania treści przesuwa się na koniec bieżącego dopasowania reguły, a pętla sprawdzania reguł rozpoczyna się na nowo, ale już w kontekście przetwarzania wskazanym przez poprzednie dopasowanie.</para> + +</sect2> + +<sect2 id="highlight-system-rules"> +<title +>Reguły</title> + +<para +>Reguły stanowią serce systemu rozpoznawania składni. Reguła może odnosić się do napisu, pojedynczego znaku lub <link linkend="regular-expressions" +>wyrażenia regularnego</link +>. Do reguł dopasowywany jest analizowany tekst dokumentu. Reguły wskazują, jakiego stylu należy użyć do wyświetlenia dopasowanego fragmentu tekstu, mogą też przełączać kontekst roboczy systemu podświetlania składni przez podanie nazwy kontekstu lub nakazując powrót do kontekstu poprzedniego.</para> + +<para +>Reguły są zgrupowane w bloki kontekstowe. Blok kontekstowy jest związany z głównymi elementami składni analizowanego tekstu np. tekst w cudzysłowach lub bloki komentarzy kodu źródłowego. Dzięki temu system podświetlania składni nie musi analizować wszystkich reguł, jeżeli nie jest to konieczne. Także pewne sekwencje znaków w tekście mogą być różnie traktowane w zależności od wybranego kontekstu przetwarzania. </para> + +<para +>Kontekst przetwarzania może być generowany dynamicznie, pozwalając na stosowaniu w regułach danych zależnych od wystąpienia określonego tekstu w treści dokumentu.</para> + +</sect2> + +<sect2 id="highlight-context-styles-keywords"> +<title +>Style kontekstu i słowa kluczowe</title> + +<para +>W niektórych językach programowania kompilator (czyli program zmieniający tzw. kod źródłowy programu na plik wykonywalny) w różny sposób traktuje liczby całkowite i zmiennoprzecinkowe. Dodatkowo wewnątrz otoczonego cudzysłowami napisu mogą być znaki o specjalnym znaczeniu. W takich wypadkach sensowne jest wyróżnienie ich z otaczającego tekstu tak aby były łatwo identyfikowalne. Tak więc nawet jeżeli takie fragmenty tekstu nie stanowią osobnego kontekstu, to są tak traktowane przez system podświetlania składni i dzięki temu mogą być odpowiednio różnicowane przy wyświetlaniu.</para> + +<para +>Definicja składni może zawierać dowolną liczbę stylów niezbędną do objęcia wszystkich elementów składniowych w danym formacie tekstu.</para> + +<para +>Dla wielu formatów dokumentów definiuje się listy słów reprezentujących określone pojęcia. Na przykład w językach programowania są to instrukcje kontrolne, typy zmiennych oraz wbudowane funkcje (każda z tych kategorii stanowi osobne pojęcie). System podświetlania składni w &kate; wykorzystuje listy słów kluczowych do zaznaczania w tekście wystąpień poszczególnych kategorii skadniowych danego formatu dokumentu.</para> + +</sect2> + +<sect2 id="kate-highlight-system-default-styles"> +<title +>Style domyślne</title> + +<para +>W przypadku otwarcia pliku z programem w C++ , &Java; lub dokumentu <acronym +>HTML</acronym +> można zauważyć, że mimo iż poszczególne typy dokumentów znacząco się od siebie różnią (inne słowa są podświetlane, itp.) to używane przez &kate; kolory są identyczne. Dzieje się tak dlatego ponieważ w &kate; istnieje zdefiniowana lista stylów domyślnych tekstu wykorzystywanych przez wszystkie definicje reguł podświetlania składni.</para> + +<para +>Pozwala to na użytkownikowi na rozpoznawanie pojęć o podobnym znaczeniu w różnych formatach dokumentu. Na przykład komentarze, które istnieją w kodzie źródłowym w niemal wszystkich językach programowania, językach skryptowych lub językach znaczników, są wyświetlane z użyciem tego samego stylu co pozwala użytkownikowi łatwo zidentyfikować wyróżniony w tekście fragment jako komentarz, niezależnie w jakim języku programowania ten tekst będzie napisany.</para> + +<tip> +<para +>Wszystkie definicje podświetlania składni korzystają z minimum jednego stylu domyślnego. Część z nich wykorzystuje więcej stylów domyślnych. Jeżeli z danego formatu dokumentu użytkownik często korzysta, to warto uruchomić okno konfiguracji i sprawdzić jakie pojęcia są dla niego zdefiniowane w zbiorze reguł podświetlania. Na przykład, dostępny jest tylko jeden styl domyślny dla napisów, jednak ponieważ język Perl działa na dwóch rodzajach napisów, to możliwe jest takie skonfigurowanie systemu podświetlania, aby oba rodzaje były wyświetlane w różny sposób. Wszystkie dostępne <link linkend="kate-highlight-default-styles" +>style domyślne</link +> zostaną omówione poniżej.</para> +</tip> + +</sect2> + +</sect1> + +<sect1 id="katehighlight-xml-format"> +<title +>Struktura pliku definicji podświetlania składni w formacie &XML;</title> + +<sect2> +<title +>Wprowadzenie</title> + +<para +>Poniższa sekcja zawiera opis formatu pliku definicji podświetlania składni. Opisane zostaną główne elementy skadni &XML; pliku, ich znaczenie oraz sposoby wykorzystania. Kolejna sekcja zawiera szczegółowy opis poszczególnych reguł interpretacji składni.</para> + +<para +>Formalna definicja struktury pliku &XML; (czyli tak zwany dokument <acronym +>DTD</acronym +>) zawarta jest w pliku <filename +>language.dtd</filename +>, który najczęściej zlokalizowany jest w katalogu: <filename +>$<envar +>KDEDIR</envar +>/share/apps/katepart/syntax</filename +>. </para> + +<variablelist> +<title +>Główne sekcje pliku definicji reguł podświetlania składni dla programu &kate;</title> + +<varlistentry> +<term +>Plik z definicją reguł podświetlania składni zawiera nagłówek definiujący wersję języka XML oraz rodzaj dokumentu (doctype):</term> +<listitem> +<programlisting +><?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE language SYSTEM "language.dtd"> +</programlisting> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Głównym elementem składowym pliku z definicją jest element <userinput +>language</userinput +> posiadający następujące atrybuty:</term> + +<listitem> +<para +>Atrybuty wymagane:</para> +<para +><userinput +>name</userinput +> określa nazwę języka (format dokumentu), która pojawia się później w menu i w oknach dialogowych.</para> +<para +><userinput +>section</userinput +> określa kategorię danego formatu dokumentu.</para> +<para +><userinput +>extensions</userinput +> określa rozszerzenia nazw plików, np.: "*.cpp;*.h"</para> + +<para +>Atrybuty opcjonalne:</para> +<para +><userinput +>mimetype</userinput +> typy &MIME; plików, których dotyczy zbiór definicji.</para> +<para +><userinput +>version</userinput +> określa wersję pliku definicji reguł podświetlania.</para> +<para +><userinput +>kateversion</userinput +> określa minimalną wersję &kate;, wymaganą do prawidłowego działania pliku definicji.</para> +<para +><userinput +>casesensitive</userinput +> określa wrażliwość na wielkość liter w słowach kluczowych.</para> +<para +><userinput +>priority</userinput +> określa priorytet stosowania danego zbioru definicji dla tych samych rozszerzeń nazw plików. Jeżeli do danego rozszerzenia pasuje kilka plików definicji, to zostaje wybrany ten o najwyższym priorytecie.</para> +<para +><userinput +>author</userinput +> zawiera imię i nazwisko autora definicji oraz jego adres e-mail.</para> +<para +><userinput +>license</userinput +> określa na jakiej licencji został udostępniony plik. Z reguły są to licencje: LGPL, Artistic, GPL, ale mogą też być inne.</para> +<para +><userinput +>hidden</userinput +> wyłącza wyświetlanie nazwy zbioru definicji w menu programu &kate;.</para> +<para +>Czyli kolejny wiersz pliku definicji może wyglądać następująco:</para> +<programlisting +><language name="C++" version="1.00" kateversion="2.4" section="Sources" extensions="*.cpp;*.h" /> +</programlisting> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>Następnym elementem struktury pliku jest znacznik <userinput +>highlighting</userinput +> zawierający element opcjonalny <userinput +>list</userinput +> oraz elementy wymagane:<userinput +>contexts</userinput +> oraz <userinput +>itemDatas</userinput +>.</term> +<listitem> +<para +>Elementy typu <userinput +>list</userinput +> zawierają listy słów kluczowych. W przedstawionym poniżej przykładzie są to słowa <emphasis +>class</emphasis +> i <emphasis +>const</emphasis +>. Możliwe jest dodanie wielu elementów typu <userinput +>list</userinput +> w zależności od potrzeb.</para> +<para +>Element <userinput +>contexts</userinput +> zawiera wszystkie konteksty występujące w składni definiowanego formatu dokumentu. Pierwszy kontekst jest domyślny i to od niego rozpoczyna się analiza składni. W omawianym przykładzie występują dwie reguły w kontekście o nazwie: <emphasis +>Normal Text</emphasis +>, dopasowujące listę słów kluczowych o nazwie: <emphasis +>somename</emphasis +> oraz reguła wykrywająca tekst w cudzysłowie przełączająca kontekst na: <emphasis +>string</emphasis +>. Więcej o regułach można przeczytać w kolejnym rozdziale.</para> +<para +>Trzecia część to element <userinput +>itemDatas</userinput +>. Zawiera on wszystkie kolory i style czcionek wykorzystywane przez konteksty i reguły. W omawianym przykładzie występują następujące elementy typu <userinput +>itemData</userinput +>: <emphasis +>Normal Text</emphasis +>, <emphasis +>String</emphasis +> i <emphasis +>Keyword</emphasis +>. </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 +>Ostatnią częścią struktury piku definicji podświetlania jest opcjonalna sekcja <userinput +>general</userinput +>, która może zawierać dodatkowe informacje o słowach kluczowych, zasadach zwijaniu kodu, komentarzach i wcięciach.</term> + +<listitem> +<para +>W części <userinput +>comment</userinput +> definiowany jest napis rozpoczynający komentarz jedno-wierszowy. Możliwe jest także definiowanie komentarzy wielowierszowych za pomocą <emphasis +>multiLine</emphasis +> z dodatkowym atrybutem <emphasis +>end</emphasis +>. Ta część definicji jest niezbędna do działania poleceń <emphasis +>Komentarz/Odkomentuj</emphasis +> dostępnych w programie &kate;.</para> +<para +>W sekcji <userinput +>keywords</userinput +> określona jest wrażliwość na wielkość liter przy rozpoznawaniu słów kluczowych. Pozostałe atrybuty opisane są poniżej.</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 +>Szczegółowy opis poszczególnych sekcji</title> +<para +>W tej części omówione zostaną wszystkie dostępne atrybuty dla elementów typu: context, itemData, keywords, a także dla komentarzy, zasad zwijania kodu i wcięć.</para> + +<variablelist> +<varlistentry> +<term +>Element <userinput +>context</userinput +>, należący do grupy <userinput +>contexts</userinput +>, definiuje reguły specyficzne dla określonego kontekstu, czyli np. co ma się stać, jeżeli system analizy składni dojdzie do końca wiersza. Dostępne atrybuty to:</term> + + +<listitem> +<para +><userinput +>name</userinput +> określa nazwę kontekstu wykorzystywaną w operacjach przełączania kontekstu podczas interpretacji reguł analizy składni.</para> +<para +><userinput +>lineEndContext</userinput +> określa na jaki kontekst system analizy powinien się przełączyć po osiągnięciu końca wiersza. Może to być nazwa kontekstu, napis <userinput +>#stay</userinput +> oznaczający pozostanie w bieżącym kontekście lub napis <userinput +>#pop</userinput +> powodujący przejście do poprzedniego kontekstu. Możliwe jest wielokrotne użycie #pop np.:<userinput +>#pop#pop#pop</userinput +> aby przejść do trzeciego kontekstu wstecz.</para> +<para +><userinput +>lineBeginContext</userinput +> określa zmianę kontekstu w przypadku wykrycia początku wiersza. Wartość domyślna: #stay.</para> +<para +><userinput +>fallthrough</userinput +> nakazuje systemowi podświetlania składni do przełączenia się do innego kontekstu (określonego przez "fallthroughContext"), jeżeli żadna reguła nie zostanie dopasowana. Wartość domyślna: <emphasis +>false</emphasis +>.</para> +<para +><userinput +>fallthroughContext</userinput +> określa kontekst, do którego system powinien się przełączyć, jeżeli żadna reguła nie zostanie dopasowana.</para> +<para +><userinput +>dynamic</userinput +> jeżeli ma wartość <emphasis +>true</emphasis +>, to powoduje zachowywanie napisów/wskaźników miejsca zapisanych przez reguły dynamiczne. Jest to wymagane np. przez dokumenty typu HERE. Wartość domyślna: <emphasis +>false</emphasis +>.</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>Element <userinput +>itemData</userinput +> należący do grupy <userinput +>itemDatas</userinput +> definiuje style czcionki i kolory. Możliwe jest z jego pomocą samodzielne definiowanie własnych stylów i kolorów, chociaż zalecane jest korzystanie ze stylów domyślnych, tak aby użytkownik widział te same kolory w różnych językach programowania. Czasami jednak niezbędne jest zdefiniowanie własnych kolorów i stylów czcionki. Dla tego elementu wymagane są atrybuty "name" oraz "defStyleNum" zaś pozostałe są opcjonalne. Dostępne atrybuty:</term> + +<listitem> +<para +><userinput +>name</userinput +> określa nazwę elementu itemData. Poszczególne reguły i konteksty będą korzystać z tej nazwy, odnosząc się do tego elementu itemData.</para> +<para +><userinput +>defStyleNum</userinput +> określa styl domyślny, który należy wykorzystać do wyświetlania. Dostępne style domyślne są opisane poniżej.</para> +<para +><userinput +>color</userinput +> określa kolor w formacie '#rrggbb' lub '#rgb'.</para> +<para +><userinput +>selColor</userinput +> określa kolor zaznaczenia.</para> +<para +><userinput +>italic</userinput +> jeżeli <emphasis +>true</emphasis +> to tekst będzie wyświetlony kursywą.</para> +<para +><userinput +>bold</userinput +> jeżeli <emphasis +>true</emphasis +> to tekst będzie pogrubiony.</para> +<para +><userinput +>underline</userinput +> jeżeli <emphasis +>true</emphasis +> to tekst będzie podkreślony.</para> +<para +><userinput +>strikeout</userinput +> jeżeli <emphasis +>true</emphasis +> to tekst będzie przekreślony.</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>Element <userinput +>keywords</userinput +> należący do grupy <userinput +>general</userinput +> określa właściwości dla słów kluczowych i posiada następujące atrybuty:</term> + +<listitem> +<para +>Atrybut <userinput +>casesensitive</userinput +> mogący przyjmować wartości <emphasis +>true</emphasis +> lub <emphasis +>false</emphasis +>. Jeżeli będzie to wartość <emphasis +>true</emphasis +> to operacja dopasowania słów kluczowych będzie wrażliwa na wielkość liter.</para> +<para +><userinput +>weakDeliminator</userinput +> zawiera listę znaków nie pełniących funkcji rozdzielającej słowa. Na przykład kropka <userinput +>'.'</userinput +> rozdziela słowa. Jeżeli więc jakieś słowo kluczowe na liście <userinput +>list</userinput +> zawiera kropkę, to zostanie dopasowane tylko wtedy, gdy kropka zostanie zdefiniowana tutaj jako znak nie pełniący funkcji rozdzielającej.</para> +<para +><userinput +>additionalDeliminator</userinput +> określa dodatkowe znaki rozdzielające.</para> +<para +><userinput +>wordWrapDeliminator</userinput +> określa znak, po którym może nastąpić przejście do następnego wiersza.</para> +<para +>Domyślnymi znakami rozdzielającymi są znaki: <userinput +>.():!+,-<=>%&*/;?[]^{|}~\</userinput +>, spacja (<userinput +>' '</userinput +>) oraz tabulator (<userinput +>'\t'</userinput +>).</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>Element <userinput +>comment</userinput +> należący do grupy <userinput +>comments</userinput +> zawiera informacje niezbędne do działania poleceń menu: <menuchoice +><guimenu +>Narzędzia</guimenu +><guimenuitem +>Komentarz</guimenuitem +></menuchoice +> oraz <menuchoice +><guimenu +>Narzędzia</guimenu +><guimenuitem +>Odkomentuj</guimenuitem +></menuchoice +>. Dostępne atrybuty:</term> + +<listitem> +<para +>Atrybut <userinput +>name</userinput +> może mieć wartość <emphasis +>singleLine</emphasis +> lub <emphasis +>multiLine</emphasis +>. W przypadku użycia argumentu <emphasis +>multiLine</emphasis +> wymagane stają się atrybuty <emphasis +>end</emphasis +> oraz <emphasis +>region</emphasis +>.</para> +<para +><userinput +>start</userinput +> określa napis oznaczający początek komentarza (np. w języku C++ jest to "/*").</para> +<para +><userinput +>end</userinput +> określa napis oznaczający koniec komentarza (np. w języku C++ jest to "*/").</para> +<para +><userinput +>region</userinput +> określa nazwę dla zwijalnego wielowierszowego komentarza. Zakładając, że zdefiniowane są następujące reguły: <emphasis +>beginRegion="Comment"</emphasis +> ... <emphasis +>endRegion="Comment"</emphasis +> można jako wartość tego atrybutu ustawić <emphasis +>region="Comment"</emphasis +>. Dzięki temu odkomentowywanie tekstu działa nawet jeżeli nie zostanie zaznaczony cały komentarz wielowierszowy. Wystarczy, że kursor znajduje się w dowolnym miejscu treści tego komentarza.</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>Element <userinput +>folding</userinput +> należący do grupy <userinput +>general</userinput +> określa właściwości funkcji zwijania kodu. Dostępne są dla niego następujące atrybuty:</term> + +<listitem> +<para +><userinput +>indentationsensitive</userinput +> jeżeli jest <emphasis +>true</emphasis +>, to znaczniki zwijania będą dodawane z uwzględnieniem wcięć, tak jak w języku skryptowym Python. Z reguły nie jest to jednak wymagane, a wartością domyślną jest: <emphasis +>false</emphasis +>.</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>Element <userinput +>indentation</userinput +> należący do grupy <userinput +>general</userinput +> określa algorytm generowania automatycznych wcięć. Definiowanie tego elementu nie jest wskazane, dlatego iż wcięcia są generowane w zależności od typu pliku lub od trybu edycji wiersza. Jeżeli element zostanie zdefiniowany to spowoduje wymuszenie na użytkowniku stosowania automatycznych wcięć, nawet jeżeli on tego nie potrzebuje. Dla elementu dostępne są atrybuty:</term> + +<listitem> +<para +><userinput +>mode</userinput +> określa nazwę trybu generowania wcięć. Możliwe są następujące tryby: <emphasis +>normal, cstyle, csands, xml, python</emphasis +> oraz <emphasis +>varindent</emphasis +>.</para> +</listitem> +</varlistentry> + + +</variablelist> + + +</sect2> + +<sect2 id="kate-highlight-default-styles"> +<title +>Style domyślne</title> +<para +>Style domyślne zostały już wcześniej <link linkend="kate-highlight-system-default-styles" +>krótko omówione</link +>. Są to predefiniowane w programie &kate; style i kolory czcionki.</para> +<variablelist> +<varlistentry> +<term +>Poniżej przedstawiono listę dostępnych stylów domyślnych:</term> +<listitem> +<para +><userinput +>dsNormal</userinput +>, dla zwykłego tekstu.</para> +<para +><userinput +>dsKeyword</userinput +>, dla słów kluczowych.</para> +<para +><userinput +>dsDataType</userinput +>, dla definicji typów danych.</para> +<para +><userinput +>dsDecVal</userinput +>, dla liczb dziesiętnych.</para> +<para +><userinput +>dsBaseN</userinput +>, dla liczb zapisanych w systemie innym niż dziesiętny.</para> +<para +><userinput +>dsFloat</userinput +>, dla liczb zmiennoprzecinkowych.</para> +<para +><userinput +>dsChar</userinput +>, dla znaków.</para> +<para +><userinput +>dsString</userinput +>, dla napisów.</para> +<para +><userinput +>dsComment</userinput +>, dla komentarzy.</para> +<para +><userinput +>dsOthers</userinput +>, dla 'pozostałych' elementów.</para> +<para +><userinput +>dsAlert</userinput +>, dla komunikatów i ostrzeżeń.</para> +<para +><userinput +>dsFunction</userinput +>, dla wywołań funkcji.</para> +<para +><userinput +>dsRegionMarker</userinput +>, dla wyświetlania znaczników regionów.</para> +<para +><userinput +>dsError</userinput +>, dla podświetlenia błędów w kodzie i błędnej składni.</para> +</listitem> +</varlistentry> +</variablelist> + +</sect2> + +</sect1> + +<sect1 id="kate-highlight-rules-detailled"> +<title +>Reguły interpretacji składni</title> + +<para +>Poniższa sekcja opisuje reguły rozpoznawania składni.</para> + +<para +>Każda reguła może zostać dopasowana do zera lub większej liczby znaków, począwszy od początku napisu podlegającego interpretacji. Jeżeli reguła zostaje dopasowana, to określonym znakom przypisany zostaje styl lub <emphasis +>atrybut</emphasis +> określony przez tę regułę. Może też zostać przełączony kontekst analizy treści.</para> + +<para +>Reguła wykrywania zapisana jest następująco:</para> + +<programlisting +><RuleName attribute="(identyfikator)" context="(identyfikator)" [atrybuty specyficzne dla reguły] /></programlisting> + +<para +>Element <emphasis +>attribute</emphasis +> określa nazwę stylu wyświetlania dla dopasowanego napisu, zaś <emphasis +>context</emphasis +> określa kontekst, który powinien obowiązywać począwszy od tego miejsca.</para> + +<para +>Atrybut <emphasis +>context</emphasis +> może zostać zapisany jako:</para> + +<itemizedlist> +<listitem> +<para +><emphasis +>Identyfikator</emphasis +> stanowiący nazwę kontekstu.</para> +</listitem> +<listitem> +<para +><emphasis +>Kolejność</emphasis +> tzn. określenie czy system ma pozostać w bieżącym kontekście(<userinput +>#stay</userinput +>) czy też zmienić kontekst na poprzedni (<userinput +>#pop</userinput +>).</para> +<para +>Przejście o kilka kontekstów wstecz możliwe jest za pomocą powtórzeń słowa #pop, np: <userinput +>#pop#pop#pop</userinput +></para> +</listitem> +</itemizedlist> + +<para +>Niektóre reguły mogą posiadać <emphasis +>reguły powiązane</emphasis +>, które są przetwarzane w przypadku zaistnienia dopasowania reguły podstawowej. Całość dopasowanego napisu otrzyma atrybut zdefiniowany przez regułę podstawową. Przykładowa reguła zawierająca regułę powiązaną wygląda tak:</para> + +<programlisting +><RuleName (atrybuty)> + <ChildRuleName (atrybuty) /> + ... +</RuleName> +</programlisting> + + +<para +>Atrybuty dotyczące poszczególnych reguł mogą się różnić, a ich charakterystyka zamieszczona jest poniżej.</para> + + +<itemizedlist> +<title +>Atrybuty wspólne</title> +<para +>Wszystkie reguły posiadają pewne wspólne zestawy atrybutów, co zaznaczone jest w opisie reguły określeniem: <userinput +>(atrybuty wspólne)</userinput +>. Atrybuty <emphasis +>attribute</emphasis +> oraz <emphasis +>context</emphasis +> są wymagane, a wszystkie pozostałe są opcjonalne. </para> + +<listitem> +<para +><emphasis +>attribute</emphasis +>: Atrybut odnoszący się do zdefiniowanego elementu <emphasis +>itemData</emphasis +>.</para> +</listitem> +<listitem> +<para +><emphasis +>context</emphasis +>: Określa kontekst, na który ma przełączyć się system podświetlania składni, jeżeli reguła zostanie dopasowana.</para> +</listitem> +<listitem> +<para +><emphasis +>beginRegion</emphasis +>: Definiuje początek bloku zwijania kodu. Wartość domyślna: nie ustawione.</para> +</listitem> +<listitem> +<para +><emphasis +>endRegion</emphasis +>: Kończy blok dla zwijania kodu. Wartość domyślna: nie ustawione.</para> +</listitem> +<listitem> +<para +><emphasis +>lookAhead</emphasis +>: Jeżeli jest <emphasis +>true</emphasis +>, to system podświetlania nie będzie przetwarzał całej długości dopasowania. Wartość domyślna to: <emphasis +>false</emphasis +>.</para> +</listitem> +<listitem> +<para +><emphasis +>firstNonSpace</emphasis +>: Dopasowuje regułę, ale tylko wtedy gdy dany napis jest pierwszym napisem w wierszu, nie rozpoczynającym się od spacji. Wartość domyślna: <emphasis +>false</emphasis +>.</para> +</listitem> +<listitem> +<para +><emphasis +>column</emphasis +>: Dopasowuje regułę tylko jeżeli kolumna też jest dopasowana. Wartość domyślna: nie ustawione.</para> +</listitem> +</itemizedlist> + +<itemizedlist> +<title +>Zasady dynamiczne</title> +<para +>Niektóre reguły dopuszczają stosowanie atrybutu logicznego <userinput +>dynamic</userinput +>, który ma wartość domyślną <emphasis +>false</emphasis +>. Jeżeli nadana zostanie mu wartość <emphasis +>true</emphasis +>, to reguła może wtedy wykorzystać znacznik pozycji dla tekstu dopasowanego przez regułę z <emphasis +>wyrażeniem regularnym</emphasis +>, która spowodowała przełączenie się do bieżącego kontekstu. Dla <userinput +>napisu</userinput +> znacznik miejsca <replaceable +>%N</replaceable +> (gdzie N to liczba) będzie zamieniony przez tekst odpowiadający <replaceable +>N</replaceable +>-temu podwyrażeniu w wyrażeniu regularnym. Dla <userinput +>znaku</userinput +> znacznik ten też musi być liczbą i zostanie zamieniony na pierwszy znak <replaceable +>N</replaceable +>-tego podwyrażenia w wyrażeniu regularnym. Jeżeli reguła dopuszcza istnienie tego atrybutu, to zostanie oznaczona napisem <emphasis +>(dynamiczna)</emphasis +> w poniższej dokumentacji.</para> + +<listitem> +<para +><emphasis +>dynamic</emphasis +> może przyjmować wartości <emphasis +>(true|false)</emphasis +>.</para> +</listitem> +</itemizedlist> + +<sect2 id="highlighting-rules-in-detail"> +<title +>Reguły - charakterystyka</title> + +<variablelist> +<varlistentry> +<term +>DetectChar</term> +<listitem> +<para +>Wykrywa określony znak. Często używane na przykład do wykrywania końca napisów w cudzysłowach.</para> +<programlisting +><DetectChar char="(znak)" (atrybuty wspólne) (dynamiczna) /></programlisting> +<para +>Atrybut <userinput +>char</userinput +> określa poszukiwany znak.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Detect2Chars</term> +<listitem> +<para +>Wykrywa dwa następujące po sobie znaki.</para> +<programlisting +><Detect2Chars char="(znak)" char1="(znak)" (atrybuty wspólne) (dynamiczna) /></programlisting> +<para +><userinput +>char</userinput +> określa pierwszy znak do wykrycia, zaś <userinput +>char1</userinput +> określa drugi znak.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>AnyChar</term> +<listitem> +<para +>Wykrywa jeden znak ze zdefiniowanego zbioru znaków.</para> +<programlisting +><AnyChar String="(napis)" (atrybuty wspólne) /></programlisting> +<para +>Atrybut <userinput +>String</userinput +> definiuje zbiór znaków.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>StringDetect</term> +<listitem> +<para +>Wykrywa dokładne wystąpienie napisu.</para> +<programlisting +><StringDetect String="(napis)" [insensitive="true|false"] (atrybuty wspólne) (dynamiczna) /></programlisting> +<para +>Atrybut <userinput +>String</userinput +> określa napis wyszukiwany. Atrybut <userinput +>insensitive</userinput +> ma wartość domyślną <emphasis +>false</emphasis +> i jest przekazywany do funkcji porównywania napisów. Jeżeli wartość tego atrybutu jest <emphasis +>true</emphasis +>, to dopasowanie tekstów będzie wrażliwe na wielkość liter.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>RegExpr</term> +<listitem> +<para +>Wyszukuje fragment zdefiniowany wyrażeniem regularnym.</para> +<programlisting +><RegExpr String="(napis)" [insensitive="true|false"] [minimal="true|false"] (atrybuty wspólne) (dynamiczna) /></programlisting> +<para +>Atrybut <userinput +>String</userinput +> zawiera wyrażenie regularne.</para> +<para +>Atrybut <userinput +>insensitive</userinput +> ma wartość domyślną <emphasis +>false</emphasis +> i jest przekazywany jako parametr do systemu interpretacji wyrażeń regularnych.</para> +<para +><userinput +>minimal</userinput +> ma wartość domyślną<emphasis +>false</emphasis +> i jest przekazywany jako parametr do systemu interpretacji wyrażeń regularnych.</para> +<para +>Ponieważ reguły są zawsze dopasowywane od początku bieżącego tekstu, wyrażenie regularne rozpoczynające się od znaku karetki (<literal +>^</literal +>) będzie oznaczać, iż reguła powinna być dopasowana tylko na początku wiersza.</para> +<para +>Więcej informacji na ten temat w części: <link linkend="regular-expressions" +>Wyrażenia regularne</link +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>keyword</term> +<listitem> +<para +>Wykrywa słowo kluczowe z podanej listy.</para> +<programlisting +><keyword String="(nazwa listy)" (atrybuty wspólne) /></programlisting> +<para +>Atrybut <userinput +>String</userinput +> określa listę słów kluczowych poprzez jej nazwę. Lista o tej nazwie musi istnieć.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Int</term> +<listitem> +<para +>Wykrywa liczbę całkowitą.</para> +<para +><programlisting +><Int (atrybuty wspólne) (dynamiczna) /></programlisting +></para> +<para +>Reguła ta nie posiada dodatkowych atrybutów. Reguły powiązane są zwykle wykorzystywane do wykrywania kombinacji znaków <userinput +>L</userinput +> oraz <userinput +>U</userinput +>, następujących po liczbie, określających zwykle typ liczby całkowitej w kodzie programu. Jako regułę powiązaną można wykorzystać dowolną inną regułę mimo tego, że definicja składni <acronym +>DTD</acronym +> dopuszcza jedynie powiązanie z regułą <userinput +>StringDetect</userinput +>.</para> +<para +>Poniższy przykład przedstawia regułę, która dopasowuje liczbę całkowitą po której wystąpi litera '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 +>Wykrywa liczbę zmiennoprzecinkową.</para> +<para +><programlisting +><Float (atrybuty wspólne) /></programlisting +></para> +<para +>Ta reguła nie ma dodatkowych atrybutów. Może być powiązana z regułą <userinput +>AnyChar</userinput +>, która wykorzystywana jest często do wyszukiwania różnych wariantów. Podobne zastosowanie przedstawiono przy omawianiu reguły <userinput +>Int</userinput +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>HlCOct</term> +<listitem> +<para +>Wykrywa liczbę zapisaną w formacie ósemkowym.</para> +<para +><programlisting +><HlCOct (atrybuty wspólne) /></programlisting +></para> +<para +>Ta reguła nie ma dodatkowych atrybutów.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>HlCHex</term> +<listitem> +<para +>Wykrywa liczbę zapisaną w formacie szesnastkowym.</para> +<para +><programlisting +><HlCHex (atrybuty wspólne) /></programlisting +></para> +<para +>Ta reguła nie ma dodatkowych atrybutów.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>HlCStringChar</term> +<listitem> +<para +>Wykrywa znak specjalny zapisany za pomocą odwrotnego ukośnika.</para> +<para +><programlisting +><HlCStringChar (atrybuty wspólne) /></programlisting +></para> +<para +>Ta reguła nie ma dodatkowych atrybutów.</para> + +<para +>Dopasowuje sekwencje specjalne, reprezentujące znaki specjalne często używane w kodach źródłowych programów, np. <userinput +>\n</userinput +> (znak nowego wiersza) lub <userinput +>\t</userinput +> (znak tabulacji).</para> + +<para +>Zostaną dopasowane następujące znaki zapisane po odwrotnym ukośniku (<literal +>\</literal +>) : <userinput +>abefnrtv"'?\</userinput +>. Dodatkowo dopasowane zostaną sekwencje zawierające liczby szesnastkowe: <userinput +>\xff</userinput +> lub ósemkowe <userinput +>\033</userinput +>.</para> + +</listitem> +</varlistentry> + +<varlistentry> +<term +>HlCChar</term> +<listitem> +<para +>Wykrywa znak w języku C.</para> +<para +><programlisting +><HlCChar (atrybuty wspólne) /></programlisting +></para> +<para +>Ta reguła nie ma dodatkowych atrybutów.</para> + +<para +>Reguła dopasowuje pojedynczy znak w języku C zamknięty apostrofami (np.:<userinput +>'c'</userinput +>). Wewnątrz apostrofów może znajdować się pojedynczy znak lub sekwencja specjalna opisująca pojedynczy znak. Więcej o dopasowaniu sekwencji specjalnych znajduje się w opisie reguły HlCStringChar.</para> + +</listitem> +</varlistentry> + +<varlistentry> +<term +>RangeDetect</term> +<listitem> +<para +>Wykrywa napis rozpoczynający się i kończący określonymi znakami.</para> +<programlisting +><RangeDetect char="(znak)" char1="(znak)" (atrybuty wspólne) /></programlisting> +<para +><userinput +>char</userinput +> określa początkowy znak zakresu znaków, zaś <userinput +>char1</userinput +> określa znak kończący zakres.</para> +<para +>Reguła może być wykorzystywana do wykrywania krótkich napisów w cudzysłowach, należy jednak pamiętać, iż system podświetlania składni analizuje pojedyncze wiersze, tak więc nie zostaną wykryte napisy wielowierszowe.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>LineContinue</term> +<listitem> +<para +>Wykrywa koniec wiersza.</para> +<programlisting +><LineContinue (atrybuty wspólne) /></programlisting> +<para +>Ta reguła nie ma dodatkowych atrybutów.</para> +<para +>Reguła ta jest przydatna przy przełączaniu kontekstu po osiągnięciu końca wiersza, jeżeli ostatnim znakiem jest odwrotny ukośnik (<userinput +>'\'</userinput +>). Jest to wykorzystywane na przykład w językach C i C++ do zapisu makr w wielu wierszach kodu.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>IncludeRules</term> +<listitem> +<para +>Dołącza reguły z innego kontekstu lub pliku definicji języka.</para> +<programlisting +><IncludeRules context="odnośnikkontekstu" [includeAttrib="true|false"] /></programlisting> + +<para +>Parametr <userinput +>context</userinput +> określa kontekst, który należy dołączyć.</para> +<para +>Jeżeli parametr jest nazwą innego kontekstu to spowoduje, to przyłączenie wszystkich określonych w innym kontekście reguł do bieżącego kontekstu, np.: <programlisting +><IncludeRules context="anotherContext" /></programlisting +></para> + +<para +>Jeżeli podany napis rozpoczyna się od <userinput +>##</userinput +>, to system podświetlania składni odszuka definicji innego języka o podanej nazwie, np.: <programlisting +><IncludeRules context="##C++" /></programlisting +></para> +<para +>Jeżeli atrybut <userinput +>includeAttrib</userinput +> ma wartość <emphasis +>true</emphasis +>, to nastąpi zmiana atrybutów na występujący w źródle. Może to być przydatne do podświetlania fragmentów z przykładami w innym formacie dokumentu, tzn. gdy tekst dopasowany przez dołączony kontekst wykorzystuje inną definicję dla podświetlania składni. </para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>DetectSpaces</term> +<listitem> +<para +>Wykrywa spacje.</para> +<programlisting +><DetectSpaces (atrybuty wspólne) /></programlisting> + +<para +>Ta reguła nie ma dodatkowych atrybutów.</para> +<para +>Regułę tę wykorzystuje się w przypadkach, gdy wiadome jest, iż w wierszu znajduje się wiele spacji, np. przy wciętych wierszach. Spowoduje ona pominięcie wszystkich spacji jednocześnie zamiast testowania wszystkich reguł znak po znaku dla każdej z nich.</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>DetectIdentifier</term> +<listitem> +<para +>Wykrywa identyfikatory (określone wyrażeniem regularnym: [a-zA-Z_][a-zA-Z0-9_]*).</para> +<programlisting +><DetectIdentifier (atrybuty wspólne) /></programlisting> + +<para +>Ta reguła nie ma dodatkowych atrybutów.</para> +<para +>Reguła powyższa służy do pomijania całego napisu składającego się ze znaków składających się na wyraz, zamiast sprawdzania wielu reguł z powodu braku dopasowania.</para> +</listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2> +<title +>Porady</title> + +<itemizedlist> +<para +>Po zrozumieniu zasady działania mechanizmu przełączania kontekstów tworzenie definicji reguł podświetlania stanie się proste. Należy jednak zawsze dokładnie sprawdzić dostosowanie wybranej reguły do konkretnej sytuacji. Wyrażenia regularne dają ogromne możliwości, ale działają wolno w porównaniu z innymi regułami. Poniżej opisano kilka porad pomocnych w tworzeniu plików definicji reguł podświetlania. </para> + +<listitem> +<para +>Jeżeli poszukiwane są tylko dwa znaki to należy wykorzystywać regułę <userinput +>Detect2Chars</userinput +> zamiast <userinput +>StringDetect</userinput +> (to samo dotyczy reguły <userinput +>DetectChar</userinput +>).</para> +</listitem> +<listitem> +<para +>Użycie wyrażeń regularnych jest proste, jednak często istnieją inne, dużo szybsze sposoby osiągnięcie tego samego rezultatu. Zakładając, iż konieczne jest dopasowanie znaku <userinput +>'#'</userinput +> jako pierwszego w wierszu. Odpowiednie wyrażenie regularne miałoby postać: <programlisting +><RegExpr attribute="Macro" context="macro" String="^\s*#" /></programlisting +>To samo można uzyskać poprzez: <programlisting +><DetectChar attribute="Macro" context="macro" char="#" firstNonSpace="true" /></programlisting +> Zamiast wyrażenia regularnego <userinput +>'^#'</userinput +> można zastosować regułę <userinput +>DetectChar</userinput +> z atrybutem <userinput +>column="0"</userinput +>. Atrybut <userinput +>column</userinput +> odnosi się do znaków w tekście, tak więc znak tabulatora zostanie policzony jako jeden znak. </para> +</listitem> +<listitem> +<para +>Możliwe jest przełączanie kontekstów bez przetwarzania znaków. Przypuśćmy, iż konieczne jest przełączenie kontekstu po napotkaniu napisu <userinput +>*/</userinput +> ale konieczne jest przetworzenie tego napisu w kolejnym kontekście. Poniższa reguła zostanie dopasowana, zaś atrybut <userinput +>lookAhead</userinput +> spowoduje zachowanie dopasowanego napisu do przetwarzania w kolejnym kontekście. <programlisting +><Detect2Chars attribute="Comment" context="#pop" char="*" char1="/" lookAhead="true" /></programlisting> +</para> +</listitem> +<listitem> +<para +>Można skorzystać z <userinput +>DetectSpaces</userinput +>, jeżeli spodziewane jest wystąpienie wielu spacji.</para> +</listitem> +<listitem> +<para +>Zamiast wyrażenia regularnego <userinput +>'[a-zA-Z_]\w*'</userinput +> można wykorzystać <userinput +>DetectIdentifier</userinput +>.</para> +</listitem> +<listitem> +<para +>Należy w miarę możliwości używać styli domyślnych, dzięki temu użytkownik będzie miał spójne środowisko pracy z różnymi plikami.</para> +</listitem> +<listitem> +<para +>Można podejrzeć zawartość innych plików definicji reguł podświetlania, aby zorientować się w sposobie definiowania bardziej skomplikowanych reguł.</para> +</listitem> +<listitem> +<para +>Sprawdzenie poprawności stworzonego pliku XML możliwe jest z wykorzystaniem polecenia: <command +>xmllint --dtdvalid language.dtd mySyntax.xml</command +>.</para> +</listitem> +<listitem> +<para +>W przypadku częstego korzystania z wyrażeń regularnych można skorzystać z mechanizmu <emphasis +>ENTITIES</emphasis +>, np:</para> +<programlisting +><?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE language SYSTEM "language.dtd" +[ + <!ENTITY myref "[A-Za-z_:][\w.:_-]*"> +]> +</programlisting> +<para +>Dzięki temu można zastosować <emphasis +>&myref;</emphasis +> zamiast wyrażenia regularnego.</para> +</listitem> +</itemizedlist> +</sect2> + +</sect1> + +</appendix> diff --git a/tde-i18n-pl/docs/tdebase/kate/index.cache.bz2 b/tde-i18n-pl/docs/tdebase/kate/index.cache.bz2 Binary files differnew file mode 100644 index 00000000000..6854bdb9b57 --- /dev/null +++ b/tde-i18n-pl/docs/tdebase/kate/index.cache.bz2 diff --git a/tde-i18n-pl/docs/tdebase/kate/index.docbook b/tde-i18n-pl/docs/tdebase/kate/index.docbook new file mode 100644 index 00000000000..6459b2249e0 --- /dev/null +++ b/tde-i18n-pl/docs/tdebase/kate/index.docbook @@ -0,0 +1,468 @@ +<?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 % Polish "INCLUDE" +><!-- change language only here --> +]> + +<book lang="&language;"> +<title +>Podręcznik &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 +>Krzysztof</firstname +><surname +>Woźniak</surname +><affiliation +><address +><email +>wozniakk@ceti.pl</email +></address +></affiliation +><contrib +>Polskie tłumaczenie</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; jest edytorem programisty dla środowiska &kde; w wersji 2.2 lub wyższej.</para> + +<para +>Niniejszy podręcznik dotyczy &kate; w wersji 2.5.0</para> +</abstract> + +<keywordset> +<keyword +>KDE</keyword> +<keyword +>tdebase</keyword> +<keyword +>Kate</keyword> +<keyword +>tekst</keyword> +<keyword +>edytor</keyword> +<keyword +>programistyczny</keyword> +<keyword +>programowanie</keyword> +<keyword +>projekty</keyword> +<keyword +>MDI</keyword> +<keyword +>wiele</keyword> +<keyword +>dokument</keyword> +<keyword +>interfejs</keyword> +<keyword +>terminal</keyword> +<keyword +>konsola</keyword> +</keywordset> + +</bookinfo> + +<chapter id="introduction"> +<title +>Wprowadzenie</title> + +<para +>Witamy w programie &kate;, edytorze tekstu dla programistów w środowisku &kde; (w wersji 2.2 lub wyższej). Główne możliwości &kate; to podświetlanie składni zarówno dla języków programowania takich jak C i C++, jak również dla kodu <acronym +>HTML</acronym +> oraz skryptów powłoki bash, możliwość tworzenia i obsługi projektów składających się z wielu plików, interfejs użytkownika dla wielu dokumentów (<acronym +>MDI</acronym +>) oraz wbudowany emulator terminala. </para> + +<para +>&kate; to jednak coś więcej niż tylko edytor. Możliwość otwierania wielu plików jednocześnie, czyni go idealnym narzędziem modyfikacji różnych ustawień konfiguracyjnych systemu &UNIX;. Niniejszy dokument również został napisany za pomocą &kate;. </para> + +<para> +<mediaobject> +<imageobject +><imagedata format="PNG" fileref="kate.png"/></imageobject> +<caption +><para +>Okno programu w trakcie edycji podręcznika ...</para +></caption> +</mediaobject> +</para> + +</chapter> + +&fundamentals-chapter; + +&mdi-chapter; + +&part-chapter; + +&plugins-chapter; + +&advanced-chapter; + +&menu-chapter; + +&configuring-chapter; + +<chapter id="credits"> + +<title +>Zasługi i licencje</title> + +<para +>Prawa autorskie programu &kate; (c) 2000, 2001, 2002 - 2005 Zespół deweloperów &kate;. </para> + +<variablelist> +<title +>Zespół deweloperów &kate;:</title> +<varlistentry> +<term +>&Christoph.Cullmann; &Christoph.Cullmann.mail;</term> +<listitem +><para +>Kierownik projektu i główny programista</para +></listitem> +</varlistentry> +<varlistentry> +<term +>&Anders.Lund; &Anders.Lund.mail;</term> +<listitem +><para +>Główny programista, moduł podświetlania dla Perl'a, dokumentacja</para +></listitem> +</varlistentry> +<varlistentry> +<term +>&Joseph.Wenninger; &Joseph.Wenninger.mail;</term> +<listitem +><para +>Główny programista, podświetlanie składni</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Michael Bartl <email +>michael.bartl1@chello.at</email +></term> +<listitem +><para +>Główny programista</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Phlip <email +>phlip_cpp@my-deja.com</email +></term> +<listitem +><para +>Kompilacja projektu</para +></listitem> +</varlistentry> +<varlistentry> +<term +>&Waldo.Bastian; &Waldo.Bastian.mail;</term> +<listitem +><para +>System obsługi bufora</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Matt Newell <email +>newellm@proaxis.com</email +></term> +<listitem +><para +>Testowanie...</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Michael McCallum <email +>gholam@xtra.co.nz</email +></term> +<listitem +><para +>Główny programista</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Jochen Wilhemly <email +>digisnap@cs.tu-berlin.de</email +></term> +<listitem +><para +>Autor KWrite</para +></listitem> +</varlistentry> +<varlistentry> +<term +>&Michael.Koch; &Michael.Koch.mail;</term> +<listitem +><para +>Konwersja KWrite na moduł KParts</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Christian Gebauer <email +>gebauer@bigfoot.com</email +></term> +<listitem +><para +>Nieokreślone</para +></listitem> +</varlistentry> +<varlistentry> +<term +>&Simon.Hausmann; &Simon.Hausmann.mail;</term> +<listitem +><para +>Nieokreślone</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Glen Parker <email +>glenebob@nwlink.com</email +></term> +<listitem +><para +>Obsługa funkcji cofnij w KWrite, integracja z programem KSpell</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Scott Manson <email +>sdmanson@alltel.net</email +></term> +<listitem +><para +>Obsługa podświetlania składni XML</para +></listitem> +</varlistentry> +<varlistentry> +<term +>&John.Firebaugh; &John.Firebaugh.mail;</term> +<listitem +><para +>Różne poprawki</para +></listitem> +</varlistentry> +<varlistentry> +<term +>&Dominik.Haumann; &Dominik.Haumann.mail;</term> +<listitem +><para +>Programista, asystent podświetlania</para +></listitem> +</varlistentry> +</variablelist> + +<variablelist> +<title +>Wiele innych osób pomogło tworzyć program:</title> +<varlistentry> +<term +>Matteo Merli <email +>merlim@libero.it</email +></term> +<listitem +><para +>Reguły podświetlania składni dla plików Spec RPM, Diff i innych</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Rocky Scaletta <email +>rocky@purdue.edu</email +></term> +<listitem +><para +>Reguły podświetlania składni dla VHDL</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Yury Lebedev </term> +<listitem +><para +>Reguły podświetlania składni dla SQL</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Chris Ross</term> +<listitem +><para +>Reguły podświetlania składni dla Ferite</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Nick Roux</term> +<listitem +><para +>Reguły podświetlania składni dla ILERPG</para +></listitem> +</varlistentry> +<varlistentry> +<term +>John Firebaugh</term> +<listitem +><para +>Reguły podświetlania składni dla Javy i wielu innych języków</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Carsten Niehaus</term> +<listitem +><para +>Reguły podświetlania składni dla LaTeX-a</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Per Wigren</term> +<listitem +><para +>Reguły podświetlania dla składni plików Make i Pythona</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Jan Fritz</term> +<listitem +><para +>Reguły podświetlania składni dla Pythona</para +></listitem> +</varlistentry> +<varlistentry> +<term +>&Daniel.Naber;</term> +<listitem +><para +>Poprawki błędów, wtyczka do obsługi XML-a</para +></listitem> +</varlistentry> +</variablelist> + +<para +>Prawa autorskie do dokumentacji (c) 2000,2001 &Seth.Rothberg; &Seth.Rothberg.mail;</para> + +<para +>Prawa autorskie do dokumentacji (c) 2002, 2003, 2005 &Anders.Lund; &Anders.Lund.mail;</para> + +<para +>Polskie tłumaczenie: <email +>wozniakk@ceti.pl</email +></para +> +&underFDL; &underGPL; </chapter> + +&highlighting-appendix; + +®exp-appendix; + +<appendix id="installation"> +<title +>Instalacja</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-pl/docs/tdebase/kate/kate.png b/tde-i18n-pl/docs/tdebase/kate/kate.png Binary files differnew file mode 100644 index 00000000000..bf3513453d1 --- /dev/null +++ b/tde-i18n-pl/docs/tdebase/kate/kate.png diff --git a/tde-i18n-pl/docs/tdebase/kate/man-kate.1.docbook b/tde-i18n-pl/docs/tdebase/kate/man-kate.1.docbook new file mode 100644 index 00000000000..5c048b91e66 --- /dev/null +++ b/tde-i18n-pl/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 % Polish "INCLUDE"> +]> + +<refentry lang="&language;"> +<refentryinfo> +<title +>Podręcznik użytkownika KDE</title> +<author +>&Lauri.Watts; &Lauri.Watts.mail;</author> +<date +>7 Czerwiec 2005</date +> <productname +>K Desktop Environment</productname +> </refentryinfo> + +<refmeta> +<refentrytitle +><command +>kate</command +></refentrytitle> +<manvolnum +>1</manvolnum> +</refmeta> + +<refnamediv> +<refname +><command +>kate</command +></refname> +<refpurpose +>Zaawansowany edytor tekstu dla środowiska &kde;</refpurpose> +</refnamediv> + +<refsynopsisdiv> +<cmdsynopsis +><command +>kate</command +> <group choice="opt" +><option +>-s, --start</option +> <replaceable +> name</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 +> name</replaceable +></group +> <group choice="opt" +><option +>-l, --line</option +> <replaceable +>wiersz</replaceable +></group +> <group choice="opt" +><option +>-c, --column</option +> <replaceable +>kolumna</replaceable +></group +> <group choice="opt" +><option +>-i, --stdin</option +></group +> <arg choice="opt" +>KDE Generic Options</arg +> <arg choice="opt" +>Qt Generic Options</arg +> </cmdsynopsis> +</refsynopsisdiv> + +<refsect1> +<title +>Charakterystyka</title> +<para +>Program &kate; jest zaawansowanym edytorem tekstu dla środowiska &kde;. </para +> +<para +>&kate; udostępnia również (pod nazwą &kwrite;) komponent edycji tekstu dla innych programów.</para> +<para +>Główne możliwości &kate; to podświetlanie składni zarówno dla języków programowania takich jak C i C++ jak i dla kodu <acronym +>HTML</acronym +> oraz skryptów powłoki bash, możliwość tworzenia i obsługi projektów składających się z wielu plików, interfejs użytkownika umożliwiający edycję wielu dokumentów (<acronym +>MDI</acronym +>) oraz wbudowana konsola. </para> + +<para +>Program &kate; to jednak coś więcej niż jedynie edytor tekstu. Możliwość otwierania wielu plików jednocześnie czyni go idealnym narzędziem dla modyfikacji różnych plików konfiguracyjnych systemu &UNIX;. Niniejszy dokument również powstał w programie &kate;. </para> + + +</refsect1> + +<refsect1> +<title +>Opcje</title> + +<variablelist> +<varlistentry> +<term +><option +>-s</option +>, <option +>--start</option +> <replaceable +>nazwa_sesji</replaceable +></term> + +<listitem +><para +>Uruchamia &kate; otwierając podaną w poleceniu sesję.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><option +>-u, --use</option +></term> +<listitem +><para +>Powoduje użycie działającej instancji programu &kate;</para +></listitem> +</varlistentry> +<varlistentry> +<term +><option +>-p, --pid</option +> <replaceable +>pid</replaceable +></term> +<listitem +><para +>Powoduje użycie działającej instancji programu &kate; ale tylko o podanym numerze procesu <replaceable +>pid</replaceable +></para +></listitem> +</varlistentry> +<varlistentry> +<term +><option +>-e, --encoding</option +> <replaceable +>kodowanie</replaceable +></term> +<listitem +><para +>Ustala sposób kodowania znaków dla otwieranego pliku</para +><para +>Pozwala to na przykład na wymuszenie otwarcia pliku z kodowaniem znaków utf-8. (Polecenie <command +>iconv -l</command +> wyświetli listę wszystkich dostępnych w systemie zestawów kodowań znaków)</para +></listitem> +</varlistentry> +<varlistentry> +<term +><option +>-l, --line</option +> <replaceable +>wiersz</replaceable +></term> +<listitem +><para +>Powoduje przejście do podanego wiersza</para +></listitem> +</varlistentry> +<varlistentry> +<term +><option +>-c, --column</option +> <replaceable +>kolumna</replaceable +></term> +<listitem +><para +>Powoduje przejście do podanej kolumny</para +></listitem> +</varlistentry> +<varlistentry> +<term +><option +>-i, --stdin</option +></term> +<listitem +><para +>Pobiera tekst ze standardowego wejścia <filename +>STDIN</filename +></para +></listitem> +</varlistentry> +</variablelist> + +</refsect1> + +<refsect1> +<title +>Zobacz także</title> + +<para +>kwrite(1)</para> + +<para +>Szczegółowa dokumentacja użytkownika dostępna jest pod adresem <ulink url="help:/kate" +>help:/kate</ulink +> (można ten <acronym +>URL</acronym +> wprowadzić w oknie przeglądarki &konqueror; lub wykonać polecenie <userinput +><command +>khelpcenter</command +> <parameter +>help:/kate</parameter +></userinput +>).</para> + +<para +>Dodatkowe informacje o programie dostępne są na <ulink url="http://kate.kde.org/" +>stronie WWW programu &kate;</ulink +>.</para> +</refsect1> + +<refsect1> +<title +>Przykłady</title> + +<para +>Aby otworzyć plik o nazwie <filename +>source.cpp</filename +> i po otwarciu ustawić w nim kursor w kolumnie 15 i wierszu 25 to należy użyć polecenia:</para> +<screen +><userinput +><command +>kate</command +> <option +>-c 15</option +> <option +>-l +25</option +> <option +>-u</option +> <filename +>source.cpp</filename +></userinput +> </screen> + +<para +>Jeżeli dostępne jest połączenie z siecią Internet można skorzystać z mechanizmu przeźroczystości sieciowej środowiska &kde; do otwierania plików na serwerach ftp. Jeżeli uprawnienia dostępu do zdalnego serwera nie pozwalają na modyfikację pliku to zostanie on otwarty w trybie tylko do odczytu zaś po dokonaniu zmian będzie go można zapisać lokalnie. Jeżeli użytkownik ma prawa zapisu do pliku zdalnego to będzie on zapisany na serwerze ftp bez konieczności wykonania żadnych dodatkowych operacji.</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 +>Autorzy</title> +<para +>Opiekunem programu &kate; jest &Christoph.Cullmann; &Christoph.Cullmann.mail;. Obszerna lista autorów i współtwórców dostępna jest we wspomnianej wyżej pełnej wersji podręcznika.</para> +</refsect1> + +</refentry> diff --git a/tde-i18n-pl/docs/tdebase/kate/mdi.docbook b/tde-i18n-pl/docs/tdebase/kate/mdi.docbook new file mode 100644 index 00000000000..7928428b52c --- /dev/null +++ b/tde-i18n-pl/docs/tdebase/kate/mdi.docbook @@ -0,0 +1,372 @@ +<chapter id="kate-mdi"> +<chapterinfo> +<authorgroup> +<author +>&Anders.Lund; &Anders.Lund.mail;</author> +<othercredit role="translator" +><firstname +>Suse</firstname +><surname +>Polska</surname +><affiliation +><address +><email +>suse@suse.pl</email +></address +></affiliation +><contrib +>Polskie tłumaczenie</contrib +></othercredit +> <othercredit role="translator" +><firstname +>Krzysztof</firstname +><surname +>Woźniak</surname +><affiliation +><address +><email +>wozniakk@ceti.pl</email +></address +></affiliation +><contrib +>Polskie tłumaczenie</contrib +></othercredit +> +</authorgroup> +</chapterinfo> +<title +>Praca z &kate; <acronym +>MDI</acronym +></title> + +<sect1 id="kate-mdi-overview"> +<title +>Przegląd</title> + +<para +>Niniejszy rozdział wyjaśni znaczenie terminów: okno, edycja, dokument, ramka , edytor. Pozwoli to czytelnikowi na bardziej efektywną pracę z &kate;.</para> + +<sect2 id="kate-mdi-overview-mainwindow"> + +<title +>Okno główne</title> + +<para +><indexterm +><primary +>Okno główne</primary +></indexterm +> Okno główne w &kate; jest standardowym oknem środowiska &kde; z dodatkowymi paskami bocznymi zawierającymi widoki narzędzi. Dostępny jest pasek menu ze standardowymi poleceniami, jak też pasek narzędzi ze skrótami do najczęściej używanych poleceń.</para> + +<para +>Najważniejszą częścią okna jest obszar edycji domyślnie wyświetlający pojedyncze okno edytora tekstu, w którym można pracować z dokumentem.</para> + +<para +>Do wyświetlania okien z narzędziami wykorzystywane są mechanizmy dokowania okien środowiska &kde;. Te okna to:</para> + +<itemizedlist> +<listitem +><para +><link linkend="kate-mdi-tools-file-list" +>Lista plików</link +></para +></listitem> +<listitem +><para +><link linkend="kate-mdi-tools-file-selector" +>Przeglądarka systemu plików</link +></para +></listitem> +<listitem +><para +><link linkend="kate-mdi-tools-konsole" +>Wbudowana konsola</link +></para +></listitem> +</itemizedlist> + +<para +>Dodatkowe widoki narzędzi np. udostępniane przez wtyczki.</para> + +<para +>Widoki narzędzi mogą być rozmieszczane w różnych panelach. Zmiana ich położenia możliwa jest po naciśnięciu prawego przycisku myszki na pasku bocznym i skorzystaniu z menu kontekstowego.</para> + +<para +>Pozycja widoku narzędzi może być zmieniona na <emphasis +>trwałą</emphasis +> w menu kontekstowym. Ponieważ każdy pasek boczny może zawierać kilka zestawów narzędzi to ustawienie zachowania na "trwały" spowoduje jednoczesne wyświetlenie kilku zestawów narzędzi.</para> + +</sect2> + + +</sect1> + +<sect1 id="kate-mdi-editor"> + +<title +>Okno edytora</title> + +<para +><indexterm +><primary +>Obszar edycji</primary +></indexterm +> W programie &kate; możliwe jest otwarcie więcej niż jednego dokumentu jednocześnie oraz podzielenie obszaru edycyjnego na dowolną liczbę ramek, podobnie jak w programach &konqueror; lub <application +>emacs</application +>. Dzięki temu użytkownik może wyświetlić kilka widoków tego samego dokumentu jednocześnie, co jest pomocne gdy np. kod programu zawiera definicje zmiennych w górnej części pliku. Można też oglądać plik nagłówkowy programu w jednej ramce, równocześnie edytując plik implementacji w innej ramce.</para> + +<para +>Jeśli dokument jest otwarty w kilku ramkach, to zmiany dokonane w jednej są natychmiast widoczne w pozostałych. Odnosi się to zarówno do zmian w tekście jak i do operacji zaznaczania. Operacje szukania lub ruchu kursora dotyczą tylko aktywnego okna.</para> + +<para +>Nie jest możliwe otwarcie wielu okien z tym samym dokumentem tak, aby zmiany w jednym nie miały wpływu na pozostałe.</para> + +<para +>W momencie podziału okna edytora na dwie ramki, obszar edycji jest dzielony na dwie równe części wyświetlające bieżący dokument. Nowa ramka pojawi się na dole (w przypadku podziału poziomego) lub po prawej stronie (w przypadku podziału pionowego). Nowa ramka staje się aktywna, co jest sygnalizowane odpowiednim kolorem obramowania ramki.</para> + +</sect1> + +<sect1 id="kate-mdi-tools-file-list"> +<title +>Lista dokumentów</title> + +<para +><indexterm +><primary +>Lista dokumentów</primary +></indexterm +> Lista dokumentów pokazuje spis wszystkich dokumentów obecnie otwartych przez &kate;. Zmodyfikowane pliki oznaczane są małą ikoną <guiicon +>dyskietki</guiicon +> po lewej stronie.</para> + +<para +>Jeśli otwartych jest więcej plików o tej samej nazwie (ale np. zlokalizowanych innych folderach) to nazwa kolejnych plików będzie rozszerzona dołączoną liczbą <quote +>(2)</quote +> i tak dalej. Po najechaniu myszką na nazwę dokumentu wyświetli się podpowiedź podająca pełną ścieżkę dostępu (pozwala to na wybranie właściwego pliku).</para +> <para +>Aby wyświetlić dany plik w bieżącej ramce, należy kliknąć na jego nazwę w liście dokumentów lewym przyciskiem myszy.</para> + +<para +>Lista dokumentów może być sortowana na kilka sposobów. Kliknięcie prawym przyciskiem myszy pozwala wybrać kolejność sortowania za pomocą kontekstowego menu <guisubmenu +>Sortuj wg.</guisubmenu +>. Dostępne są następujące możliwości: <variablelist> + +<varlistentry> +<term +><guimenuitem +>Kolejność otwierania</guimenuitem +></term> +<listitem +><para +>Sortuje dokumenty według kolejności ich otwierania.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guimenuitem +>Nazwa dokumentu</guimenuitem +></term> +<listitem +><para +>Sortuje dokumenty alfabetycznie.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guimenuitem +>URL</guimenuitem +></term> +<listitem +><para +>Sortuje dokumenty alfabetycznie, stosując pełny adres URL.</para +></listitem> +</varlistentry> + +</variablelist> + +</para> + +<para +>Zmiany w dokumentach będą przedstawiane na liście za pomocą zmienionych kolorów tła pod nazwą dokumentu. Każda edycja dokumentu wzmacnia nasycenie koloru tła tak, że ostatnio edytowane dokumenty mają kolor najbardziej wyrazisty. Pozwala to na łatwą identyfikację dokumentów, którymi w danej chwili zajmuje się użytkownik. Funkcja ta może zostać wyłączona w karcie <link linkend="config-dialog-documentlist" +>Lista dokumentów</link +> okna konfiguracji.</para> + +<para +>Domyślna lokalizacja listy dokumentów w oknie &kate; to lewa strona obszaru edycyjnego.</para> +</sect1> + +<sect1 id="kate-mdi-tools-file-selector"> +<title +>Przeglądarka systemu plików</title> + +<para +><indexterm +><primary +>Przeglądarka systemu plików</primary +></indexterm +> Przeglądarka systemu plików wyświetla listę katalogów, pozwalając na wybranie i otwarcie pliku z pokazywanego katalogu w bieżącej ramce okna edycyjnego.</para> + +<para +>Przeglądarka systemu plików zawiera następujące elementy:</para> + +<variablelist> +<varlistentry> +<term +>Pasek zadań</term> +<listitem> +<para +>Zawiera standardowe przyciski nawigacyjne:</para> +<variablelist> +<varlistentry> +<term +><guibutton +>Katalog domowy</guibutton +></term> +<listitem +><para +>Wciśnięcie tego przycisku powoduje przejście do katalogu domowego użytkownika.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guibutton +>Katalog wyżej</guibutton +></term> +<listitem +><para +>Wciśnięcie tego przycisku powoduje przejście do katalogu nadrzędnego nad bieżącym (jeżeli jest to możliwe).</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guibutton +>W tył</guibutton +></term> +<listitem +><para +>Powoduje przejście do katalogu, który był poprzednio wyświetlany.Ten przycisk jest nieaktywny, jeśli wcześniej nie otwarto żadnego innego katalogu.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guibutton +>W przód</guibutton +></term> +<listitem +><para +>Powoduje przejście do następnego katalogu z historii przeglądania. Ten przycisk jest nieaktywny, jeśli nie ma następnego katalogu w historii.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guibutton +>Bieżący katalog dokumentu</guibutton +></term> +<listitem +><para +>Powoduje przejście do katalogu, w którym znajduje się bieżący dokument. Ten przycisk jest nieaktywny, jeśli dokument jest nowy, niezapisany lub jeśli nie da się określić katalogu, w którym się znajduje.</para +></listitem> +</varlistentry> +</variablelist> + +</listitem> +</varlistentry> + +<varlistentry> +<term +>Ścieżka dostępu &URL;</term> +<listitem> +<para +>Tutaj można wpisać ścieżkę dostępu do katalogu, który użytkownik chce przeglądać. Pole &URL; przechowuje listę poprzednio wpisywanych ścieżek. Wybranie jednej z nich możliwe jest za pomocą przycisku rozwijania listy po prawej stronie pola.</para> +<tip +><para +>Pole &URL; posiada funkcję automatycznego uzupełniania nazw katalogów. Metoda uzupełniania może być wybrana po naciśnięciu prawego przycisku myszki na polu tekstowym.</para +></tip> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Widok katalogu</term> +<listitem +><para +>Zawiera standardową dla środowiska &kde; przeglądarkę plików w katalogu.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Filtr nazw plików</term> +<listitem> +<para +>Pozwala na filtrowania listy plików wyświetlonych w oknie według zdefiniowanych kryteriów. Można wykorzystać standardowe maski filtra plików, a w przypadku podawania więcej niż jednej maski poszczególne pozycje należy rozdzielić spacjami np: <userinput +>*.cpp *.h *.moc</userinput +>.</para> +<para +>Aby wyświetlić wszystkie pliki należy wprowadzić w tym polu gwiazdkę: <userinput +>*</userinput +>.</para> +<para +>Pole filtra nazw plików zachowuje 10 ostatnich wpisów. Aby wybrać któryś z nich, należy skorzystać z przycisku rozwijania listy po prawej stronie pola.</para> +</listitem> +</varlistentry> + +</variablelist> + +</sect1> + + +<sect1 id="kate-mdi-tools-konsole"> +<title +>Konsola</title> + +<para +><indexterm +><primary +>Konsola</primary +></indexterm +> Wbudowana konsola jest kopią programu &konsole; dla środowiska &kde;. Można ją włączyć w menu <menuchoice +><guimenu +>Okno</guimenu +><guimenuitem +>Widoki narzędzi </guimenuitem +> <guimenuitem +>Pokaż panel Konsola</guimenuitem +></menuchoice +> lub przez naciśnięcie klawisza <keycombo action="simul" +><keycap +>F7</keycap +></keycombo +>. Dodatkowo, jeżeli włączona została opcja <link linkend="config-dialog-general-sync-konsole" +>Synchronizuj konsolę z aktywnym dokumentem</link +> to katalog roboczy w konsoli będzie zawsze ustawiany na ścieżkę do katalogu, w którym znajduje się bieżący dokument.</para> + +<para +>Domyślnie konsola w oknie &kate; znajduje się na dole, pod obszarem edycji.</para> + +<para +>Program &konsole; można dodatkowo konfigurować. Po naciśnięciu prawego przycisku myszki otworzy się kontekstowe menu z listą dostępnych opcji. Więcej informacji o korzystaniu z &konsole; dostępne jest w podręczniku dla tego programu.</para> + +</sect1> + +<sect1 id="kate-mdi-tools-externaltools"> +<title +>Narzędzia zewnętrzne</title> + +<para +>W menu <guimenu +>Narzędzia</guimenu +> dostępne jest podmenu <guisubmenu +>Narzędzia zewnętrzne</guisubmenu +>. Pozycje z tego menu służą do uruchamiania programów wykonujących operację na danych związanych z bieżącym dokumentem. Może do nich zostać przekazana na przykład: ścieżka do pliku, katalog, cały tekst dokumentu lub jego zaznaczony fragment.</para> + +<para +>Narzędzia zewnętrzne użytkownik może definiować samodzielnie w karcie <link linkend="config-dialog-externaltools" +>Narzędzia zewnętrzne</link +> okna konfiguracji &kate;. </para> + +</sect1> + +</chapter> diff --git a/tde-i18n-pl/docs/tdebase/kate/menus.docbook b/tde-i18n-pl/docs/tdebase/kate/menus.docbook new file mode 100644 index 00000000000..8f75064a06a --- /dev/null +++ b/tde-i18n-pl/docs/tdebase/kate/menus.docbook @@ -0,0 +1,2238 @@ +<chapter id="menu-entries"> +<chapterinfo> +<authorgroup> +<author +><personname +><firstname +></firstname +></personname +></author> +<othercredit role="translator" +><firstname +>Suse</firstname +><surname +>Polska</surname +><affiliation +><address +><email +>suse@suse.pl</email +></address +></affiliation +><contrib +>Polskie tłumaczenie</contrib +></othercredit +> <othercredit role="translator" +><firstname +>Krzysztof</firstname +><surname +>Woźniak</surname +><affiliation +><address +><email +>wozniakk@ceti.pl</email +></address +></affiliation +><contrib +>Polskie tłumaczenie</contrib +></othercredit +> +</authorgroup> +</chapterinfo> +<title +>Menu programu</title> + +<sect1 id="file-menu"> +<title +>Menu <guimenu +>Plik</guimenu +></title> + +<variablelist> +<varlistentry> +<term> +<anchor id="new"/> +<menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>N</keycap +></keycombo +> </shortcut +> <guimenu +>Plik</guimenu +> <guimenuitem +>Nowy</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Rozpoczyna edycję <action +>nowego dokumentu</action +>. Na liście plików po lewej stronie okna pojawi się on pod nazwą: <emphasis +>Nienazwany</emphasis +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="open"/> +<menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>O</keycap +></keycombo +> </shortcut +> <guimenu +>Plik</guimenu +> <guimenuitem +>Otwórz...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Otwiera standardowe okno wyboru pliku środowiska &kde;, z którego można wybrać jeden lub więcej plików do otworzenia. </para> + +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="open-recent"/> +<menuchoice +><guimenu +>Plik</guimenu +> <guimenuitem +>Otwórz poprzedni</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>To polecenie pozwala na <action +>wybranie i otwarcie pliku</action +> za pomocą menu zawierającego listę ostatnio edytowanych dokumentów. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="open-with"/> +<menuchoice +><guimenu +>Plik</guimenu +> <guimenuitem +>Otwórz w ...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>W tym menu wyświetlona jest lista zainstalowanych programów obsługujących pliki zgodne z typem MIME bieżącego dokumentu. Wybranie jednej z pozycji spowoduje uruchomienie tego programu i otworzenie w nim bieżącego dokumentu.</para> +<para +>Widoczna w tym menu pozycja <guimenuitem +>Inne...</guimenuitem +> otwiera okno dialogowe pozwalające na wybranie dowolnego programu do <action +>otwarcia</action +> bieżącego pliku. Mimo otwarcia pliku przez inny program pozostanie on w dalszym ciągu otwarty w edytorze &kate;. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="save"/> +<menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>S</keycap +></keycombo +> </shortcut +> <guimenu +>Plik</guimenu +> <guimenuitem +>Zapisz</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Polecenie to <action +>zapisuje bieżący dokument</action +> i powinno być dla bezpieczeństwa regularnie wykonywane. Jeżeli dokument jest <emphasis +>nienazwany</emphasis +> wtedy wybranie polecenia <guimenuitem +>Zapisz</guimenuitem +> otworzy okno dialogowe: <guimenuitem +>Zapisz jako ...</guimenuitem +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="save-as"/> +<menuchoice +><guimenu +>Plik</guimenu +> <guimenuitem +>Zapisz jako ...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Polecenie pozwala <action +>nadawać i zmieniać nazwy plików </action +>. Po jego uruchomieniu wyświetla się okno dialogowe analogiczne do okna otwierania plików. Można je wykorzystać do przeglądania systemu plików, podglądania zawartości plików oraz filtrowania listy za pomocą masek nazw plików. </para> + +<para +>W polu "Nazwa pliku" należy wprowadzić wybraną dla zapisywanego pliku nazwę, a następnie nacisnąć przycisk <guibutton +>OK</guibutton +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="save-all"/> +<menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>L</keycap +></keycombo +> </shortcut +> <guimenu +>Plik</guimenu +> <guimenuitem +>Zapisz wszystko</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Polecenie to <action +>zapisuje wszystkie otwarte i zmodyfikowane pliki</action +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="reload"/> +<menuchoice +><shortcut +> <keycombo action="simul" +><keycap +>F5</keycap +></keycombo +> </shortcut +> <guimenu +>Plik</guimenu +> <guimenuitem +>Wczytaj ponownie</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Powoduje ponowne <action +>wczytanie zawartości </action +> bieżącego dokumentu z dysku. Funkcja ta przydaje się, jeżeli inny program lub proces zmienił plik w czasie, gdy był on otwarty w &kate; </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="print"/> +<menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>P</keycap +></keycombo +> </shortcut +> <guimenu +>Plik</guimenu +> <guimenuitem +>Drukuj...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +><action +>Drukuje bieżący dokument</action +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term id="export-as-html"> +<menuchoice +><guimenu +>Plik</guimenu +> <guimenuitem +>Eksportuj jako HTML...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Pozwala na zapisanie pliku w formacie HTML, dzięki czemu dokument może być oglądany w przeglądarce WWW. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term id="mail"> +<menuchoice +><guimenu +>Plik</guimenu +> <guimenuitem +>Wyślij</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Otwiera domyślny program pocztowy, tworzy nową wiadomość i załącza do niej bieżący dokument. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="close"/> +<menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>W</keycap +></keycombo +> </shortcut +> <guimenu +>Plik</guimenu +> <guimenuitem +>Zamknij</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +><action +>Zamyka bieżący dokument</action +>. Jeżeli użytkownik dokonał w nim jakichś zmian, to pojawi się okno dialogowe z informacją o konieczności zapisania pliku przed jego zamknięciem. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="close-all"/> +<menuchoice +><guimenu +>Plik</guimenu +> <guimenuitem +>Zamknij wszystko</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>To polecenie <action +>zamyka wszystkie otwarte w &kate; dokumenty</action +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="quit"/> +<menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>Q</keycap +></keycombo +> </shortcut +> <guimenu +>Plik</guimenu +> <guimenuitem +>Zakończ</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Polecenie <action +>kończy pracę z &kate;</action +> i zamyka wszystkie otwarte dokumenty. Jeżeli użytkownik dokonał w nich jakichś zmian, to pojawi się okno dialogowe z informacją o konieczności zapisania ich przed zamknięciem. </para> +</listitem> +</varlistentry> +</variablelist> +</sect1> + +<sect1 id="edit-menu"> +<title +>Menu <guimenu +>Edycja</guimenu +></title> +<para +>Menu <guimenu +>Edycja</guimenu +> zawiera polecenia dotyczące bieżącego dokumentu.</para> + +<variablelist> +<title +>Menu programu</title> +<varlistentry> +<term> +<anchor id="edit-undo"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>Z</keycap +></keycombo +></shortcut +> <guimenu +>Edycja</guimenu +> <guimenuitem +>Cofnij</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Wycofuje ostatnie wykonane przez użytkownika zmiany (wprowadzenie, skopiowanie, usunięcie tekstu itp.)</para> +<note +><para +>Jeżeli włączona jest opcja grupowego wycofywania, to możliwe jest wycofanie kilku zmian tego samego rodzaju jednocześnie, np. wpisywanych po kolei znaków.</para +></note> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-redo"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>Z</keycap +></keycombo +></shortcut +> <guimenu +>Edycja</guimenu +> <guimenuitem +>Przywróć</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Polecenie przywraca zmiany w dokumencie wycofane wcześniej za pomocą operacji Cofnij.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-cut"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>X</keycap +></keycombo +></shortcut +> <guimenu +>Edycja</guimenu +> <guimenuitem +>Wytnij</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Opcja ta wycina zaznaczony fragment tekstu i przenosi go do schowka. Schowek stanowi integralną część środowiska &kde; i umożliwia wymianę danych pomiędzy różnymi programami.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-copy"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>C</keycap +></keycombo +></shortcut +> <guimenu +>Edycja</guimenu +> <guimenuitem +>Kopiuj</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Kopiuje zaznaczony fragment tekstu do schowka.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-copy-as-html"/> +<menuchoice +><guimenu +>Edycja</guimenu +><guimenuitem +>Kopiuj jako HTML</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Kopiuje zaznaczony fragment tekstu w postaci HTML do schowka (uwzględniając kolory podświetlania składni).</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-paste"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>V</keycap +></keycombo +></shortcut +> <guimenu +>Edycja</guimenu +> <guimenuitem +>Wklej</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Wstawia zawartość schowka w bieżącej pozycji kursora. Schowek stanowi integralną część środowiska &kde; i umożliwia wymianę danych pomiędzy różnymi programami.</para> +<note +><para +>Jeżeli włączona jest opcja "Nadpisuj zaznaczenie" to wklejany tekst spowoduje zastąpienie zaznaczonego fragmentu dokumentu.</para +></note> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-select-all"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>A</keycap +></keycombo +></shortcut +> <guimenu +>Edycja</guimenu +><guimenuitem +>Zaznacz wszystko</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Powoduje zaznaczenie całego dokumentu.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-deselect"/> +<menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;&Shift;<keycap +>A</keycap +></keycombo +> </shortcut +> <guimenu +>Edycja</guimenu +><guimenuitem +>Usuń zaznaczenie</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Usuwa zaznaczenie tekstu, o ile jakiś tekst jest zaznaczony.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-toggle-block-selection"/> +<menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;&Shift;<keycap +>B</keycap +></keycombo +> </shortcut +> <guimenu +>Edycja</guimenu +><guimenuitem +>Tryb zaznaczania bloku</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Przełącza sposób zaznaczania tekstu. Jeżeli włączony jest tryb zaznaczania bloku, to użytkownik może zaznaczać pionowe obszary dokumentu (przykładowo można zaznaczyć kolumny od 5 do 10 w wierszach od 9 do 15).</para> +<para +>Pasek stanu pokazuje aktywny tryb zaznaczania wyświetlając <quote +>NORM</quote +> lub <quote +>BLK</quote +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-find"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>F</keycap +></keycombo +></shortcut +> <guimenu +>Edycja</guimenu +><guimenuitem +>Znajdź</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Otwiera okno wyszukiwania, służące do znajdowania tekstu w bieżącym dokumencie.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-find-next"/> +<menuchoice +><shortcut +><keycombo action="simul" +><keycap +>F3</keycap +></keycombo +></shortcut +> <guimenu +>Edycja</guimenu +><guimenuitem +>Znajdź następne</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Przenosi kursor do kolejnego wystąpienia poszukiwanego napisu lub wyrażenia regularnego w dokumencie.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-find-previous"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Shift;<keycap +>F3</keycap +></keycombo +></shortcut +> <guimenu +>Edycja</guimenu +> <guimenuitem +>Znajdź poprzedni</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Przenosi kursor do poprzedniego wystąpienia poszukiwanego napisu lub wyrażenia regularnego w dokumencie.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-replace"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>R</keycap +></keycombo +></shortcut +> <guimenu +>Edycja</guimenu +> <guimenuitem +>Zastąp...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Otwiera okno dialogowe polecenia zastępowania znalezionego napisu innym napisem.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-go-to-line"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>G</keycap +></keycombo +></shortcut +> <guimenu +>Edycja</guimenu +> <guimenuitem +>Idź do wiersza...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Opcja ta otwiera okno przejścia do wiersza, w którym użytkownik określa numer wiersza, do którego chce przenieść kursor.</para> +</listitem> +</varlistentry> + +</variablelist> + +</sect1> + +<sect1 id="document-menu"> +<title +>Menu <guimenu +>Dokument</guimenu +></title> +<para +>Menu Dokument zawiera wpisy odpowiadające wszystkim otwartym plikom. Wybranie jednej z pozycji tego menu przywoła odpowiedni dokument i wyświetli go w oknie edycyjnym. Jeżeli użytkownik korzysta z ramek, to wybrany dokument zostanie pokazany w aktywnej ramce.</para> +<para +>Dodatkowe polecenia pozwalają na poruszanie się pomiędzy otwartymi dokumentami: <variablelist> +<title +>Pozycje menu</title> + +<varlistentry> +<term> +<anchor id="document-back"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Alt;<keycap +>W lewo</keycap +></keycombo +></shortcut +> <guimenu +>Dokument</guimenu +> <guimenuitem +>W tył</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Przywołuje dokument poprzedni w stosunku do bieżącego. W przypadku korzystania z ramek pokazany zostanie w aktywnej ramce.</para +> <para +>Dokumenty ustawione są w kolejności otwierania, a nie historii korzystania z nich. To zachowanie może zostać zmienione w kolejnych wersjach &kate;.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="document-forward"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Alt;<keycap +>W prawo</keycap +></keycombo +></shortcut +> <guimenu +>Dokument</guimenu +> <guimenuitem +>W przód</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Przywołuje dokument następny w stosunku do bieżącego. W przypadku korzystania z ramek pokazany zostanie w aktywnej ramce.</para> +<para +>Dokumenty ustawione są w kolejności otwierania, a nie historii korzystania z nich. To zachowanie może zostać zmienione w kolejnych wersjach &kate;.</para> +</listitem> +</varlistentry> +</variablelist> +</para> +</sect1> + +<sect1 id="view-menu"> +<title +>Menu <guimenu +>Widok</guimenu +></title> + +<para +>Menu <guimenu +>Widok</guimenu +> pozwala na zarządzanie ustawieniami specyficznymi dla aktywnego okna edytora oraz na zarządzanie ramkami.</para> + +<variablelist> +<title +>Pozycje menu</title> + +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +><keycap +>F7</keycap +></keycombo +></shortcut +> <guimenu +>Widok</guimenu +> <guimenuitem +>Przełącz do linii poleceń</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Polecenie włącza lub wyłącza wyświetlanie <link linkend="advanced-editing-tools-commandline" +>wbudowanej linii poleceń edytora</link +>. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Widok</guimenu +> <guimenuitem +>Schemat</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Menu wyświetli listę dostępnych schematów ustawień. Użytkownik może wybrać z listy wymagany dla bieżącego edytora schemat ustawień. Zmiana domyślnego schematu możliwa jest w <link linkend="config-dialog-editor-colors" +>oknie konfiguracji</link +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +><keycap +>F10</keycap +></keycombo +></shortcut +> <guimenu +>Widok</guimenu +> <guimenuitem +>Dynamiczne zawijanie wyrazów</guimenuitem +></menuchoice> +</term> +<listitem +><para +>Włącza lub wyłącza funkcję dynamicznego zawijania wyrazów dla bieżącego okna edytora. Funkcja ta pozwala na wyświetlanie całego tekstu w oknie bez konieczności stosowania poziomego paska przesuwania. Dzieje się tak poprzez wyświetlenie jednego wiersza rzeczywistego w kilku wierszach w oknie edytora w sytuacji, gdy wiersz rzeczywisty nie mieści się w oknie.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Widok</guimenu +> <guimenuitem +>Pokaż znacznik statycznego zawijania wyrazów</guimenuitem +></menuchoice +></term> +<listitem +><para +>Włączenie tej opcji powoduje wyświetlenie pionowej kreski w tej kolumnie tekstu, w której nastąpiłoby przeniesienie do następnego wiesza. Numer tej kolumny określony jest w <link linkend="config-dialog-editor-wrap-words-at" +>oknie konfiguracji</link +>. Znacznik zawijania wyrazów widoczny jest jedynie w przypadku użycia czcionki o stałej szerokości.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="view-show-icon-border"/> +<menuchoice +><shortcut +><keycombo action="simul" +><keycap +>F6</keycap +></keycombo +></shortcut +> <guimenu +>Widok</guimenu +> <guimenuitem +>Pokaż pasek ikon</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Przełącza wyświetlanie paska ikon po lewej stronie obszaru edycji.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="view-show-line-numbers"/> +<menuchoice +><shortcut +><keycombo action="simul" +><keycap +>F11</keycap +></keycombo +></shortcut +> <guimenu +>Widok</guimenu +> <guimenuitem +>Pokaż numery wierszy</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Przełącza wyświetlanie paska zawierającego kolejne numery wierszy po lewej stronie aktywnego okna edytora.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Widok</guimenu +> <guimenuitem +>Pokaż znaki paska przewijania</guimenuitem +></menuchoice +></term> +<listitem +><para +>Przełącza wyświetlanie znaczników zakładek (i innych wyróżnionych miejsc w dokumencie) na pionowym pasku przewijania. Znaczniki są wyświetlane jako cienkie kreski w kolorze zdefiniowanym dla zakładek. Kliknięcie środkowym klawiszem na tej kresce przesunie kursor na pozycję oznaczonej zakładki.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +><keycap +>F9</keycap +></keycombo +></shortcut +> <guimenuitem +>Pokaż/Ukryj znaczniki zwijania</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Przełącza wyświetlanie znaczników zwijania kodu źródłowego w pasku po lewej stronie okna. Więcej na ten temat w rozdziale <link linkend="advanced-editing-tools-code-folding" +>korzystanie ze zwijania kodu źródłowego</link +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="view-code-folding"/> +<menuchoice> +<guimenuitem +>Zwijanie kodu</guimenuitem> +</menuchoice> +</term> + +<listitem> +<variablelist> +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +><keycap +>Ctrl</keycap +> <keycap +>Shift</keycap +><keycap +>-</keycap +></keycombo +></shortcut +> <guimenuitem +>Zwiń szczytowy poziom</guimenuitem +></menuchoice> +</term> +<listitem +><para +>Zwija wszystkie szczytowe regiony zwijania w dokumencie.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +><keycap +>Ctrl</keycap +> <keycap +>Shift</keycap +><keycap +>+</keycap +></keycombo +></shortcut +> <guimenuitem +>Rozwiń szczytowy poziom</guimenuitem +></menuchoice> +</term> +<listitem +><para +>Rozwija wszystkie szczytowe regiony zwijania w dokumencie.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +><keycap +>Ctrl</keycap +> <keycap +>-</keycap +></keycombo +></shortcut +> <guimenuitem +>Zwiń jeden poziom lokalny</guimenuitem +></menuchoice> +</term> +<listitem +><para +>Zwija jeden region zwijania kodu znajdujący się najbliżej bieżącej pozycji kursora.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +><keycap +>Ctrl</keycap +> <keycap +>+</keycap +></keycombo +></shortcut +> <guimenuitem +>Rozwiń jeden poziom lokalny</guimenuitem +></menuchoice> +</term> +<listitem +><para +>Rozwija region zwijania kodu znajdujący się najbliżej kursora.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> + +</varlistentry> + +</variablelist> + +</sect1> + +<sect1 id="bookmarks-menu"> +<title +>Menu <guimenu +>Zakładki</guimenu +></title> + +<para +>Menu <guimenu +>Zakładki</guimenu +> pozwala użytkownikowi na zarządzanie zakładkami zdefiniowanymi w bieżącym dokumencie.</para> + +<para +>W dolnej części menu widoczna jest lista zakładek znajdujących się w bieżącym dokumencie (jeżeli tylko zostały zdefiniowane). Wyświetlone będą początkowe wyrazy wiersza, w którym została zdefiniowana zakładka. Wybranie zakładki z menu spowoduje przesunięcie kursora do odpowieniego wiersza i pokazanie go w oknie edycyjnym.</para> + +<variablelist> + +<title +>Pozycje menu</title> + +<varlistentry> +<term> +<anchor id="bookmarks-toggle-bookmark"/> +<menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>B</keycap +></keycombo +> </shortcut +> <guimenu +>Zakładki</guimenu +> <guimenuitem +>Ustaw zakładkę</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Ustawia bądź usuwa zakładkę dla wiersza dokumentu, w którym znajduje się kursor (jeżeli zakładka dla tego wiersza już istnieje, to zostanie usunięta, w przeciwnym wypadku zostanie dodane nowa).</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="bookmarks-clear-bookmarks"/> +<menuchoice +><guimenu +>Zakładki</guimenu +> <guimenuitem +>Wyczyść wszystkie zakładki</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Usuwa wszystkie zakładki zdefiniowane dla bieżącego dokumentu.</para> +</listitem> +</varlistentry> + +<varlistentry id="bookmarks-previous"> +<term +><menuchoice +><shortcut +><keycombo action="simul" +><keycap +>Alt</keycap +> <keycap +>Page Up</keycap +></keycombo +></shortcut +> <guimenu +>Zakładki</guimenu +><guimenuitem +>Poprzednia</guimenuitem +></menuchoice> +</term> +<listitem +><para +>Przesuwa kursor do zakładki znajdującej się przed bieżącą pozycją kursora. W menu widoczny będzie numer wiersza z zakładką oraz pierwsze wyrazy tego wiersza. Niniejsza pozycja pojawia się w menu jedynie wtedy, gdy istnieją zakładki poprzedzające bieżącą pozycję kursora.</para +></listitem> +</varlistentry> + +<varlistentry id="bookmarks-next"> +<term +><menuchoice +><shortcut +><keycombo action="simul" +><keycap +>Alt</keycap +> <keycap +>Page Down</keycap +></keycombo +></shortcut +> <guimenu +>Zakładki</guimenu +><guimenuitem +>Następna</guimenuitem +></menuchoice +></term> +<listitem +><para +>Przesuwa kursor do zakładki znajdującej się poniżej bieżącej pozycji kursora. W menu widoczny będzie numer wiersza z zakładką oraz początkowe wyrazy z tego wiersza. Niniejsza pozycja pojawia się w menu jedynie wtedy, gdy istnieją zakładki znajdujące się poniżej bieżącej pozycji kursora.</para +></listitem> +</varlistentry> + +</variablelist> + +</sect1> + +<sect1 id="tools-menu"> + +<title +>Menu <guimenu +>Narzędzia</guimenu +></title> + +<variablelist> + +<varlistentry> +<term +><menuchoice +><guimenu +>Narzędzia</guimenu +><guimenuitem +>Wklej do konsoli</guimenuitem +></menuchoice +></term> +<listitem +><para +>Przenosi zaznaczony fragment tekstu do okna wbudowanej konsoli bez dodawania znaku końca wiersza.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Narzędzia</guimenu +> <guisubmenu +>Narzędzia zewnętrzne</guisubmenu +></menuchoice +></term> +<listitem +><para +>Menu wyświetla listę wszystkich dostępnych <link linkend="kate-mdi-tools-externaltools" +>narzędzi zewnętrznych</link +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-read-only"/><menuchoice +><guimenu +>Narzędzia</guimenu +> <guimenuitem +>Tryb tylko do odczytu</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Ustawia bieżący dokument w tryb tylko to odczytu, który blokuje możliwość dodawania i zmieniania jego treści.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-filetype"/><menuchoice +><guimenu +>Narzędzia</guimenu +> <guimenuitem +>Typ pliku</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Opcja pozwala na wybranie schematu typu pliku dla bieżącego dokumentu. Zmiana tutaj dokonana zastępuje ustawienia globalne dla typu pliku znajdujące się w menu <menuchoice +> <guimenu +>Ustawienia</guimenu +> <guimenuitem +>Konfiguracja edytora...</guimenuitem +></menuchoice +> w karcie Typy plików, ale wyłącznie dla otwartego dokumentu.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-highlighting"/><menuchoice +><guimenu +>Narzędzia</guimenu +> <guimenuitem +>Podświetlenie</guimenuitem +></menuchoice +></term> + <listitem> +<para +>Pozwala na wybór reguł podświetlania składni dla bieżącego dokumentu. Wybranie tej opcji zastępuje globalne ustawienie podświetlania składni zdefiniowane w menu <menuchoice +> <guimenu +>Ustawienia</guimenu +> <guimenuitem +>Konfiguracja edytora...</guimenuitem +></menuchoice +> w zakładce: Podświetlenie.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-indentation"/><menuchoice +><guimenu +>Narzędzia</guimenu +><guimenuitem +>Wcięcia</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Pozwala na wybór zachowania mechanizmu <link linkend="kate-part-autoindent" +>automatycznych wcięć</link +>. Zmiana dokonana tutaj zastępuje globalne ustawienia zdefiniowane w menu <menuchoice +> <guimenu +>Ustawienia</guimenu +> <guimenuitem +>Konfiguracja edytora...</guimenuitem +></menuchoice +> w zakładce: Wcięcia.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-encoding"/><menuchoice +><guimenu +>Narzędzia</guimenu +> <guimenuitem +>Kodowanie</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Umożliwia zmianę ustawienia kodowania znaków zdefiniowanego w menu <menuchoice +> <guimenu +>Ustawienia</guimenu +> <guimenuitem +>Konfiguracja edytora...</guimenuitem +></menuchoice +> w zakładce: Otwórz/Zapisz. Dokonana zmiana dotyczyć będzie tylko bieżącego dokumentu.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-end-of-line"/><menuchoice +><guimenu +>Narzędzia</guimenu +> <guimenuitem +>Koniec wiersza</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Pozwala na zmianę stosowanego kodowania znaków końca wiersza dla bieżącego dokumentu. Zmiana dokonana tutaj zastępuje globalne ustawienie zdefiniowane w menu <menuchoice +> <guimenu +>Ustawienia</guimenu +> <guimenuitem +>Konfiguracja &kate;...</guimenuitem +></menuchoice +> w zakładce: Otwórz/Zapisz.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-spelling"/><menuchoice +><guimenu +>Narzędzia</guimenu +><guimenuitem +>Poprawność pisowni...</guimenuitem +></menuchoice> +</term> + +<listitem +><para +><action +>Uruchamia moduł sprawdzania pisowni, który pomaga znaleźć i poprawić błędy ortograficzne</action +>. Kliknięcie tej pozycji menu rozpocznie sprawdzanie i otworzy okno za pomocą którego można ten proces kontrolować. W środkowej części okna dostępne są cztery pola, zaczynając od góry:</para> + +<variablelist> +<varlistentry> +<term +><guilabel +>Nieznane słowo:</guilabel +></term> +<listitem +><para +>Wyświetlane tu jest słowo, na którym zatrzymało się sprawdzanie pisowni. Następuje to zawsze, gdy program sprawdzający znajdzie słowo, którego nie ma w swoim słowniku (pliku zawierającego listę poprawnych wyrazów, z którymi porównywane są wszystkie słowa z dokumentu).</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Zastąp przez:</guilabel +></term> +<listitem +><para +>Jeżeli program sprawdzający znajdzie w swoim słowniku wyrazy podobne do wyrazu błędnego, to tutaj pojawi się pierwszy z listy znalezionych wyrazów. Użytkownik może zaakceptować sugestię programu, może wpisać w tym polu własną skorygowaną wersję słowa lub wybrać inną sugestię z listy podpowiedzi znajdującej się poniżej.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Podpowiedzi:</guilabel +></term> +<listitem +><para +>Program sprawdzający wyświetli tutaj listę wyrazów najbardziej zbliżonych do wyrazu uznanego za błędny. Kliknięcie na dowolnej pozycji z listy podpowiedzi spowoduje przeniesienie sugerowanego wyrazu do pola <guilabel +>Zastąp przez:</guilabel +> znajdującego się powyżej.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Język:</guilabel +></term> +<listitem +><para +>Jeżeli w systemie zainstalowane są słowniki dla różnych języków, to tutaj można wybrać słownik/język, który będzie wykorzystywany do sprawdzania pisowni.</para +></listitem> +</varlistentry> +</variablelist> + +<para +>Po prawej stronie okna dialogowego widoczne jest pięć przycisków pozwalających użytkownikowi kontrolować proces sprawdzania i korygowania pisowni. Są to przyciski:</para> + +<variablelist> +<varlistentry> +<term +><guibutton +>Dodaj do słownika</guibutton +></term> +<listitem +><para +>Powoduje dodanie <guilabel +>nieznanego słowa</guilabel +> do słownika. Dzięki temu podczas kolejnego sprawdzania słowo to będzie uznane za poprawne.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guibutton +>Zastąp</guibutton +></term> +<listitem +><para +>Ten przycisk zamienia znalezione w tekście nieznane słowo na słowo wpisane w polu <guilabel +>Zastąp przez:</guilabel +>.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guibutton +>Zastąp wszystkie</guibutton +></term> +<listitem +><para +>Przycisk ten zamienia znalezione <guilabel +>nieznane słowo</guilabel +> oraz wszystkie pozostałe jego wystąpienia w dokumencie na słowo widoczne w polu <guilabel +>Zastąp przez</guilabel +>.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guibutton +>Ignoruj</guibutton +></term> +<listitem +><para +>Naciśnięcie przycisku spowoduje zignorowanie znalezionego nieznanego słowa i kontynuację procesu sprawdzania tekstu bez dokonywania żadnych zmian.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guibutton +>Ignoruj wszystkie</guibutton +></term> +<listitem +><para +>Naciśnięcie przycisku spowoduje zignorowanie faktu znalezienia <guilabel +>nieznanego słowa</guilabel +> i kontynuację procesu sprawdzania tekstu. Zignorowane będą również wszystkie pozostałe wystąpienia tego słowa w tekście.</para +> <note +><para +>Polecenie "ignoruj wszystkie" dotyczy tylko jednego uruchomienia programu sprawdzania pisowni. Jeżeli sprawdzanie będzie znowu później uruchomione, to program zatrzyma się na tym słowie.</para +></note +></listitem> +</varlistentry> +</variablelist> + +<para +>Kolejne trzy przyciski widoczne w oknie sprawdzania pisowni zlokalizowane są w jego dolnej części. Są to:</para> + +<variablelist> +<varlistentry> +<term +><guibutton +>Pomoc</guibutton +></term> +<listitem +><para +>Opcja ta uruchamia system pomocy &kde; i otwiera niniejszą dokumentację.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>Zakończ</guibutton +></term> +<listitem +><para +>Przycisk ten kończy proces sprawdzania pisowni i wraca do bieżącego dokumentu.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>Anuluj</guibutton +></term> +<listitem +><para +>Przycisk ten anuluje sprawdzanie pisowni. Wszystkie zmiany (operacje zastąpienia słów) są cofane i następuje powrót do bieżącego dokumentu.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> + +<variablelist> +<varlistentry> +<term +><anchor id="tools-spelling-from-cursor"/><menuchoice +><guimenu +>Narzędzia</guimenu +> <guimenuitem +>Sprawdzanie pisowni (od kursora)...</guimenuitem +></menuchoice +></term> + <listitem> +<para +>Uruchamia program sprawdzający pisownię dla tekstu rozpoczynającego się od bieżącej pozycji kursora (zamiast od początku dokumentu).</para> + </listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-spellcheck-selection"/><menuchoice +><guimenu +>Narzędzia</guimenu +> <guimenuitem +>Sprawdzanie pisowni w zaznaczeniu...</guimenuitem +></menuchoice +></term> + <listitem> +<para +>Sprawdza pisownię w zaznaczonym fragmencie tekstu.</para> + </listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="indent"/><menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>I</keycap +></keycombo +> </shortcut +> <guimenu +>Narzędzia</guimenu +><guimenuitem +>Wcięcie</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Powoduje zwiększenie wcięcia wybranego wiersza o jeden krok. Wielkość kroku zależy od ustawień parametrów dotyczących <link linkend="config-dialog-editor-indent" +>reguł wcięć</link +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-unindent"/><menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;&Shift;<keycap +>I</keycap +></keycombo +> </shortcut +> <guimenu +>Narzędzia</guimenu +><guimenuitem +>Usuń wcięcie</guimenuitem +></menuchoice +></term> + +<listitem> +<para +>Zmniejsza wcięcie bieżącego zdania o jeden krok. Wielkość kroku zależy od ustawień parametrów dotyczących <link linkend="config-dialog-editor-indent" +>reguł wcięć</link +>.</para> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-cleanindent"/><menuchoice +><guimenu +>Narzędzia</guimenu +><guimenuitem +>Wyczyść Wcięcia</guimenuitem +></menuchoice +></term +> <listitem> +<para +>Poprawia wcięcia dla zaznaczonego fragmentu tekstu lub dla wiersza, w którym znajduje się kursor. Poprawienie wcięć pozwala na zachowanie wybranego trybu wcięć dla danego fragmentu tekstu.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-align"/><menuchoice +><guimenu +>Narzędzia</guimenu +> <guimenuitem +>Wyrównaj</guimenuitem +> </menuchoice +></term> +<listitem> +<para +>Powoduje ponowne wyrównanie bieżącego wiersza lub wybranego fragmentu tekstu zgodnie z trybem wcięć ustawionym dla dokumentu.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-comment"/><menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>D</keycap +></keycombo +> </shortcut +> <guimenu +>Narzędzia</guimenu +><guimenuitem +>Komentarz</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Zmienia zaznaczony fragment lub bieżący wiersz tekstu na komentarz stosując reguły komentowania zgodne z wybranymi zasadami podświetlania kodu (HTML, C, itp.).</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-uncomment"/><menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;&Shift;<keycap +>D</keycap +></keycombo +> </shortcut +> <guimenu +>Narzędzia</guimenu +><guimenuitem +>Odkomentuj</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Usuwa komentarze z zaznaczonego fragmentu lub bieżącego wiersza tekstu. Komentarze rozpoznawane są zgodne z wybranymi zasadami podświetlania kodu (HTML, C, itp.).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-uppercase"/><menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>U</keycap +></keycombo +> </shortcut +> <guimenu +>Narzędzia</guimenu +><guimenuitem +>Duże litery</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Zmienia wszystkie litery w zaznaczonym fragmencie (lub jedną literę za kursorem) na duże.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-lowercase"/><menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;&Shift;<keycap +>U</keycap +></keycombo +> </shortcut +> <guimenu +>Narzędzie</guimenu +> <guimenuitem +>Małe litery</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Zmienia wszystkie litery w zaznaczonym fragmencie (lub jedną literę za kursorem) na małe.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-capitalize"/><menuchoice +><shortcut +> <keycombo action="simul" +>&Alt;&Ctrl;<keycap +>U</keycap +></keycombo +> </shortcut +> <guimenu +>Narzędzia</guimenu +> <guimenuitem +>Kapitaliki</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Przekształca zaznaczony fragment lub bieżące słowo na pisane kapitalikami.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-join-lines"/><menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>J</keycap +></keycombo +> </shortcut +> <guimenu +>Narzędzia</guimenu +> <guimenuitem +>Połącz wiersze</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Dokonuje połączenia wierszy w wybranym fragmencie, lub wiersza bieżącego z wierszem znajdującym się poniżej, używając spacji jako znaku oddzielającego. Spacje poprzedzające i znajdujące się na końcach łączonych linii są usuwane.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-word-wrap-document"/><menuchoice +><guimenu +>Narzędzia</guimenu +> <guimenuitem +>Zawiń wyrazy</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Powoduje zastosowanie reguł statycznego zawijania tekstu dla całego dokumentu. Oznacza to, że tekst zostanie przeniesiony do nowego wiersza automatycznie, jeżeli dany wiersz przekroczy ilość znaków zdefiniowaną w karcie "Edycja" w menu <menuchoice +> <guimenu +>Ustawienia</guimenu +><guimenuitem +>Konfiguracja &kate;...</guimenuitem +></menuchoice +></para +></listitem> +</varlistentry> + +</variablelist> + + +</sect1> + +<sect1 id="sessions-menu"> +<title +>Menu <guimenu +>Sesje</guimenu +></title> + +<para +>Menu zawiera polecenia służące do zarządzania sesjami programu &kate;. Więcej informacji na ten temat znajduje się w sekcji: <link linkend="fundamentals-using-sessions" +>Korzystanie z sesji</link +>.</para> + +<variablelist> + +<varlistentry id="sessions-new"> +<term +><menuchoice +><guimenu +>Sesje</guimenu +> <guimenuitem +>Nowa</guimenuitem +></menuchoice +></term> +<listitem +><para +>Tworzy nową, pustą sesję. Wszystkie otwarte pliki zostaną zamknięte.</para +></listitem> + +</varlistentry> + +<varlistentry id="sessions-open"> +<term +><menuchoice +><guimenu +>Sesje</guimenu +> <guimenuitem +>Otwórz...</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Otwiera okno dialogowe wyboru sesji pozwalające na wybór i otwarcie zapisanej sesji.</para +></listitem> +</varlistentry> + +<varlistentry id="sessions-quick-open"> +<term +><menuchoice +><guimenu +>Sesje</guimenu +> <guisubmenu +>Szybkie otwieranie</guisubmenu +> </menuchoice +></term> +<listitem +><para +>Wyświetla menu podrzędne pozwalające wybrać jedną spośród zapisanych sesji.</para> +</listitem> +</varlistentry> + +<varlistentry id="sessions-save"> +<term +><menuchoice +><guimenu +>Sesje</guimenu +> <guimenuitem +>Zapisz</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Zapisuje bieżącą sesję. Jeżeli sesja bieżąca jest nienazwana, to pojawi się prośba o nadanie nazwy dla tej sesji.</para +></listitem> +</varlistentry> + +<varlistentry id="sessions-save-as"> +<term +><menuchoice +><guimenu +>Sesje</guimenu +> <guimenuitem +>Zapisz jako...</guimenuitem +></menuchoice +></term> +<listitem +><para +>Pozwala na zapisanie bieżącej sesji pod nową nazwą.</para +></listitem> +</varlistentry> + +<varlistentry id="sessions-manage"> +<term +><menuchoice +><guimenu +>Sesje</guimenu +> <guimenuitem +>Zarządzaj...</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Wyświetla okno dialogowe "Zarządzanie sesjami", pozwalające na zmiany nazw i usuwanie zapisanych sesji.</para +></listitem> +</varlistentry> + + +</variablelist> + +</sect1> + +<sect1 id="settings-menu"> + +<title +>Menu <guimenu +>Ustawienia</guimenu +></title> + +<para +>Menu <guimenu +>Ustawienia</guimenu +> umożliwia zmianę właściwości głównego okna programu, takich jak pokazywanie i ukrywanie pasków narzędzi. Pozwala także na uruchamianie okien dialogowych konfiguracji parametrów programu.</para> + +<variablelist> + +<varlistentry> +<term> +<anchor id="settings-toolbars"/> +<menuchoice +><guimenu +>Ustawienia</guimenu +> <guimenuitem +>Paski narzędzi</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Podmenu wyświetla listę dostępnych pasków narzędzi. Każda pozycja tego podmenu włącza lub wyłącza wyświetlanie jednego z pasków narzędzi.</para> +</listitem> +</varlistentry> + +<varlistentry id="settings-fullscreen"> +<term +><menuchoice +><guimenu +>Ustawienia</guimenu +> <guimenuitem +>Tryb pełnoekranowy</guimenuitem +></menuchoice +></term> +<listitem +><para +>Przełącza program w tryb pełnego ekranu.</para> +<note +><para +>W przyszłości polecenie to zostanie przeniesione do menu "Okno"</para +></note> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="settings-configure-shortcuts"/> +<menuchoice +><guimenu +>Ustawienia</guimenu +><guimenuitem +>Konfiguracja skrótów...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Wyświetla standardowe okno ustawień skrótów klawiszowych środowiska &kde;.</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term> +<anchor id="settings-configure-toolbars"/> +<menuchoice +><guimenu +>Ustawienia</guimenu +><guimenuitem +>Konfiguracja pasków narzędzi...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Wyświetla standardowe okno konfiguracji pasków narzędzi środowiska &kde;.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="settings-configure-kate"/> +<menuchoice +><guimenu +>Ustawienia</guimenu +> <guimenuitem +>Konfiguracja &kate;</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Otwiera <link linkend="config-dialog" +> główne okno konfiguracji programu</link +> &kate;.</para> +</listitem> +</varlistentry> + +</variablelist> + +</sect1> + +<sect1 id="window-menu"> +<title +>Menu <guimenu +>Okno</guimenu +></title> + +<variablelist> +<varlistentry> +<term> +<anchor id="window-new"/> +<menuchoice +><guimenu +>Okno</guimenu +> <guimenuitem +>Nowe okno</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +><action +>Otwiera nową instancję programu &kate;</action +>. Zawartość nowego okna będzie identyczna jak w bieżącej instancji &kate;. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="window-split-vertical"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>L</keycap +></keycombo +></shortcut +> <guimenu +>Okno</guimenu +> <guimenuitem +>Podziel pionowo</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Spowoduje podzielenie ramki (zwykle jest to obszar edycji) na dwie równe części. Nowa część będzie umieszczona po lewej stronie części bieżącej. Nowa ramka stanie się aktywna i pokazuje ten sam dokument.</para> +<para +>Patrz również <link linkend="kate-mdi" +>Praca z &kate; MDI</link +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="window-split-horizontal"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>T</keycap +></keycombo +></shortcut +> <guimenu +>Okno</guimenu +> <guimenuitem +>Podziel poziomo</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Spowoduje podzielenie ramki (zwykle jest to obszar edycji) na dwie równe części. Nowa część będzie umieszczona u dołu pod częścią bieżącą. Nowa ramka stanie się aktywna i wyświetli dokument bieżący.</para> +<para +>Patrz również <link linkend="kate-mdi" +>Praca z &kate; MDI</link +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="window-close-current"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>R</keycap +></keycombo +></shortcut +> <guimenu +>Okno</guimenu +> <guimenuitem +>Zamknij bieżący widok</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Zamyka aktywną ramkę. Opcja ta jest niedostępna, jeśli w programie występuje tylko jedna ramka (główny obszar edycji).</para +> <para +>Zamknięcie ramki nie zamyka żadnego dokumentu. Będą one w dalszym ciągu dostępne w menu <link linkend="document-menu" +><guimenu +>Dokument</guimenu +></link +>, jak też na liście dokumentów.</para +> <para +>Patrz również <link linkend="kate-mdi" +>Praca z &kate; MDI</link +>.</para> +</listitem> +</varlistentry> + +<varlistentry id="window-next-view"> +<term +><menuchoice +><shortcut +><keycombo action="simul" +><keycap +>F8</keycap +> </keycombo +></shortcut +><guimenu +>okno</guimenu +><guimenuitem +>Następny widok</guimenuitem +></menuchoice +></term> +<listitem +><para +>Uaktywnia kolejny widok w przypadku, jeżeli okno edycyjne zostało wcześniej podzielone na kilka widoków.</para +></listitem> +</varlistentry> + +<varlistentry id="window-previous-view"> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Shift;<keycap +>F8</keycap +> </keycombo +></shortcut +><guimenu +>Okno</guimenu +><guimenuitem +>Poprzedni widok</guimenuitem +></menuchoice +></term> +<listitem +><para +>Uaktywnia poprzedni widok w przypadku, jeżeli okno edycyjne zostało wcześniej podzielone na kilka widoków.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Okno</guimenu +><guisubmenu +>Widoki narzędzi</guisubmenu +> </menuchoice +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><anchor id="window-toolviews-show-sidebars"/> +<menuchoice +><guimenu +>Okno</guimenu +><guisubmenu +>Widoki narzędzi</guisubmenu +> <guimenuitem +>Pokaż/Ukryj panele</guimenuitem +></menuchoice +></term> +<listitem +><para +>Przełącza wyświetlanie paska z przyciskami przełączającymi widoki w panelach. Komenda ta nie wpływa na wyświetlanie zawartości panelu. Jeżeli jest on widoczny to pozostaje widoczny, zaś skróty klawiszowe przypisane do poniżej wymienionych poleceń będą działać dalej.</para +></listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="window-toolviews-show-filelist"/> +<menuchoice +><guimenu +>Okno</guimenu +><guisubmenu +>Widoki narzędzi</guisubmenu +> <guimenuitem +>Pokaż/Ukryj panel Dokumenty</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Włącza lub ukrywa listę dokumentów otwartych w programie &kate;.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="window-toolviews-show-fileselector"/> +<menuchoice +><guimenu +>Okno</guimenu +><guisubmenu +>Widoki narzędzi</guisubmenu +> <guimenuitem +>Pokaż/Ukryj panel Przeglądarka systemu plików</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Włącza lub ukrywa przeglądarkę systemu plików.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="window-toolviews-greptool"/> +<menuchoice +><guimenu +>Okno</guimenu +><guisubmenu +>Widoki narzędzi</guisubmenu +> <guimenuitem +>Pokaż/Ukryj panel Znajdź w plikach</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Włącza lub wyłącza wyświetlanie narzędzia <guilabel +>Znajdź w plikach</guilabel +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="window-toolviews-show-konsole"/> +<menuchoice +><guimenu +>Okno</guimenu +><guisubmenu +>Widoki narzędzi</guisubmenu +> <guimenuitem +>Pokaż/Ukryj panel Konsola</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Włącza lub wyłącza wyświetlanie okna wbudowanej konsoli.</para> +<para +>Pierwsze uaktywnienie tej opcji spowoduje otwarcie nowej sesji w oknie konsoli.</para> +<para +>Po wyświetleniu konsola staje się aktywna, co umożliwia natychmiastowe wprowadzanie poleceń. Dodatkowo, jeżeli włączona została opcja <link linkend="config-dialog-general-sync-konsole" +>Synchronizuj konsolę z aktywnym dokumentem</link +> w karcie <link linkend="config-dialog-general" +>Ogólne</link +> okna <link linkend="config-dialog" +>Konfiguracji</link +>, to bieżący katalog w konsoli zostanie ustawiony na katalog bieżącego dokumentu.</para> +</listitem> +</varlistentry> + +</variablelist> + +</listitem> +</varlistentry> + +</variablelist> + +</sect1> + +<sect1 id="help-menu"> + +<title +>Menu <guimenu +>Pomoc</guimenu +></title> + +<para +>Oprócz standardowych elementów menu <guimenu +>Pomoc</guimenu +> środowiska &kde; znajdują się tu również opcje wyświetlające podręczniki użytkownika zainstalowanych w &kate; wtyczek.</para> +&help.menu.documentation; </sect1> + +</chapter> diff --git a/tde-i18n-pl/docs/tdebase/kate/mimetypechooser.png b/tde-i18n-pl/docs/tdebase/kate/mimetypechooser.png Binary files differnew file mode 100644 index 00000000000..3ade00eb2d5 --- /dev/null +++ b/tde-i18n-pl/docs/tdebase/kate/mimetypechooser.png diff --git a/tde-i18n-pl/docs/tdebase/kate/part.docbook b/tde-i18n-pl/docs/tdebase/kate/part.docbook new file mode 100644 index 00000000000..202e8e6ac3c --- /dev/null +++ b/tde-i18n-pl/docs/tdebase/kate/part.docbook @@ -0,0 +1,1000 @@ +<chapter id="kate-part"> +<chapterinfo> +<authorgroup> +<author +>&Anders.Lund; &Anders.Lund.mail;</author> +<othercredit role="translator" +><firstname +>Suse</firstname +><surname +>Polska</surname +><affiliation +><address +><email +>suse@suse.pl</email +></address +></affiliation +><contrib +>Polskie tłumaczenie</contrib +></othercredit +> <othercredit role="translator" +><firstname +>Krzysztof</firstname +><surname +>Woźniak</surname +><affiliation +><address +><email +>wozniakk@ceti.pl</email +></address +></affiliation +><contrib +>Polskie tłumaczenie</contrib +></othercredit +> +</authorgroup> +</chapterinfo> +<title +>Praca z edytorem &kate;</title> + +<sect1 id="kate-part-overview"> + +<title +>Wstęp</title> + +<para +>Edytor &kate; jest częścią środowiska &kde; wykorzystywaną także przez inne programy takie jak np.: &kwrite; lub &konqueror; do wyświetlania plików lokalnych jak i znajdujących się w sieci.</para> + +<para +>Edytor składa się z następujących elementów:</para> + +<variablelist> + +<varlistentry> +<term +>Obszar edycji</term> +<listitem +><para +>Tutaj jest wyświetlana treść dokumentu.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Paski przewijania</term> +<listitem> +<para +>Paski przewijania pozwalają na przesuwanie widocznego obszaru dokumentu. Przesuwanie dokumentu za pomocą pasków przewijania nie powoduje zmiany bieżącej pozycji kursora.</para> +<para +>Paski przewijania są wyświetlane i ukrywane w zależności od potrzeb.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Pasek ikon</term> +<listitem> +<para +>Pasek ikon jest wąskim obszarem po lewej stronie obszaru edycji wyświetlającym różnego rodzaju ikony obok zaznaczonych wierszy tekstu.</para> +<para +>Klikając lewym przyciskiem myszy w pasku ikon można dodać lub usunąć <link linkend="kate-part-bookmarks" +>zakładkę</link +> dla wybranego wiersza dokumentu.</para> +<para +>Przełączenie wyświetlania paska ikon odbywa się poprzez menu: <menuchoice +><guimenu +>Widok</guimenu +> <guimenuitem +>Pokaż pasek ikon</guimenuitem +></menuchoice +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Pasek numerów wierszy</term> +<listitem> +<para +>Pasek numerów wierszy wyświetla numery wszystkich widocznych wierszy dokumentu.</para> +<para +>Przełączanie wyświetlania paska numerów wierszy odbywa się poprzez menu: <menuchoice +><guimenu +>Widok</guimenu +> <guimenuitem +>Pokaż numery wierszy</guimenuitem +></menuchoice +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Pasek znaczników zwijania</term> +<listitem> +<para +>Pozwala użytkownikowi na zwijanie lub rozwijanie fragmentów kodu programu. Rozpoznawanie fragmentu podlegającego operacji zwinięcia/rozwinięcia odbywa się zgodnie z zasadami zdefiniowanymi w regułach podświetlania składni dla danego formatu dokumentu.</para> +</listitem> +</varlistentry> + +</variablelist> + +<itemizedlist> +<title +>Pozostałe informacje zawarte w niniejszym rozdziale:</title> +<listitem +><para +><link linkend="kate-part-navigation" +>Nawigacja w tekście</link +> </para +></listitem> +<listitem +><para +><link linkend="kate-part-selection" +>Zaznaczanie tekstu</link +></para +></listitem> +<listitem +><para +><link linkend="kate-part-copy-and-paste" +>Kopiowanie i wklejanie</link +></para +></listitem> +<listitem +><para +><link linkend="kate-part-find-replace" +>Wyszukiwanie i zamiana tekstu</link +></para +></listitem> +<listitem +><para +><link linkend="kate-part-bookmarks" +>Korzystanie z zakładek</link +></para +></listitem> +<listitem +><para +><link linkend="kate-part-auto-wrap" +>Automatyczne zawijanie wyrazów</link +></para +></listitem> +<listitem +><para +><link linkend="kate-part-autoindent" +>Korzystanie z automatycznych wcięć</link +></para +></listitem> +</itemizedlist> + +</sect1> + +<sect1 id="kate-part-navigation"> +<title +>Nawigacja w tekście</title> + +<para +>Przesuwanie kursora w treści dokumentu odbywa się w &kate; tak, jak w większości graficznych edytorów tekstu. Działają klawisze strzałek, <keycap +>Page Up</keycap +>, <keycap +>Page Down</keycap +>, <keycap +>Home</keycap +>, <keycap +>End</keycap +> oraz ich kombinacje z klawiszami <keycap +>Ctrl</keycap +> oraz <keycap +>Shift</keycap +>. Klawisz <keycap +>Shift</keycap +> stosowany jest do zaznaczania tekstu zaś klawisz <keycap +>Ctrl</keycap +> w różny sposób modyfikuje sposób działania pozostałych klawiszy: <itemizedlist> +<listitem +><para +>W połączeniu z klawiszami strzałek <keycap +>w górę</keycap +> i <keycap +>w dół</keycap +> powoduje przesuwanie zawartości okna zamiast przesuwania kursora.</para +></listitem> +<listitem +><para +>Użycie <keycap +>Ctrl</keycap +> z klawiszami strzałek <keycap +>w lewo</keycap +> oraz <keycap +>w prawo</keycap +> będzie powodowało przesuwanie kursora o całe wyrazy, a nie o pojedyncze znaki.</para +></listitem> +<listitem +><para +>Dla klawiszy <keycap +>Page Up</keycap +> oraz <keycap +>Page Down</keycap +> zmiana działania polega na przesuwaniu kursora najpierw na początek lub koniec bieżącego okna, zamiast przesuwania o jedną stronę z zachowaniem pozycji kursora.</para> +</listitem> +<listitem +><para +>W kombinacji z <keycap +>Home</keycap +> oraz <keycap +>End</keycap +>, <keycap +>Ctrl</keycap +> oznacza przesunięcie na początek lub koniec dokumentu, nie zaś na początek lub koniec wiersza.</para +></listitem> +</itemizedlist> +</para> + +<para +>Program &kate; umożliwia szybkie przemieszczanie się pomiędzy odpowiadającymi sobie parami nawiasów lub cudzysłowów. Naciśnięcie klawiszy <keycombo +><keycap +>Ctrl</keycap +><keycap +>6</keycap +></keycombo +> gdy kursor znajduje się obok nawiasu lub cudzysłowu spowoduje przeniesienie go do nawiasu lub cudzysłowu będącego dla niego parą.</para> + +<para +>Dodatkowo można skorzystać z mechanizmu <link linkend="kate-part-bookmarks" +>zakładek</link +> w celu szybkiego przenoszenia kursora pomiędzy zdefiniowanymi wcześniej pozycjami w treści dokumentu.</para> + +</sect1> + +<sect1 id="kate-part-selection"> +<title +>Zaznaczanie tekstu</title> + +<para +>Fragmenty tekstu w &kate; można zaznaczać za pomocą myszki lub klawiatury.</para> + +<para +>Aby zaznaczyć tekst za pomocą myszki, należy nacisnąć i przytrzymać lewy przycisk myszki, a następnie przesunąć kursor z punktu wyjścia do końca zaznaczanego fragmentu. Zaznaczany fragment zmienia kolor tła w czasie zaznaczania.</para> + +<para +>Podwójne kliknięcie zaznacza cały wyraz.</para> + +<para +>Potrójne kliknięcie zaznacza cały wiersz.</para> + +<para +>Przytrzymanie klawisza &Shift; podczas klikania myszy w dokumencie powoduje zaznaczanie tekstu:</para> + +<itemizedlist> +<listitem +><para +>Gdy nie ma innego zaznaczenia to zostanie zaznaczony fragment od bieżącej pozycji kursora do pozycji, na której znajdzie się wskaźnik myszy w momencie kliknięcia.</para +></listitem> +<listitem +><para +>Jeżeli istnieje już zaznaczenie to kliknięcie rozszerzy zaznaczenie począwszy od jego granicy do pozycji wskaźnika myszy w momencie kliknięcia.</para +></listitem> +</itemizedlist> + +<note> +<para +>Zaznaczanie tekstu za pomocą myszki powoduje automatyczne kopiowanie go do schowka. Można potem zaznaczony fragment wkleić w dowolnym miejscu za pomocą środkowego przycisku myszki. Możliwe jest też wklejenie go w innym programie. </para> +</note> + +<para +>Aby zaznaczyć tekst za pomocą klawiatury, należy przytrzymać klawisz &Shift; i przesunąć kursor klawiszami strzałek, <keycap +>Page Up</keycap +>, <keycap +>Page Down</keycap +>, <keycap +>Home</keycap +> i <keycap +>End</keycap +> (działają też ich kombinacje z klawiszem &Ctrl;).</para> + +<para +>Więcej informacji na ten temat w sekcji <link linkend="kate-part-navigation" +>Nawigacja w tekście</link +> niniejszego dokumentu.</para> + +<para +>Skopiowanie wybranego fragmentu do schowka możliwe jest za pomocą menu: <menuchoice +><guimenu +>Edycja</guimenu +> <guimenuitem +>Kopiuj</guimenuitem +></menuchoice +> lub skrótu klawiszowego (domyślnie jest to: <keycombo action="simul" +>&Ctrl;<keycap +>C</keycap +></keycombo +>).</para> + +<para +>Usunięcie zaznaczenia dla wybranego fragmentu odbywa się za pomocą opcji menu <menuchoice +><guimenu +>Edycja</guimenu +> <guimenuitem +>Usuń zaznaczenie</guimenuitem +></menuchoice +>, skrótu klawiszowego (domyślnie jest to: <keycombo action="simul" +>&Ctrl;&Shift;<keycap +>A</keycap +></keycombo +>) lub poprzez kliknięcie lewym przyciskiem myszy w dowolnym miejscu obszaru edycji.</para> + +<sect2 id="kate-part-selection-block"> +<title +>Korzystanie z zaznaczania bloku</title> + +<para +>Włączenie trybu zaznaczania bloku pozwala na <quote +>zaznaczanie tekstu w pionie</quote +>, tzn. wybór tych samych kolumn z wielu następujących po sobie wierszy. Funkcja ta jest przydatna w pracy z plikami zawierającymi kolumny o stałej szerokości np.: z danymi, liczbami, itp.</para> + +<para +>Tryb zaznaczania bloku może być włączony w menu <menuchoice +><guimenu +>Edycja</guimenu +> <guimenuitem +>Tryb zaznaczania bloku</guimenuitem +></menuchoice +> lub za pomocą skrótu klawiszowego: <keycombo action="simul" +>&Ctrl;&Shift;<keycap +>B</keycap +></keycombo +></para> + +</sect2> + +<sect2 id="kate-part-seleciton-overwrite"> + +<title +>Tryb zastępowania zaznaczenia</title> + +<para +>Włączenie trybu zastępowania zaznaczenia powoduje, iż wprowadzenie lub wklejenie tekstu przy istniejącym zaznaczeniu fragmentu dokumentu spowoduje zastąpienie tego fragmentu wprowadzanym znakiem lub wklejanym tekstem. Jeżeli tryb zastępowania zaznaczenia jest wyłączony to nowy tekst zostanie dodany w miejscu bieżącej pozycji kursora.</para> + +<para +>Tryb zastępowania zaznaczenia jest domyślnie włączony.</para> + +<para +>Zmiana tego ustawienia jest możliwa w karcie <link linkend="config-dialog-editor-cursor-selection" +>Kursor i zaznaczanie</link +> okna dialogowego <link linkend="config-dialog" +>Konfiguracja &kate;</link +>.</para> + +</sect2> + +<sect2 id="kate-part-selection-persistent"> + +<title +>Korzystanie z trwałego zaznaczenia</title> + +<para +>Przy włączonej opcji trwałego zaznaczenia operacje wpisywania znaków lub przemieszczania kursora nie powodują usunięcia zaznaczenia. Oznacza to, że można przesuwać kursor poza miejscem zaznaczenia, a także wprowadzać wewnątrz zaznaczenia nowy tekst, nie tracąc tego zaznaczenia.</para> + +<para +>Opcja trwałego zaznaczenia domyślnie jest wyłączona.</para> + +<para +>Zmiana trybu trwałego zaznaczenia możliwa jest w karcie <link linkend="config-dialog-editor-cursor-selection" +>Kursor i zaznaczanie</link +> okna dialogowego <link linkend="config-dialog" +>Konfiguracja &kate;</link +>.</para> + +<warning> +<para +>Jednoczesne włączenie trybu trwałego zaznaczenia i zastępowania zaznaczenia powoduje, iż wpisywanie lub wklejanie tekstu wewnątrz zaznaczonego fragmentu spowoduje, że zostanie on zastąpiony nowym tekstem, a zaznaczenie usunięte.</para> +</warning> + +</sect2> + +</sect1> + +<sect1 id="kate-part-copy-and-paste"> + +<title +>Kopiowanie i wklejanie tekstu</title> + +<para +>Aby skopiować fragment tekstu należy go wcześniej zaznaczyć, a następnie użyć menu <menuchoice +><guimenu +>Edycja</guimenu +> <guimenuitem +>Kopiuj</guimenuitem +></menuchoice +>. Niezależnie od tego polecenia, każde zaznaczenie fragmentu tekstu powoduje automatyczne skopiowanie go do schowka menedżera okien X.</para> + +<para +>Wklejenie tekstu ze schowka możliwe jest za pomocą polecenia menu <menuchoice +> <guimenu +>Edycja</guimenu +><guimenuitem +>Wklej</guimenuitem +></menuchoice +> .</para> + +<para +>Dodatkowo każdy fragment zaznaczony myszką może zostać wklejony w innym miejscu dokumentu za pomocą <mousebutton +>środkowego</mousebutton +> przycisku myszy.</para> + +<tip> +<para +>Środowisko &kde; umożliwia dostęp do wielu poprzednio kopiowanych fragmentów tekstu za pomocą narzędzia &klipper;, którego ikona widoczna jest na pasku &kicker-dopelniacz;.</para> +</tip> + +</sect1> + +<sect1 id="kate-part-find-replace"> +<title +>Wyszukiwanie i zamiana tekstu</title> + +<sect2 id="find-replace-dialog"> +<title +>Okna dialogowe <guilabel +>Znajdź ...</guilabel +> i <guilabel +>Zastąp ...</guilabel +></title> + + +<para +>Okna dialogowe dla wyszukiwania i zastępowania tekstu w programie &kate; są do siebie bardzo podobne. Jedyną różnicą jest to, iż w oknie zastępowania widoczne jest dodatkowe pole do wprowadzania tekstu zastępującego tekst znaleziony, a także kilka dodatkowych opcji.</para> + +<para +>Okna dialogowe zawierają następujące elementy:</para> + +<variablelist> + +<varlistentry> +<term +><guilabel +>Szukany tekst</guilabel +></term> +<listitem +><para +>Tutaj należy wprowadzić poszukiwany napis. Sposób wyszukiwania zależy od zaznaczenia opisanych poniżej opcji.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Wyrażenie regularne</guilabel +></term> +<listitem> +<para +>Jeśli ta opcja jest zaznaczona to wprowadzony w polu wyszukiwania napis jest interpretowany jako wyrażenie regularne. Po zaznaczeniu tej opcji uaktywni się przycisk graficznego narzędzia do tworzenia i edycji wyrażeń regularnych.</para> +<para +>Więcej informacji na ten temat znajduje się w sekcji: <link linkend="regular-expressions" +> Wyrażenia regularne</link +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Uwzględniaj wielkość liter</guilabel +></term> +<listitem> +<para +>Jeśli opcja zostanie wyłączona to operacja wyszukiwania nie będzie wrażliwa na wielkość liter.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Całe słowa</guilabel +></term> +<listitem> +<para +>Włączenie tej opcji spowoduje, iż program nie będzie wyszukiwał napisów stanowiących fragmenty innych dłuższych wyrazów.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Od kursora</guilabel +></term> +<listitem> +<para +>Jeśli wybrano tę opcję, to wyszukiwanie zacznie się od miejsca położenia kursora, w przeciwnym wypadku rozpocznie się od początku dokumentu.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Znajdź wstecz</guilabel +></term> +<listitem> +<para +>Jeśli opcja zostanie zaznaczona, to wyszukiwanie rozpocznie się począwszy od bieżącego miejsca położenia kursora, w kierunku początku dokumentu.</para> +</listitem> +</varlistentry> + +</variablelist> + +<para +>Okno dialogowe <guilabel +>Zastąp ... </guilabel +> zawiera kilka dodatkowych opcji:</para> + +<variablelist> + +<varlistentry> +<term +><guilabel +>Wstawiany tekst</guilabel +></term> +<listitem +><para +>W tym polu wprowadzić należy tekst zastępujący znaleziony napis.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Zaznaczony tekst</guilabel +></term> +<listitem> +<para +>Ta opcja jest nieaktywna jeśli brak jest zaznaczenia w bieżącym dokumencie lub opcja <guilabel +>Pytaj przy zamianie</guilabel +> jest włączona. Włączenie opcji powoduje, iż zamiana wyszukanego napisu na tekst zastępujący odbywać się będzie tylko w ramach zaznaczonego fragmentu tekstu.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Pytaj przy zamianie</guilabel +></term> +<listitem +><para +>Jeśli opcja zostanie włączona, to program, w przypadku znalezienia pasującego napisu, wyświetli okno zawierające następujące przyciski: <variablelist> + +<varlistentry> +<term +><guibutton +>Zastąp</guibutton +></term> +<listitem +><para +>Przycisk spowoduje zamianę znalezionego napisu (znaleziony napis jest podświetlony w oknie edycyjnym).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>Znajdź następny</guibutton +></term> +<listitem +><para +>Program pominie bieżący wynik wyszukiwania i będzie kontynuować wyszukiwanie.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>Zastąp wszystkie</guibutton +></term> +<listitem +><para +>Wyłącza wyświetlanie następnych pytań i zastępuje wszystkie pozostałe wystąpienia szukanego napisu w tekście.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>Zamknij</guibutton +></term> +<listitem +><para +>Pomija bieżący wynik wyszukiwania i kończy dalsze operacje.</para +></listitem> +</varlistentry> + +</variablelist> + +</para +></listitem> +</varlistentry> + +</variablelist> + +<note> +<para +>W chwili obecnej program &kate; nie pozwala na użycie parametru minimalnego dopasowania dla mechanizmu wyrażeń regularnych. Opcja ta zostanie dodana w następnej wersji programu.</para> +</note> + +</sect2> + +<sect2 id="finding-text"> +<title +>Wyszukiwanie tekstu</title> + +<para +>Aby wyszukać napis w bieżącym dokumencie należy oworzyć okno dialogowe <guilabel +>Znajdź tekst</guilabel +> za pomocą skrótu klawiszowego <keycombo action="simul" +>&Ctrl;<keycap +>F</keycap +></keycombo +> lub wybierając z menu polecenie <menuchoice +><guimenu +>Edycja</guimenu +> <guimenuitem +>Znajdź...</guimenuitem +></menuchoice +>. W odpowiednim polu tego okna należy wprowadzić poszukiwany napis, ustawić ewentualnie dodatkowe <link linkend="find-replace-dialog" +>opcje wyszukiwania</link +> zgodnie z wymaganiami, a następnie nacisnąć przycisk <guibutton +>Znajdź</guibutton +>. Jeżeli poszukiwany napis nie zostanie znaleziony pomiędzy bieżącą pozycją kursora, a końcem dokumentu to użytkownik zostanie zapytany o zgodę na kontynuację wyszukiwania od początku dokumentu (lub końca, jeśli została włączona opcja wyszukiwania wstecz). </para> + +<para +>Znaleziony napis zostaje zaznaczony, zaś okno dialogowe <guilabel +>Znajdź ...</guilabel +> zostaje ukryte. Wyszukiwanie następnych wystąpień tego samego tekstu jest jednak bardzo proste:</para> + +<para +>Aby znaleźć kolejne dopasowanie w bieżącym kierunku wyszukiwania, należy wybrać z menu<menuchoice +><guimenu +>Edycja</guimenu +> <guimenuitem +>Znajdź następne</guimenuitem +></menuchoice +> lub nacisnąć klawisz <keycap +>F3</keycap +>.</para> + +<para +>Aby wyszukać kolejne dopasowanie napisu w kierunku przeciwnym do bieżącego kierunku wyszukiwania należy wybrać z menu <menuchoice +><guimenu +>Edycja</guimenu +> <guimenuitem +>Znajdź Poprzedni</guimenuitem +></menuchoice +> lub nacisnąć klawisz <keycombo action="simul" +>&Shift;<keycap +>F3</keycap +></keycombo +>.</para> + +<para +>Jeśli proces wyszukiwanie osiągnie koniec (początek) dokumentu, to program zapyta się czy ma kontynuować szukanie od początku (końca) do bieżącej pozycji kursora. </para> + +</sect2> + +<sect2> +<title +>Zastępowanie tekstu</title> + +<para +>Zastępowanie tekstu odbywa się z pomocą okna dialogowego <guilabel +>Zastąp tekst</guilabel +> uruchamianego za pomocą menu <menuchoice +><guimenu +>Edycja</guimenu +> <guimenuitem +>Zastąp...</guimenuitem +></menuchoice +> lub za pomocą klawiszy <keycombo action="simul" +>&Ctrl;<keycap +>R</keycap +></keycombo +>. W wyświetlonym oknie dialogowym należy wprowadzić poszukiwany napis oraz tekst, który ma go zastąpić (jeżeli w polu tekst zastępujący nic nie będzie to każde znalezione wystąpienie tekstu poszukiwanego zostanie usunięte). Po zaznaczeniu dodatkowych <link linkend="find-replace-dialog" +>opcji wyszukiwania</link +> należy nacisnąć przycisk <guibutton +>Zastąp</guibutton +>.</para> + +<tip> +<para +>W przypadku korzystania z wyrażeń regularnych dla poszukiwania tekstu przy operacjach zastępowania można skorzystać z odwołań zwrotnych do przechwytywania dopasowanego tekstu i wykorzystywania go w napisie zastępującym.</para> +<para +>Więcej informacji na ten temat znajduje się w sekcji: <xref linkend="regular-expressions"/> .</para> +</tip> + +<tip +><para +>Dodatkowo możliwe jest wykorzystanie poleceń <command +>find</command +>, <command +>replace</command +> oraz <command +>ifind</command +> (wyszukiwanie przyrostowe) dostępnych w <link linkend="advanced-editing-tools-commandline" +>linii poleceń edytora</link +>.</para> +</tip> + +</sect2> + +</sect1> + +<sect1 id="kate-part-bookmarks"> +<title +>Korzystanie z zakładek</title> + +<para +>Mechanizm zakładek pozwala na oznaczenie wybranych fragmentów dokumentu w celu ich szybkiego wyszukiwania.</para> + +<para +>Zakładkę dla wiersza można zdefiniować na dwa sposoby:</para> + +<itemizedlist> +<listitem> +<para +>Po ustawieniu kursora w wybranym wierszu można wybrać z menu <menuchoice +><guimenu +>Zakładki</guimenu +><guimenuitem +>Ustaw zakładkę</guimenuitem +></menuchoice +> (<keycombo action="simul" +>&Ctrl;<keycap +>B</keycap +></keycombo +>).</para> +</listitem> +<listitem> +<para +>Można kliknąć na pasek ikon obok wybranego wiersza.</para> +</listitem> +</itemizedlist> + + +<para +>Zdefiniowane w dokumencie zakładki widoczne są w menu <guimenu +>Zakładki</guimenu +> jako pozycje menu, zawierające w swej treści numer wiersza i jego kilka początkowych słów. Wybranie zakładki z menu spowoduje przeniesienie kursora na początek oznaczonego przez tę zakładkę wiersza.</para> + +<para +>Można szybko przenosić kursor pomiędzy zakładkami odbywa się za pomocą poleceń menu <menuchoice +><guimenu +>Zakładki</guimenu +><guimenuitem +>Następna</guimenuitem +> </menuchoice +> (<keycombo action="simul" +><keycap +>Alt</keycap +> <keycap +>Page Down</keycap +></keycombo +>) lub <menuchoice +> <guimenu +>Zakładki</guimenu +><guimenuitem +>Poprzednia</guimenuitem +></menuchoice +> (<keycombo action="simul" +><keycap +>Alt</keycap +><keycap +>Page Up</keycap +> </keycombo +>).</para> + +</sect1> + +<sect1 id="kate-part-auto-wrap"> + +<title +>Automatyczne zawijanie wyrazów</title> + +<para +>Funkcja pozwala na formatowanie tekstu tak, iż wyrazy wykraczające poza zdefiniowaną dla wiersza maksymalną liczbę znaków, zostają automatycznie przeniesione do następnego wiersza, chyba że w wierszu tym zapisany jest dłuższy napis nie zawierający spacji i innych tzw. białych znaków.</para> + +<para +>Włączenie/wyłączenie tej opcji możliwe jest w karcie <link linkend="config-dialog-editor-edit" +>Edycja</link +> w oknie dialogowym <link linkend="config-dialog" +>Konfiguracji</link +>.</para> + +<para +>Aby ustawić liczbę znaków w wierszu po których następuje zawijanie wyrazów, należy skorzystać z opcji <link linkend="config-dialog-editor-wrap-words-at" +><guibutton +>Zawijaj wyrazy na...</guibutton +></link +> dostępnej w karcie <link linkend="config-dialog-editor-edit" +>Edycja</link +> okna dialogowego <link linkend="config-dialog" +>Konfiguracja</link +>.</para> + +<para +>Efekty działania tej funkcji są następujące: <itemizedlist> +<listitem +><para +>W trakcie pisania edytor automatycznie wstawi znak przeniesienia do następnego wiersza po ostatniej spacji poprzedzającej wyraz, który spowodował przekroczenie maksymalnej liczby znaków w wierszu.</para +></listitem> +<listitem +><para +>Podczas wczytywania dokumentu program zawinie wyrazy w taki sam sposób, aby wiersze dokumentu nie przekraczały zdefiniowanej liczby znaków (przy założeniu, że zawierają spacje pozwalające na przeniesienie całego wyrazu).</para +></listitem> +</itemizedlist> + +</para> + +<note +><para +>Obecna wersja programu nie pozwala na odmienne ustawienie działania funkcji zawijania wyrazów dla różnych typów dokumentów lub dla poszczególnych otwartych plików. Zostanie to poprawione w następnych wersjach programu &kate;.</para +></note> + +</sect1> + +<sect1 id="kate-part-autoindent"> +<title +>Korzystanie z funkcji automatycznych wcięć</title> + +<para +>Program &kate; umożliwia stosowanie różnorodnych trybów automatycznego generowania wcięć w tekście, przystosowanych dla różnych rodzajów dokumentów. Użytkownik może wybrać tryb generowania wcięć w menu: <menuchoice +><guimenu +>Narzędzia</guimenu +><guisubmenu +>Wcięcia</guisubmenu +></menuchoice +>. Uzupełnieniem funkcji automatycznych wcięć jest polecenie <menuchoice +><guimenu +>Narzędzia</guimenu +><guimenuitem +>Wyrównaj</guimenuitem +></menuchoice +>, które powoduje regenerację wielkości wcięć dla zaznaczonego fragmentu lub bieżącego wiersza. Można zastosować to polecenie dla całego dokumentu zaznaczając cały tekst przed jego uruchomieniem.</para> + +<para +>Wszystkie tryby automatycznych wcięć wykorzystują ustawienia konfiguracyjne dla bieżącego dokumentu.</para> + +<tip +><para +>Użytkownik może określić różnorodne parametry konfiguracyjne związane z wcięciami za pomocą <link linkend="config-variables" +>zmiennych konfiguracyjnych pliku</link +> oraz <link linkend="config-dialog-editor-filetypes" +>typów pliku</link +>.</para +></tip> + +<variablelist> + +<title +>Dostępne tryby pracy automatycznych wcięć</title> + +<varlistentry> +<term +>Brak</term> +<listitem +><para +>Wyłącza funkcję automatycznych wcięć.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Normalny</term> +<listitem +><para +>W tym trybie generowania wcięć program stara się utrzymać wcięcie na poziomie podobnym do wcięcia w poprzednim wierszu. Ten tryb może być używany z poleceniami "wcięcie" i "usuń wcięcie" dla samodzielnego ustalania poziomów wcięć w dokumencie. </para +></listitem> +</varlistentry> + +<varlistentry +><term +>Styl C</term> +<listitem +><para +>Moduł generowania wcięć dla języka C, C++, C#, java, javascript i innych podobnych. Ten moduł nie będzie dobrze działać dla języków skryptowych takich jak Perl czy PHP.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Styl SS & C</term> +<listitem +><para +>Alternatywny moduł generowania wcięć dla języków programowania z rodziny C.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Styl Python</term> +<listitem +><para +>Moduł generowania automatycznych wcięć dostosowany do języka Python. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +>XML</term> +<listitem +><para +>Moduł automatycznego generowania wcięć dla dokumentów w standardzie XML. Nie należy go używać dla dokumentów HTML, ponieważ nie będzie sobie radził z otwartymi znacznikami (takimi jak np.: <br>))</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Program wcinający na podstawie zmiennych</term> +<listitem> + +<note> +<para +>Funkcja generowania wcięć na podstawie zmiennych ma charakter eksperymentalny. Jej działanie może się zmienić, może też zostać usunięta w przyszłych wersjach programu.</para> +</note> + +<para +>Program wcinający na podstawie zmiennych jest konfigurowany za pomocą zmiennych zapisanych w edytowanym pliku lub w definicji typu pliku. Dostępne są następujące zmienne: <variablelist> +<varlistentry> +<term +>var-indent-indent-after</term> +<listitem> +<para +>Wyrażenie regularne powodujące, iż wcięcie wiersza zwiększy się o jednostkę jeżeli pierwszy znak wiersza nie będący znakiem białym pasuje do wyrażenia. var-indent-indent: Wyrażenie regularne, które powoduje wcięcie pasującego wiersza o jedną jednostkę.</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>var-indent-unindent</term> +<listitem> +<para +>Wyrażenie regularne, które powoduje zmniejszenie wcięcia o jednostkę w przypadku spełnienia warunku.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>var-indent-triggerchars</term> +<listitem> +<para +>Lista znaków, których wprowadzenie spowoduje ponowne przeliczenie wielkości wcięcia.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>var-indent-handle-couples</term> +<listitem> +<para +>Lista zestawów nawiasów generujących wcięcie. Może to być dowolna kombinacja nawiasów zwykłych, klamrowych i kwadratowych. Każdy para nawiasów traktowana jest następująco: jeżeli w dokumencie znajdują się niedopasowane nawiasy otwierające to wcięcie zwiększy się o jednostkę. Jeżeli zaś występują niedopasowane nawiasy zamykające w bieżącym wierszu to wcięcie zmniejszy się o jednostkę.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><literal +>var-indent-couple-attribute</literal +></term> +<listitem> +<para +>Atrybut znaków rozpoznawanych podczas operacji poszukiwania pasujących do siebie par znaków otwarcia i zamknięcia. Wartością zmiennej jest nazwa atrybutu z pliku XML definiującego reguły podświetlania składni (np. "Symbol"). Wartością domyślną jest 0 (co oznacza z reguły styl "zwykłego tekstu").</para> +</listitem> +</varlistentry> + +</variablelist> + +</para +></listitem> +</varlistentry> + +</variablelist> + +</sect1> + +</chapter> diff --git a/tde-i18n-pl/docs/tdebase/kate/plugins.docbook b/tde-i18n-pl/docs/tdebase/kate/plugins.docbook new file mode 100644 index 00000000000..25c9ce0c15c --- /dev/null +++ b/tde-i18n-pl/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 +>Krzysztof</firstname +><surname +>Woźniak</surname +><affiliation +><address +><email +>wozniakk@ceti.pl</email +></address +></affiliation +><contrib +>Polskie Tłumaczenie</contrib +></othercredit +> +</authorgroup> +</chapterinfo> + +<title +>Korzystanie z wtyczek</title> + +<para +>W programie &kate; dostępne są dwa rodzaje wtyczek: wtyczki programu &kate; oraz wtyczki dla komponentu edytora. Druga grupa wtyczek dostępna jest dla wszystkich programów korzystających z komponentu edytora, takich jak np. KDevelop, Quanta, Kile, Kwrite i wiele innych. Pierwsza grupa zaś jest dostępna tylko w programie &kate;.</para> + +<para +>Włączenie obu rodzajów wtyczek odbywa się w <link linkend="configuring-kate-configdialog" +>w oknie dialogowym konfiguracji</link +>, w którym można ustawić również dodatkowe parametry konfiguracyjne dla wtyczek tego wymagających.</para> + +<para +>Wtyczki realizujące wiele różnych funkcji dostępne są w pakiecie tdeaddons oraz w innych miejscach w sieci WWW. Kilka wtyczek dostarczanych jest wraz z komponentem edytora i są to wtyczki: dopełniania słów, obsługi zakładek, wstawiania plików, szukania przyrostowego, sprawdzania pisowni i słownika wyrazów bliskoznacznych.</para> + +</chapter> diff --git a/tde-i18n-pl/docs/tdebase/kate/regular-expressions.docbook b/tde-i18n-pl/docs/tdebase/kate/regular-expressions.docbook new file mode 100644 index 00000000000..13cf44739ab --- /dev/null +++ b/tde-i18n-pl/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 +>Krzysztof</firstname +><surname +>Woźniak</surname +><affiliation +><address +><email +>wozniakk@ceti.pl</email +></address +></affiliation +><contrib +>Polskie tłumaczenie</contrib +></othercredit +> +</authorgroup> +</appendixinfo> + +<title +>Wyrażenia regularne</title> + +<synopsis +>Dodatek niniejszy zawiera krótkie, ale obejmujące większość zagadnień wprowadzenie do tajemniczego świata <emphasis +>wyrażeń regularnych</emphasis +>. Dokumentacja oparta jest na formacie wyrażeń regularnych stosowanych przez &kate;, która nie jest w pełni kompatybilna z wyrażeniami z języka perl lub polecenia <command +>grep</command +>.</synopsis> + +<sect1> + +<title +>Wprowadzenie</title> + +<para +><emphasis +>Wyrażenia regularne</emphasis +> pozwalają na takie określenie możliwej zawartości przeszukiwanego tekstu, iż stosunkowo prosty program może określić, czy dany fragment pasuje, czy też nie, do poszukiwanego wzorca. Bardziej zaawansowane zastosowania wyrażeń regularnych pozwalają na przechowywanie i późniejsze wykorzystanie dopasowanych wzorców.</para> + +<para +>Przykładowo, załóżmy, że chcemy znaleźć wszystkie zdania w tekście, rozpoczynające się od słów: <quote +>Henrik</quote +> lub <quote +>Pernille</quote +>, po których następuje czasownik <quote +>say</quote +>.</para> + +<para +>Wykorzystując tradycyjny mechanizm wyszukiwania należałoby zacząć od znalezienia napisu <quote +>Henrik</quote +> z następującym po nim fragmentem <quote +>sa</quote +> czyli np: <userinput +>Henrik sa</userinput +>. Przeglądając znalezione teksty należałoby odrzucić te nie będące początkiem zdania oraz te, gdzie napis <quote +>sa</quote +> nie jest początkiem słów <quote +>says</quote +>, <quote +>said</quote +> itd. Następnie trzeba oczywiście powtórzyć te działania dla kolejnego nazwiska...</para> + +<para +>Za pomocą wyrażeń regularnych zadanie to może być wykonane za pomocą jednej operacji szukania i z dużo większą precyzją.</para> + +<para +>W wyrażeniu regularnym definiowane są reguły generalizujące poszukiwany fragment tekstu. W podanym przykładzie pożądany rezultat szukania można słownie opisać tak: <quote +>Wyszukaj wiersz rozpoczynający się albo od słowa <quote +>Henrik</quote +> albo <quote +>Pernille</quote +> (przed którym występuje do 4 spacji lub znaków tabulacji), i następujący po nim tekst <quote +>sa</quote +> z końcówkami <quote +>ys</quote +> lub <quote +>id</quote +></quote +>. Można to osiągnąć za pomocą następującego wyrażenia regularnego:</para +> <para +><userinput +>^[ \t]{0,4}(Henrik|Pernille) sa(ys|id)</userinput +></para> + +<para +>Powyższy przykład przedstawia cztery główne mechanizmy współczesnych wyrażeń regularnych:</para> + +<itemizedlist> +<listitem +><para +>Wzorce</para +></listitem> +<listitem +><para +>Zakotwiczenia</para +></listitem> +<listitem +><para +>Kwantyfikatory</para +></listitem> +<listitem +><para +>Odwołania zwrotne</para +></listitem> +</itemizedlist> + +<para +>Znak karetki (<literal +>^</literal +>), rozpoczynający wyrażenie jest zakotwiczeniem oznaczającym, iż dopasowanie będzie możliwe tylko wtedy, jeżeli podany wzorzec znajdzie się na początku wiersza.</para> + +<para +>Napisy <literal +>[ \t]</literal +> oraz <literal +>(Henrik|Pernille) sa(ys|id)</literal +> to tzw. wzorce. Pierwszy określa <emphasis +>klasę znaków</emphasis +>, która będzie dopasowana do spacji lub tabulatora, drugi zawiera wzorzec składający się z podwzorca pasującego do napisu <literal +>Henrik</literal +> <emphasis +>albo</emphasis +> <literal +>Pernille</literal +>. Następnie poszukiwany jest fragment <literal +> sa</literal +>, a potem podwzorzec pasujący do napisów <literal +>ys</literal +> <emphasis +> lub </emphasis +> <literal +>id</literal +>.</para> + +<para +>Zapis <literal +>{0,4}</literal +> jest kwantyfikatorem oznaczającym, iż dopasowane zostaną <quote +>co najmniej 0 lecz nie więcej niż 4 wystąpienia określonego wzorca</quote +>.</para> + +<para +>Ponieważ oprogramowanie obsługi wyrażeń regularnych zawiera mechanizm <emphasis +>odwołań zwrotnych</emphasis +>, możliwe jest zachowanie całego dopasowanego fragmentu tekstu (określonego jako podwzorzec w nawiasach okrągłych), a następnie wykorzystanie tego fragmentu w dalszej części wyrażenia (w podanym przykładzie może to być dopasowane nazwisko lub ostatnia część czasownika).</para> + +<para +>Podsumowując, wprowadzone wyrażenie regularne będzie pasować do tekstu tam, i tylko tam, gdzie użytkownik tego wymaga.</para> + +<para +>Poniższe sekcje zawierają szczegółowe informacje o wykorzystaniu wzorców, klas znaków, zakotwiczeń, kwantyfikatorów i odwołań zwrotnych. W ostatniej części przedstawiono kilka pożytecznych przykładów wykorzystania wyrażeń regularnych.</para> + +</sect1> + +<sect1 id="regex-patterns"> + +<title +>Wzorce</title> + +<para +>Wzorce mogą się składać ze znaków i klas znaków. Wzorce mogą zawierać podwzorce, czyli wzorce zamknięte w nawiasach okrągłych.</para> + +<sect2> +<title +>Sekwencje specjalne</title> + +<para +>W definicji zarówno wzorców, jak i klas znaków, niektóre znaki mają specjalne znaczenie. Aby wyszukać te znaki w tekście, muszą być zapisane w postaci <emphasis +>sekwencji specjalnej</emphasis +>, tak aby program obsługi wyrażeń regularnych interpretował je jako znaki tekstu, a nie znaki sterujące procesem wyszukiwania.</para> + +<para +>Aby tego dokonać należy poprzedzić znak specjalny znakiem odwrotnego ukośnika (<literal +>\</literal +>).</para> + + +<para +>Program obsługujący wyrażenia regularne pozwala zapisywać każdy znak w postaci sekwencji specjalnej, nawet taki, który nie ma żadnego specjalnego znaczenia. Na przykład zapisanie litery <quote +>j</quote +> w postaci sekwencji <userinput +>\j</userinput +> jest całkowicie poprawne i oznacza literę <quote +>j</quote +>. Jeżeli więc użytkownik nie jest pewny czy dany znak ma znaczenie specjalne czy też nie, to może go dla bezpieczeństwa zapisać w postaci sekwencji specjalnej.</para> + +<para +>Istnieje oczywiście również sekwencja specjalna dla określenia znaku odwrotnego ukośnika i jest to: <userinput +>\\</userinput +>.</para> + +</sect2> + +<sect2> +<title +>Skróty i klasy znaków</title> + +<para +><emphasis +>Klasa znaków</emphasis +> to wyrażenie pasujące do jednego znaku wybranego z określonego zbioru znaków. W wyrażeniach regularnych klasy znaków są definiowane poprzez podanie zbioru znaków wewnątrz nawiasów kwadratowych <literal +>[]</literal +> lub poprzez użycie jednego ze skrótowych predefiniowanych klas znaków opisanych poniżej.</para> + +<para +>Proste klasy znaków zawierają listę znaków np.: <userinput +>[abc]</userinput +> (klasa pasuje do każdej z liter: <quote +>a</quote +>, <quote +>b</quote +> lub <quote +>c</quote +>) albo <userinput +>[0123456789]</userinput +> (klasa znaków pasująca do dowolnej cyfry).</para> + +<para +>Ponieważ litery i cyfry można ustawić w logicznym porządku, to możliwe jest zapisanie klas znaków w postaci zakresów znaków np.: <userinput +>[a-c]</userinput +> jest równoważne zapisowi <userinput +>[abc]</userinput +>, zaś <userinput +>[0-9]</userinput +> jest tożsame z zapisem <userinput +>[0123456789]</userinput +>. Dopuszczalne są różne kombinacje zakresów w definicji klas znaków np. <userinput +>[a-fynot1-38]</userinput +> jest całkowicie poprawne, i będzie pasować do jednego następujących znaków: <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 +> lub <quote +>8</quote +>).</para> + +<para +>Duże litery i małe litery są różnymi znakami dla oprogramowania obsługi wyrażeń regularnych, aby więc określić wzorzec nie uwzględniający wielkości liter: <quote +>a</quote +> lub <quote +>b</quote +> należy zapisać go następująco: <userinput +>[aAbB]</userinput +>.</para> + +<para +>Możliwe jest zastosowanie <quote +>negacji</quote +> klasy znaków, która oznacza dopasowanie do <quote +>wszystkich znaków oprócz</quote +> tych określonych w klasie. Negacji klasy dokonuje się za pomocą znaku (<literal +>^</literal +>), który musi stanowić pierwszy znak jej definicji: </para> + +<para +><userinput +>[^abc]</userinput +> pasuje do każdego znaku <emphasis +>z wyjątkiem liter </emphasis +>:<quote +>a</quote +>, <quote +>b</quote +> lub <quote +>c</quote +>.</para> + +<para +>Oprócz znaków alfabetu zdefiniowane zostały skróty dla pewnych znaków specjalnych oraz najczęściej używanych klas znaków: <variablelist> + +<varlistentry> +<term +><userinput +>\a</userinput +></term> +<listitem +><para +>Pasuje do znaku <acronym +>ASCII</acronym +> dzwonka (BEL, 0x07).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\f</userinput +></term> +<listitem +><para +>Pasuje do znaku <acronym +>ASCII</acronym +> form feed (FF, 0x0C).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\n</userinput +></term> +<listitem +><para +>Pasuje do znaku <acronym +>ASCII</acronym +> line feed (LF, 0x0A, nowy wiersz w systemach UNIX).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\r</userinput +></term> +<listitem +><para +>Pasuje do znaku <acronym +>ASCII</acronym +> carriage return (CR, 0x0D).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\t</userinput +></term> +<listitem +><para +>Pasuje do znaku <acronym +>ASCII</acronym +> - tabulacja pozioma (HT, 0x09).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\v</userinput +></term> +<listitem +><para +>Pasuje do znaku <acronym +>ASCII</acronym +> tabulacja pionowa (VT, 0x0B).</para +></listitem> +</varlistentry> +<varlistentry> +<term +><userinput +>\xhhhh</userinput +></term> + +<listitem +><para +>Pasuje do znaku Unicode o numerze "hhhh" zapisanym w formacie szesnastkowym (w zakresie od 0x0000 do 0xFFFF). \0ooo (tzn.: \zero ooo) pasuje do znaku <acronym +>ASCII</acronym +>/Latin-1 o kodzie "ooo" w systemie ósemkowym (z zakresu od 0 do 0377).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>.</userinput +> (kropka)</term> +<listitem +><para +>Pasuje do każdego znaku (także do znaku końca wiersza).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\d</userinput +></term> +<listitem +><para +>Pasuje do cyfry, co jest tożsame z zapisem: <literal +>[0-9]</literal +></para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\D</userinput +></term> +<listitem +><para +>Pasuje do znaku nie będącego cyfrą, co jest równoważne zapisom: <literal +>[^0-9]</literal +> lub <literal +>[^\d]</literal +></para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\s</userinput +></term> +<listitem +><para +>Pasuje do znaku spacji lub innego tzw. białego znaku. Tożsame z: <literal +>[ \t\n\r]</literal +></para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\S</userinput +></term> +<listitem +><para +>Dopasowuje znak nie będący spacją lub innym tzw. białym znakiem. Tożsame z: <literal +>[^ \t\n\r]</literal +> lub <literal +>[^\s]</literal +></para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\w</userinput +></term> +<listitem +><para +>Pasuje do dowolnego <quote +>elementu słowa</quote +> - tzn. do dowolnej litery lub cyfry. Należy zwrócić uwagę, iż znak podkreślenia (<literal +>_</literal +>) nie zostanie dopasowany (co dzieje się np. w wyrażeniach regularnych Perl-a). Zapis ten równoważny jest klasie znaków: <literal +>[a-zA-Z0-9]</literal +></para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\W</userinput +></term> +<listitem +><para +>Pasuje do wszystkich znaków nie będących literami bądź cyframi, co jest równoważne wyrażeniom <literal +>[^a-zA-Z0-9]</literal +> lub <literal +>[^\w]</literal +></para +></listitem> +</varlistentry> + + +</variablelist> + +</para> + +<para +>Skróty można wykorzystywać we własnych definicjach klas np. aby dopasować znak alfabetu, spację oraz kropkę można użyć wyrażenia: <userinput +>[\w \.]</userinput +></para +> + +<note +> <para +>Zapis klas znaków w notacji POSIX <userinput +>[:<class name>:]</userinput +> nie jest obecnie obsługiwany przez &kate;.</para +> </note> + +<sect3> +<title +>Znaki o specjalnym znaczeniu dla klas znaków</title> + +<para +>Następujące znaki mają specjalne znaczenie wewnątrz definicji klasy znaków <quote +>[]</quote +>. Muszą one być zapisane w postaci sekwencji specjalnej, jeżeli użytkownik chce je umieścić jako element klasy:</para> + +<variablelist> +<varlistentry> +<term +><userinput +>]</userinput +></term> +<listitem +><para +>Znak kończący definicję klasy znaków. Musi być zapisany w postaci sekwencji specjalnej, jeżeli nie jest pierwszym znakiem klasy (może nastąpić po daszku ^ tzn. negacji klasy).</para +></listitem> +</varlistentry> +<varlistentry> +<term +><userinput +>^</userinput +> (daszek)</term> +<listitem +><para +>Oznacza negację klasy w przypadku, jeżeli jest na pierwszym miejscu jej definicji. Musi być zapisany w postaci sekwencji specjalnej w przypadku występowania jako pierwszy znak klasy.</para +></listitem +> +</varlistentry> +<varlistentry> +<term +><userinput +>-</userinput +> (minus)</term> +<listitem +><para +>Oznacza zakres znaków w klasie. Zawsze musi być zapisany w postaci sekwencji specjalnej.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><userinput +>\</userinput +> (odwrotny ukośnik)</term> +<listitem +><para +>Występuje tylko pod postacią sekwencji specjalnej.</para +></listitem> +</varlistentry> + +</variablelist> + +</sect3> + +</sect2> + +<sect2> + +<title +>Alternatywa, czyli dopasowanie <quote +>jednego z kilku</quote +> wzorców</title> + +<para +>Jeżeli konieczne jest dopasowanie wyrażenia do jednego ze zbioru kilku alternatywnych wzorców, to należy je zapisać rozdzielając znakiem <literal +>|</literal +> (pionowej kreski).</para> + +<para +>Na przykład w celu odszukania w tekście słów <quote +>John</quote +> lub <quote +>Harry</quote +> należy użyć wyrażenia <userinput +>John|Harry</userinput +>.</para> + +</sect2> + +<sect2> + +<title +>Podwzorce</title> + +<para +><emphasis +>Podwzorce</emphasis +>, czyli wzorce zamknięte w nawiasach okrągłych, wykorzystywane są w wielu sytuacjach przy tworzeniu wyrażeń regularnych.</para> + +<sect3> + +<title +>Definiowanie alternatyw</title> + +<para +>Można skorzystać z podwzorców do grupowania zbioru wzorców alternatywnych, składających się na inny wzorzec. Wzorce alternatywne rozdzielane są znakiem <quote +>|</quote +> (pionowej kreski).</para> + +<para +>Na przykład aby wyszukać jeden z trzech wyrazów: <quote +>int</quote +>, <quote +>float</quote +> lub <quote +>double</quote +> można użyć wzorca <userinput +>int|float|double</userinput +>. Jeżeli dodatkowo po każdym z tych wyrazów ma występować spacja i pewna liczba innych znaków to należy to wyrażenie zapisać jako podwzorzec w nawiasach okrągłych: <userinput +>(int|float|double)\s+\w+</userinput +>.</para> + +</sect3> + +<sect3> + +<title +>Przechwytywanie dopasowanego tekstu (odwołania zwrotne)</title> + +<para +>Wykorzystanie odwołań zwrotnych wymaga użycia podwzorca dla określenia części wzorca, którą system wyrażeń regularnych powinien przechwycić.</para> + +<para +>Przykładowo, jeżeli poszukiwane są dwa następujące po przecinku (i ew. spacji) powtórzenia tego samego słowa, to wyrażenie będzie miało postać <userinput +>(\w+),\s*\1</userinput +>. Podwzorzec <literal +>\w+</literal +> pasuje do zbitki liter lub cyfr zaś całe wyrażenie będzie dopasowane, jeżeli po tym podwzorcu wystąpi przecinek (spacja - 0 lub więcej), a następnie identyczna zbitka liter lub cyfr (zapis <literal +>\1</literal +> odwołuje się do przechwyconego <emphasis +>pierwszego zapisanego w nawiasach podwzorca wyrażenia</emphasis +>).</para> + +<!-- <para +>See also <link linkend="backreferences" +>Back references</link +>.</para +> --> + +</sect3> + +<sect3 id="lookahead-assertions"> +<title +>Zakotwiczenia w przód</title> + +<para +>Zakotwiczenie w przód to podwzorzec rozpoczynający się od znaków <literal +>?=</literal +> lub <literal +>?!</literal +>.</para> + +<para +>Na przykład, aby dopasować napis <quote +>Bill</quote +>, ale tylko wtedy, gdy nie następuje po nim napis <quote +> Gates</quote +>, można użyć wyrażenia: <userinput +>Bill(?! Gates)</userinput +>. Pasuje ono do napisów <quote +>Bill Clinton</quote +> oraz <quote +>Billy the kid</quote +>, ale ignoruje inne wystąpienia.</para> + +<para +>Podwzorce wykorzystane przy zakotwiczeniach nie są przechwytywane.</para> + +<para +>Więcej informacji w sekcji <link linkend="assertions" +>Zakotwiczenia</link +></para> + +</sect3> + +</sect2> + +<sect2 id="special-characters-in-patterns"> +<title +>Znaki specjalnego znaczenia wewnątrz wzorców</title> + +<para +>Następujące znaki mają specjalne znaczenie wewnątrz definicji wzorca. Muszą one być zapisane w postaci sekwencji specjalnej w przypadku ich wyszukiwania w tekście: <variablelist> + +<varlistentry> +<term +><userinput +>\</userinput +> (odwrotny ukośnik)</term> +<listitem +><para +>Odwrotny ukośnik.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>^</userinput +> (daszek)</term> +<listitem +><para +>Zakotwiczenie do początku tekstu.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>$</userinput +></term> +<listitem +><para +>Zakotwiczenie do końca tekstu.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>()</userinput +> (lewy i prawy nawias)</term> +<listitem +><para +>Oznaczenie podwzorca.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>{}</userinput +> (lewy i prawy nawias klamrowy)</term> +<listitem +><para +>Oznaczenie kwantyfikatora.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>[]</userinput +> (lewy i prawy nawias kwadratowy)</term> +<listitem +><para +>Oznaczenie klasy znaków.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>|</userinput +> (pionowa kreska)</term> +<listitem +><para +>Logiczne LUB. Rozdziela wzorce alternatywne.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>+</userinput +> (znak plusa)</term> +<listitem +><para +>Kwantyfikator, oznacza: "1 lub więcej" wystąpień.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>*</userinput +> (gwiazdka)</term> +<listitem +><para +>Kwantyfikator, oznacza: "0 lub więcej" wystąpień.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>?</userinput +> (znak zapytania)</term> +<listitem +><para +>Oznacza opcjonalność wzorca. Może być interpretowany jako kwantyfikator: 0 lub 1.</para +></listitem> +</varlistentry> + +</variablelist> + +</para> + +</sect2> + +</sect1> + +<sect1 id="quantifiers"> +<title +>Kwantyfikatory</title> + +<para +><emphasis +>Kwantyfikatory</emphasis +> umożliwiają definiowanie wyrażeń regularnych, które dopasowują się do określonej liczby (zakresu) znaków, wzorców lub klas znaków.</para> + +<para +>Kwantyfikatory zapisywane są w nawiasach klamrowych (<literal +>{</literal +> oraz <literal +>}</literal +>) i mają postać: <literal +>{[minimalna liczba wystąpień][,[maksymalna liczba wystąpień]]}</literal +> </para> + +<para +>Wykorzystanie kwantyfikatorów zaprezentowano w poniższych przykładach: <variablelist> + +<varlistentry> +<term +><userinput +>{1}</userinput +></term> +<listitem +><para +>Dokładnie jedno wystąpienie</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>{0,1}</userinput +></term> +<listitem +><para +>Brak wystąpienia lub jedno wystąpienie</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>{,1}</userinput +></term> +<listitem +><para +>To co powyżej ale mniej pisania ;-)</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>{5,10}</userinput +></term> +<listitem +><para +>Co najmniej 5, ale nie więcej niż 10 wystąpień.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>{5,}</userinput +></term> +<listitem +><para +>Co najmniej 5 wystąpień (brak górnego ograniczenia).</para +></listitem> +</varlistentry> + +</variablelist> + +</para> + +<para +>Dodatkowo możliwe jest wykorzystanie kilku skrótów: <variablelist> + +<varlistentry> +<term +><userinput +>*</userinput +> (gwiazdka)</term> +<listitem +><para +>podobnie jak <literal +>{0,}</literal +>, wyszukuje dowolną liczbę wystąpień.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>+</userinput +> (znak plusa)</term> +<listitem +><para +>podobnie jak <literal +>{1,}</literal +>, wyszukuje co najmniej jedno wystąpienie.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>?</userinput +> (znak zapytania)</term> +<listitem +><para +>podobnie jak <literal +>{0,1}</literal +>, dopasowuje brak lub dokładnie jedno wystąpienie.</para +></listitem> +</varlistentry> + +</variablelist> + +</para> + +<sect2> + +<title +>Zachłanność</title> + +<para +>Jeżeli kwantyfikatory nie mają określonej maksymalnej liczby wystąpień, to wyrażenie jest dopasowywane do maksymalnej możliwej liczby wyszukiwanych wzorców. Zachowanie takie nazywane jest <emphasis +>zachłannością</emphasis +> kwantyfikatorów.</para> + +<para +>Współczesne oprogramowanie obsługujące wyrażenia regularne pozwala na <quote +>wyłączenie zachłanności</quote +>. W środowisku graficznym możliwość ta może być dostępna albo nie. Przykładowo, w oknie wyszukiwania pozwalającym na użycie wyrażeń regularnych, może znaleźć się pole wyboru o nazwie: <quote +>Minimalne dopasowanie</quote +>. Powinna też znaleźć się tam informacja, iż zachłanność jest zachowaniem domyślnym dla wyrażeń regularnych.</para> + +</sect2> + +<sect2> +<title +>Przykłady</title> + +<para +>Poniżej znajduje się kilka przykładów użycia kwantyfikatorów</para> + +<variablelist> + +<varlistentry> +<term +><userinput +>^\d{4,5}\s</userinput +></term> +<listitem +><para +>Pasuje do cyfr napisu <quote +>1234 go</quote +> oraz <quote +>12345 now</quote +> ale nie pasuje do napisów <quote +>567 eleven</quote +> albo <quote +>223459 somewhere</quote +></para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\s+</userinput +></term> +<listitem +><para +>Pasuje do jednej lub więcej spacji lub innych tzw. białych znaków</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>(bla){1,}</userinput +></term> +<listitem +><para +>Pasuje do wszystkich <quote +>blablabla</quote +> oraz <quote +>bla</quote +> w słowach <quote +>blackbird</quote +> lub <quote +>tabla</quote +></para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>/?></userinput +></term> +<listitem +><para +>Pasuje do <quote +>/></quote +> w <quote +><closeditem/></quote +> jak również do <quote +>></quote +> w <quote +><openitem></quote +>.</para +></listitem> +</varlistentry> + +</variablelist> + +</sect2> + +</sect1> + +<sect1 id="assertions"> +<title +>Zakotwiczenia</title> + +<para +><emphasis +>Zakotwiczenia</emphasis +> pozwalają dopasowywać wzorce wyrażenia regularnego tylko wtedy, gdy spełnione są określone warunki.</para> + +<para +>Zakotwiczenie nie musi określać żadnego znaku do dopasowania. Bada ono raczej otoczenie potencjalnego dopasowania przed jego zatwierdzeniem. Na przykład zakotwiczenie <emphasis +>granica słowa</emphasis +> nie działa na zasadzie wyszukiwania znaków nie pasujących do słowa, ale zamiast tego sprawdza, czy kolejny znak nie jest znakim składającym się na słowo. Oznacza to, iż zakotwiczenie może zostać dopasowane tam, gdzie nie ma żadnego znaku (np. na końcu przeszukiwanego napisu).</para> + +<para +>Część zakotwiczeń właściwie nie posiada wzorca dopasowania, lecz zamiast tego wskazują część napisu nie stanowiącą rezultatu dopasowania całego wyrażenia.</para> + +<para +>Wyrażenia regularne opisane w tej dokumentacji pozwalają na użycie następujących zakotwiczeń: <variablelist> + +<varlistentry +> +<term +><userinput +>^</userinput +> (daszek: początek tekstu)</term +> +<listitem +><para +>Określa początek przeszukiwanego tekstu.</para +> <para +>Wyrażenie <userinput +>^Peter</userinput +> spowoduje dopasowanie wzorca <quote +>Peter</quote +> dla tekstu <quote +>Peter, hey!</quote +> ale już nie dla tekstu: <quote +>Hey, Peter!</quote +> </para +> </listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>$</userinput +> (koniec tekstu)</term> +<listitem +><para +>Określa koniec przeszukiwanego tekstu.</para> + +<para +>Wyrażenie <userinput +>you\?$</userinput +> będzie dopasowane do ostatniego "you" w tekście <quote +>You didn't do that, did you?</quote +>, ale już nie dla tekstu: <quote +>You didn't do that, right?</quote +></para> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\b</userinput +> (granica słowa)</term> +<listitem +><para +>Określa sytuację gdy po jednej stronie jest element słowa, a po drugiej inny znak (nie będący elementem słowa).</para> +<para +>Funkcja przydatna do wykrywania końca słów. Jej użycie po dwóch stronach wzorca spowoduje dopasowanie tylko całych wyrazów. Wyrażenie <userinput +>\bin\b</userinput +> będzie dopasowane do <quote +>in</quote +> w tekście <quote +>He came in through the window</quote +>, ale nie do napisu <quote +>in</quote +> w słowie <quote +>window</quote +>.</para +></listitem> + +</varlistentry> + +<varlistentry> +<term +><userinput +>\B</userinput +> (przeciwieństwo granicy słowa)</term> +<listitem +><para +>Dopasowuje wzorzec wszędzie tam, gdzie <quote +>\b</quote +> nie spowoduje dopasowania.</para> +<para +>Oznacza to, iż będą wyszukiwane wzorce znajdujące się np. wewnątrz dłuższych wyrazów. Wyrażenie <userinput +>\Bin\B</userinput +> będzie dopasowane do "in" w słowie <quote +>window</quote +>, ale już nie do "in" w wyrazie <quote +>integer</quote +>, czy też napisie <quote +>I'm in love</quote +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>(?=PATTERN)</userinput +> (Zakotwiczenie w przód)</term> +<listitem +><para +>Zakotwiczenie w przód analizuje część napisu następującą po potencjalnym dopasowaniu. Zakotwiczenie w przód nie spowoduje dopasowania wzorca, jeżeli tekst następujący po nim nie pasuje do <emphasis +>PATTERN</emphasis +> (wzorca) zakotwiczenia. Należy podkreślić iż tekst, który pasuje do wzorca zakotwiczenia, nie będzie częścią rezultatu wyszukiwania.</para> +<para +>Wyrażenie <userinput +>handy(?=\w)</userinput +> dopasowane będzie do <quote +>handy</quote +> w słowie <quote +>handyman</quote +> ale już nie do napisu: <quote +>That came in handy!</quote +></para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>(?!PATTERN)</userinput +> (Negacja zakotwiczenia w przód)</term> + +<listitem +><para +>Zanegowane zakotwiczenie w przód nie dopuści dopasowania wzorca, jeżeli tekst następujący po nim pasuje do <emphasis +>PATTERN</emphasis +> (wzorca) zakotwiczenia.</para> +<para +>Wyrażenie <userinput +>const \w+\b(?!\s*&)</userinput +> pasuje do tekstu <quote +>const char</quote +> w napisie <quote +>const char* foo</quote +> ale już nie będzie pasować do <quote +>const QString</quote +> w <quote +>const QString& bar</quote +> ponieważ znak <quote +>&</quote +> pasuje do negacji zakotwiczenia w przód.</para> +</listitem> +</varlistentry> + +</variablelist> + +</para> + +</sect1> + +<!-- TODO sect1 id="backreferences"> + +<title +>Back References</title> + +<para +></para> + +</sect1 --> + +</appendix> diff --git a/tde-i18n-pl/docs/tdebase/kate/unhighlighted.png b/tde-i18n-pl/docs/tdebase/kate/unhighlighted.png Binary files differnew file mode 100644 index 00000000000..6361032f3b8 --- /dev/null +++ b/tde-i18n-pl/docs/tdebase/kate/unhighlighted.png |
