From a617cf1142bdf4be948a50de10395e09917e660d Mon Sep 17 00:00:00 2001 From: Slávek Banko Date: Fri, 17 Oct 2025 09:37:29 +0200 Subject: Add translated handbooks from tde-i18n. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Slávek Banko --- doc/da/kxsldbg/callstack.docbook | 28 + doc/da/kxsldbg/credits.docbook | 29 + doc/da/kxsldbg/entities.docbook | 28 + doc/da/kxsldbg/glossary.docbook | 35 ++ doc/da/kxsldbg/index.docbook | 112 ++++ doc/da/kxsldbg/kxsldbg_configure.docbook | 67 +++ doc/da/kxsldbg/kxsldbg_inspector.docbook | 71 +++ doc/da/kxsldbg/kxsldbg_mainwindow.docbook | 443 ++++++++++++++++ doc/da/kxsldbg/kxsldbg_tools.docbook | 77 +++ doc/da/kxsldbg/sources.docbook | 27 + doc/da/kxsldbg/templates.docbook | 20 + doc/da/kxsldbg/variables.docbook | 44 ++ doc/da/xsldbg/commands.docbook | 758 +++++++++++++++++++++++++++ doc/da/xsldbg/credits.docbook | 14 + doc/da/xsldbg/index.docbook | 96 ++++ doc/da/xsldbg/introduction.docbook | 16 + doc/da/xsldbg/usage.docbook | 62 +++ doc/de/kxsldbg/breakpoints_window.png | Bin 0 -> 32759 bytes doc/de/kxsldbg/callstack.docbook | 28 + doc/de/kxsldbg/callstack_window.png | Bin 0 -> 25759 bytes doc/de/kxsldbg/configure_window.png | Bin 0 -> 30264 bytes doc/de/kxsldbg/credits.docbook | 29 + doc/de/kxsldbg/entities.docbook | 28 + doc/de/kxsldbg/entities_window.png | Bin 0 -> 14401 bytes doc/de/kxsldbg/globals_window.png | Bin 0 -> 21720 bytes doc/de/kxsldbg/glossary.docbook | 35 ++ doc/de/kxsldbg/index.docbook | 112 ++++ doc/de/kxsldbg/kxsldbg_configure.docbook | 67 +++ doc/de/kxsldbg/kxsldbg_inspector.docbook | 71 +++ doc/de/kxsldbg/kxsldbg_mainwindow.docbook | 443 ++++++++++++++++ doc/de/kxsldbg/kxsldbg_tools.docbook | 77 +++ doc/de/kxsldbg/main_window.png | Bin 0 -> 64660 bytes doc/de/kxsldbg/publicid_window.png | Bin 0 -> 11765 bytes doc/de/kxsldbg/sources.docbook | 27 + doc/de/kxsldbg/sources_window.png | Bin 0 -> 26361 bytes doc/de/kxsldbg/systemid_window.png | Bin 0 -> 11864 bytes doc/de/kxsldbg/templates.docbook | 20 + doc/de/kxsldbg/templates_window.png | Bin 0 -> 24971 bytes doc/de/kxsldbg/variables.docbook | 44 ++ doc/de/kxsldbg/walk_window.png | Bin 0 -> 9667 bytes doc/es/kxsldbg/1downarrow.png | Bin 0 -> 568 bytes doc/es/kxsldbg/breakpoints_window.png | Bin 0 -> 67114 bytes doc/es/kxsldbg/callstack.docbook | 28 + doc/es/kxsldbg/callstack_window.png | Bin 0 -> 44464 bytes doc/es/kxsldbg/configure.png | Bin 0 -> 340 bytes doc/es/kxsldbg/configure_window.png | Bin 0 -> 11488 bytes doc/es/kxsldbg/credits.docbook | 29 + doc/es/kxsldbg/entities.docbook | 28 + doc/es/kxsldbg/entities_window.png | Bin 0 -> 60411 bytes doc/es/kxsldbg/exit.png | Bin 0 -> 679 bytes doc/es/kxsldbg/glossary.docbook | 35 ++ doc/es/kxsldbg/index.docbook | 112 ++++ doc/es/kxsldbg/kxsldbg_configure.docbook | 67 +++ doc/es/kxsldbg/kxsldbg_inspector.docbook | 71 +++ doc/es/kxsldbg/kxsldbg_mainwindow.docbook | 443 ++++++++++++++++ doc/es/kxsldbg/kxsldbg_tools.docbook | 77 +++ doc/es/kxsldbg/main_window.png | Bin 0 -> 42506 bytes doc/es/kxsldbg/next.png | Bin 0 -> 169 bytes doc/es/kxsldbg/publicid_window.png | Bin 0 -> 16698 bytes doc/es/kxsldbg/run.png | Bin 0 -> 544 bytes doc/es/kxsldbg/sources.docbook | 27 + doc/es/kxsldbg/sources_window.png | Bin 0 -> 39836 bytes doc/es/kxsldbg/step.png | Bin 0 -> 349 bytes doc/es/kxsldbg/systemid_window.png | Bin 0 -> 17186 bytes doc/es/kxsldbg/templates.docbook | 20 + doc/es/kxsldbg/templates_window.png | Bin 0 -> 40682 bytes doc/es/kxsldbg/variables.docbook | 44 ++ doc/es/kxsldbg/variables_window.png | Bin 0 -> 36307 bytes doc/es/kxsldbg/walk_window.png | Bin 0 -> 42523 bytes doc/es/kxsldbg/xsldbg_break.png | Bin 0 -> 186 bytes doc/es/kxsldbg/xsldbg_data.png | Bin 0 -> 161 bytes doc/es/kxsldbg/xsldbg_delete.png | Bin 0 -> 166 bytes doc/es/kxsldbg/xsldbg_enable.png | Bin 0 -> 199 bytes doc/es/kxsldbg/xsldbg_output.png | Bin 0 -> 106 bytes doc/es/kxsldbg/xsldbg_refresh.png | Bin 0 -> 157 bytes doc/es/kxsldbg/xsldbg_source.png | Bin 0 -> 144 bytes doc/es/kxsldbg/xsldbg_stepdown.png | Bin 0 -> 94 bytes doc/es/kxsldbg/xsldbg_stepup.png | Bin 0 -> 144 bytes doc/es/xsldbg/commands.docbook | 758 +++++++++++++++++++++++++++ doc/es/xsldbg/credits.docbook | 14 + doc/es/xsldbg/index.docbook | 96 ++++ doc/es/xsldbg/introduction.docbook | 16 + doc/es/xsldbg/usage.docbook | 62 +++ doc/et/kxsldbg/callstack.docbook | 28 + doc/et/kxsldbg/credits.docbook | 29 + doc/et/kxsldbg/entities.docbook | 28 + doc/et/kxsldbg/glossary.docbook | 35 ++ doc/et/kxsldbg/index.docbook | 112 ++++ doc/et/kxsldbg/kxsldbg_configure.docbook | 67 +++ doc/et/kxsldbg/kxsldbg_inspector.docbook | 71 +++ doc/et/kxsldbg/kxsldbg_mainwindow.docbook | 443 ++++++++++++++++ doc/et/kxsldbg/kxsldbg_tools.docbook | 77 +++ doc/et/kxsldbg/sources.docbook | 27 + doc/et/kxsldbg/templates.docbook | 20 + doc/et/kxsldbg/variables.docbook | 44 ++ doc/et/xsldbg/commands.docbook | 758 +++++++++++++++++++++++++++ doc/et/xsldbg/credits.docbook | 14 + doc/et/xsldbg/index.docbook | 96 ++++ doc/et/xsldbg/introduction.docbook | 16 + doc/et/xsldbg/usage.docbook | 62 +++ doc/fr/kxsldbg/callstack.docbook | 28 + doc/fr/kxsldbg/credits.docbook | 29 + doc/fr/kxsldbg/entities.docbook | 28 + doc/fr/kxsldbg/glossary.docbook | 35 ++ doc/fr/kxsldbg/index.docbook | 110 ++++ doc/fr/kxsldbg/kxsldbg_configure.docbook | 67 +++ doc/fr/kxsldbg/kxsldbg_inspector.docbook | 71 +++ doc/fr/kxsldbg/kxsldbg_mainwindow.docbook | 443 ++++++++++++++++ doc/fr/kxsldbg/kxsldbg_tools.docbook | 77 +++ doc/fr/kxsldbg/sources.docbook | 27 + doc/fr/kxsldbg/templates.docbook | 20 + doc/fr/kxsldbg/variables.docbook | 44 ++ doc/it/kxsldbg/callstack.docbook | 28 + doc/it/kxsldbg/credits.docbook | 29 + doc/it/kxsldbg/entities.docbook | 28 + doc/it/kxsldbg/glossary.docbook | 35 ++ doc/it/kxsldbg/index.docbook | 112 ++++ doc/it/kxsldbg/kxsldbg_configure.docbook | 67 +++ doc/it/kxsldbg/kxsldbg_inspector.docbook | 71 +++ doc/it/kxsldbg/kxsldbg_mainwindow.docbook | 443 ++++++++++++++++ doc/it/kxsldbg/kxsldbg_tools.docbook | 77 +++ doc/it/kxsldbg/sources.docbook | 27 + doc/it/kxsldbg/templates.docbook | 20 + doc/it/kxsldbg/variables.docbook | 44 ++ doc/it/xsldbg/commands.docbook | 758 +++++++++++++++++++++++++++ doc/it/xsldbg/credits.docbook | 14 + doc/it/xsldbg/index.docbook | 96 ++++ doc/it/xsldbg/introduction.docbook | 16 + doc/it/xsldbg/usage.docbook | 62 +++ doc/nl/kxsldbg/callstack.docbook | 28 + doc/nl/kxsldbg/credits.docbook | 29 + doc/nl/kxsldbg/entities.docbook | 28 + doc/nl/kxsldbg/glossary.docbook | 35 ++ doc/nl/kxsldbg/index.docbook | 110 ++++ doc/nl/kxsldbg/kxsldbg_configure.docbook | 67 +++ doc/nl/kxsldbg/kxsldbg_inspector.docbook | 71 +++ doc/nl/kxsldbg/kxsldbg_mainwindow.docbook | 443 ++++++++++++++++ doc/nl/kxsldbg/kxsldbg_tools.docbook | 77 +++ doc/nl/kxsldbg/sources.docbook | 27 + doc/nl/kxsldbg/templates.docbook | 20 + doc/nl/kxsldbg/variables.docbook | 44 ++ doc/nl/xsldbg/commands.docbook | 758 +++++++++++++++++++++++++++ doc/nl/xsldbg/credits.docbook | 13 + doc/nl/xsldbg/index.docbook | 96 ++++ doc/nl/xsldbg/introduction.docbook | 17 + doc/nl/xsldbg/usage.docbook | 63 +++ doc/pt/kxsldbg/callstack.docbook | 28 + doc/pt/kxsldbg/credits.docbook | 29 + doc/pt/kxsldbg/entities.docbook | 28 + doc/pt/kxsldbg/glossary.docbook | 35 ++ doc/pt/kxsldbg/index.docbook | 112 ++++ doc/pt/kxsldbg/kxsldbg_configure.docbook | 67 +++ doc/pt/kxsldbg/kxsldbg_inspector.docbook | 71 +++ doc/pt/kxsldbg/kxsldbg_mainwindow.docbook | 443 ++++++++++++++++ doc/pt/kxsldbg/kxsldbg_tools.docbook | 77 +++ doc/pt/kxsldbg/sources.docbook | 27 + doc/pt/kxsldbg/templates.docbook | 20 + doc/pt/kxsldbg/variables.docbook | 44 ++ doc/pt/xsldbg/commands.docbook | 758 +++++++++++++++++++++++++++ doc/pt/xsldbg/credits.docbook | 14 + doc/pt/xsldbg/index.docbook | 96 ++++ doc/pt/xsldbg/introduction.docbook | 16 + doc/pt/xsldbg/usage.docbook | 62 +++ doc/pt_BR/kxsldbg/callstack.docbook | 28 + doc/pt_BR/kxsldbg/credits.docbook | 29 + doc/pt_BR/kxsldbg/entities.docbook | 28 + doc/pt_BR/kxsldbg/glossary.docbook | 35 ++ doc/pt_BR/kxsldbg/index.docbook | 110 ++++ doc/pt_BR/kxsldbg/kxsldbg_configure.docbook | 67 +++ doc/pt_BR/kxsldbg/kxsldbg_inspector.docbook | 71 +++ doc/pt_BR/kxsldbg/kxsldbg_mainwindow.docbook | 443 ++++++++++++++++ doc/pt_BR/kxsldbg/kxsldbg_tools.docbook | 77 +++ doc/pt_BR/kxsldbg/sources.docbook | 27 + doc/pt_BR/kxsldbg/templates.docbook | 20 + doc/pt_BR/kxsldbg/variables.docbook | 44 ++ doc/pt_BR/xsldbg/commands.docbook | 758 +++++++++++++++++++++++++++ doc/pt_BR/xsldbg/credits.docbook | 13 + doc/pt_BR/xsldbg/index.docbook | 96 ++++ doc/pt_BR/xsldbg/introduction.docbook | 16 + doc/pt_BR/xsldbg/usage.docbook | 62 +++ doc/ru/kxsldbg/callstack.docbook | 28 + doc/ru/kxsldbg/credits.docbook | 29 + doc/ru/kxsldbg/entities.docbook | 28 + doc/ru/kxsldbg/glossary.docbook | 35 ++ doc/ru/kxsldbg/kxsldbg_configure.docbook | 67 +++ doc/ru/kxsldbg/kxsldbg_inspector.docbook | 71 +++ doc/ru/kxsldbg/kxsldbg_mainwindow.docbook | 443 ++++++++++++++++ doc/ru/kxsldbg/kxsldbg_tools.docbook | 77 +++ doc/ru/kxsldbg/sources.docbook | 27 + doc/ru/kxsldbg/templates.docbook | 20 + doc/ru/kxsldbg/variables.docbook | 44 ++ doc/ru/xsldbg/commands.docbook | 758 +++++++++++++++++++++++++++ doc/ru/xsldbg/credits.docbook | 14 + doc/ru/xsldbg/index.docbook | 96 ++++ doc/ru/xsldbg/introduction.docbook | 16 + doc/ru/xsldbg/usage.docbook | 62 +++ doc/sv/kxsldbg/breakpoints_window.png | Bin 0 -> 51035 bytes doc/sv/kxsldbg/callstack.docbook | 28 + doc/sv/kxsldbg/callstack_window.png | Bin 0 -> 35938 bytes doc/sv/kxsldbg/configure_window.png | Bin 0 -> 18824 bytes doc/sv/kxsldbg/credits.docbook | 29 + doc/sv/kxsldbg/entities.docbook | 28 + doc/sv/kxsldbg/entities_window.png | Bin 0 -> 34360 bytes doc/sv/kxsldbg/glossary.docbook | 35 ++ doc/sv/kxsldbg/index.docbook | 112 ++++ doc/sv/kxsldbg/kxsldbg_configure.docbook | 67 +++ doc/sv/kxsldbg/kxsldbg_inspector.docbook | 71 +++ doc/sv/kxsldbg/kxsldbg_mainwindow.docbook | 443 ++++++++++++++++ doc/sv/kxsldbg/kxsldbg_tools.docbook | 77 +++ doc/sv/kxsldbg/main_window.png | Bin 0 -> 33668 bytes doc/sv/kxsldbg/publicid_window.png | Bin 0 -> 8334 bytes doc/sv/kxsldbg/sources.docbook | 27 + doc/sv/kxsldbg/sources_window.png | Bin 0 -> 32537 bytes doc/sv/kxsldbg/systemid_window.png | Bin 0 -> 8409 bytes doc/sv/kxsldbg/templates.docbook | 20 + doc/sv/kxsldbg/templates_window.png | Bin 0 -> 32552 bytes doc/sv/kxsldbg/variables.docbook | 44 ++ doc/sv/kxsldbg/variables_window.png | Bin 0 -> 23901 bytes doc/sv/kxsldbg/walk_window.png | Bin 0 -> 9613 bytes doc/sv/xsldbg/commands.docbook | 758 +++++++++++++++++++++++++++ doc/sv/xsldbg/credits.docbook | 14 + doc/sv/xsldbg/index.docbook | 96 ++++ doc/sv/xsldbg/introduction.docbook | 16 + doc/sv/xsldbg/usage.docbook | 62 +++ 224 files changed, 19187 insertions(+) create mode 100644 doc/da/kxsldbg/callstack.docbook create mode 100644 doc/da/kxsldbg/credits.docbook create mode 100644 doc/da/kxsldbg/entities.docbook create mode 100644 doc/da/kxsldbg/glossary.docbook create mode 100644 doc/da/kxsldbg/index.docbook create mode 100644 doc/da/kxsldbg/kxsldbg_configure.docbook create mode 100644 doc/da/kxsldbg/kxsldbg_inspector.docbook create mode 100644 doc/da/kxsldbg/kxsldbg_mainwindow.docbook create mode 100644 doc/da/kxsldbg/kxsldbg_tools.docbook create mode 100644 doc/da/kxsldbg/sources.docbook create mode 100644 doc/da/kxsldbg/templates.docbook create mode 100644 doc/da/kxsldbg/variables.docbook create mode 100644 doc/da/xsldbg/commands.docbook create mode 100644 doc/da/xsldbg/credits.docbook create mode 100644 doc/da/xsldbg/index.docbook create mode 100644 doc/da/xsldbg/introduction.docbook create mode 100644 doc/da/xsldbg/usage.docbook create mode 100644 doc/de/kxsldbg/breakpoints_window.png create mode 100644 doc/de/kxsldbg/callstack.docbook create mode 100644 doc/de/kxsldbg/callstack_window.png create mode 100644 doc/de/kxsldbg/configure_window.png create mode 100644 doc/de/kxsldbg/credits.docbook create mode 100644 doc/de/kxsldbg/entities.docbook create mode 100644 doc/de/kxsldbg/entities_window.png create mode 100644 doc/de/kxsldbg/globals_window.png create mode 100644 doc/de/kxsldbg/glossary.docbook create mode 100644 doc/de/kxsldbg/index.docbook create mode 100644 doc/de/kxsldbg/kxsldbg_configure.docbook create mode 100644 doc/de/kxsldbg/kxsldbg_inspector.docbook create mode 100644 doc/de/kxsldbg/kxsldbg_mainwindow.docbook create mode 100644 doc/de/kxsldbg/kxsldbg_tools.docbook create mode 100644 doc/de/kxsldbg/main_window.png create mode 100644 doc/de/kxsldbg/publicid_window.png create mode 100644 doc/de/kxsldbg/sources.docbook create mode 100644 doc/de/kxsldbg/sources_window.png create mode 100644 doc/de/kxsldbg/systemid_window.png create mode 100644 doc/de/kxsldbg/templates.docbook create mode 100644 doc/de/kxsldbg/templates_window.png create mode 100644 doc/de/kxsldbg/variables.docbook create mode 100644 doc/de/kxsldbg/walk_window.png create mode 100644 doc/es/kxsldbg/1downarrow.png create mode 100644 doc/es/kxsldbg/breakpoints_window.png create mode 100644 doc/es/kxsldbg/callstack.docbook create mode 100644 doc/es/kxsldbg/callstack_window.png create mode 100644 doc/es/kxsldbg/configure.png create mode 100644 doc/es/kxsldbg/configure_window.png create mode 100644 doc/es/kxsldbg/credits.docbook create mode 100644 doc/es/kxsldbg/entities.docbook create mode 100644 doc/es/kxsldbg/entities_window.png create mode 100644 doc/es/kxsldbg/exit.png create mode 100644 doc/es/kxsldbg/glossary.docbook create mode 100644 doc/es/kxsldbg/index.docbook create mode 100644 doc/es/kxsldbg/kxsldbg_configure.docbook create mode 100644 doc/es/kxsldbg/kxsldbg_inspector.docbook create mode 100644 doc/es/kxsldbg/kxsldbg_mainwindow.docbook create mode 100644 doc/es/kxsldbg/kxsldbg_tools.docbook create mode 100644 doc/es/kxsldbg/main_window.png create mode 100644 doc/es/kxsldbg/next.png create mode 100644 doc/es/kxsldbg/publicid_window.png create mode 100644 doc/es/kxsldbg/run.png create mode 100644 doc/es/kxsldbg/sources.docbook create mode 100644 doc/es/kxsldbg/sources_window.png create mode 100644 doc/es/kxsldbg/step.png create mode 100644 doc/es/kxsldbg/systemid_window.png create mode 100644 doc/es/kxsldbg/templates.docbook create mode 100644 doc/es/kxsldbg/templates_window.png create mode 100644 doc/es/kxsldbg/variables.docbook create mode 100644 doc/es/kxsldbg/variables_window.png create mode 100644 doc/es/kxsldbg/walk_window.png create mode 100644 doc/es/kxsldbg/xsldbg_break.png create mode 100644 doc/es/kxsldbg/xsldbg_data.png create mode 100644 doc/es/kxsldbg/xsldbg_delete.png create mode 100644 doc/es/kxsldbg/xsldbg_enable.png create mode 100644 doc/es/kxsldbg/xsldbg_output.png create mode 100644 doc/es/kxsldbg/xsldbg_refresh.png create mode 100644 doc/es/kxsldbg/xsldbg_source.png create mode 100644 doc/es/kxsldbg/xsldbg_stepdown.png create mode 100644 doc/es/kxsldbg/xsldbg_stepup.png create mode 100644 doc/es/xsldbg/commands.docbook create mode 100644 doc/es/xsldbg/credits.docbook create mode 100644 doc/es/xsldbg/index.docbook create mode 100644 doc/es/xsldbg/introduction.docbook create mode 100644 doc/es/xsldbg/usage.docbook create mode 100644 doc/et/kxsldbg/callstack.docbook create mode 100644 doc/et/kxsldbg/credits.docbook create mode 100644 doc/et/kxsldbg/entities.docbook create mode 100644 doc/et/kxsldbg/glossary.docbook create mode 100644 doc/et/kxsldbg/index.docbook create mode 100644 doc/et/kxsldbg/kxsldbg_configure.docbook create mode 100644 doc/et/kxsldbg/kxsldbg_inspector.docbook create mode 100644 doc/et/kxsldbg/kxsldbg_mainwindow.docbook create mode 100644 doc/et/kxsldbg/kxsldbg_tools.docbook create mode 100644 doc/et/kxsldbg/sources.docbook create mode 100644 doc/et/kxsldbg/templates.docbook create mode 100644 doc/et/kxsldbg/variables.docbook create mode 100644 doc/et/xsldbg/commands.docbook create mode 100644 doc/et/xsldbg/credits.docbook create mode 100644 doc/et/xsldbg/index.docbook create mode 100644 doc/et/xsldbg/introduction.docbook create mode 100644 doc/et/xsldbg/usage.docbook create mode 100644 doc/fr/kxsldbg/callstack.docbook create mode 100644 doc/fr/kxsldbg/credits.docbook create mode 100644 doc/fr/kxsldbg/entities.docbook create mode 100644 doc/fr/kxsldbg/glossary.docbook create mode 100644 doc/fr/kxsldbg/index.docbook create mode 100644 doc/fr/kxsldbg/kxsldbg_configure.docbook create mode 100644 doc/fr/kxsldbg/kxsldbg_inspector.docbook create mode 100644 doc/fr/kxsldbg/kxsldbg_mainwindow.docbook create mode 100644 doc/fr/kxsldbg/kxsldbg_tools.docbook create mode 100644 doc/fr/kxsldbg/sources.docbook create mode 100644 doc/fr/kxsldbg/templates.docbook create mode 100644 doc/fr/kxsldbg/variables.docbook create mode 100644 doc/it/kxsldbg/callstack.docbook create mode 100644 doc/it/kxsldbg/credits.docbook create mode 100644 doc/it/kxsldbg/entities.docbook create mode 100644 doc/it/kxsldbg/glossary.docbook create mode 100644 doc/it/kxsldbg/index.docbook create mode 100644 doc/it/kxsldbg/kxsldbg_configure.docbook create mode 100644 doc/it/kxsldbg/kxsldbg_inspector.docbook create mode 100644 doc/it/kxsldbg/kxsldbg_mainwindow.docbook create mode 100644 doc/it/kxsldbg/kxsldbg_tools.docbook create mode 100644 doc/it/kxsldbg/sources.docbook create mode 100644 doc/it/kxsldbg/templates.docbook create mode 100644 doc/it/kxsldbg/variables.docbook create mode 100644 doc/it/xsldbg/commands.docbook create mode 100644 doc/it/xsldbg/credits.docbook create mode 100644 doc/it/xsldbg/index.docbook create mode 100644 doc/it/xsldbg/introduction.docbook create mode 100644 doc/it/xsldbg/usage.docbook create mode 100644 doc/nl/kxsldbg/callstack.docbook create mode 100644 doc/nl/kxsldbg/credits.docbook create mode 100644 doc/nl/kxsldbg/entities.docbook create mode 100644 doc/nl/kxsldbg/glossary.docbook create mode 100644 doc/nl/kxsldbg/index.docbook create mode 100644 doc/nl/kxsldbg/kxsldbg_configure.docbook create mode 100644 doc/nl/kxsldbg/kxsldbg_inspector.docbook create mode 100644 doc/nl/kxsldbg/kxsldbg_mainwindow.docbook create mode 100644 doc/nl/kxsldbg/kxsldbg_tools.docbook create mode 100644 doc/nl/kxsldbg/sources.docbook create mode 100644 doc/nl/kxsldbg/templates.docbook create mode 100644 doc/nl/kxsldbg/variables.docbook create mode 100644 doc/nl/xsldbg/commands.docbook create mode 100644 doc/nl/xsldbg/credits.docbook create mode 100644 doc/nl/xsldbg/index.docbook create mode 100644 doc/nl/xsldbg/introduction.docbook create mode 100644 doc/nl/xsldbg/usage.docbook create mode 100644 doc/pt/kxsldbg/callstack.docbook create mode 100644 doc/pt/kxsldbg/credits.docbook create mode 100644 doc/pt/kxsldbg/entities.docbook create mode 100644 doc/pt/kxsldbg/glossary.docbook create mode 100644 doc/pt/kxsldbg/index.docbook create mode 100644 doc/pt/kxsldbg/kxsldbg_configure.docbook create mode 100644 doc/pt/kxsldbg/kxsldbg_inspector.docbook create mode 100644 doc/pt/kxsldbg/kxsldbg_mainwindow.docbook create mode 100644 doc/pt/kxsldbg/kxsldbg_tools.docbook create mode 100644 doc/pt/kxsldbg/sources.docbook create mode 100644 doc/pt/kxsldbg/templates.docbook create mode 100644 doc/pt/kxsldbg/variables.docbook create mode 100644 doc/pt/xsldbg/commands.docbook create mode 100644 doc/pt/xsldbg/credits.docbook create mode 100644 doc/pt/xsldbg/index.docbook create mode 100644 doc/pt/xsldbg/introduction.docbook create mode 100644 doc/pt/xsldbg/usage.docbook create mode 100644 doc/pt_BR/kxsldbg/callstack.docbook create mode 100644 doc/pt_BR/kxsldbg/credits.docbook create mode 100644 doc/pt_BR/kxsldbg/entities.docbook create mode 100644 doc/pt_BR/kxsldbg/glossary.docbook create mode 100644 doc/pt_BR/kxsldbg/index.docbook create mode 100644 doc/pt_BR/kxsldbg/kxsldbg_configure.docbook create mode 100644 doc/pt_BR/kxsldbg/kxsldbg_inspector.docbook create mode 100644 doc/pt_BR/kxsldbg/kxsldbg_mainwindow.docbook create mode 100644 doc/pt_BR/kxsldbg/kxsldbg_tools.docbook create mode 100644 doc/pt_BR/kxsldbg/sources.docbook create mode 100644 doc/pt_BR/kxsldbg/templates.docbook create mode 100644 doc/pt_BR/kxsldbg/variables.docbook create mode 100644 doc/pt_BR/xsldbg/commands.docbook create mode 100644 doc/pt_BR/xsldbg/credits.docbook create mode 100644 doc/pt_BR/xsldbg/index.docbook create mode 100644 doc/pt_BR/xsldbg/introduction.docbook create mode 100644 doc/pt_BR/xsldbg/usage.docbook create mode 100644 doc/ru/kxsldbg/callstack.docbook create mode 100644 doc/ru/kxsldbg/credits.docbook create mode 100644 doc/ru/kxsldbg/entities.docbook create mode 100644 doc/ru/kxsldbg/glossary.docbook create mode 100644 doc/ru/kxsldbg/kxsldbg_configure.docbook create mode 100644 doc/ru/kxsldbg/kxsldbg_inspector.docbook create mode 100644 doc/ru/kxsldbg/kxsldbg_mainwindow.docbook create mode 100644 doc/ru/kxsldbg/kxsldbg_tools.docbook create mode 100644 doc/ru/kxsldbg/sources.docbook create mode 100644 doc/ru/kxsldbg/templates.docbook create mode 100644 doc/ru/kxsldbg/variables.docbook create mode 100644 doc/ru/xsldbg/commands.docbook create mode 100644 doc/ru/xsldbg/credits.docbook create mode 100644 doc/ru/xsldbg/index.docbook create mode 100644 doc/ru/xsldbg/introduction.docbook create mode 100644 doc/ru/xsldbg/usage.docbook create mode 100644 doc/sv/kxsldbg/breakpoints_window.png create mode 100644 doc/sv/kxsldbg/callstack.docbook create mode 100644 doc/sv/kxsldbg/callstack_window.png create mode 100644 doc/sv/kxsldbg/configure_window.png create mode 100644 doc/sv/kxsldbg/credits.docbook create mode 100644 doc/sv/kxsldbg/entities.docbook create mode 100644 doc/sv/kxsldbg/entities_window.png create mode 100644 doc/sv/kxsldbg/glossary.docbook create mode 100644 doc/sv/kxsldbg/index.docbook create mode 100644 doc/sv/kxsldbg/kxsldbg_configure.docbook create mode 100644 doc/sv/kxsldbg/kxsldbg_inspector.docbook create mode 100644 doc/sv/kxsldbg/kxsldbg_mainwindow.docbook create mode 100644 doc/sv/kxsldbg/kxsldbg_tools.docbook create mode 100644 doc/sv/kxsldbg/main_window.png create mode 100644 doc/sv/kxsldbg/publicid_window.png create mode 100644 doc/sv/kxsldbg/sources.docbook create mode 100644 doc/sv/kxsldbg/sources_window.png create mode 100644 doc/sv/kxsldbg/systemid_window.png create mode 100644 doc/sv/kxsldbg/templates.docbook create mode 100644 doc/sv/kxsldbg/templates_window.png create mode 100644 doc/sv/kxsldbg/variables.docbook create mode 100644 doc/sv/kxsldbg/variables_window.png create mode 100644 doc/sv/kxsldbg/walk_window.png create mode 100644 doc/sv/xsldbg/commands.docbook create mode 100644 doc/sv/xsldbg/credits.docbook create mode 100644 doc/sv/xsldbg/index.docbook create mode 100644 doc/sv/xsldbg/introduction.docbook create mode 100644 doc/sv/xsldbg/usage.docbook diff --git a/doc/da/kxsldbg/callstack.docbook b/doc/da/kxsldbg/callstack.docbook new file mode 100644 index 0000000..1d3a2e5 --- /dev/null +++ b/doc/da/kxsldbg/callstack.docbook @@ -0,0 +1,28 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&rune.laursen.role; + + + +Arbejde med kaldstakken + +Alle kaldstak-punkter ses på listen her. Jo ældre kaldstak-indgangen er jo lavere rammenummer vil den have. Se eksempel herunder. + + +Kaldstakvinduet + + + + +Kaldstakvinduet + + + +Klik på en kaldstak-indgang i den viste liste vil få markøren i hovedvinduet til at gå hen til filen og det angivne linjenummer. + + diff --git a/doc/da/kxsldbg/credits.docbook b/doc/da/kxsldbg/credits.docbook new file mode 100644 index 0000000..ceecdb5 --- /dev/null +++ b/doc/da/kxsldbg/credits.docbook @@ -0,0 +1,29 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&erik.kjaer.pedersen.role; + + +Medvirkende og licenser + +&kxsldbg; © 2004 Keith Isdale +Dokumentation © 2004 Keith Isdale + + + +Tak til: + +Dem som skrevet libxml og libxslt. + + +Robert Jacolin for tilbagemelding om tidligere versioner af &kxsldbg;. + + +Igor Zlatkovic for at have lavet programfiler for WIN32 for libxml/xslt og &xsldbg;. + + +&underFDL; &underGPL; diff --git a/doc/da/kxsldbg/entities.docbook b/doc/da/kxsldbg/entities.docbook new file mode 100644 index 0000000..5d01d9b --- /dev/null +++ b/doc/da/kxsldbg/entities.docbook @@ -0,0 +1,28 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&erik.kjaer.pedersen.role; + + +Arbejde med &XML; datafiler (entiteter) + +Hvis inspektordialogen ikke vises brug menupunktet Værktøjer Vis inspektorer . For at arbejde med entiteter klik på Entiteter-fanebladet i den viste dialog. + +Alle eksterne &XML;-entiteter inkluderet via DATA-fil eller en af dens søskende er på listen her. I dette eksempel har jeg kørt &kxsldbg; på testdoc.xsl med testdoc.xml (fundet i <KDE PREFIX>/share/apps/kxsldbg-mappen så du kan se nogle entiteter. + + +Entiteter-vinduet + + + + +Entiteter-vinduet + + + +klik på en entitetsindgang i den viste liste vil få markøren i hovedvinduet til at gå til starten af den angivne fil. + diff --git a/doc/da/kxsldbg/glossary.docbook b/doc/da/kxsldbg/glossary.docbook new file mode 100644 index 0000000..4606fb8 --- /dev/null +++ b/doc/da/kxsldbg/glossary.docbook @@ -0,0 +1,35 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&erik.kjaer.pedersen.role; + + + + +Nøgleord + +&xsldbg; + +Se . + + + + +Xpath + +Et gyldigt udtryk som definerer hvilke data der kræves. Se W3C's hjemmeside. + + + + +Qname + +Et fuldt kvalificeret navn, for eksempel xsl:min_variabel. Se W3C's hjemmeside. + + + + diff --git a/doc/da/kxsldbg/index.docbook b/doc/da/kxsldbg/index.docbook new file mode 100644 index 0000000..80e1c3f --- /dev/null +++ b/doc/da/kxsldbg/index.docbook @@ -0,0 +1,112 @@ + +KXSLDbg"> + + + + + + + + + + + + + + + xsldbg"> + DTD"> + XSD"> + XSLT"> +]> + + + + +&kxsldbg;-håndbogen + + +Keith Isdale
k_isdale@tpg.com.au
+ + + +&erik.kjaer.pedersen.role; + + + + +2002 +2003 +2004 +Keith Isdale + + +&FDLNotice; +2004-11-18 +0.5 + + +&kxsldbg; sørger for en grafisk grænseflade for &xsldbg;, som hjælper med fejlsøgning i &XSLT;-scripter. + + + +KDE +xsldbg +libxslt +fejlsøger + + + + +Indledning + + +Funktioner + +&kxsldbg; giver adgang til de fleste &xsldbg;-kommandoer til at + +Sætte og ændre stoppunkter + + +Vise værdien af XPaths + + +Vise information om de tilstedeværende skabeloner, variable, kaldstak-indgange, stilark og entiteter. + + +Sæt og ændr stoppunkter og variable + + +Flytte omkring i &XSL;-kildekoden og &XML;-dokumentet via Xpath + + +Slå PUBLIC og SYSTEM ID op i aktuel &XML;-mappe + + + + + + +Nyligt tilføjede egenskaber +&kxsldbg; kan nu + + +Sætte og ændre variable + + +Vise teksten i hovedvindue ved brug af &kate;-bibliotekerne + + + + + + + + +Brug af &kxsldbg; +&configure-section; &mainwindow-section; &inspector-section; &variables; &callstack; &templates; &sources; &entities; &tools-section; + +&credits-chapter; + + diff --git a/doc/da/kxsldbg/kxsldbg_configure.docbook b/doc/da/kxsldbg/kxsldbg_configure.docbook new file mode 100644 index 0000000..f60590d --- /dev/null +++ b/doc/da/kxsldbg/kxsldbg_configure.docbook @@ -0,0 +1,67 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&erik.kjaer.pedersen.role; + + + +Indstilling af &kxsldbg;-session + +Du begynder indstillingen ved at klikke på Fejlsøg Indstil i menulinjen. + + +Indstillingsdialogen + + + + +Indstillingsdialogen +Indstillingsdialogen. + + + + +Sådan kommer vi i gang + +For at kunne køre en stilskabelon skal du angive: +&XSL;-kildekode +&XML;-data +Uddatafil + + + +Ved at bruge knappen ... til at vælge den ønskede fil. &XSL; kilden og >&XML; data kan referere til URI der indeholder http://, ftp:// eller file://. Uddatafil skal referere til en skrivbar lokal fil. +For at følge med i eksemplerne skal du vælge følgende filer i eksemplet. <KDE PREFIX>/share/apps/kxsldbg mappen +&XSL;-kildekode: testdoc.xsl +&XML;-data: testdoc.xml +Uddatafil: /tmp/xsldbg_output.txt + + + + + +Arbejde med valgmuligheder + +Du kan vælge ingen eller nogle valgmuligheder i Tilvalgs-dialogen. Hvert tilvalg har et værktøjsvink med information om hvilken effekt det har. + + + +Arbejde med parametre + +Du kan tilføje nul eller flere parametre via LibXSLT parametre-delen i dialogen. Dette gør det muligt at angive parameterværdier til stilarket. + +F.eks. kan du tilføje et parameternavn af minparam med en parameterværdi, 'Hello World!' og klikke på Tilføj-knappen. For at opdatere værdien i en eksisterende parameter, skal du bare navigere til den værdi du ønsker at ændre med knapperne Forrige eller Næste, angive en ny parameterværdi og så klikke på knappen Anvend. + + + +Anvend ændringer + +For at ændringerne du har lavet skal få virkning, trykkes på knappen Anvend. For at ignorere alle ændringer trykkes på knappen Annullér. + +Du kan lukke dialogen med symbolet X som vises længst oppe til højre i vinduet. Hvis du behøver at ændre indstillingerne, åbnes dialogen blot igen som tidligere beskrevet. + + diff --git a/doc/da/kxsldbg/kxsldbg_inspector.docbook b/doc/da/kxsldbg/kxsldbg_inspector.docbook new file mode 100644 index 0000000..9c2b428 --- /dev/null +++ b/doc/da/kxsldbg/kxsldbg_inspector.docbook @@ -0,0 +1,71 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&erik.kjaer.pedersen.role; + + +Sæt og ændr stoppunkter + +Den primære måde at arbejde med stoppunkter er via hovedvinduet. Se + +Når stilarket er startet, kan du bruge menupunktet Værktøjer Vis inspektører. Klik derefter på fanebladet Stoppunkter. Se et eksempel herunder. + + +Opsætning af stoppunkter + + + + +Opsætning af stoppunkter + + + + +Tilføj et stoppunkt + +Du kan tilføje et stoppunkt ved at angive et af følgende: + +En fil og et linjenummer + +Et skabelonnavn + +Et skabelonnavn og et tilstandsnavn + +Et tilstandsnavn + + + + +Og derefter trykke på knappen Tilføj. + + + +Detaljeinformation om argument: + +Et filnavn kan være en absolut søgesti til en lokal fil, eller en delvis søgesti (⪚ xsldoc.xsl). + +Et skabelon- eller tilstandsnavn er et fuldstændigt kvalificeret navn hvor den ikke-lokale del er valgfri, ⪚ matches xsl:min_mall af min_mall. + + + +Slet et stoppunkt + +Venstreklik først på stoppunktet som du vil slette i listen med aktuelle stoppunkter. Klik derefter på Slet-knappen. + + + +Slet alle stoppunkter + +Klik på Slet alt-knappen. + + + +Aktivér eller deaktivér et stoppunkt + +Venstreklik først på stoppunktet som du vil aktivere i listen med aktuelle stoppunkter. Klik derefter på Aktivér-knappen. + + diff --git a/doc/da/kxsldbg/kxsldbg_mainwindow.docbook b/doc/da/kxsldbg/kxsldbg_mainwindow.docbook new file mode 100644 index 0000000..d122431 --- /dev/null +++ b/doc/da/kxsldbg/kxsldbg_mainwindow.docbook @@ -0,0 +1,443 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&erik.kjaer.pedersen.role; + + +Brug af hovedvinduet + + +Hovedvinduet + + + + +En tekstvisning af den aktuelle fil som fejlsøges +En tekstvisning af den aktuelle fil som fejlsøges. + + + + +Arbejde med hovedvinduet + +Et givet stoppunkts tilstand indikeres via den relevante tekst, med en anderledes baggrundsfarve. Du kan vælge den ønskede farve sådan: OpsætningIndstil Editor, på siden Farver. + + +Du kan sætte, deaktivere eller fjerne et stoppunkt ved at bruge taster, Fejlret-menuen eller knapperne på værktøjslinjen. + +Du kan flytte markøren rundt i teksten med følgende taster: + + +Piletaster: Venstre pil, Højre pil, Opad pil eller Nedad pil. +Sidetaster: Page Up eller Page Down + + + + + + +Arbejde med &kxsldbg;-uddata + +Det meste uddata fra &kxsldbg; fanges og præsenteres enten i inspektørens dialog eller i &kxsldbg;s udskriftsvindue. Undtagelsen for denne regel er: + + +En fejlmeddelelse som kommer fra &kxsldbg; vises i en meddelelsesdialog. + + +Resultatet af evaluering af et udtryk vises i en meddelelsesdialog. + + +Uddata fra en søgning sendes til filen som angives i &kxsldbg;s udskriftsvindue. + + + + + + + + diff --git a/doc/da/kxsldbg/kxsldbg_tools.docbook b/doc/da/kxsldbg/kxsldbg_tools.docbook new file mode 100644 index 0000000..2edee3f --- /dev/null +++ b/doc/da/kxsldbg/kxsldbg_tools.docbook @@ -0,0 +1,77 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&erik.kjaer.pedersen.role; + + + +Diverse værktøjer + +Flere værktøjer er tilgængelige via menuen Fejlsøg, hvor det hovedværktøjet er inspektørværktøjet. + + +Inspektørværktøjet + +Inspektørværktøjet indeholder alle de enkelte dialoger til at arbejde med: + +Stoppunkter +Skabeloner +Variabler +Indgange i kaldstakken +&XSL; kildekodefiler +&XML;-entiteter + + + + + +Kør ved at gennemgå + +Ved at klikke på menupunktet Start kørsel ved gang vises en dialog for at vælge gangshastighed. + + +Gang-vinduet + + + + +Gang-vinduet + + + +For at stoppe gangen, bruges enten tasten W eller menupunktet Stop kørsel ved gang. + + + +Slå &XML;-entiteter op + +For at slå op SystemID op i aktuel &XML;-mappe, bruges menupunktet Slå SystemID op, og derefter indskrives værdien der skal findes i dialogen som vises. + + +System-ID vinduet + + + + +System-ID vinduet + + + +For at slå et PublicID op, bruges menupunktet Slå PublicID op, og derefter indskrives værdien der skal findes i dialogen som vises. + + +Det offentlige ID vindue + + + + +Det offentlige ID vindue + + + + + diff --git a/doc/da/kxsldbg/sources.docbook b/doc/da/kxsldbg/sources.docbook new file mode 100644 index 0000000..3b5a4c2 --- /dev/null +++ b/doc/da/kxsldbg/sources.docbook @@ -0,0 +1,27 @@ + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&erik.kjaer.pedersen.role; + + +Arbejde med &XSLT;-kildefiler (kilder) + +Hvis inspektørdialogen ikke vises brug menupunktet Værktøjer Vis inspektører . For at arbejde med kilder klikkes på kildefanebladet i den viste dialog. + +Alle &XSLT;-kildefiler der er inkluderet i &XSLT;-filen eller en af dens søskende er på denne liste. + + +Kildevinduet + + + + +Kildevinduet + + + +Klik på en kildeindgang i den viste liste vil få markøren i hovedvinduet til at gå til starten af den angivne fil. + diff --git a/doc/da/kxsldbg/templates.docbook b/doc/da/kxsldbg/templates.docbook new file mode 100644 index 0000000..92d24e3 --- /dev/null +++ b/doc/da/kxsldbg/templates.docbook @@ -0,0 +1,20 @@ + +Arbejde med skabeloner + +Hvis inspektørdialogen ikke vises brug menupunktet Værktøjer Vis inspektører . For at arbejde med skabeloner klikkes på skabelonfanebladet i den viste dialog. + +Alle skabeloner er på denne liste. Bemærk venligst at eksportreglerne for &XSLT; gælder. Så der kan ikke være mere end en skabelon med samme tilpasning og tilstandsdetaljer. + + +Skabelonvinduet + + + + +Skabelonvinduet + + + +Klik på en skabelonindgang i den viste liste vil få markøren i hovedvinduet til at gå til starten af den angivne fil. + + diff --git a/doc/da/kxsldbg/variables.docbook b/doc/da/kxsldbg/variables.docbook new file mode 100644 index 0000000..e5d4ef1 --- /dev/null +++ b/doc/da/kxsldbg/variables.docbook @@ -0,0 +1,44 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&rune.laursen.role; + + + +Arbejde med variabler + +Hvis inspektørdialogen ikke vises brug menupunktet Værktøjer Vis inspektører . + +Lokale og globale variable vises i separate faneblade i inspektørdialogen. Det følgende eksempel viser et XSLT-kodesegment der erklærer en global og en lokal variabel. + +<xsl:variabelname="globalvariabel" vælg="'foo'"/> + + <xsl:skabelon match="/"/> + <xsl:param name="localvariabel" vælg="'bar'"/> + </xsl:skabelon match="/"/> + + +Et klik på en varibel i listen med musen, viser opsummerende information i bunden af dialogen. Hvis en variabel har et særligt udtryk, for eksempel + +<xsl:variabelnavn="changeable" vælg="'oldValue'" /> + + +så kan en ny XPath vælges ved at indtaste en ny værdi for Variabeludtryk og derefter klikke på Sæt udtryk-knappen. + + +Fanebladet Variable + + + + +Faneblad til variable +Faneblad til variable + + + +Klik på en variabelindgang i den viste liste, vil få markøren i hovedvinduet til at gå til filen og det angivede linjenummer. + diff --git a/doc/da/xsldbg/commands.docbook b/doc/da/xsldbg/commands.docbook new file mode 100644 index 0000000..9accd3b --- /dev/null +++ b/doc/da/xsldbg/commands.docbook @@ -0,0 +1,758 @@ + + +Kommandoreference + +Tilføjparam +Tilføj en libxslt-parameter. Svarer til at bruge --param <QNAME>:<XPATH> på kommandolinjen. + +At bruge Tilføjparam + +tilføjparam <QNAME> <XPATH>    (<XPATH> må ikke indeholde mellemrum eller dobbelte anførselstegn.) +tilføjparam<QNAME> "<XPATH>"    (Må ikke indeholde dobbelte anførselstegn i <XPATH>) + + +
+ + +Tilføjovervågning +Tilføj et udtryk der skal overvåges. Se på visovervågning virker for at vise overvågningsværdier. +Genvejsnavn: overvåg +At bruge tilføjovervågning + +tilføjovervågning <XPATH> + + +
+ + +Basis +Udskriv denne knudes base +Brug af base + + +base + + +
+ + +Afbryd +Afbryd ved en skabelon, på et sted i et stilark eller en xml-fil indlæst af xsldbg eller i den aktuelle knude. Nyt i xsldbg 3.1.4: Når du er i gdb-kompatibilitetstilstand kan forældreløse stoppunkter sættes i en bestemt fil og linjenummer og ændre til en aktiv senere. +Genvejsnavn: bXsldbg forsøger at gætte at gætte den fuldstændiga URL givet etfilnavn uden angiven søgesti et filnavn i samme mappe som "øverste" skabelon som blev indlæst et filnavn relativt til xsldbgs nuværende arbejdsmappe Hvis du altså har indlæst en stilskabelonfil fra ../en/xsldoc.xsl kan du gøre dette. break -l xsldoc.xsl 26 Denne kommando matcher en partiel eller fuldstændig QNAME-skabelon og/eller tilstandsnavn som angives. For eksempel matcher "skabelon" et hvilket som helst QNAME med en lokal del af "skabelon". Alle navnerum i angivet QNAME expanderes som angives af navnerumerna definerede i XSL-kildekodsfilen, t.ex. expanderes "xsl:test1" til "http://www.w3.org/199/XSL/Transform:test1" En ønsket stoppunkt skal først løses op i dens tilhørende URL og linjenummer- Dette gøres automatisk efter den første skabelon er set af xsldbg. Stoppunkter valideres igen, et kort stykke tid efter hvert kørselsstart. Automatisk stoppunktsvalidering bruges når gdb-tilstand er aktiveret, standardopførselen i xsldbg. +Anvendelse af break + + +break -l <FILENAME> <LINENO>     (For at sætte et stoppunkt i en angivet fil, på et givet linjenummer) +break -l <URL> <LINENO>    (For at sætte et stoppunkt i en angivet URL, på et angivet linjenummer) +break <TEMPLATE_NAME>    (For at afbryde i en navngiven eller matchende skabelon.) +break <TEMPLATE_NAME> <MODE_NAME>    (For at afbryde i en navngiven skabelon med givet tilstand.)> +break "" <MODE_NAME>    (For at afbryde i alle skabeloner som har et givet tilstandsnavn) +break *    (For at afbryde i alle fundne skabeloner.) +break \*    (For at afbryde i skabelon "*". Andre navn som indeholder '*' behandles ikke specielt.) +break     (For at sætte et stoppunkt i nuværende knudepunkt. Ja, det omfatter XML-dataknudepunkter.) + + +
+ + +Bye +Afslut behandling af stilark så snart som muligt. +Brug af Bye + + +farvel + + +
+ + +cat +Udskriv resultatet af et Xpath-udtryk relativt til nuværende knudepunkt. +Brug af cat + + +Anvendelse: cat <XPATH>    (For at vise en variabel eller parameter) +Anvendelse : cat $<QNAME> + + +
+ + +cd +Skift til søgestien som angives af en Xpath. +Brug af cd + + +<< = forudgående-søsken::knude() +>> = efterfølgende-søsken::knude() +<- = forfader::knude() +-> = efterkommer::knude() + +
+ + +chdir +Ændr arbejdsmappen +Brug af chdir + + +chdir <STI>    (En relativ eller absolut søgesti i operativsystemet) + + +
+ + +Fortsæt +Fortsæt med at køre stilarket og stop ved eventuelle stoppunkter. +Genvejsnavn: c +Bruge af continue + + +fortsætte + + +
+ + +Data +Skift til visning af det nuværende knudepunkt i XML-data, eller ændr de anvendte XML-data. +Dataanvendelse + + +data    (Skift til nuværende dokumentknudepunkt.) +data <DATA>    (For at skifte til en ny XML-datafil. Et indledende "~" erstattes af værdien i miljøvariablen $HOME. Kommandoen "run" behøves for at kunne behandle det) + + +
+ + +Slet +Slet et skabelon-stoppunkt. +Genvejsnavn: d +Anvendelse af Delete + + +delete    (For at fjerne stoppunktet i det nuværende knudepunkt) +delete <STOPPUNKT_ID>    (For at fjerne stoppunktet med angivet stoppunktsnummer) +delete -l <FILENAME> <LINENO>    (Fjern i angivet fil, på linjenummer) +delete -l <URL> <LINENO>    (Fjern i angiven URL, på linjenummer) +delete <SKABELONNAVN>    (For at fjerne stoppunktet i navngiven skabelon.) +delete *    (For at fjerne alle stoppunkter.) + + +
+ + +Sletparam +Slet en libxslt-parameter +Brug af sletparam + + +delparam    (Slet alle eksisterendeparametre) +delparam <PARAM_ID> + + +
+ + +Sletovervåg +Slet et overvågningsudtryk, eller fjern alle overvågningsudtryk som vises af kommandoen "showwatch". +Brug af sletovervåg + + +delwatch <OVERVÅGNINGS_ID>    (Slet et overvågningsudtryk med given identifikation) +delwatch *    (Slet alle overvågningsudtryk) + + +
+ + +Dir +Udskriv en liste af knudepunkter på samme måde som en dir skalkommando. + +Anvendelse af Dir + + +dir + + +
+ + +Deaktivér +Deaktivér et stoppunkt +Anvendelse af Disable + + +disable    (For at deaktivere stoppunktet i det aktuelle knudepunkt) +disable <STOPPUNKT_ID>    (For at deaktivere stoppunktet med angivet stoppunktsnummer) +disable -l <FILENAME> <LINENO>    (Deaktivér stoppunkt i angivet fil, på angivet linjenummer) +disable -l <URI> <LINENO>    (Deaktivér stoppunkt i angivet URI, på angivet linjenummernummer) + + +
+ + +du +Udskriv en oversigt af underliggende knudepunkter i træformat. +Brug af du + + +du + + +
+ + +Dump +Dump detaljeret information om dette knudepunkt +Anvendelse af Dump + + +dump + + +
+ + +Aktivér +Aktivér eller deaktivér et stoppunkt (skifter mellem aktiv/inaktiv) +Genvejsnavn: e +Anvendelse af Enable + + +enable    (For at aktivere eller deaktivere stoppunktet i det aktuelle knudepunkt) +enable <STOPPUNKT_ID>    (For at aktivere eller deaktivere stoppunktet med angivet stoppunktsnummer) +enable -l <FILENAME> <LINENO>    (Aktivér eller deaktivér stoppunkt i angiven fil, på angivet linjenummer) +enable -l <URI> <LINENO>    (Aktivér eller deaktivér stoppunkt i angiven URI, på angivet linjenummer) + + +
+ + +Entiteter +Udskriv liste med eksterne Generelle fortolkede entiteter der bruges i datafilen (dokument). +Genvejsnavn: ent +Anvendelse af Entities + + +entiteter + + +
+ + +Afslut +Afslut behandling af stilark så snart som muligt. +Anvendelse af Exit + + +afslutte + + +
+ + +Ramme +Udskriv stakrammen ved en given dybde +Genvejsnavn: f +Anvendelse af Frame + + +frame <RAMME_DYBDE>    (Dybde er et tal fra 0 til kaldstakkens aktuelle dybde) + + +
+ + +Ledig +Frigør stilark og data (deaktiveret, se run). +Anvendelse af Free + + +fri + + +
+ + +Globale +Udskriv en liste af globale stilarkvariable eller parametre. Udskriv værdien på en global variabel. +Anvendnelse af Globals + + +globals    (Udskriv liste med alle globalt tilgængelige variabler) +globals -f    (Udskriv liste med alle globalt tilgængelige variabler og deres værdier) +globals <QNAME>    (Udskriv værdien på variablen som angives) + + +
+ + +Hjælp +Vis hjælp om kommando eller oversigt +Genvejsnavn: h +Brug af hjælp + + +help     (Vis oversigt over produktet) +help <KOMMANDO>     (Vis hjælp om en kommando) + + +
+ + +Indlæs +Indlæs xsldbgs indstillinger og brugerens tilvalg, fra disk. +Brug af indlæs + + +indlæs + + +
+ + +Lokale +Udskriv en en liste med lokale stilarks-variable eller parametre. Udskriv værdien på en lokal variabel. +Anvendelse af Locals + + +locals    (Udskriv en liste med alle lokalt tilgængelige variabler) +locals -f    (Udskriv en liste med alle globalt tilgængelige variabler og deres værdier) +locals <QNAME>    (Udskriv værdien på variablen som angives) + + +
+ + +Ls +List knudepunkter i kompakt format +Anvendelse af Ls + + +ls + + +
+ + +Næste +Spring over en xsl:kald-skabelon eller xsl:anvendelses-skabeloner. Kommandoen har samme effekt som at indtaste kommandoerne "step" og derefter "up". +Genvejsnavn: n +Anvendelse af Next + + +next    (fortsæt til næste instruktion på samme niveau) + + +
+ + +Tilvalg +Udskriv værdier for xsldbgs indstillinger +Anvendelse af Options + + +indstillinger + + +
+ + +Uddata +Angiv en lokal, skrivbar fil som skal bruges til udskrivning af resultater. +Genvejsnavn: o +Anvendelse af Output + + +output <FILENAME>    (Filnavnet på en lokal skrivbar fil, som kan have præfikset "~" på Unix-lignende og CYGWIN platforme, eller miljøvariabler på RISC OS.) +output <WEBBADRESS>    (<URI> må kun benytte protokollen "file://". Den konverteres sidenhen til et filnavn som passer til operativsystemet) +output -    (Send til stdout. Skal kun bruges når xsldbgs kommandoprompt benyttes) + + +
+ + +Public +Udskriv værdien som et offentligt ID afbilder via den aktuelle mappe +Genvejsnavn: pub +Anvendelse af Public + + +public "<PublikID>" + + +
+ + +pwd +Udskriv den aktuelle arbejdsmappe. +Brug af pwd + + +pwd + + +
+ + +Afslut +Afslut behandling af stilark så snart som muligt. +Genvejsnavn: q +Brug af afslut + + +afslut + + +
+ + +Run +Genstart stilarket. +Genvejsnavn: r +Anvendelse af Run + + +kør + + +
+ + +Gem +Gem xsldbgs tilvalg og brugerindstillinger til disken +Brug af gem + + +gem + + +
+ + +Søg +Søg i en database med al information samlet ind fra de indlæste stilark +Alle udskriftsfiler opbevares i værdien på alternativet "searchresultspath" hvis den er angivet, eller samme mappe som det tilhørende stilark. Filen searchresults.xml omdannes normalt af search.xsl, men omdannes ved hjælp af searchhtml. XSL hvis indstillingen "preferhtml" er aktiveret. Når søgkommandoen udføres, oprettes en XML-fil (searchresults.xml). Derefter kan du behandle filen med dit eget stilark for at præsentere data på andre måder. Hvis indstillingen "preferhtml" ikke er aktiveret, udskrives searchresult.txt på skærmen. Afhængigt af om mængden af data som indsamles, kan det tage et stykke tid udføre denne kommando. +Anvendelse af Search + + +search <XPATH>    (Se hvilken Xpath der kan bruges. Se search.dtd. Standard er <XPATH> er '//search/*') +search -sort <XPATH>    (Fortæller search.xsl at resultatet skal sorteres inden det udskrives) + + +
+ + +Sæt +Sæt værdien af en variabel +Sæt brug + + +set <VARIABEL_NAVN> <XPATH> + + +
+ + +indstil +Sæt en indstilling til udførsel af stilark +Du skal bruge kommandoen run for at aktivere ændringer. +Brug af indstil + + +indstil <OPTION_NAME> <HELTALS_VÆRDI> +Hvor <OPTION_NAME> kan være en den ene eller den anden + + + + + debug    (Hvis <HELTALSVÆRDI> er sand, dumpes resultattræet i stedet) + catalogs    (Hvis <HELTALSVÆRDI> er sand, benyt da mapperne fra $SGML_CATALOG_FILES eller SGML $CatalogFiles for RISC OS) + html    (Hvis <HELTALSVÆRDI> er sand er inddatadokumentet en HTML-fil) + docbook    (Hvis <HELTALSVÆRDI> er sand og docbook stadigvæk understøttes af libxml, er inddatadokumentet SGML-docbook) + xinclude    (Hvis <HELTALSVÆRDI> er sand, udfør da Xinclude-behandling af dokumentinddata) + preferhtml    (Hvis <HELTALSVÆRDI> er sand, er det foretrukne uddataformat til søgeresultaterne, HTML-udskrift) + autoencode    (Hvis <HELTALSVÆRDI> er sand, forsøg da at bruge tegnsættet fra stilarket) + utf8input    (Hvis <HELTALSVÆRDI> er sand, gøres al inddata fra brugeren til UTF-8. Dette bruges normalt når xsldbg kører som en tråd) +      + gdb    (Kør i gdb-tilstand) + For værdien 1 betyder dette + Udskriv masser af beskeder. Forøg udskrivningsfrekvensen med "Breapoint at ...". + For det meste skrives GDB_LINES_TO_PRINT ud når udtryk evalueres, efterfulgt af en "...". Se options.h for at ændre værdien. Standard er tre linjer med tekst. + Både lokale og globale variabler udskrives når kommandoen "locals" udføres + Når udtryk udskrives med cat eller print, indledes den evaluerede værdi med "= " <UDTRYK>. + + + + + + For værdien 2 betyder dette Udskriv meddelelser som behøves af Kdbg samt udskriften angivet ovenover (når værdien er 1). + + + + + + + + + nonet    (Hvis <HELTALSVÆRDI> er sand, nægtes hentning af DTD'er eller entiteter via netværk) + novalid    (Hvis <HELTALSVÆRDI> er sand, spring over indlæsningsfasen for DTD'er) + repeat    (Hvis <HELTALSVÆRDI> er sand, kør da omdannelsen 20 gange) + profile    (Hvis <HELTALSVÆRDI> er sand, dump profileringsinformation) + timing    (Hvis <HELTALSVÆRDI> er sand, vis anvendt tid) + noout    (Hvis <HELTALSVÆRDI> er sand, dump ikke resultatet) + + + + +Når værdien er sand hvis den ikke er lig med nul +Når værdien er falsk hvis den ikke er lig med nul. +stdout    Udskriv alle fejlmeddelelser til stdout. Normalt havner alle fejlmeddelelser på stdout. +setoption <OPTION_NAME> "<STRING_VALUE>"    (Må ikke indeholde dobbelte citationstegn i <STRING_VALUE>) +setoption <OPTION_NAME> <STRING_VALUE>    (Må hverken indeholde mellemrum eller dobbelte citationstegn i <STRING_VALUE>) +Hvor <OPTION_NAME> kan være en den ene eller den anden + + + + + data    (Datafilens URI) + source    (Kildekodefilens URI) + output    (Udskriftsfilens SystemID) + docspath    (Søgesti der skal bruges når der søges efter dokumentation) + catalognames    (Navnene på mapperne der skal bruges når indstillingen catalogs er aktiveret. Værdien går tabt hvis den angives inden indstillingen catalogs) + encoding    (Hvilken tegnsæt der skal bruges til standardudskriften) + searchresultspath    Hvilken søgesti der skal bruges når søgeresultat gemmes. Hvis den ikke er angivet, anvender xsldbg stilarkets søgesti. + + + + + +
+ + +Skal +Kør skal-kommando +Brug af skal + + +shell <TEXT>    (<TEXT> er teksten der skal sendes til operativsystemet til udførelse) + + +
+ + +Showbreak +Til at vise en liste over skabelon-stoppunkter. +Genvejsnavn: visHvis en tilstand findes i et skabelonstoppunkt vil den blive tilføjet i stoppunktets navns slutning. Et eksempel på udskriften er: +Stoppunkt 3 aktiveret i skabelonen :"*" i filen test1.xsl : linje 105 +Stoppunkt 2 aktiveret i skabelon :"* testMode" i filen test1.xsl : linje 109 +Breakpoint 1 enabled for template :"* http://www.w3.org/1999/XSL/Transform:testMode" in file test1.xsl : line 113 + +Total of 3 breakpoints present + +Brug af showbreak + + +showbreak + + +
+ + +visparam +Udskriv de eksisterende libxslt-parametre +Brug af visparam + + +visparam + + +
+ + +visovervåg +Vis det aktuelle overvågede udtryk +Genvejsnavn: overvågninger +Brug af visovervåg + + +showwatch    (Vis overvågningspunkter som er valgt og deres værdier) +showwatch 1    (Aktivér automatisk udskrivning af overvågede udtryk. Dette er standard.) +showwatch 0    (Deaktivér automatisk udskrivning af overvågede udtryk.) + + +
+ + +Kilde +Skift til visning af aktuel knudepunkt i stilarket, eller udskift stilarket +Brug af kilde + + +source    (Skift til nuværende knudepunkt i stilarket.) +source <SOURCE>    (For at skifte til en ny kildekodefil. Et indledende "~" erstattes af værdien på miljøvariablen $HOME. Kommandoen "run" er nødvendig for at udføre den) + + +
+ + +Trin +Gå til næste instruktion i stilarket. +Genvejsnavn: s +Brug af trin + + +trin + + +
+ + +Stepdown +Træd ned i en nyere "kalderamme". +Genvejsnavn: ned +Anvendelse af stepdown + + +stepdown     (gå ind i, en stega ned en post) +stepdown <NUMBER_OF_FRAMESSTER>     (gå ned et givet antal rammer) + + +
+ + +Træd op +Gå et trin op til en ældre "kalderamme". +Genvejsnavn: opDette er ikke nogen præcis kommando, xsldbg stopper så tæt på som muligt. +Brug af træd op + + +stepup     (Gå et trin op) +stepup <NUMBER_OF_FRAMES>     (gå et givet antal trin op) + + +
+ + +Stilark +Udskriv en liste med indlæste stilark +Genvejsnavn: stil +Brug af stilark + + +stilark + + +
+ + + +System +Udskriv værdien som en systemfil afbilder via den nuværende mappe. +Genvejsnavn: sys +Brug af system + + +system "<SystemID>" + + +
+ + +Skabeloner +Udskriv en liste med tilgængelige skabeloner. Søg efter en skabelon +Genvejsnavn: t +Brug af skabeloner + + +skabeloner +templates <TEMPLATE>    (Udskriv detaljeret information om skabelonen som hedder <TEMPLATE> hvis den kan findes) + + +
+ + +Spor +Spor en kørsel af stilarket, udskriv filen og linjerne af mellemliggende trin. +Brug af spor + + +spore + + +
+ + +tty +Åbn en terminalemulering. Sæt tty-omdirigeringsniveuaet. +Brug af tty + + +tty <DEVICE_PATH>    (<DEVICE_PATH> er en gyldig terminal i operativsystemet. Forsøger kun åbne terminalen. +tty <TTY-LEVEL>    (Sæt tty-omdirigeringsniveauet, hvor <TTY_LEVEL> er et gyldigt inddata/uddata-niveau at bruge.) + Hvor niveau er + 0 = Standard-inddata/uddata + 1 = Terminaludskrift af resultat fra transformationer, sporing og trinvis kørsel     (Normaltilstand når TTY-enheden er blevet åbnet. Endnu ikke fuldstændig implementeret.) + 2 = Fuldstændig omdirigering til terminalen    (Endnu ikke implementeret.) + Alle andre heltalsværdier antages at betyde niveau 0 + + + + + + +
+ + +Validér +Validerer udskriftfilen som oprettes af stilarket (deaktiveret) +Brug af validér + + +validér + + +
+ + +Gå +Gå gennem koden i forskellige hastighedsintervaller. +Brug af gå + + +walk <SPEED>    (Brug Ctrl+C for at stoppe kørslen. <SPEED> er en værdi mellem 0 og 9, hvor 0 betyder stop, 1 er meget hurtigt og 9 er meget langsomt) + + +
+ + +Hvor +Udskriv en sporing af skabeloner (rammestak) og udskriv arbejdsmappen. +Genvejsnavn: w +Brug af hvor + + +hvor + + +
+ + +Skriv +Skal afsluttes +Brug af skriv + + +skriv + + +
+ + + + + + + diff --git a/doc/da/xsldbg/credits.docbook b/doc/da/xsldbg/credits.docbook new file mode 100644 index 0000000..1cc54c1 --- /dev/null +++ b/doc/da/xsldbg/credits.docbook @@ -0,0 +1,14 @@ + + +Medvirkende og licens + +&xsldbg; +Program ophavsret 2004 Keith Isdale k_isdale tpg com au + +&erik.kjaer.pedersen.credit; +&underFDL; &underGPL; +Tak til +Forfatterne til libxml og libxsl. +Johannes Sixt for at hjælpe med tilføjelse af xsldbg-understøttelse til KDbg + + diff --git a/doc/da/xsldbg/index.docbook b/doc/da/xsldbg/index.docbook new file mode 100644 index 0000000..c464d63 --- /dev/null +++ b/doc/da/xsldbg/index.docbook @@ -0,0 +1,96 @@ + +xsldbg"> + + + + + + + + +]> + + + + + + + + + + + +&xsldbg;-håndbogen + + +Keith Isdale
k_isdale@tpg.com.au
+ + + +&rune.laursen.role; + + + + +2002 +2003 +Keith Isdale + + +&FDLNotice; +2004-09-26 +1.01.00 + + + +&xsldbg; er et værktøj der skal hjælpe dig til at forstå stilark. Det som gør det anderledes end andre stilark-fejlrettere, er muligheden for at søge efter interessante elementer i stilarket og spore stilark-kørsel. + + + +KDE +tdeutils +xsldbg +xsl +XML + + + + +&introduction-chapter; +&usage-chapter; +&commands-chapter; +&credits-chapter; + + + +Installation + + +Sådan får du fat i &xsldbg; + +Se kxsldbg-komponenten i tdewebdev modulet &kde;'s SVN. +&install.intro.documentation; + + +Krav + +For at bruge &xsldbg; ordentligt, skal du have &kde; libxslt, libexslt og libxml installeret. Disser er tilgængelige på almindelige &kde;-installationer. + + + +Kompilering og installation +&xsldbg; er normalt oversat som en del af ksxldbg-komponenten i tdewebdev-modulet + + + +Indstilling + +&xsldbg; indstillet med argumenter som skrives på kommandolinjen og dens setoption kommando + + + + + +&documentation.index; + diff --git a/doc/da/xsldbg/introduction.docbook b/doc/da/xsldbg/introduction.docbook new file mode 100644 index 0000000..1e8890e --- /dev/null +++ b/doc/da/xsldbg/introduction.docbook @@ -0,0 +1,16 @@ + + +Indledning + +&xsldbg; er et tekstbaseret værktøj til at fejlrette stilark (eXtensible Stylesheet Language) og har kommandoer der ligner dem i UNIX/Linux fejlretteren gdb. Det har tre primære metoder at udføre stilark på. + + + + Køre hele stilarket + Enkelt trin til næste xsl-instruktion. + Fortsæt indtil næste stoppunkt eller når stilarket begynder forfra. + + + + + diff --git a/doc/da/xsldbg/usage.docbook b/doc/da/xsldbg/usage.docbook new file mode 100644 index 0000000..162ca1f --- /dev/null +++ b/doc/da/xsldbg/usage.docbook @@ -0,0 +1,62 @@ + + +Brug af &xsldbg; + +xsldbg kommandoargumenter +På systemer med et readline-bibliotek til rådighed, kan du bruge tilbage/fremad-knapperne til at navigere i kommandohistorikken. På alle systemer kan den sidst brugte kommando gentages ved blot at trykke på <ENTER>-tasten. +Hvis dit operativsystem understøtter det kan filnavne udvides. +Mange kommandoer kan tage mere end et argument. Du kan bruge anførselstegn til at lade flere komplekse udtryk blive opfattet som et enkelt, f.eks. break "* | @" ville lade dig sætte et stoppunkt på skabelonen med navnet "* | @" + + +Oversigt over termer +Den følgende tabel beskriver termerne der bruges i den efterfølgende kommandoguide. + + + SKABELON_NAVN : Et gyldigt skabelonnavn indeholder kun ASCII-tegn 0x00 til 0x7F og kan kan være et fuldgyldigt navn som "xsl:skabelonNavn". + FILNAVN : Et gyldigt navn på en lokal fil på brugerens system. Det kan have et "~"-præfiks på *nix og CYGWIN-platforme, eller miljøvariable på RISC OS. + URI : En Uniform Ressource Identifier som defineret i RFC 2396 + TILSTANDS_NAVN : Skabelonens tilstand som kan være et fuldgyldigt navn som "xsl:tilstandsNavn". + QNAVN : Et fuldgyldigt navn som "xsl:lokalPart" + LINENO : Et gyldigt linjenummer i et tilhørende <FILNAVNAVN> + ANTAL_RAMMER : Et gyldigt antal rammer at ændre placering med + STOPPUNKT_ID : Et gyldigt stoppunkts-nummer + OVERVÅGNINGS_ID : Et gyldigt overvågningsnummer som angivet af showwatch-kommandoen + HASTIGHED : hastigheden hvormed koden gennemgåes, mellem 0 og 9 +     (Kommentar): en kommentar om kommandoens betydning eller anvendelse + { opt1 | opt2 | opt2 .. etc} : Vælg en af de foregående opt's + XPATH : et xpath-udvalg af knudepunkter + PARAM_ID : et gyldigt parametertal som angivet af showparam-kommandoen + PATH : En sti at ændre arbejdsmappe med. På nogle operativsystemer vil et "~"-præfiks erstatte stien til din hjemmemappe + TEKST : Fri tekst     (ingen relationer) + KOMMANDO : En gyldig kommando til xsldbg + QNAME : Et gyldig variabel/parameternavn + KILDE : Stilarket der bruge/eksekveres. Se <FILNAVN> og <URI> + DATA : XML-data(dokument) der skal bearbejdes af stilarket. Se <FILNAVN> og <URI> + ENHEDS_STI : En gyldig terminal på operativsystemet + TTY_NIVEAU : Er et gyldigt niveau bruge inddata/uddata på + + + + +Oversigt over tilgængelige kommandoer + + +Hjælp hjælp +Kører relateret : {farvel|exit| afslut}, trin, træd op, træd ned, næste, fortsæt, kør, spor, indstil, indstillinger +Libxslt parameter-relateret : tilføjparam, sletparam, visparam, uddata, indstil, indstillinger +Skabelonrelateret : skabeloner, hvor, ramme +Stoppunkt-relateret : afbryd, vis afbryd, slet, aktivér +Udtryksvisning(xpath) : cat +Knudevisning : ls, dir, du, cat, pwd +Variabelvisning : globale, locale, cat, addwatch +Variabelindstillinger : set +Knudemarkering : kilde, data, cd +Søgning : søg +Operativsystemrelateret : chdir, skal, tty +Filrelateret : uddata, entiteter, system, offentlig +Deaktiverede filkommandoer : validér, indlæs, gem, skriv, free + + + + + diff --git a/doc/de/kxsldbg/breakpoints_window.png b/doc/de/kxsldbg/breakpoints_window.png new file mode 100644 index 0000000..1dd4752 Binary files /dev/null and b/doc/de/kxsldbg/breakpoints_window.png differ diff --git a/doc/de/kxsldbg/callstack.docbook b/doc/de/kxsldbg/callstack.docbook new file mode 100644 index 0000000..7708e61 --- /dev/null +++ b/doc/de/kxsldbg/callstack.docbook @@ -0,0 +1,28 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +GeorgSchuster
gschuster@utanet.at
Deutsche Übersetzung + + + +Arbeiten mit dem Aufrufstapel + +Alle Aufrufstapel-Elemente werden hier aufgelistet. Je älter der Stapeleintrag ist, desto niedriger ist seine Frame-Nummer. Siehe das Beispiel unten. + + +Das Aufrufstapel-Fenster + + + + +Das Aufrufstapel-Fenster + + + +Durch Anklicken eines Aufrufstapeleintrags in der gezeigten Liste wird der Cursor im Hauptfenster zur entsprechenden Zeilennummer der entsprechenden Datei versetzt. + + diff --git a/doc/de/kxsldbg/callstack_window.png b/doc/de/kxsldbg/callstack_window.png new file mode 100644 index 0000000..7f1a2f1 Binary files /dev/null and b/doc/de/kxsldbg/callstack_window.png differ diff --git a/doc/de/kxsldbg/configure_window.png b/doc/de/kxsldbg/configure_window.png new file mode 100644 index 0000000..4f85943 Binary files /dev/null and b/doc/de/kxsldbg/configure_window.png differ diff --git a/doc/de/kxsldbg/credits.docbook b/doc/de/kxsldbg/credits.docbook new file mode 100644 index 0000000..71c7c71 --- /dev/null +++ b/doc/de/kxsldbg/credits.docbook @@ -0,0 +1,29 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +GeorgSchuster
gschuster@utanet.at
Deutsche Übersetzung + + +Mitwirkende und Lizenzen + +&kxsldbg; © 2004 Keith Isdale +Dokumentation © 2004 Keith Isdale + + + +Vielen Dank für die Mithilfe: + +Den Entwicklern der libxml und libxslt Bibliotheken. + + +Robert Jacolin für viele Verbesserungsvorschläge zu früheren Versionen von &kxsldbg;. + + +Igor Zlatkovic für die WIN32-Ausgabe der libxml/xslt und von &xsldbg;. + + +&underFDL; &underGPL; diff --git a/doc/de/kxsldbg/entities.docbook b/doc/de/kxsldbg/entities.docbook new file mode 100644 index 0000000..bc0236c --- /dev/null +++ b/doc/de/kxsldbg/entities.docbook @@ -0,0 +1,28 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +GeorgSchuster
gschuster@utanet.at
Deutsche Übersetzung + + +Arbeiten mit &XML; Daten-Dateien (Entities) + +Wenn der Inspiziere-Dialog nicht automatisch startet, wählen Sie Debuggen Inspiziere ... im Menü. Um die Entitäten zu bearbeiten, wählen Sie den Karteireiter Entities in diesem Dialog. + +Alle externen &XML;-Entities, die über die Datendatei oder eine ihrer Geschwister eingefügt sind, werden hier aufgelistet. Für dieses Beispiel wurde &kxsldbg; mit testdoc.xsl gegentestdoc.xml (die sich im Verzeichnis <KDE PREFIX>/share/apps/kxsldbg befindet) gestartet, damit einige Entities sichtbar werden. + + +Das Entities-Fenster + + + + +Das Entities-Fenster + + + +Das Anklicken eines Entities-Eintrags in der gezeigten Liste bewegt den Textzeiger im Hauptfenster an den Beginn der entsprechenden Datei. + diff --git a/doc/de/kxsldbg/entities_window.png b/doc/de/kxsldbg/entities_window.png new file mode 100644 index 0000000..9efaa1f Binary files /dev/null and b/doc/de/kxsldbg/entities_window.png differ diff --git a/doc/de/kxsldbg/globals_window.png b/doc/de/kxsldbg/globals_window.png new file mode 100644 index 0000000..bd3a5f2 Binary files /dev/null and b/doc/de/kxsldbg/globals_window.png differ diff --git a/doc/de/kxsldbg/glossary.docbook b/doc/de/kxsldbg/glossary.docbook new file mode 100644 index 0000000..38247f3 --- /dev/null +++ b/doc/de/kxsldbg/glossary.docbook @@ -0,0 +1,35 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +GeorgSchuster
gschuster@aon.at
Deutsche Übersetzung + + + + +Schlüsselworte + +&xsldbg; + +Siehe . + + + + +XPath + +Ein gültiger Ausdruck, der definiert, welche Daten erforderlich sind. Näheres siehe auf der W3C-Website. + + + + +QName + +Ein voll qualifizierter (ausgeschriebener) Name. Zum Beispiel xsl:myvariable. Siehe W3C-Website + + + + diff --git a/doc/de/kxsldbg/index.docbook b/doc/de/kxsldbg/index.docbook new file mode 100644 index 0000000..0589d2a --- /dev/null +++ b/doc/de/kxsldbg/index.docbook @@ -0,0 +1,112 @@ + +KXSLDbg"> + + + + + + + + + + + + + + + xsldbg"> + DTD"> + XSD"> + XSLT"> +]> + + + + +Das Handbuch zu &kxsldbg; + + +Keith Isdale
k_isdale@tpg.com.au
+ + + +GeorgSchuster
gschuster@utanet.at
Übersetzung + + + + +2002 +2003 +2004 +Keith Isdale + + +&FDLNotice; +2004-11-18 +0.5 + + +&kxsldbg; ist eine grafische Benutzeroberfläche für &xsldbg;, welche das Bereinigen von Fehlern in &XSLT; Skripten unterstützt. + + + +KDE +xsldbg +libxslt +Debugger + + + + +Einführung + + +Funktionen + +&kxsldbg; ermöglicht den Zugriff auf die meisten &xsldbg;-Befehle, um + +Haltepunkte zu setzen und zu verändern + + +Den Wert von XPath-Ausdrücken anzeigen + + +Informationen über Templates, Variable, Stapelaufrufe, Stilvorlagen und gefundene Entities anzuzeigen + + +Setzen und verändern von Haltepunkten und Variablen + + +Bewegen in &XSL;-Quellen und &XML;-Dokumenten mittels XPath + + +Nachschlagen von PUBLIC IDs und SYSTEM IDs im aktuellen &XML;-Katalog + + + + + + +Kürzlich hinzugefügte Funktionen +&kxsldbg; kann nun + + +Variablen setzen und verändern + + +Stellt den Text im Hauptfenster mittels der &kate;-Bibliotheken dar + + + + + + + + +Die Verwendung von &kxsldbg; +&configure-section; &mainwindow-section; &inspector-section; &variables; &callstack; &templates; &sources; &entities; &tools-section; + +&credits-chapter; + + diff --git a/doc/de/kxsldbg/kxsldbg_configure.docbook b/doc/de/kxsldbg/kxsldbg_configure.docbook new file mode 100644 index 0000000..9eb08ec --- /dev/null +++ b/doc/de/kxsldbg/kxsldbg_configure.docbook @@ -0,0 +1,67 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +GeorgSchuster
gschuster@utanet.at
Deutsche Übersetzung + + + +Einstellung einer &kxsldbg;-Sitzung + +Die Einstellungen können mit Debuggen Einstellungen im Menü vorgenommen werden. + + +Der Einstellungs-Dialog + + + + +Der Einstellungs-Dialog +Der Einstellungs-Dialog. + + + + +Einführung + +Um eine Stilvorlage zu starten, müssen sie folgendes festlegen: +&XSL;-Quelle +&XML;-Daten +Ausgabedatei + + + +Drücken Sie die jeweilige Schaltfläche ..., um die gewünschte Datei auszuwählen. Bitte beachten Sie, dass die &XSL;-Quelle und die &XML;-Daten auch eine URI mit http://, ftp:// or file:// enthalten können. Die Ausgabedatei muss aber eine schreibbare lokale Datei sein. +Zum Fortfahren mit den Beispielen wählen sie bitte die folgenden Dateien im Beispielordner <KDE PREFIX>/share/apps/kxsldbg +&XSL;-Quelle: testdoc.xsl +&XML;-Daten: testdoc.xml +Ausgabedatei: /tmp/xsldbg_output.txt + + + + + +Einstellungen im Menü + +Man kann keine oder mehrere Einstellungen aus dem Einstellungen-Dialog wählen. Jede Einstellung wird durch ein Hilfefenster über die Wirkung unterstützt. + + + +Arbeiten mit Parametern + +Man kann keine oder mehrere Parameter über denLibXSLT-ParameterAbschnitt des Dialoges hinzufügen. Dies ermöglicht die Übergabe von Parameterwerten an die Stilvorlage. + +Sie könnten zum Beispiel einen neuen Parameternamen mit meinemParameter und einem Parameterwert von 'Hallo Welt!' hinzufügen und die Hinzufügen Schaltfläche anklicken. Um einen existierenden Parameter zu ändern, gehen Sie mit der Vor oder Weiter Schaltfläche zum gewünschten Wert und geben Sie einen neuenParameterwert ein und bestätigen Sie mit Anwenden. + + + +Änderungen durchführen + +Um die vorgenommenen Änderungen durchzuführen, drücken Sie den Anwenden-Knopf. Drücken von Abbrechen verwirft sämtliche Änderungen. + +Der Dialog kann durch Drücken von X im rechten oberen Eck des Fensters geschlossen werden. Wenn die Konfiguration geändert werden soll, öffnen Sie den Konfigurationsdialog noch einmal. + + diff --git a/doc/de/kxsldbg/kxsldbg_inspector.docbook b/doc/de/kxsldbg/kxsldbg_inspector.docbook new file mode 100644 index 0000000..d65c70d --- /dev/null +++ b/doc/de/kxsldbg/kxsldbg_inspector.docbook @@ -0,0 +1,71 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +GeorgSchuster
gschuster@utanet.at
Deutsche Übersetzung + + +Setzen und Ändern von Haltepunkten + +Die Hauptarbeit mit Haltepunkten findet im Hauptfenster statt. Siehe das folgende + +Sobald die Stilvorlage gestartet ist, kann im Menü Debuggen Inspiziere ... gewählt werden. Dann auf den Karteireiter Haltepunkte klicken, wie im Beispiel unten. + + +Festlegung von Haltepunkten + + + + +Festlegung von Haltepunkten + + + + +Hinzufügen von Haltepunkten + +Ein Haltepunkt kann wie folgt hinzugefügt werden: + +eine Datei und Zeilennummer + +einen Vorlagennamen + +ein Vorlagenname mit einem Modus-Namen + +einen Modus-Namen + + + + +uns schließlich durch Drücken des Hinzufügen Knopfes. + + + +Einzelheiten der Argumente + +Ein Dateinamen kann ein absoluter Pfad zu einer lokalen Datei sein. Oder nur der Dateiname (z.B. xsldoc.xsl). + +Ein Vorlagen- oder Modusname kann ein voll qualifizierter Name sein, wobei der nicht lokale Teil optional ist, z. B. xsl:mytemplate wird auch durch mytemplate schon bezeichnet + + + +Einen Haltepunkt löschen + +Zuerst den zu löschenden Haltepunkt in der Liste der aktuellen Haltepunkte anklicken. Dann den Löschen Knopf drücken. + + + +Alle Haltepunkte löschen + +Drücken Sie auf den Alles Löschen Knopf. + + + +Aktivieren oder Deaktivieren eines Haltepunktes + +Zuerst klicken Sie auf den zu aktivierenden Haltepunkt und anschließend auf den Aktivieren Knopf. + + diff --git a/doc/de/kxsldbg/kxsldbg_mainwindow.docbook b/doc/de/kxsldbg/kxsldbg_mainwindow.docbook new file mode 100644 index 0000000..140e5fb --- /dev/null +++ b/doc/de/kxsldbg/kxsldbg_mainwindow.docbook @@ -0,0 +1,443 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +GeorgSchuster
gschuster@utanet.at
Deutsche Übersetzung + + +Arbeiten mit dem Hauptfenster + + +Das Hauptfenster + + + + +Textansicht der aktuell in Fehlerbereinigung befindlichen Datei +Textansicht der aktuell in Fehlerbereinigung befindlichen Datei. + + + + +Arbeiten mit dem Hauptfenster + +Der Status eines bestimmten Haltepunktes wir im entsprechenden Text mit einer anderen Hintergrundfarbe angezeigt. Die gewünschte Farbe kann ausgewählt werden: siehe im EinstellungenEditoreinstellungen Dialog, auf der Seite Farben. + + +Man kann einen Haltepunkt mittels Tasten, dem Debug Menü oder den Symbolen in der Werkzeugleiste setzen, deaktivieren oder löschen. + +Der Cursor kann mit folgenden Tasten im Text bewegt werden: + + +Pfeiltasten: Pfeil links, Pfeil rechts, Pfeil hoch oder Pfeil runter. +Bildtasten: Bild auf oder Bild ab + + + + + + +Arbeiten mit der &kxsldbg;-Ausgabe + +Der größte Teil der Ausgabe aus &kxsldbg; wird abgefangen und entweder im "Inspiziere ..." Dialog oder im &kxsldbg;-Ausgabefenster gezeigt. Folgende Ausnahmen gelten von dieser Regel: + + +Eine Fehlermeldung von &kxsldbg; wird in einem Meldungsfenster angezeigt. + + +Das Ergebnis des Überprüfens eines Ausdrucks wird in einem Meldungsfenster angezeigt. + + +Die Ausgabe eines Suchlaufes wird an die im &kxsldbg;-Ausgabefenster gekennzeichnete Datei gesendet. + + + + + + + + diff --git a/doc/de/kxsldbg/kxsldbg_tools.docbook b/doc/de/kxsldbg/kxsldbg_tools.docbook new file mode 100644 index 0000000..90da08e --- /dev/null +++ b/doc/de/kxsldbg/kxsldbg_tools.docbook @@ -0,0 +1,77 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +GeorgSchuster
gschuster@utanet.at
Deutsche Übersetzung + + + +Verschiedene Werkzeuge + +Die verschiedenen Werkzeuge sind über das Debuggen-Menü verfügbar, wobei das "Inspiziere ..."-Werkzeug am wichtigsten ist. + + +Das "Inspiziere ..."-Werkzeug + +Das "Inspiziere ..."-Werkzeug enthält für die folgenden Aufgaben eigene Dialoge: + +Haltepunkte +Vorlagen +Variablen +Aufruflisteneinträge +&XSL;-Quelldateien +&XML;-Entities + + + + + +Schrittweises Ausführen + +Durch Anklicken von Schrittweises Ausführen im Menü wird ein Dialog für die Wahl der Ablaufgeschwindigkeit angezeigt. + + +Das Ablauffenster + + + + +Das Ablauffenster + + + +Um den Ablauf zu stoppen drücken Sie die W-Taste oder wählen Sie Schrittweises Ausführen im Menü. + + + +Aufruf von &XML;-Entities + +Um eine SystemID im aktuellen &XML;-Katalog nachzuschlagen, wählen Sie SystemID nachschlagen ... im Menü und geben im angezeigten Dialog den zu findenden Wert ein. + + +Das SystemID-Fenster + + + + +Das SystemID-Fenster + + + +Zum Nachschlagen einer PublicID wählen Sie PublicID nachschlagen ... aus dem Menü und geben den zu findenden Wert im dann angezeigten Dialog ein. + + +Das PublicID-Fenster + + + + +Das PublicID-Fenster + + + + + diff --git a/doc/de/kxsldbg/main_window.png b/doc/de/kxsldbg/main_window.png new file mode 100644 index 0000000..41f32ed Binary files /dev/null and b/doc/de/kxsldbg/main_window.png differ diff --git a/doc/de/kxsldbg/publicid_window.png b/doc/de/kxsldbg/publicid_window.png new file mode 100644 index 0000000..a94eeab Binary files /dev/null and b/doc/de/kxsldbg/publicid_window.png differ diff --git a/doc/de/kxsldbg/sources.docbook b/doc/de/kxsldbg/sources.docbook new file mode 100644 index 0000000..87fc797 --- /dev/null +++ b/doc/de/kxsldbg/sources.docbook @@ -0,0 +1,27 @@ + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +GeorgSchuster
gschuster@utanet.at
Deutsche Übersetzung + + +Umgang mit &XSLT;-Quelldateien (Quellen) + +Sollte der Inspektions-Dialog nicht erscheinen, wählen Sie Debuggen Inspiziere ... aus dem Menü. Um die Quellen zu bearbeiten, klicken Sie auf den Karteireiter Quelltexte im erscheinenden Dialog. + +Alle &XSLT;-Quelldateien, die durch die &XSLT;-Datei eingebunden sind oder deren "Geschwister" werden hier aufgelistet. + + +Das Quellenfenster + + + + +Das Quellenfenster + + + +Das Anklicken eines Quelleintrags in der gezeigten Liste versetzt den Textzeiger im Hauptfenster an den Beginn der entsprechenden Datei. + diff --git a/doc/de/kxsldbg/sources_window.png b/doc/de/kxsldbg/sources_window.png new file mode 100644 index 0000000..719090a Binary files /dev/null and b/doc/de/kxsldbg/sources_window.png differ diff --git a/doc/de/kxsldbg/systemid_window.png b/doc/de/kxsldbg/systemid_window.png new file mode 100644 index 0000000..08bf5f4 Binary files /dev/null and b/doc/de/kxsldbg/systemid_window.png differ diff --git a/doc/de/kxsldbg/templates.docbook b/doc/de/kxsldbg/templates.docbook new file mode 100644 index 0000000..b5229e9 --- /dev/null +++ b/doc/de/kxsldbg/templates.docbook @@ -0,0 +1,20 @@ + +Arbeiten mit Vorlagen + +Sollte der Inspektions-Dialog nicht erscheinen, wählen Sie Debuggen Inspiziere ... aus dem Menü. Um die Quellen zu bearbeiten, klicken Sie auf den Karteireiter Quelltexte im erscheinenden Dialog. + +Alle gefundenen Vorlagen werden hier aufgelistet. Es ist zu beachten, dass die Export-Regeln von &XSLT; gelten. Daher können mehrere Vorlagen mit den selben Übereinstimmungs- und Modus-Einzelheiten vorhanden sein. + + +Das Vorlagenfenster + + + + +Das Vorlagenfenster + + + +Das Anklicken eines Vorlageneintrags in der gezeigten Liste bewegt den Textzeiger im Hauptfenster zur entsprechenden Zeile dieser Datei. + + diff --git a/doc/de/kxsldbg/templates_window.png b/doc/de/kxsldbg/templates_window.png new file mode 100644 index 0000000..3dc8fe5 Binary files /dev/null and b/doc/de/kxsldbg/templates_window.png differ diff --git a/doc/de/kxsldbg/variables.docbook b/doc/de/kxsldbg/variables.docbook new file mode 100644 index 0000000..5da4d30 --- /dev/null +++ b/doc/de/kxsldbg/variables.docbook @@ -0,0 +1,44 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +GeorgSchuster
gschuster@utanet.at
Deutsche Übersetzung + + + +Arbeiten mit Variablen + +Sollte der Inspektor-Dialog nicht sichtbar sein, wählen Sie im Menü Debuggen Inspiziere .... + +Lokale und globale Variable werden in einem Karteireiter im Inspiziere-Dialog gezeigt. Das folgende Beispiel zeigt XSLT-Quelltext, in dem eine globale und eine lokale Variable deklariert wird + +<xsl:variable name="globalvariable" select="'foo'"/> + + <xsl:template match="/"/> + <xsl:param name="localvariable" select="'bar'"/> + </xsl:template match="/"/> + + +Durch Anklicken einer Variable aus der Liste erhält man eine zusammenfassende Information im Dialog unten. Wenn eine Variable einen bestimmten Ausdruck, zum Beispiel + +<xsl:variable name="changeable" select="'oldValue'" /> + + +enthält, dann kann ein neuer XPath durch Eingabe eines neuen Wertes für den Variablen-Ausdruck und Anklicken der Schaltfläche Ausdruck festlegen gewählt werden. + + +Der Karteireiter Variable + + + + +Der Karteireiter für Variable +Der Karteireiter für Variable + + + +Beim Anklicken eines Variableneintrags in der Liste wird der Textzeiger im Hauptfenster zur entsprechenden Zeile dieser Datei versetzt. + diff --git a/doc/de/kxsldbg/walk_window.png b/doc/de/kxsldbg/walk_window.png new file mode 100644 index 0000000..133de28 Binary files /dev/null and b/doc/de/kxsldbg/walk_window.png differ diff --git a/doc/es/kxsldbg/1downarrow.png b/doc/es/kxsldbg/1downarrow.png new file mode 100644 index 0000000..6e864cb Binary files /dev/null and b/doc/es/kxsldbg/1downarrow.png differ diff --git a/doc/es/kxsldbg/breakpoints_window.png b/doc/es/kxsldbg/breakpoints_window.png new file mode 100644 index 0000000..82a6f63 Binary files /dev/null and b/doc/es/kxsldbg/breakpoints_window.png differ diff --git a/doc/es/kxsldbg/callstack.docbook b/doc/es/kxsldbg/callstack.docbook new file mode 100644 index 0000000..79f1c82 --- /dev/null +++ b/doc/es/kxsldbg/callstack.docbook @@ -0,0 +1,28 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +Juan ManuelGarcía Molina
juanma@superiodico.net
Traductor + + + +Trabajar con la pila de llamadas + +Se listan aquí todos los elementos encontrados en la pila de llamadas. Mientras más angigua sea la entrada, más bajo será el número del marco que tenga. Vea el ejemplo de más abajo. + + +La ventana de la pila de llamadas + + + + +La ventana de la pila de llamadas + + + +Al hacer clic sobre una entrada de la pila de llamadas que se muestra en la lista, el cursor de la ventana principal se desplazará al archivo y el número de línea indicados. + + diff --git a/doc/es/kxsldbg/callstack_window.png b/doc/es/kxsldbg/callstack_window.png new file mode 100644 index 0000000..cd1294f Binary files /dev/null and b/doc/es/kxsldbg/callstack_window.png differ diff --git a/doc/es/kxsldbg/configure.png b/doc/es/kxsldbg/configure.png new file mode 100644 index 0000000..a1f3da8 Binary files /dev/null and b/doc/es/kxsldbg/configure.png differ diff --git a/doc/es/kxsldbg/configure_window.png b/doc/es/kxsldbg/configure_window.png new file mode 100644 index 0000000..a61ddbc Binary files /dev/null and b/doc/es/kxsldbg/configure_window.png differ diff --git a/doc/es/kxsldbg/credits.docbook b/doc/es/kxsldbg/credits.docbook new file mode 100644 index 0000000..7b82324 --- /dev/null +++ b/doc/es/kxsldbg/credits.docbook @@ -0,0 +1,29 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +Juan ManuelGarcía Molina
juanma@superiodico.net
Traductor + + +Créditos y licencias + +&kxsldbg; © 2004 Keith Isdale +Documentación © 2004 Keith Isdale + + + +Gracias a: + +Los que han escrito libxml y libxslt. + + +Robert Jacolin por su realimentación en las primeras versiones de &kxsldbg;. + + +Igor Zlatkovic por crear binario WIN32 de libxml/xslt y &xsldbg;. + + +&underFDL; &underGPL; diff --git a/doc/es/kxsldbg/entities.docbook b/doc/es/kxsldbg/entities.docbook new file mode 100644 index 0000000..cffd792 --- /dev/null +++ b/doc/es/kxsldbg/entities.docbook @@ -0,0 +1,28 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +Juan ManuelGarcía Molina
juanma@superiodico.net
Traductor + + +Trabajar con archivos de datos &XML; (Entidades) + +Si no se está mostrando el cuadro de diálogo del inspector, use el elemento Herramientass Mostrar inspectores del menú. Para trabajar con entidades, haga clic sobre la solapa Entidades del cuadro de diálogo que se muestra. + +Todas las entidades &XML; externas incluídas por medio del archivo DATA o uno de sus hermanos se muestran aquí. Para este ejemplo, he ejecutado &kxsldbg; sobre testdoc.xsl con testdoc.xml (que se encuentra en la carpeta <KDE PREFIX>/share/apps/kxsldbg, de tal forma que pueda ver algunas entidades. + + +La ventana Entidades + + + + +La ventana Entidades + + + +Al hacer clic sobre una entidad de la lista se pasará el cursor a la ventana principal, al comienzo del archivo indicado. + diff --git a/doc/es/kxsldbg/entities_window.png b/doc/es/kxsldbg/entities_window.png new file mode 100644 index 0000000..78697f7 Binary files /dev/null and b/doc/es/kxsldbg/entities_window.png differ diff --git a/doc/es/kxsldbg/exit.png b/doc/es/kxsldbg/exit.png new file mode 100644 index 0000000..dc11dc6 Binary files /dev/null and b/doc/es/kxsldbg/exit.png differ diff --git a/doc/es/kxsldbg/glossary.docbook b/doc/es/kxsldbg/glossary.docbook new file mode 100644 index 0000000..24c2baf --- /dev/null +++ b/doc/es/kxsldbg/glossary.docbook @@ -0,0 +1,35 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +Juan ManuelGarcía Molina
juanma@superiodico.net
Traductor + + + + +Palabras clave + +&xsldbg; + +Vea . + + + + +XPath + +Una expresión válida que define qué datos son necesarios. Vea el sitio web del W3C. + + + + +QName + +Un nombre plenamente cualificado. Por ejemplo, xsl:mivariable. Vea el sitio web del W3C + + + + diff --git a/doc/es/kxsldbg/index.docbook b/doc/es/kxsldbg/index.docbook new file mode 100644 index 0000000..4f784a0 --- /dev/null +++ b/doc/es/kxsldbg/index.docbook @@ -0,0 +1,112 @@ + +KXSLDbg"> + + + + + + + + + + + + + + + xsldbg"> + DTD"> + XSD"> + XSLT"> +]> + + + + +El manual de &kxsldbg; + + +Keith Isdale
k_isdale@tpg.com.au
+ + + +Juan ManuelGarcía Molina
juanma@superiodico.net
Traductor + + + + +2002 +2003 +2004 +Keith Isdale + + +&FDLNotice; +2004-11-18 +0.5 + + +&kxsldbg; proporciona un interfaz de usuario gráfico para &xsldbg;, que admite la depuración de guiones &XSLT;. + + + +KDE +xsldbg +libxslt +depurador + + + + +Introducción + + +Características + +&kxsldbg; proporciona acceso a la mayor parte de los comandos de &xsldbg; para + +Fijar y modificar puntos de interrupción + + +Mostrar el valor de XPaths + + +Mostrar información sobre las plantillas, las variables, las entradas de la pila de llamadas, las hojas de estilo y las entidades presentes. + + +Definir y modificar los puntos de interrupción y las variables + + +Moverse por los documentos fuente &XSL; y &XML; por medio de XPaths + + +Buscar ids. de sistema y públicos en el cuadro de diálogo &XML; actual + + + + + + +Características añadidas recientemente +Ahora, &kxsldbg; puede + + +Definir y modificar variables + + +Se dibuja el texto de la ventana principal usando las bibliotecas de &kate;. + + + + + + + + +Usar &kxsldbg; +&configure-section; &mainwindow-section; &inspector-section; &variables; &callstack; &templates; &sources; &entities; &tools-section; + +&credits-chapter; + + diff --git a/doc/es/kxsldbg/kxsldbg_configure.docbook b/doc/es/kxsldbg/kxsldbg_configure.docbook new file mode 100644 index 0000000..f055b60 --- /dev/null +++ b/doc/es/kxsldbg/kxsldbg_configure.docbook @@ -0,0 +1,67 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +Juan ManuelGarcía Molina
juanma@superiodico.net
Traductor + + + +Configurar una sesión de &kxsldbg; + +Para empezar la configuración, haga clic sobre Depurar Configurar en la barra de menú. + + +El cuadro de diálogo Configuración + + + + +El cuadro de diálogo Configuración +El cuadro de diálogo Configuración. + + + + +Comenzar + +Para poder ejecutar una hoja de estilo tiene que especificar la: +fuente &XSL; +datos &XML; +Archivo de salida + + + +Use el botón ... para seleccionar el archivo deseado. La fuente &XSL; y los datos &XML; se pueden referir a la URI que contiene un http://, un ftp:// o un file://. El Archivo de salida se debe referir a un archivo local en el que se pueda escribir. +Para continuar con los ejemplo, seleccione los siguientes archivos de la carpeta <KDE PREFIX>/share/apps/kxsldbg:: +fuente &XSL;: testdoc.xsl +Datos &XML;: testdoc.xml +Archivo de salida: /tmp/xsldbg_output.txt + + + + + +Trabajar con las opciones + +Puede seleccionar cero o más opciones del cuadro de diálogo Opciones. Cada opción tiene un consejo sobre el efecto que tiene. + + + +Trabajar con parámetros + +Puede añadir cero o más parámetros por medio de la sección Parámetros LibXSLT del cuadro de diálogo. Esto le permite proporcionar valores de parámetros para la hoja de estilo. + +Por ejemplo, podría añadir e introducir un Nombre de parámetro miparam con un Valor del parámetro de '¡Hola, mundo!' y hacer clic en el botón Añadir. Para actualizar el valor de un parámetro existente, puede usar el navegador para llegar al valor que quiera cambiar con los botones Ant o Sig, proporcionar un nuevo Valor del parámetro y luego hacer clic sobre el botón Aplicar. + + + +Aplicar cambios + +Para que tengan efecto los cambios que ha hecho, pulse el botón Aplicar. Para ignorar todos los cambios, pulse el botón Cancelar. + +Puede cerrar el cuadro de diálogo usando la X que se proporciona arriba y a la derecha de la ventana. Si necesita cambiar la configuración, simplemente vuelva a abrir el cuadro de diálogo de configuración que se mostró antes. + + diff --git a/doc/es/kxsldbg/kxsldbg_inspector.docbook b/doc/es/kxsldbg/kxsldbg_inspector.docbook new file mode 100644 index 0000000..b5952a2 --- /dev/null +++ b/doc/es/kxsldbg/kxsldbg_inspector.docbook @@ -0,0 +1,71 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +Juan ManuelGarcía Molina
juanma@superiodico.net
Traductor + + +Configurar y modificar puntos de interrupción + +La forma principal de trabajar con los puntos de ruptura es por medio de la ventana principal. Vea + +Una vez que haya comenzado la hoja de estilo, puede usar el elemento del menú Herramientas Mostrar inspectores . Luego, haga clic sobre la solapa Puntos de interrupción. Más abajo tiene un ejemplo. + + +Configurar puntos de interrupción + + + + +Configurar puntos de interrupción + + + + +Añadir un punto de interrupción + +Puede añadir un punto de interrupción suministrando: + +un archivo y un número de línea + +un nombre de plantilla + +un nombre de plantilla y un nombre de modo + +un nombre de modo + + + + +Y luego pulse el botón Añadir. + + + +Destalles del argumento + +Un nombre de archivo debe ser una ruta absoluta a un archivo local. O un archivo parcial (⪚ xsldoc.xsl). + +Una plantilla o un nombre de modo es un nombre plenamente cualificado en el que las partes no locales son opcionales, ⪚ xsl:miplantilla se hace coincidir con miplantilla + + + +Eliminar un punto de interrupción + +En primer lugar, haga clic izquierdo con el ratón sobre el punto de interrupción que quiera eliminar en la lista actual de puntos de interrupción. Luego haga clic sobre el botón Eliminar. + + + +Eliminar todos los puntos de interrupción + +Clic sobre el botón Eliminar todos. + + + +Activar o desactivar un punto de interrupción + +Primero, haga clic &LMB; sobre el punto de interrupción que quiera eliminar de la lista actual de puntos de interrupción. Luego, haga clic sobre el botón Activar. + + diff --git a/doc/es/kxsldbg/kxsldbg_mainwindow.docbook b/doc/es/kxsldbg/kxsldbg_mainwindow.docbook new file mode 100644 index 0000000..6650bf9 --- /dev/null +++ b/doc/es/kxsldbg/kxsldbg_mainwindow.docbook @@ -0,0 +1,443 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +Juan ManuelGarcía Molina
juanma@superiodico.net
Traductor + + +Usar la ventana principal + + +La ventana principal + + + + +Una vista de texto del archivo que se está depurando actualmente +Una vista de texto del archivo que se está depurando actualmente. + + + + +Trabajar con la ventana principal + +El estado de un punto de interrupción dado se indica por medio del texto relevante con un color de fondo diferente. Puede elegir el color que desee: puede ver el cuadro de diálogo PreferenciasConfigurar editor Colores, en la página Colores. + + +Puede definir, desactivar o eliminar un punto de interrupción usando las teclas, el menú Depurar o los botones de la barra de herramientas. + +Puede mover el cursor a través del texto usando las siguientes teclas: + + +Flechas de dirección: flecha arriba, flecha derecha, flecha arriba or flecha abajo. +Teclas de página: Av Pág or Re Pág + + + + + + +Trabajar con la salida de &kxsldbg; + +La mayoría de la salida de &kxsldbg; se captura y se presenta o bien en los cuadros de diálogo de los inspectores o bien en la ventana de salida de &kxsldbg;. Las excepciones a esta regla son: + + +Se muestra un mensaje que viene de &kxsldbg; dentro de un cuadro de diálogo de mensaje. + + +El resultado de evaluar una expresión se muestra en un cuadro de diálogo de mensaje. + + +La salida de la búsqueda se envía al campo que se indica en la ventana de salida de &kxsldbg;. + + + + + + + + diff --git a/doc/es/kxsldbg/kxsldbg_tools.docbook b/doc/es/kxsldbg/kxsldbg_tools.docbook new file mode 100644 index 0000000..ebbee08 --- /dev/null +++ b/doc/es/kxsldbg/kxsldbg_tools.docbook @@ -0,0 +1,77 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +Juan ManuelGarcía Molina
juanma@superiodico.net
Traductor + + + +Herramientas varias + +Hay disponibles varias herramientas por medio del menú herramientas. La herramienta principal es el inspector. + + +Herramienta Inspector + +La herramienta inspector es la que tiene todos los cuadros de diálogo individuales con los que trabajar: + +Puntos de interrupción +Plantillas +Variables +Entradas de la pila de llamadas +Archivos fuente &XSL; +Entidades &XML; + + + + + +Ejecutar por pasos + +Al hacer clic sobre el menú Comenzar ejecución por pasos, se mostrará un cuadro de diálogo para permitir la selección de la velocidad del paso. + + +La ventana de paso + + + + +La ventana de paso + + + +Para detener la marcha use o bien la tecla W o bien seleccione el elemento Comenzar la ejecución por pasos. + + + +Buscar entidades &XML; + +Para buscar un id. de sistema en el catálogo &XML; actual, use el menú Buscar id. de sistema y luego indique el valor para encontrarlo en el cuadro de diálogo que se muestra. + + +La ventana id. del sistema + + + + +La ventana id. del sistema + + + +Para buscar un id. público, use la entrada Buscar id. público del menú para indicar el valor para encontrar el cuadro de diálogo que se muestra. + + +La ventana id. público + + + + +La ventana id. público + + + + + diff --git a/doc/es/kxsldbg/main_window.png b/doc/es/kxsldbg/main_window.png new file mode 100644 index 0000000..156a4ee Binary files /dev/null and b/doc/es/kxsldbg/main_window.png differ diff --git a/doc/es/kxsldbg/next.png b/doc/es/kxsldbg/next.png new file mode 100644 index 0000000..128f746 Binary files /dev/null and b/doc/es/kxsldbg/next.png differ diff --git a/doc/es/kxsldbg/publicid_window.png b/doc/es/kxsldbg/publicid_window.png new file mode 100644 index 0000000..167f33a Binary files /dev/null and b/doc/es/kxsldbg/publicid_window.png differ diff --git a/doc/es/kxsldbg/run.png b/doc/es/kxsldbg/run.png new file mode 100644 index 0000000..6ebbd38 Binary files /dev/null and b/doc/es/kxsldbg/run.png differ diff --git a/doc/es/kxsldbg/sources.docbook b/doc/es/kxsldbg/sources.docbook new file mode 100644 index 0000000..f1ffaee --- /dev/null +++ b/doc/es/kxsldbg/sources.docbook @@ -0,0 +1,27 @@ + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +Juan ManuelGarcía Molina
juanma@superiodico.net
Traductor + + +Trabajar con archivos fuente de &XSLT; (Fuentes) + +Si el cuadro de diálogo del inspector no se muestra, use el elemento Herramientas Mostar inspectores del menú. Para trabajar con las fuentes, haga clic sobre la solapa fuentes del cuadro de diálogo que se muestra. + +Aquí se listan todos los archivos fuente &XSLT; que incluye el archivo &XSLT; o uno de sus hermanos. + + +La ventana Fuentes + + + + +La ventana Fuentes + + + +Al hacer clic sobre la entrada de la lista de fuentes se pasará el de la ventana principal al comienzo del archivo indicado. + diff --git a/doc/es/kxsldbg/sources_window.png b/doc/es/kxsldbg/sources_window.png new file mode 100644 index 0000000..6462ad3 Binary files /dev/null and b/doc/es/kxsldbg/sources_window.png differ diff --git a/doc/es/kxsldbg/step.png b/doc/es/kxsldbg/step.png new file mode 100644 index 0000000..3fe4010 Binary files /dev/null and b/doc/es/kxsldbg/step.png differ diff --git a/doc/es/kxsldbg/systemid_window.png b/doc/es/kxsldbg/systemid_window.png new file mode 100644 index 0000000..c856c13 Binary files /dev/null and b/doc/es/kxsldbg/systemid_window.png differ diff --git a/doc/es/kxsldbg/templates.docbook b/doc/es/kxsldbg/templates.docbook new file mode 100644 index 0000000..cf42030 --- /dev/null +++ b/doc/es/kxsldbg/templates.docbook @@ -0,0 +1,20 @@ + +Trabajar con plantillas + +Si el cuadro de diálogo del inspector no se muestra, use el elemento Herramientas Mostrar inspectores del menú. Para trabajar con las plantillas, haga clic sobre la solapa plantillas del cuadro de diálogo que se muestra. + +Todas las plantillas encontradas se listan aquí. Tenga en cuenta que se aplican las reglas de exportación de &XSLT;. Así que sólo puede haber una o más plantillas con igual coincidencia y detalles del modo. + + +La ventana Plantillas + + + + +La ventana Plantillas + + + +Al hacer clic sobre una entrada de la lista de plantillas se pasará el cursor de la ventana principal al archivo y número de línea que se indique. + + diff --git a/doc/es/kxsldbg/templates_window.png b/doc/es/kxsldbg/templates_window.png new file mode 100644 index 0000000..eaba975 Binary files /dev/null and b/doc/es/kxsldbg/templates_window.png differ diff --git a/doc/es/kxsldbg/variables.docbook b/doc/es/kxsldbg/variables.docbook new file mode 100644 index 0000000..e14fba4 --- /dev/null +++ b/doc/es/kxsldbg/variables.docbook @@ -0,0 +1,44 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +Juan ManuelGarcía Molina
juanma@superiodico.net
Traductor + + + +Trabajar con variables + +Si el cuadro de diálogo del inspector no se muestra, use el elemento Tools Mostrar inspectores del menú. + +Las variables locales y globales se muestran en una solapa del cuadro de diálogo del inspector. El ejemplo siguiente muestra un segmento de código XSLT que declara una variable global y una local. + +<xsl:variable name="globalvariable" select="'foo'"/> + + <xsl:template match="/"/> + <xsl:param name="localvariable" select="'bar'"/> + </xsl:template match="/"/> + + +Al hacer clic con el ratón sobre una variable de la lista, se mostrará información resumida en la parte inferior del cuadro de diálogo. Si una variable tiene una expresión seleccionada, por ejemplo + +<xsl:variable name="changeable" select="'oldValue'" /> + + +se seleccionará un nuevo XPath introduciendo un valor nuevo para Expresión de variable y haciendo clic luego en el botón Definir expresión. + + +La solapa «Variables» + + + + +La solapa «Variables» +La solapa «Variables» + + + +Al hacer clic sobre una entrada de la variable en la lista que se muestra, el cursor de la ventana principal pasará al archivo y al número de línea indicado. + diff --git a/doc/es/kxsldbg/variables_window.png b/doc/es/kxsldbg/variables_window.png new file mode 100644 index 0000000..8e6a154 Binary files /dev/null and b/doc/es/kxsldbg/variables_window.png differ diff --git a/doc/es/kxsldbg/walk_window.png b/doc/es/kxsldbg/walk_window.png new file mode 100644 index 0000000..af36505 Binary files /dev/null and b/doc/es/kxsldbg/walk_window.png differ diff --git a/doc/es/kxsldbg/xsldbg_break.png b/doc/es/kxsldbg/xsldbg_break.png new file mode 100644 index 0000000..ac71547 Binary files /dev/null and b/doc/es/kxsldbg/xsldbg_break.png differ diff --git a/doc/es/kxsldbg/xsldbg_data.png b/doc/es/kxsldbg/xsldbg_data.png new file mode 100644 index 0000000..5144e39 Binary files /dev/null and b/doc/es/kxsldbg/xsldbg_data.png differ diff --git a/doc/es/kxsldbg/xsldbg_delete.png b/doc/es/kxsldbg/xsldbg_delete.png new file mode 100644 index 0000000..5539aba Binary files /dev/null and b/doc/es/kxsldbg/xsldbg_delete.png differ diff --git a/doc/es/kxsldbg/xsldbg_enable.png b/doc/es/kxsldbg/xsldbg_enable.png new file mode 100644 index 0000000..7813b86 Binary files /dev/null and b/doc/es/kxsldbg/xsldbg_enable.png differ diff --git a/doc/es/kxsldbg/xsldbg_output.png b/doc/es/kxsldbg/xsldbg_output.png new file mode 100644 index 0000000..7347ebf Binary files /dev/null and b/doc/es/kxsldbg/xsldbg_output.png differ diff --git a/doc/es/kxsldbg/xsldbg_refresh.png b/doc/es/kxsldbg/xsldbg_refresh.png new file mode 100644 index 0000000..b3cf38d Binary files /dev/null and b/doc/es/kxsldbg/xsldbg_refresh.png differ diff --git a/doc/es/kxsldbg/xsldbg_source.png b/doc/es/kxsldbg/xsldbg_source.png new file mode 100644 index 0000000..792252b Binary files /dev/null and b/doc/es/kxsldbg/xsldbg_source.png differ diff --git a/doc/es/kxsldbg/xsldbg_stepdown.png b/doc/es/kxsldbg/xsldbg_stepdown.png new file mode 100644 index 0000000..7173989 Binary files /dev/null and b/doc/es/kxsldbg/xsldbg_stepdown.png differ diff --git a/doc/es/kxsldbg/xsldbg_stepup.png b/doc/es/kxsldbg/xsldbg_stepup.png new file mode 100644 index 0000000..6d15801 Binary files /dev/null and b/doc/es/kxsldbg/xsldbg_stepup.png differ diff --git a/doc/es/xsldbg/commands.docbook b/doc/es/xsldbg/commands.docbook new file mode 100644 index 0000000..d98ec4e --- /dev/null +++ b/doc/es/xsldbg/commands.docbook @@ -0,0 +1,758 @@ + + +Referencia de comandos + +Addparam +Añade un parámetro libxslt ; equivalente a proporcionar --param <QNAME>:<XPATH> en la línea de órdenes. + +Uso de addparam + +addparam <QNAME> <XPATH>    (El <XPATH> no puede contener ni espacios ni comillas dobles). +addparam <QNAME> "<XPATH>"    (No debe contener comillas dobles en <XPATH>) + + +
+ + +Addwatch +Añade un observador para una expresión. Puede dirigirse a showwatch para obtener más información sobre la muestra de valores de watch. +Nombre para acceso rápido: watch +Uso de addwatch + +addwatch <XPATH> + + +
+ + +Base +Imprime la base de este nodo +Uso de base + + +base + + +
+ + +Break +Se detiene en la plantilla, en una ubicación de la hoja de estilos o en un archivo xml cargado por xsldbg, o en el nodo actual. Nuevo en xsldbg 3.1.4: en modo de compatibilidad con gdb, los puntos de interrupción huérfanos se pueden definir en un archivo específico y en un número de línea, y se puede resolver más tarde sobre uno activo. +Nombre para acceso rápido: bxsldbg intentará averiguar la URL completa, dado un nombre de archivo sin una ruta especificada. un archivo del mismo directorio que la hoja de estilos cargada «superior» un nombre de archivo relativo al directorio de trabajo actual de xsldbg Por ejemplo, si ha cargado un archivo de hoja de estilos de ../en/xsldoc.xsl, puede hacerlo con break -l xsldoc.xsl 26 Este comando hará coincidir con una plantilla QNAME parcial o completa y/o un nombre de modo proporcionado. Por ejemplo, «plantilla» se encajará con cualquier QNAME que tenga una parte local «template». Cualquier espacio de nombres que haya en el QNAME que se proporciona se expandirá como se indique en los espacios de nombres que estén definidos en el archivo fuente XSL. Por ejemplo, «xsl:test1» se expandirá como «http://www.w3.org/199/XSL/Transform:test1». Puede ser necesario que se resuelva un punto de introducción solicitado con su URL y número de línea asociados. Esto se hace automáticamente una vez que xsldbg ha visto la primera plantilla. Los puntos de interrupción se vuelven a validar poco después del comienzo de cada ejecución. La validación automática de puntos de interrupción se usa cuando está activado el modo gdb: el comportamiento predefinido de xsldbg. +Uso de break + + +break -l <FILENAME> <LINENO>    (Para definir el punto de interrupción en un archivo y número de línea específicos). +break -l <URI> <LINENO>    (Para definir el punto de interrupción en una URI y número de línea específicos). +break <TEMPLATE_NAME>    (Para detenerse en una plantilla nombrada o que coincida con la que se indica). +break <TEMPLATE_NAME> <MODE_NAME>    (Para detenerse en una plantilla en el modo indicado).> +break "" <MODE_NAME>    (Para detenerse en cualquier plantilla que tenga un nombre de modo indicado). +break *    (Para detenerse en cualquier plantilla que se encuentre). +break \*    (Para detenerse en la plantilla «*». No se dará un trato especial a otros nombres que incluyan «*»). +break     (Para poner el punto de interrupción en el nodo actual. Sí que se incluye en los nodos de datos xml.) + + +
+ + +Bye +Detiene el procesamiento de la hoja de estilos tan pronto como sea posible. +Uso de bye + + +bye + + +
+ + +Cat +Imprime el resultado de una expresión de xpath en el nodo relativo actual. +Uso de cat + + +Uso: cat <XPATH>    (Para ver una variable o un parámetro). +Usago: cat $<QNAME> + + +
+ + +Cd +Pasa a la ruta especificada en un xpath. +Uso de cd + + +<< = predecesor::nodo() +>> = sucesor::nodo() +<- = antepasado::nodo() +-> = descendiente::nodo() + +
+ + +Chdir +Pasa al directorio de trabajo +Uso de chdir + + +chdir <PATH>    (Una ruta relativa o absoluta para el sistema operativo). + + +
+ + +Continue +Continúa la ejecución de una hoja de estilos, deteniéndose en cualquier punto de interrupción que se encuentre. +Nombre para acceso rápido: c +Uso de continue + + +continue + + +
+ + +Data +Pasa a mostrar el nodo actual en los datos xml. O cambia los datos xml que se usan +Uso de data + + +data    (Pasa al nodo del documento actual). +data <DATA>    (Para pasar a un nuevo archivo de datos xml. Una «~» al comienzo se reemplaza por el valor de la variable de entorno $HOME. Se tendrá que usar el comando «run» para procesarlo). + + +
+ + +Delete +Elimina un punto de interrupción de la plantilla +Nombre para acceso rápido: c +Uso de delete + + +delete    (Para eliminar un punto de interrupción del nodo actual). +delete <ID_PUNTOINT>    (Para eliminar un punto de interrupción, conocido el número específico del punto de interrupción). +delete -l <NOMBREARCH> <NUMLINEA>    (Elimina el punto de interrupción del número de línea y archivo especificados). +delete -l <URI> <NUMLINEA>    (Elimina el punto de interrupción del número de línea y la URI especificados). +delete <NOMBREPLANTILLA>    (Para eliminar un punto de interrupción de la plantilla que se indica). +delete *    (Para eliminar todos los puntos de interrupción). + + +
+ + +Delparam +Elimina un parámetro de libxslt +Uso de delparam + + +delparam    (Elimina todos los parámetros presentes). +delparam <ID_PARAM> + + +
+ + +Delwatch +Elimina la observación de una expresión o elimina todas las expresiones observadas que se muestran en el comando «showwatch». +Uso de delwatch + + +delwatch <IDOBSERV>    (Elimina la observación de una expresión, con un id. dado). +delwatch *    (Elimina las observaciones de todas las variables). + + +
+ + +Dir +Muestra la lista de nodos de forma similar a como lo hace el comando «dir» en la shell. + +Uso de dir + + +dir + + +
+ + +Disable +Inactiva un punto de interrupción +Uso de disable + + +disable    (Para desactivar un punto de interrupción en el nodo actual). +disable <ID_PUNTOINT>    (Para inactivar un punto de interrupción con un número específico). +disable -l <NOMBREARCH> <NUMLINEA>    (Inactiva el punto de interrupción del archivo y número de línea que se indique). +disable -l <URI> <NUMLINEA>    (Inactiva el punto de interrupción de la URI y el número de línea que se indique). + + +
+ + +Du +Muestra un resumen de los nodos hijo en formato de árbol. +Uso de du + + +du + + +
+ + +Dump +Volcado de los detalles internos de este nodo +Uso de dump + + +dump + + +
+ + +Enable +Activa o inactiva un punto de interrupción (alterna entre activar e inactivar). +Nombre para acceso rápido: e +Uso de enable + + +enable    (Para activar o inactivar un punto de interrupción en el nodo actual). +enable <ID_PUNTOINT>    (Para activar o inactivar un punto de interrupción, estando especificado el número del punto). +enable -l <NOMBREARCH> <NUMLINEAO>    (Activa o inactiva el punto de interrupción en el archivo y número de línea que se indica). +enable -l <URI> <NUMLINEA>    (Activa o inactiva el punto de interrupción que hay en la URI y el número de línea que se indica). + + +
+ + +Entities +Muestra la lista de entidades externas generales analizadas que se han usado en el archivo de datos (documento). +Nombre para acceso rápido: ent +Uso de entities + + +entities + + +
+ + +Exit +Detiene el procesamiento de la hoja de estilos tan pronto como sea posible. +Uso de exit + + +exit + + +
+ + +Frame +Muestra el marco de pila con la profundidad indicada. +Nombre para acceso rápido: f +Uso de frame + + +frame <PROFUND_MARCO>    (La profundidad es un número de 0 a la profundidad actual de la pila de llamadas). + + +
+ + +Free +Libera la hoja de estilos y los datos (si está inactivo, vea lo que se dice de run) +Uso de free + + +free + + +
+ + +Globals +Muestra una lista de las variables o parámetros de la hoja de estilos globales. Muestra el valor de una variable global. +Uso de globals + + +globals    (Muestra la lista de todas las variables globales que hay disponibles). +globals -f    (Muestra la lista de todas las variables globales que hay disponibles y de sus valores). +globals <QNOMBRE>    (Muestra el valor de la variable indicada). + + +
+ + +Help +Muestra ayuda genérica o sobre el comando +Nombre para acceso rápido: h +Uso de help + + +help     (Muestra una visión general del producto). +help <COMANDO>     (Muestra ayuda sobre un comando). + + +
+ + +Load +Carga desde disco las opciones de xsldbg y las preferencias del usuario. +Uso de load + + +load + + +
+ + +Locals +Muestra una lista con las variables o parámetros locales de la hoja de estilos. Muestra el valor de una variable local. +Uso de locals + + +locals    (Muestra una lista con todas las variables disponibles localmente). +locals -f    (Muestra una lista con todas las variables locales que hay disponibles y con sus valores). +locals <QNOMBRE>    (Muestra el valor de la variable especificada). + + +
+ + +Ls +Lista de nodos en formato breve. +Uso de ls + + +ls + + +
+ + +Next +Evita una llamada a plantilla xsl (xsl:call-template) o una aplicación de plantilla xsl (xsl:apply-templates). Este comando tiene el mismo efecto que introducir los comando «step» y luego «up». +Nombre para acceso rápido: n +Uso de next + + +next    (seguir a la siguiente instrucción emparentada). + + +
+ + +Options +Muestra los valores de las opciones de xsldbg. +Uso de options + + +options + + +
+ + +Output +Especifica un archivo local y en el que se puede escribir, para mandar allí los resultados. +Nombre para acceso rápido: o +Uso de output + + +output <NOMBREARCH>    (El nombre de un archivo local en el que se puede escribir. Puede contener el prefijo «~» en las plataformas *nix y CYGWIN, o variables de entorno en RISC OS). +output <URI>    (La <URI> sólo debe puede usar el protocolo «file://». Esa URI se convierte a un nombre de archivo adecuado para el sistema operativo). +output -    (Envía a la salida estándar. Sólo se debe usar cuando se esté usando xsldbg desde la línea de órdenes). + + +
+ + +Public +Muestra el valor al que está mapeado un id. público según el catálogo actual. +Nombre para el acceso rápido: pub +Uso de public + + +public "<IDPublico>" + + +
+ + +Pwd +Muestra el directorio de trabajo actual. +Uso de pwd + + +pwd + + +
+ + +Quit +Detiene el procesamiento de la hoja de estilos tan pronto como sea posible. +Nombre para acceso rápido: q +Uso de quit + + +quit + + +
+ + +Run +Reinicia la hoja de estilos. +Nombre para acceso rápido: r +Uso de run + + +run + + +
+ + +Save +Guarda en disco las opciones de xsldbg y las preferencias del usuario. +Uso de save + + +save + + +
+ + +Search +Busca en una base de datos con toda la información recogida de la hojas de estilos cargadas +Todos los archivos de salida se almacenan donde indique el valor de la opción «searchresultpath», si está definida, o en el mismo directorio que la hoja de estilos. searchresults.xml se suele transformar en search.xsl, pero se transformará usando searchhtml.xsl, si está definida la opción «prefrehtml». Cuando el comando «search» se hace funcionar, se crea un archivo (searchresults.xml). Luego puede procesar este archivo con su propia hoja de estilos para presentar los datos de otras maneras. Si no está definida la opción «preferhtml», se mostrará en pantalla «searchresult.txt». Según la cantidad de datos que se haya recogido, puede llevar cierto tiempo la finalización de este comando. +Uso de search + + +search <XPATH>    (Puede ver qué xpath se puede usar en search.dtd. El <XPATH> predefinido es «//search/*».) +search -sort <XPATH>    (Le dice a search.xsl que ordene el resultado antes de mostrarlo en la salida). + + +
+ + +Set +Define el valor de una variable. +Uso de set + + +set <NOMBRE_VARIABLE> <XPATH> + + +
+ + +Setoption +Define una opción para la ejecución de una hoja de estilos. +Tiene que usar el comando «run» para activar los cambios. +Uso de setoption + + +setoption <NOMBRE_OPCION> <VALOR_ENTERO> +Donde <NOMBRE_OPCION> puede ser o bien + + + + + debug    (Si <VALOR_ENTERO> es cierto, se vuelca el árbol del resultado en su lugar). + catalogs    (Si <VALOR_ENTERO> es cierto, usa los catálogos de $SGML_CATALOG_FILES o SGML$CatalogFiles para el sistema operativo risc). + html    (Si <VALOR_ENTERO> es cierto, el documento de entrada es un archivo HTML). + docbook    (Si <VALOR_ENTERO> es cierto y la biblioteca libxml lo admite, el documento de entrada en un docbook de SGML). + xinclude    (Si <VALOR_ENTERO> es cierto, usa el procesamiento XInclude para el documento input). + preferhtml    (Si <VALOR_ENTERO> es cierto, se prefiere la salida html para los resultados de «search». : Puede ver el comando «search»). + autoencode    (Si <VALOR_ENTERO> es cierto, se intenta usar la codificación de la hoja de estilos.) + utf8input    (Si <VALOR_ENTERO> es cierto, toda la salida del usuario se hace en UTF-8. Se suele usar cuando xsldbg se hace funcionar como hilo). +      + gdb    (Ejecuta gdb en modo de compatibilidad). + Para un valor de 1, significa + Mostrar muchos más mensajes. Aumenta la frecuencia, mostrando «Punto de interrupción en...» + En la mayoría de líneas de GDB_LINES_TO_PRINT se mostrarán cuando se estén evaluando expresiones, seguidas de «...». Puede cambiar este valor en options.h. De forma predefinida, son tres líneas de texto. + Tanto las locales como las globales se mostrarán cuando se haga funcionar el comando «locals». + Al mostrar las expresiones con cat/print. El valor evaluado se precederá con «= » < EXPRESION > + + + + + + Para un valor de 2, significa Mostrar los mensajes que necesite KDbg, así como el estado de la salida de arriba (cuando el valor es 1). + + + + + + + + + nonet    (Si <VALOR_ENTERO> es cierto, rechaza obtener las DTDs de las entidades por la red). + novalid    (Si <VALOR_ENTERO> es cierto, evita la fase de carga de la DTD). + repeat    (Si <VALOR_ENTERO> es cierto, se hace funcionar la transformación 20 veces). + profile    (Si <VALOR_ENTERO> es cierto, se vuelca información sobre perfiles). + timing    (Si <VALOR_ENTERO> es cierto, se muestra el tiempo que se emplea). + noout    (Si <VALOR_ENTERO> es cierto, no se vuelca el resultado). + + + + +Donde el valor es cierto si NO es igual a cero. +Donde el valor es falso, SI ES igual a cero. +stdout    Muestra todos los mensajes de error en la salida estándar (stdout). Normalmente, los mensajes de error van a la salida de error (stderr). +setoption <NOMBRE_OPCION> "<VALOR_DE_CADENA>"    (No debe contener comillas dobles dentro de <VALOR_DE_CADENA>). +setoption <NOMBRE_DE_OPCION> <VALOR_DE_CADENA>    (No debe contener ningún espacio ni comillas dobles en <VALOR_DE_CADENA>). +Donde <NOMBRE_OPCION> puede ser o bien + + + + + data    (La URI del archivo de datos). + source    (La URI del archivo de origen). + output    (El id. del sistema del archivo de salida). + docspath    (Ruta para usar al buscar documentación). + catalognames    (Los nombres de los catálogos que se usan cuando la opción catalogs está definida. El valor se pierde si se define antes de definir la opción catalogs). + encoding    (Qué codificación usar para la salida estándar). + searchresultspath    Qué ruta se va a usar para almacenar el resultado de la búsqueda. Si no está definido, xsldbg usará la ruta de la hoja de estilos. + + + + + +
+ + +Shell +Ejecuta un comando en la shell +Uso de shell + + +shell <TEXTO>    (<TEXTO> es el texto que se pasa al sistema operativo para que lo ejecute). + + +
+ + +Showbreak +Para mostrar la lista de puntos de interrupción de la plantilla. +Nombre para acceso rápido: showSi existe un modo en el punto de interrupción de la plantilla, se añadirá al final del nombre de la plantilla para el punto de interrupción. Ejemplo de la salida: +Punto de interrupción 3 activado para la plantilla «*» en la línea 105 del archivo test1.xsl. +Punto de interrupción 2 activado para la plantilla «* testMode» en la línea 109 del archivo test1.xsl. +Punto de interrupción 1 activado para la plantilla «* http://www.w3.org/1999/XSL/Transform:testMode» en la línea 113 del archivo test1.xsl. + +En total hay 3 puntos de interrupción. + +Uso de showbreak + + +showbreak + + +
+ + +Showparam +Muestra la lista de parámetros presentes en libxslt. +Uso de showparam + + +showparam + + +
+ + +Showwatch +Muestra la expresión que se está observando en este momento. +Nombre para acceso rápido: watches +Uso de showwatch + + +showwatch    (Muestra las variables que se están observando en este momento y sus valores). +showwatch 1    (Activa la muestra automática de las expresiones que se están observando. Es lo que se usa de forma predefinida). +showwatch 0    (Desactiva la muestra automática de las expresiones que se están observando). + + +
+ + +Source +Pasa a mostrar el nodo actual de la hoja de estilos. O cambia la hoja de estilos que se está usando. +Uso de source + + +source    (Pasa al nodo actual de la hoja de estilos). +source <FUENTE>    (Para pasar a un nuevo archivo fuente. El «~» del comienzo se reemplaza por el valor de la variable de entorno $HOME. Se tiene que usar el comando «run» para ejecutarlo). + + +
+ + +Step +Avanza hasta la siguiente instrucción de la hoja de estilos. +Nombre para acceso rápido: s +Uso de step + + +step + + +
+ + +Stepdown +Retrocede hasta un «marco de llamada» más reciente. +Nombre para acceso rápido: down +Uso de stepdown + + +stepdown     (retrocede un marco). +stepdown <NUMERO_DE_MARCOS>    (retrocede el número de marcos que se le indique). + + +
+ + +Stepup +Avanza a un «marco de llamada» anterior. +Nombre para acceso rápido: upNo es un comando preciso. xsldbg se detendrá tan pronto como pueda. +Uso de stepup + + +stepup     (avanza un marco). +stepup <NUMERO_DE_MARCOS>     (avanza el número de marcos que se le indique). + + +
+ + +Stylesheets +Muestra una lista de las hojas de estilos que están cargadas. +Nombre para acceso rápido: style +Uso de stylesheets + + +stylesheets + + +
+ + + +System +Muestra el valor con el que se mapea el archivo de sistema por medio del catálogo actual +Nombre para acceso rápido: sys +Uso de system + + +system "<id. sistema>" + + +
+ + +Templates +Muestra la lista de las plantillas disponibles. Busca una plantilla. +Nombre para acceso rápido: t +Uso de templates + + +templates +templates <PLANTILLA>    (Muestra detalles de la plantilla llamada <PLANTILLA>, si es que existe). + + +
+ + +Trace +Traza una ejecución de la hoja de estilo, mostrando el archivo y las líneas de los pasos intermedios. +Uso de trace + + +trace + + +
+ + +Tty +Abre un terminal. Define el nivel de la redirección de tty. +Uso de tty + + +tty <RUTA_DISPOSITIVO>    (Donde <RUTA_DISPOSITIVO> es un terminal válido del sistema operativo. Sólo intenta abrir el terminal. +tty <NIVEL_TTY>    (Define el nivel de la redirección de tty, donde <NIVEL_TTY> es un nivel válido de entrada/salida que se va a usar). + Donde el nivel es + 0 = Entrada/salida predefinida + 1 = Salida por terminal de los resultados de la transformación, siguiendo la traza y avanzando    (El estado predefinido cuando se ha abierto el dispositivo tty. Aún no está implementado por completo). + 2 = Redirección completa al terminal    (Aún no implementado). + Se asume que todos los demás valores enteros son el nivel 0. + + + + + + +
+ + +Validate +Valida el archivo de salida que genera la hoja de estilos (desactivado). +Uso de validate + + +validate + + +
+ + +Walk +Avanza a través del código, usando un rango de velocidades. +Uso de walk + + +walk <VELOCIDAD>    (Use Ctrl-c para detener la ejecución, <VELOCIDAD> es un valor entre 0 y 9, donde 0 significa detenido 1 es muy rápido y 9 es muy lento). + + +
+ + +Where +Muestra una traza de las llamadas de las plantillas (pila del marco) y muestra el directorio de trabajo. +Nombre para acceso rápido: w +Uso de where + + +where + + +
+ + +Write +Por terminar. +Uso de write + + +write + + +
+ + + + + + + diff --git a/doc/es/xsldbg/credits.docbook b/doc/es/xsldbg/credits.docbook new file mode 100644 index 0000000..5600cce --- /dev/null +++ b/doc/es/xsldbg/credits.docbook @@ -0,0 +1,14 @@ + + +Créditos y licencia + +&xsldbg; +Copyright del programa 2004 Keith Isdale k_isdale tpg com au + +Juan Manuel García Molinajuanma@superiodico.net +&underFDL; &underGPL; +Gracias a +Los autores de libxml y libxsl. +Johannes Sixt, por su ayuda para añadir soporte xsldbg en KDbg. + + diff --git a/doc/es/xsldbg/index.docbook b/doc/es/xsldbg/index.docbook new file mode 100644 index 0000000..cdb6ec3 --- /dev/null +++ b/doc/es/xsldbg/index.docbook @@ -0,0 +1,96 @@ + +xsldbg"> + + + + + + + + +]> + + + + + + + + + + + +El manual de &xsldbg; + + +Keith Isdale
k_isdale@tpg.com.au
+ + + +Juan Manuel García Molina
juanma@superiodico.net
Traductor + + + + +2002 +2003 +Keith Isdale + + +&FDLNotice; +2004-09-26 +1.01.00 + + + + es un&xsldbg;a herramienta pensada para ayudarle a comprender las hojas de estilo. Lo que la hace diferente de otros depuradores de hojas de estilo es la capacidad de buscar elementos de interés y poder seguir una traza de la ejecución de la hoja de estilos. + + + +KDE +tdeutils +xsldbg +xsl +XML + + + + +&introduction-chapter; +&usage-chapter; +&commands-chapter; +&credits-chapter; + + + +Instalación + + +Cómo obtener &xsldbg; + +Puede ver el componente kxsldbg del módulo tdewebdev en el SVN de &kde;. +&install.intro.documentation; + + +Requisitos + +Para usar correctamente &xsldbg;, necesita que &kde; libxslt, libexslt y libxml estén instalados. Suelen estar disponibles en una instalación típica de &kde;. + + + +Compilación e instalación +&xsldbg; se suele compilar como parte del componente kxsldbg, en el módulo tdewebdev. + + + +Configuración + +&xsldbg; se configura usando argumentos que se pasan en la línea de órdenes y con el comando setoption. + + + + + +&documentation.index; + diff --git a/doc/es/xsldbg/introduction.docbook b/doc/es/xsldbg/introduction.docbook new file mode 100644 index 0000000..439796e --- /dev/null +++ b/doc/es/xsldbg/introduction.docbook @@ -0,0 +1,16 @@ + + +Introducción + +&xsldbg; es una herramienta textual para depurar hojas de estilos (el eXtensible Stylesheet Language, lenguaje de hoja de estilo extensible) y tiene comandos similares al depurador de Unix/Linux gdb. Tiene tres modos principales de ejecución de hojas de estilos. + + + + Ejecutar toda la hoja de estilos. + Pasar a la siguiente instrucción xsl. + Continuar hasta que se encuentre el siguiente punto de interrupción, o se reinicie la hoja de estilos. + + + + + diff --git a/doc/es/xsldbg/usage.docbook b/doc/es/xsldbg/usage.docbook new file mode 100644 index 0000000..4a49084 --- /dev/null +++ b/doc/es/xsldbg/usage.docbook @@ -0,0 +1,62 @@ + + +Usar &xsldbg; + +Argumentos del comando xsldbg +En sistemas que tengan la biblioteca readline, puede usar las techas atrás y adelante para navegar por el histórico de los comandos que se han introducido. En todos los sistemas, se puede repetir el último comando que se ha introducido simplemente pulsando la tecla <ENTER>. +Si su sistema operativo lo admite, los nombres de archivos se expandirán. +Algunos comandos llevan más de un argumento. Se pueden usar comillas dobles para evitar que las expresiones complejas se traten como un argumento. Por ejemplo, "* | @" le permitiría definir un punto de interrupción en la plantilla que se llama "* | @" + + +Leyenda de los términos +La tabla siguiente describe los términos que se usan en la subsiguiente guía de comandos. + + + NOMBRE_PLANTILLA: Un nombre de plantilla válido sólo contiene carácteres ASCII con los códigos desde el 0x00 hasta el 0x7F. Y puede ser un nombre plenamente cualificado, por ejemplo«xsl:NombrePlantilla». + NOMBREARCHIVO: Un nombre de archivo local válido para el sistema del usuario. Puede tener un prefijo «~» en las plataformas *nix y CYGWIN. O las variables de entorno disponibles en RISC OS. + URI : Un Uniform Resource Identifier (Identificador de Recurso Uniforme), tal y como se define en el RFC 2396. + NOMBRE_MODO: El modo de la plantilla, que puede ser un nombre plenamente cualificado, por ejemplo «xsl:nombreModo». + QNOMBRE: Un nombre plenamente cualificado, por ejemplo «xsl:parteLocal». + NUMLINEA: Un número de línea válido en el <NOMBREARCH> asociado. + NUMERO_DE_MARCOS: Un marco de número de líneas válido con el que cambiar la posición. + ID_PUNTOINT: Un número de punto de interrupción válido. + ID_OBSERV: Un número de expresión de observador válido, tal y como indica el comando showwatch. + VELOCIDAD: velocidad de avance a través del código, entre 0 y 9. +     (Comentario): un comentario sobre el significado o la utilización de un comando. + { opc1 | opc2 | opc2 .. etc}: Elegir una de las opciones. + XPATH: una selección de nodos de xpath + ID_PARAM: un número de parámetro válido, tal y como se indica para el comando showparam + RUTA: Una ruta a la que pasar el directorio de trabajo. En algunos sistemas operativos, el prefijo «~» se reemplaza por la ruta del directorio personal. + TEXTO: Texto de formato libre     (sin restricciones). + COMANDO: Un comando válido para xsdbg. + QNOMBRE: Un nombre válido para una variable o un parámetro. + ORIGEN: La hoja de estilos que se va a ejecutar. Puede ver la leyenda para <NOMBREARCH> y <URI>. + DATA: El (documento) de datos xml que va a procesar la hoja de estilos. Puede ver la leyenda para <NOMBREARCH> y <URI>. + RUTA_DISPOSITIVO: Es un terminal válido para el sistema operativo. + NIVEL_TTY: Es un nivel de entrada/salida válido que se va a usar. + + + + +Vistazo general a los comandos disponibles + + +Relativos a la ayuda: help +Relativos a la ejecución: {bye|exit| quit}, step, stepup, stepdown, next, continue, run, trace, setoption, options +Relativos a los parámetros d elibxslt: addparam, delparam, showparam, output, setoption, options +Relacionados con las plantillas: templates, where, frame +Relacionados con los puntos de interrupción: break, showbreak, delete, enable +Ver la expresión(xpath): cat +Vista de nodos: ls, dir, du, cat, pwd +Vista de variables: globals, locals, cat, addwatch +Definición de variables: set +Selección de nodos: source, data, cd +Búsqueda: search +Relacionados con el sistema operativo: chdir, shell, tty +Relacionados con el archivo: output, entities, system, public +Comandos desactivados de archivos: validate, load, save, write, free + + + + + diff --git a/doc/et/kxsldbg/callstack.docbook b/doc/et/kxsldbg/callstack.docbook new file mode 100644 index 0000000..97b97dd --- /dev/null +++ b/doc/et/kxsldbg/callstack.docbook @@ -0,0 +1,28 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +MarekLaane
bald@online.ee
Tõlge eesti keelde + + + +Väljakutsete pinu kasutamine + +Siin on ära toodud kõik väljakutsete pinu elemendid. Mida vanem on väljakutsete pinu kirje, seda väiksem on tema raami number. Vaata allpool toodud näidet. + + +Väljakutsete pinu aken + + + + +Väljakutsete pinu aken + + + +Klõps nimekirjas oleval väljakutsete pinu kirjel viib kursori peaaknas osutatud faili ja reanumbrile. + + diff --git a/doc/et/kxsldbg/credits.docbook b/doc/et/kxsldbg/credits.docbook new file mode 100644 index 0000000..7f3b1bd --- /dev/null +++ b/doc/et/kxsldbg/credits.docbook @@ -0,0 +1,29 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +MarekLaane
bald@online.ee
Tõlge eesti keelde + + +Autorid ja litsents + +&kxsldbg; © 2004: Keith Isdale +Dokumentatsiooni © 2004: Keith Isdale + + + +Tänud: + +libxml ja libxslt autorid. + + +Robert Jacolin tagasiside eest &kxsldbg; varaste versioonide kohta. + + +Igor Zlatkovic libxml/xslt ja &xsldbg; WIN32 binaarfailide loomise eest. + + +&underFDL; &underGPL; diff --git a/doc/et/kxsldbg/entities.docbook b/doc/et/kxsldbg/entities.docbook new file mode 100644 index 0000000..fb7d648 --- /dev/null +++ b/doc/et/kxsldbg/entities.docbook @@ -0,0 +1,28 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +MarekLaane
bald@online.ee
Tõlge eesti keelde + + +&XML; andmefailide (olemite) kasutamine + +Kui inspektori dialoogi ei ole näha, kasuta menüükäsku Tööriistad Näita inspektoreid . Olemite kasutamiseks klõpsa dialoogis kaardile Olemid. + +Siin on ära toodud kõik andmefaili või selle järglaste kaudu teada olevad välised &XML; olemid. Antud näites olen lasknud &kxsldbg;-l faili testdoc.xsl analüüsida failiga testdoc.xml (need leiab kataloogist <KDE PREFIX>/share/apps/kxsldbg), mis pakub mõningaid olemeid. + + +Olemite aken + + + + +Olemite aken + + + +Klõps nimekirjas oleval olemi kirjel põhjustab kursori liikumise peaaknas osutatud faili algusse. + diff --git a/doc/et/kxsldbg/glossary.docbook b/doc/et/kxsldbg/glossary.docbook new file mode 100644 index 0000000..8da2d2c --- /dev/null +++ b/doc/et/kxsldbg/glossary.docbook @@ -0,0 +1,35 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +MarekLaane
bald@online.ee
Tõlge eesti keelde + + + + +Võtmesõnad + +&xsldbg; + +Vaata . + + + + +XPath + +Kehtiv avaldis, mis määrab, millised andmed on nõutavad. Vaata W3C veebilehekülge + + + + +QName + +Täielikult kvalifitseeritud nimi. Näiteks xsl:myvariable. Vaata W3C veebilehekülge + + + + diff --git a/doc/et/kxsldbg/index.docbook b/doc/et/kxsldbg/index.docbook new file mode 100644 index 0000000..6c81121 --- /dev/null +++ b/doc/et/kxsldbg/index.docbook @@ -0,0 +1,112 @@ + +KXSLDbg"> + + + + + + + + + + + + + + + xsldbg"> + DTD"> + XSD"> + XSLT"> +]> + + + + +&kxsldbg; käsiraamat + + +Keith Isdale
k_isdale@tpg.com.au
+ + + +Marek Laane
bald@starman.ee
Tõlge eesti keelde + + + + +2002 +2003 +2004 +Keith Isdale + + +&FDLNotice; +2004-11-18 +0.5 + + +&kxsldbg; kujutab endast &xsldbg; graafilist kasutajaliidest, mis toetab &XSLT; skriptide silumist. + + + +KDE +xsldbg +libxslt +silur + + + + +Sissejuhatus + + +Võimalused + +&kxsldbg; abil saab tarvitada enamikku &xsldbg; käske, mis teeb võimalikuks + +Katkestuspunktide määramise ja muutmise + + +XPath-ide väärtuse näitamise + + +Info näitamise leitud mallide, muutujate, väljakutsete pinu, laaditabelite ja olemite kohta + + +Katkestuspunktide ja muutujate määramise ja muutmise + + +&XSL; allika ja &XML; dokumendi liigutamise XPath-i abil + + +PUBLIC ja SYSTEM ID otsimise parajasti aktiivses &XML; kataloogis + + + + + + +Uuemad omadused +&kxsldbg; suudab nüüd + + +määrata ja muuta muutujaid + + +renderdada teksti peaaknas &kate; teeke ära kasutades + + + + + + + + +kxsldbg; kasutamine +&configure-section; &mainwindow-section; &inspector-section; &variables; &callstack; &templates; &sources; &entities; &tools-section; + +&credits-chapter; + + diff --git a/doc/et/kxsldbg/kxsldbg_configure.docbook b/doc/et/kxsldbg/kxsldbg_configure.docbook new file mode 100644 index 0000000..f87d1d6 --- /dev/null +++ b/doc/et/kxsldbg/kxsldbg_configure.docbook @@ -0,0 +1,67 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +MarekLaane
bald@online.ee
Tõlge eesti keelde + + + +&kxsldbg; seansi seadistamine + +Seadistamise käivitab menüükäsk Silumine Seadista . + + +Seadistustedialoog + + + + +Seadistustedialoog +Seadistustedialoog. + + + + +Alustamine + +Laaditabeli kasutamiseks tuleb määrata: +&XSL; allikas +&XML; andmed +Väljundfail + + + +Nupp ... võimaldab valida vajaliku faili. Väljad &XSL; allikas ja >&XML; andmed võivad viidata URI-le, milles võib esineda http://, ftp:// või file://. Väljundfail peab kindlasti olema kirjutamisõigusega kohalik fail. +Asja näitlikustamiseks valime nüüd järgmised failid kataloogis <KDE PREFIX>/share/apps/kxsldbg: +&XSL; allikas: testdoc.xsl +&XML; andmed: testdoc.xml +Väljundfail: /tmp/xsldbg_output.txt + + + + + +Valikute kasutamine + +Valikud võimaldab valida null või enam võtit. Iga võtme juures võid näha kohtspikrit, mis kirjeldab selle toimet. + + + +Parameetrite kasutamine + +Dialoogi sektsioonis Libxslt parameetrid saab lisada null või enam parameetrit. See lubab pakkuda laaditabelile parameetrite väärtusi. + +Näiteks võid sisestada Parameetri nimena myparam, anda Parameetri väärtuseks 'Tere, maailm!' ning klõpsata nupule Lisa. Olemasoleva parameetri värskendamiseks liigu lihtsalt vajalikule väärtusele nuppudega Eelmine või Järgmine, anna uus Parameetri väärtus ning klõpsa nupule Rakenda. + + + +Muudatuste rakendamine + +Kui soovid, et tehtud muudatused ellu rakendataks, klõpsa nupule Rakenda. Muudatuste ignoreerimiseks klõpsa nupule Loobu. + +Dialoogi saab sulgeda akna ülal paremal nurgas asuvat ikooni X kasutades. Kui tahad seadistust muuta, ava lihtsalt seadistustedialoog uuesti (seda kirjeldasime eespool). + + diff --git a/doc/et/kxsldbg/kxsldbg_inspector.docbook b/doc/et/kxsldbg/kxsldbg_inspector.docbook new file mode 100644 index 0000000..520d55e --- /dev/null +++ b/doc/et/kxsldbg/kxsldbg_inspector.docbook @@ -0,0 +1,71 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +MarekLaane
bald@online.ee
Tõlge eesti keelde + + +Katkestuspunktide seadmine ja muutmine + +Põhiliselt saab katkestuspunktidega tegelda peaaknas. Vaata + +Kui laaditabel on käivitatud, saab kasutada menüükäsku Tööriistad Näita inspektoreid . Seejärel klõpsa katkestuspunktide kaardile, mida näitame allpool. + + +Katkestuspunktide määramine + + + + +Katkestuspunktide määramine + + + + +Katkestuspunkti lisamine + +Katkestuspunkti saab lisada, kui anda: + +fail ja reanumber + +malli nimi + +malli nimi ja režiimi nimi + +režiimi nimi + + + + +Ja seejärel klõpsata nupule Lisa. + + + +Argumendi üksikasjad + +Faili nimi võib olla kohaliku faili absoluutne asukoht või ka osaline fail (⪚ xsldoc.xsl). + +Malli või režiimi nimi on täielikult kvalifitseeritud nimi, kus mittelokaalne osa pole kohustuslik, ⪚ xsl:mytemplate korral on sobivuseks mytemplate + + + +Katkestuspunkti kustutamine + +Esmalt klõpsa katkestuspunktide nimekirjas katkestuspunktile, mida soovid kustutada, ning seejärel nupule Kustuta. + + + +Kõigi katkestuspunktide kustutamine + +Klõpsa nupule Kustuta kõik. + + + +Katkestuspunkti lubamine või keelamine + +Esmalt klõpsa katkestuspunktide nimekirjas &HVN;ga katkestuspunktile, mida soovid muuta, ning seejärel nupule Luba. + + diff --git a/doc/et/kxsldbg/kxsldbg_mainwindow.docbook b/doc/et/kxsldbg/kxsldbg_mainwindow.docbook new file mode 100644 index 0000000..2da9298 --- /dev/null +++ b/doc/et/kxsldbg/kxsldbg_mainwindow.docbook @@ -0,0 +1,443 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +MarekLaane
bald@online.ee
Tõlge eesti keelde + + +Peaakna kasutamine + + +Peaaken + + + + +Tekstivaade aktiivse faili silumisel +Tekstivaade aktiivse faili silumisel. + + + + +Töö peaaknas + +Iga katkestuspunkti olekut näitab vastav tekst ning erinev taustavärv. Sul on võimalik värvid ise määrata: vaata dialoogi SeadistusedRedaktori seadistamine kaarti Värvid. + + +Katkestuspunkti saab seada/keelata/kustutada klahvidega, menüüst Silumine või tööriistariba nuppudega. + +Kursorit saab tekstis liigutada järgmiste klahvidega: + + +Nooleklahvid: Nool vasakule, Nool paremale, Nool üles või Nool alla. +Leheküljeklahvid: Page Up või Page Down + + + + + + +&kxsldbg; väljundi kasutamine + +Enamik &kxsldbg; väljundist haaratakse ja näidatakse kas inspektorite dialoogis või &kxsldbg; väljundiaknas. Erandiks on: + + +&kxsldbg; veateadet näidatakse teatedialoogis. + + +Avaldise hindamise tulemust näidatakse teatedialoogis. + + +Otsingutulemus saadetakse &kxsldbg; väljundiaknas osutatud failile. + + + + + + + + diff --git a/doc/et/kxsldbg/kxsldbg_tools.docbook b/doc/et/kxsldbg/kxsldbg_tools.docbook new file mode 100644 index 0000000..1cfbde7 --- /dev/null +++ b/doc/et/kxsldbg/kxsldbg_tools.docbook @@ -0,0 +1,77 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +MarekLaane
bald@online.ee
Tõlge eesti keelde + + + +Mitmesugused tööriistad + +Tööriistade menüü pakub mitmesuguseid tööriistu, millest peamine on inspekteerimisvahend. + + +Inspekteerimisvahend + +Inspektor sisaldab mitmeid kaarte: + +Katkestuspunktid +Mallid +Muutujad +Väljakutsete pinu kirjed +&XSL; allikafailid +&XML; olemid + + + + + +Laaditabeli läbimine + +Menüükäsu Alusta laaditabeli läbimist valimisel ilmub dialoog, kus saab valida läbimise kiiruse. + + +Läbimise aken + + + + +Läbimise aken + + + +Läbimise peatamiseks kasuta klahvi W või vali menüükäsk Lõpeta laaditabeli läbimine. + + + +&XML; olemite otsimine + +System ID otsimiseks aktiivses &XML; kataloogis kasuta menüükäsku System ID otsing ning sisesta siis ilmuvas dialoogis väärtus, mida soovid leida. + + +System ID aken + + + + +System ID aken + + + +Public ID otsimiseks kasuta menüükäsku Public ID otsing ning sisesta siis ilmuvas dialoogis väärtus, mida soovid leida. + + +Public ID aken + + + + +Public ID aken + + + + + diff --git a/doc/et/kxsldbg/sources.docbook b/doc/et/kxsldbg/sources.docbook new file mode 100644 index 0000000..b26726c --- /dev/null +++ b/doc/et/kxsldbg/sources.docbook @@ -0,0 +1,27 @@ + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +MarekLaane
bald@online.ee
Tõlge eesti keelde + + +&XSLT; allikafailide (lähteteksti) kasutamine + +Kui inspektori dialoogi ei ole näha, kasuta menüükäsku Tööriistad Näita inspektoreid . Allikafailide kasutamiseks klõpsa dialoogis vastavale kaardile. + +Siin on näha kõik &XSLT; faili või mõnesse selle järglasse kaasatud &XSLT; allikafailid. + + +Allikafailide aken + + + + +Allikafailide aken + + + +Klõps nimekirjas oleval allikafaili kirjel põhjustab kursori liikumise peaaknas osutatud faili algusse. + diff --git a/doc/et/kxsldbg/templates.docbook b/doc/et/kxsldbg/templates.docbook new file mode 100644 index 0000000..7123696 --- /dev/null +++ b/doc/et/kxsldbg/templates.docbook @@ -0,0 +1,20 @@ + +Mallide kasutamine + +Kui inspektori dialoogi ei ole näha, kasuta menüükäsku Tööriistad Näita inspektoreid . Mallide kasutamiseks klõpsa dialoogis vastavale kaardile. + +Siin on ära toodud kõik mallid. Palun arvesta, et kehtivad &XSLT; ekspordireeglid, nii et nimekirjas võib olla enam kui üks mall ühesuguste sobivuste ja režiimiga. + + +Mallide aken + + + + +Mallide aken + + + +Klõps nimekirjas oleval mallikirjel põhjustab kursori liikumise peaaknas osutatud faili ja reanumbrile. + + diff --git a/doc/et/kxsldbg/variables.docbook b/doc/et/kxsldbg/variables.docbook new file mode 100644 index 0000000..44f84d1 --- /dev/null +++ b/doc/et/kxsldbg/variables.docbook @@ -0,0 +1,44 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +MarekLaane
bald@online.ee
Tõlge eesti keelde + + + +Muutujate kasutamine + +Kui inspektori dialoogi ei ole näha, kasuta menüükäsku Tööriistad Näita inspektoreid . + +Kohalikud ja globaalsed muutujad on näha inspektoridialoogi kaardil. Järgnev näide kujutab endast XSLT koodi lõiku, mis deklareerib globaalse ja kohaliku muutuja. + +<xsl:variable name="globalvariable" select="'foo'"/> + + <xsl:template match="/"/> + <xsl:param name="localvariable" select="'bar'"/> + </xsl:template match="/"/> + + +Hiirega mõnel nimekirja muutujal klõpsates näeb selle kokkuvõtlikku infot dialoogi allosas. Kui muutujas esineb avaldis, näiteks + +<xsl:variable name="changeable" select="'oldValue'" /> + + +siis saab valida uue XPathi, sisestades uue muutuja avaldise ning klõpsates nupule Määra avaldis. + + +Muutujate kaart + + + + +Muutujate kaart +Muutujate kaart + + + +Klõps nimekirjas oleval muutujakirjel põhjustab kursori liikumise peaaknas osutatud failile ja reanumbrile. + diff --git a/doc/et/xsldbg/commands.docbook b/doc/et/xsldbg/commands.docbook new file mode 100644 index 0000000..d21e245 --- /dev/null +++ b/doc/et/xsldbg/commands.docbook @@ -0,0 +1,758 @@ + + +Käskude seletused + +Addparam +Lisab libxslt parameetri; vaste käsureal --param <QNAME>:<XPATH>. + +Addparam kasutamine + +addparam <QNAME> <XPATH>    (<XPATH> ei tohi sisaldada tühikuid ega topeltjutumärke.) +addparam <QNAME> "<XPATH>"    (<XPATH> ei tohi sisaldada topeltjutumärke) + + +
+ + +Addwatch +Lisab jöälgitava avaldise. Jälgimisväärtuste näitamise kohta vaata showwatch +Lühinimi: watch +Addwatch kasutamine + +addwatch <XPATH> + + +
+ + +Base +Näitab antud sõlme baasi +Base kasutamine + + +base + + +
+ + +Break +Lisab katkestuse malli, laaditabeli asukohta või xsldbg laetud XML-faili või aktiivsesse sõlme. xsldbg 3.1.4 uus omadus: GDB ühilduvusrežiinmis saab määrata orvust katkestuspunktid konkreetsele failile ja reanumbrile ning lahendada hiljem. +Lühinimi: bxsldbg üritab täieliku URL-i ära arvata järgmiste asjade põhjal: failinimi ilma asukoha määranguta. failinimi samas kataloogis, kus asub laetud "tipp-laaditabel". failinimi xsldbg aktiivse töökataloogi suhtes. S.t. kui oled laadinud laaditabelifaili ../en/xsldoc.xsl, saad seda teha break -l xsldoc.xsl 26 See käsk sobib osalise või täieliku QNAME malliga ja/või antud režiimi nimega. Nt. "template" sobib iga QNAME-ga, mille kohalikus osas esineb "template" Kõik nimeruumid antud QNAME nimes laiendatakse vastavalt nimeruumide definitsioonile XSL allikfailis, nt. "xsl:test1" laiendatakse "http://www.w3.org/199/XSL/Transform:test1" Soovitud katkestuspunkt lahendatakse sellega seostatud URL-i ja reanumbri järgi. Seda tehakse automaatselt pärast seda, kui xsldbg on näinud esimest malli. Katkestuspunktid valideeritakse uuesti kohe pärast iga töötlemist. Automaatselt valideeritakse katkestuspunkte GDB režiimi kasutamisel - mis on ka xsldbg vaikerežiim +Break kasutamine + + +break -l <FAILINIMI> <REANR>    (Katkestuspunkti määramiseks määratud failis, reanumbril) +break -l <URI> <REANR>    (Katkestuspunkti määramiseks konkreetses URI-s, reanumbril) +break <MALLINIMI>    (Nimetatud või sobiva malli katkestamiseks) +break <MALLINIMI> <REŽIIMINIMI>    (Nimetatud malli katkestamiseks antud režiimis) +break "" <REŽIIMINIMI>    (Suvalise antud režiiminimega malli katkestamiseks) +break *    (Suvalise leitud malli katkestamiseks) +break \*    (Malli "*" katkestamiseks. Muid nimesid, milles leidub '*', ei kohelda spetsiaalselt) +break     (Aktiivse sõlme katkestamiseks. Jah, nende hulka kuuluvad XML-andmete sõlmed!) + + +
+ + +Bye +Lõpetab laaditabeli töötlemise nii ruttu, kui võimalik. +Bye kasutamine + + +bye + + +
+ + +Cat +Näitab XPath-avaldise tulemust aktiivse sõlme suhtes. +Cat kasutamine + + +Kasutamine: cat <XPATH>    (Muutuja või parameetri vaatamiseks) +Kasutamine: cat $<QNAME> + + +
+ + +Cd +Asukoha muutmine vastavalt XPath'i määratule. +Cd kasutamine + + +<< = preceding-sibling::node() +>> = following-sibling::node() +<- = ancestor::node() +-> = decendant::node() + +
+ + +Chdir +Töökataloogi muutmine +Chdir kasutamine + + +chdir <ASUKOHT>    (Suhteline või absoluutne asukoht operatsioonisüsteemis) + + +
+ + +Continue +Laaditabeli täitmise jätkamine, peatumine kõigis leitud katkestuspunktides. +Lühinimi: c +Continue kasutamine + + +continue + + +
+ + +Data +Lülitumine XML-andmete aktiivsele sõlmele või kasutatavate XML-andmete muutmine +Data kasutamine + + +data    (Lülitumine dokumendi aktiivsele sõlmele) +data <ANDMED>    (Lülitumiseks uuele XML-andmete failile. Alustav "~" asendatakse keskkonnamuutuja $HOME väärtusega. Vajab kasutamiseks käsku "run") + + +
+ + +Delete +Malli katkestuspunkti kustutamine +Lühinimi: d +Delete kasutamine + + +delete    (Katkestuspunkti kustutamiseks aktiivses sõlmes) +delete <KATKESTUSPUNKTI_ID>    (Määratud numbriga katkestuspunkti kustutamiseks) +delete -l <FAILINIMI> <REANR>    (Kustutamiseks määratud failis, reanumbril) +delete -l <URI> <REANR>    (Kustutamiseks määratud URI-s, reanumbril) +delete <MALLINIMI>    (Katkestuspunkti kustutamiseks nimetatud mallis) +delete *    (Kõigi katkestuspunktide kustutamiseks) + + +
+ + +Delparam +libxslt parameetri kustutamine +Delparam kasutamine + + +delparam    (Kõigi olemasolevate parameetrite kustutamiseks) +delparam <PARAM_ID> + + +
+ + +Delwatch +Jälgimisavaldise kustutamine või kõigi jälgimisavaldiste eemaldamine, nagu näitab käsk "showwatch" +Delwatch kasutamine + + +delwatch <JÄLGIJA_ID>    (Antud ID-ga jälgimisavaldise kustutamiseks) +delwatch *    (Kõigi jälgimisavaldiste kustutamiseks) + + +
+ + +Dir +Sõlmede nimekirja näitamine (sarnaneb shellikäsuga dir). + +Dir kasutamine + + +dir + + +
+ + +Disable +Katkestuspunkti keelamine +Disable kasutamine + + +disable    (Katkestuspunkti keelamiseks aktiivses sõlmes) +disable <KATKESTUSPUNKTI_ID>    (Määratud numbriga katkestuspunkti keelamiseks) +disable -l <FAILINIMI> <REANR>    (Katkestuspunkti keelamiseks määratud failis, reanumbril) +disable -l <URI> <REANR>    (Katkestuspunkti keelamiseks määratud URI-s, reanumbril) + + +
+ + +Du +Alamsõlmede kokkuvõtte näitamine puukujuliselt. +Du kasutamine + + +du + + +
+ + +Dump +Antud sõlme igavate üksikasjade salvestamine +Dump kasutamine + + +dump + + +
+ + +Enable +Katkestuspunkti lubamine või keelamine (lülitamine) +Lühinimi: e +Enable kasutamine + + +enable    (Katkestuspunkti lubamiseks/keelamiseks aktiivses sõlmes) +akenable <KATKESTUSPUNKTI_ID>    (Määratud numbriga katkestuspunkti lubamiseks/keelamiseks) +enable -l <FAILINIMI> <REANR>    (Katkestuspunkti lubamiseks/keelamiseks määratud failis, reanumbril) +enable -l <URI> <REANR>    (Katkestuspunkti lubamiseks/keelamiseks määratud URI-s, reanubmril) + + +
+ + +Entities +Andmefailis (dokumendis) kasutatud väliste üldiste olemite nimekirja näitamine +Lühinimi: ent +Entities kasutamine + + +entities + + +
+ + +Exit +Lõpetab laaditabeli töötlemise nii ruttu, kui võimalik. +Exit kasutamine + + +exit + + +
+ + +Frame +Pinu raami näitamine määratud sügavusega +Lühinimi: f +Frame kasutamine + + +frame <RAAMI_SÜGAVUS>    (Sügavus on arv vahemikus 0 kuni väljakutsete pinu praegune sügavus) + + +
+ + +Free +Vaba laaditabel ja andmed (keelatud, vaata run) +Free kasutamine + + +free + + +
+ + +Globals +Laaditabeli globaalsete muutujate või parameetrite nimekirja näitamine. Globaalse muutuja väärtuse näitamine +Globals kasutamine + + +globals    (Kõigi globaalsete muutujate nimekirja näitamine) +globals -f    (Kõigi globaalsete muutujate ja nende väärtuste nimekirja näitamine) +globals <QNAME>    (Määratud muutuja väärtuse näitamine) + + +
+ + +Help +Abi näitamine käsu kohta +Lühinimi: h +Help kasutamine + + +help     (Toote ülevaate näitamiseks) +help <KÄSK>     (Abi näitamiseks käsu kohta) + + +
+ + +Load +xsldbg valikute ja kasutajaeelistuste laadimine kettalt +Load kasutamine + + +load + + +
+ + +Locals +Laaditabeli kohalike muutujate või parameetrie nimekirja näitamine. Kohaliku muutuja väärtuse näitamine +Locals kasutamine + + +locals    (Kõigi saadaolevate kohalike muutujate nimekirja näitamine) +locals -f    (Kõigi saadaolevate kohalike muutujate ja nende väärtuste nimekirja näitamine) +locals <QNAME>    (Määratud muutuja väärtuse näitamine) + + +
+ + +Ls +Sõlmede nimekiri lühivormis +Ls kasutamine + + +ls + + +
+ + +Next +xsl:call-template või xsl:apply-templates vahelejätmine. Sama toimega, mis käsk "step" ja seejärel "up" +Lühinimi; n +Next kasutamine + + +next    (Edasiliikumiseks järgmise alaminstruktsiooni juurde) + + +
+ + +Options +xsldbg võtme väärtuste näitamine +Options kasutamine + + +options + + +
+ + +Output +Kohaliku kirjutamisõigusega faili määramine, mida kasutatakse tulemuste väljundina +Lühinimi: o +Output kasutamine + + +output <FAILINIMI>    (Kohaliku kirjutamisõigusega faili nimi. *NIX- ja CYGWIN-platvormil võib eelneda prefiks "~", RISC OS-i puhul keskkonnamuutujad) +output <URI>    (<URI> saab kasutada ainult protokolli "file://" puhul. See teisendatakse siis operatsioonisüsteemile sobivale failinime kujule) +output -    (Saatmine standardväljundisse. Kasutatav ainult xsldbg kasutamise korral käsurealt) + + +
+ + +Public +Väärtuse näitamine, mida avalik ID seostab aktiivse kataloogiga +Lühinimi: pub +Public kasutamine + + +public "<PublicID>" + + +
+ + +Pwd +Aktiivse töökataloogi näitamine. +Pwd kasutamine + + +pwd + + +
+ + +Quit +Lõpetab laaditabeli töötlemise nii ruttu, kui võimalik. +Lühinimi: q +Quit kasutamine + + +quit + + +
+ + +Run +Laaditabeli taaskäivitamine. +Lühinimi: r +Run kasutamine + + +run + + +
+ + +Save +xsldbg valikute ja kasutajaeelistuste salvestamine kettale +Save kasutamine + + +save + + +
+ + +Search +Andmebaasist kõigi laaditud laaditabelite kohta kogutud info otsimine +Kõik väljundfailid salvestatakse asukohta, mille väärtuse määrab võti "searchresultspath" või samassse kataloogi laaditabeliga. Faili searchresults.xml transformeerib tavaliselt search.xsl, kuid seda transformeeritakse searchhtml.xsl abil, kui kasutatakse võtit "prefrehtml". Otsimiskäsu andmisel luuakse XML-fail searchresults.xml. Seejärel saab seda faili töödelda omaenda laaditabeliga andmete esitamiseks muul moel. Kui määratud on võti "preferhtml", näidatakse faili searchresult.txt. Sõltuvalt kogutud andmete hulgast võib käsu töötlemine võtta päris tükk aega. +Search kasutamine + + +search <XPATH>    (Vaatamiseks, milline XPath on kasutusel search.dtd vaatamiseks. Vaikimisi <XPATH> on s'//search/*') +search -sort <XPATH>    (Annab failile search.xsl korralduse tulemus enne esitamist sortida) + + +
+ + +Set +Muutuja väärtuse määramine +Set kasutamine + + +set <MUUTUJA_NIMI> <XPATH> + + +
+ + +Setoption +Laaditabeli täitmise võtme määramine +Muudatuste aktiveerimiseks tuleb kasutada käsku run +Setoption kasutamine + + +setoption <VÕTME_NIMI> <TÄISARV> +Kus <VÕTME_NIMI> võib olla + + + + + debug    (Kui <TÄISARV> on tõene, salvestatakse tulemusepuu) + catalogs    (Kui <TÄISARV> on tõene, kasutata katalooge asukohast õige $SGML_CATALOG_FILES või SGML $CatalogFiles RISC OS-i korral) + html    (Kui <TÄISARV> on tõene, on väljunddokument HTML-fail) + docbook    (Kui <TÄISARV> on tõene ja libxml toetab docbook'i, on sisenddokument SGML-docbook) + xinclude    (Kui <TÄISARV> on tõene, sooritatakse sisenddokumendil XInclude töötlus) + preferhtml    (Kui <TÄISARV> on tõene, eelistata otsingutulemuse korral HTML-väljundit. Vaata käsku search) + autoencode    (Kui <TÄISARV> on tõene, üritatakse kasutada laaditabeli kodeeringut) + utf8input    (Kui <TÄISARV> on tõene, on kogu kasutaja sisend UTF-8 kodeeringus. Seda kasutatakse tavaliselt siis, kui xsldbg käivitatakse lõimena) +      + gdb    (Käivitatakse GDB ühilduvusrežiimis) + Väärtuse 1 korral tähendab see + Näidatakse palju rohkem teateid. Suurendab "Katkestuspunkt asukohas..." näitamise sagedust + Avaldiste hindamisel näidatakse kõige enam GDB_LINES_TO_PRINT rida, millele järgneb "..." Vaata options.h selle väärtuse muutmiseks, vaikeväärtus on kolm tekstirida + Näidatakse nii kohalikke kui globaalseid, kui antakse käsk "locals" + Avaldise näitamisel käsuga cat/print. Hinnatud väärtusele lisatakse prefiks "= " < EXPRESSION > + + + + + + Väärtuse 2 korral tähendab see Näidatakse teateid, mida vajab KDbg, samuti ülalmainitud väljundiolekut (kui väärtus on 1) + + + + + + + + + nonet    (Kui <TÄISARV> on tõene, keeldutakse DTD-sid või olemeid tõmbamast võrgust) + novalid    (Kui <TÄISARV> on tõene, jäetakse DTD laadimise faas vahele) + repeat    (Kui <TÄISARV> on tõene, käivitatakse transformatsioon 20 korda) + profile    (Kui <TÄISARV> on tõene, salvestatakse profileerimisinfo) + timing    (Kui <TÄISARV> on tõene, näidatakse kulunud aega) + noout    (Kui <TÄISARV> on tõene, tulemust ei salvestata) + + + + +Kus väärtus on tõene, kui see EI VÕRDU nulliga +Kus väärtus on väär, kui see VÕRDUB nulliga +stdout    (Kõik veateated saadetakse standardväljundisse (stdout) tavapärase standardveaväljundi (stderr) asemel) +setoption <VÕTME_NIMI> "<STRINGI_VÄÄTUS>"    (Ei tohi sisaldada topeltjutumärke <STRINGI_VÄÄRTUS> sees) +setoption <VÕTME_NIMI> <STRINGI_VÄÄTUS>    (Ei tohi sisaldada tühikuid ega topeltjutumärke <STRINGI_VÄÄRTUS> sees) +Kus <VÕTME_NIMI> võib olla + + + + + data    (Andmefaili URI) + source    (Allikfaili URI) + output    (Väljundfaili SystemID) + docspath    (Dokumentatsiooni otsimisel kasutatav otsingutee) + catalognames    (Kataloogide nimed, mida kasutatakse võtme catalogs määramise korral. Väärtus läheb kaotsi, kui see määratakse enne võtme catalogs määramist) + encoding    (Standardväljundis kasutatav kodeering) + searchresultspath    (Otsingu tulemuste salvestamisel kasutatav otsingutee. Kui on määramata, kasutab xsldbg laaditabeli otsinguteed) + + + + + +
+ + +Shell +Shellikäsu käivitamine +Shell kasutamine + + +shell <TEKST>    (<TEKST> on operatsioonisüsteemile täitmiseks edastatav tekst) + + +
+ + +Showbreak +Malli katkestuspunktide näitamine. +Lühinimi: showKui malli katkestuspunktile on olemas režiim, siis lisatakse see mallinime järele tähistama katkestuspunkti. Väljundi näide on selline: +Katkestuspunkt 3 mallis lubatud: "*" failis test1.xsl : real 105 +Katkestuspunkt 2 mallis lubatud: "* testMode" failis test1.xsl : real 109 +Katkestuspunkt 1 mallis lubatud: "* http://www.w3.org/1999/XSL/Transform:testMode" failis test1.xsl : real 113 + +Kokku 3 katkestuspunkti + +Showbreak kasutamine + + +showbreak + + +
+ + +Showparam +Olemasolevate libxslt parameetrie näitamine +Showparam kasutamine + + +showparam + + +
+ + +Showwatch +Jälgitava aktiivse avaldise näitamine +Lühinimi: watches +Showwatch kasutamine + + +showwatch    (Aktiivsete valitud jälgijate ja nende väärtuste näitamine) +showwatch 1    (Jälgimisavaldiste automaatse näitamise lubamine. See on vaikimisi sees) +showwatch 0    (Jälgimisavaldiste automaatse näitamise keelamine) + + +
+ + +Source +Laaditabeli aktiivse sõlme näitamise lülitamine või kasutatava laaditabeli muutmine +Source kasutamine + + +source    (Lülitumine laaditabeli aktiivsele sõlmele) +source <ALLIKAS>    (Uuele allikfailile lülitumiseks. Alustav "~" asendatakse keskkonnamuutuja $HOME väärtusega. Vajab käivitamiseks käsku "run") + + +
+ + +Step +Täitmise järgmise laaditabeli instruktsioonini. +Lühinimi: s +Step kasutamine + + +step + + +
+ + +Stepdown +Samma alla uuemasse "väljakutseraami". +Lühinimi: down +Stepdown kasutamine + + +stepdown     (samm üks raam allapoole) +stepdown <RAAMIDE_ARV>    (samm allapoole määratud raamide arvu võrra) + + +
+ + +Stepup +Samm üles vanemasse "väljakutseraami". +Lühinimi: upSee ei ole täpne käsk, xsldbg peatub nii lähedal, kui võimalik. +Stepup kasutamine + + +stepup     (samm üks raam ülespoole) +stepup <RAAMIDE_ARV>    (samm ülespoole määratud raamide arvu võrra) + + +
+ + +Stylesheets +Laetud laaditabelite nimekirja näitamine +Lühinimi: style +Stylesheets kasutamine + + +stylesheets + + +
+ + + +System +Väärtuse näitamine, mille süsteemne fail seostab aktiivse kataloogiga +Lühinimi: sys +System kasutamine + + +system "<SystemID>" + + +
+ + +Templates +Saadaolevate mallide nimekirja näitamine. Malli otsimine +Lühinimi: t +Templates kasutamine + + +templates +templates <MALL>    (Malli nimega <MALL> üksikasjade näitamine, kui see leitakse) + + +
+ + +Trace +Laaditabeli täitmise jälgimine faili nime ja vahepealsete sammude ridu näidates +Trace kasutamine + + +trace + + +
+ + +Tty +Terminali avamine. Tty ümbersuunamise taseme määramine. +Tty kasutamine + + +tty <SEADME_ASUKOHT>    (Kus <SEADME_ASUKOHT> on operatsioonisüsteemi kehtiv terminal. Lihtsalt püüab avada terminali) +tty <TTY_TASE>    (Tty ümbersuunamise taseme määramine, kus <TTY_TASE> on kasutatava sisendi/väljundi kehtiv tase) + Kus tase on + 0 = vaikimisi sisend/väljund + 1 = transformeerimise, jälgimise ja läbimise tulemuste väljund terminali    (Vaikeolek, kui tty-seade on avatud. Pole veel täielikult teostatud) + 2 = täielik ümbersuunamine terminali    (Pole veel teostatud) + Kõiki muid täisarve tõlgendatakse kui taset 0 + + + + + + +
+ + +Validate +Laaditabeli tekitatud väljundfaili valideerimine (keelatud) +Validate kasutamine + + +validate + + +
+ + +Walk +Koodi läbimine kiirustevahemikke kasutades +Walk kasutamine + + +walk <KIIRUS>    (Ctrl+C peatab täitmise, <KIIRUS> on väärtus vahemikus 0 kuni 9, kus 0 tähendab peatamist, 1 väga kiiret ja 9 väga aeglast) + + +
+ + +Where +Malli väljakutsete (raami pinu) jälituse ja töökataloogi näitamine. +Lühinimi: w +Where kasutamine + + +where + + +
+ + +Write +Veel lõpetamata +Write kasutamine + + +write + + +
+ + + + + + + diff --git a/doc/et/xsldbg/credits.docbook b/doc/et/xsldbg/credits.docbook new file mode 100644 index 0000000..ddaa6fa --- /dev/null +++ b/doc/et/xsldbg/credits.docbook @@ -0,0 +1,14 @@ + + +Autorid ja litsents + +&xsldbg; +Rakenduse autoriõigus 2004: Keith Isdale k_isdale tpg com au + +Tõlge eesti keelde: Marek Laane bald@starman.ee +&underFDL; &underGPL; +Tänud: +libxml ja libxsl autoritele. +Johannes Sixtile abi eest xsldbg toetuse lisamisel KDbg-le. + + diff --git a/doc/et/xsldbg/index.docbook b/doc/et/xsldbg/index.docbook new file mode 100644 index 0000000..7a90c0f --- /dev/null +++ b/doc/et/xsldbg/index.docbook @@ -0,0 +1,96 @@ + +xsldbg"> + + + + + + + + +]> + + + + + + + + + + + +&xsldbg; käsiraamat + + +Keith Isdale
k_isdale@tpg.com.au
+ + + +Marek Laane
bald@starman.ee
Tõlge eesti keelde + + + + +2002 +2003 +Keith Isdale + + +&FDLNotice; +2004-09-26 +1.01.00 + + + +&xsldbg; on tööriist, mis aitab paremini mõista laaditabeleid. Muudest laaditabelite siluritest eristab seda oskus otsida huvipakkuvaid elemente ning jälgida laaditabeli täitmist. + + + +KDE +tdeutils +xsldbg +xsl +XML + + + + +&introduction-chapter; +&usage-chapter; +&commands-chapter; +&credits-chapter; + + + +Paigaldamine + + +&xsldbg; hankimine + +Otsi moodulisse tdewebdev kuuluv kxsldbg üles oma lähimast &kde; SVN-hoidlast. +&install.intro.documentation; + + +Nõuded + +&xsldbg; edukaks kasutamiseks on vajalik &kde; libxslt, libexslt ja libxml paigaldamine. Tavaliselt käivad need nagunii &kde;-ga kaasas. + + + +Kompileerimine ja paigaldamine +&xsldbg; kompileeritakse tavaliselt osana moodulisse tdewebdev kuuluvast komponendist kxsldbg + + + +Seadistamine + +&xsldbg; on seadistatud argumente kasutades, mis edastatakse käsurea ja käsu setoption vahendusel. + + + + + +&documentation.index; + diff --git a/doc/et/xsldbg/introduction.docbook b/doc/et/xsldbg/introduction.docbook new file mode 100644 index 0000000..04ed0cb --- /dev/null +++ b/doc/et/xsldbg/introduction.docbook @@ -0,0 +1,16 @@ + + +Sissejuhatus + +&xsldbg; on tekstipõhine tööriist laaditabelite (eXtensible Stylesheet Language) silumiseks ning selle käsud sarnanevad UNIX-i/Linuxi siluri GDB käskudega. Laaditabelite käivitamisel saab kasutada kolme põhirežiimi. + + + + Kogu laaditabeli käivitamine + Täitmine järgmise xsl-instruktsioonini + Jätkamine järgmise katkestuspunktini või laaditabeli taaskäivitamiseni + + + + + diff --git a/doc/et/xsldbg/usage.docbook b/doc/et/xsldbg/usage.docbook new file mode 100644 index 0000000..bd8a659 --- /dev/null +++ b/doc/et/xsldbg/usage.docbook @@ -0,0 +1,62 @@ + + +&xsldbg; kasutamine + +xsldbg käsureaargumendid +Süsteemis, kus leidub readline teek, saab sisestatud käskude ajaloos liikuda tagasi/edasiklahvidega. Kõigis süsteemides saab viimati sisestatud käsku korrata vajutusega klahvile <ENTER>. +Kui operatsioonisüsteem seda toetab, saab failinimesid laiendada. +Mitmele käsule võib anda enam kui ühe argumendi. Keerukamad avaldised saab panna jutumärkidesse, et neid tõlgendataks ühe argumendina - näiteks break "* | @" võimaldab määrata katkestuspunkti mallile nimega "* | @" + + +Mõistete selgitus +Järgnev tabel kirjeldab käskude seletuses kasutatud mõisteid. + + + MALLINIMI: kehtiv mallinimi, mis tohib sisaldada ainult ASCII sümboleid vahemikus 0x00 kuni 0x7F, ning peab olema täielikult kvalifitseeruv nimi, s.t. "xsl:malliNimi". + FAILINIMI: kehtiv failinimi kasutaja süsteemis. Sellel võib *NIX- ja CYGWIN-platvormidel olla prefiks "~" või RISC OS-i tingimustes keskkonnamuutujad + URI: universaalne ressursi identifikaator, nagu selle määratleb RFC 2396 + SÕLMENIMI: malli režiim, mis võib olla täielikult kvalifitseeruv nimi, s.t. "xsl:sõlmeNimi". + QNAME: täielikult kvalifitseeruv nimi, s.t. "xsl:kohalikKomponent" + REANR: kehtiv reanumber, seotud kirjega <FAILINIMI> + RAAMIDE_ARV: kehtiv raamide arv, mille võrra asukohta muuta + KATKESTUSPUNKTI_ID: kehtiv katkestuspunkti number + JÄLGIJA_ID: kehtiv jälgimisavaldise number, nagu seda näitab käsk showwatch + KIIRUS: kiirus koodi läbimiseks vahemikus 0 kuni 9 +     (Kommentaar): kommentaar käsu tähenduse või kasutamise kohta + { valik1 | valik2 | valik2 .. jne}: valikute valimine + XPATH: sõlme(de) XPath'i valik + PARAM_ID: kehtiv parameetri number, nagu seda näitab käsk showparam + ASUKOHT: töökataloogi asukoht. Mõnes operatsioonisüsteemis võib kodukataloogi asukohta asendada sümboliga "~" + TEKST: vabas vormis tekst     (piirangud puuduvad) + KÄSK: xsldbg kehtiv käsk + QNAME: kehtiv muutuja/parameetri nimi + ALLIKAS: täidetav laaditabel. Vaata <FAILINIMI> ja <URI> + ANDMED: laaditabeli töödeldavad XML-andmed (dokument). Vaata <FAILINIMI> ja <URI> + SEADME_ASUKOHT: operatsioonisüsteemi kehtiv terminal + TTY_TASE: kasutatav kehtiv sisendi/väljundi tase + + + + +Ülevaade saadaolevatest käskudest + + +Abiga seotud: help +Töötamisega seotud: {bye|exit| quit}, step, stepup, stepdown, next, continue, run, trace, setoption, options +Libxslt parameetriga seotud: addparam, delparam, showparam, output, setoption, options +Malliga seotud: templates, where, frame +Katkestuspunktiga seotud: break, showbreak, delete, enable +Avaldise vaatamine (XPath): cat +Sõlme vaatamine: ls, dir, du, cat, pwd +Muutuja vaatamine: globals, locals, cat, addwatch +Muutuja määramine: set +Sõlme valik: source, data, cd +Otsimine: search +Operatsioonisüsteemiga seotud: chdir, shell, tty +Failiga seotud: output, entities, system, public +Keelatud failikäsud: validate, load, save, write, free + + + + + diff --git a/doc/fr/kxsldbg/callstack.docbook b/doc/fr/kxsldbg/callstack.docbook new file mode 100644 index 0000000..e4bf9f1 --- /dev/null +++ b/doc/fr/kxsldbg/callstack.docbook @@ -0,0 +1,28 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&traducteurRobertJacolin; + + + +Travailler avec la pile d'appels + +Tous les éléments de la pile d'appels qui ont été trouvés sont listés ici. Plus l'appel est vieux, plus le numéro du cadre sera bas. Voir l'exemple ci-dessous. + + +La fenêtre de la pile d'appels + + + + +La fenêtre de la pile d'appels + + + +En cliquant sur un élément de la pile d'appels dans la liste affichée, le curseur de la fenêtre principale se rendra dans le fichier et à la ligne indiqués. + + diff --git a/doc/fr/kxsldbg/credits.docbook b/doc/fr/kxsldbg/credits.docbook new file mode 100644 index 0000000..396d3b0 --- /dev/null +++ b/doc/fr/kxsldbg/credits.docbook @@ -0,0 +1,29 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&traducteurRobertJacolin; + + +Remerciements et licences + +&kxsldbg; © 2004 Keith Isdale +Documentation © 2004 Keith Isdale + + + +Merci pour : + +le créateur de libxml et de libxslt. + + +Robert Jacolin pour des retours sur des versions plus anciennes de &kxsldbg;. + + +Igor Zlatkovic pour la création de binaire WIN32 de libxml/xslt et de &xsldbg;. + + +&underFDL; &underGPL; diff --git a/doc/fr/kxsldbg/entities.docbook b/doc/fr/kxsldbg/entities.docbook new file mode 100644 index 0000000..b7ee790 --- /dev/null +++ b/doc/fr/kxsldbg/entities.docbook @@ -0,0 +1,28 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&traducteurRobertJacolin; + + +Travailler avec des fichier de données &XML; (entités) + +Si la boîte de dialogue de contrôle n'est pas affichée, utilisez le menu Outils Afficher les contrôleurs. Pour travailler avec les entités, cliquez sur l'onglet Entités de la boîte de dialogue ainsi affichée. + +Toutes les entités &XML; externes incluses par le fichier de données ou un des fichiers de même niveau sont listées ici. Par exemple, j'ai lancé &kxsldbg; avec testdoc.xsl sur testdocxml (que l'on peut trouver dans le dossier <KDE PREFIX>/share/apps/kxsldbg pour que vous puissiez voir des entités. + + +La fenêtre des entités + + + + +La fenêtre des entités + + + +En cliquant sur une entité de la liste, le curseur de la fenêtre principale se rendra au début du fichier indiqué. + diff --git a/doc/fr/kxsldbg/glossary.docbook b/doc/fr/kxsldbg/glossary.docbook new file mode 100644 index 0000000..247546c --- /dev/null +++ b/doc/fr/kxsldbg/glossary.docbook @@ -0,0 +1,35 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&traducteurRobertJacolin; + + + + +Mots-clés + +&xsldbg; + +Voir . + + + + +XPath + +Une expression valable qui définit la donnée nécessaire. Voir le site web du W3C. + + + + +QName + +Un nom pleinement qualifié. Par exemple, xsl:mavariable. Voir le site web du W3C. + + + + diff --git a/doc/fr/kxsldbg/index.docbook b/doc/fr/kxsldbg/index.docbook new file mode 100644 index 0000000..e3aa0ce --- /dev/null +++ b/doc/fr/kxsldbg/index.docbook @@ -0,0 +1,110 @@ + +KXSLDbg"> + + + + + + + + + + + + + + + xsldbg"> + DTD"> + XSD"> + XSLT"> + +]> + + + + +Manuel de &kxsldbg; + + +Keith Isdale
k_isdale@tpg.com.au
+ + + + + +2002 +2003 +2004 +Keith Isdale + + +&FDLNotice; +2004-11-18 +0.5 + + +&kxsldbg; fournit une interface graphique utilisateur pour &xsldbg; qui gère le débogage des scripts &XSLT;. + + + +kde +xsldbg +libxslt +debugger + + + + +Introduction + + +Fonctionnalités + +&kxsldbg; permet d'accéder à la plupart des commandes de &xsldbg; pour + +ajouter et modifier des points d'arrêt + + +afficher les valeurs des XPath + + +afficher des informations sur les modèles (templates), les variables, les éléments des piles d'appel, les feuilles de style et les entités présents + + +ajouter et modifier des points d'arrêt et des variables + + +se déplacer dans le source &XSL; et les documents &XML; en utilisant des XPaths + + +chercher les identifiants publics et système dans le catalogue &XML; actif + + + + + + +Caractéristiques récemment ajoutées +&kxsldbg; peut maintenant + + +ajouter et modifier des variables + + +effectuer le rendu du texte dans la fenêtre principale en utilisant les bibliothèques de &kate;. + + + + + + + + +Utilisation de &kxsldbg; +&configure-section; &mainwindow-section; &inspector-section; &variables; &callstack; &templates; &sources; &entities; &tools-section; + +&credits-chapter; + + diff --git a/doc/fr/kxsldbg/kxsldbg_configure.docbook b/doc/fr/kxsldbg/kxsldbg_configure.docbook new file mode 100644 index 0000000..67ea2cf --- /dev/null +++ b/doc/fr/kxsldbg/kxsldbg_configure.docbook @@ -0,0 +1,67 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&traducteurRobertJacolin; + + + +Configurer une session &kxsldbg; + +Vous lancez la configuration en cliquant sur Debug Configuration dans la barre de menus. + + +La boîte de dialogue de configuration + + + + +La boîte de dialogue de configuration +La boîte de dialogue de configuration + + + + +Premiers pas + +Pour pouvoir lancer une feuille de styles, il vous faut indiquer : +le fichier source &XSL; +le fichier de données &XML; +le fichier de sortie + + + +Utilisez le bouton ... pour choisir le fichier désiré. &XSL; source et >&XML; data doivent faire référence à des URI qui contiennent http://, ftp:// ou file://. Le Fichier de sortie doit faire référence à un fichier local accessible en écriture. +Pour poursuivre avec les exemples, sélectionnez les fichiers suivants du dossier d'exemple <PREFIXE DE KDE>/share/apps/kxsldbg. +Fichier source &XSL; : testdoc.xsl +Fichier de données &XML; : testdoc.xml +Fichier de sortie : /tmp/xsldbg_output.txt + + + + + +Indiquer des options + +Vous pouvez sélectionner une, plusieurs ou aucune options dans la boîte de dialogue Options. Chaque option a une bulle d'aide qui donne une idée de l'effet qu'elle a. + + + +Ajouter des paramètres + +Vous pouvez sélectionner un, plusieurs ou aucun paramètres au moyen de la section Paramètres LibXSLT de la boîte de dialogue. Cela vous permet de fournir les valeurs des paramètres de la feuille de styles. + +Par exemple, vous pouvez saisir monparam dans Nom du paramètre : avec 'Bonjour tout le monde !' dans Valeur du paramètre : et cliquer sur le bouton Ajouter. Pour mettre à jour la valeur d'un paramètre existant, naviguez simplement vers la valeur que vous souhaitez modifier avec les boutons Précédent et Suivant, donnez une nouvelle Valeur du paramètre : puis cliquez sur Appliquer. + + + +Appliquer les modifications + +Pour que les modifications que vous avez effectuées prennent effet, actionnez le bouton Appliquer. Pour ignorer toutes les modifications, actionnez le bouton Annuler. + +Vous pouvez fermer la boîte de dialogue en utilisant le bouton X fourni en haut à droite de la fenêtre. Si vous avez besoin de modifier la configuration, il suffit d'ouvrir la boîte de dialogue de configuration comme vu précédemment. + + diff --git a/doc/fr/kxsldbg/kxsldbg_inspector.docbook b/doc/fr/kxsldbg/kxsldbg_inspector.docbook new file mode 100644 index 0000000..6f9b643 --- /dev/null +++ b/doc/fr/kxsldbg/kxsldbg_inspector.docbook @@ -0,0 +1,71 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&traducteurRobertJacolin; + + +Paramétrer et modifier les points d'arrêt + +La principale façon de travailler avec les points d'arrêt est d'utiliser la fenêtre principale. Voir + +Une fois que vous avez démarré la feuille de styles, vous pouvez utiliser l'élément de menu Outils Afficher les contrôleurs. Puis cliquez sur l'onglet Points d'arrêt. Voir ci-dessous pour un exemple. + + +Paramétrer les points d'arrêt + + + + +Paramétrer les points d'arrêt + + + + +Ajouter un point d'arrêt + +Vous pouvez ajouter un point d'arrêt en fournissant : + +un fichier et un numéro de ligne + +un nom de modèle (template + +un nom de modèle et un nom de mode + +un nom de mode + + + + +puis en actionnant le bouton Ajouter. + + + +Détails des arguments + +Un nom de fichier peut être un chemin absolu vers un fichier local ou un nom de fichier relatif (&pex; xsldoc.xsl). + +Un nom de modèle ou de mode peut être un nom pleinement qualifié où la partie non locale est optionnelle ; &pex; xsl:monmodele correspond à monmodele. + + + +Supprimer un point d'arrêt + +D'abord, cliquez sur le point d'arrêt que vous voulez supprimer dans la liste des points en cours avec le &BGS;. Puis cliquez sur le bouton Supprimer. + + + +Effacer tous les points d'arrêt + +Cliquez sur le bouton Tout effacer. + + + +Activer ou désactiver un point d'arrêt + +D'abord, cliquez avec le &BGS; sur le point d'arrêt que vous voulez désactiver dans la liste des points d'arrêt en cours. Puis cliquez sur le bouton Activer. + + diff --git a/doc/fr/kxsldbg/kxsldbg_mainwindow.docbook b/doc/fr/kxsldbg/kxsldbg_mainwindow.docbook new file mode 100644 index 0000000..b1a0282 --- /dev/null +++ b/doc/fr/kxsldbg/kxsldbg_mainwindow.docbook @@ -0,0 +1,443 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&traducteurRobertJacolin; + + +Utiliser la fenêtre principale + + +La fenêtre principale + + + + +Une vue textuelle du fichier en cours à corriger +Une vue textuelle du fichier en cours à corriger. + + + + +Travailler avec la fenêtre principale + +L'état d'un point d'arrêt donné est indiqué par une couleur de fond différente pour le texte concerné. Vous pouvez choisir cette couleur : reportez-vous à la boîte de dialogue ConfigurationConfigurer l'éditeur... dans la page Couleurs. + + +Vous pouvez définir, désactiver ou supprimer un point d'arrêt en utilisant les touches, le menu Déboguer ou les boutons de la barre d'outils. + +Vous pouvez déplacer le curseur dans le texte en utilisant les touches suivantes : + + +Les touches fléchées : Flèche gauche, Flèche droite, Flèche vers le haut, Flèche vers le bas. +Les touches de changement de page : Page précédente ou Page suivante + + + + + + +Utiliser la sortie de &kxsldbg; + +La plus grande partie de ce qui est généré par &kxsldbg; est capturé et présenté soit dans les boîtes de dialogue des contrôleurs, soit dans la fenêtre de sortie de &kxsldbg;. Les exceptions à cette règle sont : + + +un message d'erreur qui vient de &kxsldbg; est affiché dans une boîte de message. + + +le résultat de l'évaluation d'une expression est affiché dans une boîte de message. + + +le résultat de recherches est envoyé dans le fichier indiqué dans la fenêtre de sortie de &kxsldbg;. + + + + + + + + diff --git a/doc/fr/kxsldbg/kxsldbg_tools.docbook b/doc/fr/kxsldbg/kxsldbg_tools.docbook new file mode 100644 index 0000000..bff4fe0 --- /dev/null +++ b/doc/fr/kxsldbg/kxsldbg_tools.docbook @@ -0,0 +1,77 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&traducteurRobertJacolin; + + + +Outils divers + +Plusieurs outils sont disponibles par l'intermédiaire du menu outils. L'outil principal est l'outil contrôleur. + + +Outil contrôleur + +L'outil contrôleur est le conteneur de toutes les boîtes de dialogue individuelles pour travailler avec : + +les points d'arrêt +les modèles (templates) +les variables +les éléments de pile d'appel +les fichiers sources &XSL; +les entités &XML; + + + + + +Exécution par étapes + +En cliquant sur le menu Démarrer l'exécution par étapes, une boîte de dialogue est affichée pour pouvoir définir la vitesse de progression. + + +La fenêtre de progression + + + + +La fenêtre de progression + + + +Pour arrêter la progression, utilisez soit la touche W soit l'élément de menu Démarrer l'exécution par étape. + + + +Recherche d'entités &XML; + +Pour retrouver un identifiant système dans la catalogue &XML; en cours, utilisez le menu Chercher l'identifiant système puis saisissez la valeur à trouver. + + +La fenêtre de l'identifiant système + + + + +La fenêtre de l'identifiant système + + + +Pour retrouver un identifiant public dans la catalogue &XML; en cours, utilisez le menu Chercher l'identifiant public puis saisissez la valeur à trouver. + + +La fenêtre de l'identifiant public + + + + +La fenêtre de l'identifiant public + + + + + diff --git a/doc/fr/kxsldbg/sources.docbook b/doc/fr/kxsldbg/sources.docbook new file mode 100644 index 0000000..282bb68 --- /dev/null +++ b/doc/fr/kxsldbg/sources.docbook @@ -0,0 +1,27 @@ + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&traducteurRobertJacolin; + + +Travailler avec les fichiers sources &XSLT; (sources) + +Si la boîte de dialogue n'est pas affichée, utilisez l'élément de menu Outils Afficher les contrôleurs . Pour utiliser les sources, cliquez sur l'onglet sources de la boîte de dialogue affichée. + +Tous les fichiers sources &XSLT; qui sont inclus par le fichier &XSLT; ou l'un des fichiers de même niveau sont listés ici. + + +La fenêtres des sources + + + + +La fenêtres des sources + + + +En cliquant sur un élément source de la liste affichée, le curseur de la fenêtre principale se rendra au début du fichier indiqué. + diff --git a/doc/fr/kxsldbg/templates.docbook b/doc/fr/kxsldbg/templates.docbook new file mode 100644 index 0000000..2e4c0b9 --- /dev/null +++ b/doc/fr/kxsldbg/templates.docbook @@ -0,0 +1,20 @@ + +Travailler avec les modèles (<foreignphrase>templates</foreignphrase>) + +Si la boîte de dialogue n'est pas affichée, utilisez l'élément de menu Outils Afficher les contrôleurs . Pour utiliser les sources, cliquez sur l'onglet sources de la boîte de dialogue affichée. + +Tous les modèles qui ont été trouvés sont énumérés ici. Veuillez noter que les règles d'exportation de &XSLT; sont appliquées. Par conséquent, il peut y avoir plus d'un modèle avec les mêmes détails de correspondance et de mode. + + +La fenêtre des modèles + + + + +La fenêtre des modèles + + + +En cliquant sur un modèle figurant dans la liste affichée, le curseur de la fenêtre principale se rendra dans le fichier et à la ligne indiqués. + + diff --git a/doc/fr/kxsldbg/variables.docbook b/doc/fr/kxsldbg/variables.docbook new file mode 100644 index 0000000..81f8c62 --- /dev/null +++ b/doc/fr/kxsldbg/variables.docbook @@ -0,0 +1,44 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&traducteurRobertJacolin; + + + +Travailler avec des variables + +Si la boîte de dialogue n'est pas affichée, utilisez l'élément de menu Outils Afficher les contrôleurs . + +Les variables locales et globales sont affichées dans un onglet séparé dans la boîte de dialogue du contrôleur. L'exemple suivant montre un segment de code XSLT qui déclare une variable globale et une variable locale. + +<xsl:variable name="globalvariable" select="'foo'"/> + + <xsl:template match="/"/> + <xsl:param name="localvariable" select="'bar'"/> + </xsl:template match="/"/> + + +En cliquant sur une variable de la liste, des informations seront affichées en bas de la boîte de dialogue. Si une variable a une expression de sélection, par exemple + +<xsl:variable name="changeable" select="'oldValue'" /> + + +alors un nouveau XPath peut être choisi en saisissant une nouvelle valeur pour l'expression de la variable puis en cliquant sur le bouton Régler l'expression. + + +L'onglet des variables + + + + +L'onglet variables +L'onglet variables + + + +En cliquant sur un élément variable de la liste affichée, le curseur de la fenêtre principale se rendra dans le fichier et à la ligne indiqués. + diff --git a/doc/it/kxsldbg/callstack.docbook b/doc/it/kxsldbg/callstack.docbook new file mode 100644 index 0000000..24bfc61 --- /dev/null +++ b/doc/it/kxsldbg/callstack.docbook @@ -0,0 +1,28 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +SamueleKaplun
kaplun@aliceposta.it
Traduzione italiana del Manuale + + + +Lavorare con il Callstack + +Sono qui elencati tutti gli elementi dello stack delle chiamate. Più la voce nello stack delle chiamate è vecchia e più basso è il suo numero di frame. Guarda sotto per un esempio. + + +La Finestra del Callstack + + + + +La Finestra del Callstack + + + +Facendo clic nella lista visualizzata su di un elemento del callstack sposterà il cursore della finestra principale al file e e alla riga indicata. + + diff --git a/doc/it/kxsldbg/credits.docbook b/doc/it/kxsldbg/credits.docbook new file mode 100644 index 0000000..bc1e907 --- /dev/null +++ b/doc/it/kxsldbg/credits.docbook @@ -0,0 +1,29 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +SamueleKaplun
kaplun@aliceposta.it
Traduzione italiana del Manuale + + +Riconoscimenti e licenza + +&kxsldbg; © 2004 Keith Isdale +Documentazione © 2004 Keith Isdale + + + +Si ringrazia: + +Gli sviluppatori di libxml e libxslt. + + +Robert Jacolin per il feedback sulle precedenti versioni di &kxsldbg;. + + +Igor Zlatkovic per aver creato i binari WIN32 di libxml/xslt e di &xsldbg;. + + +&underFDL; &underGPL; diff --git a/doc/it/kxsldbg/entities.docbook b/doc/it/kxsldbg/entities.docbook new file mode 100644 index 0000000..43b4692 --- /dev/null +++ b/doc/it/kxsldbg/entities.docbook @@ -0,0 +1,28 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +SamueleKaplun
kaplun@aliceposta.it
Traduzione documento + + +Lavorare con i File Dati &XML; (Entità) + +Se non è visualizzata la finestra di dialogo dell'inspector utilizza la voce del menu Strumenti Visualizza inspector. Per lavorare con le entità fai clic sulla linguetta Entità della finestra di dialogo visualizzata. + +Sono elencate qui tutte le entità &XML; esterne incluse per mezzo del file DATA o altri file analoghi. Per questo esempio ho lanciato &kxsldbg; sul file testdoc.xsl con il file testdoc.xml (che si trova nella cartella <KDE PREFIX>/share/apps/kxsldbg) così che possiate vedere alcune entità. + + +La Finestra Entità + + + + +La Finestra Entità + + + +Facendo clic sulla un'entità nella lista visualizzata sposterà il cursore nella finestra principale all'inizio del file indicato. + diff --git a/doc/it/kxsldbg/glossary.docbook b/doc/it/kxsldbg/glossary.docbook new file mode 100644 index 0000000..7284d14 --- /dev/null +++ b/doc/it/kxsldbg/glossary.docbook @@ -0,0 +1,35 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +SamueleKaplun
kaplun@aliceposta.it
Traduzione italiana del Manuale + + + + +Parole chiave + +&xsldbg; + +Guarda su . + + + + +XPath + +Un'espressione valida che definisce quali dati sono richiesti. Guarda sul sito web del W3C. + + + + +QName + +Un nome pienamente qualificato. Per esempio, xsl:miavariabile. Guarda sul sito del W3C + + + + diff --git a/doc/it/kxsldbg/index.docbook b/doc/it/kxsldbg/index.docbook new file mode 100644 index 0000000..8f8ed08 --- /dev/null +++ b/doc/it/kxsldbg/index.docbook @@ -0,0 +1,112 @@ + +KXSLDbg"> + + + + + + + + + + + + + + + xsldbg"> + DTD"> + XSD"> + XSLT"> +]> + + + + +Il Manuale di &kxsldbg; + + +Keith Isdale
k_isdale@tpg.com.au
+ + + +SamueleKaplun
Samuele.Kaplun@cern.ch
Traduzione del documento + + + + +2002 +2003 +2004 +Keith Isdale + + +&FDLNotice; +2004-11-18 +0.5 + + +&kxsldbg; è un'interfaccia grafica per &xsldbg;, che supporta il debug di script &XSLT;. + + + +KDE +xsldbg +libxslt +debugger + + + + +Introduzione + + +Funzionalità + +&kxsldbg; permette l'accesso alla maggior parte dei comandi di &xsldbg; per + +Impostare e modificare breakpoint + + +Visualizzare il valore degli XPaths + + +Visualizzare informazioni riguardo a modelli, variabili, voci dello stack delle chiamate, fogli stile ed entità presenti + + +Imposta e modifica breakpoint e variabili + + +Muoversi attraverso sorgenti &XSL; e documenti &XML; per mezzo degli Xpath + + +Ricercare i PUBLIC e SYSTEM ID nel catalogo &XML; corrente + + + + + + +Caratteristiche recentemente aggiunte +&kxsldbg; adesso può + + +Impostare e modificare variabili + + +Visualizzare il testo nella finestra principale utilizzando le librerie di &kate; + + + + + + + + +Usare &kxsldbg; +&configure-section; &mainwindow-section; &inspector-section; &variables; &callstack; &templates; &sources; &entities; &tools-section; + +&credits-chapter; + + diff --git a/doc/it/kxsldbg/kxsldbg_configure.docbook b/doc/it/kxsldbg/kxsldbg_configure.docbook new file mode 100644 index 0000000..b2fe7cd --- /dev/null +++ b/doc/it/kxsldbg/kxsldbg_configure.docbook @@ -0,0 +1,67 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +SamueleKaplun
kaplun@aliceposta.it
Traduzione del documento + + + +Configurare una Sessione &kxsldbg; + +Puoi iniziare la configurazione facendo clic nella barra dei Menu su Debug Configura... . + + +La finestra di Dialogo Configurazione + + + + +La Finestra di Dialogo Configurazione +La Finestra di Dialogo Configurazione. + + + + +Primi passi + +Per caricare uno foglio stile devi specificare: +il sorgente &XSL; +i dati &XML; +il file di output + + + +Utilizza il pulsante ... per scegliere il file desiderato. Il Sorgente &XSL; ed i dati &XML; possono far riferimento ad un URI che contiene http://, ftp:// o file://. Il File di output deve far riferimento ad un file locale scrivibile. +Per andare avanti con gli esempi, seleziona i seguenti file nella cartella degli esempi <KDE PREFIX>/share/apps/kxsldbg +sorgente &XSL;: testdoc.xsl +dati &XML;: testdoc.xml +File di Output: /tmp/xsldbg_output.txt + + + + + +Lavorare con le Opzioni + +Puoi selezionare zero o più opzioni dalla finestra di dialogo Opzioni. Ogni opzione ha un suggerimento su cosa questa faccia. + + + +Lavorare con i parametri + +Puoi aggiungere zero o più parametri attraverso la sezione Parametri di LibXSLT della finestra di dialogo. Potrai indicare, così, i valori dei parametri al foglio stile. + +Per esempio puoi inserire un Nome parametro chiamato mioparametro con un Valore parametro impostato come 'Ciao Mondo!', quindi fare clic sul pulsante Aggiungi. Per aggiornare il valore di un parametro esistente basta raggiungere il valore che desideri modificare con i pulsanti Precedente o Successivo, fornire un nuovo Valore parametro e poi fare clic sul pulsante Applica. + + + +Applicare le Modifiche + +Per far sì che le modifiche che hai fatto abbiano effetto premi il pulsante Applica. Per ignorare qualsiasi cambiamento premi il pulsante Annulla. + +Puoi chiudere la finestra di dialogo utilizzando la X a disposizione in alto a destra nella finestra. Se hai bisogno di modificare la configurazione basta che riapri la finestra di dialogo configurazione come mostrato. + + diff --git a/doc/it/kxsldbg/kxsldbg_inspector.docbook b/doc/it/kxsldbg/kxsldbg_inspector.docbook new file mode 100644 index 0000000..f6dba8c --- /dev/null +++ b/doc/it/kxsldbg/kxsldbg_inspector.docbook @@ -0,0 +1,71 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +SamueleKaplun
kaplun@aliceposta.it
Traduzione del documento + + +Impostare e Modificare i Breakpoint + +La finestra principale è la via primaria per lavorare con i breakpoint. Guarda + +Una volta che hai lanciato il foglio stile, puoi usare la voce del menu Strumenti Mostra ispettori . Poi fai clic sulla linguetta dei Breakpoint. Guarda sotto per un esempio. + + +Impostare i Breakpoint + + + + +Impostare i Breakpoint + + + + +Aggiungere un Breakpoint + +Puoi aggiungere un breakpoint indicando uno tra: + +un file e un numero di riga + +il nome di un modello + +un nome di un modello e di una modalità + +il nome di una modalità + + + + +E poi premendo il pulsante Aggiungi. + + + +Dettagli degli Argomenti + +Il nome di un file può essere un percorso assoluto verso un file locale. Un nome di file parziale (ad esempio xsldoc.xsl). + +Un modello o il nome di una modalità può essere un Nome pienamente Qualificato, dove la parte non locale è opzionale, Ad esempio xsl:mytemplate corrisponde a mytemplate + + + +Cancellare un Breakpoint + +Per prima cosa fai clic col mouse sul breakpoint che vuoi cancellare nella lista dei breakpoint correnti. Poi fai clic sul pulsante Elimina. + + + +Cancellare Tutti i Breakpoint + +Fai clic sul pulsante Pulisci. + + + +Abilitare o Disabilitare un Breakpoint + +Per prima cosa fai &LMB; clic sul breakpoint che vuoi abilitare nella lista dei breakpoint correnti. Poi fai clic sul pulsante Abilitato. + + diff --git a/doc/it/kxsldbg/kxsldbg_mainwindow.docbook b/doc/it/kxsldbg/kxsldbg_mainwindow.docbook new file mode 100644 index 0000000..2beb7bc --- /dev/null +++ b/doc/it/kxsldbg/kxsldbg_mainwindow.docbook @@ -0,0 +1,443 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +SamueleKaplun
kaplun@aliceposta.it
Traduzione del documento + + +Usare la Finestra Principale + + +La finestra principale + + + + +Una vista testuale del file correntemente analizzato +Una vista testuale del file correntemente analizzato. + + + + +Lavorare con la Finestra Principale + +Lo stato di un determinato breakpoint viene indicato attraverso il testo relativo con un differente colore dello sfondo. Puoi scegliere il colore desiderato: gurda nella finestra di dialogo ImpostazioniConfigura editor la scheda Colori. + + +Puoi impostare, disabilitare o cancellare un breakpoint utilizzando il menu Debug o i pulsanti sulla barra degli strumenti. + +Puoi muovere il cursore attraverso il testo utilizzando i seguenti tasti: + + +Tasti freccia: Freccia Sinistra, Freccia Destra, Freccia Su o Freccia Giù. +Tasti Pagina: Pagina Su o Pagina giù + + + + + + +Lavorare con l'Output di &kxsldbg; + +La maggior parte dell'output di &kxsldbg; viene catturato e presentato nella finestra di dialogo degli ispettori o nella finestra dell'output di &kxsldbg;. Le eccezioni a questa regola sono: + + +Un messaggio di errore proveniente da &kxsldbg; viene visualizzato dentro ad una finestra di messaggio. + + +Il risultato della valutazione di un'espressione viene visualizzato in una finestra di messaggio. + + +L'output di una ricerca viene inviato al file indicato nella finestra di output di &kxsldbg;. + + + + + + + + diff --git a/doc/it/kxsldbg/kxsldbg_tools.docbook b/doc/it/kxsldbg/kxsldbg_tools.docbook new file mode 100644 index 0000000..98c49dc --- /dev/null +++ b/doc/it/kxsldbg/kxsldbg_tools.docbook @@ -0,0 +1,77 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +SamueleKaplun
kaplun@aliceposta.it
Traduzione del documento + + + +Strumenti Eterogenei + +Sono disponibili diversi strumenti attraverso il menu strumenti. Il principale è l'inspector. + + +Strumento Inspector + +L'inspector contiene tutte le finestre di dialogo individuali per lavorare con: + +Breakpoint +Modelli +Variabili +Voci del callstack +File sorgenti &XSL; +Entità &XML; + + + + + +Esecuzione passo-passo + +Facendo clic sul menu Scorri il Foglio Stile..., si apre una finestra di dialogo che permette di scegliere la velocità del passo. + + +La Finestra Passo + + + + +La Finestra Passo + + + +Per terminare l'avanzamento usa o il tasto W o seleziona la voce del menu Scorri il Foglio di Stile.... + + + +Cerca Entità &XML; + +Per cercare uno System ID nel catalogo &XML; corrente utilizza il menu Cerca SystemID e poi inserisci il valore da trovare nella finestra di dialogo visualizzata. + + +La Finestra System ID + + + + +La Finestra System ID + + + +Per cercare un PUBLIC ID utilizza la voce del menu Cerca PublicID ed inserisci il valore da cercare nella finestra di dialogo che viene visualizzata. + + +La Finestra Public ID + + + + +La Finestra Public ID + + + + + diff --git a/doc/it/kxsldbg/sources.docbook b/doc/it/kxsldbg/sources.docbook new file mode 100644 index 0000000..352c02b --- /dev/null +++ b/doc/it/kxsldbg/sources.docbook @@ -0,0 +1,27 @@ + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +SamueleKaplun
kaplun@aliceposta.it
Traduzione italiana del Manuale + + +Lavorare con i file sorgenti &XSLT; + +Se non viene visualizzata la finestra di dialogo dell'inspector utilizza la voce del menu Strumenti Visualizza inspector. Per lavorare con i sorgenti fai clic sulla linguetta dei sorgenti della finestra di dialogo visualizzata. + +Sono elencati qui tutti i file sorgenti &XSLT; che sono inclusi dal file &XSLT; o da uno dei suoi fratelli. + + +La Finestra dei Sorgenti + + + + +La Finestra dei Sorgenti + + + +Facendo clic su una voce nella lista visualizzata sposterà il cursore nella finestra principale all'inizio del file indicato. + diff --git a/doc/it/kxsldbg/templates.docbook b/doc/it/kxsldbg/templates.docbook new file mode 100644 index 0000000..2d01f8b --- /dev/null +++ b/doc/it/kxsldbg/templates.docbook @@ -0,0 +1,20 @@ + +Lavorare con i Modelli + +Se non viene visualizzata la finestra di dialogo dell'inspector utilizza la voce del menu Strumenti Visualizza inspector. Per lavorare con i modelli fai clic sulla linguetta dei modelli della finestra di dialogo visualizzata. + +Tutti i modelli trovati sono visualizzati qui. Fai attenzione che le regole di esportazione di &XSLT; siano applicate. Solo in quel caso potrebbe esserci più di un modello con la stessa corrispondenza e dettagli di modo. + + +La Finestra dei Modelli + + + + +La Finestra dei Modelli + + + +Facendo clic sulla voce di un modello nella lista visualizzata sposterà il cursore nella finestra principale nel file e alla linea indicata. + + diff --git a/doc/it/kxsldbg/variables.docbook b/doc/it/kxsldbg/variables.docbook new file mode 100644 index 0000000..88f6edd --- /dev/null +++ b/doc/it/kxsldbg/variables.docbook @@ -0,0 +1,44 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +SamueleKaplun
kaplun@aliceposta.it
Traduzione del documento + + + +Lavorare con le Variabili + +Se non è visibile la finestra di dialogo dell'inspector utilizza la voce del menu Strumenti Visualizza inspector . + +Le variabili locali e globali sono visualizzate in una scheda separata nella finestra di dialogo dell'inspector. L'esempio seguente mostra un pezzo di codice XSLT che dichiara una variabile globale e una locale + +<xsl:variable name="globalvariable" select="'pippo'"/> + + <xsl:template match="/"/> + <xsl:param name="localvariable" select="'pluto'"/> + </xsl:template match="/"/> + + +Facendo clic con il mouse su una variabile nella lista verranno visualizzate le informazioni di riepilogo in basso nella finestra di dialogo. Se una variabile ha un'espressione di selezione, per esempio + +<xsl:variable name="modificabile" select="'vecchioValoree'" /> + + +potrà essere scelto un nuovo XPath inserendo un nuovo valore per Espressione variabile e premendo quindi il pulsante Imposta espressione. + + +La scheda Variabili + + + + +La scheda Variabili +La scheda Variabili + + + +Facendo clic sulla voce di una variabile nella lista visualizzata sposterà il cursore nella finestra principale nel file e alla linea indicata. + diff --git a/doc/it/xsldbg/commands.docbook b/doc/it/xsldbg/commands.docbook new file mode 100644 index 0000000..27a1122 --- /dev/null +++ b/doc/it/xsldbg/commands.docbook @@ -0,0 +1,758 @@ + + +Guida ai comandi + +Addparam +Aggiunge un parametro libxslt ; equivalente a fornire --param <QNAME>:<XPATH> attraverso la riga di comando. + +Uso di addparam + +addparam <QNAME> <XPATH>    (Lo <XPATH> non deve contenere alcuno spazio né virgolette doppie.) +addparam <QNAME> "<XPATH>"    (Non deve contenere virgolette doppie in <XPATH>) + + +
+ + +Addwatch +Aggiunge un'espressione da osservare. Vedi showwatch per i valori di osservazione +Nome scorciatoia: watch +Uso di addwatch + +addwatch <XPATH> + + +
+ + +Base +Stampa l'indirizzo base per questo nodo +Uso di base + + +base + + +
+ + +Break +Interrompe su un template, alla posizione di un foglio di stile o ad un file xml caricato da xsldbg, o al nodo corrente. È un comando introdotto in xsldbg 3.1.4: Quando si è in modalità compatibile con gdb i punti di interruzione rimasti orfani possono essere impostati per un file ed un numero di riga specificati ed essere risolti ad un punto effettivo più tardi. +Nome scorciatoia: bxsldbg cercherà di indovinare l'URL completo a partire dal nome del file senza il percorso specificato nome del file nella stessa directory del foglio di stile principale caricato nome del file relativo alla directory di lavoro corrente di xsldbg Cioè se hai caricato il foglio stile ../en/xsldoc.xsl, puoi fare questo: break -l xsldoc.xsl 26 Questo comando troverà corrispondenze con template di QNAME parziali completi e/o nomi di modi forniti. Ad esempio template corrisponderà con successo ad ogni QNAME che ha come parte locale template Uno spazio dei nomi fornito in QNAME sarà espanso come specificato dagli spazi dei nomi definiti nel file sorgente XSL. Ad es. xsl:test1 sarà espanso come http://www.w3.org/199/XSL/Transform:test1 Un punto di interruzione richiesto può essere risolto come l'URL associato e il numero di riga. Ciò è fatto automaticamente dopo che il primo template è stato visto da xsldbg. I punti di interruzione sono ri-convalidati poco dopo l'avvio di ogni esecuzione. La convalida automatica dei punti di interruzione è usata quando è in uso la modalità gdb – il comportamento predefinito di xsldbg +Uso di break + + +break -l <NOMEFILE> <NUMRIGA>    (Per impostare un breakpoint sul file e numero di riga specificati) +break -l <URI> <NUMRIGA>    (Per impostare un breakpoint sull'URI e numero di riga specificati) +break <NOME_TEMPLATE>    (Per interrompere sul template indicato o corrispondente.) +break <NOME_TEMPLATE> <NOME_MODO>    (Per interrompere sul template indicato con la modalità data.)> +break "" <NOME_MODO>    (Per arrestarsi su un template qualsiasi che ha un dato nome) +break *    (Per arrestarsi quando si incontra un template qualsiasi.) +break \*    (Per arrestarsi al template "*". Altri nomi che includono '*' non verranno trattati in modo speciale.) +break     (Per inserire un punto di arresto sul nodo corrente. Include nodi dati xml!) + + +
+ + +Bye +Esce dal processamento del foglio di stile il più presto possibile. +Uso di bye + + +bye + + +
+ + +Cat +Stampa il risultato di un'espressione xpath nella modalità relativa corrente. +Uso di cat + + +Uso : cat <XPATH>    (Per vedere una variabile o un parametro) +Uso : cat $<QNAME> + + +
+ + +Cd +Cambia il percorso a quello specificato da un xpath. +Uso di cd + + +<< = preceding-sibling::node() +>> = following-sibling::node() +<- = ancestor::node() +-> = decendant::node() + +
+ + +Chdir +Cambia la cartella di lavoro +Uso di chdir + + +chdir <PATH>    (Un percorso relativo o assoluto del sistema operativo) + + +
+ + +Continue +Continua ad eseguire un foglio di stile, fermandosi su ogni breakpoint trovato. +Nome scorciatoia: c +Uso di continue + + +continue + + +
+ + +Data +Commuta sulla visualizzazione del nodo corrente dei dati xml. Oppure cambia i dati xml da usare +Uso di data + + +data    (Va al nodo corrente del documento.) +data <DATA>    (Per usare un nuovo file di dati xml. Un ~ iniziale è sostituito dal valore della variabile di ambiente $HOME. Sarà necessario usare il comando run per processarlo) + + +
+ + +Delete +Elimina il punto di interruzione di un modello +Nome scorciatoia: d +Uso di delete + + +delete    (Per eliminare un punto di interruzione al nodo corrente) +delete <ID_BREAKPOINT>    (Per eliminare il punto di interruzione al numero di interruzione specificato) +delete -l <NOMEFILE> <NUMRIGA>    (Per eliminare nel file specificato, alla riga indicata) +delete -l <URI> <NUMRIGA>    (Per eliminare nell'URI specificato, alla riga indicata) +delete <NOMETEMMPLATE>    (Per eliminare un punto di interruzione nel template indicato) +delete *    (Per eliminare tutti i punti di interruzione) + + +
+ + +Delparam +Elimina un parametro libxslt +Uso di delparam + + +delparam    (Elimina tutti i parametri presenti) +delparam <ID_PARAM> + + +
+ + +Delwatch +Elimina un'espressione di osservazione o elimina tutte le espressioni di osservazione mostrate dal comando showwatch +Uso di delwatch + + +delwatch <WATCHID>    (Elimina un'espressione di osservazione con l'ID dato) +delwatch *    (Elimina tutte le espressioni di osservazione) + + +
+ + +Dir +Stampa una lista di nodi in modo simile al comando della shell dir. + +Uso di dir + + +dir + + +
+ + +Disable +Disabilita un breakpoint +Uso di disable + + +disable    (Per disabilitare un punto di interruzione nel nodo corrente) +disable <ID_BREAKPOINT>    (Per disabilitare un punto di interruzione col numero specificato +disable -l <FILENAME> <LINENO>    (Disabilita un punto di interruzione alla riga e al file specificati) +disable -l <URI> <LINENO>    (Disabilita un punto di interruzione alla riga e all'URI specificati) + + +
+ + +Du +Stampa un riassunto dei nodi figli in un formato al albero. +Uso di du + + +du + + +
+ + +Dump +Mostra tutti i dettagli del nodo +Uso di dump + + +dump + + +
+ + +Enable +Abilita o disabilita un breakpoint (Commuta abilita/disabilita/) +Nome scorciatoia: e +Uso di enable + + +enable    (Per abilitare/disabilitare un punto di interruzione al nodo corrente) +enable <ID_BREAKPOINT>    (Per abilitare/disabilitare il punto di interruzione col numero specificato +enable -l <NOMEFILE> <NRIGA>    (Abilita/disabilita un punto di interruzione per file e riga specificati) +enable -l <URI> <NRIGA>    (Abilita/disabilita un punto di interruzione per URI e riga specificati) + + +
+ + +Entities +Stampa l'elenco delle entità General Parsed usate dal file di dati (documento) +Nome scorciatoia: ent +Uso di entities + + +entities + + +
+ + +Exit +Esce dal processamento del foglio di stile il più presto possibile. +Uso di exit + + +exit + + +
+ + +Frame +Stampa il frame dello stack alla profondità indicata +Nome scorciatoia: f +Uso di frame + + +frame <PROFONDITÀ_FRAME>    (La profondità è un numero da 0 alla profondità attuale dello stack delle chiamate) + + +
+ + +Free +Libera il foglio di stile ed i dati (Disabilitato, vedi run) +Uso di free + + +free + + +
+ + +Globals +Stampa un elenco delle variabili o dei parametri globali del foglio di stile. Stampa il valore di una variabile globale +Uso di globals + + +globals    (Stampa un elenco di tutte le variabili globali disponibili) +globals -f    (Stampa un elenco di tutte le variabili globali disponibili ed i loro valori) +globals <NOMEQ>    (Stampa il valore della variabile specificata) + + +
+ + +Help +Mostra l'aiuto su un comando o una breve introduzione +Nome scorciatoia: h +Uso di help + + +help     (Mostra l'introduzione del prodotto) +help <COMMAND>     (Mostra l'aiuto del comando) + + +
+ + +Load +Carica le opzioni di xsldbg e le preferenze utente dal disco +Uso di load + + +load + + +
+ + +Locals +Stampa una lista di variabili o parametri di un foglio di stile locale. Stampa il valore di una variabile locale +Uso di locals + + +locals    (Stampa l'elenco di tutte le variabili locali disponibili) +locals -f    (Stampa l'elenco di tutte le variabili locali disponibili ed i loro valori) +locals <NOMEQ>    (Stampa il valore della variabile specificata) + + +
+ + +Ls +Elenca i nodi in un formato breve +Uso di ls + + +ls + + +
+ + +Next +Salta oltre un xsl:call-template o xsl:apply-templates. Ha lo stesso effetto dell'esecuzione del comando "step" seguito da "up" +Nome scorciatoia: n +Uso di next + + +next    (procede alla successiva istruzione allo stesso livello) + + +
+ + +Options +Stampa i valori delle opzioni di xsldbg +Uso di options + + +options + + +
+ + +Output +Specifica un file locate e scrivibile da usare per l'output dei risultati +Nome scorciatoia: o +Uso di output + + +output <NOMEFILE>    (Un nome di file su cui è permesso scrivere. Può avere un prefisso "~" sulle piattaforme *nix e CYGWIN, o può avere variabili di ambiente in RISC OS) +output <URI>    (L'<URI> può usare solo il protocollo "file://". È convertito al nome di un file adatto al sistema operativo) +output -    (invia all'output standard. Può essere usato solo al prompt dei comandi di xsldbg) + + +
+ + +Public +Stampa il valore associato ad un ID pubblico attraverso li catalogo corrente +Nome scorciatoia: pub +Uso di public + + +public "<IDPubblico>" + + +
+ + +Pwd +Stampa la cartella di lavoro corrente. +Uso di pwd + + +pwd + + +
+ + +Quit +Esce dal processamento del foglio di stile il più presto possibile. +Nome scorciatoia: q +Uso di quit + + +quit + + +
+ + +Run +Riavvia il foglio di stile. +Nome scorciatoia: r +Uso di run + + +run + + +
+ + +Save +Salva le opzioni di xsldbg e le preferenze utente sul disco +Uso di save + + +save + + +
+ + +Search +Cerca in una banca dati di informazioni raccolte dai fogli di stile caricati +tutti i file di output sono scritti sul percorso specificato da "searchresultspath", se l'opzione è specificata, o nella stessa directory del foglio di stile fornito. searchresults.xml è normalmente trasformato da search.xsl, ma sarà trasformato da seachhtml.xsl se l'opzione "preferhtml" è impostata. Quando viene eseguito il comando di ricerca, sarà creato un file xml (searchresults.xml). Potrai quindi elaborare questo file con un tuo foglio di stile per presentare i dati in altri modi. Se l'opzione "preferhtml" non è impostata, verrà stampato sullo schermo searchresult.txt A seconda della quantità di dati raccolti, il completamento di questo comando può richiedere parecchio tempo. +Uso di search + + +search <XPATH>    (Per vedere quale xpath può essere usato, vedi search.dtd. L'<XPATH> predefinito è '//search/*' ) +search -sort <XPATH>    (Indica a search.xsl di ordinare i risultati prima di emetterli) + + +
+ + +Set +Imposta il valore di una variabile +Uso di set + + +set <NOME_VARIABILE> <XPATH> + + +
+ + +Setoption +Imposta una opzione per l'esecuzione di un foglio di stile +Dovrai usare il comando run per attivare le modifiche +Uso di setoption + + +setoption <NOME_OPZIONE> <VALORE_INTERO> +Dove <NOME_OPZIONE> può essere + + + + + debug    (Se <VALORE_INTERO> vale true mostra l'intero albero del risultato) + catalogs    (Se <VALORE_INTERO> vale true usa i cataloghi da $SGML_CATALOG_FILES o SGML$CatalogFiles per il sistema operativo RISC) + html    (Se <VALORE_INTERO> vale true il documento in ingresso è un file HTML) + docbook    (Se <VALORE_INTERO> vale true e docbook è ancora supportato da libxml il documento in ingresso è un docbook SGML) + xinclude    (Se <VALORE_INTERO> vale true esegue l'elaborazione di XInclude sui documenti in ingresso) + preferhtml    (Se <VALORE_INTERO> vale true viene preferita l'uscita HTML per i risultati della ricerca. Vedi il comando search) + autoencode    (Se <VALORE_INTERO> vale true cerca di usare la codifica del foglio di stile) + utf8input    (Se <VALORE_INTERO> vale true tutto l'input dell'utente è in UTF-8. Questo è usato normalmente quando xsldbg è eseguito come thread) +      + gdb    (Esegui in modalità compatibile con gdb) + Il valore 1 significa + Stampa molti più messaggi. Aumenta la frequenza della stampa di "Punto di interruzione su..." + Verranno stampate al massimo GDB_LINES_TO_PRINT righe quando è valutata un'espressione, seguite da dei puntini di sospensione ("..."). Vedi options.h per cambiarne il valore, salvo modifiche saranno stampate tre righe di testo. + Stampa sia le variabili globali che le locali quando si usa il comando "locals" + Quando si stampano espressioni con cat/print, il valore valutato sarà preceduto da "= " < EXPRESSION > + + + + + + Il valore 2 significa Stampa i messaggi necessari a KDbg oltre allo stati dell'output di cui sopra (quando il valore è 1) + + + + + + + + + nonet    (Se <VALORE_INTERO> vale true rifiuta di prelevare DTD o entità dalla rete) + novalid    (Se <VALORE_INTERO> vale true salta la fase di caricamento del DTD) + repeat    (Se <VALORE_INTERO> vale true esegue la trasformazione 20 volte) + profile    (Se <VALORE_INTERO> vale true stampa le informazioni di profilazione) + timing    (Se <VALORE_INTERO> vale true stampa il tempo usato) + noout    (Se <VALORE_INTERO> vale true non viene stampato il risultato) + + + + +Dove il valore è true se non è uguale a zero +Dove il valore è false se è uguale a zero +stdout    Stampa tutti i messaggi di errore su stdout. Normalmente i messaggi di errore vanno a stderr. +setoption <NOME_OPZIONE> "<VALORE_STRINGA>"    (Non deve contenere virgolette doppie in <VALORE_STRINGA>) +setoption <NOME_OPZIONE> <VALORE_STRINGA>    (Non deve contenere spazi né virgolette doppie in <VALORE_STRINGA>) +Dove <NOME_OPZIONE> può essere + + + + + data    (URI del file di dati) + source    (URI del file sorgente) + output    (SystemID del file in uscita) + docspath    (Percorso da usare per la ricerca della documentazione) + catalognames    (I nomi dei cataloghi da usare quando è impostata l'opzione dei cataloghi. Il valore andrà perduto se l'impostazione è effettuata prima dell'opzione dei cataloghi) + encoding    (Quale codifica usare per l'output standard) + searchresultspath    Quale percorso usare per memorizzare i risultati della ricerca. Se non è impostata, xsldbg userà il percorso del foglio di stile + + + + + +
+ + +Shell +Esegue comandi della shell +Uso di shell + + +shell <TESTO>    (<TESTO> è il testo da passare al sistema operativo per l'esecuzione) + + +
+ + +Showbreak +Per mostrare un elenco dei punti di interruzione +Nome scorciatoia: showSe esiste un modo sul punto di interruzione di un template, verrà inserito in fondo al nome del template del punto di interruzione. Un esempio dell'uscita è: +Breakpoint 3 enabled for template :"*" in file test1.xsl : line 105 +Breakpoint 2 enabled for template :"* testMode" in file test1.xsl : line 109 +Breakpoint 1 enabled for template :"* http://www.w3.org/1999/XSL/Transform:testMode" in file test1.xsl : line 113 + +Total of 3 breakpoints present + +Uso di showbreak + + +showbreak + + +
+ + +Showparam +Stampa i parametri libxslt presenti +Uso di showparam + + +showparam + + +
+ + +Showwatch +Mostra l'espressione corrente sotto osservazione +Nome scorciatoia: watches +Uso di showwatch + + +showwatch    (Mostra le espressioni sotto osservazione attualmente selezionate ed i loro valori) +showwatch 1    (Abilita la stampa automatica delle espressioni sotto osservazione. È la modalità predefinita) +showwatch 0    (Disabilita la stampa automatica delle espressioni sotto osservazione) + + +
+ + +Source +Passa a mostrare il nodo corrente del foglio di stile. Oppure cambia il foglio di stile da usare +Uso di source + + +source    (Va al nodo corrente del foglio stile) +source <SORGENTE>    (Per cambiare file sorgente. Un "~" iniziale è sostituito dal valore della variabile di ambiente $HOME. È necessario usare il comando "run" per eseguire la modifica) + + +
+ + +Step +Passa alla prossima istruzione del foglio di stile. +Nome scorciatoia: s +Uso di step + + +step + + +
+ + +Stepdown +Discende ad un nuovo "frame di chiamata" +Nome scorciatoia: down +Uso di stepdown + + +stepdown     (discende di un frame) +stepdown <NUMERO_DI_FRAME>    (discende nello stack del numero di frame specificato) + + +
+ + +Stepup +Risale ad un "frame di chiamata" più vecchio. +Nome scorciatoia: upQuesto non è un comando accurato, xsldbg cercherà di fermarsi il più vicino possibile. +Uso di stepup + + +stepup     (risale di un frame) +stepup <NUMERO_DI_FRAME>     (risale del numero di frame specificati) + + +
+ + +Stylesheets +Stampa una lista di fogli di stile caricati +Nome scorciatoia: style +Uso di stylesheets + + +stylesheets + + +
+ + + +System +Stampa il valore associato ad un file di sistema attraverso il catalogo corrente +Nome scorciatoia: sys +Uso di system + + +system "<IDSistema>" + + +
+ + +Templates +Stampa una lista di template disponibili. Cerca un template +Nome scorciatoia: t +Uso di templates + + +templates +templates <TEMPLATE>    (Stampa i dettagli di un template chiamato <TEMPLATE> se è presente) + + +
+ + +Trace +Esegue il trace dell'esecuzione del foglio di stile stampando il file e le righe dei passi intermedi +Uso di trace + + +trace + + +
+ + +Tty +Apre un terminale. Imposta il livello di redirezione tty. +Uso di tty + + +tty <PERCORSO_DISPOSITIVO>    (Dove <PERCORSO_DISPOSITIVO> è un terminale valido del sistema operativo. Prova soltanto ad aprire il terminale +tty <LIVELLO_TTY>    (Imposta il livello di ridirezione su tty, dove <LIVELLO_TTY> è un livello valido di input/output da usare) + Dove livello è + 0 = Input/output predefiniti + 1 = uscita su terminale del risultato della trasformazione, dei trace e dell'esecuzione passo-passo     (Stato predefinito quando il dispositivo tty device è stato aperto. Non ancora completamente implementato.) + 2 = Redirezione completa al terminale    (Non ancora implementato.) + Tutti gli altri valori interi sono interpretati come livello 0 + + + + + + +
+ + +Validate +Convalida il file di output generato dal foglio di stile (disabilitato) +Uso di validate + + +validate + + +
+ + +Walk +Esegue passo a passo il codice usando una gamma di velocità +Uso di walk + + +walk <VELOCITÀ>    (Usa &Ctrl;-c per interrompere l'esecuzione, <VELOCITÀ> è un valore tra 0 e 9, dove 0 significa fermo, 1 molto veloce e 9 molto lento) + + +
+ + +Where +Stampa la sequenza delle chiamate ai template (lo stack frame) e stampa la directory attuale. +Nome scorciatoia: w +Uso di where + + +where + + +
+ + +Write +Da completare +Uso di write + + +write + + +
+ + + + + + + diff --git a/doc/it/xsldbg/credits.docbook b/doc/it/xsldbg/credits.docbook new file mode 100644 index 0000000..865d353 --- /dev/null +++ b/doc/it/xsldbg/credits.docbook @@ -0,0 +1,14 @@ + + +Riconoscimenti e licenza + +&xsldbg; +Copyright del programma 2004 Keith Isdale k_isdale tpg com au + +Fabio Avallone, Federico Zenith +&underFDL; &underGPL; +Grazie a +Gli autori di libxml e libxsl. +Johannes Sixt per aver aggiunto il supporto di xsldbg a KDbg + + diff --git a/doc/it/xsldbg/index.docbook b/doc/it/xsldbg/index.docbook new file mode 100644 index 0000000..5431ee7 --- /dev/null +++ b/doc/it/xsldbg/index.docbook @@ -0,0 +1,96 @@ + +xsldbg"> + + + + + + + + +]> + + + + + + + + + + + +Guida di &xsldbg; + + +Keith Isdale
k_isdale@tpg.com.au
+ + + +LorenzoCombatti
com_89@hotmail.com
Traduzione della documentazione + + + + +2002 +2003 +Keith Isdale + + +&FDLNotice; +2004-09-26 +1.01.00 + + + +&xsldbg; è uno strumento progettato per aiutare a capire i fogli di stile. Ciò che lo rende differente dagli altri programmi per il debug di fogli di stile è la capacità di cercare oggetti interessanti e di rintracciare l'esecuzione dei fogli di stile. + + + +KDE +tdeutils +xsldbg +xsl +XML + + + + +&introduction-chapter; +&usage-chapter; +&commands-chapter; +&credits-chapter; + + + +Installazione + + +Come ottenere &xsldbg; + +Vedi il componente kxsldbg del modulo tdewebdev nell'SVN di &kde;. +&install.intro.documentation; + + +Requisiti + +Per poter utilizzare &xsldbg; devi avere installate le librerie libxslt, libexslt e libxml di &kde; (sono normalmente disponibili nell'installazione tipica di &kde;). + + + +Compilazione e Installazione +&xsldbg; normalmente è compilato come parte delle componenti di kxsldbg nel modulo tdewebdev + + + +Configurazione + +&xsldbg; è configurato usando gli argomenti passati dalla linea di comando e dal suo comando setoption + + + + + +&documentation.index; + diff --git a/doc/it/xsldbg/introduction.docbook b/doc/it/xsldbg/introduction.docbook new file mode 100644 index 0000000..9be6302 --- /dev/null +++ b/doc/it/xsldbg/introduction.docbook @@ -0,0 +1,16 @@ + + +Introduzione + +&xsldbg; è uno strumento basato sul testo per effettuare il debug dei fogli di stile (il linguaggio per i fogli di stile estendibili - eXtensible Stylesheet Language) e fornisce comandi simili al programma Unix/Linux per il debug gdb. Fornisce tre modalità principali di esecuzione dei fogli di stile. + + + + Esegui l'intero foglio di stile + Passa alla prossima istruzione xsl + Continua fino al prossimo punto di arresto, oppure fino all'inizio del foglio di stile + + + + + diff --git a/doc/it/xsldbg/usage.docbook b/doc/it/xsldbg/usage.docbook new file mode 100644 index 0000000..36ba4e6 --- /dev/null +++ b/doc/it/xsldbg/usage.docbook @@ -0,0 +1,62 @@ + + +Utilizzo di &xsldbg; + +argomenti del comando xsldbg +Sui sistemi nei quali è disponibile la libreria readline puoi usare i tasti indietro/avanti per navigare nell'elenco dei comandi inseriti. Su tutti i sistemi l'ultimo comando inserito può essere ripetuto premendo semplicemente il tasto <INVIO>. +Se il tuo sistema operativo lo supporta, i nomi di file verranno espansi. +Diversi comandi accettano più di un argomento. Le virgolette (") possono essere utilizzare per far sì che espressioni complesse vengano trattate come un solo argomento. Ad esempio, break "* | @" ti permette di impostare un breakpoint sul template di nome "* | @" + + +Legenda dei termini +La seguente tabella descrive i termini utilizzati nella guida ai comandi subito dopo + + + NOME_TEMPLATE : Un nome di template valido contiene solo codici di caratteri ASCII da 0x00 a 0x7F. Può essere un nome completamente qualificato, ad esempio "xsl:nomeTemplate". + NOMEFILE : Un nome di file locale al sistema dell'utente. Può avere un prefisso "~" sulle piattaforme *nix e CYGWIN. Oppure variabili di ambiente nei SO (sistemi operativi) RISC + URI : Uno Uniform Resource Identifier (Identificatore uniforme di risorsa) come definito dalla RFC 2396 + NOME_MODO : Il modo di un template che può essere un nome completamente qualificato, ad esempio "xsl:nomeModo". + QNAME : Un nome completamente qualificato, ad esempio "xsl:localPart" + NUMRIGA : Un numero di riga valido nel <NOMEFILE> associato + NUM_DI_FRAME : Un numero di riga nel frame valido col quale cambiare posizione + ID_BREAKPOINT : Un numero valido di break point + ID_WATCH : Un numero valido di espressione di osservazione come indicato dal comando showwatch + PASSO: passo con il quale scorrere il codice, tra 0 e 9 +     (Commento): un commento circa il significato o l'uso di un comando + { opz1 | opz2 | opz2 .. etc} : Scegli una delle opzioni + XPATH : una selezione xpath di nodo/i + ID_PARAM : un numero valido di parametro come indicato dal comando showparam + PERCORSO : Un percorso per cambiare la cartella di lavoro. Su qualche sistema operativo un prefisso di tipo "~" verrà sostituito dal percorso della cartella home + TESTO : Testo libero     (nessuna restrizione) + COMANDO : Un comando valido per xsdbg + QNAME : Un nome valido di variabile/parametro + SORGENTE : Il foglio di stile da eseguire/in esecuzione. Vedi <NOMEFILE> e <URI> + DATI : I dati (documento) xml da processare/in processamento dal foglio di stile. Vedi <NOMEFILE> e <URI> + PERCORSO_DISP : Un terminale valido sul sistema operativo + LIVELLO_TTY : Un livello valido di input/output da utilizzare + + + + +Panoramica dei comandi disponibili + + +Riguardanti l'aiuto :help +Riguardanti l'esecuzione : {bye|exit| quit}, step, stepup, stepdown, next, continue, run, trace, setoption, options +Riguardanti i parametri libxslt : addparam, delparam, showparam, output, setoption, options +Riguardanti i template : templates, where, frame +Riguardanti i break point : break, showbreak, delete, enable +Visualizzazione di espressioni (xpath) : cat +Visualizzazione di nodi : ls, dir, du, cat, pwd +Visualizzazione di variabili : globals, locals, cat, addwatch +Impostazione di variabili: set +Selezione di nodi : source, data, cd +Ricerca :search +Riguardanti il sistema operativo :chdir, shell, tty +Riguardanti i file : output, entities, system, public +Comandi sui file disabilitati: validate, load, save, write, free + + + + + diff --git a/doc/nl/kxsldbg/callstack.docbook b/doc/nl/kxsldbg/callstack.docbook new file mode 100644 index 0000000..dffdd30 --- /dev/null +++ b/doc/nl/kxsldbg/callstack.docbook @@ -0,0 +1,28 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&Sander.Koning;&Tom.Albers; + + + +Met de aanroepstapel werken + +Alle items op de aanroepstapel worden hier weergegeven. Hoe ouder het item op de aanroepstapel, hoe lager het framenummer. Zie hieronder voor een voorbeeld. + + +Het venster Aanroepstapel + + + + +Het venster Aanroepstapel + + + +Als u op een item van de aanroepstapel klikt wordt de cursor in het hoofdvenster verplaatst naar het aangegeven bestand en regelnummer. + + diff --git a/doc/nl/kxsldbg/credits.docbook b/doc/nl/kxsldbg/credits.docbook new file mode 100644 index 0000000..2c90a1f --- /dev/null +++ b/doc/nl/kxsldbg/credits.docbook @@ -0,0 +1,29 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&Sander.Koning;&Tom.Albers; + + +Dankbetuigingen en licenties + +&kxsldbg; © 2004 Keith Isdale +Documentatie © 2004 Keith Isdale + + + +Met dank aan: + +De auteurs van libxml en libxslt. + + +Robert Jacolin voor terugkoppeling over eerdere versies van &kxsldbg;. + + +Igor Zlatkovic voor het maken van WIN32-applicaties van libxml/xslt en &xsldbg;. + + +&underFDL; &underGPL; diff --git a/doc/nl/kxsldbg/entities.docbook b/doc/nl/kxsldbg/entities.docbook new file mode 100644 index 0000000..e9d2dfc --- /dev/null +++ b/doc/nl/kxsldbg/entities.docbook @@ -0,0 +1,28 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&Sander.Koning;&Tom.Albers; + + +Met &XML;-databestanden (entiteiten) werken + +Als het dialoogvenster van de inspector niet zichtbaar is, kiest u Hulpmiddelen Inspectors tonen. Om met entiteiten te werken klikt u op de tab Entiteiten van het venster. + +Alle externe &XML;-entiteiten die ingevoegd zijn via het DATA-bestand of een van de nevenliggende bestanden worden hier weergegeven. Voor dit voorbeeld is &kxsldbg; uitgevoerd op testdoc.xsl met testdoc.xml (uit <KDEMAP>/share/apps/kxsldbg) opdat u wat entiteiten kunt zien. + + +Het venster Entiteiten + + + + +Het venster Entiteiten + + + +Als u op een entiteit in de lijst klikt wordt de cursor in het hoofdvenster verplaatst naar het begin van het aangegeven bestand. + diff --git a/doc/nl/kxsldbg/glossary.docbook b/doc/nl/kxsldbg/glossary.docbook new file mode 100644 index 0000000..aa441f5 --- /dev/null +++ b/doc/nl/kxsldbg/glossary.docbook @@ -0,0 +1,35 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&Sander.Koning;&Tom.Albers; + + + + +Sleutelwoorden + +&xsldbg; + +Zie . + + + + +XPad + +Een geldige expressie die aangeeft welke data nodig is. Zie de W3C website. + + + + +QNaam + +Een volledig gekwalificeerde naam. Bijvoorbeeld xsl:mijnvariabele. Zie de W3C website + + + + diff --git a/doc/nl/kxsldbg/index.docbook b/doc/nl/kxsldbg/index.docbook new file mode 100644 index 0000000..fa23e05 --- /dev/null +++ b/doc/nl/kxsldbg/index.docbook @@ -0,0 +1,110 @@ + +KXSLDbg"> + + + + + + + + + + + + + + + xsldbg"> + DTD"> + XSD"> + XSLT"> + +]> + + + + +Handboek van &kxsldbg; + + +Keith Isdale
k_isdale@tpg.com.au
+ + + + + +2002 +2003 +2004 +Keith Isdale + + +&FDLNotice; +2004-11-18 +0.5 + + +&kxsldbg; biedt een grafische interface als frontend voor&xsldbg;, waarmee u &XSLT;-scripts kunt debuggen. + + + +kde +xsldbg +libxslt +debugger + + + + +Inleiding + + +Mogelijkheden + +Met &kxsldbg; kunt u het merendeel van de opdrachten van &xsldbg; gebruiken om + +Breekpunten te zetten en te wijzigen + + +De waarde van XPaden weer te geven + + +Informatie over de aanwezige sjablonen, variabelen, aanroepstapel, stijlbladen en entiteiten weer te geven + + +Breekpunten en variabelen te zetten en te wijzigen + + +Door &XSL;-bronnen en &XML;-documenten te bladeren met XPaden + + +PUBLIC- en SYSTEM-ID's in de huidige &XML;-catalogus op te zoeken + + + + + + +Recent toegevoegde mogelijkheden +&kxsldbg; kan nu + + +Variabelen instellen en veranderen + + +De tekst in het hoofdvenster weergeven met behulp van de &kate;-bibliotheek + + + + + + + + +&kxsldbg; gebruiken +&configure-section; &mainwindow-section; &inspector-section; &variables; &callstack; &templates; &sources; &entities; &tools-section; + +&credits-chapter; + + diff --git a/doc/nl/kxsldbg/kxsldbg_configure.docbook b/doc/nl/kxsldbg/kxsldbg_configure.docbook new file mode 100644 index 0000000..e46b623 --- /dev/null +++ b/doc/nl/kxsldbg/kxsldbg_configure.docbook @@ -0,0 +1,67 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&Sander.Koning;&Tom.Albers; + + + +Een &kxsldbg;-sessie instellen + +U start het instellen met Debuggen Instellen in de menubalk. + + +Het dialoogvenster Instellen + + + + +Het dialoogvenster Instellen +Het dialoogvenster Instellen. + + + + +Hoe te beginnen + +Om een stijlblad uit te kunnen voeren moet u het volgende opgeven: +het &XSL;-bronbestand +het &XML;-databestand +het uitvoerbestand + + + +Met de knop ... kunt u het gewenste bestand kiezen. &XSL;-bron en >&XML;-data mogen verwijzen naar een URI met http://, ftp:// of file://. Het Uitvoerbestand moet een lokaal beschrijfbaar bestand zijn. +Om de voorbeelden te volgen, kiest u de volgende bestanden in de voorbeeldmap <KDE-MAP>/share/apps/kxsldbg: +&XSL;-bron: testdoc.xsl +&XML;-data: testdoc.xml +Uitvoerbestand: /tmp/xsldbg_output.txt + + + + + +Met opties werken + +U kunt opties kiezen uit het dialoogvenster Opties. Elke optie heeft een ballontekst die u informatie geeft over het effect van die optie. + + + +Met parameters werken + +U kunt parameters toevoegen via de sectie LibXSLT-parameters. Hiermee kunt u parameterwaarden aan het stijlblad meegeven. + +U kunt bijvoorbeeld als Parameternaam mijnparam kiezen met alsParameterwaarde 'Hallo wereld!' en vervolgens de knop Toevoegen kiezen. Om de waarde van een bestaande parameter te wijzen kunt u de knoppen Vorige en Volgende gebruiken, een nieuwe Parameterwaarde invoeren en dan de knop Toepassen kiezen. + + + +Wijzigingen toepassen + +Als u wilt dat de wijzigingen in werking treden, moet u de knop Toepassen kiezen. Om wijzigingen ongedaan te maken kiest u de knop Annuleren. + +U kunt het dialoogvenster sluiten met de X in de rechterbovenhoek van het venster. Als u de instellingen weer wilt wijzigen opent u het instellingenvenster als hiervoor. + + diff --git a/doc/nl/kxsldbg/kxsldbg_inspector.docbook b/doc/nl/kxsldbg/kxsldbg_inspector.docbook new file mode 100644 index 0000000..d482824 --- /dev/null +++ b/doc/nl/kxsldbg/kxsldbg_inspector.docbook @@ -0,0 +1,71 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&Sander.Koning;&Tom.Albers; + + +Breekpunten zetten en wijzigen + +De belangrijkste manier om met breekpunten te werken is via het hoofdvenster. Zie + +Als u het stijlblad gestart hebt, kunt u het menu-item Hulpmiddelen Inspectors tonen kiezen. Klik dan op de tab Breekpunten. Zie hieronder voor een voorbeeld. + + +Breekpunten zetten + + + + +Breekpunten zetten + + + + +Een breekpunt toevoegen + +U kunt een breekpunt toevoegen door een van onderstaande op te geven: + +een bestand en een regelnummer + +een sjabloonnaam + +een sjabloonnaam en een modusnaam + +een modusnaam + + + + +En dan op de knop Toevoegen te klikken. + + + +Details bij argumenten + +Een bestandsnaam mag een absoluut pad naar een lokaal bestand zijn, of een gedeeltelijke naam (⪚ xsldoc.xsl). + +Een sjabloon- of modusnaam is een gekwalificeerde naam (QName) waarbij het niet-lokale deel optioneel is ⪚ xsl:mijnsjabloon klopt met mijnsjabloon. + + + +Een breekpunt verwijderen + +Klik eerst met de linkermuisknop op het breekpunt dat u wilt verwijderen. Klik dan op de knop Verwijderen. + + + +Alle breekpunten verwijderen + +Klik op de knop Alle verwijderen. + + + +Een breekpunt in- of uitschakelen + +Klik eerst met de &LMB; op het breekpunt dat u wilt inschakelen. Klik dan op de knop Inschakelen. + + diff --git a/doc/nl/kxsldbg/kxsldbg_mainwindow.docbook b/doc/nl/kxsldbg/kxsldbg_mainwindow.docbook new file mode 100644 index 0000000..45ff643 --- /dev/null +++ b/doc/nl/kxsldbg/kxsldbg_mainwindow.docbook @@ -0,0 +1,443 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&Sander.Koning;&Tom.Albers; + + +Het hoofdvenster gebruiken + + +Het hoofdvenster + + + + +Een tekstweergave van het bestand dat gedebugd wordt. +Een tekstweergave van het bestand dat gedebugd wordt. + + + + +Met het hoofdvenster werken + +De status van een bepaald breekpunt wordt aangegeven met de bijbehorende tekst en een achtergrondkleur. U kunt de gewenste kleuren instellen: zie de pagina Kleuren in het dialoogvenster Instellingen Editor instellen. + + +U kunt een breekpunt zetten, uitschakelen of verwijderen met toetsen, het menu Debuggen of de knoppen op de werkbalk. + +U kunt de cursor door de tekst verplaatsen met de volgende toetsen: + + +Pijltoetsen: Links, Rechts, Omhoog of Omlaag. +Paginatoetsen: Page Up en Page Down + + + + + + +Met de uitvoer van &kxsldbg; werken + +De meeste uitvoer van &kxsldbg; wordt opgevangen en weergegeven in het inspector-dialoog of het uitvoervenster van &kxsldbg;. Uitzonderingen hierop zijn: + + +Een foutmelding van &kxsldbg; wordt weergegeven in een meldingsvenster. + + +Het resultaat van een geëvalueerde expressie wordt weergegeven in een meldingsvenster. + + +Het resultaat wordt naar het bestand gestuurd dat in het uitvoervenster van &kxsldbg; wordt aangegeven. + + + + + + + + diff --git a/doc/nl/kxsldbg/kxsldbg_tools.docbook b/doc/nl/kxsldbg/kxsldbg_tools.docbook new file mode 100644 index 0000000..ea5b97a --- /dev/null +++ b/doc/nl/kxsldbg/kxsldbg_tools.docbook @@ -0,0 +1,77 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&Sander.Koning;&Tom.Albers; + + + +Diverse hulpmiddelen + +Er zijn diverse hulpmiddelen beschikbaar via het menu Hulpmiddelen. Het belangrijkste hulpmiddel is de inspector. + + +Het Inspectorhulpmiddel + +De inspector is het hulpmiddel dat alle dialoogvensters bevat voor: + +Breekpunten +Sjablonen +Variabelen +Items op de aanroepstapel +&XSL;-bronbestanden +&XML;-entiteiten + + + + + +Uitvoeren door lopen + +Door op Uitvoering starten met lopen te klikken wordt een dialoogvenster geopend waarmee u de snelheid kunt instellen. + + +Het venster Lopen + + + + +Het venster Lopen + + + +Om te stoppen met lopen kunt u de toets W gebruiken of het menu-item Uitvoering starten met lopen kiezen. + + + +&XML;-entiteiten opzoeken + +Om een System-ID in de huidige &XML;-catalogus op te zoeken, kiestu System-ID opzoeken en voert u de te zoeken waarde in in het dialoogvenster. + + +Het venster System-ID + + + + +Het venster System-ID + + + +Om een PUBLIC-ID op te zoeken kiest u Public-ID opzoeken en voert u de op te zoeken waarde in in het dialoogvenster. + + +Het venster Public-ID + + + + +Het venster Public-ID + + + + + diff --git a/doc/nl/kxsldbg/sources.docbook b/doc/nl/kxsldbg/sources.docbook new file mode 100644 index 0000000..511a772 --- /dev/null +++ b/doc/nl/kxsldbg/sources.docbook @@ -0,0 +1,27 @@ + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&Sander.Koning;&Tom.Albers; + + +Met &XSLT;-bronbestanden (bronnen) werken + +Als het dialoogvenster van de inspector niet zichtbaar is, kiest uHulpmiddelen Inspectors tonen. U kunt met bronnen werken door dit aan te geven op het tabblad "Bronnen" van het getoonde venster. + +Alle &XSLT;-bronbestanden die worden meegenomen door het &XSLT;-bestand of één van de nevenliggende bestanden worden hier weergegeven. + + +Het venster Bronnen + + + + +Het venster Bronnen + + + +Als u op een bron in de lijst klikt, wordt de cursor in het hoofdvenster verplaatst naar het begin van het aangegeven bestand. + diff --git a/doc/nl/kxsldbg/templates.docbook b/doc/nl/kxsldbg/templates.docbook new file mode 100644 index 0000000..d6cf048 --- /dev/null +++ b/doc/nl/kxsldbg/templates.docbook @@ -0,0 +1,20 @@ + +Met sjablonen werken + +Als het dialoogvenster van de inspector niet zichtbaar is, kies dan Hulpmiddelen Inspectors tonen. Om met sjablonen te werken kiest u op de tab Sjablonen van het venster. + +Alle gevonden sjablonen worden hier weergegeven. Let u erop dat de exporteerregels van &XSLT; gelden. Dus er mag niet meer dan één sjabloon met dezelfde overeenkomst- en modusdetails zijn. + + +Het venster Sjablonen + + + + +Het venster Sjablonen + + + +Als u op een sjabloon in de lijst klikt wordt de cursor in het hoofdvenster verplaatst naar het aangegeven bestand en regelnummer. + + diff --git a/doc/nl/kxsldbg/variables.docbook b/doc/nl/kxsldbg/variables.docbook new file mode 100644 index 0000000..d93e13f --- /dev/null +++ b/doc/nl/kxsldbg/variables.docbook @@ -0,0 +1,44 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +&Sander.Koning;&Tom.Albers; + + + +Met variabelen werken + +Als het dialoogvenster van de inspector niet zichtbaar is, kiest u Hulpmiddelen Inspectors tonen. + +Lokale en globale variabelen worden in een tab op het dialoogvenster getoond. Het volgende voorbeeld laat een XSLT-codesegment zien dat een globale en een lokale variabele declareert. + +<xsl:variable name="globalvariable" select="'foo'"/> + + <xsl:template match="/"/> + <xsl:param name="localvariable" select="'bar'"/> + </xsl:template match="/"/> + + +Als u met de muis op een variabele klikt wordt er informatie over die variabele getoond onderaan het dialoogvenster. Als een variabele een select-expressie heeft, bijvoorbeeld + +<xsl:variable name="changeable" select="'oldValue'" /> + + +dan kan een nieuw XPad gekozen worden door een nieuwe waarde in te voeren bij Variabele-expressie en vervolgens de knop Expressie instellen te kiezen. + + +Het tabblad Variabelen + + + + +Het tabblad Variabelen +Het tabblad Variabelen + + + +Als u op een variabele in de lijst klikt wordt de cursor in het hoofdvenster verplaatst naar het aangegeven bestand en regelnummer. + diff --git a/doc/nl/xsldbg/commands.docbook b/doc/nl/xsldbg/commands.docbook new file mode 100644 index 0000000..c63b9a5 --- /dev/null +++ b/doc/nl/xsldbg/commands.docbook @@ -0,0 +1,758 @@ + + +Opdrachten-overzicht + +Addparam +Een parameter voor libxslt toevoegen; equivalent aan het meegeven van --param <QNAAM>:<XPAD> op de opdrachtregel. + +Gebruik van addparam + +addparam <QNAAM> <XPAD>    (<XPAD> mag geen spaties of dubbele aanhalingstekens bevatten.) +addparam <QNAAM> "<XPAD>"    (<XPAD> mag geen dubbele aanhalingstekens bevatten.) + + +
+ + +Addwatch +Een expressie voor observatie toeveogen. Zie showwatch voor het weergeven van waarden. +Afkorting: watch +Gebruik van addwatch + +addwatch <XPAD> + + +
+ + +Base +De basis van deze knoop weergeven +Gebruik van base + + +base + + +
+ + +Break +Afbreken in een sjabloon, een bepaalde locatie in een stijlblad of xml-bestand dat geladen is door xsldbg, of de huidige knoop. Nieuw in xsldbg 3.1.4: In gdb-compatibiliteitsmodus kunnen breekpunten op een bepaalde regel in een bestand gezet worden, en later geactiveerd worden. +Afkorting: bxsldbg probeert de complete URL te raden, gegeven een bestandsnaam zonder pad. bestandsnaam in dezelfde map als het "bovenste" geladen stijlblad een bestandsnaam relatief aan de huidige werkmap van xsldbg. Als u bijvoorbeeldhet stijlblad ../en/xsldoc.xsl geladen heeft kunt u dit doen: break -l xsldoc.xsl 26 Deze opdracht werkt met gedeeltelijke of gehele QNAAM-sjablonen en/of modi. Bijvoorbeeld "template" komt overeen met elke QNAAM waarvan het lokale deel "template" is. Een namespace in de opgegeven QNAAM wordt uitgebreid zoals opgegeven in de namespaces die gedefinieerd zijn in het XSL-bronbestand, bijvoorbeeld "xsl:test1" wordt uitgebreid naar "http://www.w3.org/199/XSL/Transform:test1". Een opgevraagd breekpunt moet mogelijk verwerkt worden om de URL en het regelnummer te verkrijgen. Dit wordt automatisch gedaan nadat het eerste sjabloon ingeladen is door xsldbg. Breekpunten worden kort na de start van elke uitvoering opnieuw gevalideerd. Automatische validatie van breekpunten wordt gedaan als gdb-modus ingeschakeld is - de standaardinstelling van xsldbg. +Gebruik van break + + +break -l <BESTANDSNAAM> <REGELNR>    (Om een breekpunt op een bepaalde regel in het opgegeven bestand te zetten) +break -l <URI> <REGELNR>    (Om een breekpunt op een bepaalde regel in de opgegeven URI te zetten) +break <SJABLOONNAAM>    (Afbreken op een opgegeven of overeenkomend sjabloon.) +break <SJABLOONNAAM> <MODUSNAAM>    (Afbreken op het opgegeven sjabloon met een bepaalde modus.)> +break "" <MODUSNAAM>    (Afbreken op elk sjabloon met de opgegeven modus.) +break *    (Afbreken op elk sjabloon.) +break \*    (Afbreken op het sjabloon "*". Een andere naam die '*' bevat wordt niet speciaal behandeld.) +break     (Afbreken op de huidige knoop - inclusief xml data-knopen!) + + +
+ + +Bye +Uitvoering van het stijlblad zo snel mogelijk stoppen. +Gebruik van bye + + +bye + + +
+ + +Cat +Het resultaat van een xpath-expressie op een knoop relatief aan de huidige weergeven. +Gebruik van cat + + +Gebruik : cat <XPAD>    (Om eenvariable of parameter te bekijken) +Gebruik : cat $<QNAAM> + + +
+ + +Cd +Naar een pad overschakelen dat gespecificeerd door een xpath. +Gebruik van cd + + +<< = preceding-sibling::node() +>> = following-sibling::node() +<- = ancestor::node() +-> = decendant::node() + +
+ + +Chdir +Van huidige werkmap veranderen. +Gebruik van chdir + + +chdir <PAD>    (Een relatief of absoluut pad voor het besturingssysteem) + + +
+ + +Continue +Doorgaan met het uitvoeren van het stijlblad en stoppen op het eerstvolgende tegengekomen breekpunt. +Afkorting: c +Gebruik van continue + + +continue + + +
+ + +Data +Overschakelen naar weergave van de huidige knoop als xml-data. Of de gebruikte xml-data veranderen. +Gebruik van data + + +data    (Naar de huidige knoop in het document overschakelen.) +data <DATA>    (Naar een ander xml-databestand overschakelen. Een inleidende "~" wordt vervangen door de waarde van de omgevingsvariabele $HOME. De opdracht "run" is nodig om de data te verwerken.) + + +
+ + +Delete +Een sjabloonbreekpunt verwijderen. +Afkorting: d +Gebruik van delete + + +delete    (Een breekpunt op de huidige knoop verwijderen.) +delete <BREEKPUNT_ID>    (Een breekpunt op de opgegeven plaats verwijderen.) +delete -l <BESTANDSNAAM> <REGELNR>    (Breekpunt op de opgegeven regel van een bestand verwijderen.) +delete -l <URI> <REGELNR>    (Breekpunt op de opgegeven regel van een URI verwijderen.) +delete <TEMMPLATENAME>    (Breekpunt bij het opgegeven sjabloon verwijderen.) +delete *    (Alle breekpunten verwijderen.) + + +
+ + +Delparam +Een parameter voor libxslt verwijderen +Gebruik van delparam + + +delparam    (Alle parameters verwijderen) +delparam <PARAM_ID> + + +
+ + +Delwatch +Een geobserveerde expressie verwijderen of alle expressies verwijderen zoals ze door de opdracht "showwatch" getoond worden. +Gebruik van delwatch + + +delwatch <WATCHID>    (Verwijder de opgegeven expressie) +delwatch *    (Verwijder alle expressies) + + +
+ + +Dir +Een lijst van knopen weergeven op een soortgelijke manier als de shell-opdracht dir. + +Gebruik van dir + + +dir + + +
+ + +Disable +Een breekpunt uitschakelen +Gebruik van disable + + +disable    (Het breekpunt op de huidige knoop verwijderen) +disable <BREEKPUNT_ID>    (Breekpunt met het opgegeven nummer verwijderen) +disable -l <BESTANDSNAAM> <REGELNR>    (Breekpunt op de opgegeven regel in een bestand verwijderen) +disable -l <URI> <REGELNR>    (Breekpunt op de opgegeven regel in een URI verwijderen) + + +
+ + +Du +Een samenvatting van subknopen in een boomstructuur-formaat weergeven. +Gebruik van du + + +du + + +
+ + +Dump +De details van deze knoop weergeven +Gebruik van dump + + +dump + + +
+ + +Enable +Een breekpunt in- of uitschakelen (enable/disable omschakelen) +Afkorting: e +Gebruik van enable + + +enable    (Breekpunt op de huidige knoop in-/uitschakelen) +enable <BREEKPUNT_ID>    (Opgegeven breekpunt in-/uitschakelen) +enable -l <BESTANDSNAAM> <REGELNR>    (Breekpunt op de opgegeven regel in een bestand in-/uitschakelen) +enable -l <URI> <REGELNR>    (Breekpunt op de opgegeven regel in een URI in-/uitschakelen) + + +
+ + +Entities +Een lijst weergeven van de externe algemeen ingelezen entiteiten die aanwezig zijn in het databestand (document). +Afkorting: ent +Gebruik van entities + + +entities + + +
+ + +Exit +Uitvoering van het stijlblad zo snel mogelijk stoppen. +Gebruik van exit + + +exit + + +
+ + +Frame +Het stackframe op een bepaalde diepte weergeven +Afkorting: f +Gebruik van frame + + +frame <FRAME_DEPTH>    (Diepte is een getal tussen 0 en de diepte van de huidige aanroepstack) + + +
+ + +Free +Stijlblad en data vrijgeven (Uitgeschakeld zie run) +Gebruik van free + + +free + + +
+ + +Globals +Een lijst weergeven van de globale stijlblad-variabelen of -parameters. De waarde van een globale variabele weergeven. +Gebruik van globals + + +globals    (Lijst van alle globaal beschikbare variabelen weergeven) +globals -f    (Lijst van alle globale variabelen en hun waarden weergeven) +globals <QNAAM>    (De waarde van de opgegeven variabele weergeven) + + +
+ + +Help +Een overzicht of hulp over een opdracht weergeven +Afkorting: h +Gebruik van help + + +help     (Overzicht weergeven) +help <OPDRACHT>     (Hulp over een opdracht weergeven) + + +
+ + +Load +Opties en gebruikersvoorkeuren voor xsldbg van schijf laden +Gebruik van load + + +load + + +
+ + +Locals +Een lijst van lokale stijlblad-variabelen of -parameters weergeven. De waarde van een lokale variabele weergeven. +Gebruik van locals + + +locals    (Lijst van alle lokaal beschikbare variabelen weergeven) +locals -f    (Lijst van alle lokale variabelen en hun waarden weergeven) +locals <QNAAM>    (Waarde van de opgegeven variabele weergeven) + + +
+ + +Ls +Knopen in een kort formaat weergeven +Gebruik van ls + + +ls + + +
+ + +Next +Een xsl:call-template of xsl:apply-templates overslaan. Deze opdracht heeft hetzelfde effect als de opdracht "step" gevolgd door "up". +Afkorting: n +Gebruik van next + + +next    (Doorgaan naar volgende instructie op hetzelfde niveau) + + +
+ + +Options +De huidige waarden van de opties van xsldbg weergeven +Gebruik van options + + +options + + +
+ + +Output +Een lokaal beschrijfbaar bestand opgeven om uitvoer van resultaten in op te slaan. +Afkorting: o +Gebruik van output + + +output <BESTANDSNAAM>    (Een lokaal, beschrijfbaar bestand. Het voorvoegsel "~" kan in *nix en CYGWIN gebruikt worden, net als omgevingsvariabelen onde RISC OS.) +output <URI>    (De <URI> mag alleen het protocol "file://" gebruiken. Deze wordt vervolgens omgezet in een geschikte bestandsnaam voor het besturingssysteem.) +output -    (Naar standaarduitvoer schrijven. Alleen gebruiken als u met de opdrachtregel van xsldbgwerkt.) + + +
+ + +Public +De waarde waarnaar een publieke ID verwijst weergeven. +Afkorting: pub +Gebruik van public + + +public "<PublicID>" + + +
+ + +Pwd +De huidige werkmap weergeven. +Gebruik van pwd + + +pwd + + +
+ + +Quit +Uitvoering van het stijlblad zo snel mogelijk stoppen. +Afkorting: q +Gebruik van quit + + +quit + + +
+ + +Run +Het stijlblad herstarten. +Afkorting: r +Gebruik van run + + +run + + +
+ + +Save +De opties en gebruikersvoorkeuren van xsldbg op schijf opslaan. +Gebruik van save + + +save + + +
+ + +Search +Een databank met alle informatie doorzoeken die uit de geladen stijlbladen gehaald is. +Alle uitvoerbestanden worden opgeslagen in de waarde van de optie "searchresultspath" als die een waarde heeft, of in dezelfde map als het stijlblad zich in bevindt. searchresults.xml wordt normaliter verwerkt door search.xsl, maar wordt door searchhtml.xsl verwerkt als de optie "preferhtml" aan staat. Als de opdracht search uitgevoerd wordt, wordt een xml-bestand (searchresults.xml) aangemaakt. U kunt dit bestand dan met uw eigen stijlblad verwerken om de gegevens op andere manieren weer te geven. Als de optie "preferhtml" niet aan staat, wordt searchresult.txt op het scherm weergegeven. Afhankelijk van de hoeveelheid data die verzameld is, duurt het een tijd om deze opdracht uit te voeren. +Gebruik van search + + +search <XPAD>    (Zie search.dtdvoor geldige waarden van xpath. het standaard <XPAD> is '//search/*' ) +search -sort <XPAD>    (Resultaten sorteren voordat deze uitgevoerd worden) + + +
+ + +Set +De waarde van een variabele instellen +Gebruik van set + + +set <VARIABLE_NAME> <XPAD> + + +
+ + +Setoption +Een optie voor de uitvoering van het stijlblad instellen +U zult de opdracht run moeten gebruiken om de wijzigingen door te voeren. +Gebruik van setoption + + +setoption <OPTION_NAME> <INTEGER_VALUE> +<OPTION_NAME> kan zijn: + + + + + debug    (Als <INTEGER_VALUE> waar is, de boomstructuur voor het resultaat weergeven.) + catalogs    (Als <INTEGER_VALUE> waar is, de catalogi uit $SGML_CATALOG_FILES, of SGML$CatalogFiles op RISC OS, gebruiken) + html    (Als <INTEGER_VALUE> waar is, is het invoerdocument een HTML-bestand) + docbook    (Als <INTEGER_VALUE> waar is, en docbook nog steeds door libxml ondersteund wordt, is het invoerdocument een SGML-docbook) + xinclude    (Als <INTEGER_VALUE> waar is, doe dan een XInclude-verwerkstap op de invoer) + preferhtml    (Als <INTEGER_VALUE> waar is, geef dan de voorkeur aan HTML-uitvoer voor zoekresultaten. Zie de opdracht search) + autoencode    (Als <INTEGER_VALUE> waar is, probeer dan de codering van het stijlblad te gebruiken) + utf8input    (Als <INTEGER_VALUE> waar is, is alle gebruikersinvoer in UTF-8. Dit is standaard als xsldbg als een thread uitgevoerd wordt) +      + gdb    (In gdb-compatabiliteitsmodus werken) + Voor een waarde 1 betekent dit + Veel meer berichten weergeven. De hoeveelheid "Breakpoint at ..." berichten verhogen. + Ten hoogste GDB_LINES_TO_PRINT regels worden weergegeven bij het evalueren van expressies, gevolgd door "...". Zie options.h voor hoe u deze waarde kunt veranderen, de standaard is 3 regels tekst. + Zowel lokale als globale variabelen worden weergegeven bij de opdracht "locals". + Bij het weergeven van expressies met cat of print zal de ge�alueerde waarde worden voorafgegaan door een "=" <EXPRESSION>. + + + + + + Voor een waarde 2 betekent dit Door KDbg benodigde berichten weergeven, naast de hierboven beschreven uitvoer (voor waarde 1). + + + + + + + + + nonet    (Als <INTEGER_VALUE> waar is,geen DTD's of entities via het netwerk laden) + novalid    (Als <INTEGER_VALUE> waaris, de DTD-inlaadfase overslaan) + repeat    (Als <INTEGER_VALUE> waar is, de transformatie 20 maal herhalen) + profile    (Als <INTEGER_VALUE> waar is, profielinformatie weergeven) + timing    (Als <INTEGER_VALUE> waar is, de verstreken tijd weergeven) + noout    (Als <INTEGER_VALUE> waar is,het resultaat niet weergeven) + + + + +Waarbij de waarde waar is als deze NIET gelijk aan 0 is. +En waarbij de waarde niet waar is als deze WEL gelijk aan 0 is. +stdout    Alle foutmeldingen op standaarduitvoer in plaats van standaardfoutuitvoer weergeven. +setoption <OPTION_NAME> "<STRING_VALUE>"    (<STRING_VALUE> mag geen dubbele aanhalingstekens bevatten) +setoption <OPTION_NAME> <STRING_VALUE>    (<STRING_VALUE> mag geen spaties of dubbele aanhalingstekens bevatten) +<OPTION_NAME> kan zijn: + + + + + data    (URI van databestand) + source    (URI van bronbestand) + output    (SystemID van uitvoerbestand) + docspath    (Pad waarin documentatie gezocht wordt) + catalognames    (Namen van de te gebruiken catalogi als de optie catalogs ingesteld is. De waarde gaat verloren als de optie catalogs ingesteld wordt nadat deze waarde is ingesteld.) + encoding    (De codering die voor standaarduitvoer gebruikt wordt) + searchresultspath    In welk pad de zoekresultaten opgeslagen moeten worden. Als deze optie niet is ingesteld gebruikt xsldbg het pad van het stijlblad. + + + + + +
+ + +Shell +Een shell-opdracht uitvoeren +Gebruik van shell + + +shell <TEKST>    (<TEKST> is de opdracht die door het besturingssysteem uitgevoerd moet worden) + + +
+ + +Showbreak +Een lijst van sjabloonbreekpunten weergeven. +Afkorting: showAls er een modus op een sjabloonbreekpunt beschikbaar is wordt deze toegevoegd aan het einde van de sjabloonnaam voor het breekpunt. Voorbeelduitvoer: +Breakpoint 3 enabled for template :"*" in file test1.xsl : line 105 +Breakpoint 2 enabled for template :"* testMode" in file test1.xsl : line 109 +Breakpoint 1 enabled for template :"* http://www.w3.org/1999/XSL/Transform:testMode" in file test1.xsl : line 113 + +Total of 3 breakpoints present + +Gebruik van showbreak + + +showbreak + + +
+ + +Showparam +De gebruikte parameters voor libxslt weergeven +Gebruik van showparam + + +showparam + + +
+ + +Showwatch +De huidige geobserveerde expressie weergeven +Afkorting: watches +Gebruik van showwatch + + +showwatch    (De huidige observatiepunten en hun waarden weergeven) +showwatch 1    (Automatisch weergevenvan geobserveerde expressies. Standaard is deze optie ingeschakeld.) +showwatch 0    (Niet automatisch weergeven van geobserveerde expressies) + + +
+ + +Source +De huidige knoop in het stijlblad weergeven. Of een anderstijlblad gebruiken. +Gebruik van source + + +source    (Naar de huidige knoop in het stijlblad overschakelen.) +source <BRON>    (Een ander bronbestand gebruiken. Het voorvoegsel "~" wordt vervangen door de waarde van de omgevingsvariabele $HOME. De opdracht "run" moet gebruikt worden om uitvoering te starten.) + + +
+ + +Step +Stappen tot de volgende instructie in het stijlblad. +Afkorting: s +Gebruik van step + + +step + + +
+ + +Stepdown +Naar beneden stappen, naar een nieuwer "aanroepframe" +Afkorting: down +Gebruik van stepdown + + +stepdown     (een frame omlaag stappen) +stepdown <AANTAL_FRAMES>    (het opgegeven aantal frames omlaag stappen) + + +
+ + +Stepup +Omhoog stappen naar een ouder "aanroepframe" +Afkorting: upDit is geen nauwkeurige opdracht, xsldbg zal zo dichtbij mogelijk stoppen. +Gebruik van stepup + + +stepup     (een frame omhoog stappen) +stepup <AANTAL_FRAMES>     (het opgegeven aantal frames omhoog stappen) + + +
+ + +Stylesheets +Een lijst van geladen stijlbladen weergeven +Afkorting: style +Gebruik van stylesheets + + +stylesheets + + +
+ + + +System +De waarde waarnaar een systeembestand verwijst weergeven +Afkorting: sys +Gebruik van system + + +system "<SystemID>" + + +
+ + +Templates +Een lijst van beschikbare sjablonen weergeven of naar een sjabloon zoeken +Afkorting: t +Gebruik van templates + + +templates +templates <TEMPLATE>    (Details over het sjabloon <TEMPLATE> weergeven - als dit gevonden kan worden) + + +
+ + +Trace +Een uitvoering van het stijlblad nalopen en het bestand en tussenliggende stappen weergeven. +Gebruik van trace + + +trace + + +
+ + +Tty +Een terminal openen. Het niveau van tty-doorsluizing instellen. +Gebruik van tty + + +tty <DEVICE_PAD>    ( <DEVICE_PAD> is een geldige terminal op het besturingssysteem. Probeert de terminal te openen.) +tty <TTY_NIVEAU>    (Het niveau van tty- doorsluizing instellen, waarbij <TTY_NIVEAU> een geldig invoer-/ uitvoerniveau is.) + Waarbij het niveau is + 0 = Standaard invoer/uitvoer + 1 = Terminal-uitvoer van resultaten van transformatie, nalopen en lopen.     (Standaardstatus als de tty geopend is. Nog niet volledig ge�plementeerd.) + 2 = Volledige doorsluizing naar terminal    (Nog niet ge�plementeerd.) + Alle andere integerwaarden worden als 0 beschouwd. + + + + + + +
+ + +Validate +Het uitvoerbestand van het stijlblad valideren (Uitgeschakeld) +Gebruik van validate + + +validate + + +
+ + +Walk +Door de code lopen op een aantal snelheden +Gebruik van walk + + +walk <SNELHEID>    (Gebruik Ctrl-c om uitvoering te stoppen, <SNELHEID> is een waarde van 0 tot en met 9. Waarbij 0 stoppen betekent, 1 zeer snel, en 9 zeer langzaam) + + +
+ + +Where +Een spoor van sjabloonaanroepen weergeven (framestack) en de huidige werkmap weergeven +Afkorting: w +Gebruik van where + + +where + + +
+ + +Write +Nog af te maken +Gebruik van write + + +write + + +
+ + + + + + + diff --git a/doc/nl/xsldbg/credits.docbook b/doc/nl/xsldbg/credits.docbook new file mode 100644 index 0000000..0e7b4df --- /dev/null +++ b/doc/nl/xsldbg/credits.docbook @@ -0,0 +1,13 @@ + + +Dankbetuigingen en licentie + +&xsldbg; +Programma copyright 2004 Keith Isdale k_isdale tpg com au &meld.fouten;&vertaling.sander; &underFDL; &underGPL; + + +Dank aan +De auteurs van libxml en libxsl. +Johannes Sixt voor hulp met het toevoegen van ondersteuning voor xsldbg aan KDbg + + diff --git a/doc/nl/xsldbg/index.docbook b/doc/nl/xsldbg/index.docbook new file mode 100644 index 0000000..ac9610c --- /dev/null +++ b/doc/nl/xsldbg/index.docbook @@ -0,0 +1,96 @@ + + + xsldbg"> + + + + + + + + +]> + + + + + + + + + + + +Het handboek van &xsldbg; + + +Keith Isdale
k_isdale@tpg.com.au
+ + + + +&Sander.Koning;&Tom.Albers; + +2002 +2003 +Keith Isdale + + +&FDLNotice; +2004-09-26 +1.01.00 + + + +xsldbg is een hulpmiddel met als doel u te helpen stijlbladen te begrijpen. Het voornaamste verschil met andere stijlblad-debuggers is de mogelijkheid om interessante items te zoeken en om de uitvoering van een stijlblad te volgen. + + + +KDE +tdeutils +xsldbg +xsl +xml + + + + +&introduction-chapter; +&usage-chapter; +&commands-chapter; +&credits-chapter; + + + +Installatie + + +&xsldbg; verkrijgen + +Zie de component kxsldbg in de module tdewebdev in een nabije KDE cvs. +&install.intro.documentation; + + +Vereisten + +Om &xsldbg; goed te kunnen gebruiken heeft u &kde; libxslt, libexslt en libxml nodig, die op een standaard KDE-installatie aanwezig zijn. + + + +Compileren en installeren +xsldbg wordt normaal gesproken gecompileerd als deel van de component kxsldbg in de module tdewebdev + + + +Instellen + +&xsldbg; wordt ingesteld door middel van argumenten op de opdrachtregel en het commando setoption + + + + + +&documentation.index; + diff --git a/doc/nl/xsldbg/introduction.docbook b/doc/nl/xsldbg/introduction.docbook new file mode 100644 index 0000000..d3e75a1 --- /dev/null +++ b/doc/nl/xsldbg/introduction.docbook @@ -0,0 +1,17 @@ + + +Inleiding + +&xsldbg; is een tekstgebaseerd hulpmiddel voor het debuggen van +stijlbladen (de zogenaamde eXtensible Stylesheet Language) en heeft opdrachten die lijken op die van de debugger gdb in Unix/Linux. Er zijn drie belangrijke manieren beschikbaar voor het uitvoeren van stijlbladen. + + + + Het gehele stijlblad uitvoeren. + Naar de volgende xsl-instructie stappen. + Doorgaan tot het volgende breekpunt, of het stijlblad opnieuw gestart is. + + + + + diff --git a/doc/nl/xsldbg/usage.docbook b/doc/nl/xsldbg/usage.docbook new file mode 100644 index 0000000..e46eeca --- /dev/null +++ b/doc/nl/xsldbg/usage.docbook @@ -0,0 +1,63 @@ + + +&xsldbg; gebruiken + +Argumenten voor de opdrachtregel van xsldbg +Op systemen waar readline beschikbaar is, kunt u de toetsen terug/vooruit om door de geschiedenis van ingevoerde opdrachten te bladeren. Op alle systemen kan de laatst ingevoerde opdrachtherhaald worden door op de toets <ENTER> te drukken. +Als uw besturingssysteem het ondersteunt worden bestandsnamen uitgebreid. +Een aantal opdrachten accepteren meer dan één argument. U kuntaanhalingstekens gebruiken om complexe expressies als één argument te laten gebruiken. Bijvoorbeeld break "* | @" maakt het mogelijk om een breekpunt op het sjabloon met de naam "* | @" te plaatsen. + + +Legenda van gebruikte termen +De volgende tabel beschrijft de termen die in de opdrachtengids gebruikt worden. + + + SJABLOONNAAM : Een geldige sjabloonnaam die alleen ASCII-tekens0x00 tot en met 0x7F bevat. Mogelijk een volledig gekwalificeerde naam zoals "xsl:templateName". + BESTANDSNAAM : Een geldige bestandsnaam op het lokale systeem van de gebruiker. Het voorvoegsel "~" mag op *nix en CYGWIN gebruikt worden. Onder RISC OS mogen omgevingsvariabelen gebruikt worden. + URI : Een 'Uniform Resource Identifier' zoals gedefinieerd door +RFC 2396 + MODUSNAAM : De sjabloonmodus, kan een volledig gekwalificeerde naam zijn als "xsl:modeName". + QNAAM : Een volledig gekwalificeerde naam als "xsl:localPart" + REGELNR : Een geldig regelnummer in het bijbehorende bestand <BESTANDSNAAM> + AANTAL_FRAMES : Een geldig aantal frames om de huidige positie mee te wijzigen. + BREEKPUNT_ID : Een geldig breekpuntnummer. + OBSERVATIE_ID : Een geldige observatie-expressie zoals aangegeven door de opdracht showwatch + SNELHEID: de snelheid om mee door de code te lopen, getal van 0 tot en met 9 +     (Commentaar): een opmerking over de betekenis of het gebruik van de opdracht + { opt1 | opt2 | opt3 .. enz} : Kies een van de opties. + XPAD : Een xpad-selectie van knopen + PARAM_ID : Een geldig parameternummer zoals aangegeven door de opdracht showparam + PAD : Een pad om de huidige werkmap in te veranderen. Op sommigebesturingssystemen wordt het voorvoegsel "~" vervangen door het pad naar uw persoonlijke map. + TEKST : Vrije tekst     (geen restricties) + OPDRACHT : Een geldige opdracht voor xsdbg + QNAAM : Een geldige naam van een variabele of parameter + BRON : Het stijlblad dat uitgevoerd wordt of moet worden. Zie <BESTANDSNAAM> en <URI> + DATA : De xml-data (document) die door het stijlblad verwerkt wordt of moet worden. Zie <BESTANDSNAAM> en <URI> + DEVICE_PAD : Een geldige terminal op het besturingssysteem + TTY_NIVEAU : Een geldig invoer-/uitvoer-niveau om te gebruiken + + + + +Overzicht van beschikbare opdrachten + + +Hulp :help +Uitvoering : {bye|exit| quit}, step, stepup, stepdown, next, continue, run, trace, setoption, options +Parameters van libxslt : addparam, delparam, showparam, output, setoption, options +Sjablonen : templates, where, frame +Breekpunten : break, showbreak, delete, enable +Expressies bekijken (xpath) : cat +Knopen bekijken : ls, dir, du, cat, pwd +Variabelen bekijken : globals, locals, cat, addwatch +Variabelen zetten : set +Knopen selecteren : source, data, cd +Zoeken :search +Besturingssysteem :chdir, shell, tty +Bestanden : output, entities, system, public +Uitgeschakelde bestandsopdrachten : validate, load, save, write, free + + + + + diff --git a/doc/pt/kxsldbg/callstack.docbook b/doc/pt/kxsldbg/callstack.docbook new file mode 100644 index 0000000..94d429e --- /dev/null +++ b/doc/pt/kxsldbg/callstack.docbook @@ -0,0 +1,28 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +JoséPires
jncp@netcabo.pt
Tradução + + + +Trabalhar com a Pilha de Chamadas + +Todos os itens da pilha de chamadas são indicados aqui. Quanto mais antigo for o item da pilha menor número de ordem terá. Veja em baixo um exemplo. + + +A Janela da Pilha de Chamadas + + + + +A Janela da Pilha de Chamadas + + + +Se carregar num item da pilha de chamadas na lista apresentada, fará com que o cursor da janela principal salte para o ficheiro e para o número de linha indicado. + + diff --git a/doc/pt/kxsldbg/credits.docbook b/doc/pt/kxsldbg/credits.docbook new file mode 100644 index 0000000..f07870a --- /dev/null +++ b/doc/pt/kxsldbg/credits.docbook @@ -0,0 +1,29 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +JoséPires
jncp@netcabo.pt
Tradução + + +Créditos e Licenças + +&kxsldbg; © 2004 Keith Isdale +Documentação com © 2004 de Keith Isdale + + + +Agradecimentos a: + +Os criadores da libxml e da libxslt. + + +Robert Jacolin pelo 'feedback' a uma versão anterior do &kxsldbg;. + + +Igor Zlatkovic por criar os binários em WIN32 da libxml/xslt e do &xsldbg;. + + +&underFDL; &underGPL; diff --git a/doc/pt/kxsldbg/entities.docbook b/doc/pt/kxsldbg/entities.docbook new file mode 100644 index 0000000..bb6d399 --- /dev/null +++ b/doc/pt/kxsldbg/entities.docbook @@ -0,0 +1,28 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +JoséPires
jncp@netcabo.pt
Tradução + + +Trabalhar com os Ficheiros de Dados em &XML; (Entidades) + +Se a janela de inspecção não é mostrada use a opção do menu Ferramentas Mostrar os inspectores . Para trabalhar com as entidades carregue na página Entidades da janela que é mostrada. + +Todas as entidades externas de &XML; incluídas com o ficheiro DATA ou com alguns dos ficheiros ao mesmo nível são mostradas aqui. Para este exemplo foi executado o &kxsldbg; no test13.xsl com o test13.xml (encontrado na pasta <PREFIXO DO KDE>/share/apps/kxsldbg da distribuição de código do &xsldbg;) de modo a que possa ver algumas entidades. + + +A Janela de Entidades + + + + +A Janela de Entidades + + + +Se carregar no item de uma entidade na lista irá mudar o cursor na janela principal para o início do ficheiro indicado. + diff --git a/doc/pt/kxsldbg/glossary.docbook b/doc/pt/kxsldbg/glossary.docbook new file mode 100644 index 0000000..fc98fa1 --- /dev/null +++ b/doc/pt/kxsldbg/glossary.docbook @@ -0,0 +1,35 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +JoséPires
jncp@netcabo.pt
Tradução + + + + +Palavras-Chave + +&xsldbg; + +Veja em . + + + + +XPath + +Uma expressão válida que define quais os dados pretendidos. Veja no 'site' Web do W3C. + + + + +QName + +Um nome qualificado completo. Por exemplo xsl:aminhavariavel. Veja no 'site' Web do W3C + + + + diff --git a/doc/pt/kxsldbg/index.docbook b/doc/pt/kxsldbg/index.docbook new file mode 100644 index 0000000..e35d246 --- /dev/null +++ b/doc/pt/kxsldbg/index.docbook @@ -0,0 +1,112 @@ + +KXSLDbg"> + + + + + + + + + + + + + + + xsldbg"> + DTD"> + XSD"> + XSLT"> +]> + + + + +O Manual do &kxsldbg; + + +Keith Isdale
k_isdale@tpg.com.au
+ + + +JoséPires
jncp@netcabo.pt
Tradução + + + + +2002 +2003 +2004 +Keith Isdale + + +&FDLNotice; +2004-11-18 +0.5 + + +O &kxsldbg; oferece uma interface gráfica para o &xsldbg;, o qual suporta a depuração de código de &XSLT;s. + + + +KDE +xsldbg +libxslt +depurador + + + + +Introdução + + +Características + +O &kxsldbg; oferece o acesso à maioria dos comandos do &xsldbg; para + +Definir e modificar os pontos de paragem + + +Mostrar o valor de XPaths + + +Mostrar informações sobre os pontos de paragem, modelos, variáveis, pilha de chamadas, 'stylesheets' e entidades encontrados + + +Definir e modificar os pontos de paragem e variáveis + + +Percorrer o código da &XSL; e o documento de &XML; através do XPath + + +Procurar os IDs PUBLIC (públicos) e SYSTEM (do sistema) no catálogo de &XML; actual + + + + + + +Funcionalidades adicionadas recentemente +O &kxsldbg; pode agora + + +Definir e modificar variáveis + + +Desenhar o texto na janela principal, usando as bibliotecas do &kate; + + + + + + + + +Usar o &kxsldbg; +&configure-section; &mainwindow-section; &inspector-section; &variables; &callstack; &templates; &sources; &entities; &tools-section; + +&credits-chapter; + + diff --git a/doc/pt/kxsldbg/kxsldbg_configure.docbook b/doc/pt/kxsldbg/kxsldbg_configure.docbook new file mode 100644 index 0000000..dbb10dd --- /dev/null +++ b/doc/pt/kxsldbg/kxsldbg_configure.docbook @@ -0,0 +1,67 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +JoséPires
jncp@netcabo.pt
Tradução + + + +Configurar uma Sessão do &kxsldbg; + +Você inicia a configuração ao carregar em Depurar Configurar no menu. + + +A Janela de Configuração + + + + +A Janela de Configuração +A Janela de Configuração. + + + + +Começar + +Para ser capaz de executar uma folha de estilo ou 'stylesheet' você precisa de indicar o: +código da &XSL; +dados em &XML; +Ficheiro de resultado + + + +Se usar o botão ... poderá escolher o ficheiro desejado. O Código de &XSL; e os Dados em &XML; podem referir-se a URIs que contenham um http://, um ftp:// ou um file://. O Ficheiro do resultado deverá ser um ficheiro local com permissões de escrita. +Para seguir com os exemplos, seleccione os seguintes ficheiros na pasta de exemplo em <PREFIXO DO KDE>/share/apps/kxsldbg +código de &XSL;: testdoc.xsl +dados em &XML;: testdoc.xml +Ficheiro de resultado: /tmp/resultado.txt + + + + + +Trabalhar com as Opções + +Você poderá seleccionar zero ou mais opções na janela de Opções. Cada opção tem uma dica com uma sugestão do efeito que esta tem. + + + +Trabalhar com os Parâmetros + +Você poderá adicionar zero ou mais parâmetros com a secção Parâmetros da LibXSLT da janela. Isto permite-lhe fornecer valores aos parâmetros da 'stylesheet'. + +Por exemplo, poderá adicionar um Nome de parâmetro igual a o_meu_parametro com um Valor de Parâmetro igual a 'Olá mundo!' e carregar no botão Adicionar. Para actualizar o valor de um parâmetro existente, basta escolhe o valor que deseja alterar com os botões Anterior ou Próximo, indicar um Valor de parâmetro novo e carregar em Aplicar. + + + +Aplicar as Alterações + +Para as alterações que efectuou fazerem efeito carregue no botão Aplicar. Para ignorar as alterações, carregue no botão Cancelar. + +Você poderá fechar a janela usando o botão X do canto superior direito da janela. Se precisar de alterar a configuração basta reabrir a janela de configuração tal como se explicou anteriormente. + + diff --git a/doc/pt/kxsldbg/kxsldbg_inspector.docbook b/doc/pt/kxsldbg/kxsldbg_inspector.docbook new file mode 100644 index 0000000..3144070 --- /dev/null +++ b/doc/pt/kxsldbg/kxsldbg_inspector.docbook @@ -0,0 +1,71 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +JoséPires
jncp@netcabo.pt
Tradução + + +Definir e Modificar os Pontos de Paragem + +A forma principal de lidar com os pontos de paragem é através da janela principal. Veja + +Logo que tenha iniciado a 'stylesheet', você poderá usar o item do menu Ferramentas Mostrar os inspectores . Carregue então na página Pontos de Paragem. Veja em baixo um exemplo. + + +Definir os Pontos de Paragem + + + + +Definir os Pontos de Paragem + + + + +Adicionar um Ponto de Paragem + +Você poderá adicionar um ponto de paragem se indicar um dos seguintes itens: + +um ficheiro e um número de linha + +o nome de um modelo + +o nome de um modelo e o nome de um modo + +o nome de um modo + + + + +E carregar de seguida no botão Adicionar. + + + +Detalhes do Argumento + +O nome de um ficheiro poderá ser a localização completa de um ficheiro local, ou apenas uma localização parcial (⪚ docum_xsl.xsl). + +O nome de um modelo ou de um modo é um Nome Qualificado completo onde a parte não-local é opcional, ⪚ xsl:omeumodelo corresponde a omeumodelo + + + +Remover um Ponto de Paragem + +Em primeiro lugar carregue no ponto de paragem que deseja remover na lista de pontos de paragem actuais. Carregue depois no botão Remover. + + + +Remover Todos os Pontos de Paragem + +Carregue no botão Remover Tudo. + + + +Activar ou Desactivar um Ponto de Paragem + +Carregue em primeiro lugar com o &LMB; no ponto de paragem que deseja activar na lista de pontos de paragem actuais. Depois carregue no botão Activar. + + diff --git a/doc/pt/kxsldbg/kxsldbg_mainwindow.docbook b/doc/pt/kxsldbg/kxsldbg_mainwindow.docbook new file mode 100644 index 0000000..de88d68 --- /dev/null +++ b/doc/pt/kxsldbg/kxsldbg_mainwindow.docbook @@ -0,0 +1,443 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +JoséPires
jncp@netcabo.pt
Tradução + + +Usar a Janela Principal + + +A Janela Principal + + + + +Uma janela de texto com o ficheiro actual a ser depurado +Uma janela de texto com o ficheiro actual a ser depurado. + + + + +Trabalhar na Janela Principal + +O estado de um determinado ponto de paragem é indicado através do texto relevante com uma cor de fundo diferente. Poderá escolher a cor desejada: veja na janela em ConfiguraçãoConfigurar o Editor, na página de Cores. + + +Você poderá definir, desactivar ou remover um ponto de paragem, usando as teclas, o menu Depurar ou os botões da barra de ferramentas. + +Você poderá mover o cursor pelo texto, usando as seguintes teclas: + + +Teclas de cursores: Esquerda, Direita, Cima ou Baixo. +Teclas de página: Page Up ou Page Down + + + + + + +Lidar com o Resultado do &kxsldbg; + +Grande parte do resultado do &kxsldbg; é capturado e apresentado tanto na janela dos inspectores como no resultado do &kxsldbg;. As excepções a esta regra são: + + +Uma mensagem de erro que vem do &kxsldbg; e que é mostrada dentro de uma janela de mensagens. + + +O resultado da avaliação de uma expressão que é também mostrado numa janela de mensagens. + + +O resultado da procura é enviado par ao ficheiro indicado na janela de resultado do &kxsldbg;. + + + + + + + + diff --git a/doc/pt/kxsldbg/kxsldbg_tools.docbook b/doc/pt/kxsldbg/kxsldbg_tools.docbook new file mode 100644 index 0000000..65002b7 --- /dev/null +++ b/doc/pt/kxsldbg/kxsldbg_tools.docbook @@ -0,0 +1,77 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +JoséPires
jncp@netcabo.pt
Tradução + + + +Ferramentas Diversas + +Várias ferramentas estão disponíveis através do menu de ferramentas; a ferramenta principal é a de inspecção. + + +Ferramenta de Inspecção + +A ferramenta de inspecção é a que contém todas as janelas individuais para lidar com: + +Pontos de Paragem +Modelos +Variáveis +Itens da pilha de chamadas +Ficheiros de código &XSL; +Entidades de &XML; + + + + + +Executar Passo-a-Passo + +Se carregar no menu Iniciar a execução passo-a-passo é mostrada uma janela que permite escolher a velocidade do passo de execução. + + +A Janela de Passo + + + + +A Janela de Passo + + + +Para parar de avançar use a tecla W ou seleccione o item do menu Iniciar a execução passo-a-passo. + + + +Procurar as Entidades de &XML; + +Para procurar um ID de Sistema no catálogo de &XML; actual use a opção Procurar o ID do Sistema e indique o valor a procurar na janela que aparece. + + +A Janela do ID do Sistema + + + + +A Janela do ID do Sistema + + + +Para procurar um ID público use a opção Procurar um ID Público e indique o valor a procurar na janela que aparece. + + +A Janela do ID Público + + + + +A Janela do ID Público + + + + + diff --git a/doc/pt/kxsldbg/sources.docbook b/doc/pt/kxsldbg/sources.docbook new file mode 100644 index 0000000..1b2b67f --- /dev/null +++ b/doc/pt/kxsldbg/sources.docbook @@ -0,0 +1,27 @@ + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +JoséPires
jncp@netcabo.pt
Tradução + + +Lidar com Ficheiros de Código de &XSLT; (Código) + +Se a janela de inspecção não estiver visível use a opção Ferramentas Mostrar os inspectores . Para lidar com o código, carregue na página de código da janela mostrada. + +Todos os ficheiros de código &XSLT; que são incluídos no ficheiro &XSLT; ou nos ficheiros do mesmo nível são listados aqui. + + +A Janela de Código + + + + +A Janela de Código + + + +Se carregar num item de código na lista mostrada fará com que o cursor da janela principal passe para o início do ficheiro indicado. + diff --git a/doc/pt/kxsldbg/templates.docbook b/doc/pt/kxsldbg/templates.docbook new file mode 100644 index 0000000..6c9fdcd --- /dev/null +++ b/doc/pt/kxsldbg/templates.docbook @@ -0,0 +1,20 @@ + +Lidar com Modelos + +Se a janela de inspecção não estiver visível use a opção Ferramentas Mostrar os inspectores . Para lidar com o código, carregue na página de código da janela mostrada. + +Todos os modelos encontrados são aqui listados. Repare que as regras de exportação do &XSLT; se aplicam. Como tal poderá existir mais do que um modelo com a mesma correspondência e modo. + + +A Janela de Modelos + + + + +A Janela de Modelos + + + +Se carregar num item de um modelo na lista mostrada fará com que o cursor da janela principal salte para o ficheiro e número de linha indicados. + + diff --git a/doc/pt/kxsldbg/variables.docbook b/doc/pt/kxsldbg/variables.docbook new file mode 100644 index 0000000..7ecdf38 --- /dev/null +++ b/doc/pt/kxsldbg/variables.docbook @@ -0,0 +1,44 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +JoséPires
jncp@netcabo.pt
Tradução + + + +Lidar com Variáveis + +Se a janela de inspecção não estiver visível use a opção Ferramentas Mostrar os inspectores . + +As variáveis locais e globais são mostradas numa página da janela de inspecção. O exemplo seguinte mostra um segmento de código de XSLT que declara uma variável global e uma local + +<xsl:variable name="variavelglobal" select="'xpto'"/> + + <xsl:template match="/"/> + <xsl:param name="variavellocal" select="'xpto2'"/> + </xsl:template match="/"/> + + +Se carregar com o rato numa variável da lista, irá mostrar uma informação de resumo no fundo da janela. Se uma variável tiver uma expressão de selecção, por exemplo + +<xsl:variable name="alteravel" select="'valorAntigo'" /> + + +então poderá ser escolhido um novo XPath com um novo valor para a Expressão da variável, carregando depois no botão Definir a expressão. + + +A página de Variáveis + + + + +A Página de Variáveis +A Página de Variáveis + + + +Se carregar num item de uma variável na lista mostrada fará com que o cursor da janela principal passe para o ficheiro e número de linha indicados. + diff --git a/doc/pt/xsldbg/commands.docbook b/doc/pt/xsldbg/commands.docbook new file mode 100644 index 0000000..d2a47b5 --- /dev/null +++ b/doc/pt/xsldbg/commands.docbook @@ -0,0 +1,758 @@ + + +Referência de Comandos + +Addparam +Adiciona um parâmetros à 'libxslt' ; é equivalente a oferecer a opção --param <QNAME>:<XPATH> através da linha de comandos. + +Utilização do 'addparam' + +addparam <QNAME> <XPATH>    (O <XPATH> não deverá conter quaisquer espaços nem aspas.) +addparam <QNAME> "<XPATH>"    (Não deverá conter aspas no <XPATH>) + + +
+ + +Addwatch +Adiciona uma expressão para ser vigiada. Veja o 'showwatch' para mostrar os valores das vigias +Nome de atalho: watch +Utilização do 'addwatch' + +addwatch <XPATH> + + +
+ + +Base +Imprime a base deste nó +Utilização do 'base' + + +base + + +
+ + +Break +Pára num modelo, num determinado local de uma 'stylesheet' ou ficheiro em XML carregado pelo 'xsldbg' ou no nó actual. É novo no xsldbg 3.1.4: Quando está no modo de compatibilidade com o 'gdb', os pontos de paragem órfãos podem ser definidos num ficheiro e número de linha específicos e podem ser traduzidos para um ponto de paragem activo mais tarde. +Nome de atalho: bO 'xsldbg' irá tentar adivinhar o URL completo, com base em o nome do ficheiro, sem o local indicado. o nome do ficheiro, na mesma pasta que a 'stylesheet' de topo se encontra o nome do ficheiro, relativo à pasta de trabalho actual do 'xsldbg' Isto significa que, se tiver carregado um ficheiro de uma 'stylesheet' com um ../en/xsldoc.xsl, poderá fazer isto break -l xsldoc.xsl 26 Este comando fará a correspondência com um modelo QNAME parcial ou completo, assim como a um modo específico. Por exemplo, o "modelo" irá corresponder a qualquer QNAME com uma parte local de "modelo" Quaisquer espaços de nomes no QNAME indicado serão expandidos, tal como está definido no ficheiro de CÓDIGO de XSL. Por exemplo, o "xsl:teste1" será expandido para "http://www.w3.org/199/XSL/Transform:teste1" Poderá ser necessário resolver um ponto de paragem pedido com o seu URL e número de linha associado. Isto é feito automaticamente, depois de o primeiro modelo ter sido visto pelo 'xsldbg'. Os pontos de paragem são validados de novo, pouco depois do início de cada execução. A validação automática dos pontos de paragem é usada quando o modo do 'gdb' está activo - o que é o comportamento por omissão do 'xsldbg' +Utilização do 'break' + + +break -l <FICHEIRO> <NUM_LINHA>    (Para definir um ponto de paragem no ficheiro e número de linha indicados) +break -l <URI> <NUM_LINHA>    (Para definir um ponto de paragem no URI e número de linha indicados) +break <NOME_MODELO>    (Para parar no modelo com o nome indicado ou que corresponda a ele.) +break <NOME_MODELO> <NOME_MODO>    (Para parar no modelo com o nome e o modo indicados.)> +break "" <NOME_MODO>    (Para parar em qualquer modelo que tenha um nome de modo igual ao indicado) +break *    (Para parar em qualquer modelo indicado.) +break \*    (Para parar no modelo "*". Os outros nomes que incluam o '*' não serão tratados de forma especial.) +break     (Para parar no nó actual. Sim, isto inclui os nós de dados em XML!) + + +
+ + +Bye +Pára o processamento da 'stylesheet' o mais cedo possível. +Utilização do 'bye' + + +bye + + +
+ + +Cat +Imprime o resultado de uma expressão de XPath no nó actual relativo. +Utilização do 'cat' + + +Utilização : cat <XPATH>    (Para ver uma variável ou parâmetro) +Utilização : cat $<QNAME> + + +
+ + +Cd +Muda para o local indicado por uma expressão XPath. +Utilização do 'cd' + + +<< = preceding-sibling::node() +>> = following-sibling::node() +<- = ancestor::node() +-> = decendant::node() + +
+ + +Chdir +Muda a pasta de trabalho +Utilização do 'chdir' + + +chdir <LOCALIZAÇÃO>    (Um local relativo ou absoluto no sistema operativo) + + +
+ + +Continue +Continua a execução da 'stylesheet', parando em todos os pontos de paragem encontrados. +Nome de atalho: c +Utilização do 'continue' + + +continue + + +
+ + +Data +Muda para a visualização do nó actual em dados de XML ou muda os dados de XML usados +Utilização do 'data' + + +data    (Muda para o nó actual do documento.) +data <DADOS>    (Para mudar para um ficheiro de dados em XML novo. Um "~" inicial será substituído pelo valor da variável de ambiente $HOME. Será necessário usar o comando "run" para o processar) + + +
+ + +Delete +Remove um ponto de paragem de um modelo +Nome de atalho: d +Utilização do 'delete' + + +delete    (Para remover um ponto de paragem no nó actual) +delete <ID_PONTO_PARAGEM>    (Para remover o ponto de paragem com o número de ponto de paragem indicada) +delete -l <FICHEIRO> <NUM_LINHA>    (Remove o ponto de paragem no ficheiro e número de linha indicados) +delete -l <URI> <NUM_LINHA>    (Remove o ponto de paragem no URI e número de linha indicados) +delete <NOME_MODELO>    (Para remover o ponto de paragem no modelo identificado pelo nome.) +delete *    (Para remover todos os pontos de paragem.) + + +
+ + +Delparam +Remove um parâmetro do 'libxslt' +Utilização do 'delparam' + + +delparam    (Remove todos os parâmetros presentes) +delparam <ID_PARAMETRO> + + +
+ + +Delwatch +Remove uma expressão vigiada ou remove todas as expressões vigiadas que aparecem com o comando "showwatch". +Utilização do 'delwatch' + + +delwatch <ID_VIGIA>    (Remove uma expressão de vigia com o ID indicado) +delwatch *    (Remove todas as expressões de vigia) + + +
+ + +Dir +Imprime uma lista de nós de uma forma semelhante à do comando 'dir' da consola. + +Utilização do 'dir' + + +dir + + +
+ + +Disable +Desactiva um ponto de paragem +Utilização do 'disable' + + +disable    (Para desactivar o ponto de paragem no nó actual) +disable <ID_PONTO_PARAGEM>    (Para desactivar o ponto de paragem com o número de ponto de paragem indicado +disable -l <FICHEIRO> <NUM_LINHA>    (Desactiva o ponto de paragem no ficheiro e número de linha indicado) +disable -l <URI> <NUM_LINHA>    (Desactiva o ponto de paragem no URI e número de linha indicados) + + +
+ + +Du +Imprime um resumo dos nós filhos com um formato em árvore. +Utilização do 'du' + + +du + + +
+ + +Dump +Revela todos os detalhes deste nó +Utilização do 'dump' + + +dump + + +
+ + +Enable +Activa ou desactiva um ponto de paragem (comuta o estado de activo/inactivo) +Nome de atalho: e +Utilização do 'enable' + + +enable    (Para activar/desactivar o ponto de paragem no nó actual) +enable <ID_PONTO_PARAGEM>    (Para activar/desactivar o ponto de paragem com o número de ponto de paragem indicado +enable -l <FICHEIRO> <NUM_LINHA>    (Activa/desactivar o ponto de paragem no ficheiro e número de linha indicados) +enable -l <URI> <NUM_LINHA>    (Activa/desactiva o ponto de paragem no URI e número de linha indicados) + + +
+ + +Entities +Imprime uma lista das entidades gerais processadas que são usadas neste ficheiro de dados (documento) +Nome de atalho : ent +Utilização do 'ent' + + +entities + + +
+ + +Exit +Pára o processamento da 'stylesheet' o mais cedo possível. +Utilização do 'exit' + + +exit + + +
+ + +Frame +Imprime o conteúdo da pilha a uma dada profundidade +Nome de atalho : f +Utilização do 'frame' + + +frame <PROFUNDIDADE>    (A profundidade é um número de 0 até à profundidade actual da pilha de chamadas) + + +
+ + +Free +Liberta a 'stylesheet' e os dados (desactivado; veja o 'run') +Utilização do 'free' + + +free + + +
+ + +Globals +Imprime uma lista com as variáveis e parâmetros globais da 'stylesheet'. Imprime o valor de uma variável global +Utilização do 'globals' + + +globals    (Imprime uma lista com todas as variáveis disponíveis a nível global) +globals -f    (Imprime uma lista com todas as variáveis globais e os seus valores) +globals <QNAME>    (Imprime o valor da variável indicada) + + +
+ + +Help +Mostra uma ajuda ou uma introdução aos comandos +Nome de atalho: h +Utilização do 'help' + + +help     (Mostra uma apresentação do produto) +help <COMANDO>     (Mostra alguma ajuda sobre um dado comando) + + +
+ + +Load +Carrega as opções e preferências do utilizador do 'xsldbg' a partir do disco +Utilização do 'load' + + +load + + +
+ + +Locals +Imprime uma lista com as variáveis e parâmetros locais da 'stylesheet'. Imprime o valor de uma variável local +Utilização do 'locals' + + +locals    (Imprime uma lista com todas as variáveis disponíveis a nível local) +locals -f    (Imprime uma lista com todas as variáveis disponíveis a nível local, bem como os seus valores) +locals <QNAME>    (Imprime o valor da variável indicada) + + +
+ + +Ls +Apresenta os nós num formato breve +Utilização do 'ls' + + +ls + + +
+ + +Next +Salta por cima de um 'xsl:call-template' ou um 'xsl:apply-templates'. Este comando tem o mesmo efeito que a introdução dos comandos "step" e "up" +Nome de atalho: n +Utilização do 'next' + + +next    (salta para a próxima instrução ao mesmo nível) + + +
+ + +Options +Imprime os valores das opções do 'xsldbg' +Utilização do 'options' + + +options + + +
+ + +Output +Indica um ficheiro local e com permissões de escrita para onde gravar o resultado +Nome de atalho : o +Utilização do 'output' + + +output <FICHEIRO>    (Um ficheiro local com permissões de escrita. Poderá ter um prefixo "~" nas plataformas *nix e CYGWIN ou variáveis de ambiente no RISC OS) +output <URI>    (O <URI> só poderá usar o protocolo "file://". Este é então convertido para um nome de ficheiro que possa ser adequado para o sistema operativo) +output -    ( Envia para o 'standard output'. Só poderá ser usado se usar a versão para a linha de comandos do 'xsldbg' ) + + +
+ + +Public +Imprime o valor que um ID público mapeia no catálogo actual +Nome de atalho : pub +Utilização do 'public' + + +public "<IDPublico>" + + +
+ + +Pwd +Imprime a pasta de trabalho actual. +Utilização do 'pwd' + + +pwd + + +
+ + +Quit +Pára o processamento da 'stylesheet' o mais cedo possível. +Nome de atalho: q +Utilização do 'quit' + + +quit + + +
+ + +Run +Reinicia a 'stylesheet'. +Nome de atalho: r +Utilização do 'run' + + +run + + +
+ + +Save +Grava as opções ou preferências de utilizador do 'xsldbg' no disco +Utilização do 'save' + + +save + + +
+ + +Search +Procura numa base de dados com toda a informação extraída das 'stylesheets' carregadas +Todos os ficheiros de saída são gravados no valor da opção "searchresultspath", se estiver definida, ou na mesma pasta que a 'stylesheet' indicada. O 'searchresults.xml' é normalmente transformado pelo 'search.xsl', mas também pode ser transformado com o 'searchhtml.xsl' se a opção "prefrehtml" estiver definida. Quando o comando 'search' é invocado, é gerado um ficheiro em XML (searchresults.xml). Poderá então processar este ficheiro com a sua própria 'stylesheet' para apresentar os dados de outra forma. Se a opção "preferhtml" não estiver definida, então será apresentado o 'searchresult.txt'. Dependendo da quantidade de dados obtida, poderá levar algum tempo a terminar este comando. +Utilização do 'search' + + +search <XPATH>    (Vê o XPath que pode ser usado; veja em search.dtd. O <XPATH> por omissão é o '//search/*' ) +search -sort <XPATH>    (Diz ao 'search.xsl' para ordenar os resultados antes de os devolver) + + +
+ + +Set +Define o valor de uma variável +Utilização do 'set' + + +set <NOME_VARIÁVEL> <XPATH> + + +
+ + +Setoption +Define uma opção para a execução da 'stylesheet' +Terá de usar o comando 'run' para activar as alterações +Utilização do 'setoption' + + +setoption <NOME_OPÇÃO> <VALOR_INTEIRO> +Onde o <NOME_OPÇÃO> tanto poderá ser + + + + + debug    (se o <VALOR_INTEIRO> for verdadeiro, faz uma visualização completa da árvore do resultado em alternativa) + catalogs    (se o <VALOR_INTEIRO> for verdadeiro, usa os catálogos de $SGML_CATALOG_FILES ou de SGML$CatalogFiles para o sistema operativo RISC) + html    (se o <VALOR_INTEIRO> for verdadeiro, o documento à entrada é um ficheiro em HTML) + docbook    (se o <INTEGER_VALUE> for verdadeiro e o DocBook ainda for suportado pela 'libxml', o documento de entrada é em DocBook de SGML) + xinclude    (se o <VALOR_INTEIRO> for verdadeiro, será feito um processamento de XInclude no documento de entrada) + preferhtml    (se o <VALOR_INTEIRO> for verdadeiro, será usado como preferido um resultado em HTML. Veja o comando 'search') + autoencode    (se o <VALOR_INTEIRO> for verdadeiro, tenta usar a codificação da 'stylesheet') + utf8input    (se o <VALOR_INTEIRO> for verdadeiro, todos os dados de entrada do utilizador estão em UTF-8. Isto é usado normalmente quando o 'xsldbg' é usado como uma tarefa ('thread') em separado) +      + gdb    (Executa no modo de compatibilidade com o 'gdb') + Para um valor igual a 1, isto significa + Imprime bastante mais mensagens. Aumenta a frequência das mensagens "Ponto de paragem em ..." + Serão impressas no máximo GDB_LINES_TO_PRINT linhas ao avaliar as expressões, seguidas de um "...". Veja o 'options.h' para alterar este valor, pelo que o predefinido são três linhas de texto + Tanto as locais como as globais serão impressas quando for executado o comando "locals" + Ao imprimir as expressões com o 'cat'/'print'. O valor avaliado será antecedido de um "= " < EXPRESSÃO > + + + + + + Para um valor igual a 2, significa Imprime as mensagens necessárias pelo KDbg, assim como o estado do 'output' acima (quando o valor é igual a 1) + + + + + + + + + nonet    (se o <VALOR_INTEIRO> for verdadeiro, recusa-se a obter os DTDs ou entidades a partir da rede) + novalid    (se o <VALOR_INTEIRO> for verdadeiro, salta a fase de carregamento da DTD) + repeat    (se o <VALOR_INTEIRO> for verdadeiro, executa 20 vezes a transformação) + profile    (se o <VALOR_INTEIRO> for verdadeiro, apresenta as informações de análise) + timing    (se o <VALOR_INTEIRO> for verdadeiro, mostra o tempo consumido) + noout    (se o <VALOR_INTEIRO> for verdadeiro, não apresenta o resultado) + + + + +Onde o valor é verdadeiro, se NÃO for igual a zero +Onde o valor é falso, se FOR igual a zero +stdout    Imprime todas as mensagens de erro no 'stdout'. Normalmente, as mensagens de erro vão para o 'stderr'. +setoption <NOME_OPÇÃO> "<VALOR_TEXTO>"    (Não deverá conter aspas no <VALOR_TEXTO>) +setoption <NOME_OPÇÃO> <VALOR_TEXTO>    (Não deverá conter quaisquer espaços, nem aspas, no <VALOR_TEXTO>) +Onde o <NOME_OPÇÃO> tanto poderá ser + + + + + data    (URI do ficheiro de dados) + source    (URI do ficheiro de código) + output    (IDSistema do ficheiro de saída) + docspath    (Local a usar quando procurar por documentação) + catalognames    (Os nomes dos catálogos a usar quando a opção 'catalogs' estiver activa. O valor será perdido se for definido antes de configurar a opção 'catalogs') + encoding    (Qual a codificação a usar para o 'standard output') + searchresultspath    Qual o local a usar ao guardar os resultados da pesquisa. Se não estiver definido, então o 'xsldbg' irá usar o mesmo local que o da 'stylesheet' + + + + + +
+ + +Shell +Executar um comando da consola +Utilização do 'shell' + + +shell <TEXTO>    (o <TEXTO> é o texto a passar ao sistema operativo para ser executado) + + +
+ + +Showbreak +Para mostrar uma lista dos pontos de paragem dos modelos. +Nome de atalho: showSe existir um modo e um ponto de paragem no modelo, então este será adicionado ao fim do nome do modelo para o ponto de paragem. Um exemplo do resultado será: +Ponto de paragem 3 activo para o modelo :"*" no ficheiro teste1.xsl : linha 105 +Ponto de paragem 2 activo para o modelo :"* modoTeste" no ficheiro teste1.xsl : linha 109 +Ponto de paragem 1 activo para o modelo :"* http://www.w3.org/1999/XSL/Transform:modoTeste" no ficheiro teste1.xsl : linha 113 + +Um total de 3 pontos de paragem presentes + +Utilização do 'showbreak' + + +showbreak + + +
+ + +Showparam +Imprime os parâmetros da 'libxslt' presentes +Utilização do 'showparam' + + +showparam + + +
+ + +Showwatch +Mostra a expressão actual que está a ser vigiada +Nome de atalho: watches +Utilização do 'showwatch' + + +showwatch    (Mostra as vigias actuais e os seus valores) +showwatch 1    (Activa a impressão automática das expressões vigiadas. Isto é usado por omissão.) +showwatch 0    (Desactiva a impressão automática das expressões vigiadas.) + + +
+ + +Source +Muda para a visualização do nó actual na 'stylesheet' ou muda a 'stylesheet' usada +Utilização do 'source' + + +source    (Muda para o nó actual da 'stylesheet'.) +source <CÓDIGO>    (Muda para um novo ficheiro de código. Um "~" inicial será substituído pelo valor da variável de ambiente $HOME. Terá de usar o comando "run" para o executar) + + +
+ + +Step +Avança até à próxima instrução da 'stylesheet'. +Nome de atalho: s +Utilização do 'step' + + +step + + +
+ + +Stepdown +Avança, descendo para um novo nível da "pilha de chamadas". +Nome de atalho: down +Utilização do 'stepdown' + + +stepdown     (desce um nível na pilha de chamadas) +stepdown <NUMERO_DE_TRAMAS>    (desce o número de níveis indicado na pilha de chamadas) + + +
+ + +Stepup +Volta para um nível superior na "pilha de chamadas". +Nome de atalho: upEste não é um comando correcto, pelo que o 'xsldbg' irá parar assim que possa. +Utilização do 'stepup' + + +stepup     (sobe um nível da pilha) +stepup <NUMERO_DE_TRAMAS>     (sobe o número indicado de níveis da pilha de chamadas) + + +
+ + +Stylesheets +Imprime uma lista com as 'stylesheets' carregadas +Nome de atalho: style +Utilização do 'stylesheets' + + +stylesheets + + +
+ + + +System +Imprime o valor que um ficheiro do sistema mapeia no catálogo actual +Nome de atalho : sys +Utilização do 'system' + + +system "<IDSistema>" + + +
+ + +Templates +Imprime uma lista com os modelos disponíveis. Procura por um modelo +Nome de atalho: t +Utilização do 'templates' + + +templates +templates <MODELO>    (Imprime os detalhes do modelo com o nome <MODELO> se existir) + + +
+ + +Trace +Faz um registo da execução da 'stylesheet', apresentando o ficheiro e os números de linha dos passos intermédios +Utilização do 'trace' + + +trace + + +
+ + +Tty +Abre um terminal. Altera o nível de redireccionamento do TTY. +Utilização do 'tty' + + +tty <LOCAL_DISPOSITIVO>    (em que o <LOCAL_DISPOSITIVO> é um terminal válido no sistema operativo. Tenta simplesmente aceder ao terminal +tty <NIVEL_TTY>    (Altera o nível de redireccionamento do TTY, onde o <NIVEL_TTY> é um nível válido de entrada/saída a usar) + Onde o 'nível' é + 0 = entrada/saída por omissão + 1 = Saída para o terminal dos resultados da transformação, do registo e do percurso     (O estado por omissão quando o dispositivo de TTY tiver sido aberto. Não está ainda completamente implementado.) + 2 = Redireccionamento completo para o terminal    (Ainda não implementado.) + Todos os outros valores inteiros correspondem ao nível 0 + + + + + + +
+ + +Validate +Valida o ficheiro de saída gerado pela 'stylesheet' (desactivado) +Utilização do 'validate' + + +validate + + +
+ + +Walk +Percorre o código, usando um intervalo de velocidades +Utilização do 'walk' + + +walk <VELOCIDADE>    (Use o Ctrl-c para parar a execução, a <VELOCIDADE> é um valor entre 0 e 9, em que o 0 significa parado, o 1 é muito rápido e o 9 é muito lento) + + +
+ + +Where +Imprime um registo das chamadas de modelos (pilha de chamadas) e imprime a pasta de trabalho. +Nome de atalho: w +Utilização do 'where' + + +where + + +
+ + +Write +A ser terminada +Utilização do 'write' + + +write + + +
+ + + + + + + diff --git a/doc/pt/xsldbg/credits.docbook b/doc/pt/xsldbg/credits.docbook new file mode 100644 index 0000000..83ffc31 --- /dev/null +++ b/doc/pt/xsldbg/credits.docbook @@ -0,0 +1,14 @@ + + +Créditos e Licença + +&xsldbg; +Programa com 'copyright' 2004 de Keith Isdale k_isdale tpg com au + +Tradução de José Nuno Pires jncp@netcabo.pt +&underFDL; &underGPL; +Agradecimentos a +Os criadores da 'libxml' e da 'libxsl'. +Johannes Sixt pela ajuda ao adicionar o suporte do 'xsldbg' ao KDbg + + diff --git a/doc/pt/xsldbg/index.docbook b/doc/pt/xsldbg/index.docbook new file mode 100644 index 0000000..7baf878 --- /dev/null +++ b/doc/pt/xsldbg/index.docbook @@ -0,0 +1,96 @@ + +xsldbg"> + + + + + + + + +]> + + + + + + + + + + + +O Manual do &xsldbg; + + +Keith Isdale
k_isdale@tpg.com.au
+ + + +JoséPires
jncp@netcabo.pt
Tradução + + + + +2002 +2003 +Keith Isdale + + +&FDLNotice; +2004-09-26 +1.01.00 + + + +O &xsldbg; é uma ferramenta que pretende ajudar a compreender as 'stylesheets'. O que o torna diferente em relação aos outros depuradores de 'stylesheets' é a capacidade de procurar por itens de interesse e de seguir a execução da 'stylesheet'. + + + +KDE +tdeutils +xsldbg +xsl +XML + + + + +&introduction-chapter; +&usage-chapter; +&commands-chapter; +&credits-chapter; + + + +Instalação + + +Como obter o &xsldbg; + +Veja a componente do 'kxsldbg' do módulo 'tdewebdev' no seu repositório de SVN do &kde;. +&install.intro.documentation; + + +Requisitos + +Para poder usar com sucesso o &xsldbg;, necessita da 'libxslt', 'libexslt' e 'libxml' do &kde; instaladas, o que acontece numa instalação típica do &kde;. + + + +Compilação e Instalação +O &xsldbg; é normalmente compilado como parte do componente 'kxsldbg', no módulo 'tdewebdev' + + + +Configuração + +O &xsldbg; é configurado através dos argumentos passados à linha de comandos e do seu comando setoption + + + + + +&documentation.index; + diff --git a/doc/pt/xsldbg/introduction.docbook b/doc/pt/xsldbg/introduction.docbook new file mode 100644 index 0000000..eee1964 --- /dev/null +++ b/doc/pt/xsldbg/introduction.docbook @@ -0,0 +1,16 @@ + + +Introdução + +O &xsldbg; é uma ferramenta baseada em texto para depurar 'stylesheets' ou folhas de estilo (na linguagem eXtensible Stylesheet Language) e tem comandos semelhantes ao depurador 'gdb' do Unix/Linux. Ele tem três modos importantes de execução das 'stylesheets'. + + + + Executar a 'stylesheet' por completo + Saltar para a próxima instrução de XSL + Continuar até ao próximo ponto de paragem ou reiniciar a 'stylesheet' + + + + + diff --git a/doc/pt/xsldbg/usage.docbook b/doc/pt/xsldbg/usage.docbook new file mode 100644 index 0000000..e30c37f --- /dev/null +++ b/doc/pt/xsldbg/usage.docbook @@ -0,0 +1,62 @@ + + +Usar o &xsldbg; + +Argumentos do comando 'xsldbg' +Nos sistemas que tenham a biblioteca 'readline' disponível, poderá usar as teclas para recuar/avançar para navegar no histórico de comandos introduzidos. Em todos os sistemas, o último comando introduzido poderá ser repetido se carregar na tecla <ENTER>. +Se o seu sistema operativo o suportar, os nomes dos ficheiros serão expandidos. +Vários dos comandos recebem mais que um argumento. Podem ser usadas plicas para que as expressões complexas seja tratadas como apenas um argumento, ⪚ o 'break "* | @"' iria permitir usar um ponto de paragem no modelo com o nome "* | @" + + +Legenda de termos +A tabela seguinte descreve os termos usados no guia de comandos subsequente + + + NOME_MODELO : Um nome de modelo válido só contém os caracteres ASCII de 0x00 até 0x7F. Poderá ser um nome qualificado por completo como por exemplo "xsl:nomeModelo". + FICHEIRO : Um nome de ficheiro válido e local ao sistema do utilizador. Poderá ter um prefixo "~" nas plataformas *nix e CYGWIN ou variáveis de ambiente no RISC OS + URI : Um Uniform Resource Identifier, tal como está definido no RFC 2396 + NOME_MODO O modo do modelo, o qual poderá ser um nome completo qualificado, por exemplo "xsl:nomeModo". + QNAME : Um nome qualificado e completo, por exemplo "xsl:parteLocal" + NUM_LINHA : Um número de linha válido no <FICHEIRO> associado + NUMERO_DE_TRAMAS : Um número de tramas da linha para o qual mudar de posição + ID_PONTO_PARAGEM : Um número de ponto de paragem válido + ID_VIGIA : Um número de expressão de vigia válido, tal como é indicado no comando 'showwatch' + VELOCIDADE: a velocidade com a qual percorrer o código, entre 0 e 9 +     (Comentário): um comentário sobre o significado ou utilização do comando + { opç1 | opç2 | opç3 .. etc} : Escolher um das opções + XPATH : uma selecção de nós via XPath + ID_PARAM : um número de parâmetro válido, tal como é indicado pelo comando 'showparam' + LOCALIZAÇÃO : Um local para o qual mudar a pasta de trabalho. Em alguns sistemas operativos, um prefixo "~" será substituído pelo seu local de trabalho + TEXTO : Algum texto livre     (sem restrições) + COMANDO : Um comando válido para o 'xsldbg' + QNAME : Um nome de parâmetro/variável válido + CÓDIGO : A 'stylesheet' que está a ser/será executada. Veja o <FICHEIRO> e o <URI> + DADOS : Os dados em XML (o documento) que está a ser/será processado pela 'stylesheet'. Veja o <FICHEIRO> e o <URI> + LOCAL_DISPOSITIVO : É um terminal válido no sistema operativo + NIVEL_TTY : É um nível válido de entrada/saída a usar + + + + +Apresentação aos comandos disponíveis + + +Relacionados com a ajuda :help +Relacionados com a execução : {bye|exit| quit}, step, stepup, stepdown, next, continue, run, trace, setoption, options +Relacionados com os parâmetros da Libxslt : addparam, delparam, showparam, output, setoption, options +Relacionados com os modelos : templates, where, frame +Relacionados com os pontos de paragem : break, showbreak, delete, enable +Visualização de expressões (XPath) : cat +Visualização de nós : ls, dir, du, cat, pwd +Visualização de variáveis : globals, locals, cat, addwatch +Definição de variáveis: set +Selecção de nós : source, data, cd +Procura :search +Relacionados com o sistema operativo :chdir, shell, tty +Relacionados com ficheiros : output, entities, system, public +Comandos de ficheiros desactivados: validate, load, save, write, free + + + + + diff --git a/doc/pt_BR/kxsldbg/callstack.docbook b/doc/pt_BR/kxsldbg/callstack.docbook new file mode 100644 index 0000000..bf75e71 --- /dev/null +++ b/doc/pt_BR/kxsldbg/callstack.docbook @@ -0,0 +1,28 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +MarcusGama
marcus_gama@uol.com.br
Tradução + + + +Trabalhando com a Pilha de Chamadas + +Todos os itens da pilha de chamadas são listados aqui. Quanto mais antigo for o item da pilha menor número de ordem terá. Veja abaixo um exemplo. + + +A Janela da Pilha de Chamadas + + + + +A Janela da Pilha de Chamadas + + + +Clicando num item da pilha de chamadas na lista apresentada, fará com que o cursor da janela principal salte para o arquivo e para o número de linha indicado. + + diff --git a/doc/pt_BR/kxsldbg/credits.docbook b/doc/pt_BR/kxsldbg/credits.docbook new file mode 100644 index 0000000..4b3a9ad --- /dev/null +++ b/doc/pt_BR/kxsldbg/credits.docbook @@ -0,0 +1,29 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +MarcusGama
marcus_gama@uol.com.br
Tradução + + +Créditos e Licenças + +&kxsldbg; © 2004 Keith Isdale +Documentation © 2004 Keith Isdale + + + +Agradecimentos a: + +Os criadores da libxml e da libxslt. + + +Robert Jacolin pelo 'feedback' a uma versão anterior do &kxsldbg;. + + +Igor Zlatkovic por criar os binários em WIN32 da libxml/xslt e do &xsldbg;. + + +&underFDL; &underGPL; diff --git a/doc/pt_BR/kxsldbg/entities.docbook b/doc/pt_BR/kxsldbg/entities.docbook new file mode 100644 index 0000000..7c4df15 --- /dev/null +++ b/doc/pt_BR/kxsldbg/entities.docbook @@ -0,0 +1,28 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +MarcusGama
marcus_gama@uol.com.br
Tradução + + +Trabalhando com os Arquivos de Dados em &XML; (Entidades) + +Se o diálogo de inspeção não é mostrado use a opção do menu Ferramentas Mostrar os inspetores . Para trabalhar com as entidades clique na página Entidades do diálogo que é mostrado. + +Todas as entidades externas de &XML; incluídas com o arquivo DATA ou com alguns dos arquivos de mesmo nível são mostradas aqui. Para este exemplo foi executado o &kxsldbg; no test13.xsl com o test13.xml (encontrado na pasta <PREFIXO DO KDE>/share/apps/kxsldbg da distribuição de código do &xsldbg;) de modo a que possa ver algumas entidades. + + +A Janela de Entidades + + + + +A Janela de Entidades + + + +Clicando no item de uma entidade na lista irá mudar o cursor na janela principal para o início do arquivo indicado. + diff --git a/doc/pt_BR/kxsldbg/glossary.docbook b/doc/pt_BR/kxsldbg/glossary.docbook new file mode 100644 index 0000000..1c94ee6 --- /dev/null +++ b/doc/pt_BR/kxsldbg/glossary.docbook @@ -0,0 +1,35 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +MarcusGama
marcus_gama@uol.com.br
Tradução + + + + +Palavras-Chave + +&xsldbg; + +Veja em . + + + + +XPath + +Uma expressão válida que define quais os dados necessários. Veja no sítio Web do W3C. + + + + +QName + +Um nome qualificado completo. Por exemplo xsl:minhavariavel. Veja no sítio Web do W3C + + + + diff --git a/doc/pt_BR/kxsldbg/index.docbook b/doc/pt_BR/kxsldbg/index.docbook new file mode 100644 index 0000000..171de17 --- /dev/null +++ b/doc/pt_BR/kxsldbg/index.docbook @@ -0,0 +1,110 @@ + +KXSLDbg"> + + + + + + + + + + + + + + + xsldbg"> + DTD"> + XSD"> + XSLT"> + +]> + + + + +O Manual do &kxsldbg; + + +Keith Isdale
k_isdale@tpg.com.au
+ + + + + +2002 +2003 +2004 +Keith Isdale + + +&FDLNotice; +2004-11-18 +0.5 + + +O &kxsldbg; oferece uma interface gráfica para o &xsldbg;, que suporta a depuração de código de &XSLT;s. + + + +kde +xsldbg +libxslt +depurador + + + + +Introdução + + +Recursos + +O &kxsldbg; oferece o acesso à maioria dos comandos do &xsldbg; para + +Definir e modificar os pontos de parada + + +Mostrar o valor de XPaths + + +Mostrar informações sobre os pontos de parada, modelos, variáveis, pilha de chamadas, folhas de estilo e entidades encontrados + + +Definir e modificar os pontos de parada e variáveis + + +Percorrer o código da &XSL; e o documento de &XML; através do XPath + + +Procurar os IDs PUBLIC (públicos) e SYSTEM (do sistema) no catálogo de &XML; atual + + + + + + +Recursos adicionados recentemente +O &kxsldbg; pode agora + + +Definir e modificar variáveis + + +Desenhar o texto na janela principal, usando as bibliotecas do &kate; + + + + + + + + +Usando o &kxsldbg; +&configure-section; &mainwindow-section; &inspector-section; &variables; &callstack; &templates; &sources; &entities; &tools-section; + +&credits-chapter; + + diff --git a/doc/pt_BR/kxsldbg/kxsldbg_configure.docbook b/doc/pt_BR/kxsldbg/kxsldbg_configure.docbook new file mode 100644 index 0000000..450a22a --- /dev/null +++ b/doc/pt_BR/kxsldbg/kxsldbg_configure.docbook @@ -0,0 +1,67 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +MarcusGama
marcus_gama@uol.com.br
Tradução + + + +Configurando uma Sessão do &kxsldbg; + +Você inicia a configuração clicando em Depurar Configurar no menu. + + +O Diálogo de Configuração + + + + +O Diálogo de Configuração +O Diálogo de Configuração. + + + + +Começando + +Para ser capaz de executar uma folha de estilo ou 'stylesheet' você precisa indicar o: +código da &XSL; +dados em &XML; +Arquivo de resultado + + + +Usando o botão ... poderá escolher o arquivo desejado. O Código de &XSL; e os Dados em &XML; podem referir-se a URIs que contenham um http://, um ftp:// ou um file://. O Arquivo de resultado deverá ser um arquivo local com permissões de escrita. +Para acompanhar os exemplos, selecione os seguintes arquivos na pasta de exemplo em <PREFIXO DO KDE>/share/apps/kxsldbg +código de &XSL;: testdoc.xsl +dados em &XML;: testdoc.xml +Arquivo de resultado: /tmp/resultado.txt + + + + + +Trabalhando com as Opções + +Você poderá selecionar zero ou mais opções no diálogo de Opções. Cada opção tem uma dica com uma sugestão do efeito que ela tem. + + + +Trabalhando com os Parâmetros + +Você poderá adicionar zero ou mais parâmetros com a seção Parâmetros da LibXSLT do diálogo. Isto permite-lhe fornecer valores aos parâmetros da 'stylesheet'. + +Por exemplo, você poderá adicionar um Nome de parâmetro igual a meu_parametro com um Valor de Parâmetro igual a 'Olá mundo!' e clicar no botão Adicionar. Para atualizar o valor de um parâmetro existente, basta escolhe o valor que deseja alterar com os botões Anterior ou Próximo, inserir um Valor de parâmetro novo e clicar em Aplicar. + + + +Aplicando as Alterações + +Para as alterações que efetuou terem efeito clique no botão Aplicar. Para ignorar as alterações, clique no botão Cancelar. + +Você poderá fechar o diálogo usando o botão X do canto superior direito da janela. Se precisar alterar a configuração basta reabrir o diálogo de configuração tal como foi explicado anteriormente. + + diff --git a/doc/pt_BR/kxsldbg/kxsldbg_inspector.docbook b/doc/pt_BR/kxsldbg/kxsldbg_inspector.docbook new file mode 100644 index 0000000..ba0f96d --- /dev/null +++ b/doc/pt_BR/kxsldbg/kxsldbg_inspector.docbook @@ -0,0 +1,71 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +MarcusGama
marcus_gama@uol.com.br
Tradução + + +Definindo e Modificando os Pontos de Parada + +A forma principal de lidar com os pontos de parada é através da janela principal. Veja + +Logo que tenha iniciado a 'stylesheet', você poderá usar o item do menu Ferramentas Mostrar os inspetores . clique então na página Pontos de Parada. Veja abaixo um exemplo. + + +Definindo os Pontos de Parada + + + + +Definindo os Pontos de Parada + + + + +Adicionando um Ponto de Parada + +Você poderá adicionar um ponto de parada se fornecer um dos seguintes itens: + +um arquivo e um número de linha + +o nome de um modelo + +o nome de um modelo e o nome de um modo + +o nome de um modo + + + + +E pressionar em seguida no botão Adicionar. + + + +Detalhes do Argumento + +O nome de um arquivo poderá ser a localização completa de um arquivo local, ou apenas uma localização parcial (⪚ docum_xsl.xsl). + +O nome de um modelo ou de um modo é um Nome Qualificado completo onde a parte não-local é opcional, ⪚ xsl:meumodelo corresponde a meumodelo + + + +Removendo um Ponto de Parada + +Primeiramente clique no ponto de parada que deseja remover na lista de pontos de parada atuais. Clique depois no botão Remover. + + + +Removendo Todos os Pontos de Parada + +Clique no botão Remover Tudo. + + + +Ativando ou Desativando um Ponto de Parada + +Primeiramente clique com o &LMB; no ponto de parada que deseja ativar na lista de pontos de parada atuais. Depois clique no botão Ativar. + + diff --git a/doc/pt_BR/kxsldbg/kxsldbg_mainwindow.docbook b/doc/pt_BR/kxsldbg/kxsldbg_mainwindow.docbook new file mode 100644 index 0000000..84187e1 --- /dev/null +++ b/doc/pt_BR/kxsldbg/kxsldbg_mainwindow.docbook @@ -0,0 +1,443 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +MarcusGama
marcus_gama@uol.com.br
Tradução + + +Usando a Janela Principal + + +A Janela Principal + + + + +Uma janela de texto com o arquivo atual sendo depurado +Uma janela de texto com o arquivo atual sendo depurado. + + + + +Trabalhando na Janela Principal + +O estado de um determinado ponto de parada é indicado através do texto relevante com uma cor de fundo diferente. Você poderá escolher a cor desejada: veja no diálogo em ConfiguraçõesConfigurar o Editor, na página de Cores. + + +Você poderá definir, desativar ou remover um ponto de parada, usando as teclas, o menu Depurar ou os botões da barra de ferramentas. + +Você poderá mover o cursor pelo texto, usando as seguintes teclas: + + +Teclas de cursores: Esquerda, Direita, Cima ou Baixo. +Teclas de página: Page Up ou Page Down + + + + + + +Trabalhando com o Resultado do &kxsldbg; + +Grande parte do resultado do &kxsldbg; é capturado e apresentado tanto na janela dos inspetores como no resultado do &kxsldbg;. As exceções a esta regra são: + + +Uma mensagem de erro que vem do &kxsldbg; e que é mostrada dentro de uma janela de mensagens. + + +O resultado da avaliação de uma expressão que é também mostrado numa janela de mensagens. + + +O resultado da procura é enviado para o arquivo indicado na janela de resultado do &kxsldbg;. + + + + + + + + diff --git a/doc/pt_BR/kxsldbg/kxsldbg_tools.docbook b/doc/pt_BR/kxsldbg/kxsldbg_tools.docbook new file mode 100644 index 0000000..e825442 --- /dev/null +++ b/doc/pt_BR/kxsldbg/kxsldbg_tools.docbook @@ -0,0 +1,77 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +MarcusGama
marcus_gama@uol.com.br
Tradução + + + +Ferramentas Diversas + +Várias ferramentas estão disponíveis através do menu de ferramentas; a ferramenta principal é a de inspeção. + + +Ferramenta de Inspeção + +A ferramenta de inspeção é a que contém todos os diálogos individuais para trabalhar com: + +Pontos de Parada +Modelos +Variáveis +Itens da pilha de chamadas +Arquivos de código &XSL; +Entidades de &XML; + + + + + +Executar Passo-a-Passo + +Clicando no menu Iniciar a execução passo-a-passo é mostrado um diálogo que permite escolher a velocidade do passo de execução. + + +A Janela de Passo + + + + +A Janela de Passo + + + +Para parar de avançar use a tecla W ou selecione o item do menu Iniciar a execução passo-a-passo. + + + +Procurando as Entidades de &XML; + +Para procurar um ID de Sistema no catálogo de &XML; atual use a opção Procurar o ID do Sistema e insira o valor a procurar no diálogo exibido. + + +A Janela do ID do Sistema + + + + +A Janela do ID do Sistema + + + +Para procurar um ID público use a opção Procurar um ID Público e insira o valor a procurar no diálogo exibido. + + +A Janela do ID Público + + + + +A Janela do ID Público + + + + + diff --git a/doc/pt_BR/kxsldbg/sources.docbook b/doc/pt_BR/kxsldbg/sources.docbook new file mode 100644 index 0000000..73beb64 --- /dev/null +++ b/doc/pt_BR/kxsldbg/sources.docbook @@ -0,0 +1,27 @@ + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +MarcusGama
marcus_gama@uol.com.br
Tradução + + +Trabalhando com Arquivos de Código de &XSLT; (Código) + +Se a janela de inspeção não estiver visível use a opção Ferramentas Mostrar os inspetores . Para trabalhar com o código, clique na página de código do diálogo mostrado. + +Todos os arquivos de código &XSLT; que são incluídos no arquivo &XSLT; ou nos arquivos do mesmo nível são listados aqui. + + +A Janela de Código + + + + +A Janela de Código + + + +Clicando num item de código na lista mostrada fará com que o cursor da janela principal passe para o início do arquivo indicado. + diff --git a/doc/pt_BR/kxsldbg/templates.docbook b/doc/pt_BR/kxsldbg/templates.docbook new file mode 100644 index 0000000..86a6dce --- /dev/null +++ b/doc/pt_BR/kxsldbg/templates.docbook @@ -0,0 +1,20 @@ + +Trabalhando com Modelos + +Se a janela de inspeção não estiver visível use a opção Ferramentas Mostrar os inspetores . Para trablhar com modelos, clique na página de modelos no diálogo mostrado. + +Todos os modelos encontrados são aqui listados. Repare que as regras de exportação do &XSLT; se aplicam. Assim poderá existir mais de um modelo com a mesma correspondência e modo. + + +A Janela de Modelos + + + + +A Janela de Modelos + + + +Clicando num item de um modelo na lista mostrada fará com que o cursor da janela principal salte para o arquivo e número de linha indicados. + + diff --git a/doc/pt_BR/kxsldbg/variables.docbook b/doc/pt_BR/kxsldbg/variables.docbook new file mode 100644 index 0000000..3ada4bd --- /dev/null +++ b/doc/pt_BR/kxsldbg/variables.docbook @@ -0,0 +1,44 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +MarcusGama
marcus_gama@uol.com.br
Tradução + + + +Trabalhando Com Variáveis + +Se a janela de inspeção não estiver visível use a opção Ferramentas Mostrar os inspetores . + +As variáveis locais e globais são mostradas numa página do diálogo de inspeção. O exemplo a seguir mostra um segmento de código de XSLT que declara uma variável global e uma local + +<xsl:variable name="variavelglobal" select="'xpto'"/> + + <xsl:template match="/"/> + <xsl:param name="variavellocal" select="'xpto2'"/> + </xsl:template match="/"/> + + +Clicando com o mouse numa variável da lista, irá mostrar uma informação de resumo no fundo da janela. Se uma variável tiver uma expressão de seleção, por exemplo + +<xsl:variable name="alteravel" select="'valorAntigo'" /> + + +então poderá ser escolhido um novo XPath com um novo valor para a Expressão da variável, clicando depois no botão Definir a expressão. + + +A página de Variáveis + + + + +A Página de Variáveis +A Página de Variáveis + + + +Clicando num item de uma variável na lista mostrada fará com que o cursor da janela principal passe para o arquivo e número de linha indicados. + diff --git a/doc/pt_BR/xsldbg/commands.docbook b/doc/pt_BR/xsldbg/commands.docbook new file mode 100644 index 0000000..ff2aec8 --- /dev/null +++ b/doc/pt_BR/xsldbg/commands.docbook @@ -0,0 +1,758 @@ + + +Referência de Comandos + +Addparam +Adiciona um parâmetro à 'libxslt' ; é equivalente a oferecer a opção --param <QNAME>:<XPATH> através da linha de comando. + +Uso do 'addparam' + +addparam <QNAME> <XPATH>    (O <XPATH> não deverá conter quaisquer espaços nem aspas.) +addparam <QNAME> "<XPATH>"    (Não deverá conter aspas no <XPATH>) + + +
+ + +Addwatch +Adiciona uma expressão para ser vigiada. Veja o 'showwatch' para mostrar os valores das vigias +Nome de atalho: watch +Uso do 'addwatch' + +addwatch <XPATH> + + +
+ + +Base +Imprime a base deste nó +Uso do 'base' + + +base + + +
+ + +Break +Interrompe num modelo, num determinado local de uma folha de estilo ou arquivo em XML carregado pelo 'xsldbg' ou no nó atual. É novo no xsldbg 3.1.4: Quando está no modo de compatibilidade com o 'gdb', os pontos de parada órfãos podem ser definidos num arquivo e número de linha específicos e podem ser traduzidos para um ponto de parada ativo mais tarde. +Nome de atalho: bO 'xsldbg' tentará adivinhar o URL completo, com base no nome do arquivo, sem o caminho especificado. nome do arquivo, na mesma pasta que a folha de estilo de topo se encontra nome do arquivo, relativo à pasta de trabalho atual do 'xsldbg' Isto significa que, se tiver carregado um arquivo de uma folha de estilo com um ../en/xsldoc.xsl, poderá fazer isto break -l xsldoc.xsl 26 Este comando fará a correspondência com um modelo QNAME parcial ou completo, assim como a um modo específico. Por exemplo, o "modelo" irá corresponder a qualquer QNAME com uma parte local de "modelo" Quaisquer espaços de nomes no QNAME indicado serão expandidos, tal como está definido no arquivo de CÓDIGO de XSL. Por exemplo, o "xsl:teste1" será expandido para "http://www.w3.org/199/XSL/Transform:teste1" Poderá ser necessário resolver um ponto de parada pedido com o seu URL e número de linha associado. Isto é feito automaticamente, depois do primeiro modelo ter sido visto pelo 'xsldbg'. Os pontos de parada são validados de novo, pouco depois do início de cada execução. A validação automática dos pontos de parada é usada quando o modo do 'gdb' está ativo - o que é o comportamento padrão do 'xsldbg' +Uso do 'break' + + +break -l <ARQUIVO> <NUM_LINHA>    (Para definir um ponto de parada no arquivo e número de linha indicados) +break -l <URI> <NUM_LINHA>    (Para definir um ponto de parada no URI e número de linha indicados) +break <NOME_MODELO>    (Para parar no modelo com o nome indicado ou que corresponda a ele.) +break <NOME_MODELO> <NOME_MODO>    (Para parar no modelo com o nome e o modo indicados.)> +break "" <NOME_MODO>    (Para parar em qualquer modelo que tenha um nome de modo igual ao indicado) +break *    (Para parar em qualquer modelo indicado.) +break \*    (Para parar no modelo "*". Os outros nomes que incluam o '*' não serão tratados de forma especial.) +break     (Para parar no nó atual. Sim, isto inclui os nós de dados em XML!) + + +
+ + +Bye +Pára o processamento da folha de estilo o mais cedo possível. +Uso do 'bye' + + +bye + + +
+ + +Cat +Imprime o resultado de uma expressão de XPath no nó atual relativo. +Uso do 'cat' + + +Uso : cat <XPATH>    (Para ver uma variável ou parâmetro) +Uso : cat $<QNAME> + + +
+ + +Cd +Muda para o local indicado por uma expressão XPath. +Uso do 'cd' + + +<< = preceding-sibling::node() +>> = following-sibling::node() +<- = ancestor::node() +-> = decendant::node() + +
+ + +Chdir +Muda a pasta de trabalho +Uso do 'chdir' + + +chdir <LOCALIZAÇÃO>    (Um local relativo ou absoluto no sistema operacional) + + +
+ + +Continue +Continua a execução da folha de estilo, parando em todos os pontos de parada encontrados. +Nome de atalho: c +Uso do 'continue' + + +continue + + +
+ + +Data +Muda para a visualização do nó atual em dados de XML ou muda os dados de XML usados +Uso do 'data' + + +data    (Muda para o nó atual do documento.) +data <DADOS>    (Para mudar para um arquivo de dados em XML novo. Um "~" inicial será substituído pelo valor da variável de ambiente $HOME. Será necessário usar o comando "run" para processá-lo) + + +
+ + +Delete +Remove um ponto de parada de um modelo +Nome de atalho: d +Uso do 'delete' + + +delete    (Para remover um ponto de parada no nó atual) +delete <ID_PONTO_PARADA>    (Para remover o ponto de parada com o número de ponto de parada indicado) +delete -l <ARQUIVO> <NUM_LINHA>    (Remove o ponto de parada no arquivo e número de linha indicados) +delete -l <URI> <NUM_LINHA>    (Remove o ponto de parada no URI e número de linha indicados) +delete <NOME_MODELO>    (Para remover o ponto de parada no modelo identificado pelo nome.) +delete *    (Para remover todos os pontos de parada.) + + +
+ + +Delparam +Remove um parâmetro do 'libxslt' +Uso do 'delparam' + + +delparam    (Remove todos os parâmetros presentes) +delparam <ID_PARAMETRO> + + +
+ + +Delwatch +Remove uma expressão vigiada ou remove todas as expressões vigiadas que aparecem com o comando "showwatch". +Uso do 'delwatch' + + +delwatch <ID_VIGIA>    (Remove uma expressão de vigia com o ID indicado) +delwatch *    (Remove todas as expressões de vigia) + + +
+ + +Dir +Imprime uma lista de nós de uma forma semelhante à do comando 'dir' do console. + +Uso do 'dir' + + +dir + + +
+ + +Disable +Desativa um ponto de parada +Uso do 'disable' + + +disable    (Para desativar o ponto de parada no nó atual) +disable <ID_PONTO_PARADA>    (Para desativar o ponto de parada com o número de ponto de parada indicado +disable -l <ARQUIVO> <NUM_LINHA>    (Desativa o ponto de parada no arquivo e número de linha indicado) +disable -l <URI> <NUM_LINHA>    (Desativa o ponto de parada no URI e número de linha indicados) + + +
+ + +Du +Imprime um resumo dos nós filhos com um formato em árvore. +Uso do 'du' + + +du + + +
+ + +Dump +Revela todos os detalhes deste nó +Uso do 'dump' + + +dump + + +
+ + +Enable +Ativa ou desativa um ponto de parada (comuta o estado de ativo/inativo) +Nome de atalho: e +Uso do 'enable' + + +enable    (Para ativar/desativar o ponto de parada no nó atual) +enable <ID_PONTO_PARADA>    (Para ativar/desativar o ponto de parada com o número de ponto de parada indicado +enable -l <ARQUIVO> <NUM_LINHA>    (Ativa/desativar o ponto de parada no arquivo e número de linha indicados) +enable -l <URI> <NUM_LINHA>    (Ativa/desativa o ponto de parada no URI e número de linha indicados) + + +
+ + +Entities +Imprime uma lista das entidades gerais processadas que são usadas neste arquivo de dados (documento) +Nome de atalho : ent +Uso do 'ent' + + +entities + + +
+ + +Exit +Pára o processamento da folha de estilo o mais cedo possível. +Uso do 'exit' + + +exit + + +
+ + +Frame +Imprime o conteúdo da pilha a uma determinada profundidade +Nome de atalho : f +Uso do 'frame' + + +frame <PROFUNDIDADE>    (A profundidade é um número de 0 até à profundidade atual da pilha de chamadas) + + +
+ + +Free +Liberta a folha de estilo e os dados (desativado; veja o 'run') +Uso do 'free' + + +free + + +
+ + +Globals +Imprime uma lista com as variáveis e parâmetros globais da folha de estilo. Imprime o valor de uma variável global +Uso do 'globals' + + +globals    (Imprime uma lista com todas as variáveis disponíveis a nível global) +globals -f    (Imprime uma lista com todas as variáveis globais e os seus valores) +globals <QNAME>    (Imprime o valor da variável indicada) + + +
+ + +Help +Mostra uma ajuda ou uma visão geral dos comandos +Nome de atalho: h +Uso do 'help' + + +help     (Mostra uma apresentação do produto) +help <COMANDO>     (Mostra a ajuda sobre um determinado comando) + + +
+ + +Load +Carrega as opções e preferências do usuário do 'xsldbg' a partir do disco +Uso do 'load' + + +load + + +
+ + +Locals +Imprime uma lista com as variáveis e parâmetros locais da folha de estilo. Imprime o valor de uma variável local +Uso do 'locals' + + +locals    (Imprime uma lista com todas as variáveis disponíveis a nível local) +locals -f    (Imprime uma lista com todas as variáveis disponíveis a nível local, bem como os seus valores) +locals <QNAME>    (Imprime o valor da variável indicada) + + +
+ + +Ls +Apresenta os nós num formato resumido +Uso do 'ls' + + +ls + + +
+ + +Next +Pula um 'xsl:call-template' ou um 'xsl:apply-templates'. Este comando tem o mesmo efeito que a inserção dos comandos "step" e "up" +Nome de atalho: n +Uso do 'next' + + +next    (salta para a próxima instrução ao mesmo nível) + + +
+ + +Options +Imprime os valores das opções do 'xsldbg' +Uso do 'options' + + +options + + +
+ + +Output +Indica um arquivo local e com permissões de escrita onde salvar a saída do comando +Nome de atalho : o +Uso do 'output' + + +output <ARQUIVO>    (Um arquivo local com permissões de escrita. Poderá ter um prefixo "~" nas plataformas *nix e CYGWIN ou variáveis de ambiente no RISC OS) +output <URI>    (O <URI> só poderá usar o protocolo "file://". Ele é então convertido para um nome de arquivo que possa ser adequado para o sistema operacional) +output -    ( Envia para a saída padrão. Só poderá ser usado se usar a versão para a linha de comando do 'xsldbg' ) + + +
+ + +Public +Imprime o valor que um ID público mapeia no catálogo atual +Nome de atalho : pub +Uso do 'public' + + +public "<IDPublico>" + + +
+ + +Pwd +Imprime a pasta de trabalho atual. +Uso do 'pwd' + + +pwd + + +
+ + +Quit +Pára o processamento da folha de estilo o mais cedo possível. +Nome de atalho: q +Uso do 'quit' + + +quit + + +
+ + +Run +Reinicia a folha de estilo. +Nome de atalho: r +Uso do 'run' + + +run + + +
+ + +Save +Salva as opções ou preferências do usuário do 'xsldbg' no disco +Uso do 'save' + + +save + + +
+ + +Search +Procura numa base de dados com todas as informações extraídas das folhas de estilo carregadas +Todos os arquivos de saída são gravados no valor da opção "searchresultspath", se estiver definida, ou na mesma pasta que a folha de estilo indicada. O 'searchresults.xml' é normalmente transformado pelo 'search.xsl', mas também pode ser transformado com o 'searchhtml.xsl' se a opção "prefrehtml" estiver definida. Quando o comando 'search' é invocado, é gerado um arquivo em XML (searchresults.xml). Você poderá então processar este arquivo com a sua própria folha de estilo para apresentar os dados de outra forma. Se a opção "preferhtml" não estiver definida, então será apresentado o 'searchresult.txt'. Dependendo da quantidade de dados obtida, poderá levar algum tempo para terminar este comando. +Uso do 'search' + + +search <XPATH>    (Vê o XPath que pode ser usado; veja em search.dtd. O <XPATH> padrão é o '//search/*' ) +search -sort <XPATH>    (Diz ao 'search.xsl' para ordenar os resultados antes de devolvê-los) + + +
+ + +Set +Define o valor de uma variável +Uso do 'set' + + +set <NOME_VARIÁVEL> <XPATH> + + +
+ + +Setoption +Define uma opção para a execução da folha de estilo +Você terá que usar o comando 'run' para ativar as alterações +Uso do 'setoption' + + +setoption <NOME_OPÇÃO> <VALOR_INTEIRO> +Onde o <NOME_OPÇÃO> tanto poderá ser + + + + + debug    (se o <VALOR_INTEIRO> for verdadeiro, faz uma visualização completa da árvore do resultado em alternativa) + catalogs    (se o <VALOR_INTEIRO> for verdadeiro, usa os catálogos de $SGML_CATALOG_FILES ou de SGML$CatalogFiles para o sistema operacional RISC) + html    (se o <VALOR_INTEIRO> for verdadeiro, o documento de entrada é um arquivo em HTML) + docbook    (se o <INTEGER_VALUE> for verdadeiro e o DocBook ainda for suportado pela 'libxml', o documento de entrada é em DocBook de SGML) + xinclude    (se o <VALOR_INTEIRO> for verdadeiro, será feito um processamento de XInclude no documento de entrada) + preferhtml    (se o <VALOR_INTEIRO> for verdadeiro, será usado como preferido um resultado em HTML. Veja o comando 'search') + autoencode    (se o <VALOR_INTEIRO> for verdadeiro, tenta usar a codificação da folha de estilo) + utf8input    (se o <VALOR_INTEIRO> for verdadeiro, todos os dados de entrada do usuário estão em UTF-8. Isto é usado normalmente quando o 'xsldbg' é usado como uma tarefa ('thread') em separado) +      + gdb    (Executa no modo de compatibilidade com o 'gdb') + Para um valor igual a 1, isto significa + Imprime muito mais mensagens. Aumenta a frequência das mensagens "Ponto de parada em ..." + Serão impressas no máximo GDB_LINES_TO_PRINT linhas ao avaliar as expressões, seguidas de um "...". Veja o 'options.h' para alterar este valor, sendo o padrão três linhas de texto + Tanto as locais como as globais serão impressas quando for executado o comando "locals" + Ao imprimir as expressões com o 'cat'/'print'. O valor avaliado será antecedido de um "= " < EXPRESSÃO > + + + + + + Para um valor igual a 2, significa Imprime as mensagens necessárias pelo KDbg, assim como o estado do 'output' acima (quando o valor é igual a 1) + + + + + + + + + nonet    (se o <VALOR_INTEIRO> for verdadeiro, recusa-se a obter os DTDs ou entidades a partir da rede) + novalid    (se o <VALOR_INTEIRO> for verdadeiro, salta a fase de carregamento da DTD) + repeat    (se o <VALOR_INTEIRO> for verdadeiro, executa 20 vezes a transformação) + profile    (se o <VALOR_INTEIRO> for verdadeiro, apresenta as informações de análise) + timing    (se o <VALOR_INTEIRO> for verdadeiro, mostra o tempo consumido) + noout    (se o <VALOR_INTEIRO> for verdadeiro, não apresenta o resultado) + + + + +Onde o valor é verdadeiro, se NÃO for igual a zero +Onde o valor é falso, se FOR igual a zero +stdout    Imprime todas as mensagens de erro no 'stdout'. Normalmente, as mensagens de erro vão para o 'stderr'. +setoption <NOME_OPÇÃO> "<VALOR_TEXTO>"    (Não deverá conter aspas no <VALOR_TEXTO>) +setoption <NOME_OPÇÃO> <VALOR_TEXTO>    (Não deverá conter quaisquer espaços, nem aspas, no <VALOR_TEXTO>) +Onde o <NOME_OPÇÃO> tanto poderá ser + + + + + data    (URI do arquivo de dados) + source    (URI do arquivo de código) + output    (IDSistema do arquivo de saída) + docspath    (Local a usar quando procurar por documentação) + catalognames    (Os nomes dos catálogos a usar quando a opção 'catalogs' estiver ativa. O valor será perdido se for definido antes de configurar a opção 'catalogs') + encoding    (Qual a codificação a usar para o 'standard output') + searchresultspath    Qual o local a usar ao guardar os resultados da pesquisa. Se não estiver definido, então o 'xsldbg' irá usar o mesmo local que o da folha de estilo + + + + + +
+ + +Shell +Executar um comando de 'shell' +Uso do 'shell' + + +shell <TEXTO>    (o <TEXTO> é o texto a passar ao sistema operacional para ser executado) + + +
+ + +Showbreak +Para mostrar uma lista dos pontos de parada dos modelos. +Nome de atalho: showSe existir um modo e um ponto de parada no modelo, então este será adicionado ao fim do nome do modelo para o ponto de parada. Um exemplo do resultado será: +Ponto de parada 3 ativo para o modelo :"*" no arquivo teste1.xsl : linha 105 +Ponto de parada 2 ativo para o modelo :"* modoTeste" no arquivo teste1.xsl : linha 109 +Ponto de parada 1 ativo para o modelo :"* http://www.w3.org/1999/XSL/Transform:modoTeste" no arquivo teste1.xsl : linha 113 + +Um total de 3 pontos de parada presentes + +Uso do 'showbreak' + + +showbreak + + +
+ + +Showparam +Imprime os parâmetros da 'libxslt' presentes +Uso do 'showparam' + + +showparam + + +
+ + +Showwatch +Mostra a expressão atual que está sendo vigiada +Nome de atalho: watches +Uso do 'showwatch' + + +showwatch    (Mostra as vigias atuais e os seus valores) +showwatch 1    (Ativa a impressão automática das expressões vigiadas. Isto é usado por padrão.) +showwatch 0    (Desativa a impressão automática das expressões vigiadas.) + + +
+ + +Source +Muda para a visualização do nó atual na folha de estilo ou muda a folha de estilo usada +Uso do 'source' + + +source    (Muda para o nó atual da folha de estilo.) +source <CÓDIGO>    (Muda para um novo arquivo de código. Um "~" inicial será substituído pelo valor da variável de ambiente $HOME. Terá que usar o comando "run" para executá-lo) + + +
+ + +Step +Avança até à próxima instrução da folha de estilo. +Nome de atalho: s +Uso do 'step' + + +step + + +
+ + +Stepdown +Avança, descendo para um novo nível da "pilha de chamadas". +Nome de atalho: down +Uso do 'stepdown' + + +stepdown     (desce um nível na pilha de chamadas) +stepdown <NUMERO_DE_QUADROS>    (desce o número de níveis indicado na pilha de chamadas) + + +
+ + +Stepup +Volta para um nível superior na "pilha de chamadas". +Nome de atalho: upEste não é um comando correto, logo o 'xsldbg' irá parar assim que possa. +Uso do 'stepup' + + +stepup     (sobe um nível da pilha) +stepup <NUMERO_DE_QUADROS>     (sobe o número indicado de níveis da pilha de chamadas) + + +
+ + +Stylesheets +Imprime uma lista com as folhas de estilo carregadas +Nome de atalho: style +Uso do 'stylesheets' + + +stylesheets + + +
+ + + +System +Imprime o valor que um arquivo do sistema mapeia no catálogo atual +Nome de atalho : sys +Uso do 'system' + + +system "<IDSistema>" + + +
+ + +Templates +Imprime uma lista com os modelos disponíveis. Procura por um modelo +Nome de atalho: t +Uso do 'templates' + + +templates +templates <MODELO>    (Imprime os detalhes do modelo com o nome <MODELO> se existir) + + +
+ + +Trace +Faz um registro da execução da folha de estilo, apresentando o arquivo e os números de linha dos passos intermediários +Uso do 'trace' + + +trace + + +
+ + +Tty +Abre um terminal. Altera o nível de redirecionamento do TTY. +Uso do 'tty' + + +tty <LOCAL_DISPOSITIVO>    (em que o <LOCAL_DISPOSITIVO> é um terminal válido no sistema operacional. Tenta simplesmente acessar o terminal +tty <NIVEL_TTY>    (Altera o nível de redirecionamento do TTY, onde o <NIVEL_TTY> é um nível válido de entrada/saída a usar) + Onde o 'nível' é + 0 = entrada/saída padrão + 1 = Saída para o terminal dos resultados da transformação, do registro e do percurso     (O estado padrão quando o dispositivo de TTY tiver sido aberto. Não está ainda completamente implementado.) + 2 = Redirecionamento completa para o terminal    (Ainda não implementado.) + Todos os outros valores inteiros correspondem ao nível 0 + + + + + + +
+ + +Validate +Valida o arquivo de saída gerado pela folha de estilo (desativado) +Uso do 'validate' + + +validate + + +
+ + +Walk +Percorre o código, usando um intervalo de velocidade +Uso do 'walk' + + +walk <VELOCIDADE>    (Use o Ctrl-c para parar a execução, a <VELOCIDADE> é um valor entre 0 e 9, em que o 0 significa parado, o 1 é muito rápido e o 9 é muito lento) + + +
+ + +Where +Imprime um registro das chamadas de modelos (pilha de chamadas) e imprime a pasta de trabalho. +Nome de atalho: w +Uso do 'where' + + +where + + +
+ + +Write +A ser terminada +Uso do 'write' + + +write + + +
+ + + + + + + diff --git a/doc/pt_BR/xsldbg/credits.docbook b/doc/pt_BR/xsldbg/credits.docbook new file mode 100644 index 0000000..6402010 --- /dev/null +++ b/doc/pt_BR/xsldbg/credits.docbook @@ -0,0 +1,13 @@ + + +Créditos e Licença + +&xsldbg; +Direitos autorais do programa 2004 Keith Isdale k_isdale tpg com au CREDIT_FOR_TRANSLATORS &underFDL; &underGPL; + + +Agradecimentos a +Os criadores da 'libxml' e da 'libxsl'. +Johannes Sixt pela ajuda ao adicionar o suporte do 'xsldbg' ao KDbg + + diff --git a/doc/pt_BR/xsldbg/index.docbook b/doc/pt_BR/xsldbg/index.docbook new file mode 100644 index 0000000..3b946d7 --- /dev/null +++ b/doc/pt_BR/xsldbg/index.docbook @@ -0,0 +1,96 @@ + + + xsldbg"> + + + + + + + + +]> + + + + + + + + + + + +O Manual do &xsldbg; + + +Keith Isdale
k_isdale@tpg.com.au
+ + + + +MarcusGama
marcus_gama@uol.com.br
Tradução + +2002 +2003 +Keith Isdale + + +&FDLNotice; +2004-09-26 +1.01.00 + + + +O 'xsldbg' é uma ferramenta que procura ajudar a compreender as folhas de estilo. O que o torna diferente em relação aos outros depuradores de folhas de estilo é a capacidade de procurar por itens de interesse e de rastrear a execução da folha de estilo. + + + +KDE +tdeutils +xsldbg +xsl +xml + + + + +&introduction-chapter; +&usage-chapter; +&commands-chapter; +&credits-chapter; + + + +Instalação + + +Como obter o &xsldbg; + +Veja a componentes do 'kxsldbg' do módulo 'tdewebdev' no repositório de CVS mais próximo de você. +&install.intro.documentation; + + +Requisitos + +Para poder usar com sucesso o &xsldbg;, você precisa da 'libxslt', 'libexslt' e 'libxml' do &kde; instaladas, o que acontece numa instalação típica do KDE. + + + +Compilação e Instalação +O 'xsldbg' é normalmente compilado como parte do componente 'kxsldbg', no módulo 'tdewebdev' + + + +Configuração + +O &xsldbg; é configurado através dos argumentos passados na linha de comando e do seu comando setoption + + + + + +&documentation.index; + diff --git a/doc/pt_BR/xsldbg/introduction.docbook b/doc/pt_BR/xsldbg/introduction.docbook new file mode 100644 index 0000000..1cf7fbf --- /dev/null +++ b/doc/pt_BR/xsldbg/introduction.docbook @@ -0,0 +1,16 @@ + + +Introdução + +O &xsldbg; é uma ferramenta baseada em texto para depurar 'stylesheets' ou folhas de estilo (na linguagem eXtensible Stylesheet Language) e possui comandos semelhantes ao depurador 'gdb' do Unix/Linux. Ele tem três modos importantes de execução das folhas de estilo. + + + + Executar toda a folha de estilo + Saltar para a próxima instrução de XSL + Continuar até ao próximo ponto de parada ou reiniciar a folha de estilo + + + + + diff --git a/doc/pt_BR/xsldbg/usage.docbook b/doc/pt_BR/xsldbg/usage.docbook new file mode 100644 index 0000000..41bf4c5 --- /dev/null +++ b/doc/pt_BR/xsldbg/usage.docbook @@ -0,0 +1,62 @@ + + +Usando o &xsldbg; + +Argumentos do comando 'xsldbg' +Nos sistemas que possuam a biblioteca 'readline' disponível, você poderá usar as teclas para recuar/avançar para navegar no histórico de comandos inseridos. Em todos os sistemas, o último comando inserido poderá ser repetido pressionando a tecla <ENTER>. +Se o seu sistema operacional suportar, os nomes dos arquivos serão expandidos. +Vários dos comandos recebem mais de um argumento. Podem ser usadas aspas simples para que as expressões complexas sejam tratadas como apenas um argumento, ⪚ o 'break "* | @"' iria permitir usar um ponto de parada no modelo com o nome "* | @" + + +Legenda de termos +A tabela a seguir descreve os termos usados no guia de comandos subsequente + + + NOME_MODELO : Um nome de modelo válido só contém os caracteres ASCII de 0x00 até 0x7F. Poderá ser um nome qualificado completo como por exemplo "xsl:nomeModelo". + ARQUIVO : Um nome de arquivo válido e local ao sistema do usuário. Poderá ter um prefixo "~" nas plataformas *nix e CYGWIN ou variáveis de ambiente no RISC OS + URI : Um Uniform Resource Identifier, tal como está definido no RFC 2396 + NOME_MODO O modo do modelo, que poderá ser um nome completo qualificado, por exemplo "xsl:nomeModo". + QNAME : Um nome qualificado e completo, por exemplo "xsl:parteLocal" + NUM_LINHA : Um número de linha válido no <ARQUIVO> associado + NUMERO_DE_QUADROS : Um número de quadros da linha para o qual mudar de posição + ID_PONTO_PARADA : Um número de ponto de parada válido + ID_VIGIA : Um número de expressão de vigia válido, tal como é indicado no comando 'showwatch' + VELOCIDADE: a velocidade com a qual percorrer o código, entre 0 e 9 +     (Comentário): um comentário sobre o significado ou utilização do comando + { opç1 | opç2 | opç3 .. etc} : Selecionar uma das opções + XPATH : uma seleção de nós via XPath + ID_PARAM : um número de parâmetro válido, tal como é indicado pelo comando 'showparam' + LOCALIZAÇÃO : Um local para o qual mudar a pasta de trabalho. Em alguns sistemas operacionals, um prefixo "~" será substituído pelo seu local de trabalho + TEXTO : Algum texto livre     (sem restrições) + COMANDO : Um comando válido para o 'xsldbg' + QNAME : Um nome de parâmetro/variável válido + CÓDIGO : A folha de estilo que está sendo/será executada. Veja o <ARQUIVO> e o <URI> + DADOS : Os dados em XML (o documento) que está sendo/será processado pela folha de estilo. Veja o <ARQUIVO> e o <URI> + LOCAL_DISPOSITIVO : É um terminal válido no sistema operacional + NIVEL_TTY : É um nível válido de entrada/saída a usar + + + + +Apresentação dos comandos disponíveis + + +Relacionados com a ajuda :help +Relacionados com a execução : {bye|exit| quit}, step, stepup, stepdown, next, continue, run, trace, setoption, options +Relacionados com os parâmetros da Libxslt : addparam, delparam, showparam, output, setoption, options +Relacionados com os modelos : templates, where, frame +Relacionados com os pontos de parada : break, showbreak, delete, enable +Visualização de expressões (XPath) : cat +Visualização de nós : ls, dir, du, cat, pwd +Visualização de variáveis : globals, locals, cat, addwatch +Definição de variáveis: set +Seleção de nós : source, data, cd +Procura :search +Relacionados com o sistema operacional :chdir, shell, tty +Relacionados com arquivos : output, entities, system, public +Comandos de arquivos desativados: validate, load, save, write, free + + + + + diff --git a/doc/ru/kxsldbg/callstack.docbook b/doc/ru/kxsldbg/callstack.docbook new file mode 100644 index 0000000..7e8c919 --- /dev/null +++ b/doc/ru/kxsldbg/callstack.docbook @@ -0,0 +1,28 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +НиколайШафоростов
shafff@ukr.net
перевод на русский + + + +Работа со стеком вызовов + +Вызов, имеющий раннее время будет иметь меньший номер xsl:param. См. пример далее. + + +Окно стека вызовов + + + + +Окно стека вызовов + + + +Щелчок на вызове приведёт к переходу в файл, из которого был произведён вызов. + + diff --git a/doc/ru/kxsldbg/credits.docbook b/doc/ru/kxsldbg/credits.docbook new file mode 100644 index 0000000..ac63b97 --- /dev/null +++ b/doc/ru/kxsldbg/credits.docbook @@ -0,0 +1,29 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +НиколайШафоростов
shafff@voliacable.com
перевод на русский + + +Лицензии и благодарности + +&kxsldbg; © 2004 Keith Isdale +Документация © 2004 Keith Isdale + + + +Выражаем свою признательность: + +Авторам libxml и libxslt. + + +Роберту Джеколину за бета-тестирование ранних версий &kxsldbg; + + +Игорю Златковичу за портирование в WIN32 программ libxml/xslt и &xsldbg;. + + +&underFDL; &underGPL; diff --git a/doc/ru/kxsldbg/entities.docbook b/doc/ru/kxsldbg/entities.docbook new file mode 100644 index 0000000..6c12374 --- /dev/null +++ b/doc/ru/kxsldbg/entities.docbook @@ -0,0 +1,28 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +НиколайШафоростов
shafff@ukr.net
перевод на русский + + +Работа с файлами данных &XML; ("элементами") + +Окно монитора можно вызвать через меню Сервис Отобразить мониторы . Перейдите на вкладку Элементы. + +Все внешние элементы &XML; включаются через файл DATA. в примере запущен &kxsldbg; с testdoc.xsl для testdoc.xml (их можно найти в <KDE PREFIX>/share/apps/kxsldbg). + + +Окно элементов + + + + +Окно элементов + + + +Щелчок на элементе приведёт к переходу в файл, имя которого указано. + diff --git a/doc/ru/kxsldbg/glossary.docbook b/doc/ru/kxsldbg/glossary.docbook new file mode 100644 index 0000000..5d52a7b --- /dev/null +++ b/doc/ru/kxsldbg/glossary.docbook @@ -0,0 +1,35 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +НиколайШафоростов
shafff@voliacable.com
перевод на русский + + + + +Ключевые слова + +&xsldbg; + +См. . + + + + +XPath + +Выражение, определяющее требуемые данные. Для подробностей см. сайт W3C. + + + + +QName + +Полностью выраженное имя. Например, xsl:myvariable. Для подробностей см. сайт W3C. + + + + diff --git a/doc/ru/kxsldbg/kxsldbg_configure.docbook b/doc/ru/kxsldbg/kxsldbg_configure.docbook new file mode 100644 index 0000000..bf3427d --- /dev/null +++ b/doc/ru/kxsldbg/kxsldbg_configure.docbook @@ -0,0 +1,67 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +НиколайШафоростов
shafff@voliacable.com
перевод на русский + + + +Настройка сеанса &kxsldbg; + +Выберите пункт Отладка Настроить . + + +Диалог настроек + + + + +Диалог настроек +Диалог настроек + + + + +Начало + +Для работы с таблицами стилей укажите: +Исходник &XSL; +Данные &XML; +Выходной файл + + + +Для этого используйте кнопку .... Поля Источник &XSL; и Данные &XML; должны содержать адрес, начинающийся с http://, ftp:// или file://. Выходной файл должно содержать путь к локальному файлу, в который можно открыть для записи. +Для следования примеру, выберите следующие файлы в каталоге с примерами (<KDE PREFIX>/share/apps/kxsldbg) +Исходный &XSL;: testdoc.xsl +Данные &XML;: testdoc.xml +Выходной файл: /tmp/xsldbg_output.txt + + + + + +Опции + +У каждой опции есть подсказка, кратко объясняющая её суть. + + + +Параметры + +Здесь, через Параметры LibXSLT, вы можете указать значения параметров для таблиц стилей. + +Например можно ввести в поле Имя параметра myparam, а в Значение параметра - 'Hello World!' и нажать кнопку Добавить. Чтобы изменить значение добавленного параметра, перейдите по списку к нему, измените содержимое поля Значение параметра и нажмите Применить. + + + +Применить изменения + +Чтобы изменения, которые вы внесли, вступили в силу, нажмите кнопку Применить. + +Для отмены изменений нажмите Отмена или просто закройте окно. + + diff --git a/doc/ru/kxsldbg/kxsldbg_inspector.docbook b/doc/ru/kxsldbg/kxsldbg_inspector.docbook new file mode 100644 index 0000000..093c734 --- /dev/null +++ b/doc/ru/kxsldbg/kxsldbg_inspector.docbook @@ -0,0 +1,71 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +НиколайШафоростов
shafff@voliacable.com
перевод на русский + + +Установка и изменение точек останова + +С точками останова можно работать через главное окно. + +После создания таблицы стилей, выберите Сервис Отобразить мониторы и перейдите на вкладку точек останова. См. пример ниже. + + +Установка точек останова + + + + +Установка точек останова + + + + +Добавление точки останова + +Вы можете установить точку останова указанием одного из следующих: + +имени файла и номера строки + +имени шаблона + +имени шаблона и режима + +имени режима + + + + +Затем нажмите кнопку Добавить. + + + +Аргументы + +Именем файла может быть абсолютный путь к нему или просто его краткое имя (например xsldoc.xsl). + +В имени шаблона или режима может быть нелокальная часть. Например xsl:mytemplate соответствует mytemplate + + + +Удаление точки останова + +Щёлкните левой кнопкой мыши на точке останова, затем нажмите кнопку Удалить. + + + +Удаление всех точек останова + +Нажмите кнопку Удалить всё. + + + +Включение/выключение точки останова + +Щёлкните левой кнопкой мыши на точке останова, затем нажмите кнопку Включить. + + diff --git a/doc/ru/kxsldbg/kxsldbg_mainwindow.docbook b/doc/ru/kxsldbg/kxsldbg_mainwindow.docbook new file mode 100644 index 0000000..d3229e1 --- /dev/null +++ b/doc/ru/kxsldbg/kxsldbg_mainwindow.docbook @@ -0,0 +1,443 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +НиколайШафоростов
shafff@voliacable.com
перевод на русский + + +Главное окно + + +Главное окно + + + + +Текстовое отображение отлаживаемого файла. +Текстовое отображение отлаживаемого файла. + + + + +Работа с главным окном + +Статус данных точек останова передаётся через текст и цвет его фона. См. НастройкаНастроить редактор, вкладка Цвета. + + +Вы можете установить/выключить/удалить точку останова в меню Отладка или на панели инструментов. + +Вы можете перемещать курсор по тексту, используя + + +Стрелки. +Клавиши Page (Page Up и Page Down) + + + + + + +Работа с выводом &kxsldbg; + +Большая часть вывода &kxsldbg; собрана и представлена или в диалоге мониторов, или в окне вывод &kxsldbg;. Исключения: + + +Сообщение об ошибке. + + +Результат проверки выражения + + +Вывод поиска отправляется в файл, указанный в окне вывода &kxsldbg; + + + + + + + + diff --git a/doc/ru/kxsldbg/kxsldbg_tools.docbook b/doc/ru/kxsldbg/kxsldbg_tools.docbook new file mode 100644 index 0000000..5f434bd --- /dev/null +++ b/doc/ru/kxsldbg/kxsldbg_tools.docbook @@ -0,0 +1,77 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +НиколайШафоростов
shafff@voliacable.com
перевод на русский + + + +Прочие инструменты + +Все инструменты доступны через меню Сервис, основным инструментом является монитор. + + +Монитор + +В мониторе содержатся диалоги для работы со следующими элементами: + +Точки останова +Шаблоны +Переменные +Стек вызовов +Исходные файлы &XSL; +Элементы &XML; + + + + + +Проходы + +После нажатия Начать проход отобразится диалог, где вы сможете установить скорость прохода + + +Окно прохода + + + + +Окно прохода + + + +Для останова прохода используйте клавишу W, или меню Начать проход. + + + +Поиск элементов &XML; + +Чтобы найти System ID в текущем каталоге &XML;, используйте меню Поиск System ID, затем введите значение для поиска диалога. + + +Окно System ID + + + + +Окно System ID + + + +Чтобы найти PUBLIC ID, используйте меню Поиск Public ID, затем введите значение для поиска диалога. + + +Окно Public ID + + + + +Окно Public ID + + + + + diff --git a/doc/ru/kxsldbg/sources.docbook b/doc/ru/kxsldbg/sources.docbook new file mode 100644 index 0000000..05f6fff --- /dev/null +++ b/doc/ru/kxsldbg/sources.docbook @@ -0,0 +1,27 @@ + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +НиколайШафоростов
shafff@ukr.net
перевод на русский + + +Работа с исходниками &XSLT; + +Окно монитора можно вызвать через меню Сервис Отобразить мониторы . Перейдите на вкладку Исходники. + +Все исходные файлы &XSLT; включаются файлом &XSLT;. + + +Окно исходников + + + + +Окно исходников + + + +Щелчок на исходнике приведёт к переходу в файл, имя которого указано. + diff --git a/doc/ru/kxsldbg/templates.docbook b/doc/ru/kxsldbg/templates.docbook new file mode 100644 index 0000000..bd8293c --- /dev/null +++ b/doc/ru/kxsldbg/templates.docbook @@ -0,0 +1,20 @@ + +Работа с шаблонами + +Окно монитора можно вызвать через меню Сервис Отобразить мониторы . Перейдите на вкладку Шаблоны. + +Здесь выводится список всех найденных шаблонов. Помните о правилах экспорта &XSLT;. Только здесь может быть несколько шаблонов с одним именем и подробностями режима. + + +Окно шаблонов + + + + +Окно шаблонов + + + +Щелчок на шаблоне приведёт к переходу в файл, имя и строка которого указаны. + + diff --git a/doc/ru/kxsldbg/variables.docbook b/doc/ru/kxsldbg/variables.docbook new file mode 100644 index 0000000..4fb2f5e --- /dev/null +++ b/doc/ru/kxsldbg/variables.docbook @@ -0,0 +1,44 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +НиколайШафоростов
shafff@ukr.net
перевод на русский + + + +Работа с переменными + +Окно монитора можно вызвать через меню Сервис Отобразить мониторы . + +Локальные и глобальные переменные отображаются в отдельных вкладках. В следующем XSLT-коде декларируются глобальная и локальная переменные + +<xsl:variable name="globalvariable" select="'foo'"/> + + <xsl:template match="/"/> + <xsl:param name="localvariable" select="'bar'"/> + </xsl:template match="/"/> + + +По щелчку на переменной из списка внизу диалога отобразится краткая информация о ней. Если в переменной есть выражение select, например + +<xsl:variable name="changeable" select="'oldValue'" /> + + +то новый XPath может быть выбран вводом нового значения выражения переменной нажатием кнопки Установить выражение. + + +Вкладка "Переменные" + + + + +Вкладка переменных +Вкладка переменных + + + +Щелчок на переменной приведёт к переходу в файл, имя и строка которого указаны. + diff --git a/doc/ru/xsldbg/commands.docbook b/doc/ru/xsldbg/commands.docbook new file mode 100644 index 0000000..6b1f28f --- /dev/null +++ b/doc/ru/xsldbg/commands.docbook @@ -0,0 +1,758 @@ + + +Описание команд + +Addparam +Добавить параметр для libxslt; эквивалентно параметру --param <QNAME>:<XPATH> в командной строке. + +Синтаксис команды addparam + +addparam <QNAME> <XPATH>    (В строке <XPATH> не должно быть пробелов или двойных кавычек.) +addparam <QNAME> "<XPATH>"    (В строке <XPATH> не должно быть двойных кавычек) + + +
+ + +Addwatch +Добавить выражение для наблюдения. Для просмотра значений наблюдаемых выражений см. showwatch +Краткая форма: watch +Синтаксис команды addwatch + +addwatch <XPATH> + + +
+ + +Base +Вывести XML-базу заданного узла +Синтаксис команды base + + +base + + +
+ + +Break +Установить точку останова в заданном шаблоне, в текущем узле, в заданном месте таблицы стилей или загруженного в xsldbg xml-файла. Новое поведение для xsldbg версии 3.1.4: в режиме совместимости с gdb Для заданной строки заданного файла могут быть установлены недействующие точки останова, которыевпоследствии будут переведены в активное состояние +Краткая форма: bxsldbg попытается самостоятельно определить полный URL для имени файла без заданного пути. имени файла, расположенного в одном каталоге с загруженной в данный момент таблицей стилей_"top"_ имени файла, относительно текущего рабочего каталога xsldbg Другими словами, если вы загрузили файл с таблицами стилей из ../en/xsldoc.xsl , вы можете сделать следующее: break -l xsldoc.xsl 26 Эта команда сработает для шаблона и/или режима с полным или частичным QNAME.Например, "template" сработает для любого QNAME, содержащегося в локальной части "template" Все пространства имён в заданном QNAME будут определены в соответствии с пространствами имён, указанными в файле XSL SOURCE. Например, "xsl:test1" будет определён как "http://www.w3.org/199/XSL/Transform:test1" Возможно, что заданная точка останова должна быть связана с соответствующим URL и номером строки. Это делается автоматически сразу после того, как xsldbg просмотрел первый шаблон Повторное связывание точек останова со своими URL происходит в начале каждого запуска исполнения. При включённом режиме gdb используется автоматическая валидация точек останова, такое поведение установлено вxsldbg по умолчанию +Синтаксис команды break + + +break -l <FILENAME> <LINENO>    (Установить точку останова в заданной строке заданного файла) +break -l <URI> <LINENO>    (Установить точку останова в заданной строке заданного URI) +break <TEMPLATE_NAME>    (Точка останова в шаблоне, имя которого задаётся полностью или регулярным выражением.) +break <TEMPLATE_NAME> <MODE_NAME>    (Установить точку останова в шаблоне с заданными именем и режимом.)> +break "" <MODE_NAME>    (Установить точку останова в любом шаблоне с заданным режимом) +break *    (Установить точку останова в любом найденном шаблоне.) +break \*    (Установить точку останова в шаблоне "*". Прочие имена, включающие символ '*', отдельно обрабатываться не будут.) +break     (Точка останова в текущем узле. Да, это распространяется и на узлы с xml-данными!) + + +
+ + +Bye +Завершить исполнение таблицы стилей при ближайшей возможности. +Синтаксис команды bye + + +bye + + +
+ + +Cat +Вывести результат выражения xPath, относящегося к текущему узлу +Синтаксис команды cat + + +Синтаксис: cat <XPATH>    (Вывести переменную или параметр) +Синтаксис: cat $<QNAME> + + +
+ + +Cd +Изменить путь, указанный в xpath. +Синтаксис команды cd + + +<< = preceding-sibling::node() +>> = following-sibling::node() +<- = ancestor::node() +-> = decendant::node() + +
+ + +Chdir +Сменить рабочий каталог +Синтаксис команды chdir + + +chdir <PATH>    (Относительный или абсолютный путь в операционной системе) + + +
+ + +Continue +Продолжить исполнение таблицы стилей с остановками на всех обнаруженных точках останова +Краткая форма: c +Синтаксис команды continue + + +continue + + +
+ + +Data +Переключиться в режим отображения текущего узла xml-данных. Или переключиться от одного xml-файла к другому. +Синтаксис команды data + + +data    (Показать текущий узел в документе.) +data <DATA>    (Использовать новый файл с xml-данными. Символ "~" в начале имени файла будет замещён значением переменной окружения $HOME. Для его обработки потребуется команда "run") + + +
+ + +Delete +Удалить точку останова в шаблоне +Краткая форма: d +Синтаксис команды delete + + +delete    (Удалить точку останова в текущем узле) +delete <BREAKPOINT_ID>    (Удалить точку останова с заданным номером) +delete -l <FILENAME> <LINENO>    (Удалить точку останова в заданной строке заданного файла) +delete -l <URI> <LINENO>    (Удалить точку останова в заданной строке заданного URI) +delete <TEMMPLATENAME>    (Удалить точку останова в шаблоне с заданным именем.) +delete *    (Удалить все точки останова.) + + +
+ + +Delparam +Удалить libxslt-параметр +Синтаксис команды delparam + + +delparam    (Удалить все заданные параметры) +delparam <PARAM_ID> + + +
+ + +Delwatch +Удалить наблюдаемое выражение или удалить все наблюдаемые выражения, присутствующие в выводе команды "showwatch." +Синтаксис команды delwatch + + +delwatch <WATCHID>    (Удалить наблюдаемое выражение с заданным ID) +delwatch *    (Удалить все наблюдаемые выражения) + + +
+ + +Dir +Вывести список узлов в формате, схожем с выводом shell-команды dir. + +Синтаксис команды dir + + +dir + + +
+ + +Disable +Отключить точку останова +Синтаксис команды disable + + +disable    (Отключить точку останова в текущем узле) +disable <BREAKPOINT_ID>    (Отключить точку останова с заданным номером +disable -l <FILENAME> <LINENO>    (Отключить точку останова в заданной строке заданного файла) +disable -l <URI> <LINENO>    (Отключить точку останова в заданной строке заданного URI) + + +
+ + +Du +Вывести список дочерних узлов в древовидной форме +Синтаксис команды du + + +du + + +
+ + +Dump +Вывести самую подробную информацию о заданном узле +Синтаксис команды dump + + +dump + + +
+ + +Enable +Включить или отключить точку останова (Переключение статуса активно/неактивно/) +Краткая форма: e +Синтаксис команды enable + + +enable    (Включить/отключить точку останова в текущем узле) +enable <BREAKPOINT_ID>    (Включить/отключить точку останова с заданным номером) +enable -l <FILENAME> <LINENO>    (Включить/отключить точку останова в заданной строке заданного файла) +enable -l <URI> <LINENO>    (Включить/отключить точку останова в заданной строке заданного URI) + + +
+ + +Entities +Вывести список внешних Общих Разобранных Сущностей (General Parsed entities), используемых в файле с данными (документ) +Краткая форма: ent +Синтаксис команды entities + + +entities + + +
+ + +Exit +Завершить исполнение таблицы стилей при ближайшей возможности. +Синтаксис команды exit + + +exit + + +
+ + +Frame +Вывести кадр стека с заданной глубиной +Краткая форма: f +Синтаксис команды frame + + +frame <FRAME_DEPTH>    (Здесь Глубина (Depth) - число от 0 до текущей глубины стека вызовов) + + +
+ + +Free +Освободить ресурсы: таблицу стилей и данные (Команда отключена, см. run) +Синтаксис команды free + + +free + + +
+ + +Globals +Вывести список глобальных переменных или параметров для таблицы стилей. Вывести значение глобальной переменной +Синтаксис команды globals + + +globals    (Вывести список всех глобально доступных переменных) +globals -f    (Вывести список всех глобально доступных переменных и их значений) +globals <QNAME>    (Вывести значение указанной переменной) + + +
+ + +Help +Вывести справку о команде или общую справку о продукте +Краткая форма: h +Синтаксис команды help + + +help     (Вывести общую справку о продукте) +help <COMMAND>     (Вывести справку о команде) + + +
+ + +Load +Загрузить ключи xsldbg и пользовательские настройки с диска +Синтаксис команды load + + +load + + +
+ + +Locals +Вывести список локальных переменных или параметров для таблицы стилей. Вывести значение локальной переменной +Синтаксис команды locals + + +locals    (Вывести список всех локально доступных переменных) +locals -f    (Вывести список всех локально доступных переменных и их значения) +locals <QNAME>    (Вывести значение указанной переменной) + + +
+ + +Ls +Вывести список узлов в кратком формате +Синтаксис команды ls + + +ls + + +
+ + +Next +Перейти к следующей инструкции без "захода" в xsl:call-template или xsl:apply-templates. Действие данной команды эквивалентно действию комбинации команд "step" и "up" +Краткая форма: n +Синтаксис команды next + + +next    (перейти к следующей инструкции того же уровня) + + +
+ + +Options +Вывести значения ключей xsldbg +Синтаксис команды options + + +options + + +
+ + +Output +Указать доступный для записи файл в локальной файловой системе, в него будут сохранены результаты +Краткая форма: o +Синтаксис команды output + + +output <FILENAME>    (Имя доступного для записи файла из локальной файловой системы. На *nix и CYGWIN-платформах может иметь префикс "~". В RISC OS это могут бытьпеременные окружения) +output <URI>    (В <URI> может быть использован только протокол "file://". Впоследствии URI будет приведён к имени файла, допустимому для операционной системы) +output -    ( Отправить на стандартный вывод. Может использоваться только когда xsldbg запущен в режиме командной строки) + + +
+ + +Public +Вывести значение, на которое Public ID отображается через текущий каталог +Краткая форма: pub +Синтаксис команды public + + +public "<PublicID>" + + +
+ + +Pwd +Вывести путь текущего рабочего каталога +Синтаксис команды pwd + + +pwd + + +
+ + +Quit +Завершить исполнение таблицы стилей при ближайшей возможности. +Краткая форма: q +Синтаксис команды quit + + +quit + + +
+ + +Run +Перезапустить исполнение таблицы стилей. +Краткая форма: r +Синтаксис команды run + + +run + + +
+ + +Save +Сохранить ключи xsldbg и пользовательские настройки на диск +Синтаксис команды save + + +save + + +
+ + +Search +Поиск в базе данных, собранных во всех загруженных таблицах стилей +Все результаты поиска сохраняются в каталоге, указанном ключом"searchresultspath", или в том же каталоге, что и исходная таблица стилей, если данный ключ не был выставлен.Как правило, для трансформаций в файле searchresults.xml используется search.xsl, но если выставлен ключ "prefrehtml", то будет использоваться searchhtml.xsl При исполнении команды search создаётся xml-файл (searchresults.xml). Впоследствии вы можете обработать этот файл вашей собственной таблицей стилей, и получить вывод в нужном вам формате. Если ключ"preferhtml" не выставлен, то результаты поиска будут выведены в searchresult.txt При большом объёме обрабатываемых данных, выполнение этой команды может занять некоторое время. +Синтаксис команды search + + +search <XPATH>    (Посмотреть, какие xpath могут быть использованы в search.dtd. Значение <XPATH> по умолчанию равно '//search/*' ) +search -sort <XPATH>    (С этим ключом search.xsl будет сортировать результаты перед их выводом) + + +
+ + +Set +Установить значение переменной +Синтаксис команды set + + +set <VARIABLE_NAME> <XPATH> + + +
+ + +Setoption +Установить ключ исполнения таблицы стилей +Для того, чтобы изменения вступили в силу, нужно воспользоваться командой run +Синтаксис команды setoption + + +setoption <OPTION_NAME> <INTEGER_VALUE> +где <OPTION_NAME> может быть одним из следующих: + + + + + debug    (Если значение <INTEGER_VALUE> истинно, вместо обычного выводавыводится дерева результатов) + catalogs    (Если значение <INTEGER_VALUE> истинно, используются каталоги из $SGML_CATALOG_FILES или SGML$CatalogFiles для risc-операционных систем) + html    (Если значение <INTEGER_VALUE> истинно, документ на входе будет HTML-файлом) + docbook    (Если значение <INTEGER_VALUE> истинно и в libxml всё ещё есть поддержка docbook, документ на входе будет иметь формат SGML docbook) + xinclude    (Если значение <INTEGER_VALUE> истинно, документ на входе будет обработан средствами XInclude) + preferhtml    (Если значение <INTEGER_VALUE> истинно, результаты поиска будут по умолчанию выводиться в html-файл.: См. справку к команде search) + autoencode    (Если значение <INTEGER_VALUE> истинно, будет предпринята попытка использовать кодировку из таблицы стилей) + utf8input    (Если значение <INTEGER_VALUE> истинно, весь ввод от пользователя идёт в кодировке UTF-8. Используется, как правило, когда xsldbg запущен как нить [thread] какого-либо процесса)) +      + gdb    (Запуск в режиме совместимости с gdb) + Для значения 1 это: + Вывод много большего количества сообщений. Частота появления сообщения "Breapoint at ..." ("Точка останова в...") возрастает + Не больше GDB_LINES_TO_PRINT строк будет выведено при разборе выражений, после этого будет выведены символы "...". Это значение можно изменить в options.h, по умолчанию оно равно трём строкам текста + Командой "locals" выводятся список как локальных, так и глобальных переменных + При выводе выражений командами cat/print, разбираемое значение будет снабжаться префиксом "= " < EXPRESSION > + + + + + + Для значения 2 это: Вывод сообщений, затребованных KDbg, вместе с сообщениями, описанными выше (когда значение равно 1) + + + + + + + + + nonet    (Если значение <INTEGER_VALUE> истинно, DTD-данные или сущности не будут доставляться из сети) + novalid    (Если значение <INTEGER_VALUE> истинно, пропустить фазу загрузки DTD) + repeat    (Если значение <INTEGER_VALUE> истинно, выполнить трансформацию 20 раз) + profile    (Если значение <INTEGER_VALUE> истинно, вывести информацию о профиле) + timing    (Если значение <INTEGER_VALUE> истинно, отобразить используемое время) + noout    (Если значение <INTEGER_VALUE> истинно, не выводить результат) + + + + +Где значение истинно, если НЕ РАВНО нулю +Где значение ложно, если РАВНО нулю +stdout    Выводить все сообщения об ошибках на стандартный вывод. Обычно все сообщения об ошибках выводятся на stderr. +setoption <OPTION_NAME> "<STRING_VALUE>"    (В строке <STRING_VALUE> не должно быть двойных кавычек) +setoption <OPTION_NAME> <STRING_VALUE>    (В строке <STRING_VALUE> не должно быть пробелов или двойных кавычек) +где <OPTION_NAME> может быть одним из следующих: + + + + + data    (URI файла с данными) + source    (URI исходного файла) + output    (Вывести SystemID файла) + docspath    (Путь к каталогу, в котором производится поиск документации) + catalognames    (Имена каталогов, которые будут использоваться при выставленном ключе catalogs. Данное значение будет утеряно, если будет задано до установки ключа catalogs) + encoding    (Какую кодировку использовать для стандартного вывода) + searchresultspath    Путь к каталогу, который будет использоваться для сохранения результатов поиска. Если такой путь не задан, то xsldbg будет использовать путь к каталогу с таблицами стилей + + + + + +
+ + +Shell +Выполнить shell-команду +Синтаксис команды shell + + +shell <TEXT>    (<TEXT> будет передан операционной системе для исполнения) + + +
+ + +Showbreak +Вывести список точек останова в шаблоне +Краткая форма: showЕсли для шаблона задан режим, то имя режима будет добавлено в конец имени шаблона при установке точки останова. Вывод команды может быть, например, таким: +Точка останова 3 включена для шаблона :"*" в файле test1.xsl : строка 105 +Точка останова 2 включена для шаблона :"* testMode" в файле test1.xsl : строка 109 +Точка останова 1 включена для шаблона:"* http://www.w3.org/1999/XSL/Transform:testMode" в файле test1.xsl : строка 113 + +Всего 3 точки останова + +Синтаксис команды showbreak + + +showbreak + + +
+ + +Showparam +Вывести список существующих параметров libxslt +Синтаксис команды showparam + + +showparam + + +
+ + +Showwatch +Показать текущее наблюдаемое выражение +Краткая форма: watches +Синтаксис команды showwatch + + +showwatch    (Показать выбранные в данный момент наблюдаемые выражения и их значения) +showwatch 1    (Включить режим автоматического вывода наблюдаемых выражений. Режим включён по умолчанию.) +showwatch 0    (Выключить режим автоматического вывода наблюдаемых выражений.) + + +
+ + +Source +Переключиться в режим отображения текущего узла в таблице стилей. Или использовать другую таблицу стилей. +Синтаксис команды source + + +source    (Перейти к текущему узлу в таблице стилей.) +source <SOURCE>    (Использовать новый файл с таблицей стилей. Символ "~" в начале имени файла будет замещён значением переменной окружения $HOME. Для его обработки потребуется команда "run") + + +
+ + +Step +Перейти к следующей инструкции таблицы стилей. +Краткая форма: s +Синтаксис команды step + + +step + + +
+ + +Stepdown +Передвинуться вниз по стеку к кадрам, которые были созданы позже. +Краткая форма: down +Синтаксис команды stepdown + + +stepdown     (передвинуться вниз по стеку на один кадр) +stepdown <NUMBER_OF_FRAMES>    (передвинуться вниз по стеку на заданное количество кадров.) + + +
+ + +Stepup +Передвинуться вверх по стеку к кадрам, которые существуют дольше. +Краткая форма: upЭта команда выполняется не очень точно, xsldbg произведёт остановку при ближайшей возможности. +Синтаксис команды stepup + + +stepup     (передвинуться вверх по стеку на один кадр) +stepup <NUMBER_OF_FRAMES>     (передвинуться вверх по стеку на заданное количество кадров.) + + +
+ + +Stylesheets +Вывести список всех загруженных таблиц стилей +Краткая форма: style +Синтаксис команды stylesheets + + +stylesheets + + +
+ + + +System +Вывести значение, на которое System ID отображается через текущий каталог +Краткая форма: sys +Синтаксис команды system + + +system "<SystemID>" + + +
+ + +Templates +Вывести список всех доступных шаблонов. Произвести поиск шаблона +Краткая форма: t +Синтаксис команды templates + + +templates +templates <TEMPLATE>    (Вывести детальную информацию о шаблоне с именем <TEMPLATE>, если такой существует) + + +
+ + +Trace +Трассировка исполнения таблицы стилей с указанием файла и строк промежуточных шагов. +Синтаксис команды trace + + +trace + + +
+ + +Tty +Открыть терминал. Установить уровень перенаправления ввода/вывода. +Синтаксис команды tty + + +tty <DEVICE_PATH>    (Где <DEVICE_PATH> - существующий терминал операционной системы. Простая попытка открыть терминал +tty <TTY_LEVEL>    (Установить уровень перенаправления ввода/вывода, где <TTY_LEVEL> - допустимый уровень ввода/вывода) + Где уровень может быть равен + 0 = ввод/вывод, установленный по умолчанию + 1 = Терминал используется для вывода результатов трансформаций, трассировок и исполнения кода     (В случае, когда был открыт терминал, это значение используется по умолчанию. В данной версии реализовано не полностью.) + 2 = Полное перенаправление на терминал    (В данной версии не реализовано.) + Все прочие целочисленные значения трактуются как задание уровня 0 + + + + + + +
+ + +Validate +Проверить на правильность файл, полученный после обработки таблицы стилей (Команда отключена) +Синтаксис команды validate + + +validate + + +
+ + +Walk +Запустить исполнение кода с заданной скоростью +Синтаксис команды walk + + +walk <SPEED>    (Чтобы остановить исполнение, используйте Ctrl-c, <SPEED> - число от 0 до 9, где 0 - остановка, 1 - самая высокая скорость, 9 - самая низкая скорость) + + +
+ + +Where +Показать цепочку вызовов шаблонов (стек кадров) и рабочий каталог. +Краткая форма: w +Синтаксис команды where + + +where + + +
+ + +Write +Описание команды появится в следующих версиях +Синтаксис команды write + + +write + + +
+ + + + + + + diff --git a/doc/ru/xsldbg/credits.docbook b/doc/ru/xsldbg/credits.docbook new file mode 100644 index 0000000..34fabfd --- /dev/null +++ b/doc/ru/xsldbg/credits.docbook @@ -0,0 +1,14 @@ + + +Авторские права и лицензия + +&xsldbg; +Авторские права на программу: 2004 Keith Isdale k_isdale tpg com au + +Перевод на русский - Данил Миронов patrungel@yahoo.fr +&underFDL; &underGPL; +Благодарности +Авторам libxml и libxsl. +Йоханнесу Зиксту [Johannes Sixt] за помощь в добавлении поддержки xsldbg в KDbg + + diff --git a/doc/ru/xsldbg/index.docbook b/doc/ru/xsldbg/index.docbook new file mode 100644 index 0000000..70811b0 --- /dev/null +++ b/doc/ru/xsldbg/index.docbook @@ -0,0 +1,96 @@ + +xsldbg"> + + + + + + + + +]> + + + + + + + + + + + +Руководство пользователя &xsldbg; + + +Keith Isdale
k_isdale@tpg.com.au
+ + + +Данил Миронов
patrungel@yahoo.fr
Перевод на русский + + + + +2002 +2003 +Keith Isdale + + +&FDLNotice; +2004-09-26 +1.01.00 + + + +&xsldbg; - это утилита, призванная упростить понимание таблиц стилей. Отличительными особенностями xsldbg от других средств отладки таблиц стилей являются возможность поиска интересующих вас элементов и возможность следить за применением таблицы стилей пошагово. + + + +KDE +tdeutils +xsldbg +xsl +XML + + + + +&introduction-chapter; +&usage-chapter; +&commands-chapter; +&credits-chapter; + + + +Установка + + +Как получить &xsldbg; + +Посмотрите компонент kxsldbg модуля tdewebdev из репозитория SVN &kde;. +&install.intro.documentation; + + +Требования + +Для корректной работы &xsldbg; в вашей системе должны быть установлены &kde; libxslt, libexslt и libxml; как правило эти компоненты присутствуют в типовой конфигурации &kde;. + + + +Компиляция и установка +Как правило, &xsldbg; компилируется как часть компонента kxsldbg модуля tdewebdev + + + +Настройка + +Настройка &xsldbg; осуществляется с помощью ключей командной строки и встроенной командой setoption + + + + + +&documentation.index; + diff --git a/doc/ru/xsldbg/introduction.docbook b/doc/ru/xsldbg/introduction.docbook new file mode 100644 index 0000000..954453f --- /dev/null +++ b/doc/ru/xsldbg/introduction.docbook @@ -0,0 +1,16 @@ + + +Введение + +&xsldbg; - это среда отладки таблиц стилей (eXtensible Stylesheet Language, Расширяемый Язык Таблиц Стилей), обладающая набором команд, схожим с gdb, отладчиком для систем Unix/Linux. Предоставлены три основных режима применения xsl-таблиц: + + + + Полное исполнение всей xsl-таблицы + Пошаговое исполнение инструкций + Продолжение исполнения xsl-преобразований до следующей точки останова или до конца таблицы на каждой итерации + + + + + diff --git a/doc/ru/xsldbg/usage.docbook b/doc/ru/xsldbg/usage.docbook new file mode 100644 index 0000000..5269bab --- /dev/null +++ b/doc/ru/xsldbg/usage.docbook @@ -0,0 +1,62 @@ + + +Использование &xsldbg; + +аргументы команды xsldbg +Системы, в которых установлена библиотека readline, позволяют пользователю передвигаться по списку ранее введённых команд с помощью клавиш "вправо"/"влево". В любых системах последняя введённая команда может быть повторена простым нажатием клавиши <ENTER>. +Частичные имена файлов будут автоматически заменены на полные, если операционная система это поддерживает. +Некоторым командам можно передать несколько аргументов. Чтобы сложные выражения воспринимались как один аргумент, их заключают в кавычки, например: break "* | @" позволит пользователю увидеть точку останова в шаблоне с именем "* | @" + + +Используемые обозначения +В данной таблице приводится описание условных обозначений, используемых в настоящем справочном руководстве + + + TEMPLATE_NAME: Допустимое имя шаблона, может содержать только ASCI-символы с кодами от 0x00 до to 0x7F. Может быть полностью определённым именем, например "xsl:templateName". + FILENAME: Допустимое имя файла из локальной файловой системы пользователя. На *nix и CYGWIN-платформах может иметь префикс "~". В RISC OS это могут бытьпеременные окружения. + URI: Универсальный Идентификатор Ресурса (Uniform Resource Identifiers) в соответствии с определением в RFC 2396 + MODE_NAME: Режим шаблона, может быть полностью определённым именем, например "xsl:modeName". + QNAME : Полностью определённое имя, например "xsl:localPart" + LINENO : Допустимый номер строки в заданном <FILENAME> + NUMBER_OF_FRAMES : допустимое число кадров для перехода + BREAKPOINT_ID : Допустимый номер точки останова + WATCH_ID: Допустимый номер наблюдаемого выражения (watch expression), берётся из вывода команды showwatch + SPEED: скорость исполнения кода, принимает значения от 0 до 9 +     (Комментарий): комментарий, поясняющий значение команды или определяющий её использование + { opt1 | opt2 | opt2 .. etc} : Выбор одного из opt-ов + XPATH: xpath-выборка узлов + PARAM_ID: допустимый номер параметра, берётся из вывода команды showparam + PATH: путь к новому рабочему каталогу. В некоторых системах префикс "~" будет заменён путём к вашему домашнему каталогу + TEXT: Текст в свободной форме     (без ограничений) + COMMAND: Допустимая команда для xsdbg + QNAME: Допустимое имя переменной/параметра + SOURCE: Исполняемая/подлежащая исполнению таблица стилей. Также см. <FILENAME> и <URI> + DATA: Xml-данные (документ), которые будут обрабатываться таблицей стилей. Также см. <FILENAME> и <URI> + DEVICE_PATH: Допустимый терминал в операционной системе + TTY_LEVEL: допустимый уровень ввода/вывода + + + + +Обзор доступных команд + + +Получение справки :help +Управление исполнением: {bye|exit| quit}, step, stepup, stepdown, next, continue, run, trace, setoption, options +Управление параметрами libxslt : addparam, delparam, showparam, output, setoption, options +Управление шаблонами: templates, where, frame +Управление точками останова : break, showbreak, delete, enable +Отображение выражений(xpath): cat +Отображение узлов: ls, dir, du, cat, pwd +Отображение переменных: globals, locals, cat, addwatch +Задание переменных: set +Выбор узла: source, data, cd +Поиск: search +Команды операционной системе: chdir, shell, tty +Управление файлами: output, entities, system, public +Отключённые команды управления файлами: validate, load, save, write, free + + + + + diff --git a/doc/sv/kxsldbg/breakpoints_window.png b/doc/sv/kxsldbg/breakpoints_window.png new file mode 100644 index 0000000..1cc6380 Binary files /dev/null and b/doc/sv/kxsldbg/breakpoints_window.png differ diff --git a/doc/sv/kxsldbg/callstack.docbook b/doc/sv/kxsldbg/callstack.docbook new file mode 100644 index 0000000..2276e9d --- /dev/null +++ b/doc/sv/kxsldbg/callstack.docbook @@ -0,0 +1,28 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +StefanAsserhäll
stefan.asserhall@comhem.se
Översättare + + + +Arbeta med anropsstacken + +Alla anropsstackposter som hittas listas här. Ju äldre anropsstackposten är desto lägre nummer har posten. Se nedan för ett exempel. + + +Anropsstackfönstret + + + + +Anropsstackfönstret + + + +Genom att klicka på en anropsstackpost i listan som visas, flyttas markören i huvudfönstret till filen och radnumret som anges. + + diff --git a/doc/sv/kxsldbg/callstack_window.png b/doc/sv/kxsldbg/callstack_window.png new file mode 100644 index 0000000..05baf3b Binary files /dev/null and b/doc/sv/kxsldbg/callstack_window.png differ diff --git a/doc/sv/kxsldbg/configure_window.png b/doc/sv/kxsldbg/configure_window.png new file mode 100644 index 0000000..98bd08f Binary files /dev/null and b/doc/sv/kxsldbg/configure_window.png differ diff --git a/doc/sv/kxsldbg/credits.docbook b/doc/sv/kxsldbg/credits.docbook new file mode 100644 index 0000000..c3218a7 --- /dev/null +++ b/doc/sv/kxsldbg/credits.docbook @@ -0,0 +1,29 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +StefanAsserhäll
stefan.asserhall@comhem.se
Översättare + + +Tack till och licenser + +&kxsldbg; © 2004 Keith Isdale +Dokumentation © 2004 Keith Isdale + + + +Tack till: + +De som skrivit libxml och libxslt. + + +Robert Jacolin för återmatning om tidigare versioner av &kxsldbg;. + + +Igor Zlatkovic för att ha skapat binärfiler för WIN32 av libxml/xslt och &xsldbg;. + + +&underFDL; &underGPL; diff --git a/doc/sv/kxsldbg/entities.docbook b/doc/sv/kxsldbg/entities.docbook new file mode 100644 index 0000000..3ebd51d --- /dev/null +++ b/doc/sv/kxsldbg/entities.docbook @@ -0,0 +1,28 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +StefanAsserhäll
stefan.asserhall@comhem.se
Översättare + + +Arbeta med &XML;-datafiler (instanser) + +Om inspektörsdialogrutan inte visas, använd menyalternativet Felsök Inspektera.... För att arbeta med instanser, klicka på fliken Instanser i dialogrutan som visas. + +Alla externa &XML;-instanser som inkluderas via datafilen eller en av filerna på samma nivå listas här. I detta exemplet har &kxsldbg; körts med testdoc.xsl med testdoc.xml (som finns i katalogen <KDE-PREFIX>/share/apps/kxsldbg) så att du kan se några instanser. + + +Instansfönstret + + + + +Instansfönstret + + + +Genom att klicka på en instans i listan som visas, flyttas markören i huvudfönstret till filen och radnumret som anges. + diff --git a/doc/sv/kxsldbg/entities_window.png b/doc/sv/kxsldbg/entities_window.png new file mode 100644 index 0000000..0d6a79f Binary files /dev/null and b/doc/sv/kxsldbg/entities_window.png differ diff --git a/doc/sv/kxsldbg/glossary.docbook b/doc/sv/kxsldbg/glossary.docbook new file mode 100644 index 0000000..2d778f5 --- /dev/null +++ b/doc/sv/kxsldbg/glossary.docbook @@ -0,0 +1,35 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +StefanAsserhäll
stefan.asserhall@comhem.se
Översättare + + + + +Nyckelord + +&xsldbg; + +Se . + + + + +Xpath + +Ett giltigt uttryck som definierar vilken data som krävs. Se W3C:s hemsida. + + + + +Qname + +Ett fullständigt kvalificerat namn, till exempel xsl:min_variabel. Se W3C:s hemsida. + + + + diff --git a/doc/sv/kxsldbg/index.docbook b/doc/sv/kxsldbg/index.docbook new file mode 100644 index 0000000..1f1c22c --- /dev/null +++ b/doc/sv/kxsldbg/index.docbook @@ -0,0 +1,112 @@ + +KXSLDbg"> + + + + + + + + + + + + + + + xsldbg"> + DTD"> + XSD"> + XSLT"> +]> + + + + +Handbok &kxsldbg; + + +Keith Isdale
k_isdale@tpg.com.au
+ + + + Stefan Asserhäll
stefan.asserhall@comhem.se
 Översättare + + + + +2002 +2003 +2004 +Keith Isdale + + +&FDLNotice; +2004-11-18 +0.5 + + +&kxsldbg; tillhandahåller ett grafiskt gränssnitt till &xsldbg;, som stöder felsökning i &XSLT;-skript. + + + +KDE +xsldbg +libxslt +felsökare + + + + +Inledning + + +Funktioner + +&kxsldbg; ger tillgång till de flesta &xsldbg;-kommandon, för att: + +Sätta och ändra brytpunkter + + +Visa värdet på Xpath + + +Visa information om mallar, variabler, poster på anropsstacken, stilmallar och instanser som finns + + +Sätta och ändra brytpunkter och variabler + + +Flytta omkring i &XSL;-källkoden och &XML;-dokumentet via Xpath + + +Slå upp PUBLIC och SYSTEM ID i aktuell &XML;-katalog + + + + + + +Nytillagda funktioner +&kxsldbg; kan nu + + +Sätta och ändra variabler + + +Ritar upp texten i huvudfönstret med &kate;-biblioteken + + + + + + + + +Använda &kxsldbg; +&configure-section; &mainwindow-section; &inspector-section; &variables; &callstack; &templates; &sources; &entities; &tools-section; + +&credits-chapter; + + diff --git a/doc/sv/kxsldbg/kxsldbg_configure.docbook b/doc/sv/kxsldbg/kxsldbg_configure.docbook new file mode 100644 index 0000000..f3b12ea --- /dev/null +++ b/doc/sv/kxsldbg/kxsldbg_configure.docbook @@ -0,0 +1,67 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +StefanAsserhäll
stefan.asserhall@comhem.se
Översättare + + + +Anpassa en &kxsldbg;-session + +Du börjar inställningen genom att klicka på Felsök Anpassa i menyraden. + + +Inställningsdialogrutan + + + + +Inställningsdialogrutan +Inställningsdialogrutan. + + + + +Komma igång + +För att kunna köra en stilmall måste du ange: +&XSL;-källkod +&XML;-data +Utdatafil + + + +Genom att använda knappen ... för att välja önskad fil. &XSL;-källa och &XML;-data kan ange webbadresser som innehåller http://, ftp:// eller file://. Utdatafil måste ange en lokal skrivbar fil. +För att följa med i exemplet, välj följande filer i exempelkatalogen <KDE-PREFIX>/share/apps/kxsldbg: +&XSL;-källkod: testdoc.xsl +&XML;-data: testdoc.xml +Utdatafil: /tmp/xsldbg_output.txt + + + + + +Arbeta med alternativ + +Du kan välja inget eller några alternativ i rutan Alternativ. Varje alternativ har ett verktygstips med information om vilken effekt det har. + + + +Arbeta med parametrar + +Du kan lägga ingen eller några parametrar via XSLT-biblioteksparametrar i dialogrutan. Det gör det möjligt att ange parametervärden till stilmallen. + +Du skulle till exempel kunna lägga till ett Parameternamn kallat min_parameter med ett Parametervärde angivet till 'Hej allesamman! och klicka på knappen Lägg till. För att uppdatera en befintlig parameters värde, navigera bara till värdet du vill ändra med knapparna Föregående och Nästa, ange ett nytt Parametervärde och klicka därefter på knappen Verkställ. + + + +Verkställa ändringar + +För att ändringarna du har gjort ska få effekt, tryck på knappen Verkställ. För att ignorera alla ändringar tryck på knappen Avbryt. + +Du kan stänga dialogrutan med symbolen X som visas längst upp till höger i fönstret. Om du behöver ändra inställningarna, öppna bara dialogrutan igen som tidigare beskrivits. + + diff --git a/doc/sv/kxsldbg/kxsldbg_inspector.docbook b/doc/sv/kxsldbg/kxsldbg_inspector.docbook new file mode 100644 index 0000000..78ed7e9 --- /dev/null +++ b/doc/sv/kxsldbg/kxsldbg_inspector.docbook @@ -0,0 +1,71 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +StefanAsserhäll
stefan.asserhall@comhem.se
Översättare + + +Sätta och ändra brytpunkter + +Det huvudsakliga sättet att arbeta med brytpunkter är via huvudfönstret. Se + +När stilmallen väl har startats, kan du använda menyalternativet Felsök Inspektera.... Klicka därefter på fliken Brytpunkter. Se nedan för ett exempel. + + +Sätta brytpunkter + + + + +Sätta brytpunkter + + + + +Lägga till en brytpunkt + +Du kan lägga till en brytpunkt genom att ange något av: + +en fil och ett radnummer + +ett mallnamn + +ett mallnamn och lägesnamn + +ett lägesnamn + + + + +Och därefter trycka på knappen Lägg till. + + + +Detaljinformation om argument + +Ett filnamn kan vara en absolut sökväg till en lokal fil, eller en partiell sökväg (t.ex. xsldoc.xsl). + +Ett mall- eller lägesnamn är ett fullständigt kvalificerat namn där den icke-lokala delen är valfri, t.ex. matchas xsl:min_mall av min_mall. + + + +Ta bort en brytpunkt + +Vänsterklicka först på brytpunkten som du vill ta bort i listan med aktuella brytpunkter. Klicka därefter på knappen Ta bort. + + + +Ta bort alla brytpunkter + +Klicka på knappen Töm. + + + +Aktivera eller inaktivera en brytpunkt + +Vänsterklicka först på brytpunkten som du vill aktivera i listan med aktuella brytpunkter. Klicka därefter på knappen Aktivera. + + diff --git a/doc/sv/kxsldbg/kxsldbg_mainwindow.docbook b/doc/sv/kxsldbg/kxsldbg_mainwindow.docbook new file mode 100644 index 0000000..157d2b9 --- /dev/null +++ b/doc/sv/kxsldbg/kxsldbg_mainwindow.docbook @@ -0,0 +1,443 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +StefanAsserhäll
stefan.asserhall@comhem.se
Översättare + + +Använda huvudfönstret + + +Huvudfönstret + + + + +En textvy av den aktuella filen som felsöks +En textvy av den aktuella filen som felsöks. + + + + +Arbeta med huvudfönstret + +Tillståndet för en given brytpunkt anges med relevant text med en annan bakgrundsfärg. Du kan välja önskad färg: Se dialogrutan Inställningar Anpassa editor, på sidan Färger. + + +Du kan sätta, inaktivera eller ta bort en brytpunkt genom att använda tangenter, menyn Felsök eller knapparna i verktygsraden. + +Du kan flytta omkring markören i texten med följande tangenter: + + +Piltangenter: vänsterpil, högerpil, uppåtpil eller neråtpil. +Sidtangenter: Page Up eller Page Down. + + + + + + +Arbeta med &kxsldbg;-utdata + +Det mesta av utdata från &kxsldbg; fångas och presenteras antingen i inspektörens dialogruta eller i &kxsldbg;s utmatningsfönster. Undantag till denna regel är: + + +Ett felmeddelande som kommer från &kxsldbg; visas i en meddelandedialogruta. + + +Resultatet från utvärdering av ett uttryck visas i en meddelandedialogruta. + + +Utdata från en sökning skickas till filen som anges i &kxsldbg;s utmatningsfönster. + + + + + + + + diff --git a/doc/sv/kxsldbg/kxsldbg_tools.docbook b/doc/sv/kxsldbg/kxsldbg_tools.docbook new file mode 100644 index 0000000..635cff7 --- /dev/null +++ b/doc/sv/kxsldbg/kxsldbg_tools.docbook @@ -0,0 +1,77 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +StefanAsserhäll
stefan.asserhall@comhem.se
Översättare + + + +Diverse verktyg + +Flera verktyg är tillgängliga via menyn Felsök, där det huvudsakliga verktyget är inspektörverktyget. + + +Inspektörverktyget + +Inspektörverktyget innehåller alla enskilda dialogrutor för att arbeta med: + +Brytpunkter +Mallar +Variabler +Poster i anropsstacken +&XSL;-källkodsfiler +&XML;-instanser + + + + + +Köra genom att gå igenom + +Genom att klicka på menyalternativet Gå igenom stilmall... visas en dialogruta för att välja genomgångshastighet. + + +Genomgångsfönstret + + + + +Genomgångsfönstret + + + +För att stoppa genomgången, använd tangenten W eller välj menyalternativet Stoppa genomgång av stilmall. + + + +Slå upp &XML;-instanser + +För att slå upp ett SystemID i aktuell &XML;-katalog, använd menyalternativet Slå upp SystemID..., och skriv sedan in värdet att söka i dialogrutan som visas. + + +SystemID-fönstret + + + + +SystemID-fönstret + + + +För att slå upp ett PublicID, använd menyalternativet Slå upp PublicID..., och skriv sedan in värdet att söka i dialogrutan som visas. + + +PublicID-fönstret + + + + +PublicID-fönstret + + + + + diff --git a/doc/sv/kxsldbg/main_window.png b/doc/sv/kxsldbg/main_window.png new file mode 100644 index 0000000..caf10c5 Binary files /dev/null and b/doc/sv/kxsldbg/main_window.png differ diff --git a/doc/sv/kxsldbg/publicid_window.png b/doc/sv/kxsldbg/publicid_window.png new file mode 100644 index 0000000..195c1d4 Binary files /dev/null and b/doc/sv/kxsldbg/publicid_window.png differ diff --git a/doc/sv/kxsldbg/sources.docbook b/doc/sv/kxsldbg/sources.docbook new file mode 100644 index 0000000..3d3a5f3 --- /dev/null +++ b/doc/sv/kxsldbg/sources.docbook @@ -0,0 +1,27 @@ + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +StefanAsserhäll
stefan.asserhall@comhem.se
Översättare + + +Arbeta med &XSLT;-källkodsfiler (Källkod) + +Om inspektörsdialogrutan inte visas, använd menyalternativet Felsök Inspektera.... För att arbeta med källkod, klicka på källkodsfliken i dialogrutan som visas. + +Alla &XSLT;-källkodsfiler som inkluderas av &XSLT;-filen eller en av filer på samma nivå listas här. + + +Källfönstret + + + + +Källfönstret + + + +Genom att klicka på en källkodsfil i listan som visas, flyttas markören i huvudfönstret till början på filen som anges. + diff --git a/doc/sv/kxsldbg/sources_window.png b/doc/sv/kxsldbg/sources_window.png new file mode 100644 index 0000000..a2ddf7a Binary files /dev/null and b/doc/sv/kxsldbg/sources_window.png differ diff --git a/doc/sv/kxsldbg/systemid_window.png b/doc/sv/kxsldbg/systemid_window.png new file mode 100644 index 0000000..f4b1bc7 Binary files /dev/null and b/doc/sv/kxsldbg/systemid_window.png differ diff --git a/doc/sv/kxsldbg/templates.docbook b/doc/sv/kxsldbg/templates.docbook new file mode 100644 index 0000000..3e2f36e --- /dev/null +++ b/doc/sv/kxsldbg/templates.docbook @@ -0,0 +1,20 @@ + +Arbeta med mallar + +Om inspektörsdialogrutan inte visas, använd menyalternativet Felsök Inspektera.... För att arbeta med mallar, klicka på mallfliken i dialogrutan som visas. + +Alla mallar som hittas listas här. Observera att exportreglerna för &XSLT; gäller. Alltså kan det finnas mer än en mall med samma värde på namn och läge. + + +Mallfönstret + + + + +Mallfönstret + + + +Genom att klicka på en mall i listan som visas, flyttas markören i huvudfönstret till filen och radnumret som anges. + + diff --git a/doc/sv/kxsldbg/templates_window.png b/doc/sv/kxsldbg/templates_window.png new file mode 100644 index 0000000..97798cd Binary files /dev/null and b/doc/sv/kxsldbg/templates_window.png differ diff --git a/doc/sv/kxsldbg/variables.docbook b/doc/sv/kxsldbg/variables.docbook new file mode 100644 index 0000000..b909950 --- /dev/null +++ b/doc/sv/kxsldbg/variables.docbook @@ -0,0 +1,44 @@ + + + + +Keith Isdale
k_isdale@tpg.com.au
+ + +StefanAsserhäll
stefan.asserhall@comhem.se
Översättare + + + +Arbeta med variabler + +Om inspektörsdialogrutan inte visas, använd menyalternativet Felsök Inspektera.... + +Lokala och globala variabler visas under en flik i inspektörsdialogrutan. Följande exempel visar ett XSLT-kodsegement som deklarerar en global och en lokal variabel. + +<xsl:variable name="global_variabel" select="'x'"/> + + <xsl:template match="/"/> + <xsl:param name="lokal_variabel" select="'y'"/> + </xsl:template match="/"/> + + +Att klicka med musen på en variabel i listan gör att översiktsinformation visas längst ner i dialogrutan. Om en variabel har ett urvalsuttryck, till exempel + +<xsl:variable name="varierande" select="'gammalt_värde'" /> + + +kan en ny Xpath väljas genom att skriva in ett nytt värde i Variabeluttryck och därefter klicka på knappen Ange uttryck. + + +Fliken Variabler + + + + +Fliken Variabler +Fliken Variabler + + + +Genom att klicka på en variabel i listan som visas, flyttas markören i huvudfönstret till filen och radnumret som anges. + diff --git a/doc/sv/kxsldbg/variables_window.png b/doc/sv/kxsldbg/variables_window.png new file mode 100644 index 0000000..810f15c Binary files /dev/null and b/doc/sv/kxsldbg/variables_window.png differ diff --git a/doc/sv/kxsldbg/walk_window.png b/doc/sv/kxsldbg/walk_window.png new file mode 100644 index 0000000..2790d85 Binary files /dev/null and b/doc/sv/kxsldbg/walk_window.png differ diff --git a/doc/sv/xsldbg/commands.docbook b/doc/sv/xsldbg/commands.docbook new file mode 100644 index 0000000..ae0bd4b --- /dev/null +++ b/doc/sv/xsldbg/commands.docbook @@ -0,0 +1,758 @@ + + +Kommandoreferens + +Addparam +Lägg till en libxslt-parameter. Motsvarar att tillhandahålla --param <KNAMN>:<XPATH> via kommandoraden. + +Användning av addparam + +addparam <KNAMN> <XPATH>    (<XPATH> får inte innehålla några mellanslag eller dubbla citationstecken.) +addparam <KNAMN> "<XPATH>"    (Får inte innehålla några dubbla citationstecken i <XPATH>) + + +
+ + +Addwatch +Lägger till ett uttryck att bevaka. Se showwatch för att visa bevakade värden. +Förkortat namn: watch +Användning av Addwatch + +addwatch <XPATH> + + +
+ + +Base +Skriv ut den här nodens bas. +Användning av Base + + +base + + +
+ + +Break +Bryt i en mall, på en plats i en stilmall eller XML-fil laddad av xsldbg, eller i nuvarande nod. Nytt i xsldbg 3.1.4: I gdb-läge kan obundna brytpunkter anges i en specifik fil och på ett specifikt radnummer, och senare lösas upp till en aktiv brytpunkt. +Förkortat namn: bXsldbg försöker gissa den fullständiga webbadressen givet filnamn utan angiven sökväg ett filnamn i samma katalog som "översta" mallen som laddats ett filnamn relativt till xsldbgs nuvarande arbetskatalog Om du alltså har laddat en stilmallsfil från ../en/xsldoc.xsl kan du göra detta. break -l xsldoc.xsl 26 Det här kommandot matchar ett partiellt eller fullständigt KNAMN och/eller lägesnamn som anges. Till exempel matchar "template" alla KNAMN med en lokal del av "template". Alla namnrymder i angivet KNAMN expanderas som anges av namnrymderna definierade i XSL-källkodsfilen, t.ex. expanderas "xsl:test1" till "http://www.w3.org/199/XSL/Transform:test1" En begärd brytpunkt måste lösas upp till tillhörande webbadress och radnummer. Det görs automatiskt efter den första mallen har setts av xsldbg. Brytpunkter valideras igen en kort tid efter varje körning startar. Automatisk brytpunktsvalidering används när gdb-läge är aktiverat, standardbeteendet hos xsldbg. +Användning av Break + + +break -l <FILNAMN> <RADNUMMER>    (För att sätta en brytpunkt i angiven fil, på angivet radnummer) +break -l <WEBBADRESS> <RADNUMMER>    (För att sätta en brytpunkt i angiven webbadress, på angivet radnummer) +break <MALLNAMN>    (För att bryta i en namngiven eller matchande mall.) +break <MALLNAMN> <LÄGESNAMN>    (För att bryta i en namngiven mall med givet läge.)> +break "" <LÄGESNAMN>    (För att bryta i alla mallar som har ett givet lägesnamn) +break *    (För att bryta i alla mallar som hittas.) +break \*    (För att bryta i mallen "*". Andra namn som innehåller '*' behandlas inte speciellt.) +break     (För att sätta en brytpunkt i nuvarande nod. Ja, det omfattar XML-datanoder.) + + +
+ + +Bye +Sluta behandla stilmallen så snart som möjligt. +Användning av Bye + + +bye + + +
+ + +Cat +Skriv ut resultatet av ett Xpath-uttryck relativt till nuvarande nod. +Användning av Cat + + +Användning: cat <XPATH>    (För att visa en variabel eller parameter) +Användning: cat $<KNAMN> + + +
+ + +Cd +Byt katalog till sökvägen som anges av en Xpath. +Användning av Cd + + +<< = föregående-på-samma-nivå::nod() +>> = nästa-på-samma-nivå::nod() +<- = överliggande::nod() +-> = underliggande::nod() + +
+ + +Chdir +Byt arbetskatalog. +Användning av Chdir + + +chdir <SÖKVÄG>    (En relativ eller absolut sökväg i operativsystemet) + + +
+ + +Continue +Fortsätt köra stilmallen, och stoppa vid eventuella brytpunkter som hittas. +Förkortat namn: c +Användning av Continue + + +continue + + +
+ + +Data +Byt till visning av nuvarande nod i XML-data, eller ändra använd XML-data. +Användning av Data + + +data    (Byt till nuvarande dokumentnod.) +data <DATA>    (För att byta till en ny XML-datafil. Ett inledande "~" ersätts av värdet på miljövariabeln $HOME. Kommandot "run" behövs för att utföra det) + + +
+ + +Delete +Ta bort en mallbrytpunkt. +Förkortat namn: d +Användning av Delete + + +delete    (För att ta bort brytpunkten i nuvarande nod) +delete <BRYTPUNKTSID>    (För att ta bort brytpunkten med angivet brytpunktsnummer) +delete -l <FILNAMN> <RADNUMMER>    (Ta bort i angiven fil, på radnummer) +delete -l <WEBBADRESS> <RADNUMMER>    (Ta bort i angiven webbadress, på radnummer) +delete <MALLNAMN>    (För att ta bort brytpunkten i namngiven mall.) +delete *    (För att ta bort alla brytpunkter.) + + +
+ + +Delparam +Ta bort en libxslt-parameter +Användning av Delparam + + +delparam    (Ta bort alla befintliga parametrar) +delparam <PARAMID> + + +
+ + +Delwatch +Ta bort ett bevakningsuttryck, eller ta bort alla bevakningsuttryck som visas av kommandot "showwatch". +Användning av Delwatch + + +delwatch <BEVAKNINGSID>    (Ta bort ett bevakningsuttryck med given identifikation) +delwatch *    (Ta bort alla bevakningsuttryck) + + +
+ + +Dir +Skriv ut en lista med noder på liknande sätt som skalkommandot dir. + +Användning av Dir + + +dir + + +
+ + +Disable +Inaktivera en brytpunkt +Användning av Disable + + +disable    (För att inaktivera brytpunkten i nuvarande nod) +disable <BRYTPUNKTSID>    (För att inaktivera brytpunkten med angivet brytpunktsnummer) +disable -l <FILNAMN> <RADNUMMER>    (Inaktivera brytpunkt i angiven fil, på angivet radnummer) +disable -l <WEBBADRESS> <RADNUMMER>    (Inaktivera brytpunkt i angiven webbadress, på angivet radnummer) + + +
+ + +Du +Skriv ut en översikt av underliggande noder med trädformat. +Användning av Du + + +du + + +
+ + +Dump +Dumpa bloddrypande detaljer för den här noden +Användning av Dump + + +dump + + +
+ + +Enable +Aktivera eller inaktivera en brytpunkt (växla aktiv/inaktiv) +Förkortat namn: e +Användning av Enable + + +enable    (För att aktivera eller inaktivera brytpunkten i nuvarande nod) +enable <BRYTPUNKTSID>    (För att aktivera eller inaktivera brytpunkten med angivet brytpunktsnummer) +enable -l <FILNAMN> <RADNUMMER>    (Aktivera eller inaktivera brytpunkt i angiven fil, på angivet radnummer) +enable -l <WEBBADRESS> <RADNUMMER>    (Aktivera eller inaktivera brytpunkt i angiven webbadress, på angivet radnummer) + + +
+ + +Entities +Skriv ut lista med externa Allmänna Tolkade enheter i använd datafil(dokument). +Förkortat namn: ent +Användning av Entities + + +entities + + +
+ + +Exit +Sluta behandla stilmallen så snart som möjligt. +Användning av Exit + + +exit + + +
+ + +Frame +Skriv ut stackposten på ett givet djup +Förkortat namn: f +Användning av Frame + + +frame <POSTDJUP>    (Djup är ett tal från 0 till anropsstackens nuvarande djup) + + +
+ + +Free +Frigör stilmall och data (inaktiverat, se run). +Användning av Free + + +free + + +
+ + +Globals +Skriv ut en lista med globala stilmallsvariabler eller parametrar. Skriv ut värdet på en global variabel. +Användning av Globals + + +globals    (Skriv ut en lista med alla globalt tillgängliga variabler) +globals -f    (Skriv ut en lista med alla globalt tillgängliga variabler och deras värden) +globals <KNAMN>    (Skriv ut värdet på variabeln som anges) + + +
+ + +Help +Visa hjälp om kommando eller översikt +Förkortat namn: h +Användning av Help + + +help     (Visa översikt av produkten) +help <KOMMANDO>     (Visa hjälp om ett kommando) + + +
+ + +Load +Ladda xsldbgs alternativ och användarinställningar från disk. +Användning av Load + + +load + + +
+ + +Locals +Skriv ut en lista med lokala stilmallsvariabler eller parametrar. Skriv ut värdet på en lokal variabel. +Användning av Locals + + +locals    (Skriv ut en lista med alla lokalt tillgängliga variabler) +locals -f    (Skriv ut en lista med alla globalt tillgängliga variabler och deras värden) +locals <KNAMN>    (Skriv ut värdet på variabeln som anges) + + +
+ + +Ls +Lista noder med kort format +Användning av Ls + + +ls + + +
+ + +Next +Hoppa över en xsl:anropsmall eller xsl:tillämpa-mallar. Kommandot har samma effekt som att skriva in kommandona "step" och därefter "up". +Förkortat namn: n +Användning av Next + + +next    (fortsätt till nästa instruktion på samma nivå) + + +
+ + +Options +Skriv ut värden på xsldbgs alternativ +Användning av Options + + +options + + +
+ + +Output +Ange en lokal, skrivbar fil som ska användas för utmatning av resultat. +Förkortat namn: o +Användning av Output + + +output <FILNAMN>    (Filnamnet på en lokalt skrivbar fil, som kan ha prefixet "~" på Unix-liknande plattformar och CYGWIN plattformar, eller miljövariabler på RISC OS.) +output <WEBBADRESS>    (<WEBBADRESS> får bara använda protokollet "file://". Den konverteras sedan till ett filnamn som är lämpligt på operativsystemet) +output -    (Skicka till standardutmatningen. Får bara användas när xsldbgs kommandorad används) + + +
+ + +Public +Skriv ut värdet som en publik identifikation avbildar via nuvarande katalog. +Förkortat namn: pub +Användning av Public + + +public "<PublikID>" + + +
+ + +Pwd +Skriv ut nuvarande arbetskatalog. +Användning av Pwd + + +pwd + + +
+ + +Quit +Sluta behandla stilmallen så snart som möjligt. +Förkortat namn: q +Användning av Quit + + +quit + + +
+ + +Run +Starta om stilmallen. +Förkortat namn: r +Användning av Run + + +run + + +
+ + +Save +Spara xsldbgs alternativ och användarinställningar på disk. +Användning av Save + + +save + + +
+ + +Search +Sök i en databas med all information som samlats in från laddade stilmallar. +Alla utmatningsfiler lagras i värdet på alternativet "searchresultspath" om det är angivet, eller samma katalog som den tillhandahållna stilmallen. Filen searchresults.xml transformeras normalt av search.xsl, men transformeras med searchhtml.xsl om alternativet "preferhtml" är aktiverat. När sökkommandot utförs, skapas en XML-fil (searchresults.xml). Därefter kan du behandla filen med en egen stilmall för att presentera data på andra sätt. Om alternativet "preferhtml" inte är aktiverat, skrivs searchresult.txt ut på skärmen. Beroende på mängden data som samlas in, kan det ta en stund att slutföra kommandot. +Användning av Search + + +search <XPATH>    (Se var Xpath kan användas. Se search.dtd. Förvald <XPATH> är '//search/*') +search -sort <XPATH>    (Tala om för search.xsl att resultatet ska sorteras innan det skrivs ut) + + +
+ + +Set +Sätt en variabels värde. +Användning av Set + + +set <VARIABELNAMN> <XPATH> + + +
+ + +Setoption +Sätt ett alternativ för stilmallens körning. +Du måste använda kommandot run för att aktivera ändringar. +Användning av Setoption + + +setoption <ALTERNATIVNAMN> <HELTALSVÄRDE> +Där <ALTERNATIVNAMN> kan vara + + + + + debug    (Om <HELTALSVÄRDE> är sant dumpa resultatträdet istället) + catalogs    (Om <HELTALSVÄRDE> är sant, använd katalogerna från $SGML_CATALOG_FILES eller SGML $CatalogFiles för RISC OS) + html    (Om <HELTALSVÄRDE> är sant är indatadokumentet en HTML-fil) + docbook    (Om <HELTALSVÄRDE> är sant och docbook fortfarande stöds av libxml, är indatadokumentet SGML-docbook) + xinclude    (Om <HELTALSVÄRDE> är sant, utför Xinclude-behandling för dokumentinmatning) + preferhtml    (Om <HELTALSVÄRDE> är sant, föredra då HTML-utmatning för sökresultat. Se kommandot search) + autoencode    (Om <HELTALSVÄRDE> är sant, försök använda kodningen från stilmallen) + utf8input    (Om <HELTALSVÄRDE> är sant, görs all inmatning av användaren med UTF-8. Detta används normalt när xsldbg kör som en tråd) +      + gdb    (Kör i gdb-läge) + För värdet 1 betyder det här + Skriv ut mängder med ytterligare meddelanden. Öka frekvensen av utskriften "Breapoint at ...". + Som mest skrivs GDB_LINES_TO_PRINT ut när uttryck utvärderas, följt av "...". Se options.h för att ändra värdet. Förvalt värde är tre rader text. + Både lokala och globala variabler skrivs ut när kommandot "locals" utförs + När uttryck skrivs ut med cat eller print, inleds det beräknade värdet med "= " <UTTRYCK>. + + + + + + För värdet 2 betyder det här Skriv ut meddelanden som behövs av Kdbg samt utmatningen angiven ovan (när värdet är 1). + + + + + + + + + nonet    (Om <HELTALSVÄRDE> är sant, vägras hämtning av DTD:er eller enheter via nätverk) + novalid    (Om <HELTALSVÄRDE> är sant, hoppa över laddningsfasen för DTD:er) + repeat    (Om <HELTALSVÄRDE> är sant, kör transformeringen 20 gånger) + profile    (Om <HELTALSVÄRDE> är sant, dumpa profileringsinformation) + timing    (Om <HELTALSVÄRDE> är sant, visa använd tid) + noout    (Om <HELTALSVÄRDE> är sant, dumpa inte resultatet) + + + + +Där värdet är sant om det INTE är lika med noll +Där värdet är falskt om det ÄR lika med noll +stdout    Skriv ut alla felmeddelanden på standardutmatningen. Normalt hamnar alla felmeddelanden på standardfelutmatningen. +setoption <ALTERNATIVNAMN> "<STRÄNGVÄRDE>"    (Det får inte finnas dubbla citationstecken i <STRÄNGVÄRDE>) +setoption <ALTERNATIVNAMN> <STRÄNGVÄRDE>    (Det får varken finnas mellanslag eller dubbla citationstecken i <STRÄNGVÄRDE>) +Där <ALTERNATIVNAMN> kan vara + + + + + data    (Datafilens webbadress) + source    (Källfilens webbadress) + output    (Utmatningsfilens SystemID) + docspath    (Sökväg att använda vid sökning efter dokumentation) + catalognames    (Namnen på katalogerna som ska användas när alternativet catalogs är angivet. Värdet går förlorat om det anges innan alternativet catalogs) + encoding    (Vilken kodning som ska användas för standardutmatningen) + searchresultspath    Vilken sökväg som ska användas när sökresultat lagras. Om den inte är angiven, använder xsldbg stilmallens sökväg. + + + + + +
+ + +Shell +Kör skalkommando +Användning av Shell + + +shell <TEXT>    (<TEXT> är texten som ska skickas till operativsystemet för att utföras) + + +
+ + +Showbreak +För att visa en lista över mallbrytpunkter. +Förkortat namn: showOm ett läge finns för en mallbrytpunkt, läggs det till sist i brytpunktens mallnamn. Ett exempel på utmatningen är: +Breakpoint 3 enabled for template :"*" in file test1.xsl : line 105 +Breakpoint 2 enabled for template :"* testMode" in file test1.xsl : line 109 +Breakpoint 1 enabled for template :"* http://www.w3.org/1999/XSL/Transform:testMode" in file test1.xsl : line 113 + +Total of 3 breakpoints present + +Användning av Showbreak + + +showbreak + + +
+ + +Showparam +Skriv ut befintliga libxslt-parametrar +Användning av Showparam + + +showparam + + +
+ + +Showwatch +Visa nuvarande uttryck som bevakas +Förkortat namn: watches +Användning av Showwatch + + +showwatch    (Visa bevakningspunkter som för närvarande är valda och deras värden) +showwatch 1    (Aktivera automatiskt utskrift av bevakade uttryck. Det används normalt.) +showwatch 0    (Inaktivera automatiskt utskrift av bevakade uttryck.) + + +
+ + +Source +Byt till att visa nuvarande nod i stilmallen, eller byt stilmall som används. +Användning av Source + + +source    (Byt till nuvarande nod i stilmallen.) +source <KÄLLKOD>    (För att byta till en ny källkodsfil. Ett inledande "~" ersätts av värdet på miljövariabeln $HOME. Kommandot "run" behövs för att utföra det) + + +
+ + +Step +Stega till nästa instruktion i stilmallen. +Förkortat namn: s +Användning av Step + + +step + + +
+ + +Stepdown +Stega ner till en nyare "anropspost". +Förkortat namn: down +Användning av Stepdown + + +stepdown     (stega ner en post) +stepdown <ANTAL_POSTER>     (stega ner angivet antal poster) + + +
+ + +Stepup +Stega upp till en äldre "anropspost". +Förkortat namn: upDet här är inte ett noggrant kommando, utan xsldbg stannar så nära det går. +Användning av Stepup + + +stepup     (stega upp en post) +stepup <ANTAL_POSTER>     (stega upp angivet antal poster) + + +
+ + +Stylesheets +Skriv ut en lista med laddade stilmallar +Förkortat namn: style +Användning av Stylesheet + + +stylesheets + + +
+ + + +System +Skriv ut värdet som en systemfil avbildar via nuvarande katalog. +Förkortat namn: sys +Användning av System + + +system "<SystemID>" + + +
+ + +Templates +Skriv ut en lista med tillgängliga mallar. Sök efter en mall +Förkortat namn: t +Användning av Templates + + +templates +templates <MALL>    (Skriv ut detaljinformation för mallen som heter <MALL> om den kan hittas) + + +
+ + +Trace +Spåra en körning av stilmallen och skriv ut fil och radnummer för mellanliggande steg +Användning av Trace + + +trace + + +
+ + +Tty +Öppna en terminal. Ställ in nivå av TTY-omdirigering. +Användning av Tty + + +tty <ENHETSSÖKVÄG>    (Där <ENHETSSÖKVÄG> är en giltig terminal i operativsystemet. Försöker bara öppna terminalen. +tty <TTY-NIVÅ>    (Ställ in nivå av TTY-omdirigering, där <TTY_NIVÅ> är en giltig nivå av inmatning och utmatning att använda.) + Där nivå är + 0 = Standardinmatning och utmatning + 1 = Terminalutmatning av resultat från transformationer, spårning och genomlöpning     (Normaltillstånd när TTY-enheten har öppnats. Inte fullständigt implementerat ännu.) + 2 = Fullständig omdirigering till terminalen    (Ännu inte implementerat.) + Alla andra heltalsvärden antas betyda nivå 0 + + + + + + +
+ + +Validate +Validera utmatningsfilen som skapas av stilmallen (inaktiverad) +Användning av Validate + + +validate + + +
+ + +Walk +Löp igenom koden med ett antal olika hastigheter +Användning av Walk + + +walk <HASTIGHET>    (Använd Ctrl+C för att stoppa körningen. <HASTIGHET> är ett värde mellan 0 och 9, där 0 betyder stoppa, 1 är mycket snabbt och 9 är mycket långsamt) + + +
+ + +Where +Skriv ut en spårning av mallanrop (anropsstack) och skriv ut arbetskatalogen. +Förkortat namn: w +Användning av Where + + +where + + +
+ + +Write +Att färdigställas +Användning av Write + + +write + + +
+ + + + + + + diff --git a/doc/sv/xsldbg/credits.docbook b/doc/sv/xsldbg/credits.docbook new file mode 100644 index 0000000..2e91085 --- /dev/null +++ b/doc/sv/xsldbg/credits.docbook @@ -0,0 +1,14 @@ + + +Tack till och licens + +&xsldbg; +Program copyright 2004 Keith Isdale k_isdale tpg com au + +Översättning Stefan Asserhäll stefan.asserhall@comhem.se +&underFDL; &underGPL; +Tack till +Upphovsmännen till libxml och libxsl. +Johannes Sixt för hjälp med att lägga till stöd för xsldbg i Kdbg. + + diff --git a/doc/sv/xsldbg/index.docbook b/doc/sv/xsldbg/index.docbook new file mode 100644 index 0000000..8ef5886 --- /dev/null +++ b/doc/sv/xsldbg/index.docbook @@ -0,0 +1,96 @@ + +xsldbg"> + + + + + + + + +]> + + + + + + + + + + + +Handbok &xsldbg; + + +Keith Isdale
k_isdale@tpg.com.au
+ + + + Stefan Asserhäll
stefan.asserhall@telia.com
 Översättare + + + + +2002 +2003 +Keith Isdale + + +&FDLNotice; +2004-09-26 +1.01.00 + + + +&xsldbg; är ett verktyg som är avsett att hjälpa till med att förstå stilmallar. Vad som gör det annorlunda jämfört med andra felsökare för stilmallar är möjligheten att söka efter intressanta objekt och att spåra stilmallens körning. + + + +KDE +tdeutils +xsldbg +xsl +XML + + + + +&introduction-chapter; +&usage-chapter; +&commands-chapter; +&credits-chapter; + + + +Installation + + +Hur man skaffar &xsldbg; + +Se komponenten kxsldbg i modulen tdewebdev i &kde; SVN. +&install.intro.documentation; + + +Krav + +För att använda &xsldbg; med lyckat resultat, behöver du ha installerat &kde;, libxslt, libexslt och libxml, som är tillgängliga i en typisk &kde;-installation. + + + +Kompilering och installation +Oftast kompileras &xsldbg; som en del av komponenten kxsldbg i modulen tdewebdev. + + + +Anpassning + +&xsldbg; anpassas med väljare som skickas via kommandoraden och dess kommando setoption. + + + + + +&documentation.index; + diff --git a/doc/sv/xsldbg/introduction.docbook b/doc/sv/xsldbg/introduction.docbook new file mode 100644 index 0000000..33a4f3e --- /dev/null +++ b/doc/sv/xsldbg/introduction.docbook @@ -0,0 +1,16 @@ + + +Inledning + +&xsldbg; är ett textbaserat verktyg för att felsöka i stilmallar (eXtensible Stylesheet Language) och har kommandon som liknar Unix/Linux avlusaren gdb. Det har tre huvudlägen för körning av stilmallar. + + + + Köra hela stilmallen + Stega till nästa XSL-instruktion + Fortsätta till nästa brytpunkt hittas, eller stilmallen startas om + + + + + diff --git a/doc/sv/xsldbg/usage.docbook b/doc/sv/xsldbg/usage.docbook new file mode 100644 index 0000000..fabad8c --- /dev/null +++ b/doc/sv/xsldbg/usage.docbook @@ -0,0 +1,62 @@ + + +Använda &xsldbg; + +Xsldbg kommandoargument +På system med biblioteket readline tillgängligt kan du använda bakåt- och framåt-tangenterna för att navigera i historiken med inmatade kommandon. På alla system kan det senast inmatade kommandot upprepas genom att bara trycka på returtangenten. +Om ditt operativsystem stöder det expanderas filnamn. +Flera kommandon har mer än ett argument. Citationstecken kan användas för att göra att sammansatta uttryck behandlas som ett argument, t.ex. break "* | @" skulle låta dig sätta en brytpunkt i mallen med namnet "* | @". + + +Begreppsförklaring +Följande tabell beskriver begreppen som används i efterföljande kommandoguide. + + + MALLNAMN: Ett giltigt mallnamn innehåller bara ASCII-teckenkoderna 0x00 till 0x7F, och kan vara ett fullständigt kvalificerat namn, dvs. "xsl:mallnamn". + FILNAMN: Ett giltigt filnamn lokalt på användarens system. Det kan ha prefixet "~" på Unix-liknande plattformar och CYGWIN plattformar, eller miljövariabler på RISC OS. + WEBBADRESS: En webbadress (Uniform Resource Identifier) enligt definitionen i RFC 2396 + LÄGESNAMN: Läget för en mall, som kan vara ett fullständigt kvalificerat namn, dvs. "xsl:lägesnamn". + KNAMN: Ett fullständig kvalificerat namn, dvs. "xsl:lokaldel". + RADNUMMER: Ett giltigt radnummer för tillhörande <FILNAMN>. + ANTAL_POSTER: Ett giltigt antal poster för ändring av position. + BRYTPUNKTSID: Ett giltigt brytpunktsnummer. + BEVAKNINGSID: Ett giltigt nummer på ett bevakningsuttryck, som anges av kommandot showwatch. + HASTIGHET: Hastighet att löpa igenom koden med, mellan 0 och 9. +     (Kommentar): En kommentar om kommandots betydelse eller användning. + { alt1 | alt2 | alt3 .. etc}: Välj ett av alternativen. + XPATH: Ett Xpath-urval av noder. + PARAMID: Ett giltigt parameternummer som anges av kommandot showparam. + SÖKVÄG: En sökväg för att ändra arbetskatalog. På vissa operativsystem ersätts prefixet "~" med sökvägen till din hemkatalog. + TEXT: Fri text     (inga begränsningar) + KOMMANDO: Ett giltigt kommando för xsdbg. + KNAMN: Ett giltigt variabel- eller parameternamn. + KÄLLA: Stilmallen som körs eller ska köras. Se <FILNAMN> och <WEBBADRESS>. + DATA: XML-data (dokument) som håller på att eller ska behandlas av stilmallen. Se <FILNAMN> och <WEBBADRESS>. + ENHETSSÖKVÄG: En giltig terminal för operativsystemet. + TTYNIVÅ: En giltig nivå att använda för inmatning eller utmatning. + + + + +Översikt av tillgängliga kommandon + + +Relaterade till hjälp: help +Relaterade till körning: {bye|exit| quit}, step, stepup, stepdown, next, continue, run, trace, setoption, options +Relaterade till Libxslt-parametrar: addparam, delparam, showparam, output, setoption, options +Relaterade till mallar: templates, where, frame +Relaterade till brytpunkter: break, showbreak, delete, enable +Visning av uttryck (Xpath): cat +Visning av noder: ls, dir, du, cat, pwd +Visning av variabler: globals, locals, cat, addwatch +Sätta variabler: set +Val av noder: source, data, cd +Sökning: search +Relaterade till operativsystem: chdir, shell, tty +Relaterade till filer: output, entities, system, public +Inaktiverade filkommandon: validate, load, save, write, free + + + + + -- cgit v1.2.3