mida 0.1.0
Mida
Description
A Microdata parser and extractor library for ruby. This is based on the latest Published version of the Microdata Specification dated 5th April 2011.
Installation
With Ruby and Rubygems:
gem install mida
Requirements:
-
Nokogiri
Usage
The following examples assume that you have required mida and open-uri.
Extracting Microdata from a page
All the Microdata is extracted from a page when a new Mida::Document instance is created.
To extract all the Microdata from a webpage:
url = 'http://example.com'
open(url) {|f| doc = Mida::Document.new(f, url)}
The top-level Items will be held in an array accessible via doc.items.
To simply list all the top-level Items that have been found:
puts doc.items
Searching
If you want to search for an Item that has a specific itemtype/vocabulary this can be done with the search method.
To return all the Items that use one of Google’s Review vocabularies:
doc.search(%r{http://data-vocabulary\.org.*?review.*?}i)
Inspecting an Item
Each Item is a Mida::Item instance and has three main methods of interest, type, properties and id.
To find out the itemtype of the Item:
puts doc.items.first.type
To find out the itemid of the Item:
puts doc.items.first.id
Properties are returned as a hash containing name/values pairs. The values will be an array of either String or Mida::Item instances.
To see the properties of the Item:
puts doc.items.first.properties
Bugs/Feature Requests
If you find a bug or want to make a feature request, please report it at the Mida project’s issues tracker on github.
License
Copyright © 2011 Lawrence Woodman. This software is licensed under the MIT License. Please see the file, LICENSE.rdoc, for details.
Gemfile:
=
install:
=
Owners:
Authors:
-
Lawrence Woodman