[xiph-commits] r9879 - websites/xspf.org
lgonze at svn.xiph.org
lgonze at svn.xiph.org
Tue Aug 30 22:43:55 PDT 2005
Author: lgonze
Date: 2005-08-30 22:43:49 -0700 (Tue, 30 Aug 2005)
New Revision: 9879
Added:
websites/xspf.org/quickstart.html
Modified:
websites/xspf.org/about.html
websites/xspf.org/apps.html
websites/xspf.org/index.html
websites/xspf.org/list.html
websites/xspf.org/schema.html
websites/xspf.org/specs.html
Log:
Add quickstart document.
Modified: websites/xspf.org/about.html
===================================================================
--- websites/xspf.org/about.html 2005-08-31 05:43:12 UTC (rev 9878)
+++ websites/xspf.org/about.html 2005-08-31 05:43:49 UTC (rev 9879)
@@ -7,7 +7,7 @@
<body>
<div id="container">
<div id="title"></div>
-<div id="menu"><a class="menuItem" href="index.html">home</a> | <a class="menuItem" href="specs.html">specs</a> | <a class="menuItem" href="schema.html">schema</a> | <a class="menuItem" href="apps.html">applications</a> | <a class="menuItem" href="http://lists.musicbrainz.org/mailman/listinfo/playlist">mailing list</a> | <a class="menuItem" href="http://wiki.xiph.org/index.php/XSPF">developer wiki</a> | <span class="selectedMenuItem">about us</span></div>
+<div id="menu"><a class="menuItem" href="index.html">home</a> | <a class="menuItem" href="quickstart.html">quick start</a> | <a class="menuItem" href="specs.html">specs</a> | <a class="menuItem" href="schema.html">schema</a> | <a class="menuItem" href="apps.html">applications</a> | <a class="menuItem" href="http://lists.musicbrainz.org/mailman/listinfo/playlist">mailing list</a> | <a class="menuItem" href="http://wiki.xiph.org/index.php/XSPF">developer wiki</a> | <span class="selectedMenuItem">about us</span></div>
<div class="main">
<h1>About Us</h1>
<p>Our group did what it did because we wanted to bring playlist formats up to snuff. There was no standards organization and no commercial sponsorship.</p>
Modified: websites/xspf.org/apps.html
===================================================================
--- websites/xspf.org/apps.html 2005-08-31 05:43:12 UTC (rev 9878)
+++ websites/xspf.org/apps.html 2005-08-31 05:43:49 UTC (rev 9879)
@@ -9,7 +9,7 @@
<body>
<div id="container">
<div id="title"></div>
-<div id="menu"><a class="menuItem" href="index.html">home</a> | <a class="menuItem" href="specs.html">specs</a> | <a class="menuItem" href="schema.html">schema</a> | <span class="selectedMenuItem">applications</span> | <a class="menuItem" href="http://lists.musicbrainz.org/mailman/listinfo/playlist">mailing list</a> | <a class="menuItem" href="http://wiki.xiph.org/index.php/XSPF">developer wiki</a> | <a class="menuItem" href="about.html">about us</a></div>
+<div id="menu"><a class="menuItem" href="index.html">home</a> | <a class="menuItem" href="quickstart.html">quick start</a> | <a class="menuItem" href="specs.html">specs</a> | <a class="menuItem" href="schema.html">schema</a> | <span class="selectedMenuItem">applications</span> | <a class="menuItem" href="http://lists.musicbrainz.org/mailman/listinfo/playlist">mailing list</a> | <a class="menuItem" href="http://wiki.xiph.org/index.php/XSPF">developer wiki</a> | <a class="menuItem" href="about.html">about us</a></div>
<div class="main">
<h1>Applications</h1>
<dl>
Modified: websites/xspf.org/index.html
===================================================================
--- websites/xspf.org/index.html 2005-08-31 05:43:12 UTC (rev 9878)
+++ websites/xspf.org/index.html 2005-08-31 05:43:49 UTC (rev 9879)
@@ -9,7 +9,7 @@
<body>
<div id="container">
<div id="title"></div>
-<div id="menu"><span class="selectedMenuItem">home</span> | <a class="menuItem" href="specs.html">specs</a> | <a class="menuItem" href="schema.html">schema</a> | <a class="menuItem" href="apps.html">applications</a> | <a class="menuItem" href="http://lists.musicbrainz.org/mailman/listinfo/playlist">mailing list</a> | <a class="menuItem" href="http://wiki.xiph.org/index.php/XSPF">developer wiki</a> | <a class="menuItem" href="about.html">about us</a></div>
+<div id="menu"><span class="selectedMenuItem">home</span> | <a class="menuItem" href="quickstart.html">quick start</a> | <a class="menuItem" href="specs.html">specs</a> | <a class="menuItem" href="schema.html">schema</a> | <a class="menuItem" href="apps.html">applications</a> | <a class="menuItem" href="http://lists.musicbrainz.org/mailman/listinfo/playlist">mailing list</a> | <a class="menuItem" href="http://wiki.xiph.org/index.php/XSPF">developer wiki</a> | <a class="menuItem" href="about.html">about us</a></div>
<div class="main">
<h1>XML Shareable Playlist Format ("spiff")</h1>
<p>XSPF is the XML format for sharing playlists.</p>
Modified: websites/xspf.org/list.html
===================================================================
--- websites/xspf.org/list.html 2005-08-31 05:43:12 UTC (rev 9878)
+++ websites/xspf.org/list.html 2005-08-31 05:43:49 UTC (rev 9879)
@@ -9,7 +9,7 @@
<body>
<div id="container">
<div id="title"></div>
-<div id="menu"><a class="menuItem" href="index.html">home</a> | <a class="menuItem" href="specs.html">specs</a> | <a class="menuItem" href="schema.html">schema</a> | <a class="menuItem" href="apps.html">applications</a> | <span class="selectedMenuItem">mailing list</span> | <a class="menuItem" href="http://wiki.xiph.org/index.php/XSPF">developer wiki</a> | <a class="menuItem" href="about.html">about us</a></div>
+<div id="menu"><a class="menuItem" href="index.html">home</a> | <a class="menuItem" href="quickstart.html">quick start</a> | <a class="menuItem" href="specs.html">specs</a> | <a class="menuItem" href="schema.html">schema</a> | <a class="menuItem" href="apps.html">applications</a> | <span class="selectedMenuItem">mailing list</span> | <a class="menuItem" href="http://wiki.xiph.org/index.php/XSPF">developer wiki</a> | <a class="menuItem" href="about.html">about us</a></div>
<div class="main">
<h1>Mailing List</h1>
<p>The <a href="http://lists.musicbrainz.org/mailman/listinfo/playlist">playlist mailing list</a> is dedicated to discussing any and all issues relating to XSPF. This mailing list also has an <a href="http://lists.musicbrainz.org/pipermail/playlist/">archive</a>.</p>
Added: websites/xspf.org/quickstart.html
===================================================================
--- websites/xspf.org/quickstart.html 2005-08-31 05:43:12 UTC (rev 9878)
+++ websites/xspf.org/quickstart.html 2005-08-31 05:43:49 UTC (rev 9879)
@@ -0,0 +1,150 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<meta name="generator" content="HTML Tidy for Cygwin (vers 1st September 2004), see www.w3.org" />
+<title>XSPF Quick Start Guide</title>
+<link rel="stylesheet" href="css/main.css" type="text/css" />
+<style type="text/css">
+/*<![CDATA[*/
+pre {
+ margin-left: 3em;
+ background-color: lightyellow;
+}
+span.callout {
+background-color: #eeeeee;
+color: red;
+}
+/*]]>*/
+</style>
+</head>
+<body>
+<div id="container">
+<div id="title"></div>
+<div id="menu"><a class="menuItem" href="index.html">home</a> | <span class="selectedMenuItem">quick start</span> | <a class="menuItem" href="specs.html">specs</a> | <a class="menuItem" href="schema.html">schema</a> | <a class="menuItem" href="apps.html">applications</a> | <a class="menuItem" href="http://lists.musicbrainz.org/mailman/listinfo/playlist">mailing list</a> | <a class="menuItem" href="http://wiki.xiph.org/index.php/XSPF">developer wiki</a> | <a class="menuItem" href="about.html">about us</a></div>
+<div class="main">
+<h1>XSPF Quick Start Guide</h1>
+<div>This document is a guide for people just encountering XSPF for the first time.</div>
+<h2>What is XSPF?</h2>
+<ul>
+<li>A playlist format like M3U</li>
+<li>XML like RSS</li>
+<li>Pronounced <cite>spiff</cite></li>
+<li>MIME type <code>application/xspf+xml</code></li>
+</ul>
+<h2>What does XSPF look like?</h2>
+<div>A very simple document looks like this:</div>
+<div>
+<pre>
+<?xml version="1.0" encoding="UTF-8"?>
+<playlist version="1" xmlns="http://xspf.org/ns/0/">
+ <trackList>
+ <track><location>file:///mp3s/song_1.mp3</location></track>
+ <track><location>file:///mp3s/song_2.mp3</location></track>
+ <track><location>file:///mp3s/song_3.mp3</location></track>
+ </trackList>
+</playlist>
+</pre></div>
+<div>Notice that the file names are <em>URIs</em>, meaning that you could pass them to a web browser. Also notice that it's <code>track<em>L</em>ist</code>, with an uppercase <cite>L</cite>, not <code>track<em>l</em>ist</code>, with a lowercase <cite>l</cite>.</div>
+<div>The following playlist is just the same except that the files are out on the web:</div>
+<div>
+<pre>
+<?xml version="1.0" encoding="UTF-8"?>
+<playlist version="1" xmlns="http://xspf.org/ns/0/">
+ <trackList>
+ <track><location><span class="callout">http://</span>example.com/song_1.mp3</location></track>
+ <track><location><span class="callout">http://</span>example.com/song_2.mp3</location></track>
+ <track><location><span class="callout">http://</span>example.com/song_3.mp3</location></track>
+ </trackList>
+</playlist>
+</pre></div>
+
+<h2>MIME type</h2>
+<div>The MIME type for XSPF documents is <code>application/xspf+xml</code>. It is <em>NOT</em> <code>text/plain</code>, <code>audio/xspf</code>, or <code>text/xml</code>. <em>THIS IS IMPORTANT</em>.</div>
+<h2>Metadata</h2>
+<div>In the follow section I'm going to show how to do standard metadata by giving example playlists for each item. I'll show each item by making a change in the following sample code:
+<div>
+<pre>
+<?xml version="1.0" encoding="UTF-8"?>
+<playlist version="1" xmlns="http://xspf.org/ns/0/">
+ <trackList>
+ <track>
+ <location>http://example.com/song_1.mp3</location>
+ </track>
+ </trackList>
+</playlist>
+</pre></div>
+</div>
+
+<dl>
+
+<dt>How do I set metadata about the playlist, like the title, the name of the author, and the homepage of the author?</dt>
+<dd>
+<div>
+<pre>
+<?xml version="1.0" encoding="UTF-8"?>
+<playlist version="1" xmlns="http://xspf.org/ns/0/">
+
+ <!-- title of the playlist -->
+ <span class="callout"><title>80s Music</title></span>
+
+ <!-- name of the author -->
+ <span class="callout"><creator>Jane Doe</creator></span>
+
+ <!-- homepage of the author -->
+ <span class="callout"><info>http://example.com/~jane</info></span>
+
+ <trackList>
+ <track>
+ <location>http://example.com/song_1.mp3</location>
+ </track>
+ </trackList>
+</playlist>
+</pre></div>
+</dd>
+
+<dt>For a song in a playlist, how do I set metadata like the name of the artist and title of the album?</dt>
+<dd>
+<div>
+<pre>
+<?xml version="1.0" encoding="UTF-8"?>
+<playlist version="1" xmlns="http://xspf.org/ns/0/">
+ <trackList>
+ <track>
+ <location>http://example.com/song_1.mp3</location>
+
+ <!-- artist or band name -->
+ <span class="callout"><creator>Led Zeppelin</creator></span>
+
+ <!-- album title -->
+ <span class="callout"><album>Houses of the Holy</album></span>
+
+ <!-- name of the song -->
+ <span class="callout"><title>No Quarter</title></span>
+
+ <!-- comment on the song -->
+ <span class="callout"><annotation>I love this song</annotation></span>
+
+ <!-- song length, in milliseconds -->
+ <span class="callout"><duration>271066</duration></span>
+
+ <!-- album art -->
+ <span class="callout"><image>http://images.amazon.com/images/P/B000002J0B.01.MZZZZZZZ.jpg</image></span>
+
+ <!-- if this is a deep link, URL of the original web page -->
+ <span class="callout"><info>http://example.com</info></span>
+
+ </track>
+ </trackList>
+</playlist>
+</pre></div>
+</dd>
+
+
+</dl>
+
+</div>
+</div>
+
+</body>
+</html>
Property changes on: websites/xspf.org/quickstart.html
___________________________________________________________________
Name: svn:executable
+ *
Modified: websites/xspf.org/schema.html
===================================================================
--- websites/xspf.org/schema.html 2005-08-31 05:43:12 UTC (rev 9878)
+++ websites/xspf.org/schema.html 2005-08-31 05:43:49 UTC (rev 9879)
@@ -9,7 +9,7 @@
<body>
<div id="container">
<div id="title"></div>
-<div id="menu"><a class="menuItem" href="index.html">home</a> | <a class="menuItem" href="specs.html">specs</a> | <span class="selectedMenuItem">schema</span> | <a class="menuItem" href="apps.html">applications</a> | <a class="menuItem" href="http://lists.musicbrainz.org/mailman/listinfo/playlist">mailing list</a> | <a class="menuItem" href="http://wiki.xiph.org/index.php/XSPF">developer wiki</a> | <a class="menuItem" href="about.html">about us</a></div>
+<div id="menu"><a class="menuItem" href="index.html">home</a> | <a class="menuItem" href="quickstart.html">quick start</a> | <a class="menuItem" href="specs.html">specs</a> | <span class="selectedMenuItem">schema</span> | <a class="menuItem" href="apps.html">applications</a> | <a class="menuItem" href="http://lists.musicbrainz.org/mailman/listinfo/playlist">mailing list</a> | <a class="menuItem" href="http://wiki.xiph.org/index.php/XSPF">developer wiki</a> | <a class="menuItem" href="about.html">about us</a></div>
<div class="main">
<h1>Schema</h1>
<p>XSPF provides a schema definition file that uses <a href="http://relaxng.org">Relax NG</a>.</p>
Modified: websites/xspf.org/specs.html
===================================================================
--- websites/xspf.org/specs.html 2005-08-31 05:43:12 UTC (rev 9878)
+++ websites/xspf.org/specs.html 2005-08-31 05:43:49 UTC (rev 9879)
@@ -9,7 +9,7 @@
<body>
<div id="container">
<div id="title"></div>
-<div id="menu"><a class="selected" href="index.html">home</a> | <span class="selectedMenuItem">specs</span> | <a class="menuItem" href="schema.html">schema</a> | <a class="menuItem" href="apps.html">applications</a> | <a class="menuItem" href="http://lists.musicbrainz.org/mailman/listinfo/playlist">mailing list</a> | <a class="menuItem" href="http://wiki.xiph.org/index.php/XSPF">developer wiki</a> | <a class="menuItem" href="about.html">about us</a></div>
+<div id="menu"><a class="selected" href="index.html">home</a> | <a class="menuItem" href="quickstart.html">quick start</a> | <span class="selectedMenuItem">specs</span> | <a class="menuItem" href="schema.html">schema</a> | <a class="menuItem" href="apps.html">applications</a> | <a class="menuItem" href="http://lists.musicbrainz.org/mailman/listinfo/playlist">mailing list</a> | <a class="menuItem" href="http://wiki.xiph.org/index.php/XSPF">developer wiki</a> | <a class="menuItem" href="about.html">about us</a></div>
<div class="main">
<h1>Specifications</h1>
<p>XSPF version 0 was finished and frozen in late April 2004. XSPF version 1 was finished and frozen in March 2005. The differences between them are subtle and fairly minor, so <em>please use version 1</em> unless you have a compelling reason not to.</p>
More information about the commits
mailing list