rdf-raptor 0.2.1 → 0.3.0

data/README

@@ -14,7 +14,8 @@ Features
 * Requires the [Raptor][] library and utilities to be available.
 * Based on the [`rapper`][rapper] command-line utility bundled with Raptor.
 * Parses and serializes RDF data from/into the RDF/XML or Turtle formats.
-* Provides serialization format autodetection for RDF/XML and Turtle.
+* Extracts RDF statements from XHTML+RDFa documents.
+* Provides serialization format autodetection for RDF/XML, Turtle and RDFa.
 * Compatible with any operating system supported by Raptor and Ruby.
 * Compatible with MRI 1.8.x, 1.9.x and JRuby (tested with JRuby 1.4).
 
@@ -44,6 +45,14 @@ Examples
       end
     end
 
+### Extracting RDF statements from an XHTML+RDFa document
+
+    RDF::Reader.open(url = "http://bblfish.net/", :format => :rdfa, :base_uri => url) do |reader|
+      reader.each_statement do |statement|
+        puts statement.inspect
+      end
+    end
+
 ### Serializing RDF statements into an RDF/XML file
 
     data = RDF::Repository.load("http://datagraph.org/jhacker/foaf.nt")
@@ -80,6 +89,14 @@ Examples
     RDF::Format.for(:file_extension => "ttl")
     RDF::Format.for(:content_type   => "text/turtle")
 
+### Obtaining the RDFa format specification class
+
+    RDF::Format.for(:rdfa)         #=> RDF::Raptor::RDFa::Format
+    RDF::Format.for("input.html")
+    RDF::Format.for(:file_name      => "input.html")
+    RDF::Format.for(:file_extension => "html")
+    RDF::Format.for(:content_type   => "application/xhtml+xml")
+
 Documentation
 -------------
 
@@ -88,11 +105,12 @@ Documentation
 * {RDF::Raptor}
   * {RDF::Raptor::RDFXML}
   * {RDF::Raptor::Turtle}
+  * {RDF::Raptor::RDFa}
 
 Dependencies
 ------------
 
-* [RDF.rb](http://rubygems.org/gems/rdf) (>= 0.1.4)
+* [RDF.rb](http://rubygems.org/gems/rdf) (>= 0.1.9)
 * [Raptor][] (>= 1.4.16), specifically the `rapper` binary
 
 Installation

data/VERSION

@@ -1 +1 @@
-0.2.1
+0.3.0

data/lib/rdf/raptor.rb

@@ -8,6 +8,8 @@ module RDF
   #   machine-readable RDF/XML format.
   # * {RDF::Raptor::Turtle} provides support for the popular
   #   human-readable Turtle format.
+  # * {RDF::Raptor::RDFa} provides support for extracting
+  #   RDF statements from XHTML+RDFa documents.
   #
   # @example Requiring the `RDF::Raptor` module
   #   require 'rdf/raptor'
@@ -32,6 +34,13 @@ module RDF
   #   RDF::Format.for(:file_extension => "ttl")
   #   RDF::Format.for(:content_type   => "text/turtle")
   #
+  # @example Obtaining an RDFa format class
+  #   RDF::Format.for(:rdfa)       #=> RDF::Raptor::RDFa::Format
+  #   RDF::Format.for("input.html")
+  #   RDF::Format.for(:file_name      => "input.html")
+  #   RDF::Format.for(:file_extension => "html")
+  #   RDF::Format.for(:content_type   => "application/xhtml+xml")
+  #
   # @see http://rdf.rubyforge.org/
   # @see http://librdf.org/raptor/
   #
@@ -104,5 +113,6 @@ module RDF
 
     require 'rdf/raptor/rdfxml'
     require 'rdf/raptor/turtle'
+    require 'rdf/raptor/rdfa'
   end # module Raptor
 end # module RDF

data/lib/rdf/raptor/rdfa.rb

@@ -0,0 +1,56 @@
+module RDF::Raptor
+  ##
+  # RDFa support.
+  #
+  # @example Requiring the `RDF::Raptor` module
+  #   require 'rdf/raptor'
+  #
+  # @example Extracting RDF statements from an XHTML+RDFa file
+  #   RDF::Reader.open("input.html") do |reader|
+  #     reader.each_statement do |statement|
+  #       puts statement.inspect
+  #     end
+  #   end
+  #
+  # @see http://rdfa.info/
+  module RDFa
+    ##
+    # RDFa format specification.
+    #
+    # @example Obtaining an RDFa format class
+    #   RDF::Format.for(:rdfa)         #=> RDF::Raptor::RDFa::Format
+    #   RDF::Format.for("input.html")
+    #   RDF::Format.for(:file_name      => "input.html")
+    #   RDF::Format.for(:file_extension => "html")
+    #   RDF::Format.for(:content_type   => "application/xhtml+xml")
+    #
+    class Format < RDF::Raptor::Format
+      content_type     'application/xhtml+xml', :extension => :html
+      content_encoding 'utf-8'
+      rapper_format    :rdfa
+
+      reader { RDF::Raptor::RDFa::Reader }
+    end
+
+    ##
+    # RDFa extractor.
+    #
+    # @example Obtaining an RDFa reader class
+    #   RDF::Reader.for(:rdfa)         #=> RDF::Raptor::RDFa::Reader
+    #   RDF::Reader.for("input.html")
+    #   RDF::Reader.for(:file_name      => "input.html")
+    #   RDF::Reader.for(:file_extension => "html")
+    #   RDF::Reader.for(:content_type   => "application/xhtml+xml")
+    #
+    # @example Extracting RDF statements from an XHTML+RDFa file
+    #   RDF::Reader.open("input.html") do |reader|
+    #     reader.each_statement do |statement|
+    #       puts statement.inspect
+    #     end
+    #   end
+    #
+    class Reader < RDF::Raptor::Reader
+      format RDF::Raptor::RDFa::Format
+    end
+  end
+end

data/lib/rdf/raptor/version.rb

@@ -1,8 +1,8 @@
 module RDF; module Raptor
   module VERSION
     MAJOR = 0
-    MINOR = 2
-    TINY  = 1
+    MINOR = 3
+    TINY  = 0
     EXTRA = nil
 
     STRING = [MAJOR, MINOR, TINY].join('.')

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 2
-  - 1
-  version: 0.2.1
+  - 3
+  - 0
+  version: 0.3.0
 platform: ruby
 authors: 
 - Arto Bendiken
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-04-07 00:00:00 +02:00
+date: 2010-04-28 00:00:00 +02:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -27,8 +27,8 @@ dependencies:
         segments: 
         - 0
         - 1
-        - 4
-        version: 0.1.4
+        - 9
+        version: 0.1.9
   type: :development
   version_requirements: *id001
 - !ruby/object:Gem::Dependency 
@@ -69,8 +69,8 @@ dependencies:
         segments: 
         - 0
         - 1
-        - 4
-        version: 0.1.4
+        - 9
+        version: 0.1.9
   type: :runtime
   version_requirements: *id004
 description: RDF.rb plugin for parsing/serializing RDF/XML and Turtle data using the Raptor RDF Parser library.
@@ -88,6 +88,7 @@ files:
 - VERSION
 - lib/rdf/raptor/cli.rb
 - lib/rdf/raptor/ffi.rb
+- lib/rdf/raptor/rdfa.rb
 - lib/rdf/raptor/rdfxml.rb
 - lib/rdf/raptor/turtle.rb
 - lib/rdf/raptor/version.rb