Revision as of 23:56, 4 February 2008

hAudio cheatsheet

version 0.8

haudio {1}.
- fn + (but see note).
- album + (but see note)
  - as described at haudio#Album.
- item *
  - as described at haudio#Item.
- position?
  - text.
- contributor *
  - using hCard; ( role)s * are as described at haudio#Contributor.
- published *
  - using datetime-design-pattern.
- rel-sample *
  - sample file/stream using rel-design-pattern.
- rel-enclosure *
  - full download of file/stream using rel-enclosure.
- rel-payment *
  - link to purchase process using rel-payment.
- photo *
  - using the HTML and XHTML tag (img).
- category *
  - text, sub elements MAY be expressed using the rel-tag elemental microformat.
- duration ?
  - ISO-8601 time duration using abbr-design-pattern.
- price *
  - using currency-proposal.
- description *
  - text.

bold {1}	MUST be present exactly once
italic*	OPTIONAL, and MAY occur more than once
+	MUST be present, and MAY occur more than once
?	OPTIONAL, but MUST NOT occur more than once
[square brackets]	list of common values
(parentheses)	data format
#	comment
!	awaiting documentation

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119.
All properties are classes, except for rel-sample, rel-enclosure and rel-payment which use the rel-design-pattern.
Either album or fn (or both) are required.
- If you only use fn - you are talking about an audio recording.
- If you only use album - you are talking about an audio album.
- If you use both fn and album - you are talking about an audio recording from the specified audio album.

hAudio
hAudio cheatsheet - hAudio properties.
hAudio authoring - learn how to add hAudio markup to your existing web pages.
hAudio issues - issues with the specification.
- Audio info issues - issues with the preparatory work.
hAudio brainstorming - ideas for the specification.
hAudio-history - the history of the research and development of hAudio.
Other cheatsheets: hAtom cheatsheet, hCard cheatsheet (also adr cheatsheet + geo cheatsheet), hCalendar cheatsheet, hResume cheatsheet, hReview cheatsheet, PDF cheatsheet

@@ Line 5: / Line 5: @@
 == Properties ==
-* '''haudio'''{1}.
+* '''haudio''' {1}.
 ** fn + (but see note).
-** ''album''+ (but see note)
+** album + (but see note)
 *** as described at [[haudio#Album]].
-** ''item''*
+** ''item'' *
 *** as described at [[haudio#Item]].
-** position? text.
+** position?
+*** text.
 ** ''contributor'' *
 *** using [[hCard]]; ( <code>''role''</code>)s * are as described at [[haudio#Contributor]].
@@ Line 39: / Line 40: @@
 *All properties are classes, except for [[haudio#Sample|rel-sample]], [[rel-enclosure]] and [[rel-payment]] which use the [[rel-design-pattern]].
 *Either <code>album</code> or <code>fn</code> (or both) are required.
+**If you <em style="text-transform:uppercase;">only</em> use <code>fn</code> - you are talking about an audio recording.
+**If you <em style="text-transform:uppercase;">only</em> use <code>album</code> - you are talking about an audio album.
+**If you use <em style="text-transform:uppercase;">both</em> <code>fn</code> and <code>album</code> - you are talking about an audio recording from the specified audio album.
 == Related pages ==
 {{haudio-related-pages}}
 *{{cheatsheets}}