W3C

GRDDL Data Views: Getting Started, Learning More

GRDDL is a technique for gleaning resource descriptions from dialects of languages. It's a way of extracting Semantic Web data in RDF from XML formats (especially XHTML dialects or microformats) via transformations identified by URIs and typically expressed in XSLT. For full details, see the GRDDL specification.

Note: The GRDDL specification is a W3C Recommendation. W3C welcomes comments by email, especially comments that reflect implementation experience.

To use GRDDL:

  1. If you're using a dialect (hDoap, Site Summaries, Embedded RDF, etc.) that already has an established GRDDL-compatible profile:
    1. Add the profile attribute:
      <html xmlns="http://www.w3.org/1999/xhtml">
        <head profile="http://purl.org/stuff/hdoap/profile">
          <title>My Project</title>
        </head>
          ...
      </html>
      
    2. Look at the data expressed as RDF using the online GRDDL demo service, and if you like, check its output with the W3C RDF Validation service, or with a tool more customized for your data, like the FOAF explorer.
    3. Let the GRDDL Working Group know how you're using GRDDL by sending mail to the public-grddl-comments list.
  2. If you're using an XHTML dialect (Dublin Core encoding, GeoURL markup, etc.) that has an existing transformation (dc-extract.xsl, grokGeoURL.xsl) ...
    1. Make links from your XHTML data to the transformation, using the transformation link type:
      <html xmlns="http://www.w3.org/1999/xhtml">
        <head profile="http://www.w3.org/2003/g/data-view">
          <title>Some Document</title>
          <link rel="transformation"
             href="http://www.w3.org/2000/06/dc-extract/dc-extract.xsl" />
          <meta name="DC.Subject"
             content="ADAM; Simple Search; Index+; prototype" />
          ...
        </head>
        ...
      </html>
      
    2. Reference the GRDDL profile to make it clear what that transformation link type means:
      <html xmlns="http://www.w3.org/1999/xhtml">
        <head profile="http://www.w3.org/2003/g/data-view">
          <title>Some Document</title>
          ...
      
    3. Check your data and let us know how it went as above.

Questions?

If you just want to use GRDDL, that's all you need to know. If you're curious to learn more, read on...

GRDDL Namespace and Metadata Profile Reference

This document, http://www.w3.org/2003/g/data-view, is a metadata profile in the sense of the HTML specification, in section 7.4.4.3 Meta data profiles.

The following term is introduced here as an XHTML link relationship name and RDF property name:

The following terms are introduced here as RDF properties:

The following terms are bound to concepts from existing standards:

We provide a sample GRDDL/XHTML implementation, and a more complete sample GRDDL implementation and a technical specification, Gleaning Resource Descriptions from Dialects of Languages (GRDDL), as a specification.

References

Acknowledgements and Colophon

This document uses Embedded RDF to encode Description of a Project (DOAP) data as well as RDF Schema data and one or two RDDL properties. We have moved away from the RDDL syntax itself.

This document was inspired by the XFN getting started page. Previous versions used XMDP (with grokXMDP.xsl), but in documenting domains and ranges of properties, maintaining the XMDP convention of ids on the dt rather than the dd element were too awkward to maintain.


Dan Connolly for the GRDDL Working Group
$Revision: 1.47 $ of $Date: 2007/10/31 02:59:16 $ by $Author: connolly $