XSPF v1 Notes and Errata: Difference between revisions

From XiphWiki
Jump to navigation Jump to search
m (Links pointed to the draft not final version by mistake)
Line 54: Line 54:


== 4.1.1.2.12.2 content ==
== 4.1.1.2.12.2 content ==
This paragraph describes the content of [http://www.xspf.org/orig-xspf-v1.html#rfc.section.4.1.1.2.12.2 ''playlist.meta''].
This paragraph describes the content of [http://www.xspf.org/xspf-v1.html#rfc.section.4.1.1.2.12.2 ''playlist.meta''].
It also reads "xspf:playlist elements MAY contain exactly one" which
It also reads "xspf:playlist elements MAY contain exactly one" which
does not make sense for the content of an element and can be safely ignored.
does not make sense for the content of an element and can be safely ignored.


== 4.1.1.2.14.1.1.1.12.2 content ==
== 4.1.1.2.14.1.1.1.12.2 content ==
This paragraph describes the content of [http://www.xspf.org/orig-xspf-v1.html#rfc.section.4.1.1.2.14.1.1.1.12.2 ''playlist.trackList.track.meta''].
This paragraph describes the content of [http://www.xspf.org/xspf-v1.html#rfc.section.4.1.1.2.14.1.1.1.12.2 ''playlist.trackList.track.meta''].
It also reads "xspf:playlist elements MAY contain exactly one" which
It also reads "xspf:playlist elements MAY contain exactly one" which
does not make sense for the content of an element and can be safely ignored.
does not make sense for the content of an element and can be safely ignored.

Revision as of 15:15, 2 May 2007

This page lists errata of the XSPF version 1 document and also gives advice on using and understanding XSPF.

Notes

<trackList> and <trackNum> spelling

Please not that trackList and trackNum elements MUST NOT be written in all lowercase since XSPF is case-sensitive. These two are the only elements containing capital letters so just remember trackList and trackNum and your XSPF will be fine.

Absolute vs. relative URIs in key attibutes

The attributes rel (<meta> and <link>) and application (<extension>) are by XSPF v1 specification allowed to hold relative URIs. For example this meta element is legal in XSPF v1:

<meta rel="playCount">14</meta>

While this might look elegant it comes with several drawbacks:

  • You might easily forget that this string is a URI and include non-URI characters like spaces by mistake (e.g. rel="play count" is not valid)
  • You lose the namespace concept: nobody will know what or whom this key belongs to or came from

For these reasons it is strongly recommended to use absolute URIs as keys instead:

<meta rel="http://example.com/track/meta/playCount/1/0/">14</meta>

Version information in key attributes

When defining you own extensions to XSPF you will have to choose an application URI for your onw extensions:

<extension application="http://example.com/myext/">
  ..
</extension>

Please consider including version information in your application URIs and increase it whenever the structure of your extension changes:

<extension application="http://example.com/xspf/track/1/0/">
  ..
</extension>

This enables others to properly distinct different versions of your extensions without the need to do version guessing. Adding version information to rel of <meta> and <link> is a good idea as well:

<meta rel="http://example.com/track/meta/playCount/1/0/">14</meta>

Element order

TODO

Whitespace

TODO

Errata

4.1.1.2.12.2 content

This paragraph describes the content of playlist.meta. It also reads "xspf:playlist elements MAY contain exactly one" which does not make sense for the content of an element and can be safely ignored.

4.1.1.2.14.1.1.1.12.2 content

This paragraph describes the content of playlist.trackList.track.meta. It also reads "xspf:playlist elements MAY contain exactly one" which does not make sense for the content of an element and can be safely ignored.