rdhtml2ag

Short:        Convert HTML documents to AmigaGuide
Author:       rmike@sbox.tu-graz.ac.at
Uploader:     rmike sbox tu-graz ac at
Type:         text/hyper
Architecture: generic

RDHTML2AG - Rexx Does HTML 2 AmigaGuide

	Written 1996 by Michael Ranner

		EMail: rmike@focus.co.at
		Homepage: http://www.sbox.tu-graz.ac.at/home/rmike

	Version 1.1

	RDHTML2AG is Public Domain.

		You may use it, modify it and distribute it all over the world!
		RDHTML2AG may not be used in commercial software!

Motivation

	There was no converter, that can convert HTML documents into AmigaGuide files.

Introduction

	Better than nothing, RDHTML2AG can convert a subset of HTML 2 terms:

	<H1> to <H6> ... rendered as described in the HTML 2 Guide
	<I> ... as italic, @{I}
	<B> ... as bold, @{B}
	<BR> ... as line break
	<P> ... as new paragraph
	<HR> ... as 80 underlined spaces
	<UL> ... as indent parapraph (only with V39 AmigaGuide, means Kick 3.0), @{LINDENT}
	<OL> ... same as <UL>! Sorry, no numbering of <LI> items.
	<LI> ... as '* ' for <UL> and <OL>
	<A HREF=...> ... as node to another AmigaGuide file
	<IMG SRC=...> ... as [Image] or ['ALT text'] and Guide links to display these Images.
	<PRE> ... as preformatted
	<XMP> and <LISTING> ... same as <PRE> but only </XMP> or </LISTING> term will be recognized.
	<ADDRESS>, <CITE>, <EM> and <VAR> ... as italic
	<STRONG> ... as bold
	<BLOCKQUOTE> ... as new paragraph and italic

	Naturelemente all </...> to the above terms will be recognized :-)

	Replacement of &amp; and so? Sorry, at the moment only &amp; &lt; &gt; and &quot; will be converted
	to '&', '<', '>' and '"'.
	
	Forms will be not converted ;-)

	Hyperlinks through the Net like http://... and so, doesn't work ;-), but will be displayed!

Installation

	copy RDHTML2AG to Rexx:

Usage

	Change in the directory, where you want to convert the HTML documents.

	rx RDHTML2AG your.html

		converts your guide in several files (each node, one file)

	rx RDAG2HTML ?

		prints the argument template Source/A.

Future

	I have to write this stuff in C to speed it up. ARexx is fine but speed is
	better :-)

Bugreport

	For minor bugs, you can eventually change the code by your self, but in any way,
	if you have found an bug, please report to rmike@sbox.tu-graz.ac.at or
	mranner@focus.co.at.

Suggestions

	Suggestions are welcome and should be send to rmike@sbox.tu-graz.ac.at or
	mranner@focus.co.at.

Disclaimer

	THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING 
	ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL
	THE AUTHOR BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR
        ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER
	IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
        OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

	Use it at your own risk!