cheat sheets.

Selectors

* 			any element
E 			an element of type E
E.warning		an E element whose class is "warning" (the document language
specifies how class is determined).
E#myid			an E element with ID equal to "myid".
E[foo]			an E element with a "foo" attribute
E[foo="bar"]    	an E element whose "foo" attribute value is exactly equal to
"bar"
E[foo~="bar"]   	an E element whose "foo" attribute value is a list of
space-separated values, one of which is exactly equal to "bar"
E[foo^="bar"]   	an E element whose "foo" attribute value begins exactly with
the string "bar"
E[foo$="bar"]   	an E element whose "foo" attribute value ends exactly with the
string "bar"
E[foo*="bar"]   	an E element whose "foo" attribute value contains the substring
"bar"
E[hreflang|="en"]       an E element whose "hreflang" attribute has a
hyphen-separated list of values beginning (from the left) with "en"
E:root			an E element, root of the document
E:nth-child(n)		an E element, the n-th child of its parent
E:nth-last-child(n)     an E element, the n-th child of its parent, counting
from the last one
E:nth-of-type(n)        an E element, the n-th sibling of its type
E:nth-last-of-type(n)   an E element, the n-th sibling of its type, counting
from the last one
E:first-child           an E element, first child of its parent
E:last-child            an E element, last child of its parent
E:first-of-type         an E element, first sibling of its type
E:last-of-type          an E element, last sibling of its type
E:only-child            an E element, only child of its parent
E:only-of-type          an E element, only sibling of its type
E:empty                 an E element that has no children (including text nodes)
E:not(s)                an E element that does not match simple selector s
E F                     an F element descendant of an E element
E > F                   an F element child of an E element
E + F                   an F element immediately preceded by an E element
E ~ F                   an F element preceded by an E element 

Scraper.scrape(source, options?) => result

  Scrapes source and returns the result. Source is one of:
    String        HTML content: parse and scrape.
    URI           Page URL: read, parse and scrape.
    HTML::Node    Element or document, for use with structures.

  Options for reading: :last_modified, :etag, :redirect_limit, :user_agent,
  :timeout.
  Options for parsing: :root_element, :parser, :parser_options.

process(selector, *values, extractor?) { |element| .... }
process(symbol?, selector, *values, extractor?) { |element| ... }

  Use selector to select elements, and extractor to extract and store values.
  Pass each selected element to the block. Block can be used instead of or in
  combination with extractors.

  Extract value from (see more options in API):
    :element      Element itself
    :text         Text value of element
    Class         Another scraper
    "elem"        Element if name matches
    "@attr"       Attribute if specified
    "elem@attr"   Attribute if specified on element
    [value, ...]  First value that matches

  Extract value to (more options in API):
    symbol        Instance variable (e.g. :title to @title)
    symbol[]      Array instance variable (e.g. "links[]")
    :skip         If true, do not further process this element

  Attribute accessors defined for each symbol used.
  If first argument is symbol, uses that name to replace any other processing
  rule with same name.

process_first(selector, *values, extractor?) { |element| .... }
process_first(symbol?, selector, *values, extractor?) { |element| ... }

  Similar to process but only processes the first selected element (if more than
  one).

result(*symbols)

  Specifies which instance variables to return. One symbol: return value of that
  variable. Multiple symbols: return object with suitable accessors.

array(*symbols)

  Specifies which instance variables are arrays. Otherwise, stores only last
  extracted value.

selector(symbol, selector, *values)
selector(symbol?, selector, *values) { |elements| ... }

  Defines selector method with the given name (symbol) that takes an element as
  argument and returns array of selected elements, empty if no elements
  selected. Defines first_ method that returns the first selected element or
  nil.

Instance Methods

  extracted         True if any processing rule returned true (also extracted =
  true/false).
  skip(element?)    Do not further process element. See also :skip=>true.
  stop()            Stop processing.
  prepare(document) Called on document before any processing.
  collect()         Called after processing is done.
  result()          Called to return result. By default returns self if
  extracted. You can override method, or redefine with class method result.