From f7e7a923aca8be643f9ae6f7252f9fb27b3d2c3b Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Sat, 3 Dec 2011 11:05:10 -0600 Subject: Second part of prior commit --- tde-i18n-fr/docs/tdewebdev/quanta/Makefile.am | 4 + tde-i18n-fr/docs/tdewebdev/quanta/Makefile.in | 635 ++++++ .../docs/tdewebdev/quanta/adv-quanta.docbook | 469 ++++ .../docs/tdewebdev/quanta/config-quanta.docbook | 9 + .../docs/tdewebdev/quanta/credits-license.docbook | 260 +++ .../docs/tdewebdev/quanta/debugging-quanta.docbook | 58 + .../docs/tdewebdev/quanta/extending-quanta.docbook | 1625 ++++++++++++++ .../docs/tdewebdev/quanta/fundamentals.docbook | 371 +++ tde-i18n-fr/docs/tdewebdev/quanta/glossary.docbook | 76 + tde-i18n-fr/docs/tdewebdev/quanta/index.cache.bz2 | Bin 0 -> 36511 bytes tde-i18n-fr/docs/tdewebdev/quanta/index.docbook | 294 +++ .../docs/tdewebdev/quanta/installation.docbook | 41 + .../docs/tdewebdev/quanta/introduction.docbook | 137 ++ tde-i18n-fr/docs/tdewebdev/quanta/q-and-a.docbook | 53 + .../docs/tdewebdev/quanta/quanta-menus.docbook | 2365 ++++++++++++++++++++ .../docs/tdewebdev/quanta/quanta-projects.docbook | 624 ++++++ .../tdewebdev/quanta/working-with-quanta.docbook | 565 +++++ 17 files changed, 7586 insertions(+) create mode 100644 tde-i18n-fr/docs/tdewebdev/quanta/Makefile.am create mode 100644 tde-i18n-fr/docs/tdewebdev/quanta/Makefile.in create mode 100644 tde-i18n-fr/docs/tdewebdev/quanta/adv-quanta.docbook create mode 100644 tde-i18n-fr/docs/tdewebdev/quanta/config-quanta.docbook create mode 100644 tde-i18n-fr/docs/tdewebdev/quanta/credits-license.docbook create mode 100644 tde-i18n-fr/docs/tdewebdev/quanta/debugging-quanta.docbook create mode 100644 tde-i18n-fr/docs/tdewebdev/quanta/extending-quanta.docbook create mode 100644 tde-i18n-fr/docs/tdewebdev/quanta/fundamentals.docbook create mode 100644 tde-i18n-fr/docs/tdewebdev/quanta/glossary.docbook create mode 100644 tde-i18n-fr/docs/tdewebdev/quanta/index.cache.bz2 create mode 100644 tde-i18n-fr/docs/tdewebdev/quanta/index.docbook create mode 100644 tde-i18n-fr/docs/tdewebdev/quanta/installation.docbook create mode 100644 tde-i18n-fr/docs/tdewebdev/quanta/introduction.docbook create mode 100644 tde-i18n-fr/docs/tdewebdev/quanta/q-and-a.docbook create mode 100644 tde-i18n-fr/docs/tdewebdev/quanta/quanta-menus.docbook create mode 100644 tde-i18n-fr/docs/tdewebdev/quanta/quanta-projects.docbook create mode 100644 tde-i18n-fr/docs/tdewebdev/quanta/working-with-quanta.docbook (limited to 'tde-i18n-fr/docs/tdewebdev/quanta') diff --git a/tde-i18n-fr/docs/tdewebdev/quanta/Makefile.am b/tde-i18n-fr/docs/tdewebdev/quanta/Makefile.am new file mode 100644 index 00000000000..b6361414814 --- /dev/null +++ b/tde-i18n-fr/docs/tdewebdev/quanta/Makefile.am @@ -0,0 +1,4 @@ +KDE_LANG = fr +SUBDIRS = $(AUTODIRS) +KDE_DOCS = AUTO +KDE_MANS = AUTO diff --git a/tde-i18n-fr/docs/tdewebdev/quanta/Makefile.in b/tde-i18n-fr/docs/tdewebdev/quanta/Makefile.in new file mode 100644 index 00000000000..25cddc8a8fd --- /dev/null +++ b/tde-i18n-fr/docs/tdewebdev/quanta/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/tdewebdev/quanta +DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in +ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 +am__aclocal_m4_deps = $(top_srcdir)/acinclude.m4 \ + $(top_srcdir)/configure.in +am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ + $(ACLOCAL_M4) +mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs +CONFIG_HEADER = $(top_builddir)/config.h +CONFIG_CLEAN_FILES = +SOURCES = +DIST_SOURCES = +#>- RECURSIVE_TARGETS = all-recursive check-recursive dvi-recursive \ +#>- html-recursive info-recursive install-data-recursive \ +#>- install-dvi-recursive install-exec-recursive \ +#>- install-html-recursive install-info-recursive \ +#>- install-pdf-recursive install-ps-recursive install-recursive \ +#>- installcheck-recursive installdirs-recursive pdf-recursive \ +#>- ps-recursive uninstall-recursive +#>+ 7 +RECURSIVE_TARGETS = all-recursive check-recursive dvi-recursive \ + html-recursive info-recursive install-data-recursive \ + install-dvi-recursive install-exec-recursive \ + install-html-recursive install-info-recursive \ + install-pdf-recursive install-ps-recursive install-recursive \ + installcheck-recursive installdirs-recursive pdf-recursive \ + ps-recursive uninstall-recursive nmcheck-recursive bcheck-recursive +RECURSIVE_CLEAN_TARGETS = mostlyclean-recursive clean-recursive \ + distclean-recursive maintainer-clean-recursive +ETAGS = etags +CTAGS = ctags +DIST_SUBDIRS = $(SUBDIRS) +#>- DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) +#>+ 1 +DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) $(KDE_DIST) +ACLOCAL = @ACLOCAL@ +AMTAR = @AMTAR@ +ARTSCCONFIG = @ARTSCCONFIG@ +AUTOCONF = @AUTOCONF@ +AUTODIRS = @AUTODIRS@ +AUTOHEADER = @AUTOHEADER@ +AUTOMAKE = @AUTOMAKE@ +AWK = @AWK@ +CONF_FILES = @CONF_FILES@ +CYGPATH_W = @CYGPATH_W@ +DCOPIDL = @DCOPIDL@ +DCOPIDL2CPP = @DCOPIDL2CPP@ +DCOPIDLNG = @DCOPIDLNG@ +DCOP_DEPENDENCIES = @DCOP_DEPENDENCIES@ +DEFS = @DEFS@ +ECHO_C = @ECHO_C@ +ECHO_N = @ECHO_N@ +ECHO_T = @ECHO_T@ +GMSGFMT = @GMSGFMT@ +INSTALL = @INSTALL@ +INSTALL_DATA = @INSTALL_DATA@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_SCRIPT = @INSTALL_SCRIPT@ +INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +KCFG_DEPENDENCIES = @KCFG_DEPENDENCIES@ +KCONFIG_COMPILER = @KCONFIG_COMPILER@ +KDECONFIG = @KDECONFIG@ +KDE_EXTRA_RPATH = @KDE_EXTRA_RPATH@ +KDE_RPATH = @KDE_RPATH@ +KDE_XSL_STYLESHEET = @KDE_XSL_STYLESHEET@ +LIBOBJS = @LIBOBJS@ +LIBS = @LIBS@ +LN_S = @LN_S@ +LTLIBOBJS = @LTLIBOBJS@ +MAKEINFO = @MAKEINFO@ +MAKEKDEWIDGETS = @MAKEKDEWIDGETS@ +MCOPIDL = @MCOPIDL@ +MEINPROC = @MEINPROC@ +MKDIR_P = @MKDIR_P@ +MSGFMT = @MSGFMT@ +PACKAGE = @PACKAGE@ +PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ +PACKAGE_NAME = @PACKAGE_NAME@ +PACKAGE_STRING = @PACKAGE_STRING@ +PACKAGE_TARNAME = @PACKAGE_TARNAME@ +PACKAGE_VERSION = @PACKAGE_VERSION@ +PATH_SEPARATOR = @PATH_SEPARATOR@ +SET_MAKE = @SET_MAKE@ +SHELL = @SHELL@ +STRIP = @STRIP@ +TOPSUBDIRS = @TOPSUBDIRS@ +VERSION = @VERSION@ +XGETTEXT = @XGETTEXT@ +XMLLINT = @XMLLINT@ +X_RPATH = @X_RPATH@ +abs_builddir = @abs_builddir@ +abs_srcdir = @abs_srcdir@ +abs_top_builddir = @abs_top_builddir@ +abs_top_srcdir = @abs_top_srcdir@ +am__leading_dot = @am__leading_dot@ +am__tar = @am__tar@ +am__untar = @am__untar@ +#>- bindir = @bindir@ +#>+ 2 +DEPDIR = .deps +bindir = @bindir@ +build_alias = @build_alias@ +builddir = @builddir@ +datadir = @datadir@ +datarootdir = @datarootdir@ +docdir = @docdir@ +dvidir = @dvidir@ +exec_prefix = @exec_prefix@ +host_alias = @host_alias@ +htmldir = @htmldir@ +includedir = @includedir@ +infodir = @infodir@ +install_sh = @install_sh@ +kde_appsdir = @kde_appsdir@ +kde_bindir = @kde_bindir@ +kde_confdir = @kde_confdir@ +kde_datadir = @kde_datadir@ +kde_htmldir = @kde_htmldir@ +kde_icondir = @kde_icondir@ +kde_kcfgdir = @kde_kcfgdir@ +kde_libs_htmldir = @kde_libs_htmldir@ +kde_libs_prefix = @kde_libs_prefix@ +kde_locale = @kde_locale@ +kde_mimedir = @kde_mimedir@ +kde_moduledir = @kde_moduledir@ +kde_servicesdir = @kde_servicesdir@ +kde_servicetypesdir = @kde_servicetypesdir@ +kde_sounddir = @kde_sounddir@ +kde_styledir = @kde_styledir@ +kde_templatesdir = @kde_templatesdir@ +kde_wallpaperdir = @kde_wallpaperdir@ +kde_widgetdir = @kde_widgetdir@ +tdeinitdir = @tdeinitdir@ +libdir = @libdir@ +libexecdir = @libexecdir@ +localedir = @localedir@ +localstatedir = @localstatedir@ +mandir = @mandir@ +mkdir_p = @mkdir_p@ +oldincludedir = @oldincludedir@ +pdfdir = @pdfdir@ +prefix = @prefix@ +program_transform_name = @program_transform_name@ +psdir = @psdir@ +sbindir = @sbindir@ +sharedstatedir = @sharedstatedir@ +srcdir = @srcdir@ +sysconfdir = @sysconfdir@ +target_alias = @target_alias@ +top_builddir = @top_builddir@ +top_srcdir = @top_srcdir@ +xdg_appsdir = @xdg_appsdir@ +xdg_directorydir = @xdg_directorydir@ +xdg_menudir = @xdg_menudir@ +KDE_LANG = fr +#>- SUBDIRS = $(AUTODIRS) +#>+ 1 +SUBDIRS =. +KDE_DOCS = AUTO +KDE_MANS = AUTO +#>- all: all-recursive +#>+ 1 +all: docs-am all-recursive + +.SUFFIXES: +$(srcdir)/Makefile.in: $(srcdir)/Makefile.am $(am__configure_deps) +#>- @for dep in $?; do \ +#>- case '$(am__configure_deps)' in \ +#>- *$$dep*) \ +#>- cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \ +#>- && exit 0; \ +#>- exit 1;; \ +#>- esac; \ +#>- done; \ +#>- echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu docs/tdewebdev/quanta/Makefile'; \ +#>- cd $(top_srcdir) && \ +#>- $(AUTOMAKE) --gnu docs/tdewebdev/quanta/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/tdewebdev/quanta/Makefile'; \ + cd $(top_srcdir) && \ + $(AUTOMAKE) --gnu docs/tdewebdev/quanta/Makefile + cd $(top_srcdir) && perl ../scripts/admin/am_edit -p../scripts/admin docs/tdewebdev/quanta/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=installation.docbook config-quanta.docbook quanta-projects.docbook index.docbook working-with-quanta.docbook credits-license.docbook glossary.docbook debugging-quanta.docbook index.cache.bz2 quanta-menus.docbook fundamentals.docbook Makefile.in extending-quanta.docbook introduction.docbook adv-quanta.docbook Makefile.am q-and-a.docbook + +#>+ 24 +index.cache.bz2: $(srcdir)/index.docbook $(KDE_XSL_STYLESHEET) glossary.docbook config-quanta.docbook quanta-menus.docbook credits-license.docbook index.docbook adv-quanta.docbook fundamentals.docbook introduction.docbook working-with-quanta.docbook q-and-a.docbook installation.docbook quanta-projects.docbook extending-quanta.docbook debugging-quanta.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)/quanta + @if test -f index.cache.bz2; then \ + echo $(INSTALL_DATA) index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/quanta/; \ + $(INSTALL_DATA) index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/quanta/; \ + elif test -f $(srcdir)/index.cache.bz2; then \ + echo $(INSTALL_DATA) $(srcdir)/index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/quanta/; \ + $(INSTALL_DATA) $(srcdir)/index.cache.bz2 $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/quanta/; \ + fi + -rm -f $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/quanta/common + $(LN_S) $(kde_libs_htmldir)/$(KDE_LANG)/common $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/quanta/common + +uninstall-docs: + -rm -rf $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/quanta + +clean-docs: + -rm -f index.cache.bz2 + + +#>+ 13 +install-nls: + $(mkinstalldirs) $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/quanta + @for base in glossary.docbook config-quanta.docbook quanta-menus.docbook credits-license.docbook index.docbook adv-quanta.docbook fundamentals.docbook introduction.docbook working-with-quanta.docbook q-and-a.docbook installation.docbook quanta-projects.docbook extending-quanta.docbook debugging-quanta.docbook ; do \ + echo $(INSTALL_DATA) $$base $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/quanta/$$base ;\ + $(INSTALL_DATA) $(srcdir)/$$base $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/quanta/$$base ;\ + done + +uninstall-nls: + for base in glossary.docbook config-quanta.docbook quanta-menus.docbook credits-license.docbook index.docbook adv-quanta.docbook fundamentals.docbook introduction.docbook working-with-quanta.docbook q-and-a.docbook installation.docbook quanta-projects.docbook extending-quanta.docbook debugging-quanta.docbook ; do \ + rm -f $(DESTDIR)$(kde_htmldir)/$(KDE_LANG)/quanta/$$base ;\ + done + + +#>+ 5 +distdir-nls: + for file in glossary.docbook config-quanta.docbook quanta-menus.docbook credits-license.docbook index.docbook adv-quanta.docbook fundamentals.docbook introduction.docbook working-with-quanta.docbook q-and-a.docbook installation.docbook quanta-projects.docbook extending-quanta.docbook debugging-quanta.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/tdewebdev/quanta/Makefile'; \ + cd $(top_srcdir) && \ + $(AUTOMAKE) --gnu docs/tdewebdev/quanta/Makefile + cd $(top_srcdir) && perl ../scripts/admin/am_edit -p../scripts/admin docs/tdewebdev/quanta/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-fr/docs/tdewebdev/quanta/adv-quanta.docbook b/tde-i18n-fr/docs/tdewebdev/quanta/adv-quanta.docbook new file mode 100644 index 00000000000..83687254760 --- /dev/null +++ b/tde-i18n-fr/docs/tdewebdev/quanta/adv-quanta.docbook @@ -0,0 +1,469 @@ + + + + +Fonctions avancées + +Christopher Hornbaker
chrishornbaker@earthlink.net
+ + + + +&traducteurPatrickMichelon; + + + + +Fonctions avancées + +Ce chapitre décrit les fonctions avancées de &quantaplus; et comment les utiliser. + + +Outils &XML; + +La version 3.2 de &quantaplus; amène avec elle de nombreux nouveaux outils et fonctions &XML;. Les outils sont uniques dans leur intégration avec &quantaplus;. Tous ces outils utilisent Kommander comme interface et libxml2 et libxslt comme dorsal. La combinaison de ces outils en fait des outils rapides, efficaces, productifs et complets. + + +Outils de documentation de &kde; + +&quantaplus; gère les deux principaux outils de documentation de &kde; : meinproc et checkXML. + + +<command +>meinproc</command +> + +Toute personne qui a travaillé avec la documentation de &kde; sait à quel point meinproc est brillant. C'est un très bon outil avec une superbe interface graphique. Vous n'avez plus besoin de passer par un shell, il suffit de cliquer sur l'icône qui ressemble à un processeur et c'est fini ! + + + +Dossier de travail courant + +Cette application attend qu'un fichier index.docbook soit présent dans un dossier. Si index.docbook est dans le dossier de travail courant, laissez simplement Dossier de travail courant coché. S'il n'est pas présent, décochez Dossier de travail courant et entrez dans le dossier que vous souhaitez traiter dans le champ Autre dossier. + + + + + +Les fichiers en sortie sont placés dans le même dossier que les fichiers source. Tous les fichiers &HTML; sont enlevés à chaque fois que meinproc est utilisé. + + + + + +<command +>checkXML</command +> + +Encore une fois, toute personne qui a travaillé avec la documentation de &kde; connaît cette application utile. Là encore, &quantaplus; lui fournit une petite interface graphique. + + + +Dossier de travail courant + +Si le fichier couramment ouvert est le fichier index.docbook, laissez simplement Dossier de travail courant coché. S'il n'est pas ouvert, décochez Dossier de travail courant et entrez dans le dossier dans lequel index.docbook peut etre trouvé. + + + + + +Sortie +S'il y a une sortie, votre fichier est alors invalide. Corrigez alors les erreurs, et essayez de nouveau. + + + + + +Validation &XML; + +&quantaplus; possède un très bon outil de validation &XML; qui utilise le dorsal xmllint. + + + +Fichier courant + +Si le fichier à valider est actuellement ouvert dans &quantaplus;, laissez simplement Fichier courant coché. S'il ne l'est pas, décochez alors Fichier courant et sélectionnez le fichier à valider à partir du sélecteur Autre fichier. + + + + +Vérification de la conformité + +Si vous souhaitez seulement savoir si un fichier est conforme, cliquez sur la case à cocher Vérification de la conformité seule. + + + + +URI de définition + +Si vous utilisez une &DTD;, et qu'elle est spécifiée dans le fichier &XML;, sélectionnez alors &DTD; (interne)(défaut). Autrement, sélectionnez &DTD; (externe) et localisez la &DTD; avec le sélecteur de fichiers définition &URI;. La validation &W3C; &XML; Schema et RelaxNG est requise pour être définie en externe via le sélecteur de fichiers Definition &URI;. + + + + + + +Traitement &XSL; + +Oui, &quantaplus; possède un outil de traitement &XSL;. Celui-ci utilise l'outil xsltproc fourni avec libxml2. + + + +Fichier courant + +Si le fichier à traiter est actuellement ouvert dans &quantaplus;, laissez simplement Fichier courant coché. S'il ne l'est pas, décochez alors Fichier courant et sélectionnez le fichier à traiter à partir du sélecteur Autre fichier. + + + + +Feuille de style + +Sélectionnez le fichier &XSL; que vous souhaitez faire utiliser. + + + + +Nom du fichier de sortie + +Donnez le nom du fichier que vous souhaitez pour le fichier de sortie. Le fichier est sorti par défaut dans votre dossier personnel. + + + + + +Cette application manque de flexibilité. Cela sera amélioré. + + + + + + + + + +Utilisation de modules externes + +Mathieu Kooiman
quanta@map-is.nl
+ + + +&traducteurPatrickMichelon; + + + + +Utilisation de modules externes + + +Qu'est-ce qu'un module externe ? + +&quantaplus; est capable de charger des modules externes, qui sont des KParts. La structure KPart est une autre structure très puissante de &kde;. Un KPart est un conteneur de fonctionnalités réutilisable et relativement petit. Il permet aux développeurs &kde; de construire sur le travail d'autres programmeurs. Un exemple de ceci est &quantaplus; lui-même. L'éditeur de &quantaplus; utilise le KPart &kate;. Le KPart &kate; avait déjà tout un groupe de fonctionnalités dont &quantaplus; avait besoin comme la mise en surbrillance de la syntaxe. L'intégration dans &quantaplus; a permis aux développeurs de &quantaplus; de se concentrer sur ce que &quantaplus; devait faire, plutôt que de faire face aux nombreux problèmes qu'aurait amené la réalisation d'un éditeur à partir de rien. + +Les modules externes qui sont chargés par &quantaplus; peuvent ne rien avoir à faire avec &quantaplus; lui-même. Ceci en fait un système de modules externes très puissant. Vous pouvez bénéficier de fonctionnalités additionnelles et ne pas avoir à attendre que quelqu'un l'intègre dans &quantaplus; ! Les modules externes peuvent être chargés dans nombre d'éléments d'interface graphique. Plus sur ce sujet ci-dessous. + + + + +Comprendre la boîte de dialogue d'édition de module externe + +Pour installer un module externe ou un Kpart, nous partons du menu Édition Modules externes . Ceci fait apparaître la boîte de dialogue suivante : + + + + + +La boîte de dialogue d'édition de module externe + + +Cette boîte de dialogue vous laisse gérer tous les modules externes définis et vous laisse en ajouter de nouveaux. Nous allons décrire chacun des éléments d'interface graphique ci-dessous : + +Dossier de recherche + +Vous pouvez donner ici un chemin de recherche. Lorsque vous ajoutez un module externe sans emplacement, &quantaplus; cherche selon ces chemins pour trouver le module. + + + + +Ajouter... + +Ceci fait apparaître une boîte de dialogue qui vous permet d'ajouter un nouveau module externe. + + + + +Configurer... + +Ceci vous permet de changer les réglages d'un module externe donné. + + + + +Supprimer + +Enlève le module externe sélectionné. + + + + +Rafraîchir + +Rafraîchit le contenu de la boîte de dialogue. + + + + + + +&debugging-quanta; diff --git a/tde-i18n-fr/docs/tdewebdev/quanta/config-quanta.docbook b/tde-i18n-fr/docs/tdewebdev/quanta/config-quanta.docbook new file mode 100644 index 00000000000..7e0fc8a994e --- /dev/null +++ b/tde-i18n-fr/docs/tdewebdev/quanta/config-quanta.docbook @@ -0,0 +1,9 @@ + + + +Configurer &quantaplus; + +Reste a écrire + diff --git a/tde-i18n-fr/docs/tdewebdev/quanta/credits-license.docbook b/tde-i18n-fr/docs/tdewebdev/quanta/credits-license.docbook new file mode 100644 index 00000000000..6025d9af269 --- /dev/null +++ b/tde-i18n-fr/docs/tdewebdev/quanta/credits-license.docbook @@ -0,0 +1,260 @@ + + + + +Remerciements et licence + +Christopher Hornbaker
chrishornbaker@earthlink.net
+ + + +&traducteurPatrickMichelon; + + + + +Remerciements et licence + + +Nos excuses à toute personne oubliée ou dont le nom a mal été orthographié. + + +Remerciements à tous ceux qui ont passé du temps à contribuer. + + +L'équipe de développement de &quantaplus;. + + +Bergia, Andrea +Éditeur original de &CSS;. + + +Britton, Marc +Kommander, diverses fonctions et correction de bogues. + + +Colton, Matthew +Écran d'accueil pour beaucoup de versions + + +Deschildre, Nicolas +Disposition visuelle de la page et système annuler / refaire. + + +Dmitrienko, Dmitri +Débogage de &PHP;4 + + +Gulmini, Luciano +Guide de cadre + + +Hanley, Jason P. +Différentes corrections, code de base pour la validation de &DTD; et autre travail relatif à la &DTD;. + + +Hindsgaul, Claus +Traduction danoise + + +Hornbaker, Christopher +Documentation &XML; + + +Isdale, Keith +&XSL; 1.0 &DTEP;, &kxsl; + + +Kooiman, Mathieu +Documentation, correction de bogues et débogage &PHP;. + + +Laffoon, Eric +Gestionnaire de projet et administrateur du site internet + + +Mantia, András +Développeur + + +Moore, Richard +Encodage, documentation des balises XML originales, et plus encore. + + +Mous, Fabrice +Documentation + + +Nickel, Robert C. +Documentation + + +Pibil, Ted +Ajout et maintenance des &DTD;. + + +Poplavsky, Dmitry +ex développeur de base, parti pour la version commerciale + + +Vilches, George +Boîte de dialogue de publication fondée sur l'arborescence + + +Yakovlev, Alexander +ex développeur de base, parti pour la version commerciale + + + + + + +Remerciements spéciaux à : + + +xmlsoft.org +Les rédacteurs de libxml2 et libxslt. + + + + + +&quantaplus; Équipe de développement de &quantaplus; 2000, 2001, 2002, 2003. + +Manuel de l'utilisateur de &quantaplus; Équipe de développement de &quantaplus; 2000, 2001, 2002, 2003. +&underFDL; &underGPL; diff --git a/tde-i18n-fr/docs/tdewebdev/quanta/debugging-quanta.docbook b/tde-i18n-fr/docs/tdewebdev/quanta/debugging-quanta.docbook new file mode 100644 index 00000000000..9b066d97348 --- /dev/null +++ b/tde-i18n-fr/docs/tdewebdev/quanta/debugging-quanta.docbook @@ -0,0 +1,58 @@ + + + + +Débogage dans &quantaplus;. + +Christopher Hornbaker
chrishornbaker@earthlink.net
+ + + +&traducteurPatrickMichelon; + + + + +Débogage dans &quantaplus;. + + +Utilisation du débogueur &PHP;. + +Le débogueur &PHP; courant fourni avec &quantaplus; est très peu utilisable. Il sera enlevé de &quantaplus; dans la prochaine version (3.3) et a été désactivé par défaut dans la version courante (3.2). Vous pouvez compter sur un nouveau débogueur pour la version 3.3. + + + +Utiliser &kxsl;, le débogueur &XSL;. + +&kxsl; est la création de Keith Isdale, comme l'est cette section de la documentation. &kxsl; est une interface graphique &kde; et un Kpart à xsldbg que vous pouvez trouver sur http://xsldbg.sf.net, de même que beaucoup d'autres travaux de Keith. + +Pour lancer &kxsl;, sélectionnez Modules externes &kxsl; . + +Reportez-vous à la documentation de &kxsl; pour plus d'informations concernant son utilisation. + + diff --git a/tde-i18n-fr/docs/tdewebdev/quanta/extending-quanta.docbook b/tde-i18n-fr/docs/tdewebdev/quanta/extending-quanta.docbook new file mode 100644 index 00000000000..c3a9c0c9782 --- /dev/null +++ b/tde-i18n-fr/docs/tdewebdev/quanta/extending-quanta.docbook @@ -0,0 +1,1625 @@ + + + + +Extending &quantaplus; + + +Christopher +Hornbaker + +
chrishornbaker@earthlink.net
+ + + + + + + + +Extending &quantaplus; + + +This chapter describes how to customize &quantaplus; to your particular +needs and how you can help &quantaplus; become better. + + + + + +Document Type Editing Package (&DTEP;) + + +Document Type Editing Packages (&DTEP;s) are used in &quantaplus; to add +support for markup, scripting languages, and &CSS;. They allow +&quantaplus; to provide features like auto-completion and node trees. +Their simplicity and flexibility are what make &quantaplus; a fast, +developer friendly &IDE; for web developers. They are what make &quantaplus; +an easy-to-use, productive environment. + + + +&DTEP;s come in two flavors, Family 1, which are markups, and Family 2, +which are scripting and &CSS;. &DTEP;s are made up of two parts, the Tag +Folder and the Toolbars. Tag Folders are composed of two types of files, +the description.rc and TagXML files, which carry the extension .tag. +Toolbars are the handy, icon-oriented tabs of buttons (above the editing +window) which place text into a document faster than the user can type. + + + +This document describes how to make TagXML files, the description.rc, and +toolbars. In short, a &DTEP;. + + + +TagXML files (.tag) define both the attributes specific to a tag and the +layout and contents of the properties dialog &quantaplus; shows for the tag. +The description.rc file provides rules and information on the &DTEP; +itself. Toolbars provide a quick means for adding tags into a document +without worry of mis-spellings and such. + + + +Packaging + + +Tag Folders are just that, folders. They are composed only of the +description.rc and TagXML files. Tag Folders carry the name of the mark-up +language and version, if applicable. (For example, html-4.01-strict) + + + + +TagXML + + +The table below lists the elements defined in TagXML and declares whether +they are required or not. While not all are required, it is recommended +that you use as many as you can so that other users can have a better +experience and more information to work with. + + + + + + +Element +Default Usage +Case Usage + + + + +TAGS +required +always + + +tag +required +always + + +label +optional +required to create a properties dialog + + +attr +optional +required to define an attribute + + +tooltip +optional +required to have the properties dialog display a tooltip + + +whatsthis +optional +required to have the properties dialog display a What's This + + + +list +optional +required when an attr is of the type list + + +item +optional +required when <list> is used + + +textlocation +optional +always + + +location +optional +required when label is used + + +text +optional +required when label is used + + +children +optional +list of tags that can appear within the tag being defined + + +child +required +a children entry + + +stoppingtags +optional +list of tags that tell another tag to end + + +stoppingtag +required +a stoppingtags entry + + + + + + + +TagXML Element Descriptions + + +The following sections will describe, in detail, each element. Everything +from where they can go to what goes in them is layed out in an +easy-to-follow manner. + + + +TAGS + + +This is the root element of a TagXML document. It may appear in a document +only once. It can contain the definition of multiple tags. This is an +element-only type element. + + + + + + +Parent(s) +Children + + + + +NONE +tag + + + + + + + +tag + + +Wrapper for tag being defined. This is an element-only type element. + + + + + + +Parent(s) +Children + + + + +TAGS +label, attr, stoppingtags + + + + + + + + + +AttributeTypeValues +DefaultUseDescription + + + + +namestring +requiredSpecifies the name of the tag being defined. + + +singleboolean +optionalSpecifies whether or not the tag requires a +closing tag </(tagname)>. + + +typestringxmltag +optionalSpecifies the type of tag being defined. + + +xmltag +Type of tag is XML-based. (Family 1 only.) + + +property +Type of tag is &CSS; related. (Family 2 only.) + + +function +Type of tag is a script function. When used, +<attr> becomes arguments of the function. (Family 2 only.) + + +class +Type of tag is a script class. (Family 2 only.) + + +returnTypestringvoid + +optionalSpecifies the return type of tag being +defined. (Family 2 only.) + + +void +Type of tag returns void. + + +int +Type of tag returns int. + + +float +Type of tag returns float. + + +long +Type of tag returns long. + + +string +Type of tag returns string. + + + + + + + +label + + +Place a label in the dialog. The text is specified by the <text> tag. +This is an element-only type element. + + + + + + +Parent(s) +Children + + + + +tag +text, location + + + + + + + +attr + + +Defines an attribute of the tag. This element occurs once for each +attribute. It defines the name and type of attribute. It also contains +additional tags that specify how this attribute should be displayed, et cetera. +This is an element-only type element. + + + + + + +Parent(s) +Children + + + + +tag +location, list, tooltip, whatsthis, textlocation + + + + + + + + + +AttributeTypeValues +DefaultUseDescription + + + + +namestring +requiredSpecifies the name of the attribute being +defined. + + +typestringinput +requiredSpecifies the type of the attribute being +defined. + + +input +Field supports free text entries (text field). + + +check +Field value is boolean (check box). + + +color +Field value is a color. + + +url +Field value is a &URL;. (Local file to refer to.) + + +list +Field value is an item from a specified list. + + +statusstringoptional +requiredSpecifies whether or not the argument is +required. (Family 2 only.) + + +optional +Argument is optional. + + +required +Argument is required. + + +implied +Argument is implied. + + + + + + + +tooltip + + +Defines the tooltip for a field in the dialog. This element is text-only. + + + + +Currently only plain text is supported (you cannot use any markup). + + + + + + + +Parent(s) +Children + + + + +attr +NONE + + + + + + + +whatsthis + + +Defines the 'What's This' help for a field in the dialog. This element is +text-only. + + + + +Currently only plain text is supported (you cannot use any markup). + + + + + + + +Parent(s) +Children + + + + +attr +NONE + + + + + + + +list + + +A container tag that groups together the items in a list. It may appear +only once for each attribute description. This is an element-only type +element. + + + + + + +Parent(s) +Children + + + + +attr +item + + + + + + + +item + + +Defines an item in a list. This element is text-only. + + + + + + +Parent(s) +Children + + + + +list +NONE + + + + + + + +textlocation + + +Specifies the position of a tag's attribute text within a dialog. This tag +can only occur once for each attribute in the dialog (&cad; one for each +<attr> tag). This element is empty. + + + + + + +Parent(s) +Children + + + + +attr +NONE + + + + + + + + + +AttributeType +UseDescription + + + + +rownonNegativeInteger +requiredSpecifies the row in the dialog layout of a +field or label. + + +colnonNegativeInteger +requiredSpecifies the column in the dialog layout of +a field or label. + + +rowspannonNegativeInteger +optionalSpecifies the number of rows a field should +span. + + +colspannonNegativeInteger +optionalSpecifies the number of columns a field +should span. + + + + + + + +location + + +Specifies the position and size of a field in the dialog. This tag should +occur once for each field in the dialog (&cad; one for each <attr> and +<label> tag). This element is empty. + + + + + + +Parent(s)Children + + + + +label, attrNONE + + + + + + + + + +AttributeType +UseDescription + + + + +rownonNegativeInteger +requiredSpecifies the row in the dialog layout of a +field or label. + + +colnonNegativeInteger +requiredSpecifies the column in the dialog layout of +a field or label. + + +rowspannonNegativeInteger +optionalSpecifies the number of rows a field should +span. + + +colspannonNegativeInteger +optionalSpecifies the number of columns a field +should span. + + + + + + + +text + + +Define the text for a label or check box. This element is text-only. + + + + + + +Parent(s)Children + + + + +label, attrNONE + + + + + + + +children + + +Defines a list of elements that can appear within the tag being specified. +This element is an element-only type element. + + + + + + +Parent(s)Children + + + + +tagchild + + + + + + + +child + + +Defines a child tag. This element is empty. + + + + + + +Parent(s)Children + + + + +childrenNONE + + + + + + + + + +AttributeType +UseDescription + + + + +namestring +requiredSpecifies a tag that can appear within the a +certain tag. + + + + + + + +stoppingtags + + +Defines a list of elements that force a tag to end. This element is an +element-only type element. + + + + + + +Parent(s)Children + + + + +tagstoppingtag + + + + + + + +stoppingtag + + +Defines a stopping tag. This element is empty. + + + + + + +Parent(s)Children + + + + +stoppingtagsNONE + + + + + + + + + +AttributeType +UseDescription + + + + +namestring +requiredSpecifies which tags force the ending of +another tag. + + + + + + + + +TagXML Usage + + +All TagXML files must begin with the &XML; declaration: <?xml +version="1.0" encoding="UTF-8"?> and must be properly nested and closed. + + + + +White space does not adversely affect anything, but watch out for & and +< characters. These should likely be replaced with an &amp; and +&lt;, respectively, in elements such as <tooltip>, <whatsthis>, +and <text>. Not doing so will not cause a crash, but you will have +chunks of your work disappear if you do not. + + + + + +TagXML Validation + + +To validate your TagXML files, simply click the Tools +pop-up dialog at the top of &quantaplus; and select Validate +TagXML. A dialog will present itself and you need only to follow +the simple directions. + + + + +This feature is currently not present. Currently validation occurs when +the TagXML files are loaded into &quantaplus;. + + + + + +TagXML Examples + + +Family 1 + + +The following will show you a valid Family 1 TagXML file. This file +happens to describe &W3C; &XML; Schema's <schema> element. The file name +for this TagXML file would be schema.tag. Simple, eh? + + + + + +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE TAGS> +<TAGS> + <tag name="schema"> + <label> + <text>id</text> + <location col="0" row="0"/> + </label> + <attr name="id" type="input"> + <tooltip>A unique ID for the element.</tooltip> + <whatsthis>A unique ID for the element.</whatsthis> + <location col="1" row="0"/> + </attr> + + <label> + <text>version</text> + <location col="0" row="1"/> + </label> + <attr name="version" type="input"> + <tooltip>Version of the schema.</tooltip> + <whatsthis>Version of the schema.</whatsthis> + <location col="1" row="1"/> + </attr> + + <label> + <text>targetNamespace</text> + <location col="0" row="2"/> + </label> + <attr name="targetNamespace" type="input"> + <tooltip>&URI; reference of the namespace of this schema.</tooltip> + <whatsthis>&URI; reference of the namespace of this schema.</whatsthis> + <location col="1" row="2"/> + </attr> + + <label> + <text>xmlns</text> + <location col="0" row="3"/> + </label> + <attr name="xmlns" type="input"> + <tooltip>&URI; reference for one or more namespaces for use in this schema. + If no prefix is used, then components of that namespace may be used unqualified.</tooltip> + <whatsthis>&URI; reference for one or more namespaces for use in this schema. + If no prefix is used, then components of that namespace may be used unqualified.</whatsthis> + <location col="1" row="3"/> + </attr> + + <label> + <text>attributeFormDefault</text> + <location col="0" row="4"/> + </label> + <attr name="attributeFormDefault" type="list"> + <items> + <item>qualified</item> + <item>unqualified</item> + </items> + <tooltip>Default form for all attributes within this schema.</tooltip> + <whatsthis>Default form for all attributes within this schema.</whatsthis> + <location col="1" row="4"/> + </attr> + + <label> + <text>elementFormDefault</text> + <location col="0" row="5"/> + </label> + <attr name="elementFormDefault" type="list"> + <items> + <item>qualified</item> + <item>unqualified</item> + </items> + <tooltip>Default form for all elements within this schema.</tooltip> + <whatsthis>Default form for all elements within this schema.</whatsthis> + <location col="1" row="5"/> + </attr> + + <label> + <text>blockDefault</text> + <location col="0" row="6"/> + </label> + <attr name="blockDefault" type="input"> + <location col="1" row="6"/> + </attr> + + <label> + <text>finalDefault</text> + <location col="0" row="7"/> + </label> + <attr name="finalDefault" type="input"> + <location col="1" row="7"/> + </attr> + </tag> +</TAGS> + + + + + + +Family 2 + + +The following will show you a valid Family 2 TagXML file. This file +happens to describe &PHP;'s overload function. The file name for this +TagXML file would be overload.tag. + + + + + +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE tags> +<tags> + <tag name="overload" type="function" returnType="void"> +<attr name="class_name" type="string" status="optional"/> + </tag> +</tags> + + + + + + + + +description.rc + + +The description.rc file is, also, quite simple. Not all of the following +need be used. The basic structure of the description.rc file is as +follows. + + + +Family 1 Structure + + + + +[General] - Generic information. +Version = Use 1 for &quantaplus; version <=3.1.2 and 2 for any version greater. +Name = DTD definition string. (-//&W3C;//DTD HTML 4.01 Transitional//EN) +NickName = The beautified name of the DTD. (HTML 4.01 Transitional). If not defined, Name is +used as NickName. +&URL; = &URL; pointing to the DTD definition. (http://www.w3.org/TR/html4/loose.dtd) +DoctypeString = The string that should appear in the !DOCTYPE declaration. +(HTML PUBLIC "-//&W3C;//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd") +Inherits = The name of the DTD from where this DTD inherits its tags. (-//&W3C;//DTD HTML 4.01//EN) +DefaultExtension = New files are created with this extension. (html) +Groups = The list of common attribute groups, which may be present in more than one tag. +(Core, I18n, Script) See below. (Group1, Group2...) +NumOfPages = How many pages does a tag dialog have, aside of the page containing the +attributes defined in the tag file? See below. (Page1,...) +CaseSensitive = Case-sensitiveness of the DTD. (true|false) +Family = 1This type of DTEP is of family 1, since it is a markup. + +[Toolbars] - Information about DTEP toolbars. +Location = The folder name inside $KDEDIR($KDEHOME)/share/apps/quanta/toolbars +where the toolbars for this DTEP are. +Names = The list of toolbar file names, minus the .toolbar.tgz extension, that +are loaded for this DTEP from the above folder. + +[Group1] - Replace with one of the Groups listed below. +Attributes = The list of attributes for this group. Currently, all of the listed attributes are + treated as strings. +Example: +[Core] +Attributes = id, class, style, title + +[Page1] - Description of a tag editor page. +Title = The title of this page in the tag editing dialog. +Groups = List of groups appearing on this page. (Core, I18n) + +[Extra rules] - Some rules not fitted in other places. +BooleanAttributes = (simple|complex) +Example for simple: <tag booleanAttr>. +Example for complex: <tag booleanAttr="1"> or <tag booleanAttr="true"> +Single Tag Style = (html|XML) +Example for html: <single_tag> +Example for XML: <single_tag /> +StructGroupsCount = The number of structure groups. See below. +MinusAllowedInWords = If true "this-is-a-word" is treated like a word. Otherwise, +it is treated like 4 words. +TagAutoCompleteAfter = CHAR. The auto-completion box is brought up automatically +once this CHAR is entered or SPACE is pressed after this CHAR. For DTEP family 1, +it is usually "<" The text "none" instead of a CHAR specifies that the tag +completion box should not be brought up automatically, only if the user requests it. +AttributeSeparator = CHAR. This CHAR means that the attribute name has ended. +It is " for XML DTEPs. +TagSeparator = CHAR. Similar to the above. + +[StructGroup_1] - Definition of structure group 1. +Name = The text that appears if there are tags matching this group settings. +No_Name = The text that appears if there are NO tags matching this group settings. +Icon = The name of the icon appearing before the above texts. +Tag = tagname(attribute1, attribute2, ...). Tags with name tagname will appear +under this group. The item text will be "attribute1_value | attribute2_value | ..." +Currently only one tag may be listed here. +HasFileName = (true|false) True, if the item text (above attribute values) contains a file name. +FileNameRx = Regular expression used to remove the unnecessary chars from the item text. + +[Parsing rules] - Rules used when parsing the document. +SpecialAreas = The beginning and ending string of special areas, separatted by a comma. +Special areas are not parsed according to this DTEP's rules, but as their own rules. +A special area can be a DTEP of another family, a comment, or something to that effect. +Eg. <!-- --> +SpecialAreaNames = Comma separated list of the above special area names. Eg. comment +SpecialTags = tagname(attributename) - Specifies a tag which defines the start of a special area. +MayContain = Comma separated list of family 2 DTEPs that can be present in the document. +(php, css) + + + + + + +Family 2 Structure + + + + +[General] - Generic information. +Version = Use 1 for &quantaplus; version <=3.1.2 and 2 for any version greater. +Name = Proper name +NickName = What every calls it. If not defined, Name is used as NickName. +Inherits = The name of the DTEP from where this DTEP inherits tags. (The Name, not NickName) +DefaultExtension = New files are created with this extension. (php) +NumOfPages = 0 Always zero because there is not a tag editing dialog for +Family 2 DTEPs. +CaseSensitive = Case-sensitiveness of the DTEP. (true|false) +Family = 2This type of DTEP is of family 2, since it is not markup. + +[Toolbars] - Information about DTEP toolbars. +Location = The folder name inside $KDEDIR($KDEHOME)/share/apps/quanta/toolbars +where the toolbars for this DTEP are. +Names = The list of toolbar file names, minus the .toolbar.tgz extension, that +are loaded for this DTEP from the above folder. + +[Extra rules] - Some rules not fitted in other places. +BooleanAttributes = (simple|complex) +Example for simple: <tag booleanAttr>. +Example for complex: <tag booleanAttr="1"> or <tag booleanAttr="true"> +StructGroupsCount = The number of structure groups. See below. +MinusAllowedInWords = If true "this-is-a-word" is treated like a word. Otherwise, +it is treated like 4 words. +TagAutoCompleteAfter = CHAR. The auto-completion box is brought up automatically +once this CHAR is entered or SPACE is pressed after this CHAR. For DTEP family 1, +it is usually "<" The text "none" instead of a CHAR specifies that the tag +completion box should not be brought up automatically, only if the user requests it. +AttributeSeparator = CHAR. This CHAR means that the attribute name has ended. +It is " for XML DTEPs. +TagSeparator = CHAR. Similar to the above. +AttributeAutoCompletionAfter = CHAR. Similar to the TagAutoCompletionAfter, but +for tag attributes. It is "(" by default and ":" for CSS. + +[StructGroup_1] - Definition of structure group 1. +Name = The text that appears if there are tags matching this group settings. +No_Name = The text that appears if there are NO tags matching this group settings. +Icon = The name of the icon appearing before the above texts. +Tag = tagname(attribute1, attribute2, ...). Tags with name tagname will appear +under this group. The item text will be "attribute1_value | attribute2_value | ..." +Currently only one tag may be listed here. +HasFileName = (true|false) True, if the item text (above attribute values) contains a file name. +FileNameRx = Regular expression used to remove the unnecessary chars from the item text. +SearchRx = regular expression used to find text areas in the Family 2 DTEP, which +will belong to this group +ClearRx = regular expression used to clear unwanted text/chars from the above +search result. The cleaned string will appear in the structure tree. + +[Parsing rules] - Rules used when parsing the document. +SpecialAreas = The beginning and ending string of special areas, separated by a comma. +Special areas are not parsed according to this DTEP's rules, but as their own rules. +A special area can be a DTEP of another family, a comment, or something to that effect. +Eg. <!-- --> +SpecialAreaNames = Comma separated list of the above special area names. Eg. comment +SpecialTags = tagname(attributename) - Specifies a tag which defines the start of a special area. +AreaBorders = Comma separated list of the area borders encapsulating this Family 2 DTEP. In the +case of PHP, it is: <? ?>, <* *>, <% %> +Tags = tagname(attribute). If the parent(real) DTD has a tag with tagname and +the attribute value of this tag is equal with the DTD name, the tag area +is parsed according to the rules of this DTD. +Comments = comma separated list of area borders for comments. EOL means end-of-line. +Eg: // EOL, /* */ +StructKeywords = Semicolon separated list of structure keywords. Structures are treated +as new nodes in the structure tree. +StructBeginStr = A string specifying the beginning of a structure (like {) +StructEndStr = A string specifying the beginning of a structure (like }) +StructRx = Regular expression containing the beginning or the end of the structure +area. Eg. \\{ | \\} (structure area border can be { or }) + + + + + + + + +Creating Toolbars + + +The following will show you how to create toolbars for a &DTEP;. Toolbars +are graphical elements that are assigned to actions. Actions, in +&quantaplus;, are the basis for nearly all the extensions that +&quantaplus; has and will acquire in the future. The same mechanism that +defines an action in &quantaplus; also enables auto-completion and tag +dialogs. With actions, the limit of what you can do is virtually +limitless. For means of an example, we will use &HTML; tidy on our web pages. + + + +From Scratch to Complete + + +To begin, you will need to create a user toolbar. Select + +Toolbars +Add User Toolbar +. + + + +If there are many tags for the markup language, it is recommended that you +split up the tags into logical groups. You will need to create a new user +toolbar for each group. In this case, there are not many, so we will be +making one toolbar and naming it with the name of the markup. + + + +Once all your toolbars are created, you must add and configure the +actions. To do this, select + +Settings +Configure Actions + + +. + + + +The parts of this window are pretty straight forward. Press the +New action button at the bottom of the window to +enter the editing mode. + + + +Fill in all of the necessary fields and add the tag to the appropriate +toolbar(s). + + + +Complete the rest and, if the tag has attributes and you always plan to +use them, check the Run "Edit tag" dialog if available + box so that you will be prompted every time the action is used. + + + +You should now have something much like the following. + + + + + + + + + +Press the Apply button and you will see the action +added to the toolbar(s) you have selected. + + + + + + + + + +Egad! That's an awful icon. How will yourself and others remember that +icon goes with that action? Let's replace it before trouble arises. + + + +To create an icon that more accurately describes that action, we will be +using &kiconedit;. Select it from the &menuk;, +Graphics +More Programs + (or where ever your distribution placed it). + + + +&kiconedit; defaults to the size 32x32 pixels, but we need 22x22. To +change this, select + +Edit +Resize +. + + + +Keep in mind that you are creating an icon that will assist in helping not +only yourself to remember which action does what, but also other users of +the &DTEP;. + + + +Since the tag I am creating the icon for is called start, +I have decided to create a Start sign. Using the color green +(green often interpreted as go, start, or +proceed) will, or, at least, should, convey a message +to the user that clicking this action will place the <start> tag in the +current document. + + + + + + + + + +Now that I am finished with the creation of the icon, I will save it. + + + +Once you are done with creating the icon(s), you must associate the icon +with the action. To do this, open + +Settings +Configure Actions + again (in &quantaplus;) and select the action you made +the icon for. Beside the Text field, you will see a +button, click it. + + + +Select Other Icons and then click the +Browse button. + + + +Goto the folder in which you saved the icon, select the icon, and click +OK. + + + +Press the Apply button and either continue to do the +same with the other tags, if any, or click OK to +finish. + + + + + + + + + +Let us say you would like to add some common &quantaplus; functions to your +toolbar or maybe you think the toolbar would be better off organized in a +different manner with some separators to group the actions. Open the +Configure Toolbars dialog by going + +Settings +Configure Toolbars +. Make sure your toolbar is selected. + + + +I will be choosing the separator (top of the left column) for my toolbar. +Once you have selected the item you wish to add to your toolbar, press the +right arrow button. This will add it to your toolbar. + + + + + + + + + +I think I would like a quick way to access the Konqueror +Preview. I will select it and add it to the toolbar. + + + + + + + + + +Note how the separator helps in grouping. Someone new to my toolbar might +have thought that the &konqueror; button was like or the opposite of the +start button. + + + + + + + + + +Apply your changes and, when you are done, press OK +to finish. + + + +Ah, look at the fantastic new toolbar! Much more handy now. + + + + + + + + + +Remember to test your toolbar, by clicking all the buttons, so that you +know the output is correct. + + + + + + + + + +Now to save the toolbar, we will select + +Toolbars +Save Toolbars +Save as Local Toolbar +. + + + +Save it to the correct folder. Since NeXML does not exist, I will just +have it to the top-level folder, but your toolbar(s) should be saved to +the correct folder. Make sure to adjust your description.rc to have it +load your toolbar(s) when a new file of that type is created. + + + + + + + +Creating Your Own Documentation + + +Robert +Nickel + +
robert@artnickel.com
+ + + + + + + + +Creating Your Own Documentation + + +Probably the most notable additions to &quantaplus; for the general user +will be the addition of documentation for the markup or scripting language +that you like best. To that end, this chapter will explain how I create +the &PHP; documentation tree for my personal use. + + + +Before starting on creating your own documentation, you may wish to check +out the +&quantaplus; repository to see if someone else has already done +this set. + + + +There are two parts to this process. First, you must obtain the existing +documentation for the markup/scripting/&etc; language that you are after. +Second, you have to create the docrc file. The first +is up to you, the second is what we will cover here. + + + +The general form of the docrc file is as follows: + + + + +#KDE Config File +[Tree] +Doc dir=path, relative to this file, of the documentation html files &pex; php42/ +#top level elements +Top Element=Your description for these documentation &pex; &PHP; 4.2 documentation + +Section 1=Section1.html +Section 2=#Sec2.1,#Sec2.2,#Sec2.3 +Sec2.1=Sec2.1.html +Sec2.2=Sec2.2.html +Sec2.3=Sec2.3.html +... + +[Context] +ContextList=func1,func2,tag1,tag2,tag3 +func1=func1.html +func2=func2.html +tag1=tag1.html +tag2=tag2.html +tag3=tag3.html + + + + +The docrc is broken down into two sections: Tree and +Context. + + + +The Tree section defines the presentation aspect of the documentation in +the documentation tab. For example, you will see that in the &PHP; +documentation you have something akin to this: + + + + + + + + + +Relating this to the above, my &PHP; docrc looks like +this: + + + + +#KDE Config File + +[Tree] + +Doc dir=php42/ + +#top level elements +Top Element=PHP 4.2 documentation + +PHP 4.2 documentation=Table of Contents,#Getting Started,#Language Reference + +Table of Contents=index.html + +Getting Started=Introduction, ... +Introduction=introduction.html +... + +Language Reference=Basic syntax, ... +Basic syntax=language.basic-syntax.html +... + + + + + +Notice the # in front of Getting Started +and Language Reference. This indicates that these are sub +containers in the tree and have content of their own. I do not believe that +there is a set limit to the depth here (other than that driven by sanity) +— use your judgment. + + + +For the Table of Contents, you will notice that it is referenced directly to +a file (and consequently shows up at the bottom of the tree view — +folders first!). + + + + +Spaces do not adversely affect anything, but watch out for & and < +characters. These should likely be replaced by &amp; and &lt; +respectively in all of the &XML; based &quantaplus; resource files. + + + + +The Context section is the section of the docrc file that is used to +facilitate context sensitive help. For example, you are writing a &PHP; +script and you would like to see the documentation for the +mysql_fetch_array function. You simply highlight the +function and then press &Ctrl;H + for context help. The documentation on +mysql_fetch_array will immediately display. There are +only two entry types here: the ContextList and the file association lines. + + + + +ContextList + + +Really simple, this is just a comma separated list of the context items +you wish to have available (for &PHP;, these are the functions for &PHP;). + + + + +File association lines + + +These are of the form context item=html doc page. &pex; +acos=function.acos.html + + + + + + +A pared down version of my docrc Context section is +as follows: + + + + +#Keywords for context help +[Context] +ContextList=abs,acos,acosh,addcslashes,addslashes,... + +abs=function.abs.html +acos=function.acos.html +acosh=function.acosh.html +addcslashes=function.addcslashes.html +addslashes=function.addslashes.html +... + + + + +Now you can just save your docrc file, save it in +$HOME/.kde/share/apps/quanta/doc +or $KDEDIR/share/apps/quatna/doc +for local or global use respectively. Then create a folder (the one +specified in your docrc file) in the same folder +as your docrc file and copy your &HTML; pages in +there. + + + +You will need to restart &quantaplus; to see your documentation. + + + +Once you are sure that they are good and worth sharing, send the +docrc file along with a description of any pertinent +information on what documentation you used to the +&quantaplus; +repository for use by the &quantaplus; community. You will not get +rich, but you will feel great knowing that you contributed to the best web +development platform around. + + + + diff --git a/tde-i18n-fr/docs/tdewebdev/quanta/fundamentals.docbook b/tde-i18n-fr/docs/tdewebdev/quanta/fundamentals.docbook new file mode 100644 index 00000000000..65038145f67 --- /dev/null +++ b/tde-i18n-fr/docs/tdewebdev/quanta/fundamentals.docbook @@ -0,0 +1,371 @@ + + + + +The Fundamentals of &quantaplus; + + +Robert +Nickel + +
robert@artnickel.com
+ + + + +Christopher +Hornbaker + +
chrishornbaker@earthlink.net
+ +Reviewer + + + +Fabrice +Mous + +
fabrice@kde.nl
+ +Reviewer + + + + + + + +The Fundamentals of &quantaplus; + + +Within &quantaplus; there are serveral key concepts. To understand and +take advantage of &quantaplus;, you must first learn these concepts, the +fundamentals. This chapter will explain and show you these concepts, without +which &quantaplus; would be primative. + + + +The Workspace + + +&quantaplus; divides the workspace into three scopes: Global, Local, and +Project. These distinctions affect various components in &quantaplus;. + + + + +Global + + +Global items are available to anyone that uses &quantaplus;. From toolbars +to actions, everything marked as global is stored in the common +&quantaplus; folder structure. This has the effect of allowing a group +of admins to save certain toolbars, actions, and templates in the global +tree, which can then be used to keep a multi-user installation of +&quantaplus; common to everyone on the system. + + + + + +Local + + +Local items make up a single user's personal collection of web development +resources. These items are made up of a user's templates and toolbars. +Local items are stored in a user's home folder. This makes all of the +user's Local items available for personal use at instance. + + + + + +Project + + +Project items are are only available to a particular project. These can +be anything from a &CSS; template to a toolbar with custom actions +which perform a special task on a project's files. Simply put, this is +the most limited scope. All of the items saved in the project workspace +will be saved in the project's folder tree, allowing you to share your +specialized tools and templates with whomever else you share your +project with. + + + + + + + + +The Multi-Document Interface + + + + + +&quantaplus; editing the document you are now reading. + + + +&quantaplus;' &MDI; is broken down to three main parts: the editor window, +the Quick Info Tabs, and the toolbars. Please see , +, and for more +information on these parts. + + + +The Editor Window + + + + + + +&quantaplus;' editor window. + + + + +&quantaplus;' editor window allows for multiple files to be opened at the +same time. When just one file is open, the document fills the entire +editor window. As soon as a second document is opened, a small amount of +space is taken from the bottom of the editor window to allow for tabs to +be displayed with the filenames and a status icon. (The above picture shows +a floppy icon beside the filename, indicating that the +file has been modified and should be saved.) + + + +At the top of the editor window is the editor toolbar set. Currently, +&quantaplus; defaults to &HTML; 4.01 Transitional, which has a default set +of toolbars that are loaded. As &quantaplus; progresses, the toolbars will +be updated to meet the needs of users and to make use of newer features. + + + +Toolbar usage is pretty straight forward. If you want to insert a basic +tag, like <u>, into your document, then you can click on the icon that +represents the tag. Now you can insert your data for the tag you have just +inserted. If you wish to insert a tag that requires certain attributes +(like an anchor), then you will get a dialog box with the various fields for +you to fill in. + + + + + +The anchor (<a>) dialog. + + + + + +The Quick Info Trees + + + + + +The Quick Info Trees. + + + +The Quick Info Trees (&QIT;) allow you to navigate, open, and gather +information in &quantaplus;. Its tabbed format presents you with the Files, Project, +Templates, Document Structure, Scripts, Attribute, and Documentation Trees. + + + +&QIT; Explained + + + +Files Tree + + + + + + + + +This is where you can browse your entire file system. You are presented +with two top-level roots of the file system. The first is your home folder +and the second is /. Use these to find existing files on your machine that +you would like to edit or add to an active project. &BDS; clicking on a file +in this view gives you several options for managing the selected file and, +also, allows you to insert the file into an active project, if any, or +toggle the view between tree and list. + + + + + +Project Tree + + + + + + + + +Project management is one of the +many powerful tools that &quantaplus; offers. This tab displays all files +within your project and allows you to manage the files within the project +through the use of &BDS; clicking. Actions, such as add, remove, upload, +or delete files entirely from the disk, can be performed through this menu. + + + + + +Templates Tree + + + + + + + + +Another feature of &quantaplus; is templates. Templates can be anything +you would like. Images, code snippets, an entire web page, et cetera. It +is entirely up to you. + + + +Templates are sorted into three categories, which are based on their scope +and the context they are being used. These scopes are carried over from +&quantaplus;' workspace. Global templates are usable all times, local +templates are usable to the current user, and project templates +are usable only within their specified project. More on templates can be +found in . + + + + + +Scripts Tree + + + + + + + + +Here you will find information about the various scripts available for use +by you. The Global, Local, and Project concept allows here as well. By +&BGS; clicking the entries, you gain access to all the available +information about the script. And &BDS; clicking allows you to perform a +few actions, such as running the script, editing the script, and emailing +the script, for example. + + + + + +Document Structure Tree + + + + + + + + +This tab displays the parser's internal representation of your document. +By &BGS; clicking on a element, your cursor will taken to the element's +position in the document. By &BDS; clicking on an element, you are +presented with a number of actions that deal with navigating and updating +the tree. + + + + + +Attribute Tree + + + + + + + + +This tree appears below all the other &QIT;s. Within it you can quickly +edit attributes and namespaces. The content-focused entry system +allows you to modify all the available attributes with little more than a +few clicks of the mouse. + + + + +Attribute Tree + + + + + + +Documentation Tree + + + + + + + + +Here you can find complete documentation on web technologies to aid your +development. You can download pre-packaged documentation for &quantaplus; +at &quantaplus;' +documentation site, you can create your own documentation, +and, by adding a folder named "doc" to a project, you can add, edit, +and view project-specific documentation. + + + + + + + +The Toolbars + + + + + +&quantaplus;' &HTML; toolbars. + + + +&quantaplus;' toolbars have been extended greatly and are easy to +understand. You click on the button and you get an associated action from +that button. The beautiful part about toolbars is that you can define your +own actions graphically within &quantaplus;. + + + +Managing toolbars in &quantaplus; is easy. By selecting the +Toolbars menu, you have the options to load, save, add, and +email toolbars. When you choose to load a toolbar, you may choose from one +of the three workspaces in +&quantaplus;. When saving a newly created toolbar, you can save it in the +local scope or within a project's scope. If you would like to make a new +toolbar available in the global scope, ask your admin to place it in +&quantaplus;' global toolbar folder. + + + +Another feature of &quantaplus; is the ability to email your toolbars. +&quantaplus; sends the toolbar as a gzipped tar archive through &kmail;. +If you receive a toolbar in email, then you can save (and load) it into +&quantaplus; like any other toolbar! + + + + diff --git a/tde-i18n-fr/docs/tdewebdev/quanta/glossary.docbook b/tde-i18n-fr/docs/tdewebdev/quanta/glossary.docbook new file mode 100644 index 00000000000..bc1839c9f9a --- /dev/null +++ b/tde-i18n-fr/docs/tdewebdev/quanta/glossary.docbook @@ -0,0 +1,76 @@ + + + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + + +Christopher Hornbaker
chrishornbaker@earthlink.net
+ +Relecteur + + +&traducteurGoneriLeBouder; + + + + + +Mots clefs + +xsldbg + +Consultez + + + +XPath + +Une expression valide qui définit quel type d'information est requis. Consultez le site du &W3C; + + + +QName + +Un nom pleinement qualifié. Par exemple xsl:mavariable. Consultez le site du &W3C; + + + + diff --git a/tde-i18n-fr/docs/tdewebdev/quanta/index.cache.bz2 b/tde-i18n-fr/docs/tdewebdev/quanta/index.cache.bz2 new file mode 100644 index 00000000000..109be56d231 Binary files /dev/null and b/tde-i18n-fr/docs/tdewebdev/quanta/index.cache.bz2 differ diff --git a/tde-i18n-fr/docs/tdewebdev/quanta/index.docbook b/tde-i18n-fr/docs/tdewebdev/quanta/index.docbook new file mode 100644 index 00000000000..e36f67e34a0 --- /dev/null +++ b/tde-i18n-fr/docs/tdewebdev/quanta/index.docbook @@ -0,0 +1,294 @@ + + + + + + + + + + + + + + + + CGI"> + DTD"> + DTEP"> + HTML"> + IDE"> + PHP"> + PDF"> + SGML"> + XSD"> + W3C'> + QIT"> + MDI"> + Gubed PHP Debugger"> + KXsldbg"> + VPL"> + + + description.rc'> +]> + + +Manuel de l'utilisateur de &quantaplus; + + + + + +ChristopherHornbaker
chrishornbaker@earthlink.net
+ + + +FabriceMous
fabrice@kde.nl
+ + + +RobertNickel
robert@artnickel.com
+ + + +András Mantia
amantia@kde.org
+ + + +EricLaffoon
sequitur@kde.org
+ +Développeur + + +András Mantia
amantia@kde.org
+ +Développeur + + +DmitryPoplavsky
dima@kde.org
+ +Développeur jusqu'à la version 2.0 + + +AlexanderYackovlev
yshurik@kde.org
+ +Développeur jusqu'à la version 2.0 + + +&traducteurEquipeKDE; + + + + +2002200320042005 +équipe de développement de &quantaplus; + + + +&FDLNotice; + + +2005-08-24 +3.4.90 + + +&quantaplus; est &IDE; WEB qui s'efforce d'être neutre et transparent à tous les langages de balises alors qu'il gère les langages de script populaires basés sur le web, &CSS;, ainsi que des autres recommandations émergentes du &W3C;. + + + +KDE +Quanta +texte +éditeur +Web +programmeur +programmation +Développement +Commandeur +xsldbg +libxslt +débogueur +projets +SGML +JSS +DTD +XML +XSD +W3C +CSS +Schéma +Livre de documentation +HTML +XHTML +CGI +PHP +Java +JavaScript +ColdFusion + + +&introduction; +&fundamentals; +&working-with-quanta; + +&quanta-menus; +&config-quanta; +&advanced-quanta; +&extending-quanta; +&q-and-a; +&credits-license; +&installation; +&glossary; + diff --git a/tde-i18n-fr/docs/tdewebdev/quanta/installation.docbook b/tde-i18n-fr/docs/tdewebdev/quanta/installation.docbook new file mode 100644 index 00000000000..1474b8eee98 --- /dev/null +++ b/tde-i18n-fr/docs/tdewebdev/quanta/installation.docbook @@ -0,0 +1,41 @@ + + + +Installation + + +Acquérir &quantaplus; +&install.intro.documentation; + + +Construire le source +&install.compile.documentation; +Considérations lors de la construction + +Il est raisonnable que vous souhaitiez personnaliser l'emplacement des fichiers de &quantaplus; sur votre système. À cette fin, autoconf possède de nombreuses options qui peuvent être passées au script configure pour contrôler cette installation. Pour obtenir une liste complète de ces options, saisissez ./configure. Ces options sont évidentes et ne seront pas couvertes ici. + +Si vous avez des difficultés pour faire fonctionner &quantaplus; correctement, vous devez vérifier votre chemin pour vous assurer que le dossier bin de &kde; 3 est présent. Soyez également sûr qu'il n'y a pas d'anciennes versions de &kde; qui apparaissent dans le PATH avant votre dossier bin de &kde;3. Ceci s'applique pareillement à &Qt;. + + + + diff --git a/tde-i18n-fr/docs/tdewebdev/quanta/introduction.docbook b/tde-i18n-fr/docs/tdewebdev/quanta/introduction.docbook new file mode 100644 index 00000000000..f57b33e69ad --- /dev/null +++ b/tde-i18n-fr/docs/tdewebdev/quanta/introduction.docbook @@ -0,0 +1,137 @@ + + + +Introduction + + Qu'est-ce qu'est &quantaplus; ? Eric Laffoon
sequitur@kde.org
 Christopher Hornbaker
chrishornbaker@earthlink.net
 Reviewer Fabrice Mous
fabrice@kde.nl
 Reviewer &traducteurGoneriLeBouder; Qu'est-ce qu'est &quantaplus; ?
Eric Laffoon de http://quanta.sourceforge.net &quantaplus; est un outil de développement Web pour l'Environnement de Bureau KDE. &quantaplus; a été conçu pour le développement rapide de site et est vite devenu un éditeur mature avec de nombreuses options avancées. Notre objectif est toujours de créer la meilleure application possible pour le développement de site internet. Nous réalisons que nous aurions besoin de l'aide de beaucoup plus de personnes actives pour réaliser cela, donc actuellement nous travaillons pour que les développeurs de sites Internet puissent personnaliser, étendre et améliorer &quantaplus;. Ainsi nous vous demanderons à vous, les développeurs de sites, de contribuer aux amélioration. Nous allons organiser cela afin que les développeurs utilisant l'outil de développement &quantaplus; puissent trouver les ressources, les extensions ainsi que les modules optimisés dont ils ont besoin pour être les développeurs les plus rapide possibles.
+ + + +&quantaplus; : où il était et où il va + +Robert Nickel
robert@artnickel.com
+ + + +Christopher Hornbaker
chrishornbaker@earthlink.net
+ +Relecteur + + +Fabrice Mous
fabrice@kde.nl
+ +Relecteur + + +&traducteurGoneriLeBouder; + + + + +&quantaplus; : où il était et où il va + +Alors qu'ils s'efforçaient d'avoir le meilleur éditeur &HTML; possible, les développeurs de &quantaplus; commencèrent a penser à une idée plus intéressante : « Et si &quantaplus; devenait un éditeur générique et extensible pour la majorité des langages ? ». Ainsi cela ferait de lui le plus grand environment de développement Internet pour &kde; ! C'est ce qui a été fait. + +Désormais non lié au &HTML;, &quantaplus; est maintenant bien parti dans sa voie pour devenir un environment de développement Internet à tout faire. Particulièrement, si vous travaillez en &XML;, &quantaplus; peut vous servir d'environment de développement intégré. + +Maintenant, comme il est dit au-dessus, il doit être noté que le développement de &quantaplus; est basé sur celui réalisé par l'ensemble de la communauté des développeurs &kde;. &quantaplus;, ainsi que le mouvement Libre, se base sur l'idée suivante : « Pourquoi écrire quelque chose déjà fait ? ». Grâce a l'architecture de &kde;, non seulement, c'est possible, mais cela permet aux utilisateurs et développeurs d'étendre &quantaplus; comme ils l'entendent. + +&quantaplus; fournit aux développeurs Internet une interface multidocument (&MDI;) puissante et intuitive. Il peut augmenter votre productivité de façon importante. À travers divers actions habituelles, script ou barres outils, vous pouvez automatiser pratiquement toutes les tâches. Avec l'utilisation de Kommander, vous pouvez étendre &quantaplus; dans plus jamais avoir à retenir la syntaxe des commandes utilisées dans les scripts (vous trouverez plus d'information sur ce sujet ici ). + + + diff --git a/tde-i18n-fr/docs/tdewebdev/quanta/q-and-a.docbook b/tde-i18n-fr/docs/tdewebdev/quanta/q-and-a.docbook new file mode 100644 index 00000000000..b2ef55e4ac8 --- /dev/null +++ b/tde-i18n-fr/docs/tdewebdev/quanta/q-and-a.docbook @@ -0,0 +1,53 @@ + + + + +Questions et Réponses + +Eric Laffoon
sequitur@kde.org
+ + + +&traducteurGoneriLeBouder; + + + + +Questions et Réponses + + + + +Comment puis-je participer au développement de &quantaplus; ? + + +Nous vous rappelons que &quantaplus; est développé par des bénévoles. Beaucoup de personnes pensent qu'elles ne peuvent pas contribuer aux logiciels libres pour une raison ou une autre. La plus courante est probablement le sentiment de ne pas avoir un niveau suffisant. &quantaplus; a été développé de façon à ce que les développeurs et non-développeurs puissent aider à améliorer &quantaplus;.Il y a déjà le problème de la documentation. Les logiciels, qu'ils soient propriétaires ou libres, sont meilleurs s'ils sont bien documentés. Nous sommes sûrs qu'il y a une partie de &quantaplus; pour laquelle le temps que vous y passerez sera le plus bénéfique. + + + + + +Dans quelle direction avance &quantaplus; ? + + +Nous avons publié &quantaplus; 3.2 et sommes actuellement en train de préparer la prochaine version. Notre objectif reste de créer le meilleur environnement de développement pour Internet possible. Nous nous rendons compte que nous allons avoir besoin de bien plus de monde actifs autour de &quantaplus; pour arriver à cela. Nous sommes donc en train de développer des changements afin de rendre plus simple la réalisation d'améliorations et extensions de la part des utilisateurs. Une grosse partie de ce travail a été accomplie dans la version 3.2. Donc nous allons demander à vous, les utilisateurs, de contribuer aux perfectionnements. Nous comptons organiser cela de façon a ce que les utilisateurs de &quantaplus; puissent trouver facilement les ressources, extensions et les modules dont ils ont besoin pour être les développeurs de site Internet les plus performants possible ! + + + + + diff --git a/tde-i18n-fr/docs/tdewebdev/quanta/quanta-menus.docbook b/tde-i18n-fr/docs/tdewebdev/quanta/quanta-menus.docbook new file mode 100644 index 00000000000..595946b7b35 --- /dev/null +++ b/tde-i18n-fr/docs/tdewebdev/quanta/quanta-menus.docbook @@ -0,0 +1,2365 @@ + + + + +La barre de menu + +Robert Nickel
robert@artnickel.com
+ + + +Christopher Hornbaker
chrishornbaker@earthlink.net
+ +Relecteur + + +Fabrice Mous
fabrice@kde.nl
+ +Relecteur + + +&traducteurPatrickMichelon; + + + + +La barre de menu + +Ce chapitre explique toutes les diverses fonctions qui peuvent être trouvées dans la barre de menu. + + +Le menu <guimenu +>Fichier</guimenu +> + + + + + &Ctrl;N Fichier Nouveau + + +Crée un nouveau fichier vide. + + + + + + &Ctrl;O Fichier Ouvrir... + + +Recherche dans le système de fichiers pour ouvrir un fichier existant. + + + + + +Fichier Récemment ouvert(s) + + +Liste les derniers fichiers que vous avez ouverts. Cette liste changera chaque fois que vous ouvrez un fichier qui ne figure pas dessus en éjectant le fichier le plus ancien de la liste en premier. + + + + + + + &Ctrl;S Fichier Enregistrer + + +Enregistre les modifications du fichier actif. + + + + + +Fichier Enregistrer sous... + + +Enregistre le fichier actif sous un autre nom. + + + + + +Fichier Enregistrer en tant que modèle + + +Ceci vous permet d'enregistrer des bouts de code et des fichiers entiers comme modèles pour un usage ultérieur. Voir la section modèles. Si vous essayez d'enregistrer le texte/fichier sauvegardé en dehors du répertoire de modèles local/projet vous recevrez un message d'erreur. + + + + +Fichier Enregistrer en tant que modèle... Enregistrer en tant que modèle local... + + +Vous permet d'enregistrer un fichier comme modèle à l'intérieur de la portée locale. + + + + + +Fichier Enregistrer en tant que modèle... Enregistrer en tant que modèle de projet... + + +Vous permet d'enregistrer un fichier comme modèle à l'intérieur de la portée d'un projet. + + + + + +Fichier Enregistrer en tant que modèle... Enregistrer la sélection dans un fichier de modèle local... + + +Vous permet d'enregistrer le texte sélectionné (&pex; un bout de code) dans un fichier de modèle local. + + + + + +Fichier Enregistrer en tant que modèle... Enregistrer la sélection dans un fichier de modèle de projet... + + +Vous permet d'enregistrer le texte sélectionné (&pex; un bout de code) dans un fichier de modèle de projet. + + + + + + + + + + &Ctrl;&Maj;S Fichier Enregistrer tout... + + +Enregistre tous les fichiers modifiés dans l'éditeur. + + + + + + &Ctrl;F5 Fichier Recharger + + +Recharge le document courant. + + + + + + &Ctrl;P Fichier Imprimer... + + +Vous pouvez imprimer vos documents. Utilise l'interface kprinter. + + + + + + &Ctrl;W Fichier Fermer + + +Ferme le fichier en cours d'affichage. + + + + + +Fichier Tout fermer + + +Ferme tous les fichiers ouverts. Vous propose d'enregistrer si des fichiers ont été modifiés. + + + + + + &Ctrl;Q Fichier Quitter + + +Sort de &quantaplus;. + + + + + + + +Le menu <guimenu +>Édition</guimenu +> + + + + + &Ctrl;Z Édition Annuler + + +Annule la dernière action accomplie. + + + + + + &Ctrl;&Maj;Z Édition Refaire + + +Refait la dernière action annulée. + + + + + + &Ctrl;X Édition Couper + + +Coupe le bloc de texte courant et place son contenu dans le presse-papiers. + + + + + + &Ctrl;C Édition Copier + + +Copie le bloc de texte courant dans le presse-papiers. + + + + + + &Ctrl;V Édition Coller + + +Colle le contenu du presse-papiers à la position courante du curseur. + + + + + +Édition Collage spécial + + + + + + +Édition Collage spécial Coller du HTML cité + + +Convertit les caractères spéciaux du texte &HTML; du presse-papiers en entités &HTML; avant de le coller dans le corps de texte, de telle manière qu'ils apparaissent correctement lorsqu'ils sont visualisés et ne sont pas interprétés comme des balises par le navigateur client. + + + + +Édition Collage spécial Coller une &URL; encodée + + +Convertit le texte du presse-papiers en encodage &URL;, qui est la manière correcte d'inclure des caractères spéciaux et des espaces dans les &URL;. Utilisé principalement lors du collage d'une &URL; dans une balise ancre. + + + + + + + + + &Ctrl;A Édition Tout sélectionner + + +Sélectionne tout le texte dans le document courant. + + + + + + &Ctrl;&Maj;A Édition Désélectionner + + +Désélectionne tout le texte dans le document courant. + + + + + + F4 Édition Mode de sélection par bloc + + +Active/désactive le surlignage de bloc. Vous permet de sélectionner des blocs de texte avec votre clavier sans appuyer sur la touche majuscule. + + + + + + Inser Édition Mode d'écrasement + + +Annule la touche Inser. + + + + + + &Ctrl;F Édition Chercher... + + +Cherche une chaîne de caractères ou expression régulière dans le texte du document courant. + + + + + + F3 Édition Poursuivre la recherche + + +Répète la recherche dans le document vers le bas à partir de l'emplacement actuel. + + + + + + &Maj;F3 Édition Chercher en arrière + + +Répète la recherche vers le haut dans le document à partir de la position actuelle. + + + + + + &Ctrl;R Édition Remplacer... + + +Remplace une chaîne de caractères ou une expression régulière de texte dans le document courant. + + + + + + &Alt;&Ctrl;F Édition Chercher dans les fichiers... + + +Trouve une chaîne de caractères ou une expression dans les fichiers du dossier sélectionné. C'est une sorte de grep ou sed en mode graphique avec certains styles d'espaces prédéfinis pour vous aider. + + + + + + &Ctrl;I Édition Indenter + + +Déplace le bloc de texte sélectionné d'une largeur de tabulation vers la droite. + + + + + + &Ctrl;&Maj;I Édition Désintenter + + +Déplace le bloc de texte sélectionné d'une largeur de tabulation vers la gauche. + + + + + +Édition Supprimer l'indentation + + +Supprime toutes les indentations. + + + + + &Ctrl;# Édition Commenter + + +Met le texte sélectionné en commentaire. + + + + + + &Ctrl;&Maj;# Édition Décommenter + + +Décommente le texte sélectionné. + + + + + + &Ctrl;J Édition Développer les abréviations + + +Développe les abréviations. + + + + + +Édition Effectuer les retours à la ligne dans le document + + +Coupe le texte dans la fenêtre courante à une largeur prédéfinie. + + + + + + &Ctrl;G Édition Aller à la ligne... + + +Va directement à une ligne donnée. Ceci est très utile quand votre script &PHP; bloque sans prévenir. + + + + + +Édition Orthographe... + + +Vérifie l'orthographe dans le document courant. + + + + + + + +Le menu <guimenu +>Affichage</guimenu +> + + + + +Affichage Vues en arborescence + + + + + +Affichage Vues en arborescence Afficher l'arborescence des fichiers + + +Bascule l'affichage de l'arborescence des fichiers. + + + + + +Affichage Vues en arborescence Afficher l'arborescence du projet + + +Bascule l'affichage de l'arborescence du projet. + + + + + +AffichageVues en arborescence Afficher l'arborescence des modèles + + +Bascule l'affichage de l'arborescence des modèles. + + + + + +AffichageVues en arborescence Afficher l'arborescence des scripts + + +Bascule l'affichage de l'arborescence des scripts. + + + + + +AffichageVues en arborescence Afficher l'arborescence de structure + + +Bascule l'affichage de l'arborescence de structure du document. + + + + + +AffichageVues en arborescence Afficher l'arborescence des attributs + + +Bascule l'affichage de l'arborescence des attributs. + + + + + +AffichageVues en arborescence Afficher l'arborescence de documentation + + +Bascule l'affichage de l'arborescence de documentation. + + + + + + + + +Affichage Afficher la barre d'outils + + +Bascule entre activé et désactivé l'affichage de la barre d'outil. + + + + + +Affichage Afficher la barre d'outils DTD + + +Bascule entre activé et désactivé l'affichage de la barre d'outils spécifique à la &DTD;. + + + + + +Affichage Afficher la barre d'état + + +Bascule entre activé et désactivé l'affichage de la barre d'état au bas de la fenêtre principale de &quantaplus;. + + + + + &Ctrl;M Affichage Afficher les messages + + +Bascule l'affichage de la fenêtre de messages. Il s'agit de la fenêtre où vous voyez la sortie de toute action de script et du débogueur. + + + + + +Affichage Afficher le rapporteur de problèmes + + +Bascule l'affichage du Rapporteur de problèmes en bas de la fenêtre principale de &quantaplus;. Le Rapporteur de problèmes est activé lorsque vous basculez vers L'arborescence de structure . + + + + + + &Maj;F9 Affichage Afficher la bordure d'icônes + + +Bascule l'affichage de la bordure d'icônes à la gauche de la fenêtre principale de l'éditeur. Cette barre permet le basculement par clic des signets. + + + + + + F11 Affichage Afficher les numéros de lignes + + +Bascule l'affichage du numéro des lignes sur le côté de la fenêtre principale de l'éditeur. + + + + + + F10 Affichage Retour à la ligne dynamique + + +Bascule entre activé et désactivé le reformatage de texte jusqu'à une largeur donnée au cours de la saisie. + + + + + + &Alt;F9 Affichage Éditeur de source + + +Bascule vers la source d'un document à éditer. + + + + + + &Ctrl;&Maj;F9 Affichage Éditeur &VPL; + + +Bascule vers l'éditeur &VPL; pour éditer le document. + + + + + + F9 Affichage Éditeurs &VPL; et source + + +Bascule vers un mode écran partagé pour éditer un document. + + + + + + F6 Affichage Aperçu + + +Prévisualise le document actif. + + + + + + &Alt;Gauche Affichage Précédent + + +Navigue d'un pas en arrière dans la prévisualisation. + + + + + + &Alt;Droite Affichage Suivant + + +Navigue un pas en avant dans l'aperçu après être retourné en arrière dans l'aperçu. + + + + + + F5 Affichage Rafraîchir l'aperçu + + +Recharge la prévisualisation à partir du disque. + + + + + + &Ctrl;F6 Affichage Afficher dans &konqueror; + + +Visualise le fichier actif avec &konqueror;. + + + + + + &Alt;F6 Affichage Visualiser avec Mozilla + + +Visualise le fichier actif avec Mozilla. + + + + + + &Alt;&Ctrl;F6 Affichage Visualiser avec &Netscape; + + +Visualise le fichier actif avec &Netscape; + + + + + + &Ctrl;&Maj;F6 Affichage Visualiser avec Opéra + + +Visualise le fichier actif avec Opéra. + + + + + + &Maj;F6 Affichage Afficher dans Lynx + + +Visualise le fichier actif avec Lynx (un navigateur en mode texte). + + + + + + +Le menu <guimenu +>Signets</guimenu +> + + + + + &Ctrl;B Signets Définir un signets + + +Définit un signet à l'emplacement de la ligne active dans le fichier actif. + + + + + +Signets Effacer tous les signets + + +Supprime tous les signets enregistrés. + + + + + + +Le menu <guimenu +>Projet</guimenu +> + +La manière d'utiliser les projets dans &quantaplus; est décrit dans . + + + + +Projet Nouveau projet... + + +Lance l'assistant de création de projet. + + + + + +Projet Ouvrir un projet... + + +Ouvre un fichier de projet existant à partir du disque. Les projets de &quantaplus; sont enregistrés avec l'extension .webprj. + + + + + +Projet Récemment ouvert(s) + + +Vous donne une liste des projets les plus récemment ouverts pour un accès rapide. + + + + + +Projet Fermer le projet + + +Ferme le projet actif. + + + + + +Projet Ouvrir une vue du projet... + + +Ouvre une « Vue », une combinaison spécifique de fichiers ouverts que vous avez au préalable enregistrés. + + + + + +Projet Enregistrer la vue du projet + + +Enregistre le groupe de fichiers ouverts comme « Vue ». + + + + + +Projet Enregistrer la vue de projet sous... + + +Enregistre le groupe de fichiers ouverts actif comme « Vue » sous un autre nom. + + + + + +Projet Effacer la vue de projet... + + +Supprime une « Vue ». + + + + + +Projet Insérer des fichiers... + + +Vous affiche une boîte de dialogue qui vous permet de sélectionner des fichiers à ajouter à votre projet courant (actif). Ces fichiers sont ensuite copiés dans le dossier du projet pour l'édition. + + + + + +Projet Insérer un dossier... + + +Insère un dossier et tout son contenu dans le projet actif. + + + + + +Projet Vérifier le dossier du projet... + + +Examine le dossier projet pour tout nouveau fichier qui peut s'y trouver. Ceci vous permet de copier des graphiques dans votre dossier projet ou un sous-dossier puis de les ajouter au projet. + + + + + + F8 Projet Envoyer le projet... + + +Publie les fichiers de votre projet vers le serveur hôte. La liste des transports disponibles dépend de la version de &kde; que vous utilisez et si vous avez téléchargé ou non des modules KIO supplémentaires. + + + + + + F7 Projet Propriétés du projet + + +Réglages qui affectent la manière dont &quantaplus; gère votre projet. Se reporter à la section &quantaplus; projets pour plus de détails. + + + + + + +Le menu <guimenu +>Barres d'outils</guimenu +> + + + + +Barres d'outils Charger les barres d'outils + + + + + + +Barres d'outils Charger les barres d'outils Charger une barre d'outils globale... + + +Charge une barre d'outils définie globalement. Celles-ci sont gardées par défaut dans $KDEDIR/share/apps/quanta/toolbars. + + + + + +Barres d'outils Charger les barres d'outils Charger une barre d'outils locale... + + +Charge une barre d'outils définie localement. Celles-ci sont gardées par défaut dans $HOME/.kde/share/apps/quanta/toolbars. + + + + + +Barres d'outils Charger les barres d'outils Charger une barre d'outils du projet + + +Charge une barre d'outils de projet. Celles-ci sont gardées dans ProjectDir/toolbars et ne sont disponibles dans ce menu que si elles ont été assignées à ce projet. + + + + + + + + +Barres d'outils Enregistrer les barres d'outils + + +Boîte de dialogue pour enregistrer vos barres d'outils. Vous permet de choisir le type de barre d'outils Local ou Projet. + + + + +Barres d'outils Enregistrer les barres d'outils Enregistrer en tant que barre d'outils locale... + + +Enregistre comme barre d'outils locale vers le dossier $HOME/.kde/share/apps/quanta/toolbars. + + + + + +Barres d'outils Enregistrer les barres d'outils Enregistrer en tant que barre d'outils du projet... + + +Enregistre comme barre d'outil de projet dans ProjectDir/toolbars + + + + + + + + +Barres d'outils Ajouter une barre d'outils d'utilisateur + + +Fait apparaître une boîte de dialogue pour créer une nouvelle barre d'outils. Ceci crée seulement le nom. Les actions doivent être ajoutées à partir de Configuration Configurer les actions . Les barres d'outils sont enregistrées grâce au menu Barres d'outils Enregistrer les barres d'outils , ou à la fermeture des barres d'outils non enregistrées, une boîte de dialogue vous avertira de les enregistrer. + + + + + +Barres d'outils Enlever la barre d'outils d'utilisateur... + + +Supprime une barre d'outils de l'utilisation. Ceci ne l'enlève pas du disque. Si vous n'avez pas enregistré la barre d'outils que vous enlevez, une boîte de dialogue vous demande de le faire. + + + + + +Barres d'outils Renommer la barre d'outils utilisateur... + + +Vous permet de renommer une barre d'outils. + + + + + +Barres d'outils Envoyer la barre d'outils par message électronique + + +C'est un moyen d'envoyer par courrier électronique vos barres d'outils personnalisées à quelqu'un (peut être l'équipe de &quantaplus; pour l'inclusion dans la prochaine version !) pour leur utilisation. Cela engendre une fenêtre de courrier et y joint automatiquement votre fichier de barre d'outils. + + + + + + + +Le menu <guimenu +>Balises</guimenu +> + +Ce menu contient une liste d'éléments qui sont dans les barres actives. Si vous avez la barre standard (&HTML;) active, le menu Balises contient un sous-menu Standard qui contient la liste des balises/actions sur cette barre d'outils. + + + + + &Ctrl;E Balises Modifier la balise courante... + + +Vous permet d'accéder à la boîte de dialogue de réglages de la balise s'il en existe une. Cette entrée est toujours présente, suivie par les sous-menus spécifiques à la &DTD;. + + + + + + + +Le menu <guimenu +>&DTD;</guimenu +> + +Christopher Hornbaker
chrishornbaker@earthlink.net
+ + + + + +Le menu <guimenu +>&DTD;</guimenu +> + + + + +&DTD; Changer la &DTD;... + + +Fait apparaître une boîte de dialogue qui vous permet de changer la &DTD; des documents courants. + + + + + +&DTD; Charger et convertir une &DTD;... + + +Charge une &DTD; que vous ou quelqu'un d'autre a écrit et la convertit dans le format de description natif de &quantaplus;. + + + + + +&DTD; Charger un paquetage de &DTD; (&DTEP;)... + + +Charge votre propre &DTEP;. + + + + + +&DTD; Envoyer un paquetage de &DTD; (&DTEP;) par message électronique... + + +Envoie votre &DTEP; à un ami via &kmail;. + + + + + + +Le menu <guimenu +>Modules</guimenu +> + + + + +Modules Édition + + +Fait apparaître une boîte de dialogue qui vous permet de charger des modules (KParts) dans &quantaplus;. + + + + + +Modules Valider + + +Valide que &quantaplus; est en mesure de charger les modules que l'utilisateur a entrés. + + + + + +Modules Module + + +Le menu Modules liste les modules disponibles sous les entrées des menus. Cliquer dessus les active. Cliquer sur un module activé le désactive. + + + + + + +Le menu <guimenu +>Outils</guimenu +> + + + + +Outils Propriétés du document + + +Édite les propriétés spécifiques d'un document actif lors de l'utilisation de l'éditeur &VPL;. + + + + + +Outils Convertir la casse de la balise et de ses attributs... + + +Convertit la casse de tous les caractères des balises et/ou attributs. + + + + + + &Alt;0 Outils Liste des fichiers ouverts... + + +Ouvre une boîte de dialogue qui met en surbrillance tous les fichiers ouverts. + + + + + + &Alt;&Ctrl;T Outils Vérification de la syntaxe HTML avec Tidy + + +Vérifie la syntaxe du document actif par rapport à la &DTD;. + + + + + + +Le menu <guimenu +>Configuration</guimenu +> + + + + +Configuration Configurer Quanta... + + +Configure le comportement de &quantaplus;. + + + + + +Configuration Configurer l'éditeur... + + +Configure le comportement de la fenêtre de l'éditeur. Se reporter à la documentation sur &kate; pour plus de détails. + + + + + +Configuration Configurer les actions... + + +Ceci est l'endroit où vous configurez les actions pour l'utilisation avec les barres d'outils. + + + + + +Configuration Configurer les barres d'outils... + + +Boîte de dialogue qui vous permet d'ajouter/de supprimer des entrées vers/à partir des barres d'outils et de changer l'ordre dans lequel apparaissent les icônes. + + + + + +Configuration Configurer les raccourcis clavier... + + +Vous permet de configurer les nombreux raccourcis de l'éditeur disponibles dans &quantaplus;. + + + + + +Configuration Mode de coloration syntaxique + + +Choisit le mode de surbrillance pour le fichier actif. La liste des variantes de mise en surbrillance change en fonction de votre version de &kate;. + + + + + +Configuration Fin de ligne + + +Sélectionne l'encodage de fin de ligne. Utile si vous avez des amis qui développent sous d'autres plates-formes. Choisissez parmi Unix, Windows/DOS ou Macintosh. + + + + + + + +Le menu <guimenu +>Aide</guimenu +> + +&quantaplus; contient un menu d'Aide standard de &kde; avec en plus ces articles : + + + + + &Ctrl;H Aide Aide contextuelle... + + +Ceci doit produire une aide fondée sur le contexte courant du pointeur. À l'heure de cette rédaction, cette fonction n'est pas encore implémentée. + + + + + +Aide Faire un don + + +&quantaplus; est un produit de haute qualité qui est librement disponible et est sous licence libre, mais comme tout projet à source ouverte, ses développeurs peuvent toujours utiliser de l'aide. Si vous souhaitez soutenir le développement de &quantaplus; d'une manière financière, vous pouvez trouver comment ici. + + + + + +Les éléments du menu d'aide standard de &kde; sont comme suit : +&help.menu.documentation; + diff --git a/tde-i18n-fr/docs/tdewebdev/quanta/quanta-projects.docbook b/tde-i18n-fr/docs/tdewebdev/quanta/quanta-projects.docbook new file mode 100644 index 00000000000..04622854997 --- /dev/null +++ b/tde-i18n-fr/docs/tdewebdev/quanta/quanta-projects.docbook @@ -0,0 +1,624 @@ + + + + +Projects + + +Robert +Nickel + +
robert@artnickel.com
+ + + + +Christopher +Hornbaker + +
chrishornbaker@earthlink.net
+ +Reviewer + + + +Fabrice +Mous + +
fabrice@kde.nl
+ +Reviewer + + + + + + + +Projects + + +New Projects + + +The &quantaplus; project wizard +( +Project +New Project +) makes project creation an easy task. + + + + + + +The Project Wizard. + + + +The fields are pretty straight forward. It is best to fill them in from +top to bottom. Filling in a project name will autocomplete all the +folder structure for the rest of the project. All of the paths and +author information fields can be configured later on clicking + + +F7 + +Project +Project Options +. + + + +General Project Settings + +Name + + +Here you fill in the name for your project. For example, we will call ours +foo. When you fill in +Name, File is filled out for +you automatically. + + + + + +File + + +This is the name of the &quantaplus; project file. By default, it is the +name of your project, but in lowercase letters and without spaces. It +uses the extension webprj (&pex; +foo.webprj). This file is stored in the root of the +project's Main Folder. + + + + + + + +Server Settings + + + +Protocol + + +Here you select the protocol you will be using to access you project. If +your project is on the same machine that you are using Quanta Plus on, +then leave the value at Local. The list of protocols shown here is +dependant of your system setup. Available protocols include SSH, FTP, NFS, +SMB, WebDAV, and many others. The protocol list is powered by &kde;'s +powerful KIOSlave architecture. This framework allows every &kde; +application to easily access remote information as if it is local to the +machine. + + + + +Host + + +Here you fill in the server address of the machine you want to access, +unless you are working through the Local protocol. Either a hostname +(hostname.example.com) or an IP address (127.0.0.1) can go here. + + + + +User + + +User name for logging onto the remote machine. This is case-sensitive. + + + + +Password + + +Password for logging onto the remote machine. This is case-sensitive + + + + +Port + + +Leave this field blank to use the default port for the protocol you are +using. You may need to change this depending on your server's +configuration. + + + + + + + + + + + +Folder Settings + + + +Main Folder + + +This is the root folder where all of the project files and folders +will be stored. + + + + +Templates Folder + + +This is where the templates for this project will be stored. By default, +its path is: Main +Folder/templates; for example /home/johndoe/projects/example_project/templates. + If you have a common set of files that you use for several +projects, then it may be useful to point this field to it, instead of to +the default. + + + + +Toolbars Folder + + +This is where the toolbars for this project will be stored. By default, +it is Project destination +/toolbars. If you have a common set of toolbars +that you use for several projects, it may be useful to point this there +instead of the default. + + + + + + + + + + + +Project Sources + + + +Add local or remote files + + +This allows you to get files from the local file system. You can choose +multiple files or entire folders. + + + + +Use wget to download files from site + + +This option is great if you have static web content that you wish to +download and modify. For server side scripting (&pex; &PHP;, Python, +&etc;.) you will have to get the files another way. + + + + + + + + + +Insert Files in Project + +Insert file from + + +Check this if you wish to include files found in the path of the Main +Folder. Leave unchecked when starting a project from scratch. + + + + +Filters + + + +Insert only markup, script, and image files + + +Choosing this option will only insert markup, script, and image files into +your project. + + + + +Insert files with the following mask + + +Choosing this option will display all files and folders within the +Main Folder and allow you to be more specific with your choices. + + + + + + + +Included files + + +This displays a list of the files in the Main Folder. You can choose +the desired files for inclusion, by checking, or exclusion, by unchecking, +in your project. + + + + + + +More Project Settings + +Author + + +Insert your name (or alias) here. + + + + +Email + + +The address where you would like email regarding this project to go. + + + + +Project Defaults + + + +Default DTD + + +Choose the markup language you will be working with the most within this +project. + + + + +Default encoding + + +Choose the character encoding you wish the files in your project to be +opened and saved with. + + + + + + + +Use preview prefix + + +Check this to use a prefix for your previews. This allows you to set the +path prefix to something other than your local file system. This is most +useful for pages that contain dynamic content and are dependent on server +processing (like &PHP;, JSS, Python, &etc;). Simply +type in the first portion of the address as it exists on that server and +the filepath at the end will be complete by &quantaplus;. For example, if +you have the domain bar.com and you are editing the +index.html page, you could edit it on your remote +machine (foo.bar.com), upload it to the server +and press F6 to see the results from +www.bar.com instead of your local file system. + + + +Prefix + + +Enter the prefix you wish to use here. + + + + + + + +Insert global templates + + +This makes a copy of the global templates in your projects folder tree. + + + + +Insert local templates + + +This makes a copy of the local templates in your projects folder tree. + + + + + + +The last screen of the new project wizard has 3 settings that can make +your life easier. These settings are available for change from the + +Project +Project Options + + menu tree on the Network Tab or with the keyboard shortcut +F7. + + + + + +Using Projects + + +Project Files + + +By default &quantaplus; will open the last project accessed when launched. +This behavior is not currently configurable. + + + +To open another project, select Open from the +Project menu or the Open Project +icon on the toolbar. The open project dialog will pop up and allow you to +choose the project you wish. Projects have a webprj extension. + + + +When closing &quantaplus;, your project file will be saved automatically. +You will be asked to save any changes before exiting if &quantaplus; +detects any changed files. This same behavior occurs if you load a new +project. + + + + + +The Project Tree View + + +The project tree view gives you uncluttered access to the files in your +project. This is where you manage the files in the current project. + + +For files, a &BDS; click brings up the following menu: + + + + + + + + +These items are fairly self-explanatory and will be left to the reader +for exploration. + + + +Folders are similar but do not contain the Open With + and Open in &quantaplus; &BDS; +menu items: + + + + + + + + + +These items are left to the reader for exploration as well. + + + + + +Uploading Projects + + +The Upload Projects dialog: + + + + + + +The Upload Projects dialog. + + + + +Host + + +This is the hostname of the server your copying the files to. Either fully +qualified domain name, or an IP address will work. + + + + + +Protocol + + +Transfer protocol to use for this upload. Depending on your version of +&kde; this list will vary. At the very least you should be able to choose +from &FTP;, file (&cad; local) and NFS. + + + + + +Port + + +Port for the transfer. Usually this will not need to be changed unless your +network administrator is hosting a service on a port other than its well +known port. + + + + + +User + + +User name to use for authentication. + + + + + +Password + + +Password to use for authentication. + + + + + +Keep Password + + +Depending on your level of paranoia, this is a time saving feature, or a +danger. Use it at your discretion. The password is kept on disk in plain text. + + + + + +Path + + +This is the base path on the remote host that you will be copying files +to. + + + + + +Upload + + +Start the upload + + + + + +Cancel + + +This will abort your transfer in progress or just exit out of the dialog +if you change your mind before starting the upload. + + + + + +All + + +Select all files in your project for upload. + + + + + +Modified + + +Select all modified files for upload. + + + + + +None + + +Unselects all files in the list. + + + + + +Invert + + +Selects/Unselects all files in the list. + + + + + +Expand All + + +Expands all folders. + + + + + +Collaspe All + + +Collaspes all folders. + + + + + +Update All + + +Refreshes list. + + + + + + + + diff --git a/tde-i18n-fr/docs/tdewebdev/quanta/working-with-quanta.docbook b/tde-i18n-fr/docs/tdewebdev/quanta/working-with-quanta.docbook new file mode 100644 index 00000000000..c1393fb1a75 --- /dev/null +++ b/tde-i18n-fr/docs/tdewebdev/quanta/working-with-quanta.docbook @@ -0,0 +1,565 @@ + + + + +Working With... + + +Robert +Nickel + +
robert@artnickel.com
+ + + + +Christopher +Hornbaker + +
chrishornbaker@earthlink.net
+ +Reviewer + + + +Fabrice +Mous + +
fabrice@kde.nl
+ +Reviewer + + + + + + + +Working With... + + +This chapter describes the parts of &quantaplus; that you will be +interacting with mostly. These not only make your more productive, but +they also allow you to customize &quantaplus; to your work-flow. + + + +Toolbars + + +As previously mentioned, toolbars in &quantaplus; are primarily managed +through the Toolbars menu. Usability and creation are +somewhat different. The creation of toolbars is discussed in a later +section entitled Creating +Toolbars. + + + +Using toolbars is quite simple. When you click on an icon for a desired +element or action, one of three possibilities occur: the element is +inserted (optionally with a closing element); or an element dialog is +activated, allowing you to fill in the attributes in a dialog box; or, +lastly, an action is activated and does something nifty for your current +file or project. If you find yourself doing tedious and redundant typing +for a particular element, that is not in &quantaplus;, then you can add it. +See for more information. + + + +A tag dialog looks just like the following: + + + + + +An example of a tag dialog. + + + + +The above image is the dialog for the anchor tag. If you know &XHTML;, +then you should have noticed that all the attributes that you can use, in +an anchor element, are available. Notice the tabs above for +Main, Core and i18n, +Events, and Focus, they hold +all of the other attributes, according to their purpose, available to the +anchor element. All you need do is: fill in the blanks for the attributes +you want in your anchor, omit the attributes you do not want, and click OK. +You now have a well formed anchor set down at the current cursor position. + + + +&quanta-projects; + + +Templates + + +Templates are basically skeleton documents, code snippets and files to +link to. &quantaplus; uses templates fundamentally as a standard file +system with enhanced organization and interfacing. You can copy, move or +link any repository currently on your system into the templates tree. +Think of &quantaplus; templates as having roughly the limitations to your +imagination that your file system has. + + + +Templates exist in nested folders. There is no limit to how deep you +can nest them however within any given folder &quantaplus; expects a +consistent action for the base template type described below. Additionally +templates allow for pre and post text to be concatenated to non document +type templates. This facilitates tag creation. The next update after the +introduction is scheduled to add the ability to pass variables to the text +such as image size information to assist in tag creation. + + + +Our goal with templates is to extend them to include multi file +concept templates useful for things like placing an order or +creating an about section, Ideally this will be a tool for making your +work more productive and dynamic. An eventual goal is to have a structural +template design mode to deal with site layout and structure which you +could use to design and interactively update your sites. If you would like +to be involved, check out our +help +wanted page. + + + + +Some of the templates that ship with &quantaplus; have conditions for +their usage. Please read carefully the usage statement of conditions at +the top of each template before you use it. + + + + +Template Types + + +Currently templates are limited to being one of the following types of +objects: + + + +Document +Text to insert in a document +A file to link to form a document + + + +Documents can be any type of document. Generally you would want to nest +more specific or diverse documents in subfolders. Here you can make a +basic framework for what you do and deliver it to your work in an +organized fashion and realize much better efficiency. Text insertion could +be anything from a snippet of code to a script or whatever you might wish +to use. This overlaps the ability to insert text blocks as an action which +can be triggered from the toolbar. Linked files can be binary, &PHP; class +libraries or whatever you like. + + + + + +Template Scopes + + +Templates are accessible based upon their established +workspace in &quantaplus; + + + + + +Creating Templates + + +Create a document structure that you love (&XML;, &HTML;, DocBook, &etc;.) +and click on + +File +Save as Template +Save as Local/Project Template +. + + + +Once this is done, you will notice that (even if it is saved as a Project +template) the template does not show in the project +tab view. Look into the templates view to find your template under the +Project templates tab. + + + +Additionally if you look at your options with the &BDS; you will see +complete file management tools for creating folders or copying and +pasting templates from one location to another. + + + + + +Using Templates With Projects + + +Project templates allow you to be more tightly focused. You can create +headers, footers or go dynamic with &PHP; include files and link them. +Additionally there are some very cool things we took into consideration +when using templates in projects. + + + +When creating a project you can opt to copy to your local project all the +existing global and user templates. Legacy project get default templating +abilities so nothing is lost You can choose where to locate your template +files so they can be in your server root and easy to upload or you can +make them secure to link to below server root which is a very cool trick. +When linking to a file not in the project templates you will be prompted +to copy the file to the project templates prior to linking. This will prevent +broken links on upload. You always have control where you place your +templates so you can choose to move them. However &quantaplus; does not +track this so you will need to change links. + + + + + +Managing Template Behavior + + +Template structure on the template tab is based on the files found in + +$KDEDIR/share/apps/quanta/templates and + +$HOME/.kde/share/apps/quanta/templates. Each of +these folders is specified as one of three types of container: + + + + +files/all + + +Binaries and such things that get inserted by their &URL; (&cad; images as +an img src=/src/url). + + + + +text/all + + +Text that you can insert into the current &quantaplus; document, such as +repetitive blocks. + + + + +template/all + + +Document templates which you can create new documents from. These open a +new window in &quantaplus;. + + + + + + +To set the behavior of each folder, &BDS; click in the template view on +the folder and choose Properties. The +following dialog will come up: + + + + + +Properties dialog. + + + + + +Type + + + +Drop down box with the three types discussed previously; files, text, +template. This box will be grayed out if you have the inherit +parent attribute box checked. + + + + + +Inherit parent attribute (foo) + + +This is checked by default and is fine for all but the top level +folders in your templates tree. If the top level folder has this +checked, it will basically deactivate templates for that folder and all +that aren't explicitly set below it. If this is not a top level folder, +then the blah will say something like +text/all. If it says nothing, then chances are that +you are on a top level folder. + + + + +Use pre/post text + + +Enables pre and post text for templates in this folder. This could be a +common header/footer for all of your templates for a given project and +then you copy content templates into that folder and have a complete +page with the custom header/footer as a starting point. + + + + +Pre-text + + +The actual text to insert before your templates content. + + + + +Post-text + + +The actual text to insert after your templates content. + + + + + + + + + + +<application>Visual Page Layout</application> + + +Nicolas +Deschildre + +
nicolasdchd@ifrance.com
+ + + + +Christopher +Hornbaker + +
chrishornbaker@earthlink.net
+ +Reviewer + + + + + + + +<application>Visual Page Layout</application> + + +&VPL; Modes + + +The Visual Page Layout (&VPL;) editor (also known +as WYSIWYG (What You See Is What You Get)) allows you +to edit a &HTML; or &XHTML; document while seeing the changes on-the-fly. +Just like your favorite wordprocessor, you can click on your document and +a cursor will appear, thus enabling you to enter text, insert images, +apply text decorations, &etc;. &VPL;'s aim is to allow you to create great, +valid web pages without any knowledge of Internet markup languages. + + + +&quantaplus; offers two modes: &VPL; Editor and +&VPL; & Source Editor, which are accesible from +the View menu. The first replaces the Source +Editor with the &VPL; Editor, and the +second splits the editor window into two parts: the Source +Editor and the &VPL; Editor. + + + +The &VPL; Editor works like so: It loads a document +like a normal &HTML; or &XHTML; page and a cursor appears. Then you can +edit it, and switching back to Source Editor, you see +that the changes you made on the &VPL; Editor have +been merged in the Source Editor. + + + + +When working in the &VPL; Editor with a document that +contains &PHP;, you will see a small green icon representing the &PHP; +code. You cannot directly edit it with the &VPL; +Editor. To edit &PHP;, you will still need to use the +Source Editor. There are no plans to change this +functionility. + + + + +The second mode behaves exactly like the first, except that you instantely +see the impact that your changes have made, either in the Source +Editor or in the &VPL; Editor, and the +cursors of the source editor and of the &VPL; Editor +are synchronized. Pressing F9 loads this mode, but, if +it is already loaded, it will move the focus from one view to the other, +while keeping you at the same location of the document. + + + +The refresh intervals between the &VPL; Editor and +the Source Editor are configurable. Go to + +Settings +Configure Quanta... +. Select the &VPL; View tab. You can +choose whether you want to refresh a view only when you click on it or +automatically. If you choose automatically, then you can choose a refresh +interval. The general recommendation is: A smaller number for fast +computers and a bigger number for slower ones. + + + + + + +The &VPL; & Source Editor mode. + + + + +&VPL; Editing + + +The <guilabel>Document Properties</guilabel> Dialog + + +Now, let's say you want to edit the title of your web page. How do you do +it? Simply launch + +Tools +Document Properties +. This tool allows the edition of invisible +tags when using the &VPL; Editor. The +Document Properties dialog is also launched when you +create a new document while in the &VPL; Editor. This +is in order to lessen the amount of hand coding you need to perform. With +it, you can edit: + + + + +Title + + +The title of the document. + + + + +Meta items + + +Meta tags allow you to store informations about the document itself +&pex; keywords for the Internet search engines. You can add or remove +Meta items by pressing the two buttons below, +and edit them by clicking on the list &pex; put keywords on +the name column and keyword1 keyword2 on the +content column. + + + + +CSS Rules + + +CSS Rules are the new way to tell your web browser +how to present the page. You can add or delete the CSS +Rules by pressing the buttons below. You can also fill the +fields like the Meta items. The edition of +CSS Rules is not yet supported. + + + + +Link CSS Stylesheet + + +You can also link an external CSS stylesheet. Simply click on the +Browse button and select your file. + + + + + + + + +The <guilabel>&VPL; Editor</guilabel> + + +You can use your cursor like you do in a wordprocessor, moving with the +arrows. It may come that the cursor does not want to go where you want it +to go (a pesky bug). Selection also works as usual. You can insert text by +typing and remove text by pressing the &Correction; or delete key. + + + +Now we come to tag insertion. You can insert images, applets, text +decorations such as bold and so on by using the same toolbars you use in +the source editor. Note that the insertion of tags does not remove previous +identical tags &pex; if you insert an anchor tag around some text, then you +must remove any other anchor tag around it. + + + + +Some toolbar items will be disabled, such as the Table +Wizard or Quick List Wizard. They will +work later in &VPL;, but, for this release, you should use the +Tables or Lists toolbars. + + + + +To edit a tag (be it an image, an applet, or whatever), switch to the +Attribute Tree, accessible via + +View +Tree views +. Click on the tag you wish to edit, or, if you cannot access +it, click on an object contained by it. The Attribute +Tree will show the current tag name as well as a list of all its +parents and attributes. Currently &VPL; does not support, say, +&XHTML;+MathML, but you will see that you can edit +namespaces via this view. You can simply click on the +Value field and modify whatever you want. If you want +to access a parent of the current tag, then select it and the +Attribute Tree will load it. + + + +To delete a tag, we will use the Attribute Tree. Have +you noticed the two little red crosses at the top-right corner? The first one +deletes only the currently selected tag and, if the &HTML;/&XHTML; +specification does not allow some childs of the deleted tag to be child of +the parent tag of the tag set to be deleted, then they are also deleted, +and so on. The second cross will delete the selected tag as well as all of +its children, so be careful! + + + + + + -- cgit v1.2.1