RubyGems - libxslt-ruby - Versions diffs - 0.6.0-x86-mswin32-60 → 0.7.0-x86-mswin32-60 - Mend

libxslt-ruby 0.6.0-x86-mswin32-60 → 0.7.0-x86-mswin32-60

Files changed (42) hide show

data/README +125 -136
data/doc/classes/XSLT.html +215 -0
data/doc/classes/XSLT/Stylesheet.html +244 -0
data/doc/classes/XSLT/TransformContext.html +111 -0
data/doc/created.rid +1 -0
data/doc/files/CHANGES.html +168 -0
data/doc/files/LICENSE.html +133 -0
data/doc/files/README.html +269 -0
data/doc/files/ext/libxslt/libxslt_c.html +101 -0
data/doc/files/ext/libxslt/ruby_xslt_stylesheet_c.html +101 -0
data/doc/files/ext/libxslt/ruby_xslt_transform_context_c.html +101 -0
data/doc/files/lib/deprecated_rb.html +101 -0
data/doc/files/lib/libxslt_rb.html +110 -0
data/doc/fr_class_index.html +29 -0
data/doc/fr_file_index.html +34 -0
data/doc/fr_method_index.html +28 -0
data/doc/index.html +24 -0
data/doc/rdoc-style.css +208 -0
data/ext/libxslt/libxslt.c +21 -212
data/ext/libxslt/libxslt.h +0 -17
data/ext/libxslt/ruby_xslt_stylesheet.c +135 -173
data/ext/libxslt/ruby_xslt_stylesheet.h +5 -10
data/ext/libxslt/ruby_xslt_transform_context.c +5 -2
data/ext/libxslt/version.h +2 -2
data/lib/deprecated.rb +66 -0
data/lib/libxslt.rb +1 -0
data/lib/libxslt_ruby.so +0 -0
data/mingw/libxslt_ruby.so +0 -0
data/tests/files/commentary.dtd +34 -0
data/tests/files/fuzface.xml +154 -0
data/tests/files/fuzface.xsl +4 -0
data/tests/files/params.xml +2 -0
data/tests/files/params.xsl +11 -0
data/tests/files/ramblings.xsl +46 -0
data/tests/test_deprecated.rb +99 -0
data/tests/test_libxslt.rb +21 -0
data/tests/test_stylesheet.rb +64 -0
data/tests/test_suite.rb +3 -0
data/vc/libxslt_ruby.sln +1 -1
data/vc/libxslt_ruby.vcproj +3 -3
metadata +41 -10
data/mingw/mingw.rake +0 -36

data/README CHANGED Viewed

@@ -1,153 +1,142 @@
-== INSTALLATION
+= libxslt-ruby
-Installation is simple.  Follow the following steps:
+== Overview
-=== Rubygems
+The libxslt gem provides Ruby language bindings for GNOME's Libxslt
+toolkit. It is free software, released under the MIT License.
-  gem install libxsl-ruby
-=== Tarball/zip
-  $ rake test
-  $ rake install
+== Requirements
-If extconf yacks up an error, follow the instructions it provides.
-You will need to chdir to ext/xml and run 'ruby extconf.rb' to provide
-options, after which you can either use Rake for everything or
-do with make (make && make install).
+libxslt-ruby requires Ruby 1.8.4 or higher.  It is dependent on
+the following libraries to function properly:
-Once installed, look at the test scripts (tests/*.rb), and run
-'rake doc' to generate API documentation.
+* libm      (math routines: very standard)
+* libz      (zlib)
+* libiconv
+* libxml2
+* libxslt
+* libxml-ruby bindings
-== DOCUMENTATION
+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.
-RDoc comments are included - run 'rake doc' to generate documentation.
-You can find the latest documentation at:
+!!!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.
-* http://libxsl.rubyforge.org
-== USAGE EXAMPLE
+== INSTALLATION
-*Note*: To use libxsl-ruby, you have to require both 'xml/libxml' and
-'xml/libxslt'. The following example is an abridged version of that
-included with the distribution, which you can run with:
+The easiest way to install libxslt-ruby is via Ruby Gems.  To install:
-  $ cd tests
-  $ ruby fuzface.rb
+<tt>gem install libxslt-ruby</tt>
+If you are running Windows, make sure to install the Win32 RubyGem which
+includes an already built binary file.  The binary is built against
+libxml2 version 2.6.32, iconv version 1.12 and libxslt version 1.1.24.
+Binaries for libxml2 and iconv are provided in the libxml-ruby bindings,
+while a binary for libxslt is provided in the libxslt-ruby bindings.
+These binaries should be put either in the libxslt/lib directory
+or on the Windows path.
+The Windows binaries are biult with MingW.  The gem also includes
+a Microsoft VC++ 2005 solution.  If you wish to run a debug version
+of libxml-ruby on Windows, then it is highly recommended
+you use VC++.
+== USAGE
 Given an XML file like:
-	<?xml version="1.0" encoding="UTF-8"?>
-	<?xml-stylesheet href="fuzface.xsl" type="text/xsl"?>
-	<commentary>
-	  <meta>
-	    <author>
-	      <first_name>Sean</first_name>
-	      <last_name>Chittenden</last_name>
-	      <email>sean@chittenden.org</email>
-	    </author>
-	    <version>$Version$</version>
-	    <date>$Date: 2007-08-29 12:18:15 -0600 (Wed, 29 Aug 2007) $</date>
-	    <id>$Id: README 33 2007-08-29 18:18:15Z transami $</id>     <title>Fuzface...</title>
-	    <subtitle>The Internet's a big place and here's some proof...</subtitle>
-	  </meta>
-	  <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>
-	</commentary>
-And an XSLT like:
-	<?xml version="1.0" ?>
-	<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>
+  <?xml version="1.0" encoding="UTF-8"?>
+  <?xml-stylesheet href="fuzface.xsl" type="text/xsl"?>
+  <commentary>
+    <meta>
+      <author>
+        <first_name>Sean</first_name>
+        <last_name>Chittenden</last_name>
+        <email>sean@chittenden.org</email>
+      </author>
+      <version>$Version$</version>
+      <date>$Date: 2008-07-10 00:39:47 -0600 (Thu, 10 Jul 2008) $</date>
+      <id>$Id: README 64 2008-07-10 06:39:47Z cfis $</id>     <title>Fuzface...</title>
+      <subtitle>The Internet's a big place and here's some proof...</subtitle>
+    </meta>
+    <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>
+  </commentary>
+And an XSLT file like this:
+  <?xml version="1.0" ?>
+  <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 'rubygems'  # if installed via gems
-	require 'xml/libxml'
-	require 'xml/libxslt'
-	# Create a new XSL Transform
-	xslt = XML::XSLT.file('fuzface.xsl')
-	xslt.doc = XML::Document.file('fuzface.xml')
-	# Parse to create a stylesheet, then apply.
-	s = xslt.parse
-	s.apply
-	# To save the result to a file:
-	File.open('fuzface.html', 'w') do |f|
-	  s.save(f)
-	end
-	# To output the result to stdout
-	s.print
-To give the following result:
-	<html>
-	<head>
-	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-	<title>Ramblings - Fuzface... - The Internet's a big place and here's some proof...</title>
-	</head>
-	<body>
-	<h1>Fuzface...</h1>
-	<h3>The Internet's a big place and here's some proof...</h3>
-	      By: SeanChittenden<br>
-	      Date: $Date: 2007-08-29 12:18:15 -0600 (Wed, 29 Aug 2007) $<br>
-	    <p>
-	      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.
-	    </p>
-	  </body>
-	</html>
-== If you checked out from CVS
-If you checked out the source from CVS, you must install a copy of
-the current (or matching) libxml-ruby headers in:
-  ext/xml/libxml-ruby
-prior to running the above. This can be done via rake, and will
-happen automatically if ../libxml/ext/xml is found, or the
-LIBXMLH=/path/to/headers commandline option is supplied.
-# $Id: README 33 2007-08-29 18:18:15Z transami $
-# See the LICENSE file for copyright and distribution information
+  require 'libxslt'
+  # Create a new XSL Transform
+  stylesheet_doc = XML::Document.file('files/fuzface.xsl')
+  stylesheet = XSLT::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.

data/doc/classes/XSLT.html ADDED Viewed

@@ -0,0 +1,215 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>Module: XSLT</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
+  <script type="text/javascript">
+  // <![CDATA[
+  function popupCode( url ) {
+    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+  }
+  function toggleCode( id ) {
+    if ( document.getElementById )
+      elem = document.getElementById( id );
+    else if ( document.all )
+      elem = eval( "document.all." + id );
+    else
+      return false;
+    elemStyle = elem.style;
+    if ( elemStyle.display != "block" ) {
+      elemStyle.display = "block"
+    } else {
+      elemStyle.display = "none"
+    }
+    return true;
+  }
+  // Make codeblocks hidden by default
+  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
+  // ]]>
+  </script>
+</head>
+<body>
+    <div id="classHeader">
+        <table class="header-table">
+        <tr class="top-aligned-row">
+          <td><strong>Module</strong></td>
+          <td class="class-name-in-header">XSLT</td>
+        </tr>
+        <tr class="top-aligned-row">
+            <td><strong>In:</strong></td>
+            <td>
+                <a href="../files/ext/libxslt/libxslt_c.html">
+                ext/libxslt/libxslt.c
+                </a>
+        <br />
+                <a href="../files/ext/libxslt/ruby_xslt_stylesheet_c.html">
+                ext/libxslt/ruby_xslt_stylesheet.c
+                </a>
+        <br />
+                <a href="../files/ext/libxslt/ruby_xslt_transform_context_c.html">
+                ext/libxslt/ruby_xslt_transform_context.c
+                </a>
+        <br />
+            </td>
+        </tr>
+        </table>
+    </div>
+  <!-- banner header -->
+  <div id="bodyContent">
+  <div id="contextContent">
+    <div id="description">
+      <p>
+The libxslt gem provides Ruby language bindings for GNOME&#8217;s Libxslt
+toolkit. It is free software, released under the MIT License.
+</p>
+<p>
+Using the bindings is straightforward:
+</p>
+<pre>
+ stylesheet_doc = XML::Document.file('stylesheet_file')
+ stylesheet = XSLT::Stylesheet.new(stylesheet_doc)
+ xml_doc = XML::Document.file('xml_file')
+ result = stylesheet.apply(xml_doc)
+</pre>
+    </div>
+   </div>
+  </div>
+    <!-- if includes -->
+    <div id="section">
+    <div id="class-list">
+      <h3 class="section-bar">Classes and Modules</h3>
+      Class <a href="XSLT/Stylesheet.html" class="link">XSLT::Stylesheet</a><br />
+Class <a href="XSLT/TransformContext.html" class="link">XSLT::TransformContext</a><br />
+    </div>
+    <div id="constants-list">
+      <h3 class="section-bar">Constants</h3>
+      <div class="name-list">
+        <table summary="Constants">
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">MAX_DEPTH</td>
+          <td>=</td>
+          <td class="context-item-value">INT2NUM(xsltMaxDepth)</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">MAX_SORT</td>
+          <td>=</td>
+          <td class="context-item-value">INT2NUM(XSLT_MAX_SORT)</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">ENGINE_VERSION</td>
+          <td>=</td>
+          <td class="context-item-value">rb_str_new2(xsltEngineVersion)</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">LIBXSLT_VERSION</td>
+          <td>=</td>
+          <td class="context-item-value">INT2NUM(xsltLibxsltVersion)</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">LIBXML_VERSION</td>
+          <td>=</td>
+          <td class="context-item-value">INT2NUM(xsltLibxmlVersion)</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">XSLT_NAMESPACE</td>
+          <td>=</td>
+          <td class="context-item-value">rb_str_new2((const char*)XSLT_NAMESPACE)</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">DEFAULT_VENDOR</td>
+          <td>=</td>
+          <td class="context-item-value">rb_str_new2(XSLT_DEFAULT_VENDOR)</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">DEFAULT_VERSION</td>
+          <td>=</td>
+          <td class="context-item-value">rb_str_new2(XSLT_DEFAULT_VERSION)</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">DEFAULT_URL</td>
+          <td>=</td>
+          <td class="context-item-value">rb_str_new2(XSLT_DEFAULT_URL)</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">NAMESPACE_LIBXSLT</td>
+          <td>=</td>
+          <td class="context-item-value">rb_str_new2((const char*)XSLT_LIBXSLT_NAMESPACE)</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">NAMESPACE_NORM_SAXON</td>
+          <td>=</td>
+          <td class="context-item-value">rb_str_new2((const char*)XSLT_NORM_SAXON_NAMESPACE)</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">NAMESPACE_SAXON</td>
+          <td>=</td>
+          <td class="context-item-value">rb_str_new2((const char*)XSLT_SAXON_NAMESPACE)</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">NAMESPACE_XT</td>
+          <td>=</td>
+          <td class="context-item-value">rb_str_new2((const char*)XSLT_XT_NAMESPACE)</td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">NAMESPACE_XALAN</td>
+          <td>=</td>
+          <td class="context-item-value">rb_str_new2((const char*)XSLT_XALAN_NAMESPACE)</td>
+        </tr>
+        </table>
+      </div>
+    </div>
+    <!-- if method_list -->
+  </div>
+<div id="validator-badges">
+  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+</div>
+</body>
+</html>