module RDF::RDFa
  ##
  # RDFa format specification.
  #
  # @example Obtaining an RDFa format class
  #   RDF::Format.for(:rdfa)     #=> RDF::RDFa::Format
  #   RDF::Format.for("etc/foaf.html")
  #   RDF::Format.for(:file_name      => "etc/foaf.html")
  #   RDF::Format.for(:file_extension => "html")
  #   RDF::Format.for(:content_type   => "text/html")
  #   RDF::Format.for(:content_type   => "application/xhtml+xml")
  #
  # @example Obtaining serialization format MIME types
  #   RDF::Format.content_types      #=> {"text/html" => [RDF::RDFa::Format]}
  #
  # @example Obtaining serialization format file extension mappings
  #   RDF::Format.file_extensions    #=> {:xhtml => "application/xhtml+xml"}
  #
  # @see http://www.w3.org/TR/rdf-testcases/#ntriples
  class Format < RDF::Format
    content_type     'text/html', :extension => :html
    content_type     'application/xhtml+xml', :extension => :xhtml
    content_type     'image/svg+xml', :extension => :svg
    content_encoding 'utf-8'

    reader { RDF::RDFa::Reader }
    XMLNS = 'http://www.w3.org/1999/xhtml'  # FIXME: This or XHV or none at all?
  end

  # Aliases for RDFa::Format
  #
  # This allows the following:
  #
  # @example Obtaining an HTML format class
  #   RDF::Format.for(:html)         # RDF::RDFa::HTML
  #   RDF::Format.for(:html).reader  # RDF::RDFa::Reader
  #   RDF::Format.for(:html).writer  # RDF::RDFa::Writer
  class HTML < RDF::Format
    reader { RDF::RDFa::Reader }
    writer { RDF::RDFa::Writer }
  end

  # Aliases for RDFa::Format
  #
  # This allows the following:
  #
  # @example Obtaining an HTML format class
  #   RDF::Format.for(:xhtml)         # RDF::RDFa::XHTML
  #   RDF::Format.for(:xhtml).reader  # RDF::RDFa::Reader
  #   RDF::Format.for(:xhtml).writer  # RDF::RDFa::Writer
  class XHTML < RDF::Format
    reader { RDF::RDFa::Reader }
    writer { RDF::RDFa::Writer }
  end

  # Aliases for RDFa::Format
  #
  # This allows the following:
  #
  # @example Obtaining an HTML format class
  #   RDF::Format.for(:svg)         # RDF::RDFa::SVG
  #   RDF::Format.for(:svg).reader  # RDF::RDFa::Reader
  #   RDF::Format.for(:svg).writer  # RDF::RDFa::Writer
  class SVG < RDF::Format
    reader { RDF::RDFa::Reader }
    writer { RDF::RDFa::Writer }
  end
end