s1kd-tools Building, installing and uninstalling khzae.net khzae.net All Update Linux requirements Add instructions for Cygwin and MinGW64 There are multiple ways to install the s1kd-tools: using a package manager and the pre-compiled Debian (.deb) or Red Hat (.rpm) packages building from source Debian (.deb) and Red Hat (.rpm) packages are provided to easily install, upgrade or uninstall the s1kd-tools on Linux systems using a package manager. The examples below focus on the standard dpkg (for Debian-based distributions) and rpm (for Red Hat-based distributions). You can download the latest release of the s1kd-tools from http://khzae.net/1/s1000d/s1kd-tools/releases/latest . Then use one of the following commands to install it: Debian: # dpkg -i s1kd-tools_[version]_[arch].deb Red Hat: # rpm -i s1kd-tools.[version].[arch].rpm To uninstall using the package manager, use one of the following commands: Debian: # dpkg -r s1kd-tools Red Hat: # rpm -e s1kd-tools To build the executables: coreutils binutils gcc make xxd pkg-config http://xmlsoft.org libxml2, libxslt, libexslt If using the SAXON XPath engine: https://www.saxonica.com/saxon-c/index.xml Saxon/C If using the XQILLA XPath engine: https://xerces.apache.org/xerces-c/ Xerces-C , http://xqilla.sourceforge.net XQilla To build the documentation from source: http://github.com/kibook/s1kd2db s1kd2db https://pandoc.org/ pandoc To build the executables on Windows, an environment such as MinGW or Cygwin is recommended. These provide POSIX-compatible tools, such as make, that allow the s1kd-tools to be built and installed on a Windows system in the same way as on a Linux system. To build the executables on Cygwin, you will need the following packages from the package installer: binutils gcc-core make xxd libxml2-devel libxslt-devel Prior to building the executables on MSYS2 MINGW64, run the following to install the necessary packages from pacman: pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-make mingw-w64-x86_64-pkgconf mingw-w64-x86_64-libxml2 mingw-w64-x86_64-libxslt mingw-w64-x86_64-libsystre vim Run the following commands to build the executables, and install both the executables and documentation: $ make # make install To uninstall the executables and documentation: # make uninstall The following parameters can be given to make to control certain options when building and installing. The PREFIX variable determines where the s1kd-tools are installed when running make install, and where they are uninstalled from when running make uninstall. The default value is /usr/local. Example: # make PREFIX=/usr install # make PREFIX=/usr uninstall The XPATH2_ENGINE variable determines which XPath 2.0 implementation the s1kd-brexcheck tool will use to evaluate the object paths of BREX rules. The s1kd-tools are built on libxml, so by default s1kd-brexcheck uses libxml's XPath implementation. However, libxml only supports XPath 1.0. While as of Issue 5.0, the S1000D default BREX rules are all compatible with XPath 1.0, Issue 4.0 and up do reference the XPath 2.0 specification. Therefore, if your project needs XPath 2.0 support for BREX rules, you should select one of these implementations: SAXON Experimental implementation using the Saxon/C library. Slower, and Saxon/C itself is a very large dependency. Not recommended at this time due to memory leak issues. XQILLA Experimental implementation using the Xerces-C and XQilla libraries. A little slower than libxml, but faster than Saxon/C, and the dependencies are much smaller than the latter. This is currently the recommended implementation if you need XPath 2.0 support. Example: $ make XPATH2_ENGINE=XQILLA