If you are running Linux or Unix you'll need a C compiler so the extension can be compiled when it is installed. If you are running Windows, then install the Windows specific RubyGem which includes an already built extension.

!!!NOTE!!! The libxml-ruby and libxslt-ruby bindings must absolutely, positively, without a doubt share the same libxml2 library. This is because libxslt modifies XML documents created by libxml2. If there are two copies of libxml2 on your system, then when XML documents allocated in copy #1 are manipulated by copy #2, a segmentation fault will occur. So make sure that your system has only one copy of libxml2 installed.

== INSTALLATION

The easiest way to install libxslt-ruby is via Ruby Gems. To install:

gem install libxslt-ruby

If you are running Windows, make sure to install the Mingw64 RubyGem which includes an already built binary file. The binary is built against libxml2 version 2.9.1, iconv version 1.14 and libxslt version 1.1.28. Binaries for libxml2 and iconv are provided in the libxml-ruby bindings, while binaries for libxslt and libexslt areprovided in the libxslt-ruby bindings.

Installation from source:

ruby ext/libxslt/extconf.rb make sudo make install

gem build libxslt-ruby.gemspec gem install libxslt-ruby-1.1.1.gem

== USAGE

For in-depth information about using libxslt-ruby please refer to its online Rdoc documentation.

All libxslt classes are in the LibXSLT::XSLT module. The simplest way to use libxslt is to require 'xslt'. This will mixin the LibXML and LibXSLT modules into the global namespace, allowing you to write code like this:

require 'xslt' document = XML::Document.new stylesheett = XSLT::Stylesheet.new(document)

If you prefer not to add the LibXSLT module to the global namepace, then write your code like this:

require 'libxslt'

class MyClass def some_method document = LibXML::XML::Document.new stylesheett = LibXSLT::XSLT::Stylesheet.new(document) end end

Given an XML file like:

Sean Chittenden sean@chittenden.org $Version$ $Date$ $Id$ Fuzface... The Internet's a big place and here's some proof...

<body>
  <para>
    I think it's a tragedy that I'm going to start off my new
    commentary by talking about facial hair and the Internet.
    Something about that just screams pathetic, but whatever: it's
    humor and that's life.
  </para>
</body>

And an XSLT file like this:

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"> <xsl:template match="/"> <xsl:element name="html"> <xsl:element name="head"> <xsl:element name="title">Ramblings - <xsl:value-of select="commentary/meta/title" /> - <xsl:value-of select="commentary/meta/subtitle" /></xsl:element> </xsl:element>

  <xsl:element name="body">
    <xsl:element name="h1"><xsl:value-of select="commentary/meta/title" /></xsl:element>
    <xsl:element name="h3"><xsl:value-of select="commentary/meta/subtitle" /></xsl:element>
    By: <xsl:value-of select="commentary/meta/author/first_name" /> <xsl:value-of select="commentary/meta/author/last_name" /><xsl:element name="br" />
    Date: <xsl:value-of select="commentary/meta/date" /><xsl:element name="br" />

    <xsl:for-each select="./commentary/body">
      <xsl:apply-templates />
    </xsl:for-each>

  </xsl:element>
</xsl:element>

</xsl:template>

<xsl:template match="para"> <xsl:element name="p"> <xsl:value-of select="." /> </xsl:element> </xsl:template> </xsl:stylesheet>

We can easily transform the XML with the following ruby code:

require 'xslt'

Create a new XSL Transform

stylesheet_doc = XML::Document.file('files/fuzface.xsl') stylesheet = LibXSLT::Stylesheet.new(stylesheet_doc)

Transform a xml document

xml_doc = XML::Document.file('files/fuzface.xml') result = stylesheet.apply(xml_doc)

You can then print, save or manipulate the returned document.

== License

See LICENSE for license information.

== DOCUMENTATION

RDoc comments are included - run 'rake doc' to generate documentation. You can find the latest documentation at:

http://libxsl.rubyforge.org/

== MORE INFORMATION

For more information please refer to the documentation. If you have any questions, please send email to libxml-devel@rubyforge.org.

FAQs

What is libxslt-ruby?

Is libxslt-ruby well maintained?

Package last updated on 19 May 2020

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install