Overview

kxsldbg provides plugins to access to XSLT debugging via xsldbg. Currently a plugin for Kate is provided.

Features include

• run to a location in XSLT/XML file
  ** step
  ** stepup
  ** stepdown
  ** next
  ** continue
  ** run
• set breakpoints on XSLT/XML files
• view XSLT/XML data
  ** view and possible set XSLT variables
  ** view and set XSLT parameter variables feed to XSLT tranformation
  ** view result of XPath expressions
  ** watch result of XPath expressions
  ** list templates in use
  ** list stylesheets in use
  ** list general parsed entities in use

Using code from git

kxsldbg makes use of submodules to setup the needed module run
git submodule foreach --recursive git submodule init
git submodule update --recursive

Install dependancies

To be able to compile kxsldbg the libraries xsldbg and qtnotifier will be built
in qxsldbg_submodule/xsldbg_submodule directory. See qxsldbg_submodule/xsldbg_submodule/README.md for details of required environment setup.

This package requiries

• Qt5.5 Core, GUI and Network module development libraries/headers to be present
• Qt5 webengine development libraries/headers to be present (for embeded help viewer)
• libexslt, libxslt and libxml2 libraries/headers to be present.

As example install prerequisites on

• OpenSuse Linux:
  sudo zypper install rpmbuild patterns-openSUSE-devel_qt5 \
  patterns-openSUSE-devel_basis patterns-openSUSE-devel_C_C++ libxslt-devel \
  libxml2-devel libxslt libxml2 kate cmake ktexteditor-devel khelpcentre

• Centos
  # Centos7 currently defaults to KDE4 so there will be alot of KF5 packages needed as
  # well as building kate from source
  sudo yum install gcc gcc-c++ make rpm-build libxslt-devel \
  libxml2-devel libxslt libxml2 qt5-qtbase-devel epel-release kate kf5-*-devel cmake3 kf5-ktexteditor khelpcentre
  # install kate from git source
  set OLDDIR=$PWD
  cd ..
  git clone https://github.com/KDE/kate.git
  cd kate
  mkdir build
  cd build

  cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release ..
  make
  make install or su -c 'make install' or sudo make install
  cd $OLDPWD

• Ubuntu based distro
  sudo apt-get install g++ make qt5-qmake libxml2-dev libxslt1-dev \
  qtbase5-dev qtbase5-dev-tools kate libkf5texteditor-dev extra-cmake-modules cmake kdoctools-dev khelpcentre

Compilation

Complation on *unix

cd <project_name_path>
mkdir build
cd build

cmake -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release ..
make
make install  or  su -c 'make install'  or  sudo make install

where "/usr" points to your KDE installation prefix.

If a custom install path is used, make the katexsldbg pluging available to kate via setting $QT_PLUGIN_PATH, e.g:
cmake -DCMAKE_INSTALL_PREFIX=~/kf5_install -DCMAKE_BUILD_TYPE=Debug ..
...
export QT_PLUGIN_PATH=~/kf5_install/lib64/plugins/

Usage

Once the katexsldbgplugin is installed

• start kate and enable the "xsldbg" plugins
• control xsldbg via the toolbars or "xsldbg" menu added to kate when "xsldbg" plugin is loaded

Documentation

KDE documentation is provided via the "Help" menu entry within the xsldbg menu seen in Kate