summaryrefslogtreecommitdiffstats
path: root/tde-i18n-pl/docs/kdeaddons/kate-plugins
diff options
context:
space:
mode:
Diffstat (limited to 'tde-i18n-pl/docs/kdeaddons/kate-plugins')
-rw-r--r--tde-i18n-pl/docs/kdeaddons/kate-plugins/Makefile.am4
-rw-r--r--tde-i18n-pl/docs/kdeaddons/kate-plugins/Makefile.in635
-rw-r--r--tde-i18n-pl/docs/kdeaddons/kate-plugins/filetemplates.docbook460
-rw-r--r--tde-i18n-pl/docs/kdeaddons/kate-plugins/htmltools.docbook106
-rw-r--r--tde-i18n-pl/docs/kdeaddons/kate-plugins/index.cache.bz2bin0 -> 11822 bytes
-rw-r--r--tde-i18n-pl/docs/kdeaddons/kate-plugins/index.docbook177
-rw-r--r--tde-i18n-pl/docs/kdeaddons/kate-plugins/insertcommand.docbook184
-rw-r--r--tde-i18n-pl/docs/kdeaddons/kate-plugins/openheader.docbook61
-rw-r--r--tde-i18n-pl/docs/kdeaddons/kate-plugins/textfilter.docbook63
-rw-r--r--tde-i18n-pl/docs/kdeaddons/kate-plugins/xmlcheck.docbook152
-rw-r--r--tde-i18n-pl/docs/kdeaddons/kate-plugins/xmltools.docbook242
11 files changed, 2084 insertions, 0 deletions
diff --git a/tde-i18n-pl/docs/kdeaddons/kate-plugins/Makefile.am b/tde-i18n-pl/docs/kdeaddons/kate-plugins/Makefile.am
new file mode 100644
index 00000000000..b964a0a9aaa
--- /dev/null
+++ b/tde-i18n-pl/docs/kdeaddons/kate-plugins/Makefile.am
@@ -0,0 +1,4 @@
+KDE_LANG = pl
+SUBDIRS = $(AUTODIRS)
+KDE_DOCS = AUTO
+KDE_MANS = AUTO
diff --git a/tde-i18n-pl/docs/kdeaddons/kate-plugins/Makefile.in b/tde-i18n-pl/docs/kdeaddons/kate-plugins/Makefile.in
new file mode 100644
index 00000000000..8c07b06daf5
--- /dev/null
+++ b/tde-i18n-pl/docs/kdeaddons/kate-plugins/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/kdeaddons/kate-plugins
+DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in
+ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
+am__aclocal_m4_deps = $(top_srcdir)/acinclude.m4 \
+ $(top_srcdir)/configure.in
+am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
+ $(ACLOCAL_M4)
+mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs
+CONFIG_HEADER = $(top_builddir)/config.h
+CONFIG_CLEAN_FILES =
+SOURCES =
+DIST_SOURCES =
+#>- RECURSIVE_TARGETS = all-recursive check-recursive dvi-recursive \
+#>- html-recursive info-recursive install-data-recursive \
+#>- install-dvi-recursive install-exec-recursive \
+#>- install-html-recursive install-info-recursive \
+#>- install-pdf-recursive install-ps-recursive install-recursive \
+#>- installcheck-recursive installdirs-recursive pdf-recursive \
+#>- ps-recursive uninstall-recursive
+#>+ 7
+RECURSIVE_TARGETS = all-recursive check-recursive dvi-recursive \
+ html-recursive info-recursive install-data-recursive \
+ install-dvi-recursive install-exec-recursive \
+ install-html-recursive install-info-recursive \
+ install-pdf-recursive install-ps-recursive install-recursive \
+ installcheck-recursive installdirs-recursive pdf-recursive \
+ ps-recursive uninstall-recursive nmcheck-recursive bcheck-recursive
+RECURSIVE_CLEAN_TARGETS = mostlyclean-recursive clean-recursive \
+ distclean-recursive maintainer-clean-recursive
+ETAGS = etags
+CTAGS = ctags
+DIST_SUBDIRS = $(SUBDIRS)
+#>- DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
+#>+ 1
+DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) $(KDE_DIST)
+ACLOCAL = @ACLOCAL@
+AMTAR = @AMTAR@
+ARTSCCONFIG = @ARTSCCONFIG@
+AUTOCONF = @AUTOCONF@
+AUTODIRS = @AUTODIRS@
+AUTOHEADER = @AUTOHEADER@
+AUTOMAKE = @AUTOMAKE@
+AWK = @AWK@
+CONF_FILES = @CONF_FILES@
+CYGPATH_W = @CYGPATH_W@
+DCOPIDL = @DCOPIDL@
+DCOPIDL2CPP = @DCOPIDL2CPP@
+DCOPIDLNG = @DCOPIDLNG@
+DCOP_DEPENDENCIES = @DCOP_DEPENDENCIES@
+DEFS = @DEFS@
+ECHO_C = @ECHO_C@
+ECHO_N = @ECHO_N@
+ECHO_T = @ECHO_T@
+GMSGFMT = @GMSGFMT@
+INSTALL = @INSTALL@
+INSTALL_DATA = @INSTALL_DATA@
+INSTALL_PROGRAM = @INSTALL_PROGRAM@
+INSTALL_SCRIPT = @INSTALL_SCRIPT@
+INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@
+KCFG_DEPENDENCIES = @KCFG_DEPENDENCIES@
+KCONFIG_COMPILER = @KCONFIG_COMPILER@
+KDECONFIG = @KDECONFIG@
+KDE_EXTRA_RPATH = @KDE_EXTRA_RPATH@
+KDE_RPATH = @KDE_RPATH@
+KDE_XSL_STYLESHEET = @KDE_XSL_STYLESHEET@
+LIBOBJS = @LIBOBJS@
+LIBS = @LIBS@
+LN_S = @LN_S@
+LTLIBOBJS = @LTLIBOBJS@
+MAKEINFO = @MAKEINFO@
+MAKEKDEWIDGETS = @MAKEKDEWIDGETS@
+MCOPIDL = @MCOPIDL@
+MEINPROC = @MEINPROC@
+MKDIR_P = @MKDIR_P@
+MSGFMT = @MSGFMT@
+PACKAGE = @PACKAGE@
+PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@
+PACKAGE_NAME = @PACKAGE_NAME@
+PACKAGE_STRING = @PACKAGE_STRING@
+PACKAGE_TARNAME = @PACKAGE_TARNAME@
+PACKAGE_VERSION = @PACKAGE_VERSION@
+PATH_SEPARATOR = @PATH_SEPARATOR@
+SET_MAKE = @SET_MAKE@
+SHELL = @SHELL@
+STRIP = @STRIP@
+TOPSUBDIRS = @TOPSUBDIRS@
+VERSION = @VERSION@
+XGETTEXT = @XGETTEXT@
+XMLLINT = @XMLLINT@
+X_RPATH = @X_RPATH@
+abs_builddir = @abs_builddir@
+abs_srcdir = @abs_srcdir@
+abs_top_builddir = @abs_top_builddir@
+abs_top_srcdir = @abs_top_srcdir@
+am__leading_dot = @am__leading_dot@
+am__tar = @am__tar@
+am__untar = @am__untar@
+#>- bindir = @bindir@
+#>+ 2
+DEPDIR = .deps
+bindir = @bindir@
+build_alias = @build_alias@
+builddir = @builddir@
+datadir = @datadir@
+datarootdir = @datarootdir@
+docdir = @docdir@
+dvidir = @dvidir@
+exec_prefix = @exec_prefix@
+host_alias = @host_alias@
+htmldir = @htmldir@
+includedir = @includedir@
+infodir = @infodir@
+install_sh = @install_sh@
+kde_appsdir = @kde_appsdir@
+kde_bindir = @kde_bindir@
+kde_confdir = @kde_confdir@
+kde_datadir = @kde_datadir@
+kde_htmldir = @kde_htmldir@
+kde_icondir = @kde_icondir@
+kde_kcfgdir = @kde_kcfgdir@
+kde_libs_htmldir = @kde_libs_htmldir@
+kde_libs_prefix = @kde_libs_prefix@
+kde_locale = @kde_locale@
+kde_mimedir = @kde_mimedir@
+kde_moduledir = @kde_moduledir@
+kde_servicesdir = @kde_servicesdir@
+kde_servicetypesdir = @kde_servicetypesdir@
+kde_sounddir = @kde_sounddir@
+kde_styledir = @kde_styledir@
+kde_templatesdir = @kde_templatesdir@
+kde_wallpaperdir = @kde_wallpaperdir@
+kde_widgetdir = @kde_widgetdir@
+kdeinitdir = @kdeinitdir@
+libdir = @libdir@
+libexecdir = @libexecdir@
+localedir = @localedir@
+localstatedir = @localstatedir@
+mandir = @mandir@
+mkdir_p = @mkdir_p@
+oldincludedir = @oldincludedir@
+pdfdir = @pdfdir@
+prefix = @prefix@
+program_transform_name = @program_transform_name@
+psdir = @psdir@
+sbindir = @sbindir@
+sharedstatedir = @sharedstatedir@
+srcdir = @srcdir@
+sysconfdir = @sysconfdir@
+target_alias = @target_alias@
+top_builddir = @top_builddir@
+top_srcdir = @top_srcdir@
+xdg_appsdir = @xdg_appsdir@
+xdg_directorydir = @xdg_directorydir@
+xdg_menudir = @xdg_menudir@
+KDE_LANG = pl
+#>- SUBDIRS = $(AUTODIRS)
+#>+ 1
+SUBDIRS =.
+KDE_DOCS = AUTO
+KDE_MANS = AUTO
+#>- all: all-recursive
+#>+ 1
+all: docs-am all-recursive
+
+.SUFFIXES:
+$(srcdir)/Makefile.in: $(srcdir)/Makefile.am $(am__configure_deps)
+#>- @for dep in $?; do \
+#>- case '$(am__configure_deps)' in \
+#>- *$$dep*) \
+#>- cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \
+#>- && exit 0; \
+#>- exit 1;; \
+#>- esac; \
+#>- done; \
+#>- echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu docs/kdeaddons/kate-plugins/Makefile'; \
+#>- cd $(top_srcdir) && \
+#>- $(AUTOMAKE) --gnu docs/kdeaddons/kate-plugins/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/kdeaddons/kate-plugins/Makefile'; \
+ cd $(top_srcdir) && \
+ $(AUTOMAKE) --gnu docs/kdeaddons/kate-plugins/Makefile
+ cd $(top_srcdir) && perl ../scripts/admin/am_edit -p../scripts/admin docs/kdeaddons/kate-plugins/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=openheader.docbook insertcommand.docbook Makefile.in textfilter.docbook index.docbook htmltools.docbook filetemplates.docbook Makefile.am xmlcheck.docbook xmltools.docbook index.cache.bz2
+
+#>+ 24
+index.cache.bz2: $(srcdir)/index.docbook $(KDE_XSL_STYLESHEET) filetemplates.docbook htmltools.docbook index.docbook xmltools.docbook insertcommand.docbook textfilter.docbook xmlcheck.docbook openheader.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-plugins
+ @if test -f index.cache.bz2; then \
+ echo $(INSTALL_DATA) index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate-plugins/; \
+ $(INSTALL_DATA) index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate-plugins/; \
+ elif test -f $(srcdir)/index.cache.bz2; then \
+ echo $(INSTALL_DATA) $(srcdir)/index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate-plugins/; \
+ $(INSTALL_DATA) $(srcdir)/index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate-plugins/; \
+ fi
+ -rm -f $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate-plugins/common
+ $(LN_S) $(kde_libs_htmldir)/$(KDE_LANG)/common $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate-plugins/common
+
+uninstall-docs:
+ -rm -rf $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate-plugins
+
+clean-docs:
+ -rm -f index.cache.bz2
+
+
+#>+ 13
+install-nls:
+ $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate-plugins
+ @for base in filetemplates.docbook htmltools.docbook index.docbook xmltools.docbook insertcommand.docbook textfilter.docbook xmlcheck.docbook openheader.docbook ; do \
+ echo $(INSTALL_DATA) $$base $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate-plugins/$$base ;\
+ $(INSTALL_DATA) $(srcdir)/$$base $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate-plugins/$$base ;\
+ done
+
+uninstall-nls:
+ for base in filetemplates.docbook htmltools.docbook index.docbook xmltools.docbook insertcommand.docbook textfilter.docbook xmlcheck.docbook openheader.docbook ; do \
+ rm -f $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate-plugins/$$base ;\
+ done
+
+
+#>+ 5
+distdir-nls:
+ for file in filetemplates.docbook htmltools.docbook index.docbook xmltools.docbook insertcommand.docbook textfilter.docbook xmlcheck.docbook openheader.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/kdeaddons/kate-plugins/Makefile'; \
+ cd $(top_srcdir) && \
+ $(AUTOMAKE) --gnu docs/kdeaddons/kate-plugins/Makefile
+ cd $(top_srcdir) && perl ../scripts/admin/am_edit -p../scripts/admin docs/kdeaddons/kate-plugins/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/kdeaddons/kate-plugins/filetemplates.docbook b/tde-i18n-pl/docs/kdeaddons/kate-plugins/filetemplates.docbook
new file mode 100644
index 00000000000..694c3aff2eb
--- /dev/null
+++ b/tde-i18n-pl/docs/kdeaddons/kate-plugins/filetemplates.docbook
@@ -0,0 +1,460 @@
+<chapter id="filetemplates">
+ <chapterinfo>
+
+ <title
+>Szablony plików</title>
+
+ <authorgroup>
+ <author
+><firstname
+>Anders</firstname
+> <surname
+>Lund</surname
+> <affiliation
+> <address
+>&Anders.Lund.mail;</address>
+ </affiliation>
+ </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>
+<date
+>2006-01-10</date
+> <releaseinfo
+>0.1</releaseinfo
+> <keywordset>
+ <keyword
+>KDE</keyword>
+ <keyword
+>kate</keyword>
+ <keyword
+>kdeaddons</keyword>
+ <keyword
+>szablon</keyword>
+ <keyword
+>makro</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title
+>Wprowadzenie</title>
+
+ <para
+>Wtyczka "Szablony Plików Kate" pozwala na tworzenie nowych dokumentów bazujących na zdefiniowanym wzorcu. Jako szablon może służyć dowolny plik tekstowy (będzie on skopiowany do zawartości nowego dokumentu) lub specjalny plik szablonu zawierający makro polecenia pozwalające na wprowadzenie do pliku informacji takich jak np. nazwisko, adres email, data, itp. oraz umożliwiające ustawienia kursora w zdefiniowanej pozycji w nowo utworzonym pliku.</para>
+ <para
+>Wszystkie szablony zlokalizowane w katalogu programu będą widoczne jako pozycje w menu <menuchoice
+><guimenu
+>Plik</guimenu
+><guimenuitem
+>Nowy z szablonu</guimenuitem
+></menuchoice
+>.</para
+> <para
+>Wtyczka ta pozwala również w prosty sposób utworzyć nowy szablon na podstawie otwartego dokumentu.</para>
+ <para
+>Katalogi z szablonami wchodzą w skład systemu plików środowiska &kde; i są one następujące:KDEDIR/share/applications/kate/plugins/katefiletemplates/templates orazKDEHOME/share/applications/kate/plugins/katefiletemplates/templates. Jeżeli w zmiennej środowiskowej KDEDIRS zdefiniowano kilka dodatkowych katalogów, to wszystkie są one sprawdzane w poszukiwaniu podobnego podkatalogu. Jeżeli znalezione zostaną szablony o identycznych nawach to wybierany jest ten znajdujący się w głównym katalogu środowiska &kde; zdefiniowanym przez zmienną KDEHOME.</para>
+ <sect1 id="katefiletemplates-menu">
+ <title
+>Pozycje menu</title>
+
+ <variablelist>
+ <varlistentry>
+ <term>
+ <menuchoice
+><guimenu
+>Plik</guimenu
+> <guimenu
+>Nowy z szablonu</guimenu
+> <guimenuitem
+>Dowolny plik...</guimenuitem
+> </menuchoice>
+ </term>
+ <listitem
+><para
+>Wyświetla okno dialogowe otwierania plików, pozwalające na wybór dowolnego wskazanego pliku jako szablonu dokumentu. Jeżeli wybrany plik posiada rozszerzenie <filename
+>katetemplate</filename
+> to zostaną zinterpretowane zawarte w nim makra i informacje o szablonie.</para
+></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>
+ <menuchoice
+><guimenu
+>Plik</guimenu
+> <guimenu
+>Nowy z szablonu</guimenu
+> <guimenuitem
+>Użyj ostatniego</guimenuitem
+> </menuchoice>
+ </term>
+ <listitem
+><para
+>Wyświetla listę ostatnio wykorzystywanych szablonów podając ich adres &URL;.</para
+></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>
+ <menuchoice
+><guimenu
+>Plik</guimenu
+> <guimenuitem
+>Nowy z szablonu</guimenuitem
+> </menuchoice>
+ </term>
+ <listitem
+><para
+>Otwiera menu podrzędne zawierające listę szablonów. Kliknięcie na wybranej pozycji tworzy plik na podstawie odpowiadającego jej szablonu.</para
+></listitem>
+ </varlistentry>
+
+ <!-- Settings menu -->
+
+ <varlistentry>
+ <term>
+ <menuchoice
+><guimenu
+>Ustawienia</guimenu
+><guimenuitem
+>Zarządzaj szablonami...</guimenuitem
+></menuchoice
+></term>
+ <listitem
+><para
+>Wyświetla okno dialogowe zawierające listę wszystkich szablonów dostępnych w katalogach programu &kate;, oraz opcje pozwalające na dodawanie, zmianę i usuwanie szablonów.</para
+></listitem>
+ </varlistentry>
+ </variablelist>
+ </sect1>
+
+ <sect1 id="katefiletemplates-use">
+ <title
+>Korzystanie z szablonów w &kate;</title>
+ <para
+>Przy tworzeniu pliku na podstawie szablonu zawierającego makro polecenia, niektóre z tych makro poleceń pojawiają się jako pola w tekście, które można edytować. Są one zaznaczane przez &kate; za pomocą podkreślenia ich.</para>
+ <para
+>Pierwsza zmienna będzie aktywna i możliwe będzie edycja jej zawartości. Jeżeli w dokumencie znajduje się kilka odwołań do tej samej zmiennej, to ich zawartość również będzie zmieniana w trakcie jej edycji. Przejście do następnej zmiennej odbywa się za pomocą klawisza TAB. Po osiągnięciu ostatniej zmiennej na liście, zostaje ona zwinięta, a normalne działanie klawisza TAB zostaje przywrócone.</para>
+ </sect1>
+
+ <sect1 id="katefiletemplates-create">
+ <title
+>Tworzenie własnych szablonów</title>
+ <para
+>Aby utworzyć nowy szablon, wybierz z menu <menuchoice
+><guimenu
+>Ustawienia</guimenu
+> <guimenuitem
+>Zarządzaj szablonami...</guimenuitem
+></menuchoice
+>, co spowoduje otworzenie okna zarządzania szablonami. W tym oknie, naciśnij przycisk <guibutton
+>Nowy...</guibutton
+>, aby uruchomić asystenta tworzenia szablonu. Asystent poprosi o wskazanie pliku, który ma zostać zamieniony na szablon, oraz o podanie ustawień szablonu, a następnie szablon zostanie utworzony.</para
+> <para
+>Innym sposobem jest ręczne utworzenie szablonu poprzez dodanie pól informacyjnych, tekstu i makro poleceń do dowolnego pliku tekstowego i zapisanie go w pliku z rozszerzeniem <filename
+>katetemplate</filename
+>.</para>
+ <para
+>Menu z listą szablonów jest aktualizowane automatycznie w momencie zapisania go na dysku w odpowiednim katalogu z szablonami &kate;.</para>
+ </sect1>
+
+ <sect1 id="katefiletemplates-edit">
+ <title
+>Modyfikacja szablonów</title>
+ <para
+>Aby zmienić szablon, wybierz z menu <menuchoice
+><guimenu
+>Ustawienia</guimenu
+> <guimenuitem
+>Zarządzaj szablonami...</guimenuitem
+></menuchoice
+>. Następnie wybierz szablon, który chcesz zmienić i naciśnij przycisk <guibutton
+>Zmień...</guibutton
+>, aby otworzyć szablon. Zamknij okno dialogowe, zmień szablon według swojego upodobania i zamknij go.Zmiany w szablonach są widoczne od razu. Możesz uruchomić szablon zaraz po zapisaniu, aby to sprawdzić.</para>
+ </sect1>
+
+ <sect1 id="katefiletemplates-format">
+ <title
+>Format pliku z szablonem dokumentu &kate;</title>
+ <para
+>Jeżeli otwierane są pliki z rozszerzeniem <filename
+>katetemplate</filename
+> to są one przetwarzane w poszukiwaniu informacji o szablonie, makro poleceniach i pozycji kursora.</para>
+
+ <sect2 id="katefiletemplates-template-info">
+ <title
+>Informacje o szablonie</title>
+ <para
+>W trakcie odczytu pliku program poszukuje wierszy rozpoczynających się od napisu <constant
+>katetemplate:</constant
+> i poszukuje w nich informacji o szablonie zapisanych w formacie NAZWAZMIENNEJ=WARTOŚĆ. Pierwszy wiersz tekstu, w którym brak jest napisu <constant
+>katetemplate:</constant
+> stanowi początek zawartości szablonu.Wartością może być dowolny znak lub ciąg znaków z wyjątkiem znaku równości (=). Dopuszczalne są następujące nazwy zmiennych: <variablelist>
+ <varlistentry>
+ <term
+><varname
+>Template</varname
+></term>
+ <listitem
+><para
+>Nazwa szablonu, która będzie wyświetlana jako pozycja w menu <menuchoice
+><guimenu
+>Plik</guimenu
+><guimenuitem
+>Nowy z szablonu</guimenuitem
+></menuchoice
+>.</para
+></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term
+><varname
+>Group</varname
+></term>
+ <listitem
+><para
+>Nazwa grupy tematycznej wykorzystywana do grupowania listy szablonów w menu <menuchoice
+><guimenu
+>Plik</guimenu
+><guimenuitem
+>Nowy z szablonu</guimenuitem
+></menuchoice
+>.</para
+></listitem>
+ </varlistentry>
+ <varlistentry
+><term
+><varname
+>Name</varname
+></term>
+ <listitem
+><para
+>Definiuje nazwę dokumentu, wyświetlaną na liście plików i pasku tytułowym okna. Jeżeli nazwa zawiera napis <userinput
+>%N</userinput
+> to będzie on zamieniany na kolejny numer dokumentu podczas tworzenia dokumentów o tej samej nazwie.</para
+></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term
+><varname
+>Highlight</varname
+></term>
+ <listitem
+><para
+>Ten parametr powoduje ustawienie trybu podświetlania dla nowo tworzonego dokumentu. Wartość parametru powinna być taka sama jak nazwa reguły podświetlania widoczna w menu <menuchoice
+><guimenu
+>Narzędzia</guimenu
+> <guimenuitem
+>Podświetlenie</guimenuitem
+> </menuchoice
+>.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term
+><varname
+>Description</varname
+></term>
+ <listitem
+><para
+>Krótki opis charakteryzujący szablon. Jest wykorzystywany do wyświetlania informacji "Co to jest?" dla odpowiedniej pozycji menu, może być też wykorzystywany w innych celach w przyszłości.</para
+></listitem>
+ </varlistentry>
+ <varlistentry
+><term
+>Author</term>
+ <listitem
+><para
+>Napis identyfikujący autora, na przykład w formie <userinput
+>Nazwisko Imię &lt;adres email&gt;</userinput
+>. Jest wykorzystywany do wyświetlania informacji "Co to jest?" dla odpowiedniej pozycji menu, może być też wykorzystywany w innych celach w przyszłości.</para
+></listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+
+ </sect2>
+
+ <sect2 id="katetemplates-macros">
+ <title
+>Makro polecenia stosowane w szablonach</title>
+
+ <para
+>Podczas przetwarzania szablonu, makro polecenia zapisane w formie <userinput
+>%{NAME}</userinput
+> lub <userinput
+>${NAME}</userinput
+> będą wstawiane do tekstu. Jeżeli znakiem poprzedzającym polecenie jest <userinput
+>$</userinput
+> to tekst będzie traktowany jako zmienna, którą można modyfikować po utworzeniu nowego dokumentu na podstawie szabonu, jeżeli zaś użyty będzie znak <userinput
+>%</userinput
+> to edycja nie będzie możliwa (no chyba że operacja wstawiania się nie powiodła).</para>
+ <para
+>Dostępne są następujące makro polecenia: <variablelist>
+ <varlistentry
+><term
+>time</term>
+ <listitem
+><para
+>Wprowadza bieżący czas w formacie zdefiniowanym przez ustawienia lokalne.</para
+></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term
+>date</term>
+ <listitem
+><para
+>Wprowadza do dokumentu bieżącą datę w zapisie krótkim.</para
+></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term
+>datetime</term>
+ <listitem
+><para
+>Wprowadza bieżącą datę i czas jako napis sformatowany zgodnie z ustawieniami lokalnymi.</para
+></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term
+>year</term>
+ <listitem
+><para
+>Wprowadza bieżący rok w postaci 4 cyfr.</para
+></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term
+>month</term>
+ <listitem
+><para
+>Pełna nazwa bieżącego miesiąca, zgodna z ustawieniami lokalnymi systemu.</para
+></listitem>
+ </varlistentry>
+ <varlistentry
+><term
+>day</term>
+ <listitem
+><para
+>Wprowadza bieżący dzień miesiąca.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry
+><term
+>hostname</term>
+ <listitem
+><para
+>Wprowadza nazwę komputera zdefiniowaną w zmiennej środowiskowej: 'hostname'.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry
+><term
+>index</term>
+ <listitem
+><para
+>Wprowadza znak 'i'.</para
+></listitem>
+ </varlistentry>
+ <varlistentry
+><term
+>fullname</term>
+ <listitem
+><para
+>Wstawia imię i nazwisko zalogowanego użytkownika, zdefiniowany w książce adresowej środowiska &kde;.</para
+></listitem>
+ </varlistentry>
+ <varlistentry
+><term
+>firstname</term>
+ <listitem
+><para
+>Wstawia imię zalogowanego użytkownika, zdefiniowany w książce adresowej środowiska &kde;.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry
+><term
+>lastname</term>
+ <listitem
+><para
+>Wstawia nazwisko zalogowanego użytkownika, zdefiniowany w książce adresowej środowiska &kde;.</para>
+ </listitem>
+ </varlistentry>
+ <!-- <varlistentry>
+ <term
+>username</term>
+ <listitem
+><para
+>Expands to your username.</para
+></listitem>
+ </varlistentry
+> -->
+ <varlistentry>
+ <term
+>email</term>
+ <listitem
+><para
+>Wstawia adres email zalogowanego użytkownika, zdefiniowany w książce adresowej środowiska &kde;.</para
+></listitem>
+ </varlistentry>
+ <!--<varlistentry>
+ <term
+>organisation</term>
+ <listitem
+><para
+>This is your organisation, as defined by
+ the owner address in your standard KDE
+ addressbook.</para
+></listitem>
+ </varlistentry
+>-->
+ </variablelist>
+ </para>
+ <para
+>Każde inne (nie znajdujące się na powyższej liście) makro polecenie, traktowane jest jako zmienna, którą można modyfikować niezależnie od dodanego prefiksu. Jeżeli taka sama zmienna występuje w kilku miejscach dokumentu, to jej edycja w jednym miejscu uzupełni wszystkie pozostałe wystąpienia przy tworzeniu dokumentu na podstawie szablonu.</para>
+ </sect2>
+
+ <sect2 id="katefiletemplates-cursor">
+ <title
+>Ustawianie pozycji kursora</title>
+ <para
+>Specjalne makro polecenie zapisane jako <userinput
+>${cursor}</userinput
+> będzie zamieniona na poziomą linię dodaną na końcu listy modyfikowalnych zmiennych, niezależnie od ich położenia w tekście.</para>
+ </sect2>
+
+ </sect1>
+
+ <sect1 id="katefiletemplates-thanks-and-acknowledgements">
+ <title
+>Podziękowania i licencje</title>
+
+ <para
+>Wtyczka <quote
+>Szablony plików &kate;</quote
+> - prawa autorskie (c) 2004 &Anders.Lund; &Anders.Lund.mail;. </para>
+
+ <para
+>Prawa autorskie do dokumentacji (c) 2004 &Anders.Lund; </para>
+
+ <para
+>Krzysztof Woźniak <email
+>wozniakk@ceti.pl</email
+></para
+>
+&underGPL; </sect1>
+</chapter>
+
+<!-- kate: word-wrap on; space-indent on; indent-width 2; --> \ No newline at end of file
diff --git a/tde-i18n-pl/docs/kdeaddons/kate-plugins/htmltools.docbook b/tde-i18n-pl/docs/kdeaddons/kate-plugins/htmltools.docbook
new file mode 100644
index 00000000000..567acdaf19f
--- /dev/null
+++ b/tde-i18n-pl/docs/kdeaddons/kate-plugins/htmltools.docbook
@@ -0,0 +1,106 @@
+<chapter id="htmltools">
+<chapterinfo>
+
+<title
+>Narzędzia <acronym
+>HTML</acronym
+> do Kate </title>
+
+<authorgroup>
+<author
+><firstname
+>Francis</firstname
+> <surname
+>Giannaros</surname
+> <affiliation
+> <address
+><email
+>francisg@gmail.com</email
+></address>
+</affiliation>
+</author>
+</authorgroup
+> <date
+>2002-05-15</date
+> <releaseinfo
+>1.00.00</releaseinfo
+> <abstract
+> <para
+>Wtyczka wspomagająca wstawianie znaczników &HTML;. </para>
+</abstract>
+
+<keywordset>
+<keyword
+>KDE</keyword>
+<keyword
+>kate</keyword>
+<keyword
+>html</keyword>
+</keywordset>
+</chapterinfo>
+
+<title
+>Wprowadzenie</title>
+
+<para
+>Wtyczka otwiera okno dialogowe, w którym należy wprowadzić nazwę znacznika &HTML;. Parametry, które występują w znaczniku otwierającym należy wpisywać tak: <userinput
+><replaceable
+>nazwa-parametru</replaceable
+>="<replaceable
+>wartość</replaceable
+>"</userinput
+>. Po naciśnięciu klawisza &Enter;, w dokumencie zostanie umieszczony znacznik otwierający i odpowiadający mu znacznik zamykający.</para>
+
+<sect1 id="htmltools-menu">
+<title
+>Pozycje menu</title>
+
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice
+><guimenu
+>Narzędzia</guimenu
+> <guimenuitem
+>Znacznik HTML...</guimenuitem
+> </menuchoice>
+</term>
+<listitem
+><para
+>Otwiera opisane wcześniej okno dialogowe</para
+></listitem>
+</varlistentry>
+</variablelist>
+
+</sect1>
+
+<sect1 id="htmltools-thanks-and-acknowledgements">
+<title
+>Podziękowania i zasługi</title>
+
+<para
+>Wtyczka <quote
+>Narzędzia HTML do Kate</quote
+>. Prawa autorskie do programu (c) 2002 Joseph Wenninger <email
+>kde@jowenn.at</email
+>. </para>
+
+<para
+>Prawa autorskie do dokumentacji (c) 2005 Francis Giannaros </para>
+
+<para
+>Krzysztof Woźniak <email
+>wozniakk@ceti.pl</email
+></para
+>
+&underGPL; </sect1>
+
+</chapter>
+
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+End:
+-->
diff --git a/tde-i18n-pl/docs/kdeaddons/kate-plugins/index.cache.bz2 b/tde-i18n-pl/docs/kdeaddons/kate-plugins/index.cache.bz2
new file mode 100644
index 00000000000..ca5c7dba474
--- /dev/null
+++ b/tde-i18n-pl/docs/kdeaddons/kate-plugins/index.cache.bz2
Binary files differ
diff --git a/tde-i18n-pl/docs/kdeaddons/kate-plugins/index.docbook b/tde-i18n-pl/docs/kdeaddons/kate-plugins/index.docbook
new file mode 100644
index 00000000000..cbc968b9948
--- /dev/null
+++ b/tde-i18n-pl/docs/kdeaddons/kate-plugins/index.docbook
@@ -0,0 +1,177 @@
+<?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 doc-filetemplates SYSTEM "filetemplates.docbook">
+ <!ENTITY doc-htmltools SYSTEM "htmltools.docbook">
+ <!ENTITY doc-insertcommand SYSTEM "insertcommand.docbook">
+ <!ENTITY doc-openheader SYSTEM "openheader.docbook">
+ <!ENTITY doc-projectmanager SYSTEM "projectmanager.docbook">
+ <!ENTITY doc-textfilter SYSTEM "textfilter.docbook">
+ <!ENTITY doc-xmltools SYSTEM "xmltools.docbook">
+ <!ENTITY doc-xmlcheck SYSTEM "xmlcheck.docbook">
+ <!ENTITY % Polish "INCLUDE"
+> <!-- change language only here -->
+]>
+
+<book lang="&language;">
+<bookinfo>
+<title
+>Podręcznik użytkownika dla wtyczek do programu &kate;</title>
+
+<othercredit role="translator"
+><firstname
+>Krzysztof</firstname
+><surname
+>Woźniak</surname
+><affiliation
+><address
+><email
+>wozniakk@ceti.pl</email
+></address
+></affiliation
+><contrib
+></contrib
+></othercredit
+>
+
+<date
+>2006-02-24</date>
+<releaseinfo
+>3.5.1</releaseinfo
+> <!-- Used KDE version here -->
+
+<copyright>
+<year
+>2001</year>
+<year
+>2002</year>
+
+</copyright>
+
+<legalnotice
+>&FDLNotice;</legalnotice>
+
+<abstract>
+<para
+>Niniejszy podręcznik dotyczy wtyczek do &kate; zaawansowanego edytora tekstu dla środowiska &kde;. </para>
+</abstract>
+
+<keywordset>
+<keyword
+>KDE</keyword>
+<keyword
+>kdeaddons</keyword>
+<keyword
+>Kate</keyword>
+<keyword
+>Wtyczki</keyword>
+</keywordset>
+
+</bookinfo>
+
+<chapter id="introduction">
+<title
+>Wtyczki programu &kate;</title>
+
+<para
+>Wtyczki w programie &kate; zwiększają funkcjonalność edytora. Mogą powodować dodanie nowej pozycji menu i skrótu klawiszowego. Można dowolną liczbę wtyczek zainstalować i włączyć lub wyłączyć w zależności od potrzeb użytkownika za pomocą okna konfiguracji &kate;. Aby tego dokonać należy wybrać menu <menuchoice
+><guimenu
+>Ustawienia</guimenu
+><guimenuitem
+>Konfiguracja: &kate;...</guimenuitem
+></menuchoice
+>. W oknie konfiguracji trzeba wybrać pozycję <menuchoice
+><guimenu
+>Program</guimenu
+><guimenuitem
+>Wtyczki</guimenuitem
+></menuchoice
+> i wybrać potrzebne do pracy z programem wtyczki. </para>
+
+<para
+>Więcej informacji dotyczących &kate; i sposobu włączania w nim wtyczek znajduje się w podręczniku programu &kate;. </para>
+
+<para
+>Podręcznik zawiera opis następujących wtyczek: </para>
+
+<itemizedlist>
+<listitem>
+<para
+><link linkend="xmltools"
+>Dopełnienie tekstu w &XML;</link
+></para>
+</listitem>
+<listitem>
+<para
+><link linkend="xmlcheck"
+>Sprawdzanie poprawności XML-a</link
+></para>
+</listitem>
+<listitem>
+<para
+><link linkend="insertcommand"
+>Polecenie wstawiania do Kate</link
+></para>
+</listitem>
+<listitem>
+<para
+><link linkend="htmltools"
+>Narzędzia &HTML; do Kate</link
+></para>
+</listitem>
+<listitem>
+<para
+><link linkend="openheader"
+>Kate - Otwarcie pliku nagłówkowego</link
+></para>
+</listitem>
+<listitem>
+<para
+><link linkend="textfilter"
+>Kate - Filtr tekstu</link
+></para>
+</listitem>
+<listitem>
+<para
+><link linkend="filetemplates"
+>Wzorce plików dla Kate</link
+></para>
+</listitem>
+</itemizedlist>
+
+</chapter>
+
+&doc-xmltools;
+&doc-xmlcheck;
+&doc-insertcommand;
+&doc-htmltools;
+&doc-openheader;
+&doc-textfilter;
+&doc-filetemplates;
+
+<chapter id="credits">
+<title
+>Licencje i zasługi</title>
+
+<para
+>Dokumentacja poszczególnych wtyczek zawiera informacje o prawach autorskich do nich. </para>
+&underFDL; &underGPL; </chapter>
+
+<!--
+<appendix id="installation">
+<title
+>Installation</title>
+<para
+>To be written
+</para>
+</appendix>
+-->
+
+</book>
+
+<!--
+Local Variables:
+mode: sgml
+End:
+-->
diff --git a/tde-i18n-pl/docs/kdeaddons/kate-plugins/insertcommand.docbook b/tde-i18n-pl/docs/kdeaddons/kate-plugins/insertcommand.docbook
new file mode 100644
index 00000000000..4e9de7595b4
--- /dev/null
+++ b/tde-i18n-pl/docs/kdeaddons/kate-plugins/insertcommand.docbook
@@ -0,0 +1,184 @@
+<chapter id="insertcommand">
+<chapterinfo>
+
+<title
+>Polecenie wstawiania do Kate</title>
+
+<authorgroup>
+<author
+><firstname
+>Anders</firstname
+> <surname
+>Lund</surname
+> <affiliation
+> <address
+>&Anders.Lund.mail;</address>
+</affiliation>
+</author>
+</authorgroup
+> <date
+>2006-05-17</date
+> <releaseinfo
+>3.5.2</releaseinfo
+> <abstract
+> <para
+>Wtyczka <quote
+>Polecenie wstawiania do Kate</quote
+> pozwala na wstawienie do edytowanego w &kate; dokumentu tekstu będącego wyjściem dowolnego polecenia powłoki. </para>
+</abstract>
+<keywordset>
+<keyword
+>KDE</keyword>
+<keyword
+>kate</keyword>
+<keyword
+>wstaw</keyword>
+</keywordset>
+</chapterinfo>
+
+<title
+>Wprowadzenie</title>
+
+<para
+>Wtyczka <quote
+>Polecenie wstawiania do Kate</quote
+> pozwala na wstawienie do edytowanego w &kate; dokumentu tekstu będącego wyjściem dowolnego polecenia powłoki.</para>
+
+<para
+>Najpierw należy włączyć wtyczkę <quote
+>Polecenie wstawiania &kate;</quote
+> korzystając z menu <menuchoice
+><guimenu
+>Ustawienia</guimenu
+> <guimenuitem
+>Konfiguracja &kate;...</guimenuitem
+></menuchoice
+> i zaznaczając w karcie konfiguracji opcję <guilabel
+>Polecenie wstawiania &kate;</guilabel
+> w sekcji konfiguracyjnej: <guilabel
+>Program</guilabel
+> <guilabel
+>Wtyczki</guilabel
+>.</para>
+
+<sect1 id="insertcommand-fund">
+<title
+>Wprowadzenie</title>
+
+<para
+>Aby skorzystać z wtyczki należy wybrać pozycję<guimenu
+>Wstaw polecenie...</guimenu
+> z menu <guimenu
+>Narzędzia</guimenu
+>. Pojawi się małe okno dialogowe pozwalające na wprowadzenie polecenia powłoki do uruchomienia, wybranie katalogu roboczego i wybranie wyjścia błędów polecenia (STDERR) zamiast wyjścia standardowego (STDOUT). Można również spowodować wprowadzenie do dokumentu tekstu z wykonanym przez powłokę poleceniem przed wygenerowaną treścią wyjścia. </para>
+
+<mediaobject>
+<imageobject
+><imagedata format="PNG" fileref="insertcommand.png"/></imageobject>
+<textobject>
+<phrase
+>Okno dialogowe wtyczki</phrase>
+</textobject>
+</mediaobject>
+
+<para
+>Wtyczka może przechowywać pewną liczbę ostatnio używanych poleceń, których ilość można ustawić w oknie konfiguracji. Lista ostatnio wykonanych poleceń jest wykorzystywana przy działaniu funkcji automatycznego uzupełniania i można ją wywołać za pomocą rozwijanej listy w polu wprowadzania polecenia. </para>
+
+<para
+>Domyślnie polecenia uruchamiane są w katalogu roboczym właściwym dla procesu programu &kate;, którym z reguły jest katalog domowy użytkownika. Zachowanie to może być zmienione w oknie konfiguracji wtyczki. </para>
+
+<para
+>Należy pamiętać że polecenia powłoki wymagające akcji użytkownika (np. polecenie passwd) lub korzystające z interfejsu 'ncurses' itp. (np. polecenie top) nie będą prawidłowo działać z tą wtyczką. </para>
+
+</sect1>
+
+<sect1 id="insertcommand-config">
+<title
+>Konfiguracja</title>
+
+<para
+>Aby dokonać konfiguracji wtyczki <quote
+>Polecenie wstawiania &kate;</quote
+> należy otworzyć okno konfiguracyjne programu za pomocą menu <menuchoice
+><guimenu
+>Ustawienia</guimenu
+><guimenuitem
+>Konfiguracja &kate;...</guimenuitem
+></menuchoice
+> oraz wybranie pozycji <menuchoice
+><guimenuitem
+>Wtyczki</guimenuitem
+><guilabel
+>Wstaw polecenie </guilabel
+></menuchoice
+>. </para>
+
+<mediaobject>
+<imageobject
+><imagedata format="PNG"
+fileref="configure_insertcommand.png"/></imageobject>
+<textobject>
+<phrase
+>Karta Konfiguracji Polecenia Wstawiania</phrase>
+</textobject>
+</mediaobject>
+
+<para
+>Dostępne są następujące opcje konfiguracyjne: </para>
+
+<variablelist>
+<varlistentry>
+<term
+><guilabel
+>Zapamiętaj ... polecenia</guilabel
+></term>
+<listitem>
+<para
+>Wartość jest przedstawiona w polu numerycznym pozwalającym na określenie liczby zapamiętywanych poleceń. Dopuszczalne są wartości z przedziału od 0 do 99. Wartością domyślną jest 20.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><guilabel
+>Rozpocznij w:</guilabel
+></term>
+<listitem>
+<para
+>To ustawienie zawiera zestaw przycisków opcji pozwalających na określenie, który katalog będzie roboczym katalogiem dla wykonywanego polecenia. Do wyboru są następujące opcje: Katalog roboczy programu &kate; (zwykle jest to katalog domowy użytkownika); Katalog dokumentu (jeżeli istnieje i jest dostępny, w przeciwnym wypadku użyty zostanie poprzednie katalog); Ostatnio używany katalog roboczy, w którym uruchomiane były polecenia. </para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+
+</sect1>
+
+<sect1 id="insertcommand-thanks-and-acknowledgements">
+<title
+>Podziękowania i zasługi</title>
+
+<para
+>Wtyczka <quote
+>Polecenie wstawiania do Kate</quote
+>. Prawa autorskie do programu (c) 2001 Anders Lund &Anders.Lund.mail;. </para>
+
+<para
+>Prawa autorskie do dokumentacji (c) 2001 &Anders.Lund; &Anders.Lund.mail; </para>
+
+<para
+>Krzysztof Woźniak <email
+>wozniakk@ceti.pl</email
+></para
+>
+&underGPL; </sect1>
+</chapter>
+
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+End:
+-->
+
diff --git a/tde-i18n-pl/docs/kdeaddons/kate-plugins/openheader.docbook b/tde-i18n-pl/docs/kdeaddons/kate-plugins/openheader.docbook
new file mode 100644
index 00000000000..c56102d572f
--- /dev/null
+++ b/tde-i18n-pl/docs/kdeaddons/kate-plugins/openheader.docbook
@@ -0,0 +1,61 @@
+<chapter id="openheader">
+<chapterinfo>
+
+<title
+>Kate - otwarcie pliku nagłówkowego</title>
+
+<!--
+<authorgroup>
+<author>
+<firstname
+> </firstname>
+<surname
+> </surname>
+<affiliation>
+<address
+><email
+> </email
+></address>
+</affiliation>
+</author>
+</authorgroup>
+<date
+>2001-05-15</date>
+<releaseinfo
+>1.00.00</releaseinfo>
+<abstract>
+<para>
+Note about open header
+</para>
+</abstract>
+-->
+<keywordset>
+<keyword
+>KDE</keyword>
+<keyword
+>kate</keyword>
+<keyword
+>plik nagłówkowy</keyword>
+</keywordset>
+</chapterinfo>
+
+<title
+>Wprowadzenie</title>
+
+<para
+>Wtyczka Kate <quote
+>Otwarcie pliku nagłówkowego</quote
+> w chwili obecnej nie posiada dokumentacji. Jeżeli jesteś zainteresowany/a poprawieniem tej sytuacji proszę się skontaktować z Lauri Watts <email
+>lauri@kde.org</email
+> która jest koordynatorem zespołu odpowiedzialnego za dokumentację dla środowiska &kde;. </para>
+
+</chapter>
+
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+End:
+-->
+
diff --git a/tde-i18n-pl/docs/kdeaddons/kate-plugins/textfilter.docbook b/tde-i18n-pl/docs/kdeaddons/kate-plugins/textfilter.docbook
new file mode 100644
index 00000000000..5319934d395
--- /dev/null
+++ b/tde-i18n-pl/docs/kdeaddons/kate-plugins/textfilter.docbook
@@ -0,0 +1,63 @@
+<chapter id="textfilter">
+<chapterinfo>
+
+<title
+>Kate - Filtr tekstu</title>
+
+<!--
+<authorgroup>
+<author>
+<firstname
+> </firstname>
+<surname
+> </surname>
+<affiliation>
+<address
+><email
+> </email
+></address>
+</affiliation>
+</author>
+</authorgroup>
+<date
+>2001-05-15</date>
+<releaseinfo
+>1.00.00</releaseinfo>
+<abstract>
+<para>
+Note about text filter plugin
+</para>
+</abstract>
+-->
+<keywordset>
+<keyword
+>KDE</keyword>
+<keyword
+>kate</keyword>
+<keyword
+>tekst</keyword>
+<keyword
+>filtr</keyword>
+</keywordset>
+</chapterinfo>
+
+<title
+>Wprowadzenie</title>
+
+<para
+>Wtyczka Kate <quote
+>Filtr tekstu</quote
+> w chwili obecnej nie posiada dokumentacji. Jeżeli jesteś zainteresowany/a poprawieniem tej sytuacji proszę się skontaktować z Lauri Watts <email
+>lauri@kde.org</email
+> która jest koordynatorem zespołu odpowiedzialnego za dokumentację dla środowiska &kde;. </para>
+
+</chapter>
+
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+End:
+-->
+
diff --git a/tde-i18n-pl/docs/kdeaddons/kate-plugins/xmlcheck.docbook b/tde-i18n-pl/docs/kdeaddons/kate-plugins/xmlcheck.docbook
new file mode 100644
index 00000000000..219cb82d223
--- /dev/null
+++ b/tde-i18n-pl/docs/kdeaddons/kate-plugins/xmlcheck.docbook
@@ -0,0 +1,152 @@
+<chapter id="xmlcheck">
+<chapterinfo>
+
+<title
+>Sprawdzanie poprawności XML-a</title>
+
+<authorgroup>
+<author
+><firstname
+>Daniel</firstname
+> <surname
+>Naber</surname
+> <affiliation
+> <address
+>&Daniel.Naber.mail;</address>
+</affiliation>
+</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>
+<date
+>2006-05-17</date
+> <releaseinfo
+>3.5.2</releaseinfo
+> <abstract
+> <para
+>Ta wtyczka sprawdza poprawność składni edytowanych plików XML.</para>
+
+</abstract>
+<keywordset>
+<keyword
+>KDE</keyword>
+<keyword
+>kate</keyword>
+<keyword
+>xml</keyword>
+<keyword
+>DTD</keyword>
+</keywordset>
+</chapterinfo>
+
+<title
+>Wprowadzanie</title>
+
+<para
+>Wtyczka sprawdza poprawność bieżącego dokumentu. Lista ostrzeżeń i błędów pojawi się dolnej części głównego okna &kate;. Kliknięcie na wybrany komunikat błędu spowoduje przeskok do odpowiadającej mu linii dokumentu. Jeżeli dany plik posiada zdefiniowany parametr <quote
+>DOCTYPE</quote
+> to do sprawdzania poprawności będzie użyty odpowiadający mu plik szablonu DTD. Poszukiwanie pliku DTD jest przeprowadzane względem katalogu w którym znajduje się bieżący dokument. Jeżeli np. szablon odnosi się do rodzaju dokumentu XML: <quote
+>DTD/xhtml1-transitional.dtd</quote
+> a edytowanym plikiem jest <filename
+>/home/peter/test.xml</filename
+> to szablon DTD powinien być umieszczony w katalogu <filename
+>/home/peter/DTD/xhtml1-transitional.dtd</filename
+>. Obsługiwane są również zdalne szablony DTD, do którym można się odwoływać poprzez http.</para>
+
+<para
+>Jeżeli dla danego pliku nie znaleziono definicji składni 'doctype' to będzie on sprawdzany jedynie pod kątem formalnym.</para>
+
+<para
+>Więcej informacji na temat &XML; znajduje się na <ulink url="http://www.w3.org/XML/"
+> oficjalnych stronach W3C &XML;</ulink
+>.</para>
+
+<para
+>Wtyczka wykorzystuje polecenie <command
+>xmllint</command
+>, będące częścią pakietu libxml2. Jeżeli polecenie to nie jest poprawnie zainstalowane w systemie to wtyczka nie będzie działać.</para>
+
+<note
+><para
+>Program w czasie działania tworzy plik tymczasowy w tym samym katalogu co plik dokumentu. Konieczne jest więc zapewnienie odpowiednich uprawnień zapisu w tym katalogu.</para
+></note>
+
+<para
+>Włączenie wtyczki odbywa się w oknie konfiguracyjnym &kate; wywoływanym przez menu <menuchoice
+><guimenu
+>Ustawienia</guimenu
+> <guimenuitem
+>Konfiguracja &kate;...</guimenuitem
+></menuchoice
+>. Należy wybrać pozycję <guilabel
+>Sprawdzanie poprawności XML-a</guilabel
+> znajdującą się w karcie <guilabel
+>Program</guilabel
+>/<guilabel
+>Wtyczki</guilabel
+>. </para>
+
+<sect1 id="xmlcheck-menu">
+<title
+>Pozycje menu</title>
+
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice
+><guimenu
+>XML</guimenu
+> <guimenuitem
+>Waliduj XML</guimenuitem
+> </menuchoice>
+</term>
+<listitem
+><para
+>Polecenie to uruchomi opisywaną wcześniej procedurę sprawdzania dokumentu.</para
+></listitem>
+</varlistentry>
+</variablelist>
+
+</sect1>
+
+<sect1 id="xmlcheck-thanks-and-acknowledgements">
+<title
+>Podziękowania i zasługi</title>
+
+<para
+>Wtyczka &kate; <quote
+>Sprawdzanie poprawności XML'a</quote
+>. Prawa autorskie (c) 2002 &Daniel.Naber; &Daniel.Naber.mail;. </para>
+
+<para
+>Prawa autorskie do dokumentacji (c) 2002 &Daniel.Naber; </para>
+
+<para
+>Krzysztof Woźniak <email
+>wozniakk@ceti.pl</email
+></para
+>
+&underGPL; </sect1>
+</chapter>
+
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+End:
+-->
+
diff --git a/tde-i18n-pl/docs/kdeaddons/kate-plugins/xmltools.docbook b/tde-i18n-pl/docs/kdeaddons/kate-plugins/xmltools.docbook
new file mode 100644
index 00000000000..a5524c57bba
--- /dev/null
+++ b/tde-i18n-pl/docs/kdeaddons/kate-plugins/xmltools.docbook
@@ -0,0 +1,242 @@
+<chapter id="xmltools">
+<chapterinfo>
+
+<title
+>Dopełnianie tekstu w XML</title>
+
+<authorgroup>
+<author
+><firstname
+>Daniel</firstname
+> <surname
+>Naber</surname
+> <affiliation
+> <address
+>&Daniel.Naber.mail;</address>
+</affiliation>
+</author>
+</authorgroup
+> <date
+>2006-05-17</date
+> <releaseinfo
+>3.5.2</releaseinfo
+> <abstract
+> <para
+>Wtyczka ta wspomaga tworzenie plików XML poprzez wyświetlanie dopuszczalnych tagów. Zawiera również inne narzędzia.</para>
+
+</abstract>
+<keywordset>
+<keyword
+>KDE</keyword>
+<keyword
+>kate</keyword>
+<keyword
+>xml</keyword>
+</keywordset>
+</chapterinfo>
+
+<title
+>Wprowadzenie</title>
+
+<para
+>Wtyczka ta powoduje wyświetlanie podpowiedzi o dostępnych w danej pozycji edytowanego pliku &XML; elementach, zgodnie z określonym dla tego pliku szablonem DTD. Wyświetlana będzie lista elementów, atrybutów, wartości atrybutów lub encji, w zależności od pozycji kursora (np. wszystkie encje będą wyświetlone jeżeli znakiem na lewo od kursora jest<quote
+>&amp;</quote
+>). Jedną z funkcji jest także zamykanie najbliższego, znajdującego się po lewej stronie kursora, otwartego znacznika.</para>
+
+<para
+>Szablon dokumentu XML <acronym
+>DTD</acronym
+> musi istnieć i być określony w formacie generowanym przez polecenie Perla <command
+>dtdparse</command
+>. Szablon w tym formacie jest nazywany <quote
+>meta szablonem DTD</quote
+>. Wraz z wtyczką zainstalowane jest kilka meta szablonów DTD w katalogu: <filename class="directory"
+>$KDEDIR/share/apps/katexmltools/</filename
+>, który jest katalogiem domyślnym przy wywoływaniu funkcji <guimenuitem
+>Przyporządkuj Meta DTD...</guimenuitem
+>. Aby stworzyć własne meta szablony DTD należy skorzystać z programu <command
+>dtdparse</command
+> dostępnego na stronach: <ulink url="http://dtdparse.sourceforge.net"
+>http://dtdparse.sourceforge.net</ulink
+>.</para>
+
+<sect1 id="xmltools-how-to-use">
+<title
+>Jak korzystać z wtyczki</title>
+
+<para
+>Należy uruchomić program &kate; i otworzyć okno dialogowe konfiguracji za pomocą menu <menuchoice
+><guimenu
+>Ustawienia</guimenu
+> <guimenuitem
+>Konfiguracja &kate;...</guimenuitem
+></menuchoice
+>. Następnie należy zaznaczyć opcję <guilabel
+>Uzupełnianie składni XML </guilabel
+> znajdującą się w karcie <guilabel
+>Program</guilabel
+>/<guilabel
+>Wtyczki</guilabel
+>. Po włączeniu wtyczki i zamknięciu okna, należy wybrać z menu pozycję <menuchoice
+><guimenu
+>XML</guimenu
+><guimenuitem
+>Przyporządkuj Meta DTD...</guimenuitem
+></menuchoice
+>. Jeżeli edytowany dokument nie posiada elementu <quote
+>DOCTYPE</quote
+> lub jeżeli jest on nieznany to należy wskazać meta szablon DTD znajdujący się na dysku. W przeciwnym wypadku zostanie automatycznie załadowany meta szablon DTD odpowiadający elementowi DOCTYPE bieżącego dokumentu.</para>
+
+<para
+>Od tego momentu można już korzystać z wtyczki podczas edycji naciskając następujące klawisze:</para>
+
+<variablelist>
+
+<varlistentry>
+<term
+>&lt; (znak mniejszości)</term>
+<listitem
+><para
+>Wyświetli listę dostępnych elementów (tagów). Klawisz działa tylko jeżeli kursor znajduje się poza znacznikiem. Należy zauważyć iż nie można użyć tego klawisze do wstawiania elementów najwyższego poziomu ( jak np.: <quote
+>&lt;html&gt;</quote
+>).</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+>" (cudzysłów)</term>
+<listitem
+><para
+>Klawisz wyświetli listę dostępnych wartości atrybutów (jeżeli występują). Klawisz działa jeżeli kursor znajduje się wewnątrz znacznika.</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+>(spacja)</term>
+<listitem
+><para
+>Naciśnięcie tego klawisza wyświetli listę dostępnych atrybutów dla bieżącego elementu. Klawisz działa jeżeli kursor znajduje się wewnątrz znacznika.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+>&amp;</term>
+<listitem
+><para
+>Klawisz wywoła listę dostępnych encji.</para
+></listitem>
+</varlistentry>
+</variablelist>
+
+</sect1>
+
+<sect1 id="xmltools-features-and-limitations">
+<title
+>Możliwości i ograniczenia</title>
+
+<para
+>Użytkownik może przetestować wszystkie funkcje i ograniczenia wtyczki wczytując plik <filename
+>$KDEDIR/share/apps/katexmltools/testcases.xml</filename
+> i postępując zgodnie z zawartymi tam instrukcjami. Należy zaznaczyć iż praca z kilkoma widokami tego samego dokumentu nie jest jeszcze poprawnie obsługiwana przez tą wtyczkę.</para>
+
+</sect1>
+
+
+<sect1 id="xmltools-menu">
+<title
+>Pozycje menu</title>
+
+<variablelist>
+<varlistentry>
+<term>
+<menuchoice
+><shortcut
+> <keycombo action="simul"
+>&Ctrl;<keycap
+>Return</keycap
+></keycombo
+> </shortcut
+> <guimenu
+>XML</guimenu
+> <guimenuitem
+>Wstaw element...</guimenuitem
+> </menuchoice>
+</term>
+<listitem
+><para
+>Otwiera okno dialogowe pozwalające na wstawienie znacznika &XML;. Znaki &lt;, &gt; oraz znacznik zamykający będą dołączone automatycznie. Jeżeli przed wybraniem tej opcji w dokumencie był zaznaczony fragment tekstu, to zostanie on umieszczony pomiędzy znacznikiem otwierającym i zamykającym. W oknie dialogowym działa również funkcja autouzupełniania nazw znaczników oraz elementów, które można umieścić w bieżącej pozycji kursora zgodnie ze zdefiniowanym za pomocą<guimenuitem
+>Przyporządkuj Meta DTD...</guimenuitem
+> meta szablonem DTD. </para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice
+><shortcut
+> <keycombo action="simul"
+>&Ctrl;<keycap
+>&lt;</keycap
+></keycombo
+> </shortcut
+> <guimenu
+>XML</guimenu
+> <guimenuitem
+>Zamknij element</guimenuitem
+> </menuchoice>
+</term>
+<listitem
+><para
+>Spowoduje przeszukanie dokumentu w poszukiwaniu znacznika, który jeszcze nie został zamknięty i zamknięcie go poprzez wstawienie odpowiedniego znacznika zamykającego. Poszukiwanie rozpoczyna się od pozycji kursora w lewą stronę. Jeżeli żaden otwarty znacznik nie zostanie znaleziony to nic nie zostanie wstawione.</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<menuchoice
+><guimenu
+>XML</guimenu
+> <guimenuitem
+>Przyporządkuj Meta DTD...</guimenuitem
+> </menuchoice>
+</term>
+<listitem
+><para
+>Pozwala na wskazanie pliku DTD, który powinien zostać użyty dla bieżącego dokumentu. Przyporządkowanie to nie zostanie zapisane, należy je ponowić przy każdym następnym uruchomieniu &kate;.</para
+></listitem>
+</varlistentry>
+</variablelist>
+
+</sect1>
+
+<sect1 id="xmltools-thanks-and-acknowledgements">
+<title
+>Podziękowania i zasługi</title>
+
+<para
+>Wtyczka &kate; <quote
+>Uzupełnianie składni XML</quote
+>. Prawa autorskie (c) 2001,2002 &Daniel.Naber; &Daniel.Naber.mail;. </para>
+
+<para
+>Prawa autorskie do dokumentacji (c) 2001,2002 &Daniel.Naber; </para>
+
+<para
+>Krzysztof Woźniak <email
+>wozniakk@ceti.pl</email
+></para
+>
+&underGPL; </sect1>
+</chapter>
+
+<!--
+Local Variables:
+mode: sgml
+sgml-omittag: nil
+sgml-shorttag: t
+End:
+-->
+