rdf-microdata 0.1.1 → 0.1.2

data/README

@@ -15,10 +15,39 @@ Install with 'gem install rdf-microdata'
 
 ## Usage
 
-### Reading RDF data in the RDFa format
+### Reading RDF data in the Microdata format
 
     graph = RDF::Graph.load("etc/foaf.html", :format => :microdata)
 
+### Generating RDF friendly URIs from terms
+As defined, Microdata creates ugly (and even illegal) URIs for `@itemprop` entries that are a simple
+term, and not already a URI. {RDF::RDFa::Reader} implements a `:rdf\_terms` option which uses an alternative
+process for creating URIs from terms: If the `@itemprop` is included within an item having an `@itemtype`,
+the URI of the `@itemtype` will be used for generating a term URI. The type URI will be trimmed following
+the last '#' or '/' character, and the term will be appended to the resulting URI. This is in keeping
+with standard convention for defining properties and classes within an RDFS or OWL vocabulary.
+
+For example:
+
+    <div itemscope itemtype="http://schema.org/Person">
+      My name is <span itemprop="name">Gregg</span>
+    </div>
+
+Without the `:rdf\_terms` option, this would create the following statements:
+
+    @prefix md: <http://www.w3.org/1999/xhtml/microdata#> .
+    @prefix schema: <http://schema.org/> .
+    <> md:item [
+      a schema:Person;
+      <http://www.w3.org/1999/xhtml/microdata#http://schema.org/Person%23:name> "Gregg"
+    ] .
+
+With the `:rdf\_terms` option, this becomes:
+
+    @prefix md: <http://www.w3.org/1999/xhtml/microdata#> .
+    @prefix schema: <http://schema.org/> .
+    <> md:item [ a schema:Person; schema:name "Gregg" ] .
+
 ## Dependencies
 * [RDF.rb](http://rubygems.org/gems/rdf) (>= 0.3.3)
 * [Nokogiri](http://rubygems.org/gems/nokogiri) (>= 1.3.3)

data/VERSION

@@ -1 +1 @@
-0.1.1
+0.1.2

data/lib/rdf/microdata/reader.rb

@@ -39,6 +39,8 @@ module RDF::Microdata
     #   whether to intern all parsed URIs
     # @option options [#to_s]    :base_uri     (nil)
     #   the base URI to use when resolving relative URIs
+    # @option options [Boolean]  :rdf_terms     (false)
+    #   Generate URIs for itemprop terms based on namespace of itemtype
     # @option options [Array] :debug
     #   Array to place debug messages
     # @return [reader]
@@ -238,7 +240,6 @@ module RDF::Microdata
         add_triple(el, base, RDF::DC.source, object)
       end
 
-
       # 5. Let memory be a mapping of items to subjects, initially empty.
       # 6. For each element that is also a top-level microdata item, run the following steps:
       #    * Generate the triples for the item. Pass a reference to memory as the item/subject list.
@@ -287,7 +288,7 @@ module RDF::Microdata
       
       # 3. If item has an item type and that item type is an absolute URL, let type be that item type.
       #    Otherwise, let type be the empty string.
-      type = uri(item.attribute('itemtype'))
+      rdf_type = type = uri(item.attribute('itemtype'))
       type = '' unless type.absolute?
       
       if type != ''
@@ -298,7 +299,7 @@ module RDF::Microdata
         type += ':' unless type.to_s.match(/\#:/)
       elsif fallback_type
         add_debug(item, "gentrips(5.2): fallback_type=#{fallback_type}, fallback_name=#{fallback_name}")
-        type = fallback_type
+        rdf_type = type = fallback_type
         # 5.2. If type does not contain a U+0023 NUMBER SIGN character (#), then append a # to type.
         type += '#' unless type.to_s.include?('#')
         # 5.3. If type does not have a : after its #, append a : to type.
@@ -335,6 +336,10 @@ module RDF::Microdata
 
           predicate = if name_uri.absolute?
             name_uri
+          elsif @options[:rdf_terms]
+            # Use the URI of the type to create URIs for @itemprop terms
+            add_debug(element, "gentrips: rdf_type=#{rdf_type}")
+            predicate = RDF::URI(rdf_type.to_s.sub(/(?<=[\/\#])[^\/\#]*$/, name))
           elsif !name.include?(':')
             s = type.to_s
             s += '%20' unless s[-1,1] == ':'

metadata

@@ -1,104 +1,100 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: rdf-microdata
-version: !ruby/object:Gem::Version 
+version: !ruby/object:Gem::Version
+  version: 0.1.2
   prerelease: 
-  version: 0.1.1
 platform: ruby
-authors: 
+authors:
 - Gregg Kellogg
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2011-07-13 00:00:00 -07:00
+date: 2011-07-23 00:00:00.000000000 -07:00
 default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
+dependencies:
+- !ruby/object:Gem::Dependency
   name: rdf
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  requirement: &2168962420 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
         version: 0.3.3
   type: :runtime
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: nokogiri
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  version_requirements: *2168962420
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: &2168961960 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
         version: 1.4.4
   type: :runtime
-  version_requirements: *id002
-- !ruby/object:Gem::Dependency 
-  name: yard
   prerelease: false
-  requirement: &id003 !ruby/object:Gem::Requirement 
+  version_requirements: *2168961960
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: &2168988620 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
         version: 0.6.0
   type: :development
-  version_requirements: *id003
-- !ruby/object:Gem::Dependency 
-  name: rspec
   prerelease: false
-  requirement: &id004 !ruby/object:Gem::Requirement 
+  version_requirements: *2168988620
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &2168988160 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
         version: 2.5.0
   type: :development
-  version_requirements: *id004
-- !ruby/object:Gem::Dependency 
-  name: rdf-spec
   prerelease: false
-  requirement: &id005 !ruby/object:Gem::Requirement 
+  version_requirements: *2168988160
+- !ruby/object:Gem::Dependency
+  name: rdf-spec
+  requirement: &2168987700 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
         version: 0.3.2
   type: :development
-  version_requirements: *id005
-- !ruby/object:Gem::Dependency 
-  name: rdf-n3
   prerelease: false
-  requirement: &id006 !ruby/object:Gem::Requirement 
+  version_requirements: *2168987700
+- !ruby/object:Gem::Dependency
+  name: rdf-n3
+  requirement: &2168987240 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
         version: 0.3.3
   type: :development
-  version_requirements: *id006
-- !ruby/object:Gem::Dependency 
-  name: rdf-isomorphic
   prerelease: false
-  requirement: &id007 !ruby/object:Gem::Requirement 
+  version_requirements: *2168987240
+- !ruby/object:Gem::Dependency
+  name: rdf-isomorphic
+  requirement: &2168986780 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
         version: 0.3.4
   type: :development
-  version_requirements: *id007
+  prerelease: false
+  version_requirements: *2168986780
 description: Microdata reader for Ruby.
 email: public-rdf-ruby@w3.org
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
 - AUTHORS
 - README
 - UNLICENSE
@@ -111,31 +107,28 @@ files:
 - lib/rdf/microdata.rb
 has_rdoc: false
 homepage: http://github.com/gkellogg/rdf-microdata
-licenses: 
+licenses:
 - Public Domain
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
       version: 1.8.1
-required_rubygems_version: !ruby/object:Gem::Requirement 
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: rdf-microdata
 rubygems_version: 1.6.2
 signing_key: 
 specification_version: 3
 summary: Microdata reader for Ruby.
 test_files: []
-