hcalendar-profile: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
(moved XMDP profile link up the page)
(Second pass at an XMDP profile: XMLized existing description, added "attendee", "contact", and "organizer" commensurate with "Semantic Equivalents" section of the hcalendar page.)
Line 1: Line 1:
''Here's a first pass at a  
''Here's a second pass at a  
[http://dannyayers.com/microformats/hcalendar-profile XMDP Profile for hCalendar]''  
[http://dannyayers.com/microformats/hcalendar-profile XMDP Profile for hCalendar]''  


'''vcalendar''' - A container for one or more events (vevent).  This property is optional; if there is only one event then omit it
<pre>
<dl class="profile">
<dt>class</dt>
<dd><p>
  <a rel="help" href="http://www.w3.org/TR/html401/struct/global.html#adef-class">
  HTML4 definition of the 'class' attribute.</a>
  This meta data profile defines some 'class' attribute values (class names)
  and their meanings as suggested by a
  <a href="http://www.w3.org/TR/WD-htmllink-970328#profile">
  draft of "Hypertext Links in HTML"</a>.
  All values are defined according to the semantics defined in the
  <a href="http://microformats.org/wiki/hcalendar">
  hCalendar specification</a>
  and thus in
  <a href="http://www.ietf.org/rfc/rfc2445.txt">RFC 2445</a>.
  </p>
  <dl>
  <dt>vcalendar</dt>
    <dd>A container for one or more events (vevent).   
    This property is optional; if there is only one event then omit it
    See section 1. of RFC 2445.
  </dd>


'''vevent''' - A container for one event
  <dt>vevent</dt>
  <dd>A container for one event
    See section 4.6.1 of RFC 2445.
  </dd>


'''dtstart''' - Date/time of the start of the event
  <dt>dtstart</dt>
  <dd>Date/time of the start of the event.
    See section 4.8.2.4 of RFC 2445.
  </dd>


'''dtend''' - Date/time of the end of the event
  <dt>dtend</dt>
  <dd>Date/time of the end of the event.
    See section 4.8.2.2 of RFC 2445.
  </dd>


'''duration''' - Length of the event
  <dt>duration</dt>
  <dd>Length of the event.
    See section 4.8.2.5 of RFC 2445.
  </dd>


'''summary''' - Short synopsis of the event, or the title of the event, or the name of the event
  <dt>summary</dt>
  <dd>Short synopsis, title, or name of the event.
    See section 4.8.1.12 of RFC 2445.
  </dd>


'''uid''' - A globally unique identifier for the event; typically a URL is used
  <dt>uid</dt>
  <dd>A globally unique identifier for the event; typically a URL is used.
    See section 4.8.4.7 of RFC 2445.
  </dd>


'''dtstamp''' - Date/time of when the document containing information about the event was created
  <dt>dtstamp</dt>
  <dd>Date/time of when the document containing information about the event  
    was created.
    See section 4.8.7.2 of RFC 2445.
  </dd>


'''method''' - Values for this property are: PUBLISH, REQUEST, REPLY, ADD, CANCEL, REFRESH, COUNTER, or DECLINECOUNTER.  For example, a value of REQUEST indicates that a request is being made for the event to occur
  <dt>method</dt>
  <dd>Function of the event object.
    Values for this property are: PUBLISH, REQUEST, REPLY, ADD, CANCEL, REFRESH,  
    COUNTER, or DECLINECOUNTER.  For example, a value of REQUEST indicates that a  
    request is being made for the event to occur.
    See section 4.7.2 of RFC 2445.
  </dd>


'''category''' - Common values are: MEETING, APPOINTMENT, CONFERENCE, EXPO.  Note: this property may be repeated (an event may belong in several categories)
  <dt>category</dt>
  <dd>Category of the event object.   
    Note: this property may be repeated (an event may belong in several categories).
    Common values are: MEETING, APPOINTMENT, CONFERENCE, EXPO.
    See section 4.8.1.2 of RFC 2445.
  </dd>


'''location''' - Tells where the event is to be held
  <dt>location</dt>
  <dd>Tells where the event is to be held.  May be represented by nested
    <a href="http://microformats.org/wiki/hcard">hCard record</a>, 
    <a href="http://microformats.org/wiki/adr">adr record</a>, 
    <a href="http://microformats.org/wiki/geo">geo record</a>, or combination thereof. 
    See sections 4.8.1.7 and 4.8.1.6 of RFC 2445.
  </dd>


'''url''' - A URL to a page that contains the definitive/preferred information about an event; uid and url are typically the same
  <dt>url</dt>
  <dd>A URL to a page that contains the definitive/preferred information about an event;
    UID and URL are typically the same
    See section 4.8.4.6 of RFC 2445.
  </dd>


'''description''' - A more detailed synopsis of the event than that provided by summary
  <dt>description</dt>
  <dd>A more detailed synopsis of the event than that provided by summary
    See section 4.8.1.5 of RFC 2445.
  </dd>


'''last-modified''' - Date/time the information about the event was updated
  <dt>last-modified</dt>
  <dd>Date/time the information about the event was updated
    See section 4.8.7.3 of RFC 2445.
  </dd>


'''status''' - Values are: TENTATIVE, CONFIRMED, CANCELLED
  <dt>status</dt>
  <dd>Status of the calendar event.  Values are: TENTATIVE, CONFIRMED, CANCELLED
    See section 4.8.1.11 of RFC 2445.
  </dd>


'''class''' -  Access classification of the event information; values are: PUBLIC, PRIVATE, CONFIDENTIAL
  <dt>class</dt>
  <dd>Access classification of the event information;
    Values are: PUBLIC, PRIVATE, CONFIDENTIAL
    See section 4.8.1.3 of RFC 2445.
  </dd>
 
  <dt>attendee</dt>
  <dd>An individual invited to attend the event; 
    An event container may contain more than one attendee record;
    May be represented by nested <a href="http://microformats.org/wiki/hcard">hCard record</a>. 
    See section 4.8.4.1 of RFC 2445.
  </dd>
 
  <dt>contact</dt>
  <dd>Contact information associated with the event; 
    May be represented by nested <a href="http://microformats.org/wiki/hcard">hCard record</a>. 
    See section 4.8.4.2 of RFC 2445.
  </dd>
 
  <dt>organizer</dt>
  <dd>The organizer associated with the event; 
    May be represented by nested <a href="http://microformats.org/wiki/hcard">hCard record</a>. 
    See section 4.8.4.3 of RFC 2445.
  </dd>
 
  </dl>
</dd>
</dl>
 
</pre>


== Related Pages ==
== Related Pages ==
{{hcalendar-related-pages}}
{{hcalendar-related-pages}}

Revision as of 08:49, 24 April 2007

Here's a second pass at a XMDP Profile for hCalendar

<dl class="profile">
 <dt>class</dt>
 <dd><p>
   <a rel="help" href="http://www.w3.org/TR/html401/struct/global.html#adef-class">
   HTML4 definition of the 'class' attribute.</a>
   This meta data profile defines some 'class' attribute values (class names) 
   and their meanings as suggested by a 
   <a href="http://www.w3.org/TR/WD-htmllink-970328#profile">
   draft of "Hypertext Links in HTML"</a>.
   All values are defined according to the semantics defined in the 
   <a href="http://microformats.org/wiki/hcalendar">
   hCalendar specification</a> 
   and thus in 
   <a href="http://www.ietf.org/rfc/rfc2445.txt">RFC 2445</a>.
  </p>
  <dl>
   <dt>vcalendar</dt>
    <dd>A container for one or more events (vevent).  
     This property is optional; if there is only one event then omit it.  
     See section 1. of RFC 2445.
   </dd>

   <dt>vevent</dt>
   <dd>A container for one event.  
    See section 4.6.1 of RFC 2445.
   </dd>

   <dt>dtstart</dt>
   <dd>Date/time of the start of the event.
    See section 4.8.2.4 of RFC 2445.
   </dd>

   <dt>dtend</dt>
   <dd>Date/time of the end of the event.
    See section 4.8.2.2 of RFC 2445.
   </dd>

   <dt>duration</dt>
   <dd>Length of the event.
    See section 4.8.2.5 of RFC 2445.
   </dd>

   <dt>summary</dt>
   <dd>Short synopsis, title, or  name of the event.
    See section 4.8.1.12 of RFC 2445.
   </dd>

   <dt>uid</dt>
   <dd>A globally unique identifier for the event; typically a URL is used.
    See section 4.8.4.7 of RFC 2445.
   </dd>

   <dt>dtstamp</dt>
   <dd>Date/time of when the document containing information about the event 
    was created.
    See section 4.8.7.2 of RFC 2445.
   </dd>

   <dt>method</dt>
   <dd>Function of the event object.
    Values for this property are: PUBLISH, REQUEST, REPLY, ADD, CANCEL, REFRESH, 
    COUNTER, or DECLINECOUNTER.  For example, a value of REQUEST indicates that a 
    request is being made for the event to occur.
    See section 4.7.2 of RFC 2445.
   </dd>

   <dt>category</dt>
   <dd>Category of the event object.  
    Note: this property may be repeated (an event may belong in several categories).
    Common values are: MEETING, APPOINTMENT, CONFERENCE, EXPO.
    See section 4.8.1.2 of RFC 2445.
   </dd>

   <dt>location</dt>
   <dd>Tells where the event is to be held.  May be represented by nested 
    <a href="http://microformats.org/wiki/hcard">hCard record</a>,  
    <a href="http://microformats.org/wiki/adr">adr record</a>,  
    <a href="http://microformats.org/wiki/geo">geo record</a>, or combination thereof.  
    See sections 4.8.1.7 and 4.8.1.6 of RFC 2445.
   </dd>

   <dt>url</dt>
   <dd>A URL to a page that contains the definitive/preferred information about an event;  
    UID and URL are typically the same.  
    See section 4.8.4.6 of RFC 2445.
   </dd>

   <dt>description</dt>
   <dd>A more detailed synopsis of the event than that provided by summary.  
    See section 4.8.1.5 of RFC 2445.
   </dd>

   <dt>last-modified</dt>
   <dd>Date/time the information about the event was updated.  
    See section 4.8.7.3 of RFC 2445.
   </dd>

   <dt>status</dt>
   <dd>Status of the calendar event.  Values are: TENTATIVE, CONFIRMED, CANCELLED.  
    See section 4.8.1.11 of RFC 2445.
   </dd>

   <dt>class</dt>
   <dd>Access classification of the event information;  
    Values are: PUBLIC, PRIVATE, CONFIDENTIAL.  
    See section 4.8.1.3 of RFC 2445.
   </dd>

   <dt>attendee</dt>
   <dd>An individual invited to attend the event;  
    An event container may contain more than one attendee record; 
    May be represented by nested <a href="http://microformats.org/wiki/hcard">hCard record</a>.  
    See section 4.8.4.1 of RFC 2445.
   </dd>

   <dt>contact</dt>
   <dd>Contact information associated with the event;  
    May be represented by nested <a href="http://microformats.org/wiki/hcard">hCard record</a>.  
    See section 4.8.4.2 of RFC 2445.
   </dd>

   <dt>organizer</dt>
   <dd>The organizer associated with the event;  
    May be represented by nested <a href="http://microformats.org/wiki/hcard">hCard record</a>.  
    See section 4.8.4.3 of RFC 2445.
   </dd>

  </dl>
 </dd>
</dl>

Related Pages

This specification is a work in progress. As additional aspects are discussed, understood, and written, they will be added. These thoughts, issues, and questions are kept in separate pages.