diff options
Diffstat (limited to 'tde-i18n-sv/docs/kdebase/kate')
18 files changed, 13625 insertions, 0 deletions
diff --git a/tde-i18n-sv/docs/kdebase/kate/Makefile.am b/tde-i18n-sv/docs/kdebase/kate/Makefile.am new file mode 100644 index 00000000000..62a50c8100b --- /dev/null +++ b/tde-i18n-sv/docs/kdebase/kate/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = sv +SUBDIRS = $(AUTODIRS) +KDE_DOCS = kate +KDE_MANS = AUTO diff --git a/tde-i18n-sv/docs/kdebase/kate/Makefile.in b/tde-i18n-sv/docs/kdebase/kate/Makefile.in new file mode 100644 index 00000000000..ddd12fad7c3 --- /dev/null +++ b/tde-i18n-sv/docs/kdebase/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/kdebase/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@ +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 = sv +#>- 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/kdebase/kate/Makefile'; \ +#>- cd $(top_srcdir) && \ +#>- $(AUTOMAKE) --gnu docs/kdebase/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/kdebase/kate/Makefile'; \ + cd $(top_srcdir) && \ + $(AUTOMAKE) --gnu docs/kdebase/kate/Makefile + cd $(top_srcdir) && perl ../scripts/admin/am_edit -p../scripts/admin docs/kdebase/kate/Makefile.in +.PRECIOUS: Makefile +Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status + @case '$?' in \ + *config.status*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ + *) \ + echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ + esac; + +$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +$(top_srcdir)/configure: $(am__configure_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(ACLOCAL_M4): $(am__aclocal_m4_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +# This directory's subdirectories are mostly independent; you can cd +# into them and run `make' without going through this Makefile. +# To change the values of `make' variables: instead of editing Makefiles, +# (1) if the variable is set in `config.status', edit `config.status' +# (which will cause the Makefiles to be regenerated when you run `make'); +# (2) otherwise, pass the desired values on the `make' command line. +$(RECURSIVE_TARGETS): + @failcom='exit 1'; \ + for f in x $$MAKEFLAGS; do \ + case $$f in \ + *=* | --[!k]*);; \ + *k*) failcom='fail=yes';; \ + esac; \ + done; \ + dot_seen=no; \ + target=`echo $@ | sed s/-recursive//`; \ + list='$(SUBDIRS)'; for subdir in $$list; do \ + echo "Making $$target in $$subdir"; \ + if test "$$subdir" = "."; then \ + dot_seen=yes; \ + local_target="$$target-am"; \ + else \ + local_target="$$target"; \ + fi; \ + (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \ + || eval $$failcom; \ + done; \ + if test "$$dot_seen" = "no"; then \ + $(MAKE) $(AM_MAKEFLAGS) "$$target-am" || exit 1; \ + fi; test -z "$$fail" + +$(RECURSIVE_CLEAN_TARGETS): + @failcom='exit 1'; \ + for f in x $$MAKEFLAGS; do \ + case $$f in \ + *=* | --[!k]*);; \ + *k*) failcom='fail=yes';; \ + esac; \ + done; \ + dot_seen=no; \ + case "$@" in \ + distclean-* | maintainer-clean-*) list='$(DIST_SUBDIRS)' ;; \ + *) list='$(SUBDIRS)' ;; \ + esac; \ + rev=''; for subdir in $$list; do \ + if test "$$subdir" = "."; then :; else \ + rev="$$subdir $$rev"; \ + fi; \ + done; \ + rev="$$rev ."; \ + target=`echo $@ | sed s/-recursive//`; \ + for subdir in $$rev; do \ + echo "Making $$target in $$subdir"; \ + if test "$$subdir" = "."; then \ + local_target="$$target-am"; \ + else \ + local_target="$$target"; \ + fi; \ + (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \ + || eval $$failcom; \ + done && test -z "$$fail" +tags-recursive: + list='$(SUBDIRS)'; for subdir in $$list; do \ + test "$$subdir" = . || (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) tags); \ + done +ctags-recursive: + list='$(SUBDIRS)'; for subdir in $$list; do \ + test "$$subdir" = . || (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) ctags); \ + done + +ID: $(HEADERS) $(SOURCES) $(LISP) $(TAGS_FILES) + list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ + unique=`for i in $$list; do \ + if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ + done | \ + $(AWK) '{ files[$$0] = 1; nonemtpy = 1; } \ + END { if (nonempty) { for (i in files) print i; }; }'`; \ + mkid -fID $$unique +tags: TAGS + +TAGS: tags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ + $(TAGS_FILES) $(LISP) + tags=; \ + here=`pwd`; \ + if ($(ETAGS) --etags-include --version) >/dev/null 2>&1; then \ + include_option=--etags-include; \ + empty_fix=.; \ + else \ + include_option=--include; \ + empty_fix=; \ + fi; \ + list='$(SUBDIRS)'; for subdir in $$list; do \ + if test "$$subdir" = .; then :; else \ + test ! -f $$subdir/TAGS || \ + tags="$$tags $$include_option=$$here/$$subdir/TAGS"; \ + fi; \ + done; \ + list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ + unique=`for i in $$list; do \ + if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ + done | \ + $(AWK) '{ files[$$0] = 1; nonempty = 1; } \ + END { if (nonempty) { for (i in files) print i; }; }'`; \ + if test -z "$(ETAGS_ARGS)$$tags$$unique"; then :; else \ + test -n "$$unique" || unique=$$empty_fix; \ + $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \ + $$tags $$unique; \ + fi +ctags: CTAGS +CTAGS: ctags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ + $(TAGS_FILES) $(LISP) + tags=; \ + list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ + unique=`for i in $$list; do \ + if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ + done | \ + $(AWK) '{ files[$$0] = 1; nonempty = 1; } \ + END { if (nonempty) { for (i in files) print i; }; }'`; \ + test -z "$(CTAGS_ARGS)$$tags$$unique" \ + || $(CTAGS) $(CTAGSFLAGS) $(AM_CTAGSFLAGS) $(CTAGS_ARGS) \ + $$tags $$unique + +GTAGS: + here=`$(am__cd) $(top_builddir) && pwd` \ + && cd $(top_srcdir) \ + && gtags -i $(GTAGS_ARGS) $$here + +distclean-tags: + -rm -f TAGS ID GTAGS GRTAGS GSYMS GPATH tags + +#>- distdir: $(DISTFILES) +#>+ 1 +distdir: distdir-nls $(DISTFILES) + @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + list='$(DISTFILES)'; \ + dist_files=`for file in $$list; do echo $$file; done | \ + sed -e "s|^$$srcdirstrip/||;t" \ + -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \ + case $$dist_files in \ + */*) $(MKDIR_P) `echo "$$dist_files" | \ + sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \ + sort -u` ;; \ + esac; \ + for file in $$dist_files; do \ + if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ + if test -d $$d/$$file; then \ + dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \ + if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ + cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \ + fi; \ + cp -pR $$d/$$file $(distdir)$$dir || exit 1; \ + else \ + test -f $(distdir)/$$file \ + || cp -p $$d/$$file $(distdir)/$$file \ + || exit 1; \ + fi; \ + done + list='$(DIST_SUBDIRS)'; for subdir in $$list; do \ + if test "$$subdir" = .; then :; else \ + test -d "$(distdir)/$$subdir" \ + || $(MKDIR_P) "$(distdir)/$$subdir" \ + || exit 1; \ + distdir=`$(am__cd) $(distdir) && pwd`; \ + top_distdir=`$(am__cd) $(top_distdir) && pwd`; \ + (cd $$subdir && \ + $(MAKE) $(AM_MAKEFLAGS) \ + top_distdir="$$top_distdir" \ + distdir="$$distdir/$$subdir" \ + am__remove_distdir=: \ + am__skip_length_check=: \ + distdir) \ + || exit 1; \ + fi; \ + done +check-am: all-am +check: check-recursive +all-am: Makefile +installdirs: installdirs-recursive +installdirs-am: +install: install-recursive +install-exec: install-exec-recursive +install-data: install-data-recursive +#>- uninstall: uninstall-recursive +#>+ 1 +uninstall: uninstall-docs uninstall-nls uninstall-recursive + +install-am: all-am + @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am + +installcheck: installcheck-recursive +install-strip: + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + `test -z '$(STRIP)' || \ + echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install +mostlyclean-generic: + +clean-generic: + +distclean-generic: + -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + +maintainer-clean-generic: + @echo "This command is intended for maintainers to use" + @echo "it deletes files that may require special tools to rebuild." +#>- clean: clean-recursive +#>+ 1 +clean: kde-rpo-clean clean-recursive + +#>- clean-am: clean-generic mostlyclean-am +#>+ 1 +clean-am: clean-docs clean-bcheck clean-generic mostlyclean-am + +distclean: distclean-recursive + -rm -f Makefile +distclean-am: clean-am distclean-generic distclean-tags + +dvi: dvi-recursive + +dvi-am: + +html: html-recursive + +info: info-recursive + +info-am: + +#>- install-data-am: +#>+ 1 +install-data-am: install-docs install-nls + +install-dvi: install-dvi-recursive + +install-exec-am: + +install-html: install-html-recursive + +install-info: install-info-recursive + +install-man: + +install-pdf: install-pdf-recursive + +install-ps: install-ps-recursive + +installcheck-am: + +maintainer-clean: maintainer-clean-recursive + -rm -f Makefile +maintainer-clean-am: distclean-am maintainer-clean-generic + +mostlyclean: mostlyclean-recursive + +mostlyclean-am: mostlyclean-generic + +pdf: pdf-recursive + +pdf-am: + +ps: ps-recursive + +ps-am: + +uninstall-am: + +.MAKE: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) install-am \ + install-strip + +.PHONY: $(RECURSIVE_CLEAN_TARGETS) $(RECURSIVE_TARGETS) CTAGS GTAGS \ + all all-am check check-am clean clean-generic ctags \ + ctags-recursive distclean distclean-generic distclean-tags \ + distdir dvi dvi-am html html-am info info-am install \ + install-am install-data install-data-am install-dvi \ + install-dvi-am install-exec install-exec-am install-html \ + install-html-am install-info install-info-am install-man \ + install-pdf install-pdf-am install-ps install-ps-am \ + install-strip installcheck installcheck-am installdirs \ + installdirs-am maintainer-clean maintainer-clean-generic \ + mostlyclean mostlyclean-generic pdf pdf-am ps ps-am tags \ + tags-recursive uninstall uninstall-am + +# Tell versions [3.59,3.63) of GNU make to not export all variables. +# Otherwise a system limit (for SysV at least) may be exceeded. +.NOEXPORT: + +#>+ 2 +KDE_DIST=fundamentals.docbook configuring.docbook Makefile.in man-kate.1.docbook plugins.docbook index.docbook part.docbook highlighting.docbook menus.docbook configdialog01.png advanced.docbook regular-expressions.docbook 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 man-kate.1.docbook configdialog01.png part.docbook mdi.docbook index.docbook menus.docbook kate.png advanced.docbook mimetypechooser.png fundamentals.docbook configuring.docbook plugins.docbook highlighting.docbook + @if test -n "$(MEINPROC)"; then echo $(MEINPROC) --check --cache index.cache.bz2 $(srcdir)/index.docbook; $(MEINPROC) --check --cache index.cache.bz2 $(srcdir)/index.docbook; fi + +docs-am: index.cache.bz2 + +install-docs: docs-am install-nls + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate + @if test -f index.cache.bz2; then \ + echo $(INSTALL_DATA) index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/; \ + $(INSTALL_DATA) index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/; \ + elif test -f $(srcdir)/index.cache.bz2; then \ + echo $(INSTALL_DATA) $(srcdir)/index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/; \ + $(INSTALL_DATA) $(srcdir)/index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/; \ + fi + -rm -f $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/common + $(LN_S) $(kde_libs_htmldir)/$(KDE_LANG)/common $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/common + +uninstall-docs: + -rm -rf $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate + +clean-docs: + -rm -f index.cache.bz2 + + +#>+ 13 +install-nls: + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate + @for base in configdialog02.png regular-expressions.docbook man-kate.1.docbook configdialog01.png part.docbook mdi.docbook index.docbook menus.docbook kate.png advanced.docbook mimetypechooser.png fundamentals.docbook configuring.docbook plugins.docbook highlighting.docbook ; do \ + echo $(INSTALL_DATA) $$base $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/$$base ;\ + $(INSTALL_DATA) $(srcdir)/$$base $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/$$base ;\ + done + +uninstall-nls: + for base in configdialog02.png regular-expressions.docbook man-kate.1.docbook configdialog01.png part.docbook mdi.docbook index.docbook menus.docbook kate.png advanced.docbook mimetypechooser.png fundamentals.docbook configuring.docbook plugins.docbook highlighting.docbook ; do \ + rm -f $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/kate/$$base ;\ + done + + +#>+ 5 +distdir-nls: + for file in configdialog02.png regular-expressions.docbook man-kate.1.docbook configdialog01.png part.docbook mdi.docbook index.docbook menus.docbook kate.png advanced.docbook mimetypechooser.png fundamentals.docbook configuring.docbook plugins.docbook highlighting.docbook ; do \ + cp $(srcdir)/$$file $(distdir); \ + done + +#>+ 15 +force-reedit: + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \ + && exit 0; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu docs/kdebase/kate/Makefile'; \ + cd $(top_srcdir) && \ + $(AUTOMAKE) --gnu docs/kdebase/kate/Makefile + cd $(top_srcdir) && perl ../scripts/admin/am_edit -p../scripts/admin docs/kdebase/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-sv/docs/kdebase/kate/advanced.docbook b/tde-i18n-sv/docs/kdebase/kate/advanced.docbook new file mode 100644 index 00000000000..3e6f209129e --- /dev/null +++ b/tde-i18n-sv/docs/kdebase/kate/advanced.docbook @@ -0,0 +1,2324 @@ +<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 +>Johan</firstname +> <surname +>Thelmén</surname +> <affiliation +><address +><email +>jth@home.se</email +></address +></affiliation +> <contrib +>Översättare</contrib +></othercredit +> +</authorgroup> +</chapterinfo> +<title +>Avancerade redigeringsverktyg</title> + +<sect1 id="advanced-editing-tools-comment"> + +<title +>Kommentera/avkommentera</title> + +<para +>Kommandona kommentera och avkommentera, som är tillgängliga i menyn <guimenu +>Verktyg</guimenu +>, låter dig lägga till eller ta bort kommentarmarkeringar i den markerade texten, eller den nuvarande raden, om ingen text är markerad, om kommentarer stöds av textformatet som du redigerar.</para> + +<para +>Reglerna för hur kommentarer ser ut definieras av syntaxdefinitionerna, så om syntaxfärgläggning inte används, så är det inte möjligt att kommentera eller avkommentera. </para> + +<para +>Vissa format definierar kommentarmarkeringar för enstaka rader, vissa för flera rader och vissa både ock. Om kommentarmarkeringar för flera rader inte är tillgängliga, så är det inte möjligt att kommentera en markering där den sista raden inte ingår helt och hållet.</para> + +<para +>Om det finns en kommentarmarkering för enstaka rader, så föredras kommentarer för enstaka rader när det är möjligt, eftersom detta hjälper till att undvika problem med nästlade kommentarer.</para> + +<para +>När kommentarmarkeringar tas bort, så ska inte någon okommenterad text markeras. När kommentarmarkeringar för flera rader tas bort från en markering, så ignoreras eventuella blanktecken utanför kommentarmarkeringen.</para> + +<para +><indexterm +><primary +>kommentera</primary +></indexterm +> För att lägga till kommentarmarkeringar, använd menyalternativet <menuchoice +><guimenu +>Verktyg</guimenu +><guimenuitem +>Kommentera</guimenuitem +></menuchoice +> eller motsvarande snabbtangent, som normalt är <keycombo action="simul" +>&Ctrl;<keycap +>D</keycap +></keycombo +>.</para> + +<para +><indexterm +><primary +>avkommentera</primary +></indexterm +> För att ta bort kommentarmarkeringar, använd menyalternativet <menuchoice +><guimenu +>Verktyg</guimenu +><guimenuitem +>Avkommentera</guimenuitem +></menuchoice +> eller motsvarande snabbtangent, som normalt är <keycombo action="simul" +>&Ctrl; <keycap +>Skift</keycap +> <keycap +>D</keycap +></keycombo +>.</para> + +</sect1> + +<sect1 id="advanced-editing-tools-commandline"> +<title +>Editorkomponentens kommandorad</title> + +<para +>Kates editorkomponent har en intern kommandorad, som låter dig utföra vissa åtgärder från ett minimalt grafiskt gränssnitt. Kommandoraden är ett textinmatningsfält längst ner i redigeringsområdet. För att visa den, välj <menuchoice +><guimenu +>Visa</guimenu +> <guimenuitem +>Byt till kommandorad</guimenuitem +></menuchoice +> eller använd snabbtangenten (normalt <keycombo action="simul" +><keycap +>F7</keycap +></keycombo +>). Editorn tillhandahåller en uppsättning kommandon som är dokumenterade nedan, och ytterligare kommandon kan tillhandahållas av insticksprogram.</para> + +<para +>Skriv in kommandot och tryck på returtangenten för att utföra det. Kommandoraden anger om kommandot lyckades och visar kanske ett meddelande. Om du kom till kommandoraden genom att trycka på <keycap +>F7</keycap +> döljs den automatiskt efter några sekunder. För att rensa meddelandet och skriva in ett nytt kommando, tryck på <keycap +>F7</keycap +> igen.</para> + +<para +>Kommandoraden har ett inbyggt hjälpsystem, skriv in kommandot <command +>help</command +> för att komma igång. För att se en lista med alla tillgängliga kommandon, skriv in <command +>help list</command +>. För att visa hjälp om ett visst kommando, skriv <command +>help <replaceable +>kommando</replaceable +></command +>.</para> + +<para +>Kommandoraden har en inbyggd historik, så att du kan återanvända kommandon som redan skrivits in. För att navigera i historiken, använd tangenterna <keycap +>Uppåtpil</keycap +> och <keycap +>Neråtpil</keycap +>. När historikkommandon visas är kommandots argument markerade, vilket låter dig enkelt skriva över argumenten.</para> + +<sect2 id="advanced-editing-tools-commandline-commands"> +<title +>Vanliga kommandon på kommandoraden</title> + +<sect3 id="advanced-editing-tools-commandline-commands-configure"> +<title +>Kommandon för att anpassa editorn</title> + +<para +>Dessa kommandon tillhandahålls av editorkomponenten och låter dig bara anpassa det aktiva dokumentet och vyn. Det är praktiskt om du vill använda en inställning som skiljer sig från den förvalda inställningen, till exempel för indentering. </para> + +<variablelist> +<title +>Argumenttyper</title> + +<varlistentry> +<term +>BOOLESK</term> +<listitem +><para +>Denna används med kommandon som sätter på eller stänger av någonting. Möjliga värden är <userinput +>on</userinput +> (på), <userinput +>off</userinput +> (av), <userinput +>true</userinput +> (sant), <userinput +>false</userinput +> (falskt), <userinput +>1</userinput +> eller <userinput +>0</userinput +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>HELTAL</term> +<listitem +><para +>Ett heltal</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>STRÄNG</term> +<listitem +><para +>En sträng</para +></listitem> +</varlistentry> + +</variablelist> + +<variablelist> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-tab-width</command +><arg +>HELTAL bredd</arg +></cmdsynopsis +></term> +<listitem +><para +>Ställer in tabulatorbredden till talet <userinput +>bredd</userinput +></para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-indent-width</command +><arg +>HELTAL bredd</arg +></cmdsynopsis +></term> +<listitem +><para +>Ställer in indenteringsbredden till talet <userinput +>bredd</userinput +>. Används bara om du indenterar med mellanslag.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-word-wrap-column</command +><arg +>HELTAL bredd</arg +></cmdsynopsis +></term> +<listitem +><para +>Ställer in radbredden för hård radbrytning till <userinput +>bredd</userinput +>. Detta används om du använder automatisk radbrytning för din text.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-icon-border</command +><arg +>BOOLESK aktivera</arg +> </cmdsynopsis +></term> +<listitem +><para +>Ställer in synligheten hos ikonkanten.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-folding-markers</command +><arg +>BOOLESK aktivera</arg +></cmdsynopsis +></term> +<listitem +><para +>Ställer in synligheten hos vikmarkörrutan.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-line-numbers</command +><arg +>BOOLESK aktivera</arg +></cmdsynopsis +></term> +<listitem +><para +>Ställer in synligheten hos radnummerrutan.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-replace-tabs</command +><arg +>BOOLESK aktivera</arg +></cmdsynopsis +></term> +<listitem +><para +>Om aktiverad, ersätts tabulatortecken med mellanslag medan du skriver. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-remove-trailing-space</command +><arg +>BOOLESK aktivera</arg +></cmdsynopsis +></term> +<listitem +><para +>Om aktiverad, tas avslutande blanktecken bort så fort markören lämnar en rad.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-show-tabs</command +><arg +>BOOLESK aktivera</arg +></cmdsynopsis +></term> +<listitem +><para +>Om aktiverad, synliggörs tabulatortecken och avslutande blanktecken med en liten punkt.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-indent-spaces</command +><arg +>BOOLESK aktivera</arg +></cmdsynopsis +></term> +<listitem +><para +>Om aktiverad, indenterar editorn med <option +>indenteringsbredd</option +> mellanslag för varje indenteringsnivå, istället för ett tabulatortecken.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-mixed-indent</command +><arg +>BOOLESK aktivera</arg +></cmdsynopsis +></term> +<listitem +><para +>Om aktiverad, använder Kate en blandning av tabulatortecken och mellanslag för indentering. Varje indenteringsnivå har bredden <option +>indenteringsbredd</option +>, och fler indenteringsnivåer optimeras så att så många tabulatortecken som möjligt används.</para> +<para +>När det utförs aktiverar kommandot dessutom indentering med mellanslag, och om indenteringsbredden inte anges ställs den in till halva <option +>tabulatorbredden</option +> för dokumentet.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-word-wrap</command +><arg +>BOOLESK aktivera</arg +></cmdsynopsis +></term> +<listitem +><para +>Aktiverar dynamisk radbrytning enligt <userinput +>aktivera</userinput +></para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-replace-tabs-save</command +><arg +>BOOLESK aktivera </arg +></cmdsynopsis +></term> +<listitem +><para +>Om aktiverad, ersätts tabulatortecken med blanktecken så fort dokumentet sparas.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-remove-trailing-space-save</command +><arg +>BOOLESK aktivera</arg +></cmdsynopsis +></term> +<listitem +><para +>Om aktiverad, tas avslutande mellanslag bort från alla rader så fort dokumentet sparas.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-indent-mode</command +><arg +>namn</arg +></cmdsynopsis +></term> +<listitem +><para +>Ställer in automatiskt indenteringsläge till <userinput +>namn</userinput +>. Om <userinput +>namn</userinput +> inte känns igen, ställs läget in till 'none'. Giltiga lägen är 'cstyle', 'csands', 'xml', 'python', 'varindent' och 'none'.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>set-highlight</command +><arg +>färgläggning</arg +></cmdsynopsis +></term> +<listitem +><para +>Ställer in dokumentets syntaxfärgläggningssystem. Argumentet måste vara ett giltigt färgläggningsnamn, som visas i menyn <menuchoice +><guimenu +>Verktyg</guimenu +> <guisubmenu +>Färgläggning</guisubmenu +></menuchoice +>. Kommandot tillhandahåller en lista för automatisk komplettering av dess argument.</para +></listitem> +</varlistentry> + +</variablelist> + +</sect3> + +<sect3 id="advanced-editing-tools-commandline-commands-edit"> +<title +>Kommandon för redigering</title> + +<para +>Dessa kommandon ändrar aktuellt dokument.</para> + +<variablelist> +<varlistentry> +<term +><cmdsynopsis +><command +>indent</command +></cmdsynopsis +></term> +<listitem +><para +>Indenterar de markerade raderna eller den nuvarande raden.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>unindent</command +></cmdsynopsis +></term> +<listitem +><para +>Avindenterar markerade rader eller nuvarande rad.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>cleanindent</command +></cmdsynopsis +></term> +<listitem +><para +>Rensar indenteringen för markerade rader eller nuvarande rad enligt dokumentets indenteringsinställningar. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>comment</command +></cmdsynopsis +></term> +<listitem +><para +>Infogar kommentarmarkeringar för att göra markeringen, markerade rader eller nuvarande rad en kommentar enligt textformatet som definieras av dokumentets syntaxfärgläggningsdefinition.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>uncomment</command +></cmdsynopsis +></term> +<listitem +><para +>Tar bort kommentarmarkeringar från markeringen, markerade rader eller nuvarande rad enligt textformatet som definieras av dokumentets syntaxfärgläggningsdefinition.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>kill-line</command +></cmdsynopsis +></term> +<listitem +><para +>Tar bort den nuvarande raden.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>replace</command +><arg +>mönster</arg +><arg +>ersättning</arg +></cmdsynopsis +></term> +<listitem +><para +>Ersätter text som matchar <userinput +>mönster</userinput +> med <userinput +>ersättning</userinput +>. Om du vill att <userinput +>mönster</userinput +> ska innehålla blanktecken, måste både <userinput +>mönster</userinput +> och <userinput +>ersättning</userinput +> placeras inom enkla eller dubbla citationstecken. Om argumenten inte är citerade, används det första ordet som <userinput +>mönster</userinput +> och resten som <userinput +>ersättning</userinput +>. Om <userinput +>ersättning</userinput +> är tom, tas varje förekomst av <userinput +>mönster</userinput +> bort.</para> +<para +>Du kan anpassa kommandot genom att lägga till ett kolon följt av en eller flera bokstäver som var och en representerar en inställning, genom att ange <userinput +>replace:alternativ mönster ersättning</userinput +>. Tillgängliga alternativ är: <variablelist> + +<varlistentry> +<term +><userinput +>b</userinput +></term> +<listitem +><para +>Sök bakåt.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>c</userinput +></term> +<listitem +><para +>Sök från markörens position.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>e</userinput +></term> +<listitem +><para +>Sök bara i markeringen.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>r</userinput +></term> +<listitem +><para +>Utför en sökning med ett reguljärt uttryck. Om det anges, kan du använda <userinput +>\N</userinput +>, där N är ett tal, för att representera hittad text i ersättningssträngen.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>s</userinput +></term> +<listitem +><para +>Utför skiftlägeskänslig sökning.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>p</userinput +></term> +<listitem +><para +>Fråga efter tillåtelse att ersätta nästa förekomst.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>w</userinput +></term> +<listitem +><para +>Matcha bara hela ord.</para +></listitem> +</varlistentry> + +</variablelist> + +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>date</command +><arg +>format</arg +></cmdsynopsis +></term> +<listitem +><para +>Infogar en datum- och tidssträng som definieras av angivet <userinput +>format</userinput +>, eller formatet <quote +>yyyy-MM-dd hh:mm:ss</quote +> om inget anges. Följande översättningar görs när <userinput +>format</userinput +> tolkas: <informaltable +> <tgroup cols="2" +> <tbody> +<row +><entry +><literal +>d</literal +></entry +><entry +>Dagen som ett tal utan inledande nolla (1-31).</entry +></row> +<row +><entry +><literal +>dd</literal +></entry +><entry +>Dagen som ett tal med inledande nolla (01-31).</entry +></row> +<row +><entry +><literal +>ddd</literal +></entry +><entry +>Dagens förkortade lokala namn (t.ex. 'mån', 'sön').</entry +></row> +<row +><entry +><literal +>dddd</literal +></entry +><entry +>Dagens långa lokala namn (t.ex. 'måndag', 'söndag').</entry +></row> +<row +><entry +><literal +>M</literal +></entry +><entry +>Månaden som ett tal utan inledande nolla (1-12).</entry +></row> +<row +><entry +><literal +>MM</literal +></entry +><entry +>Månaden som ett tal med inledande nolla (01-12).</entry +></row> +<row +><entry +><literal +>MMM</literal +></entry +><entry +>Månadens förkortade lokala namn (t.ex. 'jan', 'dec').</entry +></row> +<row +><entry +><literal +>yy</literal +></entry +><entry +>Året som ett tal med två siffror (00-99).</entry +></row> +<row +><entry +><literal +>yyyy</literal +></entry +><entry +>Året som ett tal med fyra siffror (1752-8000)</entry +></row> +<row +><entry +><literal +>h</literal +></entry +><entry +>Timman utan inledande nolla (0-23 eller 1-12 om FM/EM visas).</entry +></row> +<row +><entry +><literal +>hh</literal +></entry +><entry +>Timman med inledande nolla (00-23 eller 01-12 om FM/EM visas).</entry +></row> +<row +><entry +><literal +>m</literal +></entry +><entry +>Minuten utan inledande nolla (0-59).</entry +></row> +<row +><entry +><literal +>mm</literal +></entry +><entry +>Minuten med inledande nolla (00-59).</entry +></row> +<row +><entry +><literal +>s</literal +></entry +><entry +>Sekunden utan inledande nolla (0-59).</entry +></row> +<row +><entry +><literal +>ss</literal +></entry +><entry +>Sekunden med inledande nolla (00-59).</entry +></row> +<row +><entry +><literal +>z</literal +></entry +><entry +>Millisekunden utan inledande nolla (0-999).</entry +></row> +<row +><entry +><literal +>zzz</literal +></entry +><entry +>Millisekunden med inledande nolla (000-999).</entry +></row> +<row +><entry +><literal +>AP</literal +></entry +><entry +>Använd FM/EM visning. AP ersätts antingen av "FM" eller "EM".</entry +></row> +<row +><entry +><literal +>ap</literal +></entry +><entry +>Använd fm/em visning. ap ersätts antingen av "fm" eller "em".</entry +></row> + +</tbody> +</tgroup> +</informaltable> + +</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>char</command +><arg +>identifierare</arg +></cmdsynopsis +></term> +<listitem> +<para +>Det här kommandot låter dig infoga enskilda tecken med deras numeriska kod, på decimal, oktal eller hexadecimal form. För att använda det, starta dialogrutan för redigeringskommandot och skriv <userinput +>char: [nummer]</userinput +> i inmatningsrutan, och tryck sedan på <guibutton +>Ok</guibutton +>.</para> + +<example> +<title +>Exempel på användning av <command +>char</command +></title> + +<para +>Inmatning: <userinput +>char:234</userinput +></para> +<para +>Utmatning: <computeroutput +>ê</computeroutput +></para> +<para +>Inmatning: <userinput +>char:0x1234</userinput +></para> +<para +>Utmatning: <computeroutput +>ሴ</computeroutput +></para> +</example> + +</listitem> +</varlistentry> + +<varlistentry> +<term> +<indexterm +><primary +>ersätt, sed-stil</primary> +<secondary +>sök, sed-stil</secondary +></indexterm> +<command +>s///[ig]</command +> <command +>%s///[ig]</command +></term> + +<listitem> +<para +>Det här kommandot söker och ersätter på ett sätt som liknar sed, för den nuvarande raden, eller för hela filen (<command +>%s///</command +>).</para> + +<para +>I kortet, så söks texten igenom efter en text som matchar <emphasis +>sökmönstret</emphasis +>, det reguljära uttrycket mellan det första och andra snedstrecket, och vid en träff så ersätts texten med uttrycket mellan mitten och sista delen av strängen. Parenteser i sökmönstret skapar <emphasis +>bakåtreferenser</emphasis +>, det vill säga kommandot kommer ihåg vilken del av texten som matchade inom parenteserna. De här strängarna kan återanvändas i ersättningsmönstret, med referenserna <userinput +>\1</userinput +>, för första paret parenteser, <userinput +>\2</userinput +> för det andra, och så vidare.</para> + +<para +>För att söka efter tecknen <literal +>(</literal +> eller <literal +>)</literal +>, måste du <emphasis +>undanta</emphasis +> dem med ett bakstreckstecken <userinput +>\(\)</userinput +>.</para> + +<para +>Om du lägger till <userinput +>i</userinput +> sist i uttrycket, blir matchningen skiftlägesokänslig. Om du lägger till <userinput +>g</userinput +> sist, ersätts alla förekomster av mönstret, annars ersätts bara den första förekomsten.</para> + +<example> + +<title +>Ersätta text på den nuvarande raden</title> + +<para +>Din vänliga kompilator stannade just, och talade om för dig att klassen <literal +>minKlass</literal +> som nämns på rad 3902 i din källkodsfil inte är definierad.</para> + +<para +>"Tusan också!" tänker du. Det ska förstås vara <literal +>MinKlass</literal +>. Du går till rad 3902, och istället för att försöka hitta ordet i texten, så startar du dialogrutan för redigeringskommandot, och skriver in <userinput +>s/minklass/MinKlass/i</userinput +>, trycker på knappen <guibutton +>Ok</guibutton +>, sparar filen och kompilerar – utan problem med felet borta.</para> + +</example> + +<example> +<title +>Ersätta text i hela filen</title> + +<para +>Antag att du har en fil där du nämner namnet <quote +>Anna Johansson</quote +> flera gånger, och någon kommer in och talar om för dig att hon precis har gift sig och bytt namn till <quote +>Anna Svensson</quote +>. Du vill, förstås, byta ut alla förekomster av <quote +>Anna Johansson</quote +> mot <quote +>Anna Svensson</quote +>.</para> + +<para +>Starta kommandoraden, och skriv in kommandot: <userinput +>%s/Anna Johansson/Anna Svensson/</userinput +>, tryck på returtangenten och du är klar.</para> + +</example> + +<example> +<title +>Ett mer avancerat exempel</title> + +<para +>Det här exemplet använder <emphasis +>bakåtreferenser</emphasis +> samt en <emphasis +>ordklass</emphasis +> (om du inte vet vad det är, se tillhörande dokumentation som nämns nedan).</para> + +<para +>Antag att du har följande rad: <programlisting +>void MinKlass::StrOperation( String &x, String &y String *p, int &a, int &b )</programlisting> +</para> +<para +>Nu inser du att det inte är bra kod, och bestämmer dig för att du vill använda nyckelordet <constant +>const</constant +> för alla <quote +>adress</quote +>- parametrar, de som markeras med operatorn & framför argumentets namn. Du skulle också vilja förenkla blanktecknen, så att det bara finns ett blanktecken mellan varje ord.</para> + +<para +>Starta dialogrutan för redigeringskommandot, skriv in: <userinput +>s/\s+(\w+)\s+(&)/ const \1 \2/g</userinput +> och tryck sedan på knappen <guibutton +>Ok</guibutton +>. Tecknet <userinput +>g</userinput +> i slutet på raden gör att det reguljära uttrycket görs om för varje träff, så att <emphasis +>bakåtreferenserna</emphasis +> sparas.</para> + +<para +>Utmatning: <computeroutput +>void MinKlass::StrOperation( const String &x, const String &y String *p, const int &a, const int &b )</computeroutput +></para> + +<para +>Åtgärden utförd! Vad hände nu egentligen? Ja, vi letade efter blanktecken (<literal +>\s+</literal +>), följt av en eller flera bokstäver (<literal +>\w+</literal +>), följt av ytterligare blanktecken (<literal +>\s+</literal +>), följt av ett och-tecken, och sparade bokstäverna samt och-tecknet för att återanvända i ersättningsoperationen. Därefter ersatta vi den matchande delen av vår rad, med ett blanktecken följt av <quote +>const</quote +>, följt av ett blanktecken, följt av våra sparade bokstäver (<literal +>\1</literal +>), följt av vårt sparade och-tecken (<literal +>\2</literal +>)</para> + +<para +>I vissa fall var bokstäverna <quote +>String</quote +>, i andra <quote +>int</quote +>, så att använda teckenklassen <literal +>\w</literal +> och tecknet <literal +>+</literal +> visade sig vara en värdefull tillgång.</para> + +</example> + +</listitem> + +</varlistentry> + +</variablelist> + +</sect3> + +<sect3 id="advanced-editing-tools-commandline-commands-navigation"> +<title +>Kommandon för navigering</title> + +<variablelist> + +<varlistentry> +<term +><cmdsynopsis +><command +>goto</command +><arg +>HELTAL rad</arg +></cmdsynopsis +></term> +<listitem +><para +>Det här kommandot går till den angivna raden.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>find</command +><arg +>mönster</arg +></cmdsynopsis +></term> +<listitem +><para +>Kommandot går till första förekomsten av <userinput +>mönster</userinput +> enligt inställningen. Följande förekomster kan hittas genom att använda <menuchoice +><guimenu +>Redigera</guimenu +> <guimenuitem +>Sök igen</guimenuitem +></menuchoice +> (normal snabbtangent är <keycap +>F3</keycap +>).</para> +<para +>Kommandot kan anpassas genom att lägga till ett kolon följt av ett eller flera alternativ. Formatet är <userinput +>find:alternativ mönster</userinput +>. Följande alternativ stöds: <variablelist> + +<varlistentry> +<term +><userinput +>b</userinput +></term> +<listitem +><para +>Sök bakåt.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>c</userinput +></term> +<listitem +><para +>Sök från markörens position.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>e</userinput +></term> +<listitem +><para +>Sök bara i markeringen.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>r</userinput +></term> +<listitem +><para +>Utför en sökning med ett reguljärt uttryck. Om det anges, kan du använda <userinput +>\N</userinput +>, där N är ett tal, för att representera hittad text i ersättningssträngen.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>s</userinput +></term> +<listitem +><para +>Utför skiftlägeskänslig sökning.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>w</userinput +></term> +<listitem +><para +>Matcha bara hela ord.</para +></listitem> +</varlistentry> + +</variablelist> + +</para> + +</listitem> + +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>ifind</command +><arg +>mönster</arg +></cmdsynopsis +></term> +<listitem +><para +>Kommandot tillhandahåller <quote +>sökning medan du skriver</quote +>. Du kan ställa in beteendet eller sökningen genom att lägga till ett kolon följt av ett eller flera alternativ, på detta sätt: <userinput +>ifind:alternativ mönster</userinput +>. Tillåtna alternativ är: <variablelist> +<varlistentry> +<term +><userinput +>b</userinput +></term> +<listitem +><para +>Sök bakåt.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>r</userinput +></term> +<listitem +><para +>Gör en sökning med ett reguljärt uttryck.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>s</userinput +></term> +<listitem +><para +>Utför skiftlägeskänslig sökning.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>c</userinput +></term> +<listitem +><para +>Sök från markörens position.</para +></listitem> +</varlistentry> + +</variablelist> +</para +></listitem> +</varlistentry> + +</variablelist> + +</sect3> + +</sect2> + +</sect1> + +<sect1 id="advanced-editing-tools-code-folding"> +<title +>Använda kodvikning</title> + +<para +>Kodvikning låter dig dölja delar av ett dokument i editorn, vilket gör det lättare att få en överblick av stora dokument. I &kate; görs beräkningen av områden som kan fällas ihop genom att använda reglerna som anges i definitionerna av syntaxfärgläggning, och därför är det bara tillgängligt i vissa format, typiskt i programkällkod, XML-markering och liknande. De flesta definitioner av syntaxfärgläggning som stöder kodvikning låter dig också manuellt definiera områden som kan fällas ihop, typiskt genom att använda nyckelorden <userinput +>BEGIN</userinput +> och <userinput +>END</userinput +>.</para> + +<para +>För att använda kodvikningsfunktionen, aktivera vikmarkörer genom att använda menyalternativet <menuchoice +><guimenu +>Visa</guimenu +> <guimenuitem +>Visa vikmarkörer</guimenuitem +></menuchoice +> om de inte redan är synliga. Vikmarkörrutan till vänster på skärmen visar en grafisk vy av områden som kan fällas ihop, med tecknen +/- för att ange möjliga åtgärder för ett givet område: tecknet - betyder att området är expanderat, och att klicka på - fäller ihop området så att tecknet + visas istället.</para> + +<para +>Fyra kommandon tillhandahålls för att hantera tillståndet hos områden som kan fällas ihop, se <link linkend="view-code-folding" +>menydokumentationen</link +>. </para> + +<para +>Om du inte vill använda kodvikningsfunktionen kan du inaktivera alternativet <guilabel +>Visa vikmarkörer (om tillgängliga)</guilabel +> på <link linkend="config-dialog-editor-appearance" +>sidan Utseende i inställningen av editorn</link +>.</para> + +</sect1> + +<sect1 id="advanced-editing-tools-scripting"> + +<title +>Skapa skript för editorkomponenten med Javaskript</title> + +<sect2 id="advanced-editing-tools-scripting-introduction"> + +<title +>Inledning</title> + +<para +>Från och med version 2.5, stöder &kate;s editorkomponent skript med ECMA-skript, också känt som Javaskript.</para> + +<para +>Skript kan bara användas via den <link linkend="advanced-editing-tools-commandline" +>inbyggda kommandoraden</link +>. Kravet är att skriptet placeras i en katalog där &kate; kan hitta det, tillsammans med en valfri .desktop-fil som definierar tillhörande egenskaper. Den giltiga katalogen heter <filename +>katepart/scripts</filename +> i &kde;:s datakataloger. Du kan hitta datakatalogerna genom att utföra kommandot <command +>kde-config <option +>--path</option +> <parameter +>data</parameter +></command +>. Du har oftast åtminstone en system och en personlig datakatalog. Naturligtvis är skript i systemdatakatalogen tillgänglig för alla användare på systemet, medan de i den personliga katalogen bara är tillgängliga för dig själv.</para> + +<note +><para +>Funktionen är experimentell, och kommer troligen att ändras under framtida utveckling.</para> +<para +>Vi vet att många kommer att vara besvikna eftersom man inte kan lägga till skript i menyn, eller tilldela dem snabbtangenter. Ursäkta, men någon gång i framtiden kommer det troligen att vara möjligt.</para> +<para +>Det är också ännu inte möjligt att skicka några argument till skript. Ha tålamod, så kan det läggas till i en ljus framtid.</para> +</note> + +</sect2> + +<sect2 id="advanced-editing-tools-scripting-reference"> + +<title +>Kates programmeringsgränssnitt för Javaskript</title> + +<para +>Här anges den fullständiga uppsättningen funktioner och egenskaper som är tillgänglig i objekten <type +>document</type +> och <type +>view</type +>. Dessutom kan du förstås använda alla standardobjekt som <type +>Math</type +>, <type +>String</type +>, <type +>Regex</type +> och så vidare.</para> + +<para +>När ett skript körs, är objektet <classname +>document</classname +> det nuvarande dokumentet, och objektet <classname +>view</classname +> är den nuvarande vyn.</para> + +<note +><para +>Argumenttyperna används förstås inte i Javaskript för närvarande, utan de är endast där för att ange vilket sorts värde som funktionerna förväntar sig.</para +></note> + +<variablelist id="advanced-editing-tools-scripting-global"> +<title +>Globala funktioner</title> +<varlistentry> +<term +><function +>debug( <parameter +><replaceable +>sträng</replaceable +></parameter +>) [funktion]</function +></term> +<listitem> +<itemizedlist> +<title +>parametrar</title> +<listitem +><para +><parameter +>sträng</parameter +> strängen att mata ut</para> +</listitem> +</itemizedlist> +<para +>Matar ut strängen på standardfelutmatningen med <acronym +>kdDebug()</acronym +>. En särskild utmatningsyta används för utmatningen, som inleds med <computeroutput +>Kate (KJS Scripts):</computeroutput +>. </para> +</listitem> +</varlistentry> +</variablelist> + +<variablelist id="advanced-editing-tools-scripting-document"> +<title +>Programmeringsgränssnittet <classname +>document</classname +></title> + +<varlistentry> +<term +><function +>document.attribute( <parameter +><replaceable +>rad</replaceable +> </parameter +>, <parameter +><replaceable +>kolumn</replaceable +></parameter +> ); [funktion]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametrar</title> +<listitem +><para +><parameter +>uint rad</parameter +> Raden för positionen där egenskapen hittas.</para +></listitem> +<listitem +><para +><parameter +>uint kolumn</parameter +> Kolumnen för positionen där egenskapen hittas.</para +></listitem> +</itemizedlist> +<para +>Returnerar den numeriska identifieraren för dokumentpositionen [<parameter +>rad</parameter +>,<parameter +>kolumn</parameter +>]. Egenskapen representerar textens synliga utseende eller stil, och används också för att beräkna syntaxfärgläggningen för en viss del av texten i blandade format som HTML eller PHP.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.canBreakAt( <parameter +>Char c</parameter +>, <parameter +>uint egenskap</parameter +> ); [funktion]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametrar</title> +<listitem +><para +><parameter +>c</parameter +> Tecknet att testa</para +></listitem> +<listitem +><para +><parameter +>egenskap</parameter +> Egenskapen på positionen för <parameter +>c</parameter +>.</para +></listitem> +</itemizedlist> +<para +>Returnerar om radbrytning är tillåten vid tecknet c med egenskapen egenskap. Resultatet bestäms genom att fråga egenskapen som äger färgläggningen om vilka tecken som tillåts vid radbrytning.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.canComment( <parameter +>uint start_egenskap</parameter +>, <parameter +>uint slut_egenskap</parameter +> ); [funktion]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametrar</title> +<listitem +><para +><parameter +>start_egenskap</parameter +> Egenskapen i början av intervallet som ska ändras till en kommentar.</para +></listitem> +<listitem +><para +><parameter +>slut_egenskap</parameter +> Egenskapen i slutet av intervallet som ska ändras till en kommentar.</para +></listitem> +</itemizedlist> +<para +>Returnerar om start_egenskap och slut_egenskap hör till samma syntaxfärgläggningssystem. Om de gör det, är det vettigt. </para> +<example> +<title +>using canComment</title> +<programlisting +>if ( document.canComment( document.attribute(1,0), document.attribute(5,0) ) ) { + // 1,0 och 5,0 hör till samma syntaxfärgläggningssystem +} +</programlisting> +</example> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.clear(); [funktion]</function +></term> +<listitem +><para +>Rensar dokumentet.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.commentStart( <parameter +>uint egenskap</parameter +> ); [funktion]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametrar</title> +<listitem +><para +><parameter +>egenskap</parameter +> Egenskapen för texten som strängen commentStart ska hämtas.</para +></listitem> +</itemizedlist> +<para +>Returnerar strängen som krävs för att starta en flerraderskommentar för text med egenskapen, eller en tom sträng om flerraderskommentarer inte stöds för texten.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.commentMarker( <parameter +>uint egenskap</parameter +> ); [funktion]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametrar</title> +<listitem +><para +><parameter +>egenskap</parameter +> Egenskapen för texten som strängen commentMarker ska hämtas</para +></listitem> +</itemizedlist> +<para +>Returnerar strängen som används ör att markera resten av raden som en kommentar med egenskapen, eller en tom sträng om kommentarer för enskilda rader inte stöds för texten.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.commentEnd( <parameter +>uint egenskap</parameter +> ); [funktion]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametrar</title> +<listitem +><para +><parameter +>egenskap</parameter +> Egenskapen för texten som strängen commentEnd ska hämtas</para +></listitem> +</itemizedlist> +<para +>Returnerar strängen som krävs för att avsluta en flerraderskommentar för text med egenskapen, eller en tom sträng om flerraderskommentarer inte stöds för texten.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.editBegin(); [funktion]</function +></term> +<listitem> +<para +>Starta en redigeringsgrupp. Alla åtgärder som utförs innan anropet editEnd() grupperas som en åtgärd att ångra.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.editEnd(); [funktion]</function +></term> +<listitem> +<para +>Avsluta en redigeringsgrupp.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.highlightMode; [egenskap:skrivskyddad]</function +></term> +<listitem> +<para +>Namnet på dokumentets färgläggningsläge, såsom JavaScript eller C++. Om inget syntaxfärgläggningsläge är inställt för dokumentet, är värdet None. Observera att du måste använda det engelska namnet i fall då det skiljer sig från det översatta.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.indentMode; [egenskap:skrivskyddad]</function +></term> +<listitem> +<para +>Name på dokumentets indenteringsläge, såsom <literal +>normal</literal +> eller <literal +>cstyle</literal +>. Kom ihåg att om inget intenteringsläge är inställt är värdet <literal +>none</literal +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.indentWidth; [egenskap:skrivskyddad]</function +></term> +<listitem> +<para +>Indenteringsbredd inställd i dokumentet. Används om indentering med mellanslag är aktiverad.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.insertLine( <parameter +>uint rad</parameter +>, <parameter +>sträng text</parameter +> ); [funktion]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametrar</title> +<listitem +><para +><parameter +>rad</parameter +> dokumentets radnummer</para> +</listitem> +<listitem +><para +><parameter +>text</parameter +> text att infoga</para +></listitem> +</itemizedlist> +<para +>Infogar en ny rad med texten <parameter +>text</parameter +> på raden <parameter +>rad</parameter +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.insertText( <parameter +>uint rad</parameter +>, <parameter +>uint kolumn</parameter +>, <parameter +>sträng text</parameter +> ); [funktion]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametrar</title> +<listitem +><para +><parameter +>rad</parameter +> radnumret</para +></listitem> +<listitem +><para +><parameter +>kolumn</parameter +> kolumnen</para +></listitem> +<listitem +><para +><parameter +>text</parameter +> texten som ska infogas</para +></listitem> +</itemizedlist> +<para +>Infogar texten <parameter +>text</parameter +> på raden <parameter +>rad</parameter +> och kolumnen <parameter +>kolumn</parameter +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>document.length(); [funktion]</term> +<listitem> +<para +>Returnerar dokumentets storlek i byte.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.lines(); [funktion]</function +></term> +<listitem> +<para +>Returnerar antal rader i dokumentet.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>document.mixedIndent; [egenskap:skrivskyddad]</term> +<listitem> +<para +>Ett booleskt värde som anger om inställningen för blandad indentering är aktiv för dokumentet. Om det är fallet, optimeras indenteringen att innehålla en blandning av tabulatortecken och mellanslag, liksom den som används av editorn Emacs.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>document.removeLine( <parameter +>uint rad</parameter +> ); [funktion]</term> +<listitem> +<itemizedlist> +<title +>Parametrar</title> +<listitem +><para +><parameter +>rad</parameter +> radnummer</para +></listitem> +</itemizedlist> +<para +>Tar bort raden rad i dokumentet.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.removeText( <parameter +>uint startrad</parameter +>, <parameter +>uint startkolumn</parameter +>, <parameter +>uint slutrad</parameter +>, <parameter +>uint slutkolumn</parameter +> ); [funktion]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametrar</title> +<listitem +><para +><parameter +>startrad</parameter +> anger startraden</para +></listitem> +<listitem +><para +><parameter +>startkolumn</parameter +> anger startkolumnen</para +></listitem> +<listitem +><para +><parameter +>slutrad</parameter +> anger slutraden</para +></listitem> +<listitem +><para +><parameter +>slutkolumn</parameter +> anger slutkolumnen</para +></listitem> +</itemizedlist> +<para +>Tar bort textintervallet från raden <parameter +>startrad</parameter +> och kolumnen <parameter +>startkolumn</parameter +> fram till raden <parameter +>slutrad</parameter +> och kolumnen <parameter +>slutkolumn</parameter +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.setText( <parameter +>sträng text</parameter +> ); [funktion]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametrar</title> +<listitem +><para +><parameter +>text</parameter +> dokumentets text</para +></listitem> +</itemizedlist> +<para +>Ändrar hela dokumentets innehåll till <parameter +>text</parameter +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.spaceIndent; [egenskap:skrivskyddad]</function +></term> +<listitem> +<para +>Ett booleskt värde som anger om indentering med mellanslag är aktiv för dokumentet. Om det är fallet, indenteras dokumentet med indentWidth mellanslag per nivå, annars sker indentering med ett tabulatortecken per nivå.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.textFull(); [funktion]</function +></term> +<listitem> +<para +>Returnerar hela dokumentets text. Om texten omfattar flera rader är radbrytningstecknet <constant +>\n</constant +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.textLine( uint rad ); [funktion]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametrar</title> +<listitem +><para +><parameter +>rad</parameter +> raden</para +></listitem> +</itemizedlist> +<para +>Returnerar texten på raden <parameter +>rad</parameter +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>document.textRange( <parameter +>uint startrad</parameter +>, <parameter +>uint startkolumn</parameter +>, <parameter +>uint slutrad</parameter +>, <parameter +>uint slutkolumn</parameter +> ); [funktion]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametrar</title> +<listitem +><para +><parameter +>startrad</parameter +> anger startraden</para +></listitem> +<listitem +><para +><parameter +>startkolumn</parameter +> anger startkolumnen</para +></listitem> +<listitem +><para +><parameter +>slutrad</parameter +> anger slutraden</para> +</listitem> +<listitem +><para +><parameter +>slutkolumn</parameter +> anger slutkolumnen</para +></listitem> +</itemizedlist> +<para +>Returnerar det angivna textintervallet. Om intervallet omfattar flera rader är radbrytningstecknet <constant +>\n</constant +>.</para> +</listitem> +</varlistentry> + +</variablelist +><!--/ document API --> + +<variablelist id="advanced-editing-tools-scripting-view"> +<title +>Programmeringsgränssnittet <classname +>view</classname +></title> + +<varlistentry> +<term +><function +>view.clearSelection(); [funktion]</function +></term> +<listitem> +<para +>Avmarkerar all text.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.cursorColumn(); [funktion]</function +></term> +<listitem> +<para +>Returnerar den nuvarande markörkolumnen (tabulatortecken expanderas).</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.cursorColumnReal(); [funktion]</function +></term> +<listitem> +<para +>Returnerar den nuvarande riktiga markörkolumnen (tabulatortecken räknas som ett tecken).</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.cursorLine(); [funktion]</function +></term> +<listitem> +<para +>Returnerar den nuvarande raden med markören.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.hasSelection(); [funktion]</function +></term> +<listitem> +<para +>Returnerar <constant +>true</constant +> om vyn innehåller markerad text, annars <constant +>false</constant +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.removeSelectedText(); [funktion]</function +></term> +<listitem> +<para +>Tar bort den markerade texten, om vyn har en markering.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.selectAll(); [funktion]</function +></term> +<listitem> +<para +>Markerar all text.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.selection(); [funktion]</function +></term> +<listitem> +<para +>Returnerar den markerade texten. Om markeringen omfattar flera rader är radbrytningstecknet <constant +>\n</constant +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.selectionEndColumn; [egenskap:skrivskyddad]</function +></term> +<listitem> +<para +>Returnerar markeringens avslutande kolumn.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.selectionEndLine; [egenskap:skrivskyddad]</function +></term> +<listitem> +<para +>Returnerar markeringens avslutande rad.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.selectionStartColumn; [egenskap:skrivskyddad]</function +></term> +<listitem> +<para +>Returnerar markeringens inledande kolumn.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.selectionStartLine; [egenskap:skrivskyddad]</function +></term> +<listitem> +<para +>Returnerar markeringens inledande rad.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.setCursorPosition( <parameter +>uint rad</parameter +>, <parameter +>uint kolumn</parameter +> ); [funktion]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametrar</title> +<listitem +><para +><parameter +>rad</parameter +> Anger rad för markören.</para +></listitem> +<listitem +><para +><parameter +>kolumn</parameter +> Anger kolumn för markören.</para +></listitem> +</itemizedlist> +<para +>Ställer in inmatningsmarkörens position i vyn till [<parameter +>rad</parameter +>, <parameter +>kolumn</parameter +>]. Det här ställer in markörens position på visuellt sätt, dvs. att ett tabulatortecken räknas upp till <parameter +>tabwidth</parameter +> beroende på positionen på raden. Markörens position blir synlig. Både rad och kolumn börjar på noll.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.setCursorPositionReal( <parameter +>uint rad</parameter +>, <parameter +>uint kolumn</parameter +> ); [funktion]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametrar</title> +<listitem +><para +><parameter +>rad</parameter +> Anger rad för markören.</para +></listitem> +<listitem +><para +><parameter +>kolumn</parameter +> Anger kolumn för markören.</para +></listitem> +</itemizedlist> +<para +>Ställer in inmatningsmarkörens position i vyn till [<parameter +>rad</parameter +>, <parameter +>kolumn</parameter +>]. Det här ställer in strängpositionen, dvs. att ett tabulatortecken räknas som 1. Markörens position blir synlig. Både rad och kolumn börjar på noll.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><function +>view.setSelection( <parameter +>uint startrad</parameter +>, <parameter +>uint startkolumn</parameter +>, <parameter +>uint slutrad</parameter +>, <parameter +>uint slutkolumn</parameter +> ); [funktion]</function +></term> +<listitem> +<itemizedlist> +<title +>Parametrar</title> +<listitem +><para +><parameter +>startrad</parameter +> anger startraden</para +></listitem> +<listitem +><para +><parameter +>startkolumn</parameter +> anger startkolumnen</para +></listitem> +<listitem +><para +><parameter +>slutrad</parameter +> anger slutraden</para +></listitem> +<listitem +><para +><parameter +>slutkolumn</parameter +> anger slutkolumnen</para +></listitem> +</itemizedlist> +<para +>Skapar en markering från raden <parameter +>startrad</parameter +> och kolumnen <parameter +>startkolumn</parameter +> fram till raden <parameter +>slutrad</parameter +> och kolumnen <parameter +>slutkolumn</parameter +>.</para> +</listitem> +</varlistentry> + +</variablelist> + +<example id="advanced-editing-tools-scripting-example"> + +<title +>Ett exempelskript</title> +<para +>Som ett exempel skapar vi ett litet skript som gör om markeringen till stora bokstäver. Det är uppenbart att vi först måste kontrollera om en markering finns. Om det är fallet, hämtar vi texten, ändrar den till stora bokstäver och ersätter den med den nya. En implementering skulle kunna se ut så här:</para> + +<programlisting +>if ( view.hasSelection() ) +{ + // gör om markeringen till stora bokstäver + column = view.selectionStartColumn; + line = view.selectionStartLine; + + selection = view.selection().toUpperCase(); + + document.editBegin(); + view.removeSelectedText(); + document.insertText( line, column, selection ); + document.editEnd(); +} +</programlisting> + +<para +>För att gruppera ihop åtgärderna så att de ångras med en enda aktivering av <guimenuitem +>Ångra</guimenuitem +>, inkapslar vi raderna <programlisting +>view.removeSelectedText()</programlisting +> och <programlisting +>document.insertText()</programlisting +> med <programlisting +>document.editBegin()</programlisting +> och <programlisting +>document.editEnd()</programlisting +>.</para> + +</example> + +<example id="advanced-editing-tools-desktop-example"> +<title +>Ett exempel på en <filename +>.desktop</filename +>-fil</title> + +<para +>Här är ett exempel på en .desktop-fil som följer med skriptet ovan.</para> + +<programlisting +># Exempel på en .desktop-fil +[Desktop Entry] +Encoding=UTF-8 +Name=Kate Part JavaScript Uppercase +Comment=Script to uppercase the selection +X-Kate-Command=uppercase-selection +X-Kate-Help=<p>Usage: <code>uppercase-selection</code></p> +</programlisting> + +<para +>Som du kan se kan du definera kodningen, ange ett namn, en kommentar, en hjälptext med X-Kate-Help och kommandoradsnamnet via X-Kate-Command. Posterna Name, Comment och X-Kate-Help översätts automatiskt till andra språk av KDE:s översättningsgrupper, om filerna finns i KDE:s SVN-arkiv.</para> + +</example> + +<sect3> +<title +>Sätta ihop allting</title> + +<para +>&kate; söker i skriptkatalogerna (se <link linkend="advanced-editing-tools-scripting-introduction" +>ovan</link +>) efter filerna <filename +>*.js</filename +>. För varje fil kontrolleras om det finns en motsvarande <filename +>.desktop</filename +>-fil. I fallet uppercase.js skulle uppercase.desktop letas efter. </para> +<para +>Om en <filename +>.desktop</filename +>-fil inte kan hittas, registreras skriptet på kate-delens kommandorad med filnamnet utan det avslutande .js, så i vårt fall skulle det vara <literal +>uppercase</literal +>. Om kommandonamnet är bra, och du inte behöver de extra funktionerna som en <filename +>.desktop</filename +>-fil tillhandahåller behöver du inte en <filename +>.desktop</filename +>-fil alls. </para> +<para +>Om en <filename +>.desktop</filename +>-fil finns, läser kate-delen namnet som skriptet ska registreras som från posten X-Kate-Command i .desktop-filen, till exempel X-Kate-Command=uppercase-selection.</para> + +</sect3> + +</sect2> + +</sect1> + +</chapter> diff --git a/tde-i18n-sv/docs/kdebase/kate/configdialog01.png b/tde-i18n-sv/docs/kdebase/kate/configdialog01.png Binary files differnew file mode 100644 index 00000000000..734397a71ae --- /dev/null +++ b/tde-i18n-sv/docs/kdebase/kate/configdialog01.png diff --git a/tde-i18n-sv/docs/kdebase/kate/configdialog02.png b/tde-i18n-sv/docs/kdebase/kate/configdialog02.png Binary files differnew file mode 100644 index 00000000000..21cab7ab611 --- /dev/null +++ b/tde-i18n-sv/docs/kdebase/kate/configdialog02.png diff --git a/tde-i18n-sv/docs/kdebase/kate/configuring.docbook b/tde-i18n-sv/docs/kdebase/kate/configuring.docbook new file mode 100644 index 00000000000..5aba8fa8e53 --- /dev/null +++ b/tde-i18n-sv/docs/kdebase/kate/configuring.docbook @@ -0,0 +1,2578 @@ +<chapter id="configuring-kate"> +<chapterinfo> +<authorgroup> +<author +>&Anders.Lund; &Anders.Lund.mail;</author> +<othercredit role="translator" +> <firstname +>Johan</firstname +> <surname +>Thelmén</surname +> <affiliation +><address +><email +>jth@home.se</email +></address +></affiliation +> <contrib +>Översättare</contrib +></othercredit +> +</authorgroup> +</chapterinfo> +<title +>Anpassa &kate;</title> + +<sect1 id="configuring-overview"> +<title +>Översikt</title> +<para> +<indexterm> +<primary +>anpassa</primary> +<secondary +>inställning</secondary> +<tertiary +>inställningar</tertiary +></indexterm> +<anchor id="find"/> <anchor id="find-again"/> <anchor id="replace"/> <anchor id="undo"/> <anchor id="redo"/> &kate; erbjuder flera sätt att justera programmet så att det beter sig som önskas. De viktigaste är: </para> + +<variablelist> +<varlistentry> +<term id="configure" +>Inställningsdialogrutan</term> +<listitem +><para +>Det huvudsakliga inställningsverktyget, som låter dig anpassa programmet &kate;, editorkomponenten och användning av insticksprogram.</para +></listitem> +</varlistentry> +<varlistentry> +<term id="settings" +>Menyn <guimenu +>Inställningar</guimenu +></term> +<listitem +><para +>Låter dig ändra ofta använda inställningar, och att starta inställningsdialogrutor.</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Menyn <guimenu +>Visa</guimenu +></term> +<listitem +><para +>Låter dig dela det nuvarande fönstret, samt visa ikoner och radnummer för dokumentet som redigeras för närvarande.</para +></listitem> +</varlistentry> +</variablelist> + +<para +>Den inbyggda terminalen använder inställningarna som definieras i Inställningscentralen, och kan anpassas genom att klicka med <mousebutton +>höger</mousebutton +> musknapp och välja i undermenyn <guimenuitem +>Inställningar</guimenuitem +>.</para> + +</sect1> + +<sect1 id="configuring-kate-configdialog"> +<title +>Den huvudsakliga inställningsdialogrutan</title> + +<mediaobject> +<imageobject> +<imagedata format="PNG" fileref="configdialog01.png"/> +</imageobject> +</mediaobject> + +<para +>Inställningsdialogrutan för &kate; visar ett träd med grupper till vänster, och en inställningssida som motsvarar den valda gruppen till höger.</para> + +<para +>Inställningarna är uppdelade i två grupper, närmare bestämt <itemizedlist> +<listitem +><para +><link linkend="config-dialog" +>Inställning av programmet</link> +</para +></listitem> +<listitem +><para +><link linkend="config-dialog-editor" +>Inställning av editorkomponenten</link +></para +></listitem> + +</itemizedlist> + +</para> + +</sect1> + +<sect1 id="config-dialog"> +<title +>Inställning av programmet &kate;</title> +<para +>Den här gruppen innehåller sidor för att anpassa det huvudsakliga &kate;-programmet.</para> + +<sect2 id="config-dialog-general"> +<title +>Sidan Allmänt</title> +<para +>Den här sidan innehåller ett fåtal globala alternativ för &kate;.</para> + +<variablelist> + +<varlistentry> +<term +><anchor id="config-dialog-general-show-full-path"/> +<guilabel +>Visa full sökväg i titeln</guilabel +></term> +<listitem +><para +>Om aktiverad, kommer Kate att visa den fullständiga webbadressen för aktuellt dokument i namnlisten, istället för bara filnamnet.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="config-general-behavior"/> +<guilabel +>Beteende</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term> +<anchor id="config-dialog-general-sync-konsole"/> +<guibutton +>Synkronisera terminalemulering med aktivt dokument</guibutton +></term> +<listitem +><para +>Det gör att den inbyggda terminalen att byta katalog med <command +>cd</command +> till katalogen för det aktiva dokumentet, när den startas, och när ett nytt dokument får fokus. Om det inte aktiveras, måste du flytta dig i terminalen själv. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="config-dialog-general-warn-mod"/> +<guilabel +>Varna om filer ändras av främmande processer</guilabel +></term> +<listitem +><para +>När aktiverad, underrättar &kate; dig om filer som ändrats utanför programmet så fort huvudfönstret får inmatningsfokus. Du kommer att kunna hantera flera ändrade filer samtidigt. Du kan ladda om, spara eller kasta ändrade filer i grupper.</para> +<para +>Om inte aktiverad, frågar &kate; dig om en åtgärd när en externt ändrad fil får fokus inne i programmet.</para> +</listitem> +</varlistentry> + +</variablelist> +</listitem> +</varlistentry +><!-- /behavior group --> + +<varlistentry> +<term +><anchor id="config-general-meta-data"/> +<guilabel +>Metainformation</guilabel +></term> +<listitem> + +<variablelist> +<varlistentry> +<term +><anchor id="config-general-keep-meta-information"/> +<guilabel +>Behåll metainformation mellan sessioner</guilabel +></term> +<listitem +><para +>När aktiverad, lagrar &kate; metadata som bokmärken och sessionsinställningar också när du stänger dokument. Data används om dokumentet är oförändrat när det öppnas igen.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="config-general-delete-meta-information-after"/> +<guilabel +>Ta bort oanvänd metainformation efter</guilabel +></term> +<listitem +><para +>Ställ in maximalt antal dagar som metainformation behålls för oöppnade filer. Det hjälper till att hålla databasen med metainformation på en rimlig storlek.</para +></listitem> +</varlistentry> + +</variablelist> + +</listitem> +</varlistentry +><!-- /meta data group --> + +</variablelist> +</sect2> + +<sect2 id="config-dialog-sessions"> +<title +>Sidan Sessioner</title> + +<para +>Den här sidan innehåller alternativ som hör ihop med att <link linkend="fundamentals-using-sessions" +>använda sessioner</link +>.</para> + +<variablelist> + +<varlistentry> +<term +><anchor id="config-dialog-sessions-elements"/> +<guilabel +>Delar av sessioner</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Inkludera fönsterinställningar</guilabel +></term> +<listitem +><para +>Om aktiverad, sparar &kate; fönsterinställningen med varje session.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry +><!-- /elements of sessions --> + +<varlistentry> +<term +><anchor id="config-dialog-sessions-startup-behavior"/> +<guilabel +>Beteende vid programstart</guilabel +></term> +<listitem> +<para +>Välj hur du vill att &kate; ska bete sig vid start. Inställningen kan överskridas genom att ange vad som ska göras på <link linkend="command-line-options" +>kommandoraden</link +>.</para> +<variablelist> +<varlistentry> +<term +><guilabel +>Starta ny session</guilabel +></term> +<listitem +><para +>Med det här alternativet startar &kate; en ny namnlös session när det startas.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Ladda senast använda session</guilabel +></term> +<listitem +><para +>&kate; använder den senast öppnade sessionen vid start. Det är bra om du alltid vill använda samma session, eller sällan byta.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Välj en session manuellt</guilabel +></term> +<listitem +><para +>&kate; visar en liten dialogruta som låter dig välja sessionen du föredrar. Det är förvalt beteende. Bra om du ofta använder många olika sessioner.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry +><!-- /startup behavior --> + +<varlistentry> +<term +><anchor id="config-dialog-sessions-exit-behavior"/> +<guilabel +>Beteende när programmet avslutas eller vid byte av session</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Spara inte session</guilabel +></term> +<listitem +><para +>Ändringar av sessionsdata (öppna filer och om aktiverat, fönsterinställningar) sparas inte. Du blir förstås tillfrågad om du har osparade filer. Med det här alternativet kan du ställa in dina sessioner en gång, och inte bekymra dig om att stänga extrafiler som du öppnade och inte vill se nästa gång du använder sessionen.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Spara session</guilabel +></term> +<listitem +><para +>&kate; sparar sessionsdata, utom om sessionen är namnlös. Med det här alternativet återställs sessionerna alltid precis som du lämnade dem. Det är förvalt beteende. </para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Fråga användaren</guilabel +></term> +<listitem +><para +>Du blir tillfrågad om du vill spara sessionen varje gång en namngiven session stängs.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry +><!-- /exit/switch behavior --> + +</variablelist> + +</sect2> + +<sect2 id="config-dialog-fileselector"> +<title +>Sidan <guilabel +>Filväljare</guilabel +></title> + +<variablelist> +<varlistentry> +<term +><guilabel +>Verktygsrad</guilabel +></term> +<listitem +><para +>Anpassa knapparna i filsystembläddrarens verktygsrad genom att flytta de du vill ha aktiverade till listan <guilabel +>Markerade åtgärder</guilabel +>, och ordna dem med pilknapparna vid sidan om listan.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Automatisk synkronisering</guilabel +></term> +<listitem +><para +>Du kan låta filsystembläddraren automatiskt gå till katalogen som innehåller aktuellt dokument vid vissa händelser: <itemizedlist +> <listitem +><para +>När ett nytt dokument blir aktivt.</para +></listitem +> <listitem +><para +>När filsystembläddraren blir synlig.</para +></listitem +> </itemizedlist +> Även om du inte väljer att använda funktionen, kan du manuellt synkronisera bläddraren med aktuellt dokument genom att trycka på verktygsradsknappen <guilabel +>Synkronisera</guilabel +>. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Kom ihåg platser</guilabel +></term> +<listitem +><para +>Välj hur lång bläddringshistorik du vill ha. Bläddraren kommer bara ihåg enskilda platser, duplikat tas bort.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Kom ihåg filter</guilabel +></term> +<listitem +><para +>Välj hur många filter du vill ska kommas ihåg. Bara enskilda distinkta filter blir ihågkomna, duplikat tas bort.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Session</guilabel +></term> +<listitem> +<para +>Ställ in om filsystembläddraren ska komma ihåg plats och filter över sessioner.</para> +</listitem> +</varlistentry> + +</variablelist> + +</sect2> + +<sect2 id="config-dialog-documentlist"> +<title +>Sidan <guilabel +>Dokumentlista</guilabel +></title> + +<variablelist> +<varlistentry> +<term +><guilabel +>Bakgrundsskuggning</guilabel +></term> +<listitem +><para +>Den här sidan låter dig aktivera eller inaktivera skuggning av bakgrunden som åskådliggör din senaste aktivitet, och välja vilka färger som används om den är aktiverad. Se avsnittet om <link linkend="kate-mdi-tools-file-list" +>dokumentlistan</link +> för mer om funktionen.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Sortera enligt</guilabel +></term> +<listitem +><para +>Ställ in hur du vill att dokumentlistan ska sorteras. Det kan också ställas in från menyn som visas med höger musknapp i dokumentlistan.</para +></listitem> +</varlistentry> +</variablelist> + +</sect2> + +<sect2 id="config-dialog-plugins"> +<title +>Sidan <guilabel +>Insticksprogram</guilabel +></title> + +<para +>Den här sidan tillhandahåller en lista med installerade insticksprogram för programmet &kate;. Varje insticksprogram representeras med namn och en kort beskrivning. Du kan markera kryssrutan vid ett objekt för att aktivera insticksprogrammet det representerar. </para> + +<para +>Om ett insticksprogram tillhandahåller inställningsalternativ, visas en sida för att komma åt dem som en underliggande sida till denna.</para> + +</sect2> + + +<sect2 id="config-dialog-externaltools"> +<title +>Externa verktyg</title> + +<para +>I menyn <guimenu +>Verktyg</guimenu +> hittar du en undermeny som heter <guisubmenu +>Externa verktyg</guisubmenu +>. Dessa verktyg startar externa program med data som hör till det nuvarande dokumentet, till exempel dess webbadress, katalog, text eller markering. Den här sidan låter dig hantera menyn och redigera, ta bort eller lägga till nya verktyg.</para> + +<para +>Varje externt verktyg är ett skalkommando som innehåller makron som representerar dokumentets data. När det aktiveras, ersätts alla makron med data från det aktiva dokumentet.</para> + +<variablelist> +<title +>Egenskaper för externa verktyg</title> +<varlistentry> +<term +>Namn</term> +<listitem +><para +>En snygg beteckning för menyn Externa verktyg.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Skript</term> +<listitem +><para +>Skriptet som ska köras när verktyget aktiveras. Innan skriptet skickas till skalet, ersätts följande makron: <variablelist> +<varlistentry> +<term +>%URL</term> +<listitem +><para +>Den fullständiga webbadressen för nuvarande dokument, eller en tom sträng om dokumentet inte har sparats.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>%URLS</term> +<listitem +><para +>En lista med webbadresser åtskilda med mellanslag för alla öppna dokument (utom de som inte har sparats).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>%directory</term> +<listitem +><para +>Katalogdelen av det nuvarande dokumentets webbadress, eller en tom sträng om det nuvarande dokumentet inte har sparats.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>%filename</term> +<listitem +><para +>Det nuvarande dokumentets filnamn utan sökvägen, eller en tom sträng om det nuvarande dokumentet inte har sparats.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>%line</term> +<listitem +><para +>Radnumret där infogningsmarkören finns i det nuvarande dokumentet.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>%column</term> +<listitem +><para +>Kolumnnumret för infogningsmarkören i det nuvarande dokumentet.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>%selection</term> +<listitem +><para +>Den markerade texten i det nuvarande dokumentet, eller en tom sträng om ingen text är markerad.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>%text</term> +<listitem +><para +>Den fullständiga texten i nuvarande dokument. Se upp med att det kan möjligtvis överskrida den maximala kommandolängden som tillåts i systemet. Använd med försiktighet.</para +></listitem> +</varlistentry> + +</variablelist> + +</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Körbar fil</term> +<listitem +><para +>Den huvudsakliga körbara filen är skriptet. Det krävs, och används för att kontrollera om kommandot över huvud taget kan köras. En fullständigt kvalificerad sökväg tillåts om den körbara filen inte finns i variabeln <envar +>PATH</envar +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Mime-typer</term> +<listitem +><para +>En lista med Mime-typer åtskilda med semikolon som det här kommandot ska aktiveras för. Den är för närvarande oanvänd.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Spara</term> +<listitem +><para +>Du kan välja att låta det nuvarande eller alla dokument sparas innan skriptet körs. Det är bekvämt om skriptet läser filen från disk.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Kommandoradsnamn</term> +<listitem +><para +>Om du fyller i detta, kommer verktyget att vara tillgängligt på <link linkend="advanced-editing-tools-commandline" +>editorns kommandorad</link +> som <command +>exttool-<replaceable +>kommandoradsnamn</replaceable +></command +> (strängen du skriver in här med <quote +>exttool-</quote +> tillagt framför).</para +></listitem> +</varlistentry> + +</variablelist> + +</sect2> + +</sect1> + +<sect1 id="config-dialog-editor"> +<title +>Inställning av editorkomponenten</title> +<para +>Den här gruppen innehåller alla sidor som hör till editorkomponenten i &kate;. De flesta inställningarna här är förvalda, och kan överskridas genom att <link linkend="config-dialog-editor-filetypes" +>definiera en filtyp</link +>, genom <link linkend="config-variables" +>dokumentvariabler</link +> eller genom att ändra dem per dokument under en redigeringssession.</para> + + +<sect2 id="config-dialog-editor-appearance"> +<title +>Utseende</title> + +<variablelist> +<varlistentry> +<term +><guilabel +>Radbrytning</guilabel +></term> +<listitem> +<variablelist> +<varlistentry id="appearance-settings"> +<term +><guilabel +>Dynamisk radbrytning</guilabel +></term> +<listitem +><para +>Om det här alternativet markeras, bryts textrader vid fönstrets kant på skärmen.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Dynamiska radbrytningsmarkörer</guilabel +></term> +<listitem +><para +>Välj när indikering av dynamisk radbrytning ska visas. </para +></listitem +></varlistentry> +<varlistentry> +<term +><guilabel +>Justera dynamiskt radbrutna rader till indenteringsdjupet: </guilabel +></term> +<listitem +><para +>Aktiverar att dynamiskt radbrytna rader justeras vertikalt till den första radens indenteringsnivå. Det kan hjälpa till att göra kod och taggar mer läsbara.</para +><para +>Dessutom låter det dig att ställa in en maximal bredd av skärmen, som ett procenttal. Därefter justeras inte längre dynamiskt radbrytna rader vertikalt. Vid 50 % får exempelvis inte rader vars indenteringsdjup är mer än 50 % av skärmens bredd någon vertikal justering för efterföljande radbrutna rader.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Kodvikning</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Visa vikmarkörer (om tillgängliga) </guilabel +></term> +<listitem +><para +>Om det här alternativet är markerat, visar den aktuella vyn markeringar för kodvikning, om kodvikning är tillgänglig.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Kanter</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Visa ikonkant </guilabel +></term> +<listitem +><para +>Om det här är markerat, ser du en ikonkant till vänster. Ikonkanten visar till exempel bokmärkesmarkeringar.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Visa radnummer </guilabel +></term> +<listitem +><para +>Om det här är markerat, ser du radnummer till vänster.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Visa rullningslistmarkeringar </guilabel +></term> +<listitem +><para +>Om det här alternativet är markerat visar aktuell vy markeringar på den vertikala rullningslisten. Markeringarna visar till exempel bokmärken.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Sortera menyn bokmärken </guilabel +></term> +<listitem +><para> +<variablelist> +<varlistentry> +<term +><guilabel +>Enligt position </guilabel +></term> +<listitem +><para +>Bokmärken ordnas enligt radnumret där de är placerade.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Enligt tillkomst </guilabel +></term> +<listitem +><para +>Varje nytt bokmärke läggs till längst ner, oberoende av var det är placerat i dokumentet.</para +></listitem> +</varlistentry> +</variablelist> +</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Visa indenteringslinjer </guilabel +></term> +<listitem +><para +>Om det här är markerat, visar editorn vertikala linjer för att hjälpa till att identifiera indenterade rader.</para +></listitem> +</varlistentry> +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-colors"> +<title +>Teckensnitt och färger</title> + +<para +>Den här sidan i dialogrutan låter dig ställa in alla teckensnitt och färger i alla färgscheman du har, samt skapa nya scheman eller ta bort befintliga. Varje schema har en inställning av färger, teckensnitt, normal textstil och markeringstextstil. </para> + +<para +>&kate; väljer schemat som för närvarande är aktivt i förväg åt dig. Om du vill arbeta med ett annat schema börja med att välja det i kombinationsrutan <guilabel +>Schema</guilabel +>.</para> + +<sect3 id="config-dialog-editor-colors-colors"> +<title +>Färger</title> + +<variablelist> +<varlistentry id="config-dialog-editor-colors-colors-text-background"> +<term +><guilabel +>Textområdets bakgrund</guilabel +></term> +<listitem> + +<variablelist> + +<varlistentry id="config-dialog-editor-colors-normal-text"> +<term +><guilabel +>Normal text</guilabel +></term> +<listitem +><para +>Det här är förvald bakgrund för redigeringsområdet. Det kommer att vara den dominerande färgen i redigeringsområdet.</para +></listitem> +</varlistentry> + +<varlistentry id="config-dialog-editor-colors-selected-text"> +<term +><guilabel +>Markerad text</guilabel +></term> +<listitem +><para +>Det här är bakgrunden för markerad text. Förvalt värde är den globala markeringsfärgen, som är inställd i färginställningarna i &kde;. </para +></listitem> +</varlistentry> + +<varlistentry id="config-dialog-editor-colors-current-line"> +<term +><guilabel +>Aktuell rad</guilabel +></term> +<listitem +><para +>Ställ in färgen för aktuell rad. Att ställa in den något annorlunda jämfört med den normala textbakgrunden hjälper till att hålla fokus på den aktuella raden. </para +></listitem> +</varlistentry> + +<varlistentry id="config-dialog-editor-colors-marks"> +<term +><guilabel +>Bokmärke</guilabel +></term> +<listitem +><para +>Den här kombinationsrutan låter dig ställa in överlagringsfärger för diverse typer av markeringar. Färgerna blandas in i en markerad rads bakgrundsfärg, så att en aktuell rad med flera markeringar har en bakgrund som är en blandning av flera färger. Markeringsfärgerna används också om du aktiverar visning av markeringar på rullningslisten.</para +></listitem> +</varlistentry> + +</variablelist> +</listitem> +</varlistentry> + +<varlistentry id="config-dialog-editor-colors-colors-other-elements"> +<term +><guilabel +>Ytterligare element</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Bakgrund för vänster kant</guilabel +></term> +<listitem +><para +>Den här färgen används för markeringar, radnummer och vikmarkörkanter till vänster i redigeringsvyn när de visas. </para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Radnummer</guilabel +></term> +<listitem +><para +>Den här färgen används för att visa radnummer till vänster i vyn när de visas.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Färglägg parenteser</guilabel +></term> +<listitem +><para +>Den här färgen används för att markera bakgrunden för matchande parenteser. </para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Radbrytningsmarkörer</guilabel +></term> +<listitem +><para +>Den här färgen används för att rita ett mönster till vänster om rader med dynamisk radbrytning när de är vertikalt justerade, samt för statiska radbrytningsmarkörer.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Tabulatormarkörer</guilabel +></term> +<listitem +><para +>Den här färgen används för att visa indikering av blanktecken när det är aktiverat. </para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +</variablelist> +</sect3> + +<sect3 id="config-dialog-editor-colors-fonts"> +<title +>Teckensnitt</title> +<para +>Här kan du välja teckensnittet för schemat. Du kan välja bland alla teckensnitt som är tillgängliga på systemet, och ställa in förvald storlek. En exempeltext visas längst ner i dialogrutan, så att du kan se effekten av dina val. </para> +</sect3> + +<sect3 id="config-dialog-editor-colors-normal-text-styles"> +<title +>Normala textstilar</title> +<para +>De normala textstilarna ärvs av färgläggningstextstilarna, vilket gör det möjligt för editorn att visa text på ett mycket konsekvent sätt, till exempel använder kommentartext samma stil i nästan alla textformat som Kate kan färglägga.</para> +<para +>Namnet i listan med stilar använder stilen som är inställd för objektet, vilket ger en omedelbar förhandsgranskning när en stil ställs in. </para> +<para +>Varje stil låter dig välja gemensamma egenskaper samt förgrunds- och bakgrundsfärger. För att inte använda en bakgrundsfärg, högerklicka och använd den sammanhangsberoende menyn.</para> +</sect3> + +<sect3 id="config-dialog-editor-colors-highlighting-text-styles"> +<title +>Färgläggningstextstilar</title> +<para +>Här kan du redigera textstilarna som används av en viss färgläggningsdefinition. Editorn väljer färgläggningen som används av aktuellt dokument i förväg. För att arbeta med en annan färgläggning, välja en i kombinationsrutan ovanför listan med stilar. </para> +<para +>Namnet i listan med stilar använder stilen som är inställd för objektet, vilket ger en omedelbar förhandsgranskning när en stil ställs in. </para> +<para +>Varje stil låter dig välja gemensamma egenskaper samt förgrunds- och bakgrundsfärger. För att inte använda en bakgrundsfärg, högerklicka och använd den sammanhangsberoende menyn. Dessutom kan du se om en stil är samma som den förvalda stilen för objektet, och ställa in den till det om den inte är det.</para> +<para +>Du märker att många färgläggningar innehåller andra färgläggningar representerade av grupper i stillistan. De flesta färgläggningar importerar till exempel färgläggningen Alerts, och många källkodsformat importerar färgläggningen Doxygen. Redigering av färger i grupperna påverkar bara stilarna när de används i det redigerade färgläggningsformatet. </para> +</sect3> + +</sect2> + +<sect2 id="config-dialog-editor-cursor-selection"> +<title +>Markör och markering</title> + +<variablelist> + +<varlistentry> +<term +><guilabel +>Förflyttning av textmarkör</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Smart home-tangent</guilabel +></term> +<listitem> +<para +>Om markerad, hoppar markören över blanktecken och går till början av radens text när tangenten Home trycks ner.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Flytta markören till nästa rad efter radslut</guilabel +></term> +<listitem> +<para +>När aktiv, och infogningsmarkören flyttas med tangenterna <emphasis role="bold" +>Vänster</emphasis +> och <emphasis role="bold" +>Höger</emphasis +> går den till föregående eller nästa rad och början eller slutet av raden, på samma sätt som de flesta editorer.</para +><para +>När inaktiv, kan inte infogningsmarkören flyttas till vänster om radens början, men den kan flyttas förbi radens slut, vilket kan vara mycket praktiskt för programmerare. När alternativet är aktivt, och markören flyttas förbi slutet av en rad (åt höger) med piltangenterna, gör det att den hoppar ner till början av nästa rad. På liknande sätt, om markören flyttas förbi början av en rad (åt vänster) hoppar den upp till slutet av föregående rad. När alternativet är inaktivt, och markören flyttas till höger förbi radens slut gör det bara att den fortsätter horisontellt på samma rad, och ett försök att flytta den åt vänster förbi början av raden gör ingenting.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Page Up och Page Down flyttar markören</guilabel +></term> +<listitem> +<para +>Det här alternativet ändrar beteende hos markören när användaren trycker på tangenten <keycap +>Page Up</keycap +> eller <keycap +>Page Down</keycap +>. Om det inte är markerat, behåller textmarkören sin relativa position i den synliga texten i &kate; när ny text blir synlig som ett resultat av åtgärden. Om markören alltså befinner sig mitt i den synliga texten när åtgärden utförs, förblir den där (utom när man når början eller slutet). När alternativet är markerat, gör första användningen av tangenten att markören antingen flyttas längst upp eller längst ner i den synliga texten när en ny sida med text visas.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Centrera markör automatiskt (rader):</guilabel +></term> +<listitem> +<para +>Anger antalet rader som behålls synliga ovanför och under markören om möjligt.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Markeringsläge</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Normal</guilabel +></term> +<listitem> +<para +>Markeringar skrivs över av inskriven text, och försvinner när markören flyttas.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Långlivat</guilabel +></term> +<listitem> +<para +>Markeringar blir kvar också efter markören flyttas och text skrivs in.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-edit"> +<title +>Redigering</title> +<variablelist> + +<varlistentry> +<term +><guilabel +>Tabulatorer</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Infoga mellanslag istället för tabulatorer</guilabel +></term> +<listitem> +<para +>När det här är aktiverat, infogar editorn ett beräknat antal mellanslag enligt positionen i texten och inställningen <option +>tab-width</option +> när du trycker på tabulatortangenten.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Visa tabulatorer</guilabel +></term> +<listitem> +<para +>När det här är markerat visar &kate; en liten punkt som en synlig representation av tabulatortecken.</para> +<note +><para +>Det gör också att punkter ritas för att ange efterföljande blanktecken. Det kommer att rättas i en framtida version av &kate;.</para +></note> +</listitem> +</varlistentry> +<varlistentry> +<term id="config-dialog-editor-tab-width" +>Tabulatorbredd</term +> <listitem +><para +>Om alternativet <link linkend="config-dialog-editor-word-wrap" +><guilabel +>Infoga mellanslag istället för tabulatorer</guilabel +></link +> är aktiverat bestämmer det här alternativet antal mellanslag som editorn använder för att automatiskt ersätta tabulatortecken.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term id="config-dialog-editor-word-wrap" +><guilabel +>Statisk radbrytning</guilabel +></term> +<listitem +><para +>Ordbrytning är en funktion som gör att editorn automatiskt påbörjar en ny textrad och flyttar (radbryter) markören till början av den nya raden. &kate; påbörjar automatiskt en ny textrad när aktuell rad når längden som anges av alternativet <link linkend="config-dialog-editor-wrap-words-at" +>Bryt rader vid:</link +>.</para> +<variablelist> +<varlistentry> +<term +><guilabel +>Aktivera statisk radbrytning</guilabel +></term> +<listitem> +<para +>Sätter på eller stänger av dynamisk radbrytning.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Visa statisk radbrytningsmarkör (om tillämplig)</guilabel +></term> +<listitem> +<para +>Om det här alternativet är markerat, ritas en vertikal linje i radbrytningskolumnen som definieras i <menuchoice +><guimenu +>Inställningar</guimenu +> <guimenuitem +>Anpassa editor...</guimenuitem +></menuchoice +> under fliken Redigering. Observera att radbrytningsmarkören bara ritas om du använder ett teckensnitt med fast breddsteg.</para> +</listitem> +</varlistentry> +<varlistentry id="config-dialog-editor-wrap-words-at"> +<term +><guilabel +>Bryt rader vid:</guilabel +></term> +<listitem> +<para +>Om alternativet <link linkend="config-dialog-editor-word-wrap" +>Radbrytning</link +> är markerat, avgör det här alternativet längden (i tecken) där editorn automatiskt påbörjar en ny rad.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Ta bort mellanslag i slutet av en rad</guilabel +></term> +<listitem +><para +>&kate; eliminerar automatiskt extra mellanslag vid textradernas slut.</para +></listitem +> </varlistentry> + +<varlistentry> +<term +><guilabel +>Automatiska hakparenteser</guilabel +></term +> <listitem +><para +>När användaren skriver in en vänsterparentes ([, ( eller {) skriver &kate; automatiskt in högerparentesen (}, ) eller ]) till höger om markören.</para +></listitem> +</varlistentry> + +<varlistentry +> <term +>Maximalt antal <link linkend="undo" +>ångra</link +>-steg:</term> +<listitem +><para +>Här kan användaren ange antal steg som &kate; behåller i minnet för syftet att ångra inskriven text och åtgärder. Det betyder att ju högre antalet steg är desto mer minne använder &kate; för det. Att ställa in alternativet till 10 skulle betyda att användaren kan ångra de senaste tio åtgärderna, <abbrev +>dvs.</abbrev +> klicka 10 gånger på knappen <guibutton +>Ångra</guibutton +> och få något att hända.</para +></listitem +> </varlistentry> + +<varlistentry +> <term +>Smart sökning av text från:</term> +<listitem +><para +>Det här avgör var &kate; hämtar söktexten (den skrivs automatiskt in i dialogrutan Sök text): <itemizedlist +><listitem +><para +><emphasis role="bold" +>Ingenstans:</emphasis +> Gissa inte söktexten.</para +></listitem +> <listitem +><para +><emphasis role="bold" +>Bara markering:</emphasis +> Använd aktuell markering om tillgänglig.</para +></listitem +> <listitem +><para +><emphasis role="bold" +>Markering, därefter aktuellt ord:</emphasis +> Använd aktuell markering om tillgänglig, använd annars aktuellt ord.</para +></listitem +> <listitem +><para +><emphasis role="bold" +>Bara aktuellt ord:</emphasis +> Använd ordet som markören för närvarande finns i, om tillgängligt.</para +></listitem +> <listitem +><para +><emphasis role="bold" +>Aktuellt ord, därefter markering:</emphasis +> Använd aktuellt ord om tillgängligt, använd annars aktuell markering.</para +></listitem +></itemizedlist +> Observera att för alla ovanstående alternativ, om en söksträng inte har eller kan bestämmas, återgår dialogrutan Sök text till den senaste söktexten. </para +></listitem> +</varlistentry> +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-indent"> +<title +>Indentering</title> +<variablelist> +<varlistentry> +<term +><guilabel +>Automatisk indentering</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Indenteringsläge:</guilabel +></term> +<listitem> +<para +>Välj automatiskt indenteringsläge som du normalt vill använda. Du rekommenderas starkt att använda <userinput +>Inget</userinput +> eller <userinput +>Normal</userinput +> här, och använda inställning av filtyper för att ställa in andra indenteringslägen för textformat som C/C++ kod eller &XML;.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Infoga inledande Doxygen "*" vid inskrivning</guilabel +></term> +<listitem> +<para +>Infoga automatiskt ett inledande "*" när text skrivs in inne i en kommentar med Doxygen-stil. Inställningen aktiveras bara när den är tillämplig.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Indentering med mellanslag</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Använd mellanslag istället för tabulator för att indentera</guilabel +></term> +<listitem> +<para +>Det här ersätter tabulatortecken med det antal mellanslag som ställs in med <guilabel +>Antal mellanslag:</guilabel +> nedan.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Emacs-liknande blandat läge</guilabel +></term> +<listitem> +<para +>Använd en blandning av tabulatortecken och mellanslag för indentering.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Antal mellanslag:</guilabel +></term> +<listitem> +<para +>Ställ in det antal mellanslag du vill använda för indentering när du markerar <guilabel +>Använd mellanslag istället för tabulator för att indentera</guilabel +> ovan.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Behåll indenteringsprofil</guilabel +></term> +<listitem +><para +>När det här är markerat, avindenterar inte editorn rader ytterligare i en markering när raden med minst indentering blir avindenterad. Om du ibland avindenterar block med indenterad kod, kan det vara till hjälp. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Behåll extra mellanslag</guilabel +></term> +<listitem +><para +>Indentering med mer än det valda antalet mellanslag kommer inte att förkortas.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Tangenter att använda</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Tabulatortangent indenterar</guilabel +></term> +<listitem> +<para +>Det här gör att tangenten <keycombo action="simul" +><keycap +>tab</keycap +></keycombo +> kan användas för att indentera.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Backsteg indenterar</guilabel +></term> +<listitem> +<para +>Det här gör att tangenten <keycombo +><keycap +>backsteg</keycap +></keycombo +> kan användas för att indentera.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Tabulatortangentläge om ingenting markerat</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Infoga indenteringstecken</guilabel +></term> +<listitem> +<para +>Det här låter tabulatortangenten infoga indenteringstecken.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Infoga tabulatortecken</guilabel +></term> +<listitem> +<para +>Det här låter tabulatortangenten infoga ett tabulatortecken.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Indentera aktuell rad</guilabel +></term> +<listitem> +<para +>Det här låter tabulatortangenten indentera aktuell rad.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-open-save"> +<title +>Öppna/Spara</title> + +<variablelist> + +<varlistentry> +<term +><guilabel +>Filformat</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Kodning:</guilabel +></term> +<listitem> +<para +>Det här ställer in förvald teckenkodning för dina filer.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Radslut:</guilabel +></term> +<listitem> +<para +>Välj radslutsläget du föredrar för det aktiva dokumentet. Du kan välja bland &UNIX;, DOS/&Windows; eller MacIntosh.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Automatisk detektering av radslut</guilabel +></term> +<listitem> +<para +>Markera det här om du vill att editorn automatiskt ska detektera radslutstyp. Den första radslutstypen som hittas används för hela filen.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Minnesanvändning</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Maximalt antal laddade block per fil:</guilabel +></term> +<listitem> +<para +>Editorn laddar angivet antal textblock (med omkring 2048 rader) i minnet. Om filstorleken är större än så, växlas andra block ut till disk och laddas transparent efter behov.</para> +<para +>Det kan orsaka små fördröjningar vid navigering i dokumentet. Ett större antal block ökar redigeringshastigheten på bekostnad av minne. </para +><para +>Välj bara det största möjliga antal block för normal användning: begränsa det bara om du har problem med minnesanvändning.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Automatisk rensning vid ladda eller spara</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Ta bort mellanslag i slutet av en rad</guilabel +></term> +<listitem> +<para +>Editorn tar automatiskt bort extra mellanslag i slutet av textrader när filen laddas eller sparas.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Kataloginställningsfil</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Sökdjup för inställningsfil:</guilabel +></term> +<listitem> +<para +>Editorn söker det angivna antalet katalognivåer uppåt efter en &kate; inställningsfil och laddar inställningsraden från den.</para> +</listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Spara säkerhetskopia</guilabel +></term> +<listitem +><para +>Säkerhetskopiering när du sparar gör att &kate; kopierar filen på disk till <prefix><filnamn><suffix> innan ändringarna sparas. Suffixet har normalvärdet <emphasis role="bold" +>~</emphasis +> och prefixet är normalt tomt. </para> +<variablelist> +<varlistentry> +<term +><guilabel +>Lokala filer</guilabel +></term> +<listitem> +<para +>Markera det här om du vill ha säkerhetskopior av lokala filer när du sparar.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Fjärrfiler</guilabel +></term> +<listitem> +<para +>Markera det här om du vill ha säkerhetskopior av fjärrfiler när du sparar.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Prefix</guilabel +></term> +<listitem> +<para +>Skriv in prefixet som ska läggas till i början av den säkerhetskopierade filens namn.</para> +</listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Suffix</guilabel +></term> +<listitem> +<para +>Skriv in suffixet som ska läggas till sist i den säkerhetskopierade filens namn.</para> +</listitem> +</varlistentry> + +</variablelist> +</listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-highlighting"> +<title +>Färgläggning</title> +<para +>Den här gruppen av alternativ används för att anpassa färgläggningsstilarna för varje typ av programmeringsspråk. Alla ändringar du gör i andra områden av dialogrutan gäller bara denna typ.</para> + +<variablelist> +<varlistentry> +<term +><guilabel +>Färglägg:</guilabel +></term> +<listitem +><para +>Det här används för att välja språktyp att ställa in.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Information</guilabel +></term> +<listitem> +<para +>Visa egenskaper för syntaxfärgläggningsregler för det valda språket: upphovsmannens namn och licens. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Egenskaper</guilabel +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><guilabel +>Filändelser:</guilabel +></term> +<listitem +><para +>Det här är listan med filändelser som används för att avgöra vilka filer som ska färgläggas med det nuvarande syntaxfärgläggningsläget.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Mime-typer:</guilabel +></term> +<listitem +><para +>Att klicka på guideknappen visar en dialogruta med en lista över alla tillgängliga Mime-typer att välja bland.</para +><para +>Posten <emphasis role="bold" +>Filändelser</emphasis +> redigeras också automatiskt.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Prioritet:</guilabel +></term> +<listitem +><para +>Ställ in prioritet för färgläggningsregeln.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>Ladda ner...</guibutton +></term> +<listitem> +<para +>Klicka på knappen för att ladda ner nya eller uppdaterade syntaxfärgläggningsbeskrivningar från &kate;s webbplats. </para> +</listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-filetypes"> +<title +>Filtyper</title> +<para +>Den här sidan låter dig överskrida förvalda inställningar för dokument med angivna Mime-typer. När editorn laddar ett dokument, kontrollerar den om det matchar filmasken eller Mime-typerna för en av de definierade filtyperna, och om det är fallet tillämpas variablerna som är definierade. Om mer än en filtyp matchas, används den med högst prioritet. </para> +<variablelist> +<varlistentry> +<term +><guilabel +>Filtyp:</guilabel +></term> +<listitem +><para +>Filtypen med högst prioritet är den som visas först i kombinationsrutan. Om fler filtyper hittas, anges de också.</para> +<variablelist> +<varlistentry> +<term +><guilabel +>Ny</guilabel +></term> +<listitem +><para +>Det här används för att skapa en ny filtyp. Efter du klickat på knappen, blir fälten nedanför tomma och du kan fylla i de egenskaper du vill ha för den nya filtypen.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Ta bort</guilabel +></term> +<listitem +><para +>För att ta bort en befintlig filtyp, markera den i kombinationsrutan och tryck på knappen Ta bort.</para +></listitem> +</varlistentry> +</variablelist> +</listitem +> </varlistentry> + +<varlistentry> +<term +><guilabel +>Egenskaper för aktuell filtyp</guilabel +></term> +<listitem +><para +>Filtypen med högst prioritet är den som visas först i kombinationsrutan. Om fler filtyper hittas, anges de också.</para> +<variablelist> +<varlistentry> +<term +><guilabel +>Namn:</guilabel +></term> +<listitem +><para +>Filtypens namn är texten i motsvarande menyalternativ. Namnet visas i menyn <menuchoice +><guisubmenu +>Verktyg</guisubmenu +> <guisubmenu +>Filtyp</guisubmenu +></menuchoice +>.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Sektion:</guilabel +></term> +<listitem +><para +>Sektionsnamnet används för att organisera filtyper i menyer. Det används också i menyn <menuchoice +><guisubmenu +>Verktyg</guisubmenu +> <guisubmenu +>Filtyp</guisubmenu +></menuchoice +>.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Variabler:</guilabel +></term> +<listitem +><para +>Strängen låter dig ställa in &kate;s inställningar för filer som väljes av den här Mime-typen genom att använda variabler i &kate;. Du kan ställa in nästan alla inställningsalternativ, såsom färgläggning, indenteringsläge, kodning, etc.</para +><para +>För en fullständig lista med kända variabler, se handboken.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Filändelser:</guilabel +></term> +<listitem +><para +>Jokerteckenmasken låter dig välja filer enligt filnamn. En typisk mask använder en asterisk och filändelsen, till exempel <filename +>*.txt; *.text</filename +>. Strängen är en lista med masker åtskilda av semikolon.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Mime-typer:</guilabel +></term> +<listitem +><para +>Visar en guide som hjälper dig att enkelt välja Mime-typer</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Prioritet:</guilabel +></term> +<listitem +><para +>Ställer in en prioritet för filtypen. Om mer än en filtyp väljer samma fil, används den med högst prioritet.</para +></listitem> +</varlistentry> +</variablelist> +</listitem +> </varlistentry> + +</variablelist> +</sect2> + +<sect2 id="config-dialog-editor-shortcuts"> +<title +>Genvägar</title> +<para +>Här kan du ändra inställningen av snabbtangenter. Välj en åtgärd och klicka på <guilabel +>Egen</guilabel +> om du vill ha en annan snabbtangent för åtgärden.</para> +<para +>Sökraden låter dig leta efter en specifik åtgärd och se dess motsvarande snabbtangent.</para> +</sect2> + +<sect2 id="config-dialog-editor-plugins"> +<title +>Insticksprogram</title> +<para +>Den här fliken visar alla tillgängliga insticksprogram, och du kan markera de du vill använda. När ett insticksprogram väl är markerat, aktiveras knappen <guibutton +>Anpassa</guibutton +> och du kan klicka på den för att anpassa det markerade insticksprogrammet.</para> +</sect2> + +</sect1> + + + +<sect1 id="config-variables"> + +<title +>Anpassa med dokumentvariabler</title> + +<para +>Variabler i Kate är Kate-programdelens implementering av dokumentvariabler, som liknar modelines i Emacs och Vi. I Kate-programdelen har raderna formatet <userinput +>kate: VARIABELNAMN VÄRDE; [ VARIABELNAMN VÄRDE; ... ]</userinput +>. Raderna kan förstås finnas i en kommentar, om filen har ett format med kommentarer. Variabelnamn är enstaka ord (inga blanktecken), och allt fram till nästa semikolon är värdet. Semikolonet är nödvändigt.</para> + +<para +>Här är ett exempel på en variabelrad, som styr indenteringsinställningar för en C++, Java eller Javaskript-fil: <programlisting +>// kate: space-indent on; indent-width 4; mixedindent off; indent-mode cstyle;</programlisting> +</para> + +<note +><para +>Bara de första och sista 10 raderna söks igenom efter variabelrader.</para +></note> + +<para +>Det finns variabler som stöder nästan alla inställningar i Kate-programdelen, och ytterligare insticksprogram kan använda variabler, som i så fall ska vara dokumenterade i insticksprogrammets dokumentation.</para> + +<sect2 id="config-variables-howto"> +<title +>Hur Kate använder variabler</title> + +<para +>När inställningarna läses, letar Kate-programdelen på följande ställen (i denna ordning): <itemizedlist +><listitem +><para +>Den allmänna inställningen.</para +></listitem +><listitem +><para +>Valfri sessionsdata.</para +></listitem +><listitem +><para +>Inställningen under "filtyp".</para +></listitem +><listitem +><para +>Dokumentvariabler i själva dokumentet.</para +></listitem +><listitem +><para +>Inställningar som görs under redigering från menyn eller kommandoraden.</para +></listitem +></itemizedlist +> Som du förstår har dokumentvariabler näst högst prioritet. Så fort ett dokument sparas, läses dokumentvariablerna om, och skriver över ändringar som gjorts med menyalternativ eller från kommandoraden.</para> + +<para +>Alla variabler som inte anges nedan lagras i dokumentet och kan läsas av andra objekt, exempelvis insticksprogram, som kan använda dem för egna syften. Det variabelbaserade indenteringsläget använder till exempel dokumentvariabler för sin inställning.</para> + +<para +>Variablerna som anges här dokumenterar &kate; version 2.4. Fler variabler kan läggas till i framtiden. Det finns tre möjliga typer av värden för variabler, med följande giltiga uttryck: <itemizedlist> +<listitem +><para +>BOOL - on|off|true|false|1|0</para +></listitem> +<listitem +><para +>HELTAL - vilket heltal som helst</para +></listitem> +<listitem +><para +>STRÄNG - allt annat</para +></listitem> +</itemizedlist> +</para> + +<variablelist> +<title +>Tillgängliga variabler</title> + +<varlistentry> +<term +><cmdsynopsis +><command +>auto-brackets</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Sätt på eller stäng av automatisk infogning av parenteser.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>auto-center-lines</command +><arg +>HELTAL</arg +></cmdsynopsis +></term> +<listitem +><para +>Ställ in antal rader för automatisk centrering.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>auto-insert-doxygen</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Sätt på eller stäng av infogning av inledande asterisk i Doxygen-kommentarer. Detta har ingen effekt om du inte använder automatisk indentering med C-stil. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>background-color</command +><arg +>STRÄNG</arg +></cmdsynopsis +></term> +<listitem +><para +>Ställ in dokumentets bakgrundsfärg. Värdet måste vara något som kan tolkas som en giltig färg, till exempel "#ff0000".</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>backspace-indents</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Sätt på eller stäng av indentering med backsteg.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>block-selection</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Sätt på eller stäng av blockmarkering.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>bracket-highlight-color</command +><arg +>STRÄNG</arg +></cmdsynopsis +></term> +<listitem +><para +>Ställer in färgen för markering av parenteser. Värdet måste vara något som kan tolkas som en giltig färg, till exempel "#ff0000". </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>current-line-color</command +><arg +>STRÄNG</arg +></cmdsynopsis +></term> +<listitem +><para +>Ställer in färgen för aktuell rad. Värdet måste vara något som kan tolkas som en giltig färg, till exempel "#ff0000".</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>dynamic-word-wrap</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Sätter på eller stänger av dynamisk radbrytning.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>eol | end-of-line</command +><arg +>STRÄNG</arg +></cmdsynopsis +></term> +<listitem +><para +>Ställer in radslutsläget. Giltiga inställningar är <quote +>unix</quote +>, <quote +>mac</quote +> och <quote +>dos</quote +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>encoding</command +><arg +>STRÄNG</arg +></cmdsynopsis +></term> +<listitem +><para +>Ställer in dokumentets kodning. Värdet måste vara ett giltigt kodningsnamn, som <quote +>utf-8</quote +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>font-size</command +><arg +>HELTAL</arg +></cmdsynopsis +></term> +<listitem +><para +>Ställer in teckenstorleken i punkter för dokumentets teckensnitt.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>font</command +><arg +>STRÄNG</arg +></cmdsynopsis +></term> +<listitem +><para +>Ställer in dokumentets teckensnitt. Värdet måste vara ett giltigt teckensnittsnamn, till exempel <quote +>courier</quote +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>icon-bar-color</command +><arg +>STRÄNG</arg +></cmdsynopsis +></term> +<listitem +><para +>Ställer in ikonradens färg. Värdet måste vara något som kan tolkas som en giltig färg, till exempel <literal +>#ff0000</literal +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>icon-border</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Sätter på eller stänger av visning av ikonkanten.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>folding-markers</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Sätter på eller stänger av visning av vikmarkörer.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>indent-mode</command +><arg +>STRÄNG</arg +></cmdsynopsis +></term> +<listitem +><para +>Ställer in automatiskt indenteringsläge. Alternativen <quote +>none</quote +>, <quote +>normal</quote +>, <quote +>cstyle</quote +>, <quote +>csands</quote +>, <quote +>python</quote +> och <quote +>xml</quote +> känns igen. Se avsnittet <xref linkend="kate-part-autoindent"/> för detaljinformation.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>indent-width</command +><arg +>HELTAL</arg +></cmdsynopsis +></term> +<listitem +><para +>Ställ in indenteringsbredden.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>keep-extra-spaces</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Ställer in om extra mellanslag ska behållas när indenteringsbredden beräknas.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>keep-indent-profile</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Om aktiverad, förhindras avindentering av ett block om minst en rad inte har någon indentering.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>line-numbers</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Sätt på eller stäng av visning av radnummer.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>mixed-indent</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Sätter på eller stänger av blandad indentering a la Emacs.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>overwrite-mode</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Sätter på eller stänger av överskrivningsläge.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>persistent-selection</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Sätt på eller stäng av långlivade markeringar.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>remove-trailing-space</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Sätter på eller stänger av dynamisk korrigering av radslut.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>replace-tabs-save</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Sätter på eller stänger av konvertering av tabulatortecken till mellanslag.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>replace-tabs</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Sätter på eller stänger av dynamisk konvertering av tabulatortecken till mellanslag.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>replace-trailing-space-save</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Sätter på eller stänger av korrigering av radslut när dokumentet sparas.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>scheme</command +><arg +>STRÄNG</arg +></cmdsynopsis +></term> +<listitem +><para +>Ställer in färgschemat. Strängen måste vara namnet på ett färgschema som finns i dina inställningar för att ha någon effekt.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>selection-color</command +><arg +>STRÄNG</arg +></cmdsynopsis +></term> +<listitem +><para +>Ställer in markeringsfärgen. Värdet måste vara något som kan tolkas som en giltig färg, till exempel "#ff0000".</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>show-tabs</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Sätter på eller stänger av synligt tabulatortecken.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>smart-home</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Sätter på eller stänger av smart Home-navigering.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>space-indent</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Sätter på eller stänger av indentering med mellanslag.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>tab-indents</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Sätter på eller stänger av indentering med tabulatortecken.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>tab-width</command +><arg +>HELTAL</arg +></cmdsynopsis +></term> +<listitem +><para +>Ställer in tabulatorvisningsbredden.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>undo-steps</command +><arg +>HELTAL</arg +></cmdsynopsis +></term> +<listitem +><para +>Ställer in antalet ångra-steg som ska kommas ihåg.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>word-wrap-column</command +><arg +>HELTAL</arg +></cmdsynopsis +></term> +<listitem +><para +>Ställer in bredden för hård radbrytning.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>word-wrap-marker-color</command +><arg +>STRÄNG</arg +></cmdsynopsis +></term> +<listitem +><para +>Ställer in färgen som markerar radbrytningar. Värdet måste vara något som kan tolkas som en giltig färg, till exempel "#ff0000".</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>word-wrap</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Sätter på eller stänger av hård radbrytning.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><cmdsynopsis +><command +>wrap-cursor</command +><arg +>BOOL</arg +></cmdsynopsis +></term> +<listitem +><para +>Sätter på eller stänger av radbrytningsmarkörer.</para +></listitem> +</varlistentry> + +</variablelist> + +</sect2> + +</sect1> + +</chapter> diff --git a/tde-i18n-sv/docs/kdebase/kate/fundamentals.docbook b/tde-i18n-sv/docs/kdebase/kate/fundamentals.docbook new file mode 100644 index 00000000000..55af3e886cf --- /dev/null +++ b/tde-i18n-sv/docs/kdebase/kate/fundamentals.docbook @@ -0,0 +1,1099 @@ +<chapter id="fundamentals"> +<chapterinfo> +<authorgroup> +<author +><personname +><firstname +></firstname +></personname +></author> +<othercredit role="translator" +> <firstname +>Johan</firstname +> <surname +>Thelmén</surname +> <affiliation +><address +><email +>jth@home.se</email +></address +></affiliation +> <contrib +>Översättare</contrib +></othercredit +> +</authorgroup> +</chapterinfo> +<title +>Grundläggande beskrivning</title> + +<para +>Har du använt en texteditor tidigare kommer du inte få några problem med &kate;. I nästa två avsnitt, <link linkend="starting-kate" +>Starta &kate; </link +> och <link linkend="working-with-kate" +>Arbeta med &kate;</link +> kommer vi visa dig allt du behöver för att snabbt komma igång. </para> + +<sect1 id="starting-kate"> +<title +>Starta &kate;</title> + +<para +>Du kan starta &kate; från <guimenu +>K-menyn</guimenu +> eller från kommandoraden. </para> + +<sect2 id="starting-from-the-menu"> +<title +>Från menyn</title> +<para +>Öppna &kde;:s programmeny genom att klicka på den <guiicon +>stora K</guiicon +>-ikonen längst ner till vänster på skärmen. Då kommer <guimenu +>programmenyn</guimenu +> att dyka upp. Flytta pekaren uppåt till menyalternativet <menuchoice +><guimenu +>Verktyg</guimenu +> <guimenuitem +>Editorer</guimenuitem +></menuchoice +>. En lista med tillgängliga editorer visas. Välj <guimenuitem +>&kate;</guimenuitem +>. </para> + +<para +>Om du inte ställer in &kate; att låta bli, så laddas de sista filerna som du redigerade. Se <link linkend="configure" +>Anpassa &kate;</link +> för att lära dig hur den här funktionen aktiveras och stängs av. </para> + +</sect2> + +<sect2 id="starting-from-the-command-line"> +<title +>Från kommandoraden</title> + +<para +>Du kan starta &kate; genom att skriva dess namn på kommandoraden. Om du anger ett filnamn, som i exemplet nedan, kommer det att öppna eller skapa den här filen. </para> + +<informalexample> +<screen +><prompt +>%</prompt +><userinput +><command +>kate</command +> <option +><replaceable +>minfil.txt</replaceable +></option +></userinput +> +</screen> +</informalexample> + +<para +>Om du har en aktiv anslutning och behörigheter, kan du dra fördel av &kde;:s nätverkstransparens för att öppna filer på Internet. </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 +>Kommandoradsväljare</title> +<para +>&kate; godtar följande argument på kommandoraden:</para> + +<variablelist> +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--help</option +></userinput +></term> +<listitem> +<para +>Visar de mest grundläggande alternativen som är tillgängliga från kommandoraden. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--help-qt</option +></userinput +></term> +<listitem> +<para +>Visar argumenten tillgängliga för att ändra hur &kate; samarbetar med &Qt;. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--help-kde</option +></userinput +></term> +<listitem> +<para +>Visar argumenten tillgängliga för att ändra hur &kate; samarbetar med &kde;. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>-s</option +> <option +>--start</option +> <parameter +>namn</parameter +></userinput +></term> +<listitem> +<para +>Startar Kate med sessionen <parameter +>namn</parameter +>. Sessionen skapas om den inte redan finns. Om en instans av &kate; som kör den angivna sessionen finns, laddas angivna filer i den instansen. När det används med väljaren <option +>--use</option +>, används också en instans som kör den här sessionen. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>-u</option +> <option +>--use</option +> <parameter +>webbadress</parameter +></userinput +></term> +<listitem> +<para +>Gör att &kate; använder en befintlig instans om det finns någon. Om du vill att alla dokument ska öppnas i en instans av Kate, kan du lägga till den här väljaren i det förvalda kommandot i din inställning av KDE-program, samt skapa ett skalalias i kommandotolken om det stöds. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>-p</option +> <option +>--pid</option +> <parameter +>processidentifierare</parameter +></userinput +></term> +<listitem> +<para +>Återanvänder bara en instans med den angivna processidentifikationen (PID). Används med väljaren <option +>--use</option +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--encoding</option +> <parameter +>kodning</parameter +> <parameter +>webbadress</parameter +></userinput +></term> +<listitem +><para +>Använder angiven kodning för dokumentet. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--line</option +> <parameter +>rad</parameter +> <parameter +>webbadress</parameter +></userinput +></term> +<listitem +><para +>Går till angiven rad efter att dokumentet har öppnats. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--column</option +> <parameter +>kolumn</parameter +> <parameter +>webbadress</parameter +></userinput +></term> +<listitem +><para +>Går till angiven kolumn efter att dokumentet har öppnats. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--stdin</option +></userinput +></term> +<listitem +><para +>Läser dokumentets innehåll från standardinmatningen. Det liknar den vanliga väljaren <option +>-</option +> som används av många kommandoradsprogram, och låter dig skicka utdata från ett kommando till &kate; via en rörledning.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--tempfile</option +></userinput +></term> +<listitem +><para +>Från &kate; 2.5.1 stöds den här standardväljaren i &kde;. När den används, behandlas angivna filer som tillfälliga filer och tas bort (om de är lokala filer och du har tillräckliga rättigheter) när de stängs, om de inte har ändrats sedan de öppnades.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--help-all</option +></userinput +></term> +<listitem> +<para +>Visar alla kommandoradsväljare. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--author</option +></userinput +></term> +<listitem> +<para +>Visar &kate;s upphovsmän i terminalfönstret. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>-v</option +> <option +>--version</option +></userinput +></term> +<listitem> +<para +>Anger versionsinformation för &Qt;, &kde; och &kate;. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +><command +>kate</command +> <option +>--license</option +></userinput +></term> +<listitem> +<para +>Visar licensinformation. </para> +</listitem> +</varlistentry> +</variablelist> +</sect3> +</sect2> + +<sect2 id="drag-and-drop"> +<title +>Drag och släpp</title> +<para +>&kate; använder &kde;s drag och släpp protokoll. Filer kan dras och släppas på &kate; från skrivbordet, &konqueror; eller någon FTP-fjärrplats öppnad i ett av &konqueror;s fönster. </para> +</sect2> +</sect1> + +<sect1 id="working-with-kate"> +<title +>Arbeta med &kate;</title> +<para +><link linkend="quick-start" +>Snabbstart</link +> visar dig hur enkelt du kan göra inställningar med fyra enkla alternativ ställa in flera kraftfulla funktioner i &kate;.<link linkend="keystroke-commands" +> Snabbtangenter</link +> visar några förvalda snabbtangentgenvägar för de som inte kan eller vill använda musen. </para> + +<sect2 id="quick-start"> +<title +>Snabbstart</title> + +<para +>Det här kapitlet beskriver några av alternativen på menyn <guimenu +>Inställningar</guimenu +> så att du snabbt kan få &kate; att fungera som du vill. </para> + +<para +>När du startar &kate; för första gången, kommer du att se två fönster med vit bakgrund. Över de två fönstren finns en verktygsrad med de vanliga ikonerna. Och ovanför den, en menyrad. </para> + +<para +>Fönstret till vänster är en sidorad. Det kombinerar dokumentfönstret och filsystembläddraren. Byt mellan de två genom att klicka på flikarna till vänster i fönstret. </para> + +<para +>Om du har startat &kate; med en fil, kommer fönstret till höger att visa filen du redigerar och dokumenten i sidoraden kommer att visa filens namn. Använd filsystembläddraren för att öppna filer. </para> + +<para +>Du kan visa eller dölja dokumentfönstret och filsystembläddraren i menyn <menuchoice +><guimenu +>Fönster</guimenu +> <guimenu +>Verktygsvyer</guimenu +></menuchoice +>. Menyn ger dig ditt första intryck av hur kraftfullt och anpassningsbart &kate; är. I det här avsnittet tittar vi på tre alternativ: </para> + +<variablelist> + +<varlistentry> +<term> +<menuchoice> +<guimenuitem +>Visa eller Dölj dokument</guimenuitem> +</menuchoice> +</term> +<listitem> +<para +>Visar eller döljer dokument. Om dokumentfönstret/filsystembläddraren inte visas, startar &kate; sidoraden som ett separat, odockat, fönster. För att docka fönstret, ta tag i de två tunna parallella linjerna ovanför flikarna genom att klicka på dem med vänster musknapp och hålla nere knappen. Dra fönstret till &kate;s redigeringsfönster och släpp vänsterknappen när du har placerat dokumentfönstret/filsystembläddraren som du föredrar. </para> + +<tip> +<para +>Om du har lyckats ta tag i de två parallella linjerna ändras din musmarkör till två korsande pilar medan du drar. </para> +</tip> + +</listitem> +</varlistentry> +<varlistentry> +<term +><menuchoice +><guimenuitem +>Visa eller Dölj filsystembläddrare</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Visar eller döljer filsystembläddraren. Detta menyval är samma som <guimenuitem +>Visa dokument</guimenuitem +> med en skillnad: När visa väljes startas fönstret med filsystembläddraren överst. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenuitem +>Visa eller Dölj terminal</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Visar eller döljer en terminal i nedre delen av &kate;s fönster. Med andra ord får du en kommandorad inbäddad i programmet. </para> +</listitem> +</varlistentry> +</variablelist> +</sect2> + +<sect2 id="keystroke-commands"> +<title +>Snabbtangenter</title> + +<para +>Många av snabbtangenterna i &kate; är konfigurerbara i menyn <link linkend="settings" +>Inställningar</link +>. Vanligtvis har &kate; följande snabbtangenter. </para> + +<informaltable> +<tgroup cols="2"> +<tbody> + +<row +><entry +><para +><keycap +>Infoga</keycap +></para +></entry> +<entry +><para +>Skiftar mellan lägena Infoga och Skriv över. I läget Infoga kommer editorn att infoga skrivna tecken i texten och skjuta tidigare inskriven data åt höger om textmarkören. Läget Skriv över gör att varje tecken som skrivs in eliminerar det nuvarande tecknet.</para +></entry> +</row> +<row> +<entry +><para +><keycombo +><keycap +>Vänsterpil</keycap +></keycombo +></para +></entry> +<entry +><para +>Flyttar markören ett tecken till vänster </para +></entry> +</row> +<row> +<entry +><para +><keycombo +><keycap +>Högerpil</keycap +></keycombo +></para +></entry> +<entry +><para +>Flyttar markören ett tecken till höger </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Uppåtpil</keycap +></keycombo +></para +></entry> +<entry +><para +>Flyttar markören en rad upp </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Neråtpil</keycap +></keycombo +></para +></entry> +<entry +><para +>Flyttar markören en rad ner </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Page Up</keycap +></keycombo +></para +></entry> +<entry +><para +>Flyttar markören upp en sida </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Page Down</keycap +></keycombo +></para +></entry> +<entry +><para +>Flyttar markören ned en sida </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Backsteg</keycap +></keycombo +></para +></entry> +<entry +><para +>Raderar tecknet till vänster om markören </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Hem</keycap +></keycombo +></para +></entry> +<entry +><para +>Flyttar markören till början av raden </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>End</keycap +></keycombo +></para +></entry> +<entry +><para +>Flyttar markören till slutet på raden </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Ta bort</keycap +></keycombo +></para +></entry> +<entry +><para +>Ta bort tecknet till höger om markören (eller eventuellt vald text)</para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Skift</keycap +> <keycap +>vänsterpil</keycap +></keycombo +></para +></entry> +<entry +><para +>Markerar ett tecken till vänster </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Skift</keycap +> <keycap +>högerpil</keycap +></keycombo +></para +></entry> +<entry +><para +>Markerar ett tecken till höger </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>F1</keycap +></keycombo +></para +></entry> +<entry +><para +>Hjälp</para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>Skift</keycap +> <keycap +>F1</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="whats-this" +>Vad är det här?</link +></para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>F</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="find" +>Sök</link +></para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +><keycap +>F3</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="find-again" +>Sök igen</link +></para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>B</keycap +></keycombo +></para +></entry> +<entry +><para +>Skapar ett Bokmärke</para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>C</keycap +></keycombo +></para +></entry> +<entry +><para +>Kopiera den markerade texten till klippbordet. </para +></entry> +</row> + +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>N</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="new" +>Nytt</link +> dokument</para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>P</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="print" +>Skriv ut</link +> </para +></entry> +</row> +<row> + +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>Q</keycap +></keycombo +></para +></entry> +<entry +><para +>Avslutar - Stänger aktuell editor </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>R</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="replace" +>Ersätt</link +></para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>S</keycap +></keycombo +></para +></entry> +<entry +><para +>Sparar filen.</para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>V</keycap +></keycombo +></para +></entry> +<entry +><para +>Klistra in.</para +></entry> +</row> + +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>X</keycap +></keycombo +></para +></entry> +<entry +><para +>Raderar markerad text och kopierar den till klippbordet. </para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>Z</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="undo" +>Ångra</link +></para +></entry> +</row> +<row> +<entry +><para +><keycombo action="simul" +>&Ctrl;<keycap +>Skift</keycap +><keycap +>Z</keycap +></keycombo +></para +></entry> +<entry +><para +><link linkend="redo" +>Gör om</link +></para +></entry> +</row> +</tbody> +</tgroup> +</informaltable> +</sect2> + +</sect1> + +<sect1 id="fundamentals-using-sessions"> +<title +>Använda sessioner</title> + +<para +>Sessioner är sättet som &kate; använder för att låta dig hantera mer än en lista med filer och inställning av det grafiska gränssnittet. Du kan ha hur många namngivna sessioner som du vill, och du kan använda namnlösa eller anonyma sessioner för filer som du bara vill använda en gång. För närvarande kan &kate; spara listan med öppna filer, och den allmänna fönsterinställningen i sessionen. Framtida versioner av &kate; kan komma att lägga till fler funktioner som kan sparas i sessioner. Med introduktionen av sessioner låter &kate; dig också öppna hur många instanser av programmet som helst, istället för bara en som tidigare var det normala beteendet.</para> + +<para +>Sessioner stöds i tre områden: <itemizedlist> +<listitem +><para +><link linkend="command-line-options" +><emphasis +>Kommandoradsväljare</emphasis +></link +> som låter dig välja och starta sessioner när du startar Kate från kommandoraden.</para> +</listitem> +<listitem +><para +>Menyn <link linkend="sessions-menu" +><emphasis +>Sessioner</emphasis +></link +> som låter dig byta, spara, starta och hantera dina sessioner.</para +></listitem> +<listitem +><para +><link linkend="config-dialog-sessions" +><emphasis +>Inställningsalternativ</emphasis +></link +> som låter dig bestämma hur sessioner i allmänhet ska bete sig.</para +></listitem> +</itemizedlist> + +</para> + +<para +>När en ny session startas, laddas inställningen för det grafiska användargränssnittet <guilabel +>Förvald session</guilabel +>. För att spara fönsterinställningen i den förvalda sessionen, måste du aktivera att fönsterinställningar sparas på inställningssidan för sessioner i inställningsdialogrutan, och därefter ladda förvald session, ställa in fönstret som önskas, och spara sessionen igen.</para> + +<para +>När en namngiven session laddas, visar &kate; sessionsnamnet i början av fönstrets namnlist, som då har formen "<replaceable +>Sessionsnamn</replaceable +>: <replaceable +>Dokumentnamn eller webbadress</replaceable +> - &kate;"</para> + +<para +>När filer öppnas från kommandoraden med <option +>--start <replaceable +>namn</replaceable +></option +> eller om en session väljes med sessionsväljaren, laddas den angivna sessionen innan filerna som anges på kommandoraden. För att öppna filer från kommandoraden med en ny, namnlös session, ställ in Kate att normalt starta en ny session på inställningsdialogrutans sessionssida, eller använda <option +>--start</option +> med en tom sträng: <replaceable +>''</replaceable +>.</para> + +<para +>Från &kate; 2.5.1 exporteras processidentifikationen (<acronym +>PID</acronym +>) för den aktuella instansen till miljövariabeln <envar +>KATE_PID</envar +>. När filer öppnas från den inbyggda terminalen väljer Kate automatiskt den aktuella instansen om ingenting annat anges på kommandoraden.</para> + +<sect2 id="old-behavior"> +<title +>Återställa gammaldags beteende hos &kate;</title> + +<para +>När du vant dig vid att använda sessioner, kommer du förhoppningsvis att märka att de tillhandahåller ett mycket enkelt och effektivt verktyg för att arbeta i olika områden. Om du dock föredrar det gamla beteendet hos &kate; (där en instans öppnar alla filer), kan du enkelt åstadkomma det genom att följa följande enkla strategi: <itemizedlist> +<listitem +><para +>Få Kate att alltid starta med väljaren <option +>--use</option +> genom att lägga till den i kommandot i programinställningarna, och dessutom använda ett skalalias.</para +></listitem> +<listitem +><para +>Anpassa &kate; att ladda den senast använda sessionen vid start.</para> +</listitem> +<listitem +><para +>Anpassa &kate; att spara fillistan när en session stängs. </para +></listitem> +<listitem +><para +>Ladda den förvalda sessionen en gång</para +></listitem> +</itemizedlist> +</para> + +</sect2> + +</sect1> + +<sect1 id="fundamentals-getting-help"> + +<title +>Hämta hjälp</title> + +<sect2> + +<title +>Med &kate;</title> +<variablelist> + +<varlistentry> +<term +>Den här handboken</term> + +<listitem> +<para +>Erbjuder detaljerad dokumentation av alla menykommandon, inställningsalternativ, verktyg, dialogrutor, insticksprogram etc., samt beskrivningar av &kate;s fönster, editorn och diverse koncept som används av programmet.</para> + +<para +>Tryck på <keycap +>F1</keycap +> eller använd menyalternativet <menuchoice +><guimenu +>Hjälp</guimenu +></menuchoice +> <guisubmenu +>Innehåll</guisubmenu +> för att titta i den här handboken.</para +></listitem> + +</varlistentry> + +<varlistentry id="whats-this"> +<term +>Vad är det här hjälp</term> +<listitem> +<para +>Vad är det här hjälp erbjuder omedelbar hjälp med enstaka element i grafiska fönster, som knappar och andra områden i fönster.</para> + +<para +>Vi försöker tillhandahålla Vad är det här hjälp för alla element som det är vettigt. Det är tillgängligt genom hela inställningsdialogrutan, samt i många andra dialogrutor.</para> + +<para +>För att använda Vad är det här hjälp, tryck på <keycombo +><keycap +>Skift</keycap +> <keycap +>F1</keycap +></keycombo +> eller använd menyalternativet <menuchoice +><guimenu +>Hjälp</guimenu +> <guimenuitem +>Vad är det här</guimenuitem +></menuchoice +> för att aktivera Vad är det här läget. Markören ändras till en pil med ett frågetecken, och du kan nu klicka på vilket element som helst i fönstret för att läsa Vad är det här hjälpen för elementet, om den finns tillgänglig.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Hjälpknappar i dialogrutor</term> +<listitem> +<para +>Vissa dialogrutor har en <guibutton +>Hjälp</guibutton +>-knapp. Genom att trycka på den startas Hjälpcentralen, och öppnar motsvarande dokumentation.</para> +</listitem> +</varlistentry> +</variablelist> + +</sect2> + +<sect2> +<title +>Med dina textfiler</title> + +<para +>&kate; tillhandahåller inte (ännu!) något sätt att läsa dokumentrelaterad dokumentation. Beroende på filen som du redigera, kan du märka att den <link linkend="kate-mdi-tools-konsole" +>inbyggda terminalen</link +> är användbar för att visa relaterade &UNIX; manualsidor, eller info-dokumentation, eller också så kan du använda </para> + +</sect2> + +</sect1> + +</chapter> diff --git a/tde-i18n-sv/docs/kdebase/kate/highlighting.docbook b/tde-i18n-sv/docs/kdebase/kate/highlighting.docbook new file mode 100644 index 00000000000..a4d172899f8 --- /dev/null +++ b/tde-i18n-sv/docs/kdebase/kate/highlighting.docbook @@ -0,0 +1,1380 @@ +<appendix id="highlight"> +<appendixinfo> +<authorgroup> +<author +><personname +><firstname +></firstname +></personname +></author> +<othercredit role="translator" +> <firstname +>Johan</firstname +> <surname +>Thelmén</surname +> <affiliation +><address +><email +>jth@home.se</email +></address +></affiliation +> <contrib +>Översättare</contrib +></othercredit +> +</authorgroup> +</appendixinfo> +<title +>Arbeta med syntaxfärgläggning</title> + +<sect1 id="highlight-overview"> + +<title +>Översikt</title> + +<para +>Syntaxfärgläggning är det som gör att editorn automatiskt visar text med olika stilar/färger, beroende på strängens funktion i relation till filens syfte. Till exempel i programkällkod, så kan kontrollsatser visas i fetstil, medan datatyper och kommentarer får annorlunda färg än resten av texten. Det här ökar textens läsbarhet väsentligt, och hjälper på så sätt författaren att vara effektivare och mer produktiv.</para> + +<mediaobject> +<imageobject +><imagedata format="PNG" fileref="highlighted.png"/></imageobject> +<textobject +><phrase +>En funktion i Perl, som visas med syntaxfärgläggning.</phrase +></textobject> +<caption +><para +>En funktion i Perl, som visas med syntaxfärgläggning.</para> +</caption> +</mediaobject> + +<mediaobject> +<imageobject +><imagedata format="PNG" fileref="unhighlighted.png"/></imageobject> +<textobject +><phrase +>Samma kod utan syntaxfärgläggning.</phrase +></textobject> +<caption +><para +>Samma kod utan syntaxfärgläggning.</para +></caption> +</mediaobject> + +<para +>Av de två exemplen, vilket är lättast att läsa?</para> + +<para +>&kate; levereras med ett flexibelt, anpassningsbart och avancerat system för att göra syntaxfärgläggning, och standarddistributionen tillhandahåller definitioner för ett brett område av programspråk, formaterings- och skriptspråk samt andra textfilformat. Dessutom kan du tillhandahålla dina egna definitioner med enkla &XML;-filer.</para> + +<para +>&kate; detekterar automatiskt de riktiga syntaxreglerna när du öppnar en fil, baserat på filens &MIME;-typ, som avgörs av dess filändelse, eller om den inte har någon, dess innehåll. Skulle du råka ut för ett dåligt val, kan du ställa in syntaxen som används för hand med menyn <menuchoice +><guimenu +>Dokument</guimenu +> <guisubmenu +>Färgläggningsläge</guisubmenu +></menuchoice +>.</para> + +<para +>Stilarna och färgerna som används av varje syntaxfärgläggningsläge kan anpassas på sidan <link linkend="config-dialog-editor-appearance" +>Utseende</link +> i <link linkend="config-dialog" +>inställningsdialogrutan</link +>, medan &MIME;-typerna det ska användas för hanteras på sidan <link linkend="config-dialog-editor-highlighting" +>Färgläggning</link +>.</para> + +<note> +<para +>Syntaxfärgläggning finns för att förbättra läsbarheten för riktig text, men du kan inte lita på att den validerar din text. Att markera text för syntax kan vara svårt, beroende på formatet som du använder, och i vissa fall är upphovsmännen till syntaxreglerna stolta om 98 procent av texten visas korrekt, även om du behöver en ovanlig stil för att se de felaktiga 2 procenten.</para> +</note> + +<tip> +<para +>Du kan ladda ner uppdaterade eller nya definitioner av syntaxfärgläggning från &kate;s webbplats genom att klicka på knappen <guibutton +>Ladda ner</guibutton +>på sidan <link linkend="config-dialog-editor-highlighting" +>Färgläggning </link +> i <link linkend="config-dialog" +>inställningsdialogrutan</link +>.</para> +</tip> + +</sect1> + +<sect1 id="katehighlight-system"> + +<title +>&kate;s syntaxfärgläggningssystem</title> + +<para +>Det här avsnittet beskriver &kate;s syntaxfärgläggningsmekanism i mer detalj. Det är avsett för dig, om du vill veta mer om den, eller om du vill skapa och ändra syntaxdefinitioner.</para> + +<sect2 id="katehighlight-howitworks"> + +<title +>Hur det fungerar</title> + +<para +>Så fort du öppnar en fil, är en av de första sakerna som &kate;-editorn gör att avgöra vilken syntaxdefinition som ska användas för filen. När filens text läses in, och medan du skriver i den, så analyserar syntaxfärgläggningssystemet texten enligt reglerna som definieras i syntaxdefinitionen och markerar var i den som olika sammanhang och stilar börjar och slutar.</para> + +<para +>När du skriver in text i dokumentet, så analyseras och markeras den nya texten i farten, så att om du tar bort ett tecken som markeras som början eller slutet på ett sammanhang, så ändras stilen på den omgivande texten i enlighet med detta.</para> + +<para +>Syntaxdefinitioner som används av &kate;s syntaxfärgläggningssystem är &XML;-filer, som innehåller <itemizedlist> +<listitem +><para +>Regler för att detektera funktionen hos text, organiserade i sammanhangsblock</para +></listitem> +<listitem +><para +>Listor med nyckelord</para +></listitem> +<listitem +><para +>Definitioner av stilobjekt</para +></listitem> +</itemizedlist> +</para> + +<para +>När texten analyseras utvärderas detekteringsreglerna i den ordning som de definierades, och om början på den nuvarande strängen matchar en regel, så används motsvarande sammanhang. Startpunkten i texten flyttas till den sista punkten där regeln matchade, och en ny genomgång av reglerna sker, med början i sammanhanget som anges av den matchande regeln.</para> + +</sect2> + +<sect2 id="highlight-system-rules"> +<title +>Regler</title> + +<para +>Detekteringsreglerna är centrala för färgläggningsdetekteringssystemet. En regel är en sträng, ett tecken eller ett reguljärt uttryck som texten som ska analyseras matchas mot. Den innehåller information om vilken stil som ska användas för den delen av texten som matchar. Den kan byta arbetssammanhanget för systemet, antingen till ett sammanhang som anges explicit, eller till det föregående sammanhanget som användes av texten.</para> + +<para +>Reglerna organiseras i sammanhangsgrupper. En sammanhangsgrupp används för de huvudsakliga koncepten i formatets text, till exempel textsträngar inom citationstecken eller kommentarblock i programkällkod. Det här försäkrar att färgläggningssystemet inte behöver gå igenom alla regler när det inte är nödvändigt, och att vissa teckensekvenser i texten kan hanteras annorlunda beroende på det nuvarande sammanhanget. </para> + +<para +>Sammanhang kan skapas dynamiskt för att till exempel tillåta användning av instansspecifik data i regler.</para> + +</sect2> + +<sect2 id="highlight-context-styles-keywords"> +<title +>Sammanhangsstilar och nyckelord</title> + +<para +>I vissa programspråk, hanteras heltal annorlunda än flyttal av kompilatorn (programmet som översätter källkoden till körbart binärformat), och det kan finnas tecken som har en särskild mening i en sträng med citationstecken. I sådana fall är det vettigt att visa dem på ett annat sätt än omgivningen så att de är lätta att identifiera när texten läses. Så även om de inte representerar speciella sammanhang, så kan de betraktas som sådana av syntaxfärgläggningssystemet, så att de kan markeras för att visas på ett annorlunda sätt.</para> + +<para +>En syntaxdefinition kan innehålla så många stilar som krävs för att täcka koncepten i det format den används för.</para> + +<para +>I många format finns det en lista på ord som representerar ett speciellt koncept. Till exempel i programspråk, så är kontrollsatserna ett koncept, namn på datatyper ett annat, och inbyggda funktioner i språket ett tredje. &kate;s syntaxfärgläggningssystem kan använda sådana listor för att detektera och markera ord i texten för att visa koncepten för textformaten.</para> + +</sect2> + +<sect2 id="kate-highlight-system-default-styles"> +<title +>Standardstilar</title> + +<para +>Om du öppnar en C++ källkodsfil, en Java källkodsfil och ett HTML-dokument i &kate;, så ser du att även om formaten är olika, och olika ord därför väljs för särskild behandling, så är färgerna som används samma. Det här beror på att &kate; har en fördefinierad lista med standardstilar, som används av varje individuell syntaxdefinition.</para> + +<para +>Det här gör det lätt att känna igen liknande koncept i olika textformat. Kommentarer finns till exempel i nästa alla program-, skript- eller formateringsspråk, och när de visas med samma stil i alla språk, behöver du inte stanna och tänka efter för att identifiera dem i texten.</para> + +<tip> +<para +>Alla stilar i en syntaxdefinition använder en av standardstilarna. Några få syntaxdefinitioner använder fler stilar än det finns som standard, så om du ofta använder ett format, kan det vara värt att titta i inställningsdialogrutan för att se om några koncept använder samma stil. Det finns till exempel bara en standardstil för strängar, men eftersom programspråket Perl hanterar två sorters strängar, kan du utöka färgläggningen genom att ställa in dessa så att de skiljer sig något. Alla <link linkend="kate-highlight-default-styles" +>tillgängliga standardstilar</link +> förklaras senare.</para> +</tip> + +</sect2> + +</sect1> + +<sect1 id="katehighlight-xml-format"> +<title +>&XML; formatet för syntaxfärgläggningsdefinitioner</title> + +<sect2> +<title +>Översikt</title> + +<para +>Det här avsnittet är en översikt av färgläggningsdefinitionernas &XML;-format. Det beskriver huvudkomponenterna och deras betydelse och användning, och går djupare in i detaljerna för detekteringsreglerna.</para> + +<para +>Den formella definitionen, också kallad en <acronym +>DTD</acronym +>, lagras i filen <filename +>language.dtd</filename +> som ska finnas installerad på ditt system i katalogen <filename +>$<envar +>KDEDIR</envar +>/share/apps/kate/syntax</filename +>. </para> + +<variablelist> +<title +>Huvudkomponenter i &kate;s färgläggningsdefinitioner</title> + +<varlistentry> +<term +>En syntaxfärgläggningsfil innehåller ett huvud som anger XML-versionen och dokumenttypen:</term> +<listitem> +<programlisting +><?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE language SYSTEM "language.dtd"> +</programlisting> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Definitionsfilens rot är elementet <userinput +>language</userinput +>. Följande egenskaper är tillgängliga:</term> + +<listitem> +<para +>Egenskaper som krävs:</para> +<para +><userinput +>name</userinput +> anger språkets namn. Det visas senare i menyer och dialogrutor.</para> +<para +><userinput +>section</userinput +> anger kategorin.</para> +<para +><userinput +>extensions</userinput +> definierar filändelser, som "*.cpp;*.h".</para> + +<para +>Valfria egenskaper:</para> +<para +><userinput +>mimetype</userinput +> kopplar filer baserat på &MIME;-typ.</para> +<para +><userinput +>version</userinput +> anger definitionsfilens aktuella version.</para> +<para +><userinput +>kateversion</userinput +> anger senaste version av &kate; som stöds.</para> +<para +><userinput +>casesensitive</userinput +> definierar om nyckelord är skiftlägeskänsliga eller inte.</para> +<para +><userinput +>priority</userinput +> krävs om en annan syntaxfärgläggningsfil använder samma filändelse. Den högsta prioriteten vinner.</para> +<para +><userinput +>author</userinput +> innehåller författarens namn och e-postadress.</para> +<para +><userinput +>license</userinput +> innehåller licensen, oftast LGPL, Artistic, GPL och andra.</para> +<para +><userinput +>hidden</userinput +> definierar om namnet ska visas i &kate;s menyer.</para> +<para +>Nästa rad kan alltså se ut så här:</para> +<programlisting +><language name="C++" version="1.00" kateversion="2.4" section="Sources" extensions="*.cpp;*.h" /> +</programlisting> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>Därefter kommer elementet <userinput +>highlighting</userinput +> som innehåller det valfria elementet <userinput +>list</userinput +> och det nödvändiga elementen <userinput +>contexts</userinput +> och <userinput +>itemDatas</userinput +>.</term> +<listitem> +<para +><userinput +>list</userinput +> element innehåller en lista med nyckelord. I det här fallet är nyckelorden <emphasis +>class</emphasis +> och <emphasis +>const</emphasis +>. Du kan lägga till så många listor som du behöver.</para> +<para +>Elementet <userinput +>contexts</userinput +> innehåller alla sammanhang. Det första sammanhanget är förvalt som start för färgläggningen. Det finns två regler i sammanhanget <emphasis +>Normal Text</emphasis +> som matchar listan av nyckelord med namnet <emphasis +>något-namn</emphasis +> och en regel som detekterar ett citationstecken och byter sammanhang till <emphasis +>string</emphasis +>. För att lära dig mer om regler, läs nästa kapitel.</para> +<para +>Den tredje delen är elementet <userinput +>itemDatas</userinput +>. Det innehåller alla färger och teckenstilar som behövs av sammanhangen och reglerna. I det här exemplet används <userinput +>itemData</userinput +> <emphasis +>Normal Text</emphasis +>, <emphasis +>String</emphasis +> och <emphasis +>Keyword</emphasis +>. </para> +<programlisting +><highlighting> + <list name="något-namn"> + <item> class </item> + <item> const </item> + </list> + <contexts> + <context attribute="Normal Text" lineEndContext="#pop" name="Normal Text" > + <keyword attribute="Keyword" context="#stay" String="något-namn" /> + <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 +>Den sista delen av färgläggningsdefinitionen är den valfria sektionen <userinput +>general</userinput +>. Den kan innehålla information om nyckelord, kodvikning, kommentarer och indentering.</term> + +<listitem> +<para +>Sektionen <userinput +>comment</userinput +> definierar den sträng som enradskommentarer inleds med. Du kan också definiera flerradskommentarer med <emphasis +>multiLine</emphasis +> och den ytterligare egenskapen <emphasis +>end</emphasis +>. Det är användbart när användaren trycker på snabbtangenten som motsvarar <emphasis +>kommentera/avkommentera</emphasis +>.</para> +<para +>Sektionen <userinput +>keywords</userinput +> definierar om listor med nyckelord är skiftlägeskänsliga eller inte. Andra egenskaper förklaras senare.</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 +>Sektionerna i detalj</title> +<para +>Den här delen beskriver alla tillgängliga egenskaper för sammanhang, itemData, nyckelord, kommentarer, kodvikning och indentering.</para> + +<variablelist> +<varlistentry> +<term +>Elementet <userinput +>context</userinput +> hör till gruppen <userinput +>contexts</userinput +>. Själva sammanhanget definierar sammanhangsspecifika regler, som vad som ska ske om färgläggningssystemet når slutet på en rad. Tillgängliga egenskaper är:</term> + + +<listitem> +<para +><userinput +>name</userinput +> är sammanhangets namn. Regler använder namnet för att ange sammanhanget att byta till om regeln matchar.</para> +<para +><userinput +>lineEndContext</userinput +> definierar sammanhanget som färgläggningssystemet byter till om det når ett radslut. Det kan antingen vara namnet på ett annat sammanhang, <userinput +>#stay</userinput +> för att inte byta sammanhang (dvs. göra ingenting) eller <userinput +>#pop</userinput +> som gör att sammanhanget lämnas. Det är till exempel möjligt att använda <userinput +>#pop#pop#pop</userinput +> för att återgå tre steg.</para> +<para +><userinput +>lineBeginContext</userinput +> definierar sammanhanget om början på en rad påträffas. Förval: #stay.</para> +<para +><userinput +>fallthrough</userinput +>definierar om färgläggningssystemet byter till sammanhanget som anges i fallthroughContext om ingen regel matchar. Förval: <emphasis +>false</emphasis +>.</para> +<para +><userinput +>fallthroughContext</userinput +> anger nästa sammanhang om ingen regel matchar.</para> +<para +><userinput +>dynamic</userinput +> om <emphasis +>true</emphasis +> kommer sammanhanget ihåg strängar/platsmarkörer som sparats av dynamiska regler. Det behövs till exempel för HERE-dokument. Förval: <emphasis +>false</emphasis +>.</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>Elementet <userinput +>itemData</userinput +> är i gruppen <userinput +>itemDatas</userinput +>. Det definierar teckenstilen och färgerna. Det är alltså möjligt att definiera egna stilar och färger, men vi rekommenderar dock att du håller dig till standardstilarna om möjligt, så att användaren alltid ser samma färger använda i olika språk. Ibland finns det dock inget annat sätt, och det är nödvändigt att ändra färg- och teckenegenskaper. Egenskapens namn och defStyleNum krävs, övriga är valfria. Tillgängliga egenskaper är:</term> + +<listitem> +<para +><userinput +>name</userinput +> anger namnet på itemData. Sammanhang och regler använder namnet i egenskapen <emphasis +>attribute</emphasis +> för att referera till itemData.</para> +<para +><userinput +>defStyleNum</userinput +> definierar vilken standardstil som ska användas. Tillgängliga standardstilar förklaras i detalj senare.</para> +<para +><userinput +>color</userinput +> definierar en färg. Giltiga format är '#rrggbb' eller '#rgb'.</para> +<para +><userinput +>selColor</userinput +> definierar markeringens färg.</para> +<para +><userinput +>italic</userinput +> om <emphasis +>true</emphasis +>, är texten kursiv.</para> +<para +><userinput +>bold</userinput +> om <emphasis +>true</emphasis +>, är texten i fetstil.</para> +<para +><userinput +>underline</userinput +> om <emphasis +>true</emphasis +>, är texten understruken.</para> +<para +><userinput +>strikeout</userinput +> om <emphasis +>true</emphasis +>, är texten överstruken.</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>Elementet <userinput +>keywords</userinput +> i gruppen <userinput +>general</userinput +> definierar nyckelordens egenskaper. Tillgängliga egenskaper är:</term> + +<listitem> +<para +><userinput +>casesensitive</userinput +> kan vara <emphasis +>true</emphasis +> eller <emphasis +>false</emphasis +>. Om det är <emphasis +>true</emphasis +>, matchas alla nyckelord skiftlägeskänsligt.</para> +<para +><userinput +>weakDeliminator</userinput +> är en lista med tecken som inte fungerar som ordavgränsare. Punkt <userinput +>'.'</userinput +> är till exempel en ordavgränsare. Med antagandet att ett nyckelord i en <userinput +>list</userinput +> innehåller en punkt, matchar det bara om du anger att punkten är en svag avgränsare.</para> +<para +><userinput +>additionalDeliminator</userinput +> definierar ytterligare avgränsare.</para> +<para +><userinput +>wordWrapDeliminator</userinput +> definierar tecken som en radbrytning kan ske efter.</para> +<para +>Standardavgränsare och radbrytningsavgränsare är tecknen <userinput +>.():!+,-<=>%&*/;?[]^{|}~\</userinput +>, mellanslag (<userinput +>' '</userinput +>) och tabulator (<userinput +>'\t'</userinput +>).</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>Elementet <userinput +>comment</userinput +> i gruppen <userinput +>comments</userinput +> definierar kommentaregenskaper som används för <menuchoice +><guimenu +>Verktyg</guimenu +> <guimenuitem +>Kommentera</guimenuitem +></menuchoice +> och <menuchoice +><guimenu +>Verktyg</guimenu +> <guimenuitem +>Avkommentera</guimenuitem +></menuchoice +>. Tillgängliga egenskaper är:</term> + +<listitem> +<para +><userinput +>name</userinput +> är antingen <emphasis +>singleLine</emphasis +> eller <emphasis +>multiLine</emphasis +>. Om du väljer <emphasis +>multiLine</emphasis +> krävs egenskaperna <emphasis +>end</emphasis +> och <emphasis +>region</emphasis +>.</para> +<para +><userinput +>start</userinput +> definierar strängen som används för att inleda en kommentar. I C++ skulle det vara "/*".</para> +<para +><userinput +>end</userinput +> definierar strängen som används för att avslutar en kommentar. I C++ skulle det vara "*/".</para> +<para +><userinput +>region</userinput +> ska vara namnet på den vikbara flerraderskommentaren. Med antagandet att du har <emphasis +>beginRegion="Comment"</emphasis +> ... <emphasis +>endRegion="Comment"</emphasis +> i dina regler, ska du använda <emphasis +>region="Comment"</emphasis +>. På så sätt fungerar avkommentering även om du inte markerar all text i en flerraderskommentar. Markören måste bara vara inne i flerraderskommentaren.</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>Elementet <userinput +>folding</userinput +> i gruppen <userinput +>general</userinput +> definierar kodvikningsegenskaper. Tillgängliga egenskaper är:</term> + +<listitem> +<para +><userinput +>indentationsensitive</userinput +> om <emphasis +>true</emphasis +> läggs kodvikningsmarkörerna till baserat på indentering, som i skriptspråket Python. Oftast behöver du inte ange det, eftersom det har det förvalda värdet <emphasis +>false</emphasis +>.</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>Elementet <userinput +>indentation</userinput +> i gruppen <userinput +>general</userinput +> definierar vilken identerare som ska användas, även om vi starkt rekommenderar att utelämna elementet, eftersom intenteraren oftast anges genom att definiera en filtyp eller genom att lägga till lägesrader i textfilen. Om du dock anger en indenterare, tvingar du användaren att använda en viss indentering, vilket kanske inte alls uppskattas. Tillgängliga egenskaper är:</term> + +<listitem> +<para +><userinput +>mode</userinput +> är namnet på indenteraren. Indenterare som för närvarande är tillgängliga är:<emphasis +>normal, cstyle, csands, xml, python</emphasis +> och <emphasis +>varindent</emphasis +>.</para> +</listitem> +</varlistentry> + + +</variablelist> + + +</sect2> + +<sect2 id="kate-highlight-default-styles"> +<title +>Tillgängliga standardstilar</title> +<para +>Standardstilar har <link linkend="kate-highlight-system-default-styles" +>redan förklarats</link +>. En kort sammanfattning: Standardstilar är fördefinierade stilar för teckensnitt och färger.</para> +<variablelist> +<varlistentry> +<term +>Här är alltså bara listan med tillgängliga standardstilar:</term> +<listitem> +<para +><userinput +>dsNormal</userinput +>, används för normal text.</para> +<para +><userinput +>dsKeyword</userinput +>, används för nyckelord.</para> +<para +><userinput +>dsDataType</userinput +>, används för datatyper.</para> +<para +><userinput +>dsDecVal</userinput +>, används för decimala värden.</para> +<para +><userinput +>dsBaseN</userinput +>, används för värden med en bas skild från 10.</para> +<para +><userinput +>dsFloat</userinput +>, används för flyttal.</para> +<para +><userinput +>dsChar</userinput +>, används för ett tecken.</para> +<para +><userinput +>dsString</userinput +>, används för strängar.</para> +<para +><userinput +>dsComment</userinput +>, används för kommentarer.</para> +<para +><userinput +>dsOthers</userinput +>, används för 'andra' saker.</para> +<para +><userinput +>dsAlert</userinput +>, används för varningsmeddelanden.</para> +<para +><userinput +>dsFunction</userinput +>, används för funktionsanrop.</para> +<para +><userinput +>dsRegionMarker</userinput +>, används för områdesmarkeringar.</para> +<para +><userinput +>dsError</userinput +>, används för färgläggning av fel och felaktig syntax.</para> +</listitem> +</varlistentry> +</variablelist> + +</sect2> + +</sect1> + +<sect1 id="kate-highlight-rules-detailled"> +<title +>Regler för syntaxdetektering</title> + +<para +>Den här sektionen beskriver reglerna för syntaxdetektering.</para> + +<para +>Varje regel kan matcha noll eller flera tecken i början av strängen som de ska testa. Om regeln matchar, så tilldelas de matchande tecknen stilen eller <emphasis +>egenskapen</emphasis +> som definieras av regeln. En regel kan också begära att det nuvarande sammanhanget byts.</para> + +<para +>En regel ser ut så här:</para> + +<programlisting +><Regelnamn attribute="(identifierare)" context="(identifierare)" [regelspecifika egenskaper] /></programlisting> + +<para +>Ordet <emphasis +>attribute</emphasis +> identifierar stilen som ska användas för tecken som matchar med namn eller index, och <emphasis +>context</emphasis +> identifierar sammanhanget som ska användas i fortsättningen.</para> + +<para +><emphasis +>Sammanhanget</emphasis +> kan identifieras av:</para> + +<itemizedlist> +<listitem> +<para +>En <emphasis +>identifierare</emphasis +>, som är namnet på det andra sammanhanget.</para> +</listitem> +<listitem> +<para +>En <emphasis +>ordning</emphasis +> som talar om att färgläggningen ska stanna kvar i det nuvarande sammanhanget (<userinput +>#stay</userinput +>), eller gå tillbaka till det föregående sammanhanget som använts i strängen (<userinput +>#pop</userinput +>).</para> +<para +>För att gå tillbaka flera steg, kan nyckelordet #pop upprepas: <userinput +>#pop#pop#pop</userinput +></para> +</listitem> +</itemizedlist> + +<para +>Vissa regler kan ha <emphasis +>delregler</emphasis +>, bara utvärderas om huvudregeln matchar. Hela den matchande strängen kommer att få egenskapen som definieras av huvudregeln. En regel med en delregel ser ut så här:</para> + +<programlisting +><Regelnamn (egenskaper)> + <Delregelnamn (egenskaper) /> + ... +</Regelnamn> +</programlisting> + + +<para +>Regelspecifika egenskaper varierar och beskrivs i följande avsnitt.</para> + + +<itemizedlist> +<title +>Gemensamma egenskaper</title> +<para +>Alla regler har följande egenskaper gemensamma och är tillgängliga på alla ställen <userinput +>(gemensamma egenskaper)</userinput +> visas. Egenskaperna <emphasis +>attribute</emphasis +> och <emphasis +>context</emphasis +> är nödvändiga, alla övriga är valfria. </para> + +<listitem> +<para +><emphasis +>attribute</emphasis +>: En egenskap avbildas på en definierad <emphasis +>itemData</emphasis +>.</para> +</listitem> +<listitem> +<para +><emphasis +>context</emphasis +>: Anger sammanhanget som färgläggningssystemet byter till om regeln matchar.</para> +</listitem> +<listitem> +<para +><emphasis +>beginRegion</emphasis +>: Inled ett kodvikningsblock. Förval: unset.</para> +</listitem> +<listitem> +<para +><emphasis +>endRegion</emphasis +>: Avsluta ett kodvikningsblock. Förval: unset.</para> +</listitem> +<listitem> +<para +><emphasis +>lookAhead</emphasis +>: Om <emphasis +>true</emphasis +> behandlar inte färgläggningssystemet matchningens längd. Förval: <emphasis +>false</emphasis +>.</para> +</listitem> +<listitem> +<para +><emphasis +>firstNonSpace</emphasis +>: Matcha bara om strängen är den första förutom blanktecken på raden. Förval: <emphasis +>false</emphasis +>.</para> +</listitem> +<listitem> +<para +><emphasis +>column</emphasis +>: Matcha bara om kolumnen matchar. Förval: unset.</para> +</listitem> +</itemizedlist> + +<itemizedlist> +<title +>Dynamiska regler</title> +<para +>Vissa regler tillåter den valfria egenskapen <userinput +>dynamic</userinput +> med Boolesk typ, som har förvalt värde <emphasis +>false</emphasis +>. Om dynamic är <emphasis +>true</emphasis +>, kan en regel använda platsmarkörer som representerar texten som matchas av en regel med ett <emphasis +>reguljärt uttryck</emphasis +> som byter till nuvarande sammanhang med sin egenskap <userinput +>string</userinput +> eller <userinput +>char</userinput +>. I en <userinput +>string</userinput +> ersätts platsmarkören <replaceable +>%N</replaceable +> (där N är ett tal) med motsvarande <replaceable +>N</replaceable +> i det anropande reguljära uttrycket. I en <userinput +>char</userinput +> måste platsmarkören vara ett tal <replaceable +>N</replaceable +> och det ersätts med första tecknet i motsvarande <replaceable +>N</replaceable +> i det anropande reguljära uttrycket. Närhelst en regel tillåter den här egenskapen, innehåller den <emphasis +>(dynamic)</emphasis +>.</para> + +<listitem> +<para +><emphasis +>dynamic</emphasis +>: kan vara <emphasis +>(true | false)</emphasis +>.</para> +</listitem> +</itemizedlist> + +<sect2 id="highlighting-rules-in-detail"> +<title +>Reglerna i detalj</title> + +<variablelist> +<varlistentry> +<term +>DetectChar</term> +<listitem> +<para +>Detektera ett enda specifikt tecken. Används ofta för att till exempel hitta slutet på strängar inom citationstecken.</para> +<programlisting +><DetectChar char="(tecken)" (gemensamma egenskaper) (dynamisk) /></programlisting> +<para +>Egenskapen <userinput +>char</userinput +> definierar tecknet som ska matchas.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Detect2Chars</term> +<listitem> +<para +>Detektera två angivna tecken i en definierad ordning.</para> +<programlisting +><Detect2Chars char="(tecken)" char1="(tecken)" (gemensamma egenskaper) (dynamisk) /></programlisting> +<para +>Egenskapen <userinput +>char</userinput +> definierar det första tecknet som ska matcha, <userinput +>char1</userinput +> det andra.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>AnyChar</term> +<listitem> +<para +>Detektera ett tecken i en angiven teckenmängd.</para> +<programlisting +><AnyChar String="(sträng)" (gemensamma egenskaper) /></programlisting> +<para +>Egenskapen <userinput +>String</userinput +> definierar teckenmängden.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>StringDetect</term> +<listitem> +<para +>Detektera en sträng exakt.</para> +<programlisting +><StringDetect String="(sträng)" [insensitive="TRUE|FALSE;"] (gemensamma egenskaper) (dynamisk) /></programlisting> +<para +>Egenskapen <userinput +>String</userinput +> definierar strängen som ska matcha. Egenskapen <userinput +>insensitive</userinput +> (okänslig) är normalt <userinput +>FALSE</userinput +> (FALSK) och skickas med till strängjämförelsefunktionen. Om värdet är <userinput +>TRUE</userinput +> (SANT) så används en jämförelse som inte bryr sig om skiftläge.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>RegExpr</term> +<listitem> +<para +>Matchar med ett reguljärt uttryck.</para> +<programlisting +><RegExpr String="(sträng)" [insensitive="TRUE|FALSE;"] [minimal="TRUE| FALSE"] (gemensamma egenskaper) (dynamisk) /></programlisting> +<para +>Egenskapen <userinput +>String</userinput +> definierar det reguljära uttrycket.</para> +<para +>Egenskapen <userinput +>insensitive</userinput +> (okänslig) är normalt <userinput +>FALSE</userinput +> (FALSK) och skickas med det reguljära uttrycket.</para> +<para +>Egenskapen <userinput +>minimal</userinput +> är normalt <userinput +>FALSE</userinput +> (FALSK) och skickas med det reguljära uttrycket.</para> +<para +>Eftersom reglerna alltid matchas mot början av den nuvarande strängen, så anger ett reguljärt uttryck som börjar med en hatt (<literal +>^</literal +>) att regeln bara ska matchas mot radens början.</para> +<para +>Se <link linkend="regular-expressions" +>Reguljära uttryck</link +> för mer information om dem.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>keyword</term> +<listitem> +<para +>Detektera ett nyckelord från en angiven lista.</para> +<programlisting +><keyword String="(listnamn)" (gemensamma egenskaper) /></programlisting> +<para +>Egenskapen <userinput +>String</userinput +> identifierar en lista på nyckelord med namn. En lista med det namnet måste finnas.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Int</term> +<listitem> +<para +>Detektera ett heltal.</para> +<para +><programlisting +><Int (gemensamma egenskaper) (dynamisk) /></programlisting +></para> +<para +>Den här regeln har inga specifika egenskaper. Delregler används typiskt för att detektera kombinationer av <userinput +>L</userinput +> och <userinput +>U</userinput +> efter talet, som anger heltalstypen i programkod. I själva verket tillåts alla regler som delregler, även om <userinput +>DTD</userinput +>:n bara tillåter delregeln <userinput +>StringDetect</userinput +>.</para> +<para +>Följande exempel matchar heltal som följs av tecknet '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 +>Detektera ett flyttal.</para> +<para +><programlisting +><Float (gemensamma egenskaper) /></programlisting +></para> +<para +>Den här regeln har inga specifika egenskaper. <userinput +>AnyChar</userinput +> tillåts som en delregel, och används typiskt för att detektera kombinationer, se regeln <userinput +>Int</userinput +> för en referens.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>HlCOct</term> +<listitem> +<para +>Detektera en oktal talrepresentation.</para> +<para +><programlisting +><HlCOct (gemensamma egenskaper) /></programlisting +></para> +<para +>Den här regeln har inga specifika egenskaper.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>HlCHex</term> +<listitem> +<para +>Detektera en hexadecimal talrepresentation.</para> +<para +><programlisting +><HlCHex (gemensamma egenskaper) /></programlisting +></para> +<para +>Den här regeln har inga specifika egenskaper.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>HlCStringChar</term> +<listitem> +<para +>Detektera ett undantaget tecken.</para> +<para +><programlisting +><HlCStringChar (gemensamma egenskaper) /></programlisting +></para> +<para +>Den här regeln har inga specifika egenskaper.</para> + +<para +>Det matchar bokstavsrepresentationer av osynliga tecken som ofta används i programkod, till exempel <userinput +>\n</userinput +> (nyrad) eller <userinput +>\t</userinput +> (tabulator).</para> + +<para +>Följande tecken matchar om de följer ett bakstreck (<literal +>\</literal +>): <userinput +>abefnrtv"'?</userinput +>. Dessutom matchar undantagna hexadecimala tal, som till exempel <userinput +>\xff</userinput +> och undantagna oktala tal, till exempel <userinput +>\033</userinput +>.</para> + +</listitem> +</varlistentry> + +<varlistentry> +<term +>HlCChar</term> +<listitem> +<para +>Detektera ett C-tecken.</para> +<para +><programlisting +><HlCChar (gemensamma egenskaper) /></programlisting +></para> +<para +>Den här regeln har inga specifika egenskaper.</para> + +<para +>Det matchar C-tecken omgivna av apostrofer (till exempel <userinput +>'c'</userinput +>). Det kan finnas ett enkelt tecken eller en teckenföljd inom apostroferna. Se HlCStringChar för matchade teckenföljder.</para> + +</listitem> +</varlistentry> + +<varlistentry> +<term +>RangeDetect</term> +<listitem> +<para +>Detektera en sträng med definierade start- och sluttecken.</para> +<programlisting +><RangeDetect char="(tecken)" char1="(tecken)" (gemensamma egenskaper) /></programlisting> +<para +><userinput +>char</userinput +> definierar tecknet som inleder intervallet, och <userinput +>char1</userinput +> tecknet som avslutar intervallet.</para> +<para +>Användbar för att till exempel detektera små strängar inom citationstecken och liknande, men observera att eftersom färgläggningen arbetar med en rad i taget, så hittar det här inte strängar som fortsätter på nästa rad.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>LineContinue</term> +<listitem> +<para +>Matchar vid radens slut.</para> +<programlisting +><LineContinue (gemensamma egenskaper) /></programlisting> +<para +>Den här regeln har inga specifika egenskaper.</para> +<para +>Den här regeln är användbar för att byta sammanhang vid radslut, om det sista tecknet är ett bakstreck (<userinput +>'\'</userinput +>). Det behövs till exempel i C/C++ för att fortsätta makron eller strängar.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>IncludeRules</term> +<listitem> +<para +>Inkludera regler från ett annat sammanhang eller språk/fil.</para> +<programlisting +><IncludeRules context="sammanhangslänk" [includeAttrib="true|false"] /></programlisting> + +<para +>Egenskapen <userinput +>context</userinput +> definierar vilket sammanhang som ska inkluderas.</para> +<para +>Om den är en enkelt sträng innehåller den alla definierade regler i det nuvarande sammanhanget, till exempel: <programlisting +><IncludeRules context="annat-sammanhang" /></programlisting +></para> + +<para +>Om strängen börjar med <userinput +>##</userinput +> letar syntaxfärgläggningssystemet efter en annan språkdefinition med det givna namnet, till exempel: <programlisting +><IncludeRules context="##C++" /></programlisting +></para> +<para +>Om egenskapen <userinput +>includeAttrib</userinput +> är <emphasis +>true</emphasis +>, ändras målegenskapen till källans egenskap. Det krävs till exempel för att kommentarer ska fungera om text som matchas av det inkluderade sammanhanget har en annan färgläggning än värdsammanhanget. </para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>DetectSpaces</term> +<listitem> +<para +>Detektera blanktecken.</para> +<programlisting +><DetectSpaces (gemensamma egenskaper) /></programlisting> + +<para +>Den här regeln har inga specifika egenskaper.</para> +<para +>Använd den här regeln om du vet att det kan finnas flera blanktecken framför, till exempel i början av indenterade rader. Regeln hoppar över alla blanktecken på en gång, istället för att prova flera regler och hoppa över en åt gången eftersom den inte matchar.</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>DetectIdentifier</term> +<listitem> +<para +>Detektera strängar för identifierare (som ett reguljärt uttryck: [a-zA-Z_][a-zA-Z0-9_]*).</para> +<programlisting +><DetectIdentifier (gemensamma egenskaper) /></programlisting> + +<para +>Den här regeln har inga specifika egenskaper.</para> +<para +>Använd den här regeln för att hoppa över en sträng med ordtecken på en gång, istället för att testa den med flera regler och hoppa ett steg i taget beroende på att ingenting matchar.</para> +</listitem> +</varlistentry> + +</variablelist> +</sect2> + +<sect2> +<title +>Tips och trick</title> + +<itemizedlist> +<para +>När du väl har förstått hur sammanhangsbyte fungerar blir det enkelt att skriva färgläggningsdefinitioner. Du bör ändå kontrollera noggrant vilken regel du väljer i vilken situation. Reguljära uttryck är mycket kraftfulla, men de är långsamma jämfört med andra regler. Du bör därför ta hänsyn till följande tips. </para> + +<listitem> +<para +>Om du bara matchar två tecken, använd <userinput +>Detect2Chars</userinput +> istället för <userinput +>StringDetect</userinput +>. Samma sak gäller för <userinput +>DetectChar</userinput +>.</para> +</listitem> +<listitem> +<para +>Reguljära uttryck är enkla att använda, men oftast finns det ett annat mycket snabbare sätt att uppnå samma resultat. Antag att du bara vill matcha tecknet <userinput +>'#'</userinput +> om det är det första tecknet på en rad. En lösning baserad på reguljära uttryck skulle se ut så här: <programlisting +><RegExpr attribute="Macro" context="macro" String="^\s*#" /></programlisting +> Du kan uppnå samma sak mycket snabbare med: <programlisting +><DetectChar attribute="Macro" context="macro" char="#" firstNonSpace="true" /></programlisting +> Om du vill matcha det reguljära uttrycket <userinput +>'^#'</userinput +> kan du fortfarande använda <userinput +>DetectChar</userinput +> med egenskapen <userinput +>column="0"</userinput +>. Egenskapen <userinput +>column</userinput +> räknar baserat på tecken, så en tabulator är fortfarande bara ett tecken. </para> +</listitem> +<listitem> +<para +>Du kan byta sammanhang utan att behandla tecken. Antag att du vill byta sammanhang när du stöter på strängen <userinput +>*/</userinput +>, men måste behandla denna sträng i nästa sammanhang. Regeln nedan matchar, och egenskapen <userinput +>lookAhead</userinput +> gör att färgläggningen behåller den matchade strängen för nästa sammanhang. <programlisting +><Detect2Chars attribute="Comment" context="#pop" char="*" char1="/" lookAhead="true" /></programlisting> +</para> +</listitem> +<listitem> +<para +>Använd <userinput +>DetectSpaces</userinput +> om du vet att många blanktecken förekommer.</para> +</listitem> +<listitem> +<para +>Använd <userinput +>DetectIdentifier</userinput +> instället för ett reguljärt uttryck <userinput +>'[a-zA-Z_]\w*'</userinput +>.</para> +</listitem> +<listitem> +<para +>Använd standardstilar överallt du kan. På så sätt finner användaren en bekant miljö.</para> +</listitem> +<listitem> +<para +>Titta i andra XML-filer för att se hur andra implementerade knepiga regler.</para> +</listitem> +<listitem> +<para +>Du kan validera alla XML-filer genom att använda kommandot <command +>xmllint --dtdvalid language.dtd min-syntax.xml</command +>.</para> +</listitem> +<listitem> +<para +>Om du mycket ofta upprepar komplexa reguljära uttryck kan du använda <emphasis +>ENTITETER</emphasis +>. Till exempel:</para> +<programlisting +><?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE language SYSTEM "language.dtd" +[ + <!ENTITY minref "[A-Za-z_:][\w.:_-]*"> +]> +</programlisting> +<para +>Nu kan du använda <emphasis +>&myref;</emphasis +> istället för det reguljära uttrycket.</para> +</listitem> +</itemizedlist> +</sect2> + +</sect1> + +</appendix> diff --git a/tde-i18n-sv/docs/kdebase/kate/index.cache.bz2 b/tde-i18n-sv/docs/kdebase/kate/index.cache.bz2 Binary files differnew file mode 100644 index 00000000000..b9d5ab5c548 --- /dev/null +++ b/tde-i18n-sv/docs/kdebase/kate/index.cache.bz2 diff --git a/tde-i18n-sv/docs/kdebase/kate/index.docbook b/tde-i18n-sv/docs/kdebase/kate/index.docbook new file mode 100644 index 00000000000..35f5a17910a --- /dev/null +++ b/tde-i18n-sv/docs/kdebase/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 "kdebase"> + <!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 % Swedish "INCLUDE" +><!-- change language only here --> +]> + +<book lang="&language;"> +<title +>Handbok &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 +>Johan</firstname +> <surname +>Thelmén</surname +> <affiliation +><address +><email +>jth@home.se</email +></address +></affiliation +> <contrib +>Översättare</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; är en texteditor för programmerare, som kräver &kde; 2.2 eller senare.</para> + +<para +>Denna handbok gäller för &kate; version 2.5.0</para> +</abstract> + +<keywordset> +<keyword +>KDE</keyword> +<keyword +>kdebase</keyword> +<keyword +>Kate</keyword> +<keyword +>text</keyword> +<keyword +>editor</keyword> +<keyword +>programmerare</keyword> +<keyword +>programmering</keyword> +<keyword +>projekt</keyword> +<keyword +>MDI</keyword> +<keyword +>Multi</keyword> +<keyword +>Dokument</keyword> +<keyword +>Gränssnitt</keyword> +<keyword +>terminal</keyword> +<keyword +>konsoll</keyword> +</keywordset> + +</bookinfo> + +<chapter id="introduction"> +<title +>Introduktion</title> + +<para +>Välkommen till &kate;, en texteditor för programmerare som levereras med &kde; 2.2 eller senare. Några av finesserna med &kate; är inställbar syntaxbelysning för programmeringsspråk som C, C++, <acronym +>HTML</acronym +> och bash-skript, möjlighet att skapa och underhålla projekt, hantera flera öppna dokument (multiple document interface) (<acronym +>MDI</acronym +>) och en inbyggd terminalemulator. </para> + +<para +>Men &kate; är mer än en editor för programmerare. Möjligheten att öppna flera filer samtidigt gör den lämplig för redigering av inställningsfiler i tex &UNIX;-system. Denna text är skriven med &kate;. </para> + +<para> +<mediaobject> +<imageobject +><imagedata format="PNG" fileref="kate.png"/></imageobject> +<caption +><para +>Redigering av den här handbokens engelska version...</para +></caption> +</mediaobject> +</para> + +</chapter> + +&fundamentals-chapter; + +&mdi-chapter; + +&part-chapter; + +&plugins-chapter; + +&advanced-chapter; + +&menu-chapter; + +&configuring-chapter; + +<chapter id="credits"> + +<title +>Tack till och Licens</title> + +<para +>&kate;. Program Copyright 2000, 2001, 2002 - 2005 av &kate;s utvecklingsgrupp </para> + +<variablelist> +<title +>&kate;-gruppen</title> +<varlistentry> +<term +>&Christoph.Cullmann; &Christoph.Cullmann.mail;</term> +<listitem +><para +>Projektledare & kärnutvecklare</para +></listitem> +</varlistentry> +<varlistentry> +<term +>&Anders.Lund; &Anders.Lund.mail;</term> +<listitem +><para +>Kärnutvecklare, syntaxfärgläggning för Perl, dokumentation</para +></listitem> +</varlistentry> +<varlistentry> +<term +>&Joseph.Wenninger; &Joseph.Wenninger.mail;</term> +<listitem +><para +>Kärnutvecklare, syntaxfärgläggning</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Michael Bartl <email +>michael.bartl1@chello.at</email +></term> +<listitem +><para +>Kärnutvecklare</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Phlip <email +>phlip_cpp@my-deja.com</email +></term> +<listitem +><para +>Projektkompilatorn</para +></listitem> +</varlistentry> +<varlistentry> +<term +>&Waldo.Bastian; &Waldo.Bastian.mail;</term> +<listitem +><para +>Det häftiga buffringssystemet</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Matt Newell <email +>newellm@proaxis.com</email +></term> +<listitem +><para +>Tester...</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Michael McCallum <email +>gholam@xtra.co.nz</email +></term> +<listitem +><para +>Kärnutvecklare</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Jochen Wilhemly <email +>digisnap@cs.tu-berlin.de</email +></term> +<listitem +><para +>Upphovsman till Kwrite</para +></listitem> +</varlistentry> +<varlistentry> +<term +>&Michael.Koch; &Michael.Koch.mail;</term> +<listitem +><para +>Flyttning av Kwrite till Kparts</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Christian Gebauer <email +>gebauer@bigfoot.com</email +></term> +<listitem +><para +>Inte angivet</para +></listitem> +</varlistentry> +<varlistentry> +<term +>&Simon.Hausmann; &Simon.Hausmann.mail;</term> +<listitem +><para +>Inte angivet</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Glen Parker <email +>glenebob@nwlink.com</email +></term> +<listitem +><para +>Ångra historik för Kwrite, Kspell-integrering</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Scott Manson <email +>sdmanson@alltel.net</email +></term> +<listitem +><para +>Stöd för Kwrite XML-syntaxfärgläggning</para +></listitem> +</varlistentry> +<varlistentry> +<term +>&John.Firebaugh; &John.Firebaugh.mail;</term> +<listitem +><para +>Diverse programfixar</para +></listitem> +</varlistentry> +<varlistentry> +<term +>&Dominik.Haumann; &Dominik.Haumann.mail;</term> +<listitem +><para +>Utvecklare, färgläggningsguide</para +></listitem> +</varlistentry> +</variablelist> + +<variablelist> +<title +>Många andra personer har bidragit:</title> +<varlistentry> +<term +>Matteo Merli <email +>merlim@libero.it</email +></term> +<listitem +><para +>Syntaxfärgläggning för RPM-specifikationsfiler, Diff med mera</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Rocky Scaletta <email +>rocky@purdue.edu</email +></term> +<listitem +><para +>Syntaxfärgläggning för VHDL</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Yury Lebedev </term> +<listitem +><para +>Syntaxfärgläggning för SQL</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Chris Ross</term> +<listitem +><para +>Syntaxfärgläggning för Ferite</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Nick Roux</term> +<listitem +><para +>Syntaxfärgläggning för ILERPG</para +></listitem> +</varlistentry> +<varlistentry> +<term +>John Firebaugh</term> +<listitem +><para +>Färgläggning för Java, och mycket mer</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Carsten Niehaus</term> +<listitem +><para +>Färgläggning för LaTeX</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Per Wigren</term> +<listitem +><para +>Färgläggning för make-filer och Python</para +></listitem> +</varlistentry> +<varlistentry> +<term +>Jan Fritz</term> +<listitem +><para +>Färgläggning för Python</para +></listitem> +</varlistentry> +<varlistentry> +<term +>&Daniel.Naber;</term> +<listitem +><para +>Små felrättningar, XML-insticksprogram</para +></listitem> +</varlistentry> +</variablelist> + +<para +>Dokumentation copyright 2000,2001 &Seth.Rothberg; &Seth.Rothberg.mail;</para> + +<para +>Dokumentation Copyright 2002, 2003, 2005 &Anders.Lund; &Anders.Lund.mail;</para> + +<para +>Översättning Johan Thelmén <email +>jth@linux.nu</email +> 2001-07-13</para +> +&underFDL; &underGPL; </chapter> + +&highlighting-appendix; + +®exp-appendix; + +<appendix id="installation"> +<title +>Installation</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-sv/docs/kdebase/kate/kate.png b/tde-i18n-sv/docs/kdebase/kate/kate.png Binary files differnew file mode 100644 index 00000000000..7d6309beab5 --- /dev/null +++ b/tde-i18n-sv/docs/kdebase/kate/kate.png diff --git a/tde-i18n-sv/docs/kdebase/kate/man-kate.1.docbook b/tde-i18n-sv/docs/kdebase/kate/man-kate.1.docbook new file mode 100644 index 00000000000..a184db61089 --- /dev/null +++ b/tde-i18n-sv/docs/kdebase/kate/man-kate.1.docbook @@ -0,0 +1,292 @@ +<?xml version="1.0" ?> +<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ +<!ENTITY % Swedish "INCLUDE"> +]> + +<refentry lang="&language;"> +<refentryinfo> +<title +>KDE användarhandbok</title> +<author +>&Lauri.Watts; &Lauri.Watts.mail;</author> +<date +>7:e juni, 2005</date +> <productname +>K-skrivbordsmiljön</productname +> </refentryinfo> + +<refmeta> +<refentrytitle +><command +>kate</command +></refentrytitle> +<manvolnum +>1</manvolnum> +</refmeta> + +<refnamediv> +<refname +><command +>kate</command +></refname> +<refpurpose +>Avancerad texteditor för &kde;</refpurpose> +</refnamediv> + +<refsynopsisdiv> +<cmdsynopsis +><command +>kate</command +> <group choice="opt" +><option +>-s, --start</option +> <replaceable +> namn</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 +> namn</replaceable +></group +> <group choice="opt" +><option +>-l, --line</option +> <replaceable +> rad</replaceable +></group +> <group choice="opt" +><option +>-c, --column</option +> <replaceable +> kolumn</replaceable +></group +> <group choice="opt" +><option +>-i, --stdin</option +></group +> <arg choice="opt" +>Allmänna KDE-väljare</arg +> <arg choice="opt" +>Allmänna Qt-väljare</arg +> </cmdsynopsis> +</refsynopsisdiv> + +<refsect1> +<title +>Beskrivning</title> +<para +>&kate; är &kde;:s avancerade texteditor. </para +> +<para +>&kate; tillhandahåller också redigeringsdelen i diverse program, med namnet &kwrite;.</para> +<para +>Några av &kate;s många funktioner omfattar inställningsbar syntaxfärgläggning för språk som går från C och C++ till <acronym +>HTML</acronym +> och Bash-skript, möjlighet att skapa och hantera projekt, ett gränssnitt för flera dokument (<acronym +>MDI</acronym +>), och en inbyggd terminalemulator </para> + +<para +>Men &kate; är mer än en editor för programmerare. Dess möjlighet att öppna flera filer på en gång gör den idealisk för att redigera de många inställningsfilerna i &UNIX;. Det här dokumentet är skrivet med &kate;. </para> + + +</refsect1> + +<refsect1> +<title +>Väljare</title> + +<variablelist> +<varlistentry> +<term +><option +>-s</option +>, <option +>--start</option +> <replaceable +>namn</replaceable +></term> + +<listitem +><para +>Starta &kate; med en given session.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><option +>-u, --use</option +></term> +<listitem +><para +>Använd ett &kate;-program som redan kör.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><option +>-p, --pid</option +> <replaceable +> pid</replaceable +></term> +<listitem +><para +>Försök bara återanvända en instans av Kate med detta <replaceable +>pid</replaceable +>.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><option +>-e, --encoding</option +> <replaceable +> namn</replaceable +></term> +<listitem +><para +>Ange kodning för filen som ska öppnas</para +><para +>Du kan använda det här för att till exempel tvinga en fil att öppnas med formatet UTF-8. (Kommandot <command +>iconv -l</command +> tillhandahåller en lista med kodningar, som kan vara till hjälp för dig.)</para +></listitem> +</varlistentry> +<varlistentry> +<term +><option +>-l, --line</option +> <replaceable +> rad</replaceable +></term> +<listitem +><para +>Flytta till den här raden</para +></listitem> +</varlistentry> +<varlistentry> +<term +><option +>-c, --column</option +> <replaceable +> kolumn</replaceable +></term> +<listitem +><para +>Flytta till den här kolumnen</para +></listitem> +</varlistentry> +<varlistentry> +<term +><option +>-i, --stdin</option +></term> +<listitem +><para +>Läs innehållet från <filename +>standardinmatningen</filename +>.</para +></listitem> +</varlistentry> +</variablelist> + +</refsect1> + +<refsect1> +<title +>Se också</title> + +<para +>kwrite(1)</para> + +<para +>Mer detaljerad användardokumentation är tillgänglig med <ulink url="help:/kate" +>help:/kate</ulink +> (skriv antingen in webbadressen i &konqueror;, eller kör <userinput +><command +>khelpcenter</command +> <parameter +>help:/kate</parameter +></userinput +>).</para> + +<para +>Det finns också ytterligare information tillgänglig på <ulink url="http://kate.kde.org/" +>&kate;s webbplats</ulink +>.</para> +</refsect1> + +<refsect1> +<title +>Exempel</title> + +<para +>För att öppna en fil som heter <filename +>kod.cpp</filename +> på kolumn 15, rad 25, i ett befintligt &kate;-fönster, skulle du kunna använda:</para> +<screen +><userinput +><command +>kate</command +> <option +>-c 15</option +> <option +>-l +25</option +> <option +>-u</option +> <filename +>kod.cpp</filename +></userinput +> </screen> + +<para +>Om du har en aktiv anslutning till Internet, kan du dra fördel av &kde;:s nätverkstransparens för att öppna en fil från en FTP-plats. Om du inte har skrivrättigheter på fjärrservern, öppnas filen bara för läsning och du blir tillfrågad om ett lokalt filnamn att spara i om du gör ändringar. Om du har skrivrättigheter sparas ändringar transparent via nätverket.</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 +>Upphovsmän</title> +<para +>Utvecklare av &kate; är &Christoph.Cullmann; &Christoph.Cullmann.mail;. En fullständig lista med upphovsmän och bidragsgivare är tillgänglig i den fullständiga användarhandboken som omnämns ovan.</para> +</refsect1> + +</refentry> diff --git a/tde-i18n-sv/docs/kdebase/kate/mdi.docbook b/tde-i18n-sv/docs/kdebase/kate/mdi.docbook new file mode 100644 index 00000000000..b157f05e8b8 --- /dev/null +++ b/tde-i18n-sv/docs/kdebase/kate/mdi.docbook @@ -0,0 +1,366 @@ +<chapter id="kate-mdi"> +<chapterinfo> +<authorgroup> +<author +>&Anders.Lund; &Anders.Lund.mail;</author> +<othercredit role="translator" +> <firstname +>Johan</firstname +> <surname +>Thelmén</surname +> <affiliation +><address +><email +>jth@home.se</email +></address +></affiliation +> <contrib +>Översättare</contrib +></othercredit +> +</authorgroup> +</chapterinfo> +<title +>Arbeta med &kate;s multipla dokumentgränssnitt</title> + +<sect1 id="kate-mdi-overview"> +<title +>Översikt</title> + +<para +>Fönster, vy, dokument, ram, editor... Vad betyder de allihop i &kate;s terminologi, och hur får man ut så mycket som möjligt av dem? Det här kapitlet förklarar allt detta, och lite till.</para> + +<sect2 id="kate-mdi-overview-mainwindow"> + +<title +>Huvudfönstret</title> + +<para +><indexterm +><primary +>Huvudfönstret</primary +></indexterm +> Huvudfönstret i &kate; är ett &kde; standardprogramfönster, med tillägg av sidorader som innehåller verktygsvyer. Det har en menyrad med alla de vanliga menyerna, och några till, och en verktygsrad som ger tillgång till ofta använda kommandon.</para> + +<para +>Den viktigaste delen av fönstret är redigeringsområdet, som normalt visar en enda texteditorkomponent, där du kan arbeta med dokument.</para> + +<para +>Dockningsmöjligheterna i fönstret används för verktygsfönster:</para> + +<itemizedlist> +<listitem +><para +><link linkend="kate-mdi-tools-file-list" +>Fillistan</link +></para +></listitem> +<listitem +><para +><link linkend="kate-mdi-tools-file-selector" +>Filsystembläddraren</link +></para +></listitem> +<listitem +><para +><link linkend="kate-mdi-tools-konsole" +>Den inbyggda terminalen</link +></para +></listitem> +</itemizedlist> + +<para +>Och möjligen andra verktygsvyer, som till exempel tillhandahålls av insticksprogram.</para> + +<para +>Verktygsvyer kan placeras i vilken sidorad som helst. För att flytta ett verktyg, högerklicka på dess sidoradsknapp och välj i menyn.</para> + +<para +>En verktygsvy kan markeras som <emphasis +>permanent</emphasis +> i sidoradens meny som visas med höger musknapp. Sidoraden kan innnehålla flera verktyg på en gång, så att när ett verktyg är permanent kan andra verktyg visas samtidigt.</para> + +</sect2> + + +</sect1> + +<sect1 id="kate-mdi-editor"> + +<title +>Redigeringsområdet</title> + +<para +><indexterm +><primary +>Redigeringsområde</primary +></indexterm +> &kate; klarar av att ha mer än ett dokument öppet på samma gång, och också att dela redigeringsområdet i hur många rutor som helst, vilket fungerar på ett liknande sätt som till exempel &konqueror; eller den populära texteditorn <application +>emacs</application +>. På det här sättet kan du titta på flera dokument samtidigt, eller flera instanser av samma dokument, vilket är praktiskt om ditt dokument till exempel innehåller definitioner längst upp som du ofta vill referera till. Eller du skulle kunna titta på en deklarationsfil för ett program i en ruta, medan du redigerar implementeringsfilen i en annan.</para> + +<para +>När ett dokument är tillgängligt i mer än en editor, så visas omedelbart ändringar i en editor också i de andra. Det här omfattar ändringar i texten, samt markering av texten. Sökoperationer eller förflyttning av markören visas bara i den nuvarande editorn.</para> + +<para +>Det är för närvarande inte möjligt att ha flera instanser av samma dokument öppna, på det sättet att en instans redigeras medan den andra inte gör det.</para> + +<para +>När editorn delas i två delar, delas den upp i två lika stora rutor, som båda visar det nuvarande dokumentet för editorn. Den nya rutan är längst ner (i fallet med en horisontell delning) eller till höger (för en vertikal delning). Den nya rutan får fokus, vilket visas med en liten grön punkt i rutan som har fokus.</para> + +</sect1> + +<sect1 id="kate-mdi-tools-file-list"> +<title +>Dokumentlistan</title> + +<para +><indexterm +><primary +>Fillista</primary +></indexterm +> Fillistan visar en lista med alla dokument som för närvarande är öppna i &kate;. Ändrade filer har en liten <guiicon +>diskett</guiicon +>ikon till vänster för att ange detta tillstånd.</para> + +<para +>Om två eller flera filer med samma namn (som finns i olika kataloger) är öppna, så läggs <quote +><2></quote +> till sist i namnet, och så vidare. Verktygstipset för filen visar hela namnet, inklusive sökvägen, och låter dig därmed välja den önskade filen.</para +> <para +>För att visa ett dokument i fönstret som för närvarande är aktivt, klicka på dokumentnamnet i listan.</para> + +<para +>Du kan sortera listan på några olika sätt genom att högerklicka i den och välja i menyn <guisubmenu +>Sortera enligt</guisubmenu +>. Alternativen är: <variablelist> + +<varlistentry> +<term +><guimenuitem +>Öppningsordning</guimenuitem +></term> +<listitem +><para +>Listar dokumenten i ordningen de öppnats.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guimenuitem +>Dokumentnamn</guimenuitem +></term> +<listitem +><para +>Listar dokumenten alfabetiskt enligt namn.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guimenuitem +>Webbadress</guimenuitem +></term> +<listitem +><para +>Listar dokumenten alfabetiskt enligt webbadress.</para +></listitem> +</varlistentry> + +</variablelist> + +</para> + +<para +>Dokumentlistan visar normalt historiken genom att skugga posterna för de senaste dokumenten med en bakgrundsfärg. Om dokumentet har redigerats, tonas extra färg in. Det senaste dokumentet har starkast färg, så att du lätt hittar dokumenten du arbetar med. Funktionen kan stängas av på sidan <link linkend="config-dialog-documentlist" +>Dokumentlista</link +> i inställningsdialogrutan.</para> + +<para +>Den normala platsen i &kate;s fönster är till vänster om redigeringsområdet.</para> +</sect1> + +<sect1 id="kate-mdi-tools-file-selector"> +<title +>Filsystembläddraren</title> + +<para +><indexterm +><primary +>Filsystembläddrare</primary +></indexterm +> Filsystembläddraren är en katalogvy, som låter dig öppna filer i en katalog som visas i den nuvarande rutan.</para> + +<para +>Uppifrån och ner, består filsystembläddraren av följande delar:</para> + +<variablelist> +<varlistentry> +<term +>En verktygsrad</term> +<listitem> +<para +>Den här innehåller vanliga navigationsknappar:</para> +<variablelist> +<varlistentry> +<term +><guibutton +>Hem</guibutton +></term> +<listitem +><para +>Genom att trycka på den här gör att katalogvyn byter till din hemkatalog med kommandot <command +>cd</command +>.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guibutton +>Upp</guibutton +></term> +<listitem +><para +>Det här gör att katalogvyn byter till katalogen omedelbart ovanför den nuvarande med kommandot <command +>cd</command +>, om möjligt.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guibutton +>Bakåt</guibutton +></term> +<listitem +><para +>Gör att katalogvyn byter till katalogen som tidigare visades i historiken med kommandot <command +>cd</command +>. Knappen är inaktiv om det inte finns någon tidigare katalog.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guibutton +>Framåt</guibutton +></term> +<listitem +><para +>Gör att katalogvyn byter till nästa katalog i historiken med kommandot <command +>cd</command +>. Knappen är inaktiv om det inte finns någon nästa katalog.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guibutton +>Synkronisera</guibutton +></term> +<listitem +><para +>Den här knappen gör att katalogvyn byter till katalogen för det nuvarande aktiva dokumentet med kommandot <command +>cd</command +>, om möjligt. Knappen är inaktiv om det nuvarande dokumentet är en ny, osparad fil, eller om katalogen som den finns i inte kan bestämmas.</para +></listitem> +</varlistentry> +</variablelist> + +</listitem> +</varlistentry> + +<varlistentry> +<term +>Ett webbadressfält</term> +<listitem> +<para +>Här kan du skriva in sökvägen till katalogen som ska visas. Inmatningsrutan behåller en lista på de senast inskrivna sökvägarna. För att välja en, använd pilknappen till höger i fältet.</para> +<tip +><para +>Inmatningsrutan har automatisk komplettering av kataloger. Kompletteringsmetoden kan anges via menyn som visas genom att klicka med höger musknapp på textfältet.</para +></tip> +</listitem> +</varlistentry> + +<varlistentry> +<term +>En katalogvy</term> +<listitem +><para +>Det här är &kde;:s standardkatalogvy.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Ett filterfält</term> +<listitem> +<para +>Filterfältet låter dig skriva in ett filter för filerna som visas i katalogvyn. Filtret använder vanliga jokertecken, där mönster måste skiljas åt av blanktecken. Till exempel: <userinput +>*.cpp *.h *.moc</userinput +>.</para> +<para +>För att visa alla filer, skriv in en ensam asterisk <userinput +>*</userinput +>.</para> +<para +>Filterfältet sparar de senaste tio filtren mellan sessioner. För att använda ett, tryck på pilknappen till höger i fältet och välj önskad filtersträng.</para> +</listitem> +</varlistentry> + +</variablelist> + +</sect1> + + +<sect1 id="kate-mdi-tools-konsole"> +<title +>Den inbyggda terminalen</title> + +<para +><indexterm +><primary +>Terminalemulator</primary +></indexterm +> Den inbyggda terminalemulatorn är en kopia av &kde;:s &konsole; terminalprogram, för bekväm användning. Den är tillgänglig via menyalternativet <menuchoice +><guimenu +>Inställningar</guimenu +> <guimenuitem +>Visa terminalemulator</guimenuitem +></menuchoice +> eller genom att trycka på tangenten <keycombo action="simul" +><keycap +>F7</keycap +></keycombo +>, och får fokus så fort den visas. Dessutom, om alternativet <link linkend="config-dialog-general-sync-konsole" +>Synkronisera konsollen med aktivt dokument</link +> är aktiverat, så byter den till katalogen för det nuvarande dokumentet med kommandot <command +>cd</command +>, om möjligt, när den visas, eller när det nuvarande dokumentet byts.</para> + +<para +>Den normala platsen i &kate;:s fönster är längst ner, under redigeringsområdet.</para> + +<para +>Du kan anpassa terminalen, med menyn som visas med höger musknapp. För mer information, se handboken för Terminal.</para> + +</sect1> + +<sect1 id="kate-mdi-tools-externaltools"> +<title +>Externa verktyg</title> + +<para +>I menyn <guimenu +>Verktyg</guimenu +> hittar du en undermeny som heter <guisubmenu +>Externa verktyg</guisubmenu +>. Dessa verktyg startar externa program med data relaterad till det nuvarande dokumentet, till exempel dess webbadress, katalog, text eller markering.</para> + +<para +>Externa verktyg är användardefinierade. Du kan lägga till, redigera eller ta bort verktyg med inställningsrutan <link linkend="config-dialog-externaltools" +>Externa verktyg</link +>. </para> + +</sect1> + +</chapter> diff --git a/tde-i18n-sv/docs/kdebase/kate/menus.docbook b/tde-i18n-sv/docs/kdebase/kate/menus.docbook new file mode 100644 index 00000000000..52a3f3f93b1 --- /dev/null +++ b/tde-i18n-sv/docs/kdebase/kate/menus.docbook @@ -0,0 +1,2228 @@ +<chapter id="menu-entries"> +<chapterinfo> +<authorgroup> +<author +><personname +><firstname +></firstname +></personname +></author> +<othercredit role="translator" +> <firstname +>Johan</firstname +> <surname +>Thelmén</surname +> <affiliation +><address +><email +>jth@home.se</email +></address +></affiliation +> <contrib +>Översättare</contrib +></othercredit +> +</authorgroup> +</chapterinfo> +<title +>Menyalternativ</title> + +<sect1 id="file-menu"> +<title +>Menyn <guimenu +>Arkiv</guimenu +></title> + +<variablelist> +<varlistentry> +<term> +<anchor id="new"/> +<menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>N</keycap +></keycombo +> </shortcut +> <guimenu +>Arkiv</guimenu +> <guimenuitem +>Ny</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Det här kommandot <action +>skapar ett nytt dokument</action +> i redigeringsfönstret. Det nya filnamnet <emphasis +>Namnlös</emphasis +> visas i listan <guibutton +>Dokument</guibutton +> till vänster. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="open"/> +<menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>O</keycap +></keycombo +> </shortcut +> <guimenu +>Arkiv</guimenu +> <guimenuitem +>Öppna...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Visar &kde;:s dialogruta för att öppna filer, som låter dig öppna en eller flera filer. </para> + +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="open-recent"/> +<menuchoice +><guimenu +>Arkiv</guimenu +> <guimenuitem +>Öppna senaste</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Öppnar en undermeny med senast redigerade filer. Väljer du en fil kommer den att <action +>öppnas</action +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="open-with"/> +<menuchoice +><guimenu +>Arkiv</guimenu +> <guimenuitem +>Öppna med</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Den här undermenyn visar en lista med program som är kända för att hantera det nuvarande dokumentets MIME-typ. Genom att välja ett alternativ öppnas det nuvarande dokumentet med det programmet.</para> +<para +>Dessutom gör alternativet <guimenuitem +>Andra...</guimenuitem +> att dialogrutan öppna med visas, som låter dig <action +>välja ett annat program som ska öppna den aktiva filen</action +>. Filen kommer fortfarande att vara öppen i &kate;. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="save"/> +<menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>S</keycap +></keycombo +> </shortcut +> <guimenu +>Arkiv</guimenu +> <guimenuitem +>Spara</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Det här kommandot <action +>sparar din fil</action +>. Använd det ofta. Är filen <emphasis +>Namnlös</emphasis +> blir <guimenuitem +>Spara</guimenuitem +> till <guimenuitem +>Spara som</guimenuitem +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="save-as"/> +<menuchoice +><guimenu +>Arkiv</guimenu +> <guimenuitem +>Spara som...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Detta öppnar dialogrutan för att spara filen. Här kan du också <action +>ge filen ett nytt namn</action +>. Dialogrutan Spara som fungerar precis som dialogrutan Öppna. Du kan navigera i filsystemet, förhandsgranska och filtrera med söksträngar. </para> + +<para +>Skriv filnamnet för filen du ska spara i platsfältet och tryck på knappen <guibutton +>OK</guibutton +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="save-all"/> +<menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>L</keycap +></keycombo +> </shortcut +> <guimenu +>Arkiv</guimenu +> <guimenuitem +>Spara alla</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Det här kommandot <action +>sparar alla ändrade öppna filer</action +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="reload"/> +<menuchoice +><shortcut +> <keycombo action="simul" +><keycap +>F5</keycap +></keycombo +> </shortcut +> <guimenu +>Arkiv</guimenu +> <guimenuitem +>Återinladda (Uppdatera)</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +><action +>Laddar den aktiva filen igen</action +>. Kommandot är användbart om ett annat program eller en annan process har ändrat filen medan den varit öppen i &kate;. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="print"/> +<menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>P</keycap +></keycombo +> </shortcut +> <guimenu +>Arkiv</guimenu +> <guimenuitem +>Skriv ut...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +><action +>Skriver ut aktuell fil</action +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term id="export-as-html"> +<menuchoice +><guimenu +>Arkiv</guimenu +> <guimenuitem +>Exportera som HTML...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Exportera filen med HTML-format så att dokumentet kan visas som en webbsida. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term id="mail"> +<menuchoice +><guimenu +>Arkiv</guimenu +> <guimenuitem +>Skicka e-post...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Öppna ditt e-postprogram och lägg till filen som en bilaga till brevet. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="close"/> +<menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>W</keycap +></keycombo +> </shortcut +> <guimenu +>Arkiv</guimenu +> <guimenuitem +>Stäng</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +><action +>Stänger aktuell fil</action +>. Har du gjort förändringar och inte sparat dessa, kommer du att få en fråga om du vill spara ändringarna innan &kate; stänger filen. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="close-all"/> +<menuchoice +><guimenu +>Arkiv</guimenu +> <guimenuitem +>Stäng alla</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Det här kommandot <action +>stänger alla filer som du har öppna</action +> i &kate;. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="quit"/> +<menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>Q</keycap +></keycombo +> </shortcut +> <guimenu +>Arkiv</guimenu +> <guimenuitem +>Avsluta</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Det här kommandot <action +>avslutar &kate;</action +> och alla filer som redigerades. Har du osparade ändringar, får du frågor om att spara dessa. </para> +</listitem> +</varlistentry> +</variablelist> +</sect1> + +<sect1 id="edit-menu"> +<title +>Menyn <guimenu +>Redigera</guimenu +></title> +<para +>Menyn <guimenu +>Redigera</guimenu +> innehåller en mängd kommandon, som alla arbetar på dokumentet som för närvarande är aktivt.</para> + +<variablelist> +<title +>Menyalternativ</title> +<varlistentry> +<term> +<anchor id="edit-undo"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>Z</keycap +></keycombo +></shortcut +> <guimenu +>Redigera</guimenu +> <guimenuitem +>Ångra</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Ångra det senaste redigeringskommandot (inmatning, kopiering, utklippning etc.)</para> +<note +><para +>Om ihopbuntad ångerfunktion är aktiverad, kan detta ångra flera redigeringskommandon av samma sort, som att skriva in tecken.</para +></note> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-redo"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl; <keycap +>Skift</keycap +> <keycap +>Z</keycap +></keycombo +></shortcut +> <guimenu +>Redigera</guimenu +> <guimenuitem +>Gör om</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Gör om det senast ångrade steget.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-cut"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>X</keycap +></keycombo +></shortcut +> <guimenu +>Redigera</guimenu +> <guimenuitem +>Klipp ut</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Tar bort den markerade texten, om det finns någon, och placerar en kopia av den borttagna texten på klippbordet.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-copy"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>C</keycap +></keycombo +></shortcut +> <guimenu +>Redigera</guimenu +> <guimenuitem +>Kopiera</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Kopierar den markerade texten, om det finns någon, till klippbordet.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-copy-as-html"/> +<menuchoice +><guimenu +>Redigera</guimenu +> <guimenuitem +>Kopiera som HTML</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Kopierar markerad text med syntaxfärgläggningen som HTML-text.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-paste"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>V</keycap +></keycombo +></shortcut +> <guimenu +>Redigera</guimenu +> <guimenuitem +>Klistra in</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Kopierar in det första objektet på klippbordet till editorn på markörens plats.</para> +<note +><para +>Om skriv över markering är aktiverad, så skriver den inklistrade texten över markerad text, om det finns någon.</para +></note> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-select-all"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>A</keycap +></keycombo +></shortcut +> <guimenu +>Redigera</guimenu +> <guimenuitem +>Markera alla</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Markerar all text i editorn.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-deselect"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>A</keycap +></keycombo +></shortcut +> <guimenu +>Redigera</guimenu +> <guimenuitem +>Avmarkera</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Avmarkerar den markerade texten i editorn, om det finns någon.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-toggle-block-selection"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>Skift</keycap +> <keycap +>B</keycap +></keycombo +></shortcut +> <guimenu +>Redigera</guimenu +> <guimenuitem +>Blockmarkeringsläge</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Växlar markeringsläge. När markeringsläget är <quote +>BLOCK</quote +>, kan du göra vertikala markeringar, t.ex. markera kolumn 5 till 10 på rad 9 till 15.</para> +<para +>Statusraden visar det nuvarande värdet för markeringsläget, antingen <quote +>NORM</quote +> eller <quote +>BLOCK</quote +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-find"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>F</keycap +></keycombo +></shortcut +> <guimenu +>Redigera</guimenu +> <guimenuitem +>Sök...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Visa sökdialogrutan som låter dig söka efter text i det redigerade dokumentet.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-find-next"/> +<menuchoice +><shortcut +><keycombo action="simul" +><keycap +>F3</keycap +></keycombo +></shortcut +> <guimenu +>Redigera</guimenu +> <guimenuitem +>Sök nästa</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Gå neråt till nästa ställe där den senaste texten eller reguljära uttrycket som eftersöktes hittas, med början på markörens plats.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-find-previous"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Shift;<keycap +>F3</keycap +></keycombo +></shortcut +> <guimenu +>Redigera</guimenu +> <guimenuitem +>Sök föregående</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Gå uppåt till nästa ställe där den senaste texten eller reguljära uttrycket som eftersöktes hittas, med början på markörens plats.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-replace"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>R</keycap +></keycombo +></shortcut +> <guimenu +>Redigera</guimenu +> <guimenuitem +>Ersätt...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Visa ersättningsdialogrutan som låter dig ersätta en eller flera förekomster av en angiven text med någonting annat.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="edit-go-to-line"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>G</keycap +></keycombo +></shortcut +> <guimenu +>Redigera</guimenu +> <guimenuitem +>Gå till rad...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Visar en dialogruta som låter dig skriva in ett radnummer att visa i dokumentet.</para> +</listitem> +</varlistentry> + +</variablelist> + +</sect1> + +<sect1 id="document-menu"> +<title +>Menyn <guimenu +>Dokument</guimenu +></title> +<para +>Dokumentmenyn tillhandahåller ett menyalternativ för varje öppet dokument. Genom att klicka på ett av dem, får det begärda dokumentet fokus. Om du har flera fönster, visas en editor för dokumentet i det fönster som för närvarande är aktivt.</para> +<para +>Dessutom tillhandahålls kommandon för att bläddra bland dina öppna dokument: <variablelist> +<title +>Menyalternativ</title> + +<varlistentry> +<term> +<anchor id="document-back"/> +<menuchoice +><shortcut +><keycombo action="simul" +><keycap +>Alt</keycap +><keycap +>Vänster</keycap +></keycombo +></shortcut +> <guimenu +>Dokument</guimenu +> <guimenuitem +>Bakåt</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Det här ger det föregående dokumentet i listan fokus. Om du har flera fönster, visas en editor för dokumentet i det fönster som för närvarande är aktivt.</para +> <para +>Ordningen är den som dokumenten öppnades med, istället för en logisk historik. Det här beteendet kan ändras i framtida versioner av &kate;.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="document-forward"/> +<menuchoice +><shortcut +><keycombo action="simul" +><keycap +>Alt</keycap +><keycap +>Höger</keycap +></keycombo +></shortcut +> <guimenu +>Dokument</guimenu +> <guimenuitem +>Framåt</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Det här ger det nästa dokumentet i listan fokus. Om du har flera fönster, visas en editor för dokumentet i det fönster som för närvarande är aktivt.</para> +<para +>Ordningen är den som dokumenten öppnades med, istället för en logisk historik. Det här beteendet kan ändras i framtida versioner av &kate;.</para> +</listitem> +</varlistentry> +</variablelist> +</para> +</sect1> + +<sect1 id="view-menu"> +<title +>Menyn <guimenu +>Visa</guimenu +></title> + +<para +>Menyn <guimenu +>Visa</guimenu +> låter dig hantera inställningar som är specifika för den aktiva editorn, och hantera ramar.</para> + +<variablelist> +<title +>Menyalternativ</title> + +<varlistentry> +<term +><menuchoice +><shortcut +><keycap +>F7</keycap +></shortcut +> <guimenu +>Visa</guimenu +> <guimenuitem +>Byt till kommandorad</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Kommandot växlar visning av den <link linkend="advanced-editing-tools-commandline" +>inbyggda kommandoraden</link +>. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Visa</guimenu +> <guisubmenu +>Schema</guisubmenu +> </menuchoice +></term> +<listitem +><para +>Den här menyn visar tillgängliga scheman. Du kan ändra schema för den nuvarande vyn här. För att ändra förvalt schema måste du använda <link linkend="config-dialog-editor-colors" +>inställningsdialogrutan</link +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +><keycap +>F10</keycap +> </keycombo +></shortcut +> <guimenu +>Visa</guimenu +> <guimenuitem +>Dynamisk radbrytning</guimenuitem +></menuchoice> +</term> +<listitem +><para +>Ändrar dynamisk radbrytning i den nuvarande vyn. Dynamisk ordbrytning gör att all text i en vy blir synlig utan att behöva rulla horisontellt genom att återge en verklig rad på fler synliga rader när det behövs.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Visa</guimenu +><guimenuitem +>Visa/Dölj statisk radbrytningsmarkör</guimenuitem +></menuchoice +></term> +<listitem +><para +>Ändrar visning av en vertikal linje som anger positionen för radbrytningsbredden som är inställd i <link linkend="config-dialog-editor-wrap-words-at" +>inställningsdialogrutan</link +>. Funktionen kräver att du använder ett teckensnitt med verkligt fast breddsteg.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="view-show-icon-border"/> +<menuchoice +><shortcut +><keycombo action="simul" +><keycap +>F6</keycap +></keycombo +></shortcut +> <guimenu +>Visa</guimenu +> <guimenuitem +>Visa/Dölj ikonkant</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Det här är ett alternativ som växlar. Om det aktiveras, visas ikonkanten vid vänsterkanten i den aktiva editorn, och vice versa.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="view-show-line-numbers"/> +<menuchoice +><shortcut +><keycombo action="simul" +><keycap +>F11</keycap +></keycombo +></shortcut +> <guimenu +>Visa</guimenu +> <guimenuitem +>Visa/Dölj radnummer</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Det här är ett alternativ som växlar. Om det aktiveras, visas en ruta med radnummer längs vänsterkanten på den aktiva editorn, och vice versa.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Inställningar</guimenu +> <guimenuitem +>Visa/Dölj rullningslistmarkeringar</guimenuitem +></menuchoice +></term> +<listitem +><para +>Ändrar hur bokmärken (och andra markeringar) åskådliggörs på den vertikala rullningslisten. När de är aktiverade, representeras markeringar av en tunn linje med markeringsfärgen på rullningslisten. Ett klick med musens mittenknapp flyttar vyn till en position nära markeringen.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +><keycap +>F9</keycap +> </keycombo +></shortcut +> <guimenu +>Visa</guimenu +><guimenuitem +>Visa/Dölj vikmarkörer</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Ändrar visning av vikmarkörer till vänster om vyn. Se <link linkend="advanced-editing-tools-code-folding" +>Använda kodvikning</link +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="view-code-folding"/> +<menuchoice> +<guimenuitem +>Kodvikning</guimenuitem> +</menuchoice> +</term> + +<listitem> +<variablelist> +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl; <keycap +>Skift</keycap +><keycap +>-</keycap +></keycombo +></shortcut +> <guimenuitem +>Fäll ihop toppnivå</guimenuitem +></menuchoice> +</term> +<listitem +><para +>Fäll ihop alla toppnivåområden i dokumentet.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl; <keycap +>Skift</keycap +><keycap +>+</keycap +></keycombo +></shortcut +> <guimenuitem +>Expandera toppnivå</guimenuitem +></menuchoice> +</term> +<listitem +><para +>Expandera alla toppnivåområden i dokumentet.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl; <keycap +>-</keycap +></keycombo +></shortcut +> <guimenuitem +>Fäll ihop en lokal nivå</guimenuitem +></menuchoice> +</term> +<listitem +><para +>Fäll ihop området närmast markören.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl; <keycap +>+</keycap +></keycombo +></shortcut +> <guimenuitem +>Expandera en lokal nivå</guimenuitem +></menuchoice> +</term> +<listitem +><para +>Expandera området närmast markören.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> + +</varlistentry> + +</variablelist> + +</sect1> + +<sect1 id="bookmarks-menu"> +<title +>Menyn <guimenu +>Bokmärken</guimenu +></title> + +<para +>Menyn <guimenu +>Bokmärken</guimenu +> låter dig arbeta med bokmärken i dokumentet som för närvarande är aktivt.</para> + +<para +>Under alternativen som beskrivs här, kommer det att finnas ett alternativ för varje bokmärke i det aktiva dokumentet. Texten är några få ord i början på den markerade raden. Välj ett alternativ för att flytta markören till början på den raden. Editorn panorerar om det behövs, för att göra raden synlig.</para> + +<variablelist> + +<title +>Menyalternativ</title> + +<varlistentry> +<term> +<anchor id="bookmarks-toggle-bookmark"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>B</keycap +></keycombo +></shortcut +> <guimenu +>Bokmärken</guimenu +> <guimenuitem +>Nytt/Rensa bokmärke</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Lägger till eller tar bort ett bokmärke på den nuvarande raden i det aktiva dokumentet (om det redan finns, tas det bort, annars läggs det till).</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="bookmarks-clear-bookmarks"/> +<menuchoice +><guimenu +>Bokmärken</guimenu +> <guimenuitem +>Rensa alla bokmärken</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Rensar (tar bort) alla bokmärken i det aktiva dokumentet.</para> +</listitem> +</varlistentry> + +<varlistentry id="bookmarks-previous"> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Alt; <keycap +>Page Up</keycap +></keycombo +></shortcut +> <guimenu +>Bokmärken</guimenu +><guimenuitem +>Föregående</guimenuitem +></menuchoice> +</term> +<listitem +><para +>Det här flyttar markören till början av den första raden ovan med ett bokmärke. Menyalternativets text innehåller radnummer och den inledande texten på raden. Alternativet är bara tillgängligt när det finns ett bokmärke på en rad ovanför markören.</para +></listitem> +</varlistentry> + +<varlistentry id="bookmarks-next"> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Alt; <keycap +>Page Down</keycap +></keycombo +></shortcut +> <guimenu +>Bokmärken</guimenu +><guimenuitem +>Nästa</guimenuitem +></menuchoice +></term> +<listitem +><para +>Det här flyttar markören till början av nästa rad med ett bokmärke. Menyalternativets text innehåller radnummer och den inledande texten på raden. Alternativet är bara tillgängligt när det finns ett bokmärke på en rad nedanför markören.</para +></listitem> +</varlistentry> + +</variablelist> + +</sect1> + +<sect1 id="tools-menu"> + +<title +>Menyn <guimenu +>Verktyg</guimenu +></title> + +<variablelist> + +<varlistentry> +<term +><menuchoice +><guimenu +>Verktyg</guimenu +> <guimenuitem +>Skicka till terminal</guimenuitem +></menuchoice +></term> +<listitem +><para +>Skicka texten som för närvarande är markerad till den inbyggda terminalemulatorn. Någon nyrad läggs inte till efter texten.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Verktyg</guimenu +> <guisubmenu +>Externa verktyg</guisubmenu +></menuchoice +></term> +<listitem +><para +>Den här undermenyn innehåller alla <link linkend="kate-mdi-tools-externaltools" +>externa verktyg</link +> som du har ställt in.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-read-only"/><menuchoice +><guimenu +>Verktyg</guimenu +> <guimenuitem +>Skrivskyddat läge</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Ställer in aktuellt dokument till skrivskyddat läge. Det förhindrar tillägg av all text och alla ändringar av dokumentets formatering.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-filetype"/><menuchoice +><guimenu +>Verktyg</guimenu +> <guimenuitem +>Filtyp</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Välj filtypschema som du föredrar för det aktiva dokumentet. Det skriver över det globala <link linkend="config-dialog-editor-filetypes" +>filtypsläget</link +> som ställts in i <menuchoice +><guimenu +>Inställningar</guimenu +> <guimenuitem +>Anpassa editor...</guimenuitem +></menuchoice +> under fliken Filtyper, men bara för det aktuella dokumentet.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-highlighting"/><menuchoice +><guimenu +>Verktyg</guimenu +> <guimenuitem +>Färgläggning</guimenuitem +></menuchoice +></term> + <listitem> +<para +>Välj färgläggningsschema som du föredrar för det aktiva dokumentet. Det skriver över det globala färgläggningsläget som ställts in i <menuchoice +><guimenu +>Inställningar</guimenu +> <guimenuitem +>Anpassa editor...</guimenuitem +></menuchoice +>, men bara för det aktuella dokumentet.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-indentation"/><menuchoice +><guimenu +>Verktyg</guimenu +> <guimenuitem +>Indentering</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Välj <link linkend="kate-part-autoindent" +>indenteringsstil</link +> som du vill ha för det aktiva dokumentet. Det skriver över det globala indenteringsläget som ställts in i <menuchoice +><guimenu +>Inställningar</guimenu +> <guimenuitem +>Anpassa editor...</guimenuitem +></menuchoice +>, men bara för det aktuella dokumentet.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-encoding"/><menuchoice +><guimenu +>Verktyg</guimenu +> <guimenuitem +>Kodning</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Du kan skriva över den förvalda kodningen inställd i <menuchoice +><guimenu +>Inställningar</guimenu +> <guimenuitem +>Anpassa editor...</guimenuitem +></menuchoice +> under fliken <guilabel +>Öppna/spara</guilabel +> för att ange en annan kodning för det aktuella dokumentet. Kodningen du ställer in här är bara giltig för det aktuella dokumentet.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-end-of-line"/><menuchoice +><guimenu +>Verktyg</guimenu +> <guimenuitem +>Radslut</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Välj radslutsläget som du föredrar för det aktiva dokumentet. Det skriver över det globala radslutsläget som ställts in i <menuchoice +><guimenu +>Inställningar</guimenu +> <guimenuitem +>Anpassa editor...</guimenuitem +></menuchoice +>, men bara för det aktuella dokumentet.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-spelling"/><menuchoice +><guimenu +>Verktyg</guimenu +><guimenuitem +>Stavning...</guimenuitem +></menuchoice> +</term> + +<listitem +><para +><action +>Det här aktiverar programmet för stavningskontroll: ett program konstruerat för att hjälpa användare hitta och korrigera eventuella stavfel.</action +> Att klicka på alternativet startar kontrollen och visar stavningskontrolldialogrutan där användaren kan styra processen. Det finns fyra inställningar vertikalt uppradade i dialogrutans mitt med motsvarande beteckningar omedelbart till vänster. Ovanifrån är de:</para> + +<variablelist> +<varlistentry> +<term +><guilabel +>Okänt ord:</guilabel +></term> +<listitem +><para +>Här anger stavningskontrollen ordet som för närvarande behandlas. Det sker när kontrollen stöter på ett ord som inte finns i dess ordlista: en fil som innehåller en lista med riktigt stavade ord som den jämför varje ord i editorn med.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Ersätt med:</guilabel +></term> +<listitem +><para +>Om kontrollen har några liknande ord i sin ordbok, kommer det första att visas här. Användaren kan acceptera förslaget, skriva in sin egen rättning, eller välja ett annat förslag från nästa ruta.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Föreslagna ord:</guilabel +></term> +<listitem +><para +>Kontrollen kan lista ett antal möjliga ersättningar för ordet som hanteras. Genom att klicka på något av förslagen skrivs ordet in i rutan <guilabel +>Ersätt med</guilabel +> ovanför.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guilabel +>Språk:</guilabel +></term> +<listitem +><para +>Om du har installerat flera ordlistor, kan du välja vilken ordlista/språk som ska användas.</para +></listitem> +</varlistentry> +</variablelist> + +<para +>Till höger i dialogrutan finns fem knappar som låter användaren styra stavningskontrollprocessen. De är:</para> + +<variablelist> +<varlistentry> +<term +><guibutton +>Lägg till i ordlista</guibutton +></term> +<listitem +><para +>Genom att trycka på den här knappen läggs ordet i rutan <guilabel +>Felstavat ord:</guilabel +> till i kontrollens ordbok. Det här betyder att i framtiden kommer kontrollen alltid att anse att det här ordet är rättstavat.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guibutton +>Ersätt</guibutton +></term> +<listitem +><para +>Den här knappen får kontrollen att ersätta ordet som hanteras i dokumentet med ordet i rutan <guilabel +>Ersätt med:</guilabel +>.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guibutton +>Ersätt alla</guibutton +></term> +<listitem +><para +>Den här knappen gör att kontrollen inte bara byter ut det nuvarande <guilabel +>okända ordet</guilabel +> utan också automatiskt gör samma utbyte för alla andra förekomster av det här <guilabel +>okända ordet</guilabel +> i dokumentet.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guibutton +>Ignorera</guibutton +></term> +<listitem +><para +>Genom att aktivera den här knappen kommer kontrollen fortsätta utan att göra några ändringar.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><guibutton +>Ignorera alla</guibutton +></term> +<listitem +><para +>Den här knappen talat om för kontrollen att inte göra något med det nuvarande <guilabel +>okända ordet</guilabel +> och att hoppa över alla andra förekomster av samma ord.</para +> <note +><para +>Det gäller bara nuvarande körning av stavningskontrollen. Om kontrollen körs igen stannar den på samma ord.</para +></note +></listitem> +</varlistentry> +</variablelist> + +<para +>Ytterligare tre knappar är placerade horisontellt längs stavningskontrolldialogrutans underkant. De är:</para> + +<variablelist> +<varlistentry> +<term +><guibutton +>Hjälp</guibutton +></term> +<listitem +><para +>Den här aktiverar &kde;:s hjälpsystem med början på &kate;:s hjälpsidor (det här dokumentet).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>Slutförd</guibutton +></term> +<listitem +><para +>Den här knappen avslutar stavningskontrollprocessen, och återgår till dokumentet.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>Avbryt</guibutton +></term> +<listitem +><para +>Den här knappen avbryter stavningskontrollprocessen, alla ändringar återställs, och du återgår till dokumentet.</para +></listitem> +</varlistentry> +</variablelist> +</listitem> +</varlistentry> +</variablelist> + +<variablelist> +<varlistentry> +<term +><anchor id="tools-spelling-from-cursor"/><menuchoice +><guimenu +>Verktyg</guimenu +> <guimenuitem +>Stavning (från markör)...</guimenuitem +></menuchoice +></term> + <listitem> +<para +>Det här aktiverar programmet för stavningskontroll, men det startar där markören finns istället för från början i dokumentet.</para> + </listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-spellcheck-selection"/><menuchoice +><guimenu +>Verktyg</guimenu +> <guimenuitem +>Stavningskontroll av markering...</guimenuitem +></menuchoice +></term> + <listitem> +<para +>Stavningskontrollerar den aktuella markeringen.</para> + </listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="indent"/><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;<keycap +>I</keycap +></keycombo +></shortcut +> <guimenu +>Verktyg</guimenu +> <guimenuitem +>Indentera</guimenuitem +></menuchoice +></term> +<listitem> +<para +>Det här ökar styckets indentering med ett steg. Stegstorleken beror på <link linkend="config-dialog-editor-indent" +>indenteringsinställningarna</link +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-unindent"/><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>i</keycap +></keycombo +></shortcut +> <guimenu +>Verktyg</guimenu +> <guimenuitem +>Avindentera</guimenuitem +></menuchoice +></term> + +<listitem> +<para +>Det här minskar styckets indentering med ett steg. Stegstorleken beror på <link linkend="config-dialog-editor-indent" +>indenteringsinställningarna</link +>.</para> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-cleanindent"/><menuchoice +><guimenu +>Verktyg</guimenu +> <guimenuitem +>Rensa indentering</guimenuitem +></menuchoice +></term +> <listitem> +<para +>Det här rensar indenteringen för nuvarande markering eller för raden där markören för närvarande befinner sig. Att rensa indenteringen försäkrar dig om att den markerade texten följer indenteringsläget du valt.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-align"/><menuchoice +><guimenu +>Verktyg</guimenu +> <guimenuitem +>Justera</guimenuitem +> </menuchoice +></term> +<listitem> +<para +>Gör att nuvarande rad eller markerade rader justeras om med indenteringsläget och indenteringsinställningarna i dokumentet.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-comment"/><menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>D</keycap +></keycombo +> </shortcut +> <guimenu +>Verktyg</guimenu +> <guimenuitem +>Kommentera</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Det här lägger till ett blanktecken i början på raden där textmarkören befinner sig eller till början av alla markerade rader.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-uncomment"/><menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;&Shift;<keycap +>D</keycap +></keycombo +> </shortcut +> <guimenu +>Verktyg</guimenu +> <guimenuitem +>Avkommentera</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Det här tar bort ett blanktecken (om det finns något) från början på raden där textmarkören befinner sig eller från början av alla markerade rader.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-uppercase"/><menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>U</keycap +></keycombo +> </shortcut +> <guimenu +>Verktyg</guimenu +> <guimenuitem +>Stora bokstäver</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Ändra den markerade texten eller bokstaven efter markören till stora bokstäver.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-lowercase"/><menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;&Shift;<keycap +>U</keycap +></keycombo +> </shortcut +> <guimenu +>Verktyg</guimenu +> <guimenuitem +>Små bokstäver</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Ändra den markerade texten eller bokstaven efter markören till små bokstäver.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-capitalize"/><menuchoice +><shortcut +> <keycombo action="simul" +>&Alt;&Ctrl;<keycap +>U</keycap +></keycombo +> </shortcut +> <guimenu +>Verktyg</guimenu +> <guimenuitem +>Inledande stor bokstav</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Ändra den inledande bokstaven för orden i den markerade texten eller i aktuellt ord till stor bokstav.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-join-lines"/><menuchoice +><shortcut +> <keycombo action="simul" +>&Ctrl;<keycap +>J</keycap +></keycombo +> </shortcut +> <guimenu +>Verktyg</guimenu +> <guimenuitem +>Kombinera rader</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Kombinerar markerade rader, eller den nuvarande raden och raden under den med ett blanktecken som avskiljare. Inledande eller efterföljande blanktecken tas bort för kombinerade rader i ändarna som påverkas.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><anchor id="tools-word-wrap-document"/><menuchoice +><guimenu +>Verktyg</guimenu +> <guimenuitem +>Bryt rader mellan ord i dokumentet</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Utför statisk radbrytning för hela dokumentet. Det betyder att en ny textrad automatiskt börjar när den nuvarande raden överskrider längden som anges av alternativet Bryt rader vid: under fliken Redigering i <menuchoice +><guimenu +>Inställningar</guimenu +> <guimenuitem +>Anpassa editor...</guimenuitem +></menuchoice +>.</para +></listitem> +</varlistentry> + +</variablelist> + + +</sect1> + +<sect1 id="sessions-menu"> +<title +>Menyn <guimenu +>Sessioner</guimenu +></title> + +<para +>Den här menyn innehåller alternativ för att använda och hantera sessioner i &kate;. För mer information, läs <link linkend="fundamentals-using-sessions" +>Använda sessioner</link +>.</para> + +<variablelist> + +<varlistentry id="sessions-new"> +<term +><menuchoice +><guimenu +>Sessioner</guimenu +> <guimenuitem +>Ny</guimenuitem +></menuchoice +></term> +<listitem +><para +>Skapar en ny tom session. Alla filer som för närvarande är öppna kommer att stängas.</para +></listitem> + +</varlistentry> + +<varlistentry id="sessions-open"> +<term +><menuchoice +><guimenu +>Sessioner</guimenu +><guimenuitem +>Öppna...</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Öppnar en befintlig session. Dialogrutan för sessionsval visas för att låta dig välja en.</para +></listitem> +</varlistentry> + +<varlistentry id="sessions-quick-open"> +<term +><menuchoice +><guimenu +>Sessioner</guimenu +><guisubmenu +>Snabböppna</guisubmenu +> </menuchoice +></term> +<listitem +><para +>Den här undermenyn låter dig öppna en befintlig session.</para> +</listitem> +</varlistentry> + +<varlistentry id="sessions-save"> +<term +><menuchoice +><guimenu +>Sessioner</guimenu +><guimenuitem +>Spara</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Sparar nuvarande session. Om sessionen är anonym, blir du tillfrågad om ett sessionsnamn.</para +></listitem> +</varlistentry> + +<varlistentry id="sessions-save-as"> +<term +><menuchoice +><guimenu +>Sessioner</guimenu +><guimenuitem +>Spara som...</guimenuitem +></menuchoice +></term> +<listitem +><para +>Sparar nuvarande session med ett nytt namn. Du blir tillfrågad om namnet att använda.</para +></listitem> +</varlistentry> + +<varlistentry id="sessions-manage"> +<term +><menuchoice +><guimenu +>Sessioner</guimenu +><guimenuitem +>Hantera...</guimenuitem +> </menuchoice +></term> +<listitem +><para +>Visar dialogrutan Sessionshantering som låter dig byta namn på och ta bort sessioner.</para +></listitem> +</varlistentry> + + +</variablelist> + +</sect1> + +<sect1 id="settings-menu"> + +<title +>Menyn <guimenu +>Inställningar</guimenu +></title> + +<para +>Menyn <guimenu +>Inställningar</guimenu +> låter dig ändra egenskaper för huvudfönstret, som att visa/dölja verktygsrader, och ger tillgång till inställningsdialogrutorna.</para> + +<variablelist> + +<varlistentry> +<term> +<anchor id="settings-toolbars"/> +<menuchoice +><guimenu +>Inställningar</guimenu +> <guimenuitem +>Verktygsrader</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Den här undermenyn anger alla tillgängliga verktygsrader. Varje alternativ byter visning av motsvarande verktygsrad.</para> +</listitem> +</varlistentry> + +<varlistentry id="settings-fullscreen"> +<term +><menuchoice +><guimenu +>Inställningar</guimenu +> <guimenuitem +>Fullskärmsläge</guimenuitem +></menuchoice +></term> +<listitem +><para +>Byter fullskärmsvisning.</para> +<note +><para +>Det här kommandot kommer att flyttas till menyn Fönster i en framtida version av &kate;.</para +></note> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="settings-configure-shortcuts"/> +<menuchoice +><guimenu +>Inställningar</guimenu +> <guimenuitem +>Anpassa genvägar...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Visar den välbekanta dialogrutan för att anpassa snabbtangenter i &kde;.</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term> +<anchor id="settings-configure-toolbars"/> +<menuchoice +><guimenu +>Inställningar</guimenu +> <guimenuitem +>Anpassa verktygsrader...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Visar den välbekanta dialogrutan för att anpassa verktygsrader i &kde;.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="settings-configure-kate"/> +<menuchoice +><guimenu +>Inställningar</guimenu +> <guimenuitem +>Anpassa &kate;...</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Startar den huvudsakliga <link linkend="config-dialog" +>inställningsdialogrutan</link +>.</para> +</listitem> +</varlistentry> + +</variablelist> + +</sect1> + +<sect1 id="window-menu"> +<title +>Menyn <guimenu +>Fönster</guimenu +></title> + +<variablelist> +<varlistentry> +<term> +<anchor id="window-new"/> +<menuchoice +><guimenu +>Fönster</guimenu +> <guimenuitem +>Nytt fönster</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +><action +>Öppnar ytterligare en kopia av &kate;</action +>. Den nya kopian är identiskt med originalet. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="window-split-vertical"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>L</keycap +></keycombo +></shortcut +> <guimenu +>Fönster</guimenu +> <guimenuitem +>Dela vertikalt</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Det här delar fönstret (som kan vara det huvudsakliga redigeringsområdet) i två lika stora rutor, med den nya till vänster om den nuvarande. Den nya rutan får fokus, och visar samma dokument som den gamla.</para> +<para +>Se också <link linkend="kate-mdi" +>Arbeta med &kate;s multipla dokumentgränssnitt</link +></para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="window-split-horizontal"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>T</keycap +></keycombo +></shortcut +> <guimenu +>Fönster</guimenu +> <guimenuitem +>Dela horisontellt</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Delar fönstret (som kan vara det huvudsakliga redigeringsområdet) i två lika stora rutor, med den nya längst ner. Den nya rutan får fokus, och visar samma dokument som den gamla.</para> +<para +>Se också <link linkend="kate-mdi" +>Arbeta med &kate;s multipla dokumentgränssnitt</link +></para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="window-close-current"/> +<menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Shift;<keycap +>R</keycap +></keycombo +></shortcut +> <guimenu +>Fönster</guimenu +> <guimenuitem +>Stäng aktuell vy</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Stänger den aktuella rutan. Det här är inaktivt om det bara finns en ruta (det huvudsakliga redigeringsområdet).</para +> <para +>Inga dokument stängs genom att stänga en ruta – de är fortfarande tillgängliga i menyn <link linkend="document-menu" +><guimenu +>Dokument</guimenu +></link +>, samt i fillistan.</para +> <para +>Se också <link linkend="kate-mdi" +>Arbeta med &kate;s multipla dokumentgränssnitt</link +></para> +</listitem> +</varlistentry> + +<varlistentry id="window-next-view"> +<term +><menuchoice +><shortcut +><keycombo action="simul" +><keycap +>F8</keycap +> </keycombo +></shortcut +><guimenu +>Fönster</guimenu +><guimenuitem +>Nästa vy</guimenuitem +></menuchoice +></term> +<listitem +><para +>Fokusera på nästa dokumentvy, om du har delat redigeringsområdet i flera vyer.</para +></listitem> +</varlistentry> + +<varlistentry id="window-previous-view"> +<term +><menuchoice +><shortcut +><keycombo action="simul" +>&Shift;<keycap +>F8</keycap +> </keycombo +></shortcut +><guimenu +>Fönster</guimenu +><guimenuitem +>Föregående vy</guimenuitem +></menuchoice +></term> +<listitem +><para +>Fokusera på föregående dokumentvy, om du har delat redigeringsområdet i flera vyer.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><menuchoice +><guimenu +>Fönster</guimenu +><guisubmenu +>Verktygsvyer</guisubmenu +> </menuchoice +></term> +<listitem> +<variablelist> +<varlistentry> +<term +><anchor id="window-toolviews-show-sidebars"/> +<menuchoice +><guimenu +>Fönster</guimenu +> <guimenuitem +>Verktygsvyer</guimenuitem +> <guimenuitem +>Visa/Dölj sidorader</guimenuitem +></menuchoice +></term> +<listitem +><para +>Byter visning av sidoradens knapprader. Kommandot påverkar inte visning av sidoradens innehållskomponenter, alla sidorader som är synliga kommer att förbli synliga, och om du tilldelat snabbtangenter till kommandona nedan kommer de förstås att fortsätta fungera.</para +></listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="window-toolviews-show-filelist"/> +<menuchoice +><guimenu +>Fönster</guimenu +> <guimenuitem +>Verktygsvyer</guimenuitem +> <guimenuitem +>Visa dokument</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Visar eller döljer &kate;s dokumentlista</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="window-toolviews-show-fileselector"/> +<menuchoice +><guimenu +>Fönster</guimenu +> <guimenuitem +>Verktygsvyer</guimenuitem +> <guimenuitem +>Visa/Dölj Filsystembläddrare</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Visar eller döljer &kate;s filsystembläddrare</para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="window-toolviews-greptool"/> +<menuchoice +><guimenu +>Fönster</guimenu +> <guimenuitem +>Verktygsvyer</guimenuitem +> <guimenuitem +>Visa/Dölj Sök i filer</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Visar eller döljer &kate;s verktyg <guilabel +>Sök i filer</guilabel +>. </para> +</listitem> +</varlistentry> + +<varlistentry> +<term> +<anchor id="window-toolviews-show-konsole"/> +<menuchoice +><guimenu +>Fönster</guimenu +> <guimenuitem +>Verktygsvyer</guimenuitem +> <guimenuitem +>Visa/Dölj Terminal</guimenuitem +> </menuchoice> +</term> +<listitem> +<para +>Visar eller gömmer den inbyggda terminalemulatorn.</para> +<para +>När det aktiveras för första gången, skapas terminalen.</para> +<para +>När terminalemulatorn visas, så får den fokus, så att du kan börja skriva in kommandon omedelbart. Om alternativet <link linkend="config-dialog-general-sync-konsole" +>Synkronisera konsollen med aktivt dokument</link +> är aktiverat på sidan <link linkend="config-dialog-general" +>Allmänt</link +> i den huvudsakliga <link linkend="config-dialog" +>inställningsdialogrutan</link +>, så byter skalsessionen arbetskatalog till katalogen för det aktiva dokumentet, om det är en lokal fil.</para> +</listitem> +</varlistentry> + +</variablelist> + +</listitem> +</varlistentry> + +</variablelist> + +</sect1> + +<sect1 id="help-menu"> + +<title +>Menyn <guimenu +>Hjälp</guimenu +></title> + +<para +>Förutom &kde;:s standardmenyalternativ under <guimenu +>Hjälp</guimenu +> som beskrivs nedan, finns det menyalternativ som visar handböcker för installerade insticksprogram.</para> +&help.menu.documentation; </sect1> + +</chapter> diff --git a/tde-i18n-sv/docs/kdebase/kate/mimetypechooser.png b/tde-i18n-sv/docs/kdebase/kate/mimetypechooser.png Binary files differnew file mode 100644 index 00000000000..177c17c9183 --- /dev/null +++ b/tde-i18n-sv/docs/kdebase/kate/mimetypechooser.png diff --git a/tde-i18n-sv/docs/kdebase/kate/part.docbook b/tde-i18n-sv/docs/kdebase/kate/part.docbook new file mode 100644 index 00000000000..8cdc9d70ada --- /dev/null +++ b/tde-i18n-sv/docs/kdebase/kate/part.docbook @@ -0,0 +1,998 @@ +<chapter id="kate-part"> +<chapterinfo> +<authorgroup> +<author +>&Anders.Lund; &Anders.Lund.mail;</author> +<othercredit role="translator" +> <firstname +>Johan</firstname +> <surname +>Thelmén</surname +> <affiliation +><address +><email +>jth@home.se</email +></address +></affiliation +> <contrib +>Översättare</contrib +></othercredit +> +</authorgroup> +</chapterinfo> +<title +>Arbeta med &kate;-editorn</title> + +<sect1 id="kate-part-overview"> + +<title +>Översikt</title> + +<para +>&kate;-editorn redigeringsområdet i &kate;s fönster. Den här editorn används också av &kwrite;, och kan användas i &konqueror; för att visa textfiler från den lokala datorn, eller från nätverket.</para> + +<para +>Editorn består av följande komponenter:</para> + +<variablelist> + +<varlistentry> +<term +>Redigeringsområdet</term> +<listitem +><para +>Det här är platsen där texten i ditt dokument finns.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Rullningslisterna</term> +<listitem> +<para +>Rullningslisterna anger positionen av den synliga delen av dokumentets text, och kan användas för att flytta omkring i dokumentet. Att dra i rullningslisterna gör inte att infogningsmarkören flyttar sig.</para> +<para +>Rullningslisterna visas eller göms efter behov.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Ikonkanten</term> +<listitem> +<para +>Ikonkanten är en smal ruta till vänster om editorn, som visar en liten ikon intill markerade rader.</para> +<para +>Du kan lägga till eller ta bort ett <link linkend="kate-part-bookmarks" +>bokmärke</link +> för en synlig rad genom att klicka med vänster musknapp i ikonkanten intill raden.</para> +<para +>Visning av ikonkanten kan ändras med menyalternativet <menuchoice +><guimenu +>Visa</guimenu +> <guimenuitem +>Visa ikonkant</guimenuitem +></menuchoice +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Radnummerrutan</term> +<listitem> +<para +>Rutan med radnummer visar radnummer för alla synliga rader i dokumentet.</para> +<para +>Visning av radnummer kan ändras med menyalternativet <menuchoice +><guimenu +>Visa</guimenu +> <guimenuitem +>Visa radnummer</guimenuitem +></menuchoice +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Kodvikningsrutan</term> +<listitem> +<para +>Kodvikningsrutan låter dig fälla ihop eller expandera block av rader som kan fällas ihop. Beräkningen av områden som kan fällas ihop görs enligt reglerna i definitionen av syntaxfärgläggning för dokumentet.</para> +</listitem> +</varlistentry> + +</variablelist> + +<itemizedlist> +<title +>Också i det här kapitlet:</title> +<listitem +><para +><link linkend="kate-part-navigation" +>Flytta sig i texten</link +> </para +></listitem> +<listitem +><para +><link linkend="kate-part-selection" +>Arbeta med markeringar</link +></para +></listitem> +<listitem +><para +><link linkend="kate-part-copy-and-paste" +>Kopiera och klistra in text</link +></para +></listitem> +<listitem +><para +><link linkend="kate-part-find-replace" +>Söka och ersätta text</link +></para +></listitem> +<listitem +><para +><link linkend="kate-part-bookmarks" +>Att använda bokmärken</link +></para +></listitem> +<listitem +><para +><link linkend="kate-part-auto-wrap" +>Automatiskt radbryta text</link +></para +></listitem> +<listitem +><para +><link linkend="kate-part-autoindent" +>Att använda automatisk indentering</link +></para +></listitem> +</itemizedlist> + +</sect1> + +<sect1 id="kate-part-navigation"> +<title +>Flytta sig i texten</title> + +<para +>Att flytta omkring i texten i &kate; sker på samma sätt som i de flesta grafiska texteditorer. Du flyttar markören med piltangenterna och tangenterna <keycap +>Page Up</keycap +>, <keycap +>Page Down</keycap +>, <keycap +>Home</keycap +> och <keycap +>End</keycap +> tillsammans med väljartangenterna <keycap +>Ctrl</keycap +> and <keycap +>Skift</keycap +>. Tangenten <keycap +>Skift</keycap +> används alltid för att skapa en markering, medan tangenten <keycap +>Ctrl</keycap +> har olika effekt för olika tangenter: <itemizedlist> +<listitem +><para +>För tangenterna <keycap +>Upp</keycap +> och <keycap +>Ner</keycap +> betyder den rulla istället för att flytta markören.</para +></listitem> +<listitem +><para +>För tangenterna <keycap +>Vänster</keycap +> och <keycap +>Höger</keycap +> betyder den hoppa över ord istället för tecken.</para +></listitem> +<listitem +><para +>För tangenterna <keycap +>Page Up</keycap +> och <keycap +>Page Down</keycap +> betyder den att gå till vyns synliga kant istället för att bläddra.</para> +</listitem> +<listitem +><para +>För tangenterna <keycap +>Home</keycap +> och <keycap +>End</keycap +> betyder den att gå till dokumentets början eller slut istället för radens början eller slut.</para +></listitem> +</itemizedlist> +</para> + +<para +>&kate; tillhandahåller också ett sätt att snabbt gå till motsvarande klammer eller parentes: Placera markören innanför ett parentes- eller klammertecken och tryck på <keycombo +><keycap +>Ctrl</keycap +><keycap +>6</keycap +></keycombo +> för att gå till motsvarande parentes eller klammer.</para> + +<para +>Dessutom kan du använda <link linkend="kate-part-bookmarks" +>bokmärken</link +> för att snabbt gå till platser som du själv definierar.</para> + +</sect1> + +<sect1 id="kate-part-selection"> +<title +>Arbeta med markeringar</title> + +<para +>Det finns två grundläggande sätt att markera text i &kate;: med musen, och med tangentbordet.</para> + +<para +>För att markera med musen, håll nere vänsterknappen medan du drar markören från stället där markeringen ska börja, till den önskade slutpunkten. Texten markeras medan du drar.</para> + +<para +>Dubbelklicka på ett ord för att markera ordet.</para> + +<para +>Trippelklicka på en rad markerar hela raden.</para> + +<para +>Om <keycap +>Skift</keycap +> hålls nere vid ett klick, så markeras texten.</para> + +<itemizedlist> +<listitem +><para +>Om ingenting redan är markerat, från textmarkörens position till musens position.</para +></listitem> +<listitem +><para +>Om det finns en markering, från och inklusive den markeringen till musens position.</para +></listitem> +</itemizedlist> + +<note> +<para +>När text markeras genom att dra med musen, kopieras den markerade texten till klippbordet, och kan klistras in genom att klicka med musens mittenknapp i editorn, eller i vilket annat program som helst där du vill klistra in texten. </para> +</note> + +<para +>För att markera med tangentbordet, håll nere <keycap +>skift</keycap +>-tangenten medan du använder förflyttningstangenterna (piltangenterna, <keycap +>Page Up</keycap +>, <keycap +>Page Down</keycap +>, <keycap +>Home</keycap +> och <keycap +>End</keycap +>, möjligen tillsammans med &Ctrl; för att utöka förflyttningen av textmarkören).</para> + +<para +>Se också avsnittet <link linkend="kate-part-navigation" +>Flytta sig i texten</link +> i det här kapitlet.</para> + +<para +>För att <action +>Kopiera</action +> den nuvarande markeringen, använd menyalternativet <menuchoice +><guimenu +>Redigera</guimenu +> <guimenuitem +>Kopiera</guimenuitem +></menuchoice +> eller snabbtangenten (normalt <keycombo action="simul" +>&Ctrl;<keycap +>C</keycap +></keycombo +>).</para> + +<para +>För att <action +>avmarkera</action +> den nuvarande markeringen använd menyalternativet <menuchoice +><guimenu +>Redigera</guimenu +> <guimenuitem +>Avmarkera</guimenuitem +></menuchoice +>, eller snabbtangenten (normalt <keycombo action="simul" +>&Ctrl; <keycap +>Skift</keycap +> <keycap +>A</keycap +></keycombo +>), eller klicka med vänster musknapp i editorn.</para> + +<sect2 id="kate-part-selection-block"> +<title +>Använda blockmarkering</title> + +<para +>När blockmarkering är aktiverat, kan du göra <quote +>vertikala markeringar</quote +> i texten, vilket betyder att markera vissa kolumner i flera rader. Det här är praktiskt för att till exempel arbeta med tabulatoråtskilda rader.</para> + +<para +>Blockmarkering kan väljas genom att använda menyalternativet <menuchoice +><guimenu +>Redigera</guimenu +> <guimenuitem +>Växla blockmarkering</guimenuitem +></menuchoice +>. Den normala snabbtangenten är <keycombo action="simul" +><keycap +>F4</keycap +></keycombo +>.</para> + +</sect2> + +<sect2 id="kate-part-seleciton-overwrite"> + +<title +>Använda skriv över-markering</title> + +<para +>Om skriv över-markering är aktiverad, så ersätts markeringen genom att skriva in eller klistra in text. Om det inte är aktiverat, så läggs ny text till på markörens plats.</para> + +<para +>Skriv över-markering är normalt aktiverad.</para> + +<para +>För att ändra inställning av alternativet, använd sidan <link linkend="config-dialog-editor-cursor-selection" +>Markör och markering</link +> i <link linkend="config-dialog" +>inställningsdialogrutan</link +>.</para> + +</sect2> + +<sect2 id="kate-part-selection-persistent"> + +<title +>Att använda långlivade markeringar</title> + +<para +>När långlivade markeringar är aktiverade, så blir inte markerad text avmarkerad när tecken skrivs in eller markören flyttas. Det här betyder att du kan flytta markören från den markerade texten, och skriva in ny text.</para> + +<para +>Långlivade markeringar är normalt inte aktiverade.</para> + +<para +>Långlivade markeringar kan aktiveras på sidan <link linkend="config-dialog-editor-cursor-selection" +>Markör och markering</link +> i <link linkend="config-dialog" +>inställningsdialogrutan</link +>.</para> + +<warning> +<para +>Om både långlivade markeringar och skriv över-markering är aktiverade, så ersätts markeringen och avmarkeras om ny text skrivs in eller klistras in, då textmarkören är inne i markeringen.</para> +</warning> + +</sect2> + +</sect1> + +<sect1 id="kate-part-copy-and-paste"> + +<title +>Kopiera och klistra in text</title> + +<para +>För att kopiera text, markera den och använd menyalternativet <menuchoice +><guimenu +>Redigera</guimenu +> <guimenuitem +>Kopiera</guimenuitem +></menuchoice +>. Dessutom, vid markering av text med musen kopieras den markerade texten till X-markeringen.</para> + +<para +>För att klistra in text som för närvarande finns på klippbordet, använd menyalternativet <menuchoice +><guimenu +>Redigera</guimenu +> <guimenuitem +>Klistra in</guimenuitem +></menuchoice +>.</para> + +<para +>Dessutom, så kan text som markeras med musen klistras in genom att klicka med musens <mousebutton +>mitt</mousebutton +>knapp på önskad plats.</para> + +<tip> +<para +>Om du använder &kde;-skrivbordet, kan du hämta text som tidigare kopierats från vilket program som helst med &klipper;-ikonen i panelens ikonbricka.</para> +</tip> + +</sect1> + +<sect1 id="kate-part-find-replace"> +<title +>Söka och ersätta text</title> + +<sect2 id="find-replace-dialog"> +<title +>Dialogrutorna <guilabel +>Sök text</guilabel +> och <guilabel +>Ersätt text</guilabel +></title> + + +<para +>Dialogrutorna för att söka och ersätta text är mycket lika i &kate;, utom att dialogrutan för att ersätta text erbjuder möjlighet att skriva in en ersättningstext och några extra alternativ.</para> + +<para +>Dialogerna erbjuder följande gemensamma alternativ:</para> + +<variablelist> + +<varlistentry> +<term +><guilabel +>Hitta text</guilabel +></term> +<listitem +><para +>Här skriver du in söksträngen. Tolkningen av strängen beror på några av alternativen som beskrivs nedan.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Reguljärt uttryck</guilabel +></term> +<listitem> +<para +>Om markerad, tolkas strängen som ett reguljärt uttryck. En knapp för att använda ett grafiskt verktyg för att skapa eller redigera reguljära uttryck kommer att aktiveras.</para> +<para +>Se <link linkend="regular-expressions" +>Reguljära uttryck</link +> för mer om detta.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Skiftlägesokänslig</guilabel +></term> +<listitem> +<para +>Om markerad, blir sökningen okänslig för skiftläget.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Endast hela ord</guilabel +></term> +<listitem> +<para +>Om markerad, så fås bara en träff om det finns en ordgräns på båda sidor om söksträngen, i betydelsen inte en bokstav eller siffra: antingen ett annat synligt tecken, eller ett radslut.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Från markören</guilabel +></term> +<listitem> +<para +>Om markerad, börjar sökningen från markörens position, annars startar den från första raden i dokumentet.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Sök baklänges</guilabel +></term> +<listitem> +<para +>Om markerad, så letar sökningen efter träffar ovanför startpunkten, antingen markörens position eller början på dokumentet, om alternativet <guilabel +>Från början</guilabel +> är aktiverat.</para> +</listitem> +</varlistentry> + +</variablelist> + +<para +>Dialogrutan <guilabel +>Ersätt text</guilabel +> erbjuder ytterligare några alternativ:</para> + +<variablelist> + +<varlistentry> +<term +><guilabel +>Ersätt med</guilabel +></term> +<listitem +><para +>Det är här du skriver in ersättningssträngen.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Markerad text</guilabel +></term> +<listitem> +<para +>Det här alternativet är inaktivt om ingen text är markerad, eller om alternativet <guilabel +>Fråga vid ersättning</guilabel +> är aktiverat. Om markerad, så ersätts alla träffar av söksträngen inom den markerade texten med ersättningssträngen.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><guilabel +>Fråga vid ersättning</guilabel +></term> +<listitem +><para +>Om markerad, frågar en liten dialogruta vad du vill göra varje gång en träff hittas. Den erbjuder följande alternativ: <variablelist> + +<varlistentry> +<term +><guibutton +>Ja</guibutton +></term> +<listitem +><para +>Tryck på den här för att ersätta den nuvarande träffen (som är markerad i editorn).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>Nej</guibutton +></term> +<listitem +><para +>Tryck på den här för att hoppa över den nuvarande träffen, och försöka hitta en till.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>Alla</guibutton +></term> +<listitem +><para +>Tryck på den här för att avbryta frågorna, och bara ersätta alla träffar.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><guibutton +>Stäng</guibutton +></term> +<listitem +><para +>Tryck på den här för att hoppa över den nuvarande träffen, och avsluta sökningen.</para +></listitem> +</varlistentry> + +</variablelist> + +</para +></listitem> +</varlistentry> + +</variablelist> + +<note> +<para +>Det finns för närvarande inget sätt att använda minimal matchning vid sökning efter ett reguljärt uttryck. Det här kommer att läggas till i en framtida version av &kate;.</para> +</note> + +</sect2> + +<sect2 id="finding-text"> +<title +>Söka efter text</title> + +<para +>För att söka efter text, starta dialogrutan <guilabel +>Sök text</guilabel +> med <keycombo action="simul" +>&Ctrl;<keycap +>F</keycap +></keycombo +> eller från menyalternativet <menuchoice +><guimenu +>Redigera</guimenu +> <guimenuitem +>Sök...</guimenuitem +></menuchoice +>, skriv in en söksträng, ställ in <link linkend="find-replace-dialog" +>alternativen</link +> som önskas och tryck på <guibutton +>Ok</guibutton +>. Om sökningen startades vid markörens position och inga träffar finns innan slutet av dokumentet nås (eller början om du söker bakåt), blir du tillfrågad om sökningen ska fortsätta förbi det. </para> + +<para +>Om en träff hittas så markeras den, och dialogrutan <guilabel +>Sök text</guilabel +> göms, men häng med, att söka efter fler träffar är mycket enkelt:</para> + +<para +>För att söka efter nästa träff i sökriktningen, använd kommandot <menuchoice +><guimenu +>Redigera</guimenu +> <guimenuitem +>Sök igen</guimenuitem +></menuchoice +> eller tryck på <keycap +>F3</keycap +>.</para> + +<para +>För att söka efter nästa träff i motsatt riktning, använd kommandot <menuchoice +><guimenu +>Redigera</guimenu +> <guimenuitem +>Sök föregående</guimenuitem +></menuchoice +> eller tryck på <keycombo action="simul" +> <keycap +>Skift</keycap +> <keycap +>F3</keycap +></keycombo +>.</para> + +<para +>Om ingen träff fås innan dokumentets slut nås (eller början om du söker bakåt), får du en fråga om du ska fortsätta förbi det. </para> + +</sect2> + +<sect2> +<title +>Ersätta text</title> + +<para +>För att ersätta text, starta dialogrutan <guilabel +>Ersätt text</guilabel +> med kommandot <menuchoice +><guimenu +>Redigera</guimenu +> <guimenuitem +>Ersätt</guimenuitem +></menuchoice +> eller snabbtangenten <keycombo action="simul" +>&Ctrl;<keycap +>R</keycap +></keycombo +>, skriv in en söksträng och eventuellt en ersättningssträng (om ersättningssträngen är tom, så tas varje träff bort), ställ in <link linkend="find-replace-dialog" +>alternativen</link +> som önskas, och tryck på knappen <guibutton +>Ok</guibutton +>.</para> + +<tip> +<para +>Om du använder ett reguljärt uttryck för att hitta texten som ska ersättas, kan du använda bakåtreferenser för att återanvända text som sparats i parentetiserade delmönster i uttrycket.</para> +<para +>Se <xref linkend="regular-expressions"/> för mer om detta.</para> +</tip> + +<tip +><para +>Du kan utföra <command +>find</command +> (sök), <command +>replace</command +> (ersätt) och <command +>ifind</command +> (inkrementell sökning) från <link linkend="advanced-editing-tools-commandline" +>kommandoraden</link +>.</para> +</tip> + +</sect2> + +</sect1> + +<sect1 id="kate-part-bookmarks"> +<title +>Att använda bokmärken</title> + +<para +>Bokmärkesfunktionen låter dig markera vissa rader, för att lätt kunna hitta dem igen.</para> + +<para +>Du kan lägga till och ta bort ett bokmärke för en rad på två olika sätt:</para> + +<itemizedlist> +<listitem> +<para +>Flytta infogningsmarkören till raden, och välj kommandot <menuchoice +><guimenu +>Bokmärken</guimenu +><guimenuitem +>Nytt bokmärke/Rensa bokmärke</guimenuitem +></menuchoice +> (<keycombo action="simul" +>&Ctrl;<keycap +>B</keycap +></keycombo +>).</para> +</listitem> +<listitem> +<para +>Klicka på ikonkanten intill raden.</para> +</listitem> +</itemizedlist> + + +<para +>Bokmärken är tillgängliga i menyn <guimenu +>Bokmärken</guimenu +>. Varje individuellt bokmärke är tillgängligt som ett menyalternativ, namngivet med radnumret för raden med bokmärket, och de första tecknen i texten på raden. För att flytta infogningsmarkören till början av en rad med ett bokmärke, öppna menyn och välj bokmärket.</para> + +<para +>För att snabbt gå mellan bokmärken eller till nästa/föregående bokmärke, använd kommandona <menuchoice +><guimenu +>Bokmärken</guimenu +> <guimenuitem +>Nästa</guimenuitem +> </menuchoice +> (<keycombo action="simul" +><keycap +>Ctrl</keycap +> <keycap +>Page Down</keycap +></keycombo +>) eller <menuchoice +> <guimenu +>Bokmärken</guimenu +> <guimenuitem +>Föregående</guimenuitem +></menuchoice +> (<keycombo action="simul" +><keycap +>Ctrl</keycap +><keycap +>Page Up</keycap +> </keycombo +>).</para> + +</sect1> + +<sect1 id="kate-part-auto-wrap"> + +<title +>Automatisk radbrytning av text</title> + +<para +>Den här funktionen låter dig formatera texten på ett mycket enkelt sätt: texten radbryts, så att inga rader överskrider ett maximalt antal tecken per rad, om det inte finns en längre sträng av andra tecken än blanktecken.</para> + +<para +>För att aktivera/inaktivera det, markera/avmarkera <guibutton +>Aktivera bryt rader mellan ord</guibutton +> på <link linkend="config-dialog-editor-edit" +> redigeringssidan</link +> i <link linkend="config-dialog" +>inställningsdialogrutan</link +>.</para> + +<para +>För att ställa in maximal radlängd (maximalt antal tecken per rad), använd alternativet <link linkend="config-dialog-editor-wrap-words-at" +><guibutton +>Bryt rader vid</guibutton +></link +> på <link linkend="config-dialog-editor-edit" +>redigeringssidan</link +> i <link linkend="config-dialog" +>inställningsdialogrutan</link +>.</para> + +<para +>Om aktiverad, så har det fäljande effekter: <itemizedlist> +<listitem +><para +>Medan du skriver, lägger editorn automatiskt till en hård nyrad efter det sista blanktecknet på en position innan den maximala radlängden nås.</para +></listitem> +<listitem +><para +>När dokumentet laddas, radbryter editorn texten på ett liknande sätt, så att inga rader är längre än den maximala radlängden, om de innehåller några blanktecken som tillåter detta.</para +></listitem> +</itemizedlist> + +</para> + +<note +><para +>Det finns för närvarande inget sätt att ställa in radbrytning för typer av dokument, eller aktivera och inaktivera funktionen på dokumentnivå. Det här kommer att rättas i en framtida version av &kate;.</para +></note> + +</sect1> + +<sect1 id="kate-part-autoindent"> +<title +>Att använda automatisk indentering</title> + +<para +>Kates editorkomponent stöder flera varianter av automatiska indenteringslägen, skapade för olika textformat. Du kan välja bland tillgängliga lägen med menyn <menuchoice +><guimenu +>Verktyg</guimenu +> <guisubmenu +>Indentering</guisubmenu +></menuchoice +>. Modulerna för automatisk indentering tillhandahåller också funktionen <menuchoice +><guimenu +>Verktyg</guimenu +> <guimenuitem +>Justera</guimenuitem +></menuchoice +> som beräknar indenteringen för markeringen eller nuvarande rad igen. Alltså kan du indentera om hela dokumentet genom att markera all text och utföra åtgärden.</para> + +<para +>Alla indenteringslägen använder inställningar som hör ihop med indentering i det aktiva dokumentet.</para> + +<tip +><para +>Du kan ställa in alla möjliga inställningsvariabler, inklusive de som hör ihop med indentering, genom att använda <link linkend="config-variables" +>dokumentvariabler</link +> och <link linkend="config-dialog-editor-filetypes" +>filtyper</link +>.</para +></tip> + +<variablelist> + +<title +>Tillgängliga lägen för automatisk indentering</title> + +<varlistentry> +<term +>Inget</term> +<listitem +><para +>Väljes det här läget stängs automatisk indentering av helt och hållet.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>Normal</term> +<listitem +><para +>Den här indenteringen behåller helt enkelt en indentering som liknar den föregående raden med något innehåll som inte är blanktecken. Du kan kombinera den med alternativen indentera och avindentera för att indentera efter din egen smak. </para +></listitem> +</varlistentry> + +<varlistentry +><term +>C-stil</term> +<listitem +><para +>Indentering för C och liknande språk, såsom C++, C#, Java, Javaskript och så vidare. Indenteringen fungerar inte med skriptspråk som Perl eller PHP.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>SS C-stil</term> +<listitem +><para +>Alternativ indentering för C och liknande språk, med samma begränsningar.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Python-stil</term> +<listitem +><para +>Indentering särskilt för skriptspråket Python. </para +></listitem> +</varlistentry> + +<varlistentry> +<term +>XML</term> +<listitem +><para +>Mycket trevlig automatisk indentering för XML. Hur lockande det än kan vara, försök inte använda den med HTML utom XHTML, eftersom den misslyckas för HTML-taggar med gammal stil (öppna taggar som till exempel <br>).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +>Variabelbaserad indentering</term> +<listitem> + +<note> +<para +>Den variabelbaserade indenteringen är experimentell, och kan ändra beteende eller försvinna i framtida versioner.</para> +</note> + +<para +>Den variabelbaserade indenteringen är speciell på det sättet att den kan ställas in genom att använda variabler i dokumentet (eller i en filtypsinställning). Följande variabler läses: <variablelist> +<varlistentry> +<term +>var-indent-indent-after</term> +<listitem> +<para +>Ett reguljärt uttryck som gör att en rad indenteras ett steg, om den första raden ovanför som inte bara innehåller blanktecken matchar. var-indent-indent: Ett reguljärt uttryck, som gör att en rad indenteras ett steg.</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term +>var-indent-unindent</term> +<listitem> +<para +>Ett reguljärt uttryck, som gör att en rad avindenteras ett steg om den matchar.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>var-indent-triggerchars</term> +<listitem> +<para +>En lista med tecken som ska orsaka att indenteringen omedelbart beräknas igen när de skrivs in.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +>var-indent-handle-couples</term> +<listitem> +<para +>En lista med parentesuppsättningar som ska hanteras. Vilken kombination som helst av 'parentes', 'krullparentes' och 'hakparentes'. Varje typ av uppsättning hanteras på följande sätt: Om det finns ett inledande tecken som inte matchas på ovanstående rad, läggs ett indenteringssteg till. Om det finns ett avslutande tecken som inte matchas på nuvarande rad, tas ett indenteringssteg bort.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><literal +>var-indent-couple-attribute</literal +></term> +<listitem> +<para +>Vid sökning efter inledande och avslutande tecken utan motsvarighet, beaktas bara tecken med denna egenskap. Värdet måste vara egenskapsnamnet från XML-syntaxfilen, till exempel "Symbol". Om den inte anges används egenskap 0 (oftast 'Normal Text').</para> +</listitem> +</varlistentry> + +</variablelist> + +</para +></listitem> +</varlistentry> + +</variablelist> + +</sect1> + +</chapter> diff --git a/tde-i18n-sv/docs/kdebase/kate/plugins.docbook b/tde-i18n-sv/docs/kdebase/kate/plugins.docbook new file mode 100644 index 00000000000..f85406e3477 --- /dev/null +++ b/tde-i18n-sv/docs/kdebase/kate/plugins.docbook @@ -0,0 +1,39 @@ +<chapter id="plugins"> + +<chapterinfo> +<authorgroup> +<author +>&Anders.Lund; &Anders.Lund.mail;</author> +<othercredit role="translator" +> <firstname +>Johan</firstname +> <surname +>Thelmén</surname +> <affiliation +><address +><email +>jth@home.se</email +></address +></affiliation +> <contrib +>Översättare</contrib +></othercredit +> +</authorgroup> +</chapterinfo> + +<title +>Arbeta med insticksprogram</title> + +<para +>Kate använder två olika typer av insticksprogram, nämligen insticksprogram för programmet &kate; och insticksprogram för &kate;s editorkomponent. De senare är tillgängliga för alla program som använder editorkomponenten, som KDevelop, Quanta, Kile, Kwrite och många andra, medan insticksprogram för programmet är specifika för &kate;.</para> + +<para +>Du kan aktivera båda typer av insticksprogram i <link linkend="configuring-kate-configdialog" +>inställningsdialogrutan</link +>, som också ger tillgång till ytterligare inställningsalternativ för insticksprogram som kräver det.</para> + +<para +>Det finns många insticksprogram för olika syften tillgängliga i modulen kdeaddons, och du kan söka efter fler på webben. Ett fåtal insticksprogram levereras med editorkomponenten för ordkomplettering, automatiska bokmärken, infoga filer, synonymordlista, stavningskontroll av ord och inkrementell sökning.</para> + +</chapter> diff --git a/tde-i18n-sv/docs/kdebase/kate/regular-expressions.docbook b/tde-i18n-sv/docs/kdebase/kate/regular-expressions.docbook new file mode 100644 index 00000000000..3ef187a50e6 --- /dev/null +++ b/tde-i18n-sv/docs/kdebase/kate/regular-expressions.docbook @@ -0,0 +1,1214 @@ +<appendix id="regular-expressions"> +<appendixinfo> +<authorgroup> +<author +>&Anders.Lund; &Anders.Lund.mail;</author> +<othercredit role="translator" +> <firstname +>Johan</firstname +> <surname +>Thelmén</surname +> <affiliation +><address +><email +>jth@home.se</email +></address +></affiliation +> <contrib +>Översättare</contrib +></othercredit +> +</authorgroup> +</appendixinfo> + +<title +>Reguljära uttryck</title> + +<synopsis +>Detta appendix innehåller en kortfattad, men förhoppningsvis tillräcklig och heltäckande introduktion till de <emphasis +>reguljära uttryckens </emphasis +> värld. Det dokumenterar reguljära uttryck på den form som är tillgänglig i &kate;, som inte är likadana som reguljära uttryck i Perl, och inte heller i till exempel <command +>grep</command +>.</synopsis> + +<sect1> + +<title +>Inledning</title> + +<para +><emphasis +>Reguljära uttryck</emphasis +> ger oss en möjlighet att beskriva ett möjligt innehåll i en textsträng på ett sätt som enkelt kan förstås av programvara, så att den kan undersöka om texten matchar, och för mer avancerade tillämpningar, ge möjlighet att spara delar av texten som matchar.</para> + +<para +>Ett exempel: Säg att du vill leta i en text efter stycken som börjar med något av namnen <quote +>Henrik</quote +> eller <quote +>Pernilla</quote +>, följt av någon form av verbet <quote +>säga</quote +>.</para> + +<para +>Med en normal sökning, skulle du börja med att leta efter det första namnet, <quote +>Henrik</quote +>, kanske följt av <quote +>s</quote +> på det här sättet: <userinput +>Henrik s</userinput +>, och medan du letar efter träffar måste du bortse från alla de som inte inleder ett stycke, samt de där ordet som börjar med <quote +>s</quote +> inte var antingen <quote +>säger</quote +>, <quote +>sade</quote +> etc. Och därefter måste du förstås repetera allt för nästa namn ...</para> + +<para +>Med reguljära uttryck, kan den här uppgiften utföras med en enda sökning, och med högre noggrannhet.</para> + +<para +>För att åstadkomma detta, definierar reguljära uttryck detaljerade regler för att beskriva en generell sträng som ska matcha. Vårt exempel, som vi kan beskriva så här med ord: <quote +>En rad som börjar antingen med <quote +>Henrik</quote +> eller <quote +>Pernilla</quote +> (möjligen efter upp till fyra mellanslag eller tabulatortecken), följt av ett mellanslag, följt av <quote +>s</quote +> och sedan antingen <quote +>äger</quote +> eller <quote +>ade</quote +></quote +>, skulle kunna uttryckas med följande reguljära uttryck:</para +> <para +><userinput +>^[ \t]{0,4}(Henrik|Pernilla) s(äger|ade)</userinput +></para> + +<para +>Ovanstående exempel demonstrerar alla fyra huvudkoncepten i moderna reguljära uttryck, nämligen:</para> + +<itemizedlist> +<listitem +><para +>Mönster</para +></listitem> +<listitem +><para +>Påståenden</para +></listitem> +<listitem +><para +>Kvalificering</para +></listitem> +<listitem +><para +>Bakåtreferenser</para +></listitem> +</itemizedlist> + +<para +>Hatten (<literal +>^</literal +>) som inleder uttrycket är ett påstående, som bara är sant om den följande strängen som matchar är först på raden.</para> + +<para +>Strängarna <literal +>[ \t]</literal +> och <literal +>(Henrik|Pernilla) s(äger|ade)</literal +> är mönster. Det första är en <emphasis +>teckenklass</emphasis +> som antingen matchar ett blanktecken eller ett (horisontellt) tabulatortecken. Det andra mönstret innehåller först ett delmönster som antingen matchar <literal +>Henrik</literal +> <emphasis +>eller</emphasis +> <literal +>Pernilla</literal +>, därefter en del som exakt matchar strängen <literal +> s</literal +> och slutligen ett delmönster som antingen matchar <literal +>äger</literal +> <emphasis +>eller</emphasis +> <literal +>ade</literal +>.</para> + +<para +>Strängen <literal +>{0,4}</literal +> är en kvalificering som säger <quote +>allt från noll upp till fyra av det föregående</quote +>.</para> + +<para +>Eftersom programvara för reguljära uttryck stöder konceptet med <emphasis +>bakåtreferenser</emphasis +>, så sparas hela den matchande delen av strängen, samt delmönster som finns mellan parenteser. Givet något sätt att komma åt de här referenserna, skulle vi kunna få tag på hela matchningen (när man söker i ett textdokument i en editor med ett reguljärt uttryck, så visas den ofta markerad), eller namnet som hittades, eller den sista delen av verbet.</para> + +<para +>I sin helhet, så matchar uttrycket vad vi ville att det skulle göra, och bara det.</para> + +<para +>Följande avsnitt beskriver i detalj hur man skapar och använder mönster, teckenklasser, påståenden, kvalificering och bakåtreferenser. Det sista avsnittet ger några användbara exempel.</para> + +</sect1> + +<sect1 id="regex-patterns"> + +<title +>Mönster</title> + +<para +>Mönster består av vanliga strängar och teckenklasser. Mönster kan innehålla delmönster, vilket är mönster som är inneslutna i parenteser.</para> + +<sect2> +<title +>Undanta tecken</title> + +<para +>I mönster och teckenklasser har vissa tecken en särskilt mening. För att uttryckligen matcha något av de här tecknen, måste de markeras eller <emphasis +>undantas</emphasis +> för att tala om för programvaran för reguljära uttryck att den ska tolka sådana tecken uttryckligen.</para> + +<para +>Det här görs genom att lägga till ett bakstreck (<literal +>\</literal +>) före tecknet.</para> + + +<para +>Programvaran för reguljära uttryck ignorerar tecken som undantas även om de inte har någon särskild betydelse i sammanhanget, så att undanta till exempel ett <quote +>j</quote +> (<userinput +>\j</userinput +>) är säkert. Om du är tveksam om ett tecken kan ha en särskild betydelse, kan du därför alltid undanta det på ett säkert sätt.</para> + +<para +>Undantag omfattar förstås också bakstrecket själv, för att uttryckligen matcha ett sådant, skulle du skriva <userinput +>\\</userinput +>.</para> + +</sect2> + +<sect2> +<title +>Teckenklasser och förkortningar</title> + +<para +>En <emphasis +>teckenklass</emphasis +> är ett uttryck som matchar ett tecken i en mängd angivna tecken. I reguljära uttryck definieras teckenklasser genom att ange de giltiga tecknen i klassen inom hakparenterser, <literal +>[]</literal +>, eller genom att använda en av de förkortade klasserna som beskrivs nedan.</para> + +<para +>Enkla teckenklasser innehåller bara uttryckligen ett eller flera tecken, till exempel <userinput +>[abc]</userinput +> (som matchar något av tecknen <quote +>a</quote +>, <quote +>b</quote +> eller <quote +>c</quote +>) eller <userinput +>[0123456789]</userinput +> (som matchar alla siffror).</para> + +<para +>Eftersom bokstäver och siffror har en logisk ordning, kan du förkorta dem genom att ange intervall: <userinput +>[a-c]</userinput +> är samma sak som <userinput +>[abc]</userinput +> och <userinput +>[0-9]</userinput +> är samma sak som <userinput +>[0123456789]</userinput +>. Att kombineras dessa sammansättningar, till exempel med <userinput +>[a-fynot1-38]</userinput +> är fullständigt riktigt (detta skulle förstås matcha antingen <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 +> eller <quote +>8</quote +>).</para> + +<para +>Eftersom stora bokstäver är andra tecken än motsvarande små bokstäver, så måste du alltså skriva <userinput +>[aAbB]</userinput +>, för att skapa en teckenklass som matchar både de små och stora bokstäverna <quote +>a</quote +> eller <quote +>b</quote +>.</para> + +<para +>Det är förstås möjligt att skapa en <quote +>negativ</quote +> klass som matchar <quote +>allting utom</quote +>. För att göra detta lägg till en hatt (<literal +>^</literal +>) först i klassen: </para> + +<para +><userinput +>[^abc]</userinput +> matchar alla tecken <emphasis +>utom</emphasis +> <quote +>a</quote +>, <quote +>b</quote +> eller <quote +>c</quote +>.</para> + +<para +>Förutom uttryckliga tecken, definieras några förkortningar, som gör livet lite enklare: <variablelist> + +<varlistentry> +<term +><userinput +>\a</userinput +></term> +<listitem +><para +>Det här matchar <acronym +>ASCII</acronym +>-tecknet BEL (0x07).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\f</userinput +></term> +<listitem +><para +>Det här matchar <acronym +>ASCII</acronym +>-tecknet ny sida (FF, 0x0C).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\n</userinput +></term> +<listitem +><para +>Det här matchar <acronym +>ASCII</acronym +>-tecknet nyrad (LF, 0x0A, Unix nyrad).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\r</userinput +></term> +<listitem +><para +>Det här matchar <acronym +>ASCII</acronym +> returtecken (CR, 0x0D).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\t</userinput +></term> +<listitem +><para +>Det här matchar <acronym +>ASCII</acronym +>-tecknet horisontell tabulator (HT, 0x09).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\v</userinput +></term> +<listitem +><para +>Det här matchar <acronym +>ASCII</acronym +>-tecknet vertikal tabulator (VT, 0x0B).</para +></listitem> +</varlistentry> +<varlistentry> +<term +><userinput +>\xhhhh</userinput +></term> + +<listitem +><para +>Det här matchar Unicode-tecknet som motsvarar det hexadecimala värdet hhhh (mellan 0x0000 och 0xFFFF). \0ooo (dvs. \noll ooo) matchar <acronym +>ASCII</acronym +>/Latin-1 tecknet som motsvarar det oktala värdet ooo (mellan 0 och 0377).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>.</userinput +> (punkt)</term> +<listitem +><para +>Det här matchar vilket tecken som helst (inklusive nyrad).</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\d</userinput +></term> +<listitem +><para +>Det här matchar en siffra. Samma som <literal +>[0-9]</literal +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\D</userinput +></term> +<listitem +><para +>Det här matchar allt utom en siffra. Samma som <literal +>[^0-9]</literal +> eller <literal +>[^\d]</literal +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\s</userinput +></term> +<listitem +><para +>Det här matchar ett blanktecken. Nästan samma sak som <literal +>[ \t\n\r]</literal +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\S</userinput +></term> +<listitem +><para +>Det här matchar allt utom ett blanktecken. Nästan samma sak som <literal +>[^ \t\r\n]</literal +>, och samma som <literal +>[^\s]</literal +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\w</userinput +></term> +<listitem +><para +>Matchar alla <quote +>ord-tecken</quote +> - i det här fallet alla bokstäver eller siffror. Observera att understreck (<literal +>_</literal +>) inte matchas, vilket är fallet för motsvarande reguljära uttryck i Perl. Samma som <literal +>[a-zA-Z0-9]</literal +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\W</userinput +></term> +<listitem +><para +>Matchar alla tecken som inte ingår i ord - allt utom bokstäver eller siffror. Samma som <literal +>[^a-zA-Z0-9]</literal +> eller <literal +>[^\w]</literal +>.</para +></listitem> +</varlistentry> + + +</variablelist> + +</para> + +<para +>De förkortade klasserna kan användas inne i en annan klass. För att till exempel matcha ett ord-tecken, ett mellanslag eller en punkt, skulle du kunna skriva <userinput +>[\w \.]</userinput +>.</para +> + +<note +> <para +>POSIX-beskrivningen av klasser <userinput +>[:<klassnamn>:]</userinput +> stöds inte för närvarande.</para +> </note> + +<sect3> +<title +>Tecken med särskild betydelse inne i teckenklasser</title> + +<para +>Följande tecken har en särskild betydelse inne i konstruktionen <quote +>[]</quote +> för teckenklasser, och måste undantas för att användas uttryckligen i en teckenklass:</para> + +<variablelist> +<varlistentry> +<term +><userinput +>]</userinput +></term> +<listitem +><para +>Avslutar teckenklassen. Måste undantas om det inte är det allra första tecknet i klassen (kan följa en hatt som inte undantas).</para +></listitem> +</varlistentry> +<varlistentry> +<term +><userinput +>^</userinput +> (hatt)</term> +<listitem +><para +>Anger en negativ klass, om det är det första tecknet. Måste undantas för att uttryckligen matcha om det är det första tecknet i klassen.</para +></listitem +> +</varlistentry> +<varlistentry> +<term +><userinput +>-</userinput +> (minus)</term> +<listitem +><para +>Anger ett logiskt intervall. Måste alltid undantas inne i en teckenklass.</para +></listitem> +</varlistentry> +<varlistentry> +<term +><userinput +>\</userinput +> (bakstreck)</term> +<listitem +><para +>Undantagstecknet. Måste alltid undantas.</para +></listitem> +</varlistentry> + +</variablelist> + +</sect3> + +</sect2> + +<sect2> + +<title +>Alternativ: matchar <quote +>en av</quote +></title> + +<para +>Om du vill matcha en av ett antal olika mönster, kan du skilja dem åt med <literal +>|</literal +> (ett vertikalt streck).</para> + +<para +>För att till exempel antingen hitta <quote +>John</quote +> eller <quote +>Harry</quote +> kan du använda uttrycket <userinput +>John|Harry</userinput +>.</para> + +</sect2> + +<sect2> + +<title +>Delmönster</title> + +<para +><emphasis +>Delmönster</emphasis +> är mönster som innesluts i parenteser, och som har flera användningar i de reguljära uttryckens värld.</para> + +<sect3> + +<title +>Ange alternativ</title> + +<para +>Du kan använda ett delmönster för att gruppera ett antal alternativ i ett större mönster. Alternativen delas av tecknet <quote +>|</quote +> (vertikalt streck).</para> + +<para +>För att till exempel matcha antingen orden <quote +>int</quote +>, <quote +>float</quote +> eller <quote +>double</quote +>, skulle du kunna använda mönstret <userinput +>int|float|double</userinput +>. Om du bara vill hitta ordet om det följs av blanktecken och därefter några bokstäver, placera alternativen i ett delmönster: <userinput +>(int|float|double)\s+\w+</userinput +>.</para> + +</sect3> + +<sect3> + +<title +>Spara text som matchar (bakåtreferenser)</title> + +<para +>Om du vill använda en bakåtreferens, använd ett delmönster för att komma ihåg önskad del av mönstret.</para> + +<para +>Om du till exempel vill hitta två förekomster av samma ord åtskilda av ett kommatecken och möjligen några blanktecken, skulle du kunna skriva <userinput +>(\w+),\s*\1</userinput +>. Delmönstret <literal +>\w+</literal +> skulle hitta en grupp med ord-tecken, och hela uttrycket skulle matcha om de följdes av ett komma, noll eller flera blanktecken och sedan en likadan grupp med ord-tecken. (Strängen <literal +>\1</literal +> refererar till <emphasis +>det första delmönstret inneslutet i parenteser</emphasis +>).</para> + +<!-- <para +>See also <link linkend="backreferences" +>Back references</link +>.</para +> --> + +</sect3> + +<sect3 id="lookahead-assertions"> +<title +>Påståenden för sökning framåt</title> + +<para +>Ett påstående för sökning framåt är ett delmönster, som antingen börjar med <literal +>?=</literal +> eller <literal +>?!</literal +>.</para> + +<para +>För att till exempel uttryckligen matcha strängen <quote +>Bill</quote +> men bara om den inte följs av <quote +> Gates</quote +>, skulle du kunna använda det här uttrycket: <userinput +>Bill(?! Gates)</userinput +>. (Det här skulle hitta <quote +>Bill Clinton</quote +> samt <quote +>Billy the kid</quote +>, men tyst ignorera de andra träffarna).</para> + +<para +>Delmönster som används för påståenden sparas inte.</para> + +<para +>Se också <link linkend="assertions" +>Påståenden</link +>.</para> + +</sect3> + +</sect2> + +<sect2 id="special-characters-in-patterns"> +<title +>Tecken med särskild betydelse inne i mönster</title> + +<para +>Följande tecken har särskild betydelse inne i mönster, och måste undantas om du uttryckligen vill matcha dem: <variablelist> + +<varlistentry> +<term +><userinput +>\</userinput +> (bakstreck)</term> +<listitem +><para +>Undantagstecknet.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>^</userinput +> (hatt)</term> +<listitem +><para +>Anger början på strängen.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>$</userinput +></term> +<listitem +><para +>Anger slutet på strängen.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>()</userinput +> (vänster och höger parentes)</term> +<listitem +><para +>Anger delmönster.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>{}</userinput +> (vänster och höger klammer)</term> +<listitem +><para +>Anger numerisk kvalificering.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>[]</userinput +> (vänster och höger hakparentes)</term> +<listitem +><para +>Anger teckenklasser.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>|</userinput +> (vertikalt streck)</term> +<listitem +><para +>Logiskt ELLER. Skiljer alternativ.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>+</userinput +> (plustecken)</term> +<listitem +><para +>Kvalificering, en eller flera.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>*</userinput +> (asterisk)</term> +<listitem +><para +>Kvalificering, noll eller flera.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>?</userinput +> (frågetecken)</term> +<listitem +><para +>Ett extra tecken. Kan tolkas som en kvalificering, noll eller ett.</para +></listitem> +</varlistentry> + +</variablelist> + +</para> + +</sect2> + +</sect1> + +<sect1 id="quantifiers"> +<title +>Kvalificering</title> + +<para +>En <emphasis +>kvalificering</emphasis +> låter ett reguljärt uttryck antingen matcha ett angivet antal eller intervall av ett tecken, en teckenklass eller ett delmönster.</para> + +<para +>En kvalificering innesluts av klamrar (<literal +>{</literal +> och <literal +>}</literal +>) och har den allmänna formen <literal +>{[minimalt antal][,[maximalt antal]]}</literal +>. </para> + +<para +>Användningen förklaras bäst med exempel: <variablelist> + +<varlistentry> +<term +><userinput +>{1}</userinput +></term> +<listitem +><para +>Exakt en förekomst</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>{0,1}</userinput +></term> +<listitem +><para +>Noll eller en förekomst</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>{,1}</userinput +></term> +<listitem +><para +>Samma sak, med mindre ansträngning ;)</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>{5,10}</userinput +></term> +<listitem +><para +>Minst 5 men maximalt 10 förekomster</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>{5,}</userinput +></term> +<listitem +><para +>Minst 5 förekomster, inget maximum</para +></listitem> +</varlistentry> + +</variablelist> + +</para> + +<para +>Det finns dessutom några förkortningar: <variablelist> + +<varlistentry> +<term +><userinput +>*</userinput +> (asterisk)</term> +<listitem +><para +>liknar <literal +>{0,}</literal +>, hittar ett godtyckligt antal förekomster.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>+</userinput +> (plustecken)</term> +<listitem +><para +>liknar <literal +>{1,}</literal +>, åtminstone en förekomst.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>?</userinput +> (frågetecken)</term> +<listitem +><para +>liknar <literal +>{0,1}</literal +>, noll eller en förekomst.</para +></listitem> +</varlistentry> + +</variablelist> + +</para> + +<sect2> + +<title +>Glupskt beteende</title> + +<para +>När kvalificeringar utan maximum används, så matchar reguljära uttryck normalt så mycket av söksträngen som möjligt, ett beteende som ofta kallas för <emphasis +>glupskt</emphasis +>.</para> + +<para +>Modern programvara för reguljära uttryck tillhandahåller en möjlighet att <quote +>stänga av det glupska beteendet</quote +>, även om det är det grafiska gränssnittet som måste ge dig tillgång till den här funktionen. En sökdialogruta som tillhandahåller sökning med reguljära uttryck skulle kunna ha en kryssruta som heter <quote +>Minimal matchning</quote +>, och borde också ange att glupskt beteende är det normala.</para> + +</sect2> + +<sect2> +<title +>Exempel i sammanhang</title> + +<para +>Här är några exempel på att använda kvalificering.</para> + +<variablelist> + +<varlistentry> +<term +><userinput +>^\d{4,5}\s</userinput +></term> +<listitem +><para +>Matchar siffrorna i <quote +>1234 gå</quote +> och <quote +>12345 nu</quote +>, men varken <quote +>567 elva</quote +> eller <quote +>223459 någonstans</quote +>.</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\s+</userinput +></term> +<listitem +><para +>Matchar en eller flera blanktecken</para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>(bla){1,}</userinput +></term> +<listitem +><para +>Matchar samtliga <quote +>blablabla</quote +> och <quote +>bla</quote +> i <quote +>blad</quote +> eller <quote +>dubbla</quote +></para +></listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>/?></userinput +></term> +<listitem +><para +>Matchar <quote +>/></quote +> i <quote +><slut/></quote +> samt <quote +>></quote +> i <quote +><start></quote +>.</para +></listitem> +</varlistentry> + +</variablelist> + +</sect2> + +</sect1> + +<sect1 id="assertions"> +<title +>Påståenden</title> + +<para +><emphasis +>Påståenden</emphasis +> gör att ett reguljärt uttryck bara matchar under vissa kontrollerade omständigheter.</para> + +<para +>Ett påstående behöver inte ett tecken för att matcha, utan undersöker istället omgivningen runt en möjlig matchning innan den erkänns. Påståendet <emphasis +>ordgräns</emphasis +> försöker till exempel inte hitta ett tecken som inte ingår i ett ord intill ett ord-tecken på platsen, utan kontrollerar istället att det inte finns ett ord-tecken. Det här betyder att påståendet matchar där det inte finns något tecken alls, dvs. vid slutet på söksträngen.</para> + +<para +>Vissa påståenden har verkligen ett mönster som ska matcha, men den delen av strängen som matchar kommer inte att ingå i resultatet för matchningen av hela uttrycket.</para> + +<para +>Reguljära uttryck som de dokumenteras här stöder följande påståenden: <variablelist> + +<varlistentry +> +<term +><userinput +>^</userinput +> (hatt: början på strängen)</term +> +<listitem +><para +>Matchar början på söksträngen.</para +> <para +>Uttrycket <userinput +>^Peter</userinput +> matchar vid <quote +>Peter</quote +> i strängen <quote +>Peter, hej då!</quote +> men inte <quote +>Hej, Peter!</quote +>. </para +> </listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>$</userinput +> (slutet på strängen)</term> +<listitem +><para +>Matchar slutet på söksträngen.</para> + +<para +>Uttrycket <userinput +>du\?$</userinput +> matchar det sista du i strängen <quote +>Du gjorde det väl inte, eller var det verkligen du?</quote +> men ingenstans i <quote +>Du gjorde det väl inte, eller hur?</quote +>.</para> + +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>\b</userinput +> (ordgräns)</term> +<listitem +><para +>Matchar om det finns ett ordtecken på ena sidan och något annat än ett ordtecken på andra sidan.</para> +<para +>Det här är användbart för att hitta slutet på ord, till exempel för både början och slutet för att hitta ett helt ord. Uttrycket <userinput +>\bin\b</userinput +> matchar ett ensamt <quote +>in</quote +> i strängen <quote +>Han kom in genom ingången</quote +>, men inte det <quote +>in</quote +> som finns i <quote +>ingången</quote +>.</para +></listitem> + +</varlistentry> + +<varlistentry> +<term +><userinput +>\B</userinput +> (icke ordgräns)</term> +<listitem +><para +>Matchar överallt där <quote +>\b</quote +> inte gör det.</para> +<para +>Det här betyder att det matchar till exempel inne i ord: Uttrycket <userinput +>\Bin\B</userinput +> matchar in i <quote +>minne</quote +> men inte i <quote +>ingång</quote +> eller <quote +>Han kom in genom fönstret</quote +>.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>(?=MÖNSTER)</userinput +> (Positiv sökning framåt)</term> +<listitem +><para +>Ett påstående som söker framåt tittar på strängen som följer en möjlig matchning. Den positiva sökningen förhindrar att strängen matchar om inte texten som följer den möjliga matchningen matchar <emphasis +>MÖNSTER</emphasis +> i påståendet, men texten som matchas av det ingår inte i resultatet.</para> +<para +>Uttrycket <userinput +>vakt(?=\w)</userinput +> matchar för <quote +>vakt</quote +> in <quote +>vaktmästare</quote +> men inte i <quote +>Han är en vakt!</quote +></para> +</listitem> +</varlistentry> + +<varlistentry> +<term +><userinput +>(?!MÖNSTER)</userinput +> (Negativ sökning framåt)</term> + +<listitem +><para +>Den negativa sökningen framåt förhindrar en möjlig matchning från att bekräftas om den följande delen av söksträngen matchar sitt <emphasis +>MÖNSTER</emphasis +>.</para> +<para +>Uttrycket <userinput +>const \w+\b(?!\s*&)</userinput +> matchar vid <quote +>const char</quote +> i strängen <quote +>const char* x</quote +> medan den inte kan matcha <quote +>const QString</quote +> i <quote +>const QString& y</quote +> eftersom <quote +>&</quote +> matchar mönstret i den negativa sökningen framåt.</para> +</listitem> +</varlistentry> + +</variablelist> + +</para> + +</sect1> + +<!-- TODO sect1 id="backreferences"> + +<title +>Back References</title> + +<para +></para> + +</sect1 --> + +</appendix> |
