text-to-10
----------

This parser (TextSAXParser.java) and stylesheet (text-to-10.xsl) allow to transform
a very simple (non XML) text format into RSS 1.0.

The reverse transformation (10-to-text.xsl) allows roundtrips as shown by the following example:
xml_com.in -> xml_com.txt -> xml_com.out3 .

An example of such a file could be (see example1.txt):

---------------
# Example1.txt

channel=     /news/
title=       4xt
description= News 4xt	

image=       /images/4xt.gif 
title=       4xt
link=        

textinput=   /subrss.xml
title=       Subscribe
description= Stay tuned ! Enter your email address to receive news4xt.
name=        email

item=        /news/000815-0001.xml
title=       RSS 1.0 support
description= A set of stylesheets is available on 4xt to translate RSS 0.9 and 0.9.1
             documents into the recently announced RSS 1.0 format, together with Java
             classes aimed at facilitating the transformation.

item=        /news/000730-0001.xml
title=       4xt internals part 1
description= XHTML layout documents, a technique widely used to build 4xt, explained on XML.com
			 under the title Style-free XSLT.

item=        /news/000703-0001.xml
title=       UX brings new Unix-like features to XT
description= Paul Tchistopolskii announced the release 0.2 of his UX environment, with cleaner
			 APIs, a string to node set conversion and the implementation of a grep command.

item=        /news/000601-0001.xml
title=       Maintenance 4xt
description= Moving ahead, 4xt is organizing the maintenance of XT.

item=        /news/000529-0001.xml
title=       HDML Output Handler
description= Khun Yee Fung has developped a HDML Output Handler.
--------------

The format is following very simple rules and is almost only plain English.

A new element starts with a token followed by an equal sign (=) immediately at
the beginning of a line.

A new element closes the previous one (there is no hierarchy).

The white spaces are normalized.

Comments can be added: they start with a # sign at the beginning of a line
and end at the end of the line.

The TextSAXParser which converts this into (example1.asxml):

--------------

<document>
<comment> Example1.txt</comment>
<channel>/news/</channel>
<title>4xt</title>
<description>News 4xt</description>
<image>/images/4xt.gif</image>
<title>4xt</title>
<link></link>
<textinput>/subrss.xml</textinput>
<title>Subscribe</title>
<description>Stay tuned ! Enter your email address to receive news4xt.</description>
<name>email</name>
<item>/news/000815-0001.xml</item>
<title>RSS 1.0 support</title>
<description>A set of stylesheets is available on 4xt to translate RSS 0.9 and 0.9.1 documents into the recently announced RSS 1.0 format, together with Java classes aimed at facilitating the transformation.</description>
<item>/news/000730-0001.xml</item>
<title>4xt internals part 1</title>
<description>XHTML layout documents, a technique widely used to build 4xt, explained on XML.com under the title Style-free XSLT.</description>
<item>/news/000703-0001.xml</item>
<title>UX brings new Unix-like features to XT</title>
<description>Paul Tchistopolskii announced the release 0.2 of his UX environment, with cleaner APIs, a string to node set conversion and the implementation of a grep command.</description>
<item>/news/000601-0001.xml</item>
<title>Maintenance 4xt</title>
<description>Moving ahead, 4xt is organizing the maintenance of XT.</description>
<item>/news/000529-0001.xml</item>
<title>HDML Output Handler</title>
<description>Khun Yee Fung has developped a HDML Output Handler.</description>
</document>
----------------

and a stylesheet which does the remining work to (example1.rss01):

----------------

<!--
		Translated from text by the RSS stylesheets release 0.01
	-->
<!-- Example1.txt-->
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns="http://purl.org/rss/1.0/">
   <channel rdf:about="/news/">
      <link>/news/</link>
      <title>4xt</title>
      <description>News 4xt</description>
   </channel>
   
   <image rdf:about="/images/4xt.gif">
      <inchannel rdf:resource="/news/"/>
      <url>/images/4xt.gif</url>
      <title>4xt</title>
      <link></link>
   </image>
   
   <textinput rdf:about="/subrss.xml">
      <inchannel rdf:resource="/news/"/>
      <link>/subrss.xml</link>
      <title>Subscribe</title>
      <description>Stay tuned ! Enter your email address to receive news4xt.</description>
      <name>email</name>
   </textinput>
   
   <item rdf:about="/news/000815-0001.xml" position="1">
      <inchannel rdf:resource="/news/"/>
      <link>/news/000815-0001.xml</link>
      <title>RSS 1.0 support</title>
      <description>A set of stylesheets is available on 4xt to translate RSS 0.9 and 0.9.1 documents into the recently announced RSS 1.0 format, together with Java classes aimed at facilitating the transformation.</description>
   </item>
   
   <item rdf:about="/news/000730-0001.xml" position="2">
      <inchannel rdf:resource="/news/"/>
      <link>/news/000730-0001.xml</link>
      <title>4xt internals part 1</title>
      <description>XHTML layout documents, a technique widely used to build 4xt, explained on XML.com under the title Style-free XSLT.</description>
   </item>
   
   <item rdf:about="/news/000703-0001.xml" position="3">
      <inchannel rdf:resource="/news/"/>
      <link>/news/000703-0001.xml</link>
      <title>UX brings new Unix-like features to XT</title>
      <description>Paul Tchistopolskii announced the release 0.2 of his UX environment, with cleaner APIs, a string to node set conversion and the implementation of a grep command.</description>
   </item>
   
   <item rdf:about="/news/000601-0001.xml" position="4">
      <inchannel rdf:resource="/news/"/>
      <link>/news/000601-0001.xml</link>
      <title>Maintenance 4xt</title>
      <description>Moving ahead, 4xt is organizing the maintenance of XT.</description>
   </item>
   
   <item rdf:about="/news/000529-0001.xml" position="5">
      <inchannel rdf:resource="/news/"/>
      <link>/news/000529-0001.xml</link>
      <title>HDML Output Handler</title>
      <description>Khun Yee Fung has developped a HDML Output Handler.</description>
   </item>
   
</rdf:RDF>
------------------

Extensions:
----------

For simple applications, the text file could be further simplified to:

------------------
channel=     /news/
item=        /news/000815-0001.xml
item=        /news/000730-0001.xml
item=        /news/000703-0001.xml
item=        /news/000601-0001.xml
item=        /news/000529-0001.xml
------------------

if we accept to get the title and description from the URLs themselves
(using the HTML META tags or extracting them from the page itself).