FindLibXslt

Finds the XSL Transformations, Extensible Stylesheet Language Transformations (XSLT) library (libxslt).

Imported Targets

Added in version 3.18.

This module provides the following Imported Targets:

LibXslt::LibXslt

Target encapsulating the usage requirements of the libxslt library. This target is available only if libxslt is found.

LibXslt::LibExslt

Target encapsulating the usage requirements for the libexslt library. Part of the libxslt package, libexslt provides optional extensions to XSLT on top of libxslt. This target is available only if the main libxslt library is found.

LibXslt::xsltproc

Target encapsulating the command-line XSLT processor (xsltproc). This tool, part of the libxslt package, applies XSLT stylesheets to XML documents as a command-line alternative to the libxslt library. This target is available only if the xsltproc executable is found.

Result Variables

This module sets the following variables:

LibXslt_FOUND

Boolean indicating whether the libxslt is found. For backward compatibility, the LIBXSLT_FOUND variable is also set to the same value.

LIBXSLT_LIBRARIES

Libraries needed to link to libxslt.

LIBXSLT_DEFINITIONS

Compiler switches required for using libxslt.

LIBXSLT_VERSION_STRING

Version of libxslt found.

LIBXSLT_EXSLT_LIBRARIES

Libraries needed when linking against the exslt library. These are available and needed only when using exslt library.

Cache Variables

The following cache variables may also be set:

LIBXSLT_INCLUDE_DIR

Directory containing libxslt/xslt.h and other libxslt header files.

LIBXSLT_EXSLT_INCLUDE_DIR

Added in version 3.18.

Directory containing libexslt/exslt.h and other exslt-related headers. These are needed only when using exslt (extensions to XSLT).

LIBXSLT_XSLTPROC_EXECUTABLE

Full path to the XSLT processor executable xsltproc if found. This path is optional.

Examples

Finding libxslt library and linking it to a project target:

find_package(LibXslt)
target_link_libraries(foo PRIVATE LibXslt::LibXslt)

When project also needs the extensions to XSLT (exslt) library, both targets should be linked:

find_package(LibXslt)
target_link_libraries(foo PRIVATE LibXslt::LibXslt LibXslt::LibExslt)

Example, how to use XSLT processor in a custom command build rule:

find_package(LibXslt)

if(TARGET LibXslt::xsltproc)
  # Executed when some build rule depends on example.html.
  add_custom_command(
    OUTPUT example.html
    COMMAND LibXslt::xsltproc -o example.html transform.xslt example.xml
  )
endif()