html2wml-0.4.11004075500007650000024000000000000774677237300131765ustar00maddinguestaffhtml2wml-0.4.11/ChangeLog010064400007650000024000000467020774677237200150340ustar00maddinguestaffVERSION HISTORY v0.4.11, 2003.10.26 - 14:58 extended the effet of --ascii: now also converts non-ASCII characters to ASCII equivalents updated Html2cHtml with the code from Html2Wml 0.4.11 v0.4.11b2, 2003.02.14 - 01:00 added support for in CGI mode v0.4.11b1, 2003.02.11 - 02:00 corrected mishandling of URLs in xlate_url() and split_card() added option -i as an alias for --ignore-images; also available in CGI mode v0.4.10, Wednesday, 27th November 2002, 20:32 corrected a bug in the man page (Werner Heuser) v0.4.10b6, Sunday, 24th November 2002, 16:54 added first hooks support for HTML form conversion; supported inputs are: text, password, hidden and select v0.4.10b5, Saturday, 9th November 2002, 0:51 added support for internal hardcoding of proxy server v0.4.10b4, Monday, 4th novembern 2002, 19:18 added missing proxy support (Frank Schwarz) v0.4.10b4.chtml.03, Sunday, 3rd November, 2002, 2:48 in Html2cHtml: the split_card() function has been partially fixed, but as I'm not satisfied with it (and it's may be impossible in cHTML the same way as in WML), the document splitting has been completly disabled v0.4.10b4, Thursday, 31st October, 2002, 20:19 added a default "encoding" parameter (valued to "iso-8859-1") v0.4.10b4, Wednesday, 30th October, 2002, 1:42 added a test to prevent incorrect auto-nesting (i.e.:

...); was also introduced a "unique" attribute in the tags tree v0.4.10b4, Tuesday, 29th October, 2002, 2:10 corrected a bug in the syntax repair engine (reverse tags were incorrectly added) (signaled by Werner heuser) v0.4.10b3, Saturday, 28th September, 2002, 17:10 added the "skip"/"end_skip" actions added the "for" action parameter v0.4.10b3, (don't remember when) in comment_tag() handler: the "include" and "fsize" actions now take into account the size of the text being added to the output v0.4.10b2, Thursday, 27th June, 2002, 0:37 xlate_url(): fixed two big bugs the URL translation in CGI mode v0.4.10b2, Sunday, 9th June, 2002, 18:41 just saw that Getopt::Long::config() is deprecated; replaced by Getopt::Long::Configure() v0.4.10b1, Friday, 5th April, 2002, 20:20 get_url(): fixed a stupid bug in the output (Ouyang) v0.4.10b1, Friday, 5th April, 2002, 2:20 in start_tag() handler: rewrote the part of the syntax repair engine that tries to insert the good tags in order to restore a valid nesting; thanks for Ouyang for pointing me to the base of the problem v0.4.9, Sunday, 24th February, 2002, 16:12 cgi_error(): changed the output so that the version number is printed v0.4.9, Monday, 14th January, 2002, 23:44 corrected a bug pointed by Werner Heuser: other schemes were messed up v0.4.8, Thursday, 27th December, 2001, 2:02 removed the XML::LibXML validation test as it is currently too unstable (it always segfaults when the doc is not valid..) v0.4.8, Tuesday, 25th December, 2001, 13:25 added a small optimization when correcting incorrect entities v0.4.8b4, Thursday, 13th December, 2001, 21:23 updated the security fix in get_url(); now "file:" schemes are also forbidden in the LWP UserAgent v0.4.8b3, Tuesday, 27th November, 2001, 0:45 completed URL encoding v0.4.8b3, Tuesday, 27th November, 2001, 23:30 tracked down and corrected a bug that occured with certain files: split_card() was incorrectly called in some cases unknown entities are now converted in order to keep the document well-formed v0.4.8b3, Tuesday, 27th November, 2001, 22:35 paths in include actions can now be relative several special characters are escaped in URLs v0.4.8b3, Sunday, 25th November, 2001, 18:46 align attribute are now always converted to lower case v0.4.8b2, Thursday, 22nd November, 2001, 2:03 corrected several braindead bugs: upper case weren't recognized; links conversion was broken in CGI mode; plus a few other stupid bugs added warnings in read_file() and get_url() v0.4.8b2, Wednesday, 21st November, 2001, 20:43 corrected a security issue pointed by Jukka Salomaa; URLs with the "file:" scheme are now forbidden v0.4.8b1, Wednesday, 21st November, 2001, 1:18 corrected a bug in the cgi mode: options weren't kept through the links changed some parts of the code to try to gain speed accidentaly corrected a bug in CGI mode :-) v0.4.7r2, Wednesday, 14th November, 2001, 0:25 corrected mistakes in the package small bug corrected v0.4.7, Sunday, 11th November, 2001, 20:42 documentation updates Html2Wml comment deleted v0.4.7, Sunday, 11th November, 2001, 2:01 convert_entities(): corrected a small bug v0.4.7, Saturday, 10th November, 2001, 23:11 added small optimizations in the URLs constructions v0.4.7, Friday, 9th November, 2001, 1:03 documentation has been updated added a workaround: wmlc doesn't like < in attributes v0.4.7, Wednesday, 7th November, 2001, 22:15 WML compilation now correctly works v0.4.7, Thursday, 2nd November, 2001, 1:21 corrected several minor things v0.4.7 beta 2, Thursday, 1st November, 2001, 16:23 end() handler: the card tag now cleans up the stack; the prev link is added before the last card tag output handling didn't work, it's corrected now usage message has been updated small optimization in the generation of the static part of self URLs in CGI mode corrected a small bug in the entities conversion corrected a warning v0.4.7 beta 1, Saturday, 11, August, 2001, 0:21 apply_options(): added security checks to forbid dangerous functions in href and src templates v0.4.7 beta 1, Friday, 10 August, 2001, 23:50 convert_entities(): corrected another bug in the regexp that close incorrect named entities; now it should work in most cases v0.4.7 beta 1, Thursday, 9 August, 2001, 21:54 get_url(): corrected a bug reported by Igor Khristophorov convert_entities(): corrected a bug in the regexp that close incorrect named entities html2wml(): added a fix for badly formed DOCTYPE (pointed by Igor Khristophorov) v0.4.6, Tuesday, 31 July, 2001, 15:17 some clean-ups v0.4.6, Tuesday, 31 July, 2001, 13:34 added code to handle unclosed named entities corrected a small bug in the code that handle unclosed numeric entities v0.4.6, Tuesday, 31 July, 2001, 12:14 corrected a mistake in the handling of frames and image maps links (pointed by Igor Khristophorov) v0.4.6 pre 6, Tuesday, 15 July, 2001, 0:18 in CGI mode, now always converts options to their short names split_card(): corrected a small bug: respect server port v0.4.6 pre 6, Sunday, 15 July, 2001, 1:04 changed a few things to clearly indicate the static configurable part of the code v0.4.6 pre 6, Thursday, 12 July, 2001, 22:22 corrected a stupid bug (pointed by Werner Heuser) v0.4.6 pre 5, Tuesday, 10 July, 2001, 0:53 corrected some bugs that were occuring when processing image maps corrected a few other bugs changed a little the presentation of the source code v0.4.6 pre 5, Monday, 9 July, 2001, 23:26 html2wml(): corrected a bug: https urls weren't handled correctly the LWP agent is now created only once per session added a few collapsing rules v0.4.6 pre 4, Monday, 9 July, 2001, 1:04 get_url(): corrected two bugs; HTTP authentication is beginning to work xlate_url(): corrected a bug: respect server port when creating relative URLs in CGI mode v0.4.6 pre 3, Wednesday, 4 July, 2001, 0:56 work in progress: HTTP authentication support v0.4.6 pre 3, Tuesday, 3rd July, 2001, 23:42 added function cgi_error() v0.4.6 pre 2, Tuesday, 26 June, 2001, 1:35 added option -o, --output to write result to the given file instead of stdout v0.4.6 pre 1, Tuesday, 26 June, 2001, 0:53 opening tags forbidden inside <a> tags v0.4.5r2, Tuesday, 26 June, 2001, 1:12 split_card(): corrected a bug (deck-split in non-cgi mode) some warnings were corrected v0.4.5, Friday, 21st June, 2001, 1:27 corrected several warnings; this also add another correction for very bad HTML documents v0.4.5, Friday, 21st June, 2001, 0:35 added support for rendering <frameset> and <area> tags v0.4.5, Thursday, 20 June, 2001, 0:36 added full support for Latin Extended-A entities plus some other non standard entities v0.4.4r3, Wednesday, 20 June, 2001, 23:19 split_card(): doc_uri is a server-relative URL whenever possible in order to save up a few bytes v0.4.4r2, Wednesday, 20 June, 2001, 22:50 id bug corrected (Igor Khristophorov) v0.4.4, Tuesday, 19 June, 2001, 1:56 corrected a bug when closing anchor tags v0.4.4, Sunday, 17 June, 2001, 23:17 collapse_spaces(): some improvments v0.4.4, Sunday, 17 June, 2001, 22:15 added support for some non-standard entities v0.4.4 pre 2, Thursday, 13rd June, 2001, 21:32 post_conversion_cleanup(): special characters present in a title are now converted (bug pointed by Igor Khristophorov) v0.4.4 pre 1, Thursday, 13rd June, 2001, 1:53 some bugs corrections v0.4.4 beta 4, Thursday, 13rd June, 2001, 1:53 xlate_url(): a part of the link is now generated only once, which should give a nice code speedup v0.4.4 beta 3, Thursday, 13rd June, 2001, 1:27 htmlize(): links are now clickable xlate_url(): now uses ';' as parameter separator instead of '&' v0.4.4 beta 3, Thursday, 13rd June, 2001, 1:08 early support for deck splitting (in CGI mode only) v0.4.4 beta 2, Thursday, 13rd June, 2001, 0:39 small changes in the settings of the HTML parser v0.4.4 beta 1, Thursday, 13rd June, 2001, 23:32 bug correction: HTML pure anchors (tag A with only a NAME attribute) are now correctly converted to WML anchors v0.4.3, Sunday, June 3rd, 2001 split_card(): added a [prev] link; label is controled by the `--prev-card-label' option documentation updated v0.4.3 pre 4, Saturday, June 2nd, 2001 short options are available; they sould be used in the CGI mode in order to save up some bytes xlate_url(): in CGI mode, generated URLs use server-relative URLs in order to save up a few bytes per link htmlize(): small improvments in the syntax highlighting v0.4.3 pre 3, Thursday, May 30, 2001 HTTP headers: corrected the charset attribute; added the Content-Length header added timing in the debug mode v0.4.3 pre 3, Wednesday, May 30, 2001 unclosed numeric entites are now closed (after a question from Daniele Frijia) v0.4.3 pre 3, Tuesday, May 29, 2001 xlate_url(): in CGI mode, generated URLs no longer use the absolute URL of the CGI in order to save up a few bytes per link; suggestion of Igor Khristophorov v0.4.3 pre 2, Sunday, May 27, 2001 the `--img-alt-text' option should now work correctly doc updated v0.4.3 pre 2, Saturday, May 26, 2001 first attempts to fix some new bugs found by Igor Khristophorov v0.4.3 pre 1, Friday, May 25, 2001 added the `--img-alt-text' option to control whether the images are replaced by their alternative text; on by default; thanks to Igor Khristophorov for the suggestion v0.4.3 pre 1, Thursday, May 24, 2001 cleaned up my debugging code; added the `debug()' function corrected a weird bug pointed by Igor Khristophorov several internal cleans-up added support for sending compiled WML added support for sending encoding information (from the patch submitted by Igor Khristophorov) added the `--numeric-non-ascii' option to control whether the non-ASCII characters are converted into numeric entities; off by default v0.4.2, Saturday, May 12, 2001 non-ASCII characters are now converted to numeric entities alone ampersand characters are now converted to the corresponding entity v0.4.2, Tuesday, May 8, 2001 corrected a small bug that prevent proper handling of https URLs corrected a small mistake in the HTML syntax highlight changed a few things in the doc v0.4.1, Saturday, April 21st, 2001 changed the default maximum size of a card to 1,000 bytes corrected a mistake in the doc v0.4.1, Sunday, April 1st, 2001 debug mode doesn't use Text::Wrap anymore, it's really too messy. I've written a small function, `simple_wrap()', that does what I had in mind added support for very bad-formed HTML documents (with no HTML or BODY tags) added the `--ignore-images' option v0.4.0, Friday, March 9, 2001 corrected a small bug in doc/Makefile added a section to the documentation v0.4.0, Thursday, March 8, 2001 complete update of the documentation v0.4.0 beta 4, Monday, January 24, 2001 improved the debug mode: now use Text::Wrap to avoid very long lines v0.4.0 beta 3, Monday, January 22, 2001 corrected the parts of the code that generated the bunch of warnings; some of the bugfixes should speed up the code a little lowered the default `max-card-size' value to 1,500 bytes v0.4.0 beta 2, Saturday, January 20, 2001 added attributes conversion v0.4.0 beta 1, Friday, January 19, 2001 the software is now correctly packaged, and has a Makefile that checks the system configuration and installs the software and the documentation changed the link reconstruction engine: it now uses Text::Template, so you can do whatever you want with the links v0.3.9, Sunday, January 07, 2001 added support to compile WML using the compiler from WML Tools v0.3.9 beta 1, Tuesday, January 02, 2001 corected a small internal flaw: now, in CGI mode, if the `url' parameter has no value, use / as a default value v0.3.8, Saturday, December 30, 2000 corrected a small bug in the link reconstruction engine the `card-split-threshold' was not available because of a mistake; this is correctd the way spaces are collapsed has been changed a little the `no-pre' option is now `nopre' v0.3.7, Friday, December 29, 2000 corrected a bug when getting the document title corrected a bug in the text handler (skip mode was ignored) ampersand characters are now escaped in URLs added the `no-pre' option to disable the use of the `pre' tag v0.3.6, Saturday, December 23, 2000 cleaned up things in the card splitting process; this correct a bug that could occur in certain circumstances documentation has been updated v0.3.5, Saturday, December 23, 2000 dollar caracters are now escaped added a small HTML syntax highlighting when debugging in CGI mode several bug corrections and improvments in the syntax correction engine named HTML entities are now converted to numeric entities, this is safer because direct conversion to Unicode didn't seem to work corrected the links reconstruction engine named entities are now also converted when in attributes v0.3.5 beta 1, Thursday, December 21, 2000 new feature: the size of the cards can be limited using the `max-card-size' option v0.3.4, Wednesday, December 20, 2000 corrected a bug in the de-nesting process added features to the links reconstruction engine corrected the local file disclosure vulnerability until now, captions tags were always skipped; now they appears when tables are linearized v0.3.3, Monday, December 18, 2000 named entities are converted to real Unicode characters non-breaking spaces ( ) are converted to spaces v0.3.3 beta 4, Friday, December 15, 2000 links reconstruction is finalized v0.3.3 beta 3, Friday, December 15, 2000 added the `ascii' option to convert entities to US-ASCII v0.3.3 beta 2, Friday, December 15, 2000 named entities conversion is finalized v0.3.3 beta 1, Friday, December 14, 2000 added preliminary support for named entities conversion and images support v0.3.2, Thursday, December 13, 2000 oops! file download was broken in 0.3.1; this is corrected now ampersand are now coded as & in links a long standing bug that appeared in some cirumstances has been fixed v0.3.1, Tuesday, December 12, 2000 added a small SSI-like engine (not heavily tested) corrected a stupid bug: I forgot to add the line that translate the internal links so that the urls point to the CGI modification of the user agent signature so that it includes the signature of the original client rendering of header tags H1, H2 and H3 has been improved added a links reconstruction engine (currently unfinished) improved the debug mode when launched from shell v0.3.0, Sunday, December 10, 2000 the syntax repair engine has been improved and should now be able to correct most usual HTML pages (I hope) v0.3.0 beta 6, Saturday, December 9, 2000 corrected a stupid bug in the CGI mode added the `debug' option corrected some mistakes in the documentation added the LINKS section in the documentation added several improvements and corrected several bugs v0.3.0 beta 5, Thursday, December 6, 2000 added the `collapse' option to control whether redundant white space chars are kept or not added the documentation for the options v0.3.0 beta 4, Monday, December 4, 2000 added the `linearize' option (on by default) so that it linearizes tables normal texts (i.e. not inside <pre> tags) are cleaned by stripping multiples spaces and lines the syntax repair engine has been rewritten, but it does not work in all cases v0.3.0 beta 3, Sunday, November 19, 2000 first try to add syntax check/repair v0.2.3, Saturday, November 18, 2000 added URI translation v0.2.2, Thursday, November 15, 2000 added XML checker; the output is given to Expat to check that it is well-formed XML. Note that XML::Parser is loaded on demand. added options support (using Getopt::Long) v0.2.1, Tuesday, November 14, 20000 cleaned up a few things; added some attributes to the allow list added url resolution v0.2.0, Saturday, November 11, 2000 first functional version; now uses HTML::Parser v3 v0.1.0, Friday, November 10, 2000 prototype version ��������������������������������������������������������������html2wml-0.4.11/ChangeLog.pod�����������������������������������������������������������������������0100644�0000765�0000024�00000043434�07746772372�0015614�0����������������������������������������������������������������������������������������������������ustar�00maddingue�����������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������=head1 VERSION HISTORY =over 4 =item v0.4.11, 2003.10.26 - 14:58 extended the effet of --ascii: now also converts non-ASCII characters to ASCII equivalents updated Html2cHtml with the code from Html2Wml 0.4.11 =item v0.4.11b2, 2003.02.14 - 01:00 added support for <base href="..."> in CGI mode =item v0.4.11b1, 2003.02.11 - 02:00 corrected mishandling of URLs in xlate_url() and split_card() added option -i as an alias for --ignore-images; also available in CGI mode =item v0.4.10, Wednesday, 27th November 2002, 20:32 corrected a bug in the man page (Werner Heuser) =item v0.4.10b6, Sunday, 24th November 2002, 16:54 added first hooks support for HTML form conversion; supported inputs are: text, password, hidden and select =item v0.4.10b5, Saturday, 9th November 2002, 0:51 added support for internal hardcoding of proxy server =item v0.4.10b4, Monday, 4th novembern 2002, 19:18 added missing proxy support (Frank Schwarz) =item v0.4.10b4.chtml.03, Sunday, 3rd November, 2002, 2:48 in Html2cHtml: the split_card() function has been partially fixed, but as I'm not satisfied with it (and it's may be impossible in cHTML the same way as in WML), the document splitting has been completly disabled =item v0.4.10b4, Thursday, 31st October, 2002, 20:19 added a default "encoding" parameter (valued to "iso-8859-1") =item v0.4.10b4, Wednesday, 30th October, 2002, 1:42 added a test to prevent incorrect auto-nesting (i.e.: <p><p>...); was also introduced a "unique" attribute in the tags tree =item v0.4.10b4, Tuesday, 29th October, 2002, 2:10 corrected a bug in the syntax repair engine (reverse tags were incorrectly added) (signaled by Werner heuser) =item v0.4.10b3, Saturday, 28th September, 2002, 17:10 added the "skip"/"end_skip" actions added the "for" action parameter =item v0.4.10b3, (don't remember when) in comment_tag() handler: the "include" and "fsize" actions now take into account the size of the text being added to the output =item v0.4.10b2, Thursday, 27th June, 2002, 0:37 xlate_url(): fixed two big bugs the URL translation in CGI mode =item v0.4.10b2, Sunday, 9th June, 2002, 18:41 just saw that Getopt::Long::config() is deprecated; replaced by Getopt::Long::Configure() =item v0.4.10b1, Friday, 5th April, 2002, 20:20 get_url(): fixed a stupid bug in the output (Ouyang) =item v0.4.10b1, Friday, 5th April, 2002, 2:20 in start_tag() handler: rewrote the part of the syntax repair engine that tries to insert the good tags in order to restore a valid nesting; thanks for Ouyang for pointing me to the base of the problem =item v0.4.9, Sunday, 24th February, 2002, 16:12 cgi_error(): changed the output so that the version number is printed =item v0.4.9, Monday, 14th January, 2002, 23:44 corrected a bug pointed by Werner Heuser: other schemes were messed up =item v0.4.8, Thursday, 27th December, 2001, 2:02 removed the XML::LibXML validation test as it is currently too unstable (it always segfaults when the doc is not valid..) =item v0.4.8, Tuesday, 25th December, 2001, 13:25 added a small optimization when correcting incorrect entities =item v0.4.8b4, Thursday, 13th December, 2001, 21:23 updated the security fix in get_url(); now "file:" schemes are also forbidden in the LWP UserAgent =item v0.4.8b3, Tuesday, 27th November, 2001, 0:45 completed URL encoding =item v0.4.8b3, Tuesday, 27th November, 2001, 23:30 tracked down and corrected a bug that occured with certain files: split_card() was incorrectly called in some cases unknown entities are now converted in order to keep the document well-formed =item v0.4.8b3, Tuesday, 27th November, 2001, 22:35 paths in include actions can now be relative several special characters are escaped in URLs =item v0.4.8b3, Sunday, 25th November, 2001, 18:46 align attribute are now always converted to lower case =item v0.4.8b2, Thursday, 22nd November, 2001, 2:03 corrected several braindead bugs: upper case <title> weren't recognized; links conversion was broken in CGI mode; plus a few other stupid bugs added warnings in read_file() and get_url() =item v0.4.8b2, Wednesday, 21st November, 2001, 20:43 corrected a security issue pointed by Jukka Salomaa; URLs with the "file:" scheme are now forbidden =item v0.4.8b1, Wednesday, 21st November, 2001, 1:18 corrected a bug in the cgi mode: options weren't kept through the links changed some parts of the code to try to gain speed accidentaly corrected a bug in CGI mode :-) =item v0.4.7r2, Wednesday, 14th November, 2001, 0:25 corrected mistakes in the package small bug corrected =item v0.4.7, Sunday, 11th November, 2001, 20:42 documentation updates Html2Wml comment deleted =item v0.4.7, Sunday, 11th November, 2001, 2:01 convert_entities(): corrected a small bug =item v0.4.7, Saturday, 10th November, 2001, 23:11 added small optimizations in the URLs constructions =item v0.4.7, Friday, 9th November, 2001, 1:03 documentation has been updated added a workaround: wmlc doesn't like < in attributes =item v0.4.7, Wednesday, 7th November, 2001, 22:15 WML compilation now correctly works =item v0.4.7, Thursday, 2nd November, 2001, 1:21 corrected several minor things =item v0.4.7 beta 2, Thursday, 1st November, 2001, 16:23 end() handler: the card tag now cleans up the stack; the prev link is added before the last card tag output handling didn't work, it's corrected now usage message has been updated small optimization in the generation of the static part of self URLs in CGI mode corrected a small bug in the entities conversion corrected a warning =item v0.4.7 beta 1, Saturday, 11, August, 2001, 0:21 apply_options(): added security checks to forbid dangerous functions in href and src templates =item v0.4.7 beta 1, Friday, 10 August, 2001, 23:50 convert_entities(): corrected another bug in the regexp that close incorrect named entities; now it should work in most cases =item v0.4.7 beta 1, Thursday, 9 August, 2001, 21:54 get_url(): corrected a bug reported by Igor Khristophorov convert_entities(): corrected a bug in the regexp that close incorrect named entities html2wml(): added a fix for badly formed DOCTYPE (pointed by Igor Khristophorov) =item v0.4.6, Tuesday, 31 July, 2001, 15:17 some clean-ups =item v0.4.6, Tuesday, 31 July, 2001, 13:34 added code to handle unclosed named entities corrected a small bug in the code that handle unclosed numeric entities =item v0.4.6, Tuesday, 31 July, 2001, 12:14 corrected a mistake in the handling of frames and image maps links (pointed by Igor Khristophorov) =item v0.4.6 pre 6, Tuesday, 15 July, 2001, 0:18 in CGI mode, now always converts options to their short names split_card(): corrected a small bug: respect server port =item v0.4.6 pre 6, Sunday, 15 July, 2001, 1:04 changed a few things to clearly indicate the static configurable part of the code =item v0.4.6 pre 6, Thursday, 12 July, 2001, 22:22 corrected a stupid bug (pointed by Werner Heuser) =item v0.4.6 pre 5, Tuesday, 10 July, 2001, 0:53 corrected some bugs that were occuring when processing image maps corrected a few other bugs changed a little the presentation of the source code =item v0.4.6 pre 5, Monday, 9 July, 2001, 23:26 html2wml(): corrected a bug: https urls weren't handled correctly the LWP agent is now created only once per session added a few collapsing rules =item v0.4.6 pre 4, Monday, 9 July, 2001, 1:04 get_url(): corrected two bugs; HTTP authentication is beginning to work xlate_url(): corrected a bug: respect server port when creating relative URLs in CGI mode =item v0.4.6 pre 3, Wednesday, 4 July, 2001, 0:56 work in progress: HTTP authentication support =item v0.4.6 pre 3, Tuesday, 3rd July, 2001, 23:42 added function cgi_error() =item v0.4.6 pre 2, Tuesday, 26 June, 2001, 1:35 added option -o, --output to write result to the given file instead of stdout =item v0.4.6 pre 1, Tuesday, 26 June, 2001, 0:53 opening tags forbidden inside <a> tags =item v0.4.5r2, Tuesday, 26 June, 2001, 1:12 split_card(): corrected a bug (deck-split in non-cgi mode) some warnings were corrected =item v0.4.5, Friday, 21st June, 2001, 1:27 corrected several warnings; this also add another correction for very bad HTML documents =item v0.4.5, Friday, 21st June, 2001, 0:35 added support for rendering <frameset> and <area> tags =item v0.4.5, Thursday, 20 June, 2001, 0:36 added full support for Latin Extended-A entities plus some other non standard entities =item v0.4.4r3, Wednesday, 20 June, 2001, 23:19 split_card(): doc_uri is a server-relative URL whenever possible in order to save up a few bytes =item v0.4.4r2, Wednesday, 20 June, 2001, 22:50 id bug corrected (Igor Khristophorov) =item v0.4.4, Tuesday, 19 June, 2001, 1:56 corrected a bug when closing anchor tags =item v0.4.4, Sunday, 17 June, 2001, 23:17 collapse_spaces(): some improvments =item v0.4.4, Sunday, 17 June, 2001, 22:15 added support for some non-standard entities =item v0.4.4 pre 2, Thursday, 13rd June, 2001, 21:32 post_conversion_cleanup(): special characters present in a title are now converted (bug pointed by Igor Khristophorov) =item v0.4.4 pre 1, Thursday, 13rd June, 2001, 1:53 some bugs corrections =item v0.4.4 beta 4, Thursday, 13rd June, 2001, 1:53 xlate_url(): a part of the link is now generated only once, which should give a nice code speedup =item v0.4.4 beta 3, Thursday, 13rd June, 2001, 1:27 htmlize(): links are now clickable xlate_url(): now uses ';' as parameter separator instead of '&' =item v0.4.4 beta 3, Thursday, 13rd June, 2001, 1:08 early support for deck splitting (in CGI mode only) =item v0.4.4 beta 2, Thursday, 13rd June, 2001, 0:39 small changes in the settings of the HTML parser =item v0.4.4 beta 1, Thursday, 13rd June, 2001, 23:32 bug correction: HTML pure anchors (tag A with only a NAME attribute) are now correctly converted to WML anchors =item v0.4.3, Sunday, June 3rd, 2001 split_card(): added a [prev] link; label is controled by the C<--prev-card-label> option documentation updated =item v0.4.3 pre 4, Saturday, June 2nd, 2001 short options are available; they sould be used in the CGI mode in order to save up some bytes xlate_url(): in CGI mode, generated URLs use server-relative URLs in order to save up a few bytes per link htmlize(): small improvments in the syntax highlighting =item v0.4.3 pre 3, Thursday, May 30, 2001 HTTP headers: corrected the charset attribute; added the Content-Length header added timing in the debug mode =item v0.4.3 pre 3, Wednesday, May 30, 2001 unclosed numeric entites are now closed (after a question from Daniele Frijia) =item v0.4.3 pre 3, Tuesday, May 29, 2001 xlate_url(): in CGI mode, generated URLs no longer use the absolute URL of the CGI in order to save up a few bytes per link; suggestion of Igor Khristophorov =item v0.4.3 pre 2, Sunday, May 27, 2001 the C<--img-alt-text> option should now work correctly doc updated =item v0.4.3 pre 2, Saturday, May 26, 2001 first attempts to fix some new bugs found by Igor Khristophorov =item v0.4.3 pre 1, Friday, May 25, 2001 added the C<--img-alt-text> option to control whether the images are replaced by their alternative text; on by default; thanks to Igor Khristophorov for the suggestion =item v0.4.3 pre 1, Thursday, May 24, 2001 cleaned up my debugging code; added the C<debug()> function corrected a weird bug pointed by Igor Khristophorov several internal cleans-up added support for sending compiled WML added support for sending encoding information (from the patch submitted by Igor Khristophorov) added the C<--numeric-non-ascii> option to control whether the non-ASCII characters are converted into numeric entities; off by default =item v0.4.2, Saturday, May 12, 2001 non-ASCII characters are now converted to numeric entities alone ampersand characters are now converted to the corresponding entity =item v0.4.2, Tuesday, May 8, 2001 corrected a small bug that prevent proper handling of https URLs corrected a small mistake in the HTML syntax highlight changed a few things in the doc =item v0.4.1, Saturday, April 21st, 2001 changed the default maximum size of a card to 1,000 bytes corrected a mistake in the doc =item v0.4.1, Sunday, April 1st, 2001 debug mode doesn't use Text::Wrap anymore, it's really too messy. I've written a small function, C<simple_wrap()>, that does what I had in mind added support for very bad-formed HTML documents (with no HTML or BODY tags) added the C<--ignore-images> option =item v0.4.0, Friday, March 9, 2001 corrected a small bug in doc/Makefile added a section to the documentation =item v0.4.0, Thursday, March 8, 2001 complete update of the documentation =item v0.4.0 beta 4, Monday, January 24, 2001 improved the debug mode: now use Text::Wrap to avoid very long lines =item v0.4.0 beta 3, Monday, January 22, 2001 corrected the parts of the code that generated the bunch of warnings; some of the bugfixes should speed up the code a little lowered the default C<max-card-size> value to 1,500 bytes =item v0.4.0 beta 2, Saturday, January 20, 2001 added attributes conversion =item v0.4.0 beta 1, Friday, January 19, 2001 the software is now correctly packaged, and has a Makefile that checks the system configuration and installs the software and the documentation changed the link reconstruction engine: it now uses Text::Template, so you can do whatever you want with the links =item v0.3.9, Sunday, January 07, 2001 added support to compile WML using the compiler from WML Tools =item v0.3.9 beta 1, Tuesday, January 02, 2001 corected a small internal flaw: now, in CGI mode, if the C<url> parameter has no value, use / as a default value =item v0.3.8, Saturday, December 30, 2000 corrected a small bug in the link reconstruction engine the C<card-split-threshold> was not available because of a mistake; this is correctd the way spaces are collapsed has been changed a little the C<no-pre> option is now C<nopre> =item v0.3.7, Friday, December 29, 2000 corrected a bug when getting the document title corrected a bug in the text handler (skip mode was ignored) ampersand characters are now escaped in URLs added the C<no-pre> option to disable the use of the C<pre> tag =item v0.3.6, Saturday, December 23, 2000 cleaned up things in the card splitting process; this correct a bug that could occur in certain circumstances documentation has been updated =item v0.3.5, Saturday, December 23, 2000 dollar caracters are now escaped added a small HTML syntax highlighting when debugging in CGI mode several bug corrections and improvments in the syntax correction engine named HTML entities are now converted to numeric entities, this is safer because direct conversion to Unicode didn't seem to work corrected the links reconstruction engine named entities are now also converted when in attributes =item v0.3.5 beta 1, Thursday, December 21, 2000 new feature: the size of the cards can be limited using the C<max-card-size> option =item v0.3.4, Wednesday, December 20, 2000 corrected a bug in the de-nesting process added features to the links reconstruction engine corrected the local file disclosure vulnerability until now, captions tags were always skipped; now they appears when tables are linearized =item v0.3.3, Monday, December 18, 2000 named entities are converted to real Unicode characters non-breaking spaces ( ) are converted to spaces =item v0.3.3 beta 4, Friday, December 15, 2000 links reconstruction is finalized =item v0.3.3 beta 3, Friday, December 15, 2000 added the C<ascii> option to convert entities to US-ASCII =item v0.3.3 beta 2, Friday, December 15, 2000 named entities conversion is finalized =item v0.3.3 beta 1, Friday, December 14, 2000 added preliminary support for named entities conversion and images support =item v0.3.2, Thursday, December 13, 2000 oops! file download was broken in 0.3.1; this is corrected now ampersand are now coded as & in links a long standing bug that appeared in some cirumstances has been fixed =item v0.3.1, Tuesday, December 12, 2000 added a small SSI-like engine (not heavily tested) corrected a stupid bug: I forgot to add the line that translate the internal links so that the urls point to the CGI modification of the user agent signature so that it includes the signature of the original client rendering of header tags H1, H2 and H3 has been improved added a links reconstruction engine (currently unfinished) improved the debug mode when launched from shell =item v0.3.0, Sunday, December 10, 2000 the syntax repair engine has been improved and should now be able to correct most usual HTML pages (I hope) =item v0.3.0 beta 6, Saturday, December 9, 2000 corrected a stupid bug in the CGI mode added the C<debug> option corrected some mistakes in the documentation added the LINKS section in the documentation added several improvements and corrected several bugs =item v0.3.0 beta 5, Thursday, December 6, 2000 added the C<collapse> option to control whether redundant white space chars are kept or not added the documentation for the options =item v0.3.0 beta 4, Monday, December 4, 2000 added the C<linearize> option (on by default) so that it linearizes tables normal texts (i.e. not inside <pre> tags) are cleaned by stripping multiples spaces and lines the syntax repair engine has been rewritten, but it does not work in all cases =item v0.3.0 beta 3, Sunday, November 19, 2000 first try to add syntax check/repair =item v0.2.3, Saturday, November 18, 2000 added URI translation =item v0.2.2, Thursday, November 15, 2000 added XML checker; the output is given to Expat to check that it is well-formed XML. Note that XML::Parser is loaded on demand. added options support (using Getopt::Long) =item v0.2.1, Tuesday, November 14, 20000 cleaned up a few things; added some attributes to the allow list added url resolution =item v0.2.0, Saturday, November 11, 2000 first functional version; now uses HTML::Parser v3 =item v0.1.0, Friday, November 10, 2000 prototype version =back ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������html2wml-0.4.11/checkconfig.cgi���������������������������������������������������������������������0100755�0000765�0000024�00000001357�07746772372�0016211�0����������������������������������������������������������������������������������������������������ustar�00maddingue�����������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������#!/usr/bin/perl use strict; my $crlf = "\015\012"; print "Content-Type: text/html$crlf$crlf", "<html>\n<body>\n", "<p><b>Required Modules</b><br>\n"; for my $module (qw(strict CGI File::Basename Getopt::Long HTML::Parser LWP::UserAgent POSIX Text::Template URI URI::URL)) { print "checking for <b>$module</b>... "; eval "use $module"; print $@ ? substr($@,0,index($@," at ")) : "ok"; print "<br>\n"; } print "</p>\n<p><b>Optional Modules</b><br>\n"; for my $module (qw(XML::Parser XML::LibXML XML::Checker::Parser)) { print "checking for <b>$module</b>... "; eval "use $module"; print $@ ? substr($@,0,index($@," at ")) : "ok"; print "<br>\n"; } print "</p>\n</body>\n</html>\n"; ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������html2wml-0.4.11/checkconfig.pl����������������������������������������������������������������������0100644�0000765�0000024�00000003104�07746772372�0016047�0����������������������������������������������������������������������������������������������������ustar�00maddingue�����������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������#!/usr/bin/perl # This script will check if the Perl software installed on the system # has the necessary requirements in order to run the program. # # It works with versions of Perl as old as 4.036. # # Copyright (c)2000, 2001 Sebastien Aperghis-Tramoni # [ configurable part ] $needperl = 5.004; $program = 'Html2Wml'; @files = ('html2wml.cgi'); # [ end configuration ] sub fatal { print @_; exit -1; } sub nonfatal { print @_; } ## Check perl version $] =~ /(\d+(\.\d+))/; if($1 < $needperl) { &fatal("Your version of Perl ($1) is too old. \n", "Please upgrade to version $needperl or later. \n"); } ## Search for needed modules for $file (@files) { open(FILE, $file) || &fatal("Can't open program file. Check if your archive is correct. \n"); %modules = (); while(<FILE>) { chop; ## end of code section if(/^__END__/) { last } if(/^__DATA__/) { last } ## skip POD sections if(/^=head/) { do { $_ = <FILE> } until(/^=cut/) } if(/^\s*(use|require) +([\w:]+)/) { $modules{$2} = $1 } } close(FILE); } ## Check if the modules are available for $module (keys %modules) { eval "$modules{$module} $module"; if($@) { if($modules{$module} eq 'use') { &fatal("Perl module $module is needed to use $program. \n") } else { &nonfatal("Perl module $module is not installed. \n", "Some fonctionalities of Html2Wml won't be available. \n") } } } exit 0; ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������html2wml-0.4.11/COPYING�����������������������������������������������������������������������������0100644�0000765�0000024�00000043105�07746772372�0014307�0����������������������������������������������������������������������������������������������������ustar�00maddingue�����������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������ GNU GENERAL PUBLIC LICENSE Version 2, June 1991 Copyright (C) 1989, 1991 Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) You can apply it to your programs, too. When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for this service if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs; and that you know you can do these things. To protect your rights, we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you". Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does. 1. You may copy and distribute verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program. You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. 2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions: a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change. b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License. c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it. Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program. In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License. 3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following: a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or, c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.) The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code. 4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance. 5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License. 7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program. If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances. It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice. This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License. 8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License. 9. The Free Software Foundation may publish revised and/or new versions of the General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Program specifies a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation. 10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. END OF TERMS AND CONDITIONS How to Apply These Terms to Your New Programs If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms. To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. <one line to give the program's name and a brief idea of what it does.> Copyright (C) 19yy <name of author> This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) 19yy name of author Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details. The hypothetical commands `show w' and `show c' should show the appropriate parts of the General Public License. Of course, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (which makes passes at compilers) written by James Hacker. <signature of Ty Coon>, 1 April 1989 Ty Coon, President of Vice This General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Library General Public License instead of this License. �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������html2wml-0.4.11/doc���������������������������������������������������������������������������������0040755�0000765�0000024�00000000000�07746772373�0013743�5����������������������������������������������������������������������������������������������������ustar�00maddingue�����������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������html2wml-0.4.11/doc/html2wml.man��������������������������������������������������������������������0100644�0000765�0000024�00000076277�07746772372�0016304�0����������������������������������������������������������������������������������������������������ustar�00maddingue�����������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.\" Automatically generated by Pod::Man version 1.02 .\" Sun Oct 26 17:23:13 2003 .\" .\" Standard preamble: .\" ====================================================================== .de Sh \" Subsection heading .br .if t .Sp .ne 5 .PP \fB\\$1\fR .PP .. .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Ip \" List item .br .ie \\n(.$>=3 .ne \\$3 .el .ne 3 .IP "\\$1" \\$2 .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. | will give a .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used .\" to do unbreakable dashes and therefore won't be available. \*(C` and .\" \*(C' expand to `' in nroff, nothing in troff, for use with C<> .tr \(*W-|\(bv\*(Tr .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` ` . ds C' ' 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\} .\" .\" If the F register is turned on, we'll generate index entries on stderr .\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and .\" index entries marked with X<> in POD. Of course, you'll have to process .\" the output yourself in some meaningful fashion. .if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" . . . nr % 0 . rr F .\} .\" .\" For nroff, turn off justification. Always turn off hyphenation; it .\" makes way too many mistakes in technical documents. .hy 0 .if n .na .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. .bd B 3 . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ====================================================================== .\" .IX Title "README 1" .TH README 1 "0.4.11" "2003-10-26" """Html2Wml Documentation""" .UC .SH "NAME" Html2Wml \*(-- Program that can convert \s-1HTML\s0 pages to \s-1WML\s0 pages .SH "SYNOPSIS" .IX Header "SYNOPSIS" Html2Wml can be used as either a shell command: .PP .Vb 1 \& $ html2wml file.html .Ve or as a \s-1CGI:\s0 .PP .Vb 1 \& /cgi-bin/html2wml.cgi?url=/index.html .Ve In both cases, the file can be either a local file or a \s-1URL\s0. .SH "DESCRIPTION" .IX Header "DESCRIPTION" Html2Wml converts \s-1HTML\s0 pages to \s-1WML\s0 decks, suitable for being viewed on a Wap device. The program can be launched from a shell to statically convert a set of pages, or as a \s-1CGI\s0 to convert a particular (potentially dynamic) \&\s-1HTML\s0 resource. .PP Althought the result is not guarantied to be valid \s-1WML\s0, it should be the case for most pages. Good \s-1HTML\s0 pages will most probably produce valid \&\s-1WML\s0 decks. To check and correct your pages, you can use W3C's softwares: the \fI\s-1HTML\s0 Validator\fR, available online at http://validator.w3.org and \fI\s-1HTML\s0 Tidy\fR, written by Dave Raggett. .PP Html2Wml provides the following features: .Ip "\(bu" 4 translation of the links .Ip "\(bu" 4 limitation of the cards size by splitting the result into several cards .Ip "\(bu" 4 inclusion of files (similar to the \s-1SSI\s0) .Ip "\(bu" 4 compilation of the result (using the \s-1WML\s0 Tools, see the section on "LINKS") .Ip "\(bu" 4 a debug mode to check the result using validation functions .SH "OPTIONS" .IX Header "OPTIONS" Please note that most of these options are also available when calling Html2Wml as a \s-1CGI\s0. In this case, boolean options are given the value \&\*(L"1\*(R" or \*(L"0\*(R", and other options simply receive the value they expect. For example, \f(CW\*(C`\-\-ascii\*(C'\fR becomes \f(CW\*(C`?ascii=1\*(C'\fR or \f(CW\*(C`?a=1\*(C'\fR. See the file \fIt/form.html\fR for an example on how to call Html2Wml as a \s-1CGI\s0. .Sh "Conversion Options" .IX Subsection "Conversion Options" .Ip "\-a, \-\-ascii" 4 .IX Item "-a, --ascii" When this option is on, named \s-1HTML\s0 entities and non-ASCII characters are converted to \s-1US-ASCII\s0 characters using the same 7 bit approximations as Lynx. For example, \f(CW\*(C`©\*(C'\fR is translated to \*(L"(c)\*(R", and \f(CW\*(C`ß\*(C'\fR is translated to \*(L"ss\*(R". This option is off by default. .Ip "\-\-[no]collapse" 4 .IX Item "--[no]collapse" This option tells Html2Wml to collapse redundant whitespaces, tabulations, carriage returns, lines feeds and empty paragraphs. The aim is to reduce the size of the \s-1WML\s0 document as much as possible. Collapsing empty paragraphs is necessary for two reasons. First, this avoids empty screens (and on a device with only 4 lines of display, an empty screen can be quite ennoying). Second, Html2wml creates many empty paragraphs when converting, because of the way the syntax reconstructor is programmed. Deleting these empty paragraphs is necessary like cleaning the kitchen :\-) .Sp If this really bother you, you can desactivate this behaviour with the \&\fB\*(--nocollapse\fR option. .Ip "\*(--ignore-images" 4 .IX Item "ignore-images" This option tells Html2Wml to completly ignore all image links. .Ip "\-\-[no]img-alt-text" 4 .IX Item "--[no]img-alt-text" This option tells Html2Wml to replace the image tags with their corresponding alternative text (as with a text mode web browser). This option is on by default. .Ip "\-\-[no]linearize" 4 .IX Item "--[no]linearize" This option is on by default. This makes Html2Wml flattens the \s-1HTML\s0 tables (they are linearized), as Lynx does. I think this is better than trying to use the native \s-1WML\s0 tables. First, they have extremely limited features and possibilities compared to \s-1HTML\s0 tables. In particular, they can't be nested. In fact this is normal because Wap devices are not supposed to have a big \s-1CPU\s0 running at some zillions-hertz, and the calculations needed to render the tables are the most complicated and CPU-hogger part of \s-1HTML\s0. .Sp Second, as they can't be nested, and as typical \s-1HTML\s0 pages heavily use imbricated tables to create their layout, it's impossible to decide which one could be kept. So the best thing is to keep none of them. .Sp \&\fB[Note]\fR Although you can desactivate this behaviour, and although there is internal support for tables, the unlinearized mode has not been heavily tested with nested tables, and it may produce unexpected results. .Ip "\-n, \-\-numeric-non-ascii" 4 .IX Item "-n, --numeric-non-ascii" This option tells Html2wml to convert all non-ASCII characters to numeric entities, i.e., "e\*'" becomes \f(CW\*(C`é\*(C'\fR, and "\*8" becomes \f(CW\*(C`ß\*(C'\fR. By default, this option is off. .Ip "\-p, \-\-nopre" 4 .IX Item "-p, --nopre" This options tells Html2Wml not to use the <pre> tag. This option was added because the compiler from \s-1WML\s0 Tools 0.0.4 doesn't support this tag. .Sh "Links Reconstruction Options" .IX Subsection "Links Reconstruction Options" .Ip "\*(--hreftmpl=\fI\s-1TEMPLATE\s0\fR" 4 .IX Item "hreftmpl=TEMPLATE" This options sets the template that will be used to reconstruct the \&\f(CW\*(C`href\*(C'\fR\-type links. See the section on "LINKS RECONSTRUCTION" for more information. .Ip "\*(--srctmpl=\fI\s-1TEMPLATE\s0\fR" 4 .IX Item "srctmpl=TEMPLATE" This option sets the template that will be used to reconstruct the \&\f(CW\*(C`src\*(C'\fR\-type links. See the section on "LINKS RECONSTRUCTION" for more information. .Sh "Splitting Options" .IX Subsection "Splitting Options" .Ip "\-s, \-\-max-card-size=\fI\s-1SIZE\s0\fR" 4 .IX Item "-s, --max-card-size=SIZE" This option allows you to limit the size (in bytes) of the generated cards. Default is 1,500 bytes, which should be small enought to be loaded on most Wap devices. See the section on "DECK SLICING" for more information. .Ip "\-t, \-\-card-split-threshold=\fI\s-1SIZE\s0\fR" 4 .IX Item "-t, --card-split-threshold=SIZE" This option sets the threshold of the split event, which can occur when the size of the current card is between \f(CW\*(C`max\-card\-size\*(C'\fR \- \&\f(CW\*(C`card\-split\-threshold\*(C'\fR and \f(CW\*(C`max\-card\-size\*(C'\fR. Default value is 50. See the section on "DECK SLICING" for more information. .Ip "\*(--next-card-label=\fI\s-1STRING\s0\fR" 4 .IX Item "next-card-label=STRING" This options sets the label of the link that points to the next card. Default is \*(L"[>>]\*(R", which whill be rendered as "[>>]". .Ip "\*(--prev-card-label=\fI\s-1STRING\s0\fR" 4 .IX Item "prev-card-label=STRING" This options sets the label of the link that points to the previous card. Default is \*(L"[<<]\*(R", which whill be rendered as "[<<]". .Sh "\s-1HTTP\s0 Authentication" .IX Subsection "HTTP Authentication" .Ip "\-U, \-\-http-user=\fI\s-1USERNAME\s0\fR" 4 .IX Item "-U, --http-user=USERNAME" Use this option to set the username for an authenticated request. .Ip "\-P, \-\-http-passwd=\fI\s-1PASSWORD\s0\fR" 4 .IX Item "-P, --http-passwd=PASSWORD" Use this option to set the password for an authenticated request. .Sh "Proxy Support" .IX Subsection "Proxy Support" .Ip "\-[no]Y, \-\-[no]proxy" 4 .IX Item "-[no]Y, --[no]proxy" Use this option to activate proxy support. By default, proxy support is activated. See the section on "PROXY SUPPORT". .Sh "Output Options" .IX Subsection "Output Options" .Ip "\-k, \-\-compile" 4 .IX Item "-k, --compile" Setting this option tells Html2Wml to use the compiler from \s-1WML\s0 Tools to compile the \s-1WML\s0 deck. If you want to create a real Wap site, you should seriously use this option in order to reduce the size of the \s-1WML\s0 decks. Remember that Wap devices have very little amount of memory. If this is not enought, use the splitting options. .Sp Take a look in \fIwml_compilation/\fR for more information on how to use a \s-1WML\s0 compiler with Html2Wml. .Ip "\-o, \-\-output" 4 .IX Item "-o, --output" Use this option (in shell mode) to specify an output file. By default, Html2Wml prints the result to standard output. .Sh "Debugging Options" .IX Subsection "Debugging Options" .Ip "\-d, \-\-debug[=\fI\s-1LEVEL\s0\fR]" 4 .IX Item "-d, --debug[=LEVEL]" This option activates the debug mode. This prints the output result with line numbering and with the result of the \s-1XML\s0 check. If the \s-1WML\s0 compiler was called, the result is also printed in hexadecimal an ascii forms. When called as a \s-1CGI\s0, all of this is printed as \s-1HTML\s0, so that can use any web browser for that purpose. .Ip "\*(--xmlcheck" 4 .IX Item "xmlcheck" When this option is on, it send the \s-1WML\s0 output to \s-1XML:\s0:Parser to check its well-formedness. .SH "DECK SLICING" .IX Header "DECK SLICING" The \fIdeck slicing\fR is a feature that Html2Wml provides in order to match the low memory capabilities of most Wap devices. Many can't handle cards larger than 2,000 bytes, therefore the cards must be sufficiently small to be viewed by all Wap devices. To achieve this, you should compile your \s-1WML\s0 deck, which reduce the size of the deck by 50%, but even then your cards may be too big. This is where Html2Wml comes with the deck slicing feature. This allows you to limit the size of the cards, currently only \&\fIbefore\fR the compilation stage. .Sh "Slice by cards or by decks" .IX Subsection "Slice by cards or by decks" On some Wap phones, slicing the deck is not sufficient: the \s-1WML\s0 browser still tries to download the whole deck instead of just picking one card at a time. A solution is to slice the \s-1WML\s0 document by decks. See the figure below. .PP .Vb 15 \& _____________ _____________ \& | deck | | deck #1 | \& | _________ | | _________ | \& | | card #1 | | | | card | | \& | |_________| | | |_________| | \& | _________ | |_____________| \& | | card #2 | | \& | |_________| | . . . \& | _________ | \& | | ... | | _____________ \& | |_________| | | deck #n | \& | _________ | | _________ | \& | | card #n | | | | card | | \& | |_________| | | |_________| | \& |_____________| |_____________| .Ve .Vb 2 \& WML document WML document \& sliced by cards sliced by decks .Ve What this means is that Html2Wml generates several \s-1WML\s0 documents. In \s-1CGI\s0 mode, only the appropriate deck is sent, selected by the id given in parameter. If no id was given, the first deck is sent. .Sh "Note on size calculation" .IX Subsection "Note on size calculation" Currently, Html2Wml estimates the size of the card on the fly, by summing the length of the strings that compose the \s-1WML\s0 output, texts and tags. I say \*(L"estimates\*(R" and not \*(L"calculates\*(R" because computing the exact size would require many more calculations than the way it is done now. One may objects that there are only additions, which is correct, but knowing the \fIexact\fR size is not necessary. Indeed, if you compile the \s-1WML\s0, most of the strings of the tags will be removed, but not all. .PP For example, take an image tag: \&\f(CW\*(C`<img src="images/dog.jpg" alt="Photo of a dog">\*(C'\fR. When compiled, the string \f(CW\*(C`"img"\*(C'\fR will be replaced by a one byte value. Same thing for the strings \f(CW\*(C`"src"\*(C'\fR and \f(CW\*(C`"alt"\*(C'\fR, and the spaces, double quotes and equal signs will be stripped. Only the text between double quote will be preserved... but not in every cases. Indeed, in order to go a step further, the compiler can also encode parts of the arguments as binary. For example, the string \f(CW\*(C`"http://www."\*(C'\fR can be encoded as a single byte (\f(CW\*(C`8F\*(C'\fR in this case). Or, if the attribute is \f(CW\*(C`href\*(C'\fR, the string \f(CW\*(C`href="http://\*(C'\fR can become the byte \f(CW\*(C`4B\*(C'\fR. .PP As you see, it doesn't matter to know exactly the size of the textual form of the \s-1WML\s0, as it will always be far superior to the size of the compiled form. That's why I don't count all the characters that may be actually written. .PP Also, it's because I'm quite lazy ;\-) .Sh "Why compiling the \s-1WML\s0 deck?" .IX Subsection "Why compiling the WML deck?" If you intent to create real \s-1WML\s0 pages, you should really consider to always compile them. If you're not convinced, here is an illustration. .PP Take the following \s-1WML\s0 code snipet: .PP .Vb 1 \& <a href='http://www.yahoo.com/'>Yahoo!</a> .Ve It's the basic and classical way to code an hyperlink. It takes 42 bytes to code this, because it is presented in a human-readable form. .PP The \s-1WAP\s0 Forum has defined a compact binary representation of \s-1WML\s0 in its specification, which is called \*(L"compiled \s-1WML\s0\*(R". It's a binary format, therefore you, a mere human, can't read that, but your computer can. And it's much faster for it to read a binary format than to read a textual format. .PP The previous example would be, once compiled (and printed here as hexadecimal): .PP .Vb 1 \& 1C 4A 8F 03 y a h o o 00 85 01 03 Y a h o o ! 00 01 .Ve This only takes 21 bytes. Half the size of the human-readable form. For a Wap device, this means both less to download, and easier things to read. Therefore the processing of the document can be achieved in a short time compared to the tectual version of the same document. .PP There is a last argument, and not the less important: many Wap devices only read binary \s-1WML\s0. .SH "ACTIONS" .IX Header "ACTIONS" Actions are a feature similar to (but with far less functionalities!) the \&\s-1SSI\s0 (Server Side Includes) available on good servers like Apache. In order not to interfere with the real \s-1SSI\s0, but to keep the syntax easy to learn, it differs in very few points. .Sh "Syntax" .IX Subsection "Syntax" Basically, the syntax to execute an action is: .PP .Vb 1 \& <!-- [action param1="value" param2='value'] --> .Ve Note that the angle brackets are part of the syntax. Except for that point, Actions syntax is very similar to \s-1SSI\s0 syntax. .Sh "Available actions" .IX Subsection "Available actions" Only few actions are currently available, but more can be implemented on request. .Ip "include" 4 .IX Item "include" .RS 4 .Ip "Description" 8 .IX Item "Description" Includes a file in the document at the current point. Please note that Html2Wml doesn't check nor parse the file, and if the file cannot be found, will silently die (this is the same behavior as \s-1SSI\s0). .Ip "Parameters" 8 .IX Item "Parameters" \&\f(CW\*(C`virtual=url\*(C'\fR \*(-- The file is get by http. .Sp \&\f(CW\*(C`file=path\*(C'\fR \*(-- The file is read from the local disk. .RE .RS 4 .RE .Ip "fsize" 4 .IX Item "fsize" .RS 4 .Ip "Description" 8 .IX Item "Description" Returns the size of a file at the current point of the document. .Ip "Parameters" 8 .IX Item "Parameters" \&\f(CW\*(C`virtual=url\*(C'\fR \*(-- The file is get by http. .Sp \&\f(CW\*(C`file=path\*(C'\fR \*(-- The file is read from the local disk. .Ip "Notes" 8 .IX Item "Notes" If you use the file parameter, an absolute path is recommend. .RE .RS 4 .RE .Ip "skip" 4 .IX Item "skip" .RS 4 .Ip "Description" 8 .IX Item "Description" Skips everything until the first \f(CW\*(C`end_skip\*(C'\fR action. .RE .RS 4 .RE .Sh "Generic parameters" .IX Subsection "Generic parameters" The following parameters can be used for any action. .Ip "for=\fIoutput format\fR" 4 .IX Item "for=output format" This paramater restricts the action for the given output format. Currently, the only available format is "\f(CW\*(C`wml\*(C'\fR" (when using \f(CW\*(C`html2chtml\*(C'\fR the format is "\f(CW\*(C`chtml\*(C'\fR"). .Sh "Examples" .IX Subsection "Examples" If you want to share a navigation bar between several \s-1WML\s0 pages, you can \&\f(CW\*(C`include\*(C'\fR it this way: .PP .Vb 1 \& <!-- [include virtual="nav.wml"] --> .Ve Of course, you have to write this navigation bar first :\-) .PP If you want to use your current \s-1HTML\s0 pages for creating your \s-1WML\s0 pages, but that they contains complex tables, or unecessary navigation tables, etc, you can simply \f(CW\*(C`skip\*(C'\fR the complex parts and keep the rest. .PP .Vb 6 \& <body> \& <!--[skip for="wml"]--> \& unecessary parts for the WML pages \& <!--[end_skip]--> \& useful parts for the WML pages \& </body> .Ve .SH "LINKS RECONSTRUCTION" .IX Header "LINKS RECONSTRUCTION" The links reconstruction engine is \s-1IMHO\s0 the most important part of Html2Wml, because it's this engine that allows you to reconstruct the links of the \s-1HTML\s0 document being converted. It has two modes, depending upon whether Html2Wml was launched from the shell or as a \s-1CGI\s0. .PP When used as a \s-1CGI\s0, this engine will reconstructs the links of the \s-1HTML\s0 document so that all the urls will be passed to Html2Wml in order to convert the pointed files (pages or images). This is completly automatic and can't be customized for now (but I don't think it would be really useful). .PP When used from the shell, this engine reconstructs the links with the given templates. Note that absolute URLs will be left untouched. The templates can be customized using the following syntax. .Sh "Templates" .IX Subsection "Templates" .Ip "\s-1HREF\s0 Template" 4 .IX Item "HREF Template" This template controls the reconstruction of the \f(CW\*(C`href\*(C'\fR attribute of the \f(CW\*(C`A\*(C'\fR tag. Its value can be changed using the \fB\*(--hreftmpl\fR option. Default value is \&\f(CW\*(C`"{FILEPATH}{FILENAME}{$FILETYPE =~ s/s?html?/wml/o; $FILETYPE}"\*(C'\fR. .Ip "Image Source Template" 4 .IX Item "Image Source Template" This template controls the reconstruction of the \f(CW\*(C`src\*(C'\fR attribute of the \f(CW\*(C`IMG\*(C'\fR tag. Its value can be changed using the \fB\*(--srctmpl\fR option. Default value is \&\f(CW\*(C`"{FILEPATH}{FILENAME}{$FILETYPE =~ s/gif|png|jpe?g/wbmp/o; $FILETYPE}"\*(C'\fR .Sh "Syntax" .IX Subsection "Syntax" The template is a string that contains the new \s-1URL\s0. More precisely, it's a Text::Template template. Parameters can be interpolated as a constant or as a variable. The template is embraced between curcly bracets, and can contain any valid Perl code. .PP The simplest form of a template is \f(CW\*(C`{PARAM}\*(C'\fR which just returns the value of \s-1PARAM\s0. If you want to do something more complex, you can use the corresponding variable; for example \f(CW\*(C`{"foo $PARAM bar"}\*(C'\fR, or \&\f(CW\*(C`{join "_", split " ", PARAM}\*(C'\fR. .PP You may read the Text::Template manpage for more information on what is possible within a template. .PP If the original \s-1URL\s0 contained a query part or a fragment part, then they will be appended to the result of the template. .Sh "Available parameters" .IX Subsection "Available parameters" .Ip "\s-1URL\s0" 4 .IX Item "URL" This parameter contains the original \s-1URL\s0 from the \f(CW\*(C`href\*(C'\fR or \f(CW\*(C`src\*(C'\fR attribute. .Ip "\s-1FILENAME\s0" 4 .IX Item "FILENAME" This parameter contains the base name of the file. .Ip "\s-1FILEPATH\s0" 4 .IX Item "FILEPATH" This parameter contains the leading path of the file. .Ip "\s-1FILETYPE\s0" 4 .IX Item "FILETYPE" This parameter contains the suffix of the file. .PP This can be resumed this way: .PP .Vb 5 \& URL = http://www.server.net/path/to/my/page.html \& ------------^^^^ ---- \& | | \e \& | | \e \& FILEPATH FILENAME FILETYPE .Ve Note that \f(CW\*(C`FILETYPE\*(C'\fR contains all the extensions of the file, so if its name is \fIindex.html.fr\fR for example, \f(CW\*(C`FILETYPE\*(C'\fR contains "\f(CW\*(C`.html.fr\*(C'\fR". .Sh "Examples" .IX Subsection "Examples" To add a path option: .PP .Vb 1 \& {URL}$wap .Ve Using Apache, you can then add a Rewrite directive so that \s-1URL\s0 ending with \&\f(CW\*(C`$wap\*(C'\fR will be redirected to Html2Wml: .PP .Vb 1 \& RewriteRule ^(/.*)\e$wap$ /cgi-bin/html2wml.cgi?url=$1 .Ve To change the extension of an image: .PP .Vb 1 \& {FILEPATH}{FILENAME}.wbmp .Ve .SH "PROXY SUPPORT" .IX Header "PROXY SUPPORT" Html2Wml uses \s-1LWP\s0 built-in proxy support. It is activated by default, and loads the proxy settings from the environment variables, using the same variables as many others programs. Each protocol (http, ftp, etc) can be mapped to use a proxy server by setting a variable of the form \f(CW\*(C`PROTOCOL_proxy\*(C'\fR. Example: use \f(CW\*(C`http_proxy\*(C'\fR to define the proxy for http access, \f(CW\*(C`ftp_proxy\*(C'\fR for ftp access. In the shell, this is only a matter of defining the variable. .PP For Bourne shell: .PP .Vb 1 \& $ export http_proxy="http://proxy.domain.com:8080/" .Ve For C-shell: .PP .Vb 1 \& % setenv http_proxy "http://proxy.domain.com:8080/" .Ve Under Apache, you can add this directive to your configuration file: .PP .Vb 1 \& SetEnv http_proxy "http://proxy.domain.com:8080" .Ve but this has the default that another \s-1CGI\s0, or another program, can use this to access external ressources. A better way is to edit Html2Wml and fill the option \f(CW\*(C`proxy\-server\*(C'\fR with the appropriate value. .SH "CAVEATS" .IX Header "CAVEATS" Html2Wml tries to make correct \s-1WML\s0 documents, but the well-formedness and the validity of the document are not guarantied. .PP Inverted tags (like "<b>bold <i>italic</b></i>") may produce unexpected results. But only bad softwares do bad stuff like this. .SH "LINKS" .IX Header "LINKS" .Sh "Download" .IX Subsection "Download" .Ip "Html2Wml" 4 .IX Item "Html2Wml" This is the web site of the Html2Wml project, hosted by SourceForge.net. All the stable releases can be downloaded from this site. .Sp [ http://www.html2wml.org/ ] .Ip "Nutialand" 4 .IX Item "Nutialand" This is the web site of the author, where you can find the archives of all the releases of Html2Wml. .Sp [ http://www.maddingue.org/softwares/ ] .Sh "Resources" .IX Subsection "Resources" .Ip "The \s-1WAP\s0 Forum" 4 .IX Item "The WAP Forum" This is the official site of the \s-1WAP\s0 Forum. You can find some technical information, as the specifications of all the technologies associated with the \s-1WAP\s0. .Sp [ http://www.wapforum.org/ ] .Ip "\s-1WAP\s0.com" 4 .IX Item "WAP.com" This site has some useful information and links. In particular, it has a quite well done \s-1FAQ\s0. .Sp [ http://www.wap.com/ ] .Ip "The World Wide Web Consortium" 4 .IX Item "The World Wide Web Consortium" Altough not directly related to the Wap stuff, you may find useful to read the specifications of the \s-1XML\s0 (\s-1WML\s0 is an \s-1XML\s0 application), and the specifications of the different stylesheet languages (\s-1CSS\s0 and \s-1XSL\s0), which include support for low-resolution devices. .Sp [ http://www.w3.org/ ] .Ip "TuxMobil" 4 .IX Item "TuxMobil" This web site is dedicated to Mobile UniX systems. It leads you to a lot of useful hands-on information about installing and running Linux and \s-1BSD\s0 on laptops, PDAs and other mobile computer devices. .Sp [ http://www.tuxmobil.org/ ] .Sh "Programmers utilities" .IX Subsection "Programmers utilities" .Ip "\s-1HTML\s0 Tidy" 4 .IX Item "HTML Tidy" This is a very handful utility which corrects your \s-1HTML\s0 files so that they conform to W3C standards. .Sp [ http://www.w3.org/People/Raggett/tidy ] .Ip "Kannel" 4 .IX Item "Kannel" Kannel is an open source Wap and \s-1SMS\s0 gateway. A \s-1WML\s0 compiler is included in the distribution. .Sp [ http://www.kannel.org/ ] .Ip "\s-1WML\s0 Tools" 4 .IX Item "WML Tools" This is a collection of utilities for \s-1WML\s0 programmers. This include a compiler, a decompiler, a viewer and a \s-1WBMP\s0 converter. .Sp [ http://pwot.co.uk/wml/ ] .Sh "\s-1WML\s0 browsers and Wap emulators" .IX Subsection "WML browsers and Wap emulators" .Ip "Opera" 4 .IX Item "Opera" Opera is originaly a Web browser, but the version 5 has a good support for \s-1XML\s0 and \s-1WML\s0. Opera is available for free for several systems. .Sp [ http://www.opera.com/ ] .Ip "wApua" 4 .IX Item "wApua" wApua is an open source \s-1WML\s0 browser written in Perl/Tk. It's easy to intall and to use. Its support for \s-1WML\s0 is incomplete, but sufficient for testing purpose. .Sp [ http://fsinfo.cs.uni-sb.de/~abe/wApua/ ] .Ip "Tofoa" 4 .IX Item "Tofoa" Tofoa is an open source Wap emulator written in Python. Its installation is quite difficult, and its incomplete \s-1WML\s0 support makes it produce strange results, even with valid \s-1WML\s0 documents. .Sp [ http://tofoa.free-system.com/ ] .Ip "EzWAP" 4 .IX Item "EzWAP" EzWAP, from \s-1EZOS\s0, is a commercial \s-1WML\s0 browser freely available for Windows 9x, \s-1NT\s0, 2000 and \s-1CE\s0. Compared to others Windows \s-1WML\s0 browsers, it requires very few resources, and is quite stable. Its support for the \s-1WML\s0 specs seems quite complete. A very good software. .Sp [ http://www.ezos.com/ ] .Ip "Deck-It" 4 .IX Item "Deck-It" Deck-It is a commercial Wap phone emulator, available for Windows and Linux/Intel only. It's a very good piece of software which really show how \s-1WML\s0 pages are rendered on a Wap phone, but one of its major default is that it cannot read local files. .Sp [ http://www.pyweb.com/tools/ ] .Ip "Klondike \s-1WAP\s0 Browser" 4 .IX Item "Klondike WAP Browser" Klondike \s-1WAP\s0 Browser is a commercial \s-1WAP\s0 browser available for Windows and PocketPC. .Sp [ http://www.apachesoftware.com/ ] .Ip "WinWAP" 4 .IX Item "WinWAP" WinWAP is a commercial Wap browser, freely available for Windows. .Sp [ http://www.winwap.org/ ] .Ip "WAPman" 4 .IX Item "WAPman" WAPman from EdgeMatrix, is a commercial \s-1WAP\s0 browser available for Windows and PalmOS. .Sp [ http://www.edgematrix.com/edge/control/MainContentBean?page=downloads ] .Ip "Wireless Companion" 4 .IX Item "Wireless Companion" Wireless Companion, from YourWap.com, is a \s-1WAP\s0 emulator available for Windows. .Sp [ http://www.yourwap.com/ ] .Ip "Mobilizer" 4 .IX Item "Mobilizer" Mobilizer is a Wap emulator available for Windows and Unix. .Sp [ http://mobilizer.sourceforge.net/ ] .Ip "QWmlBrowser" 4 .IX Item "QWmlBrowser" QWmlBrowser (formerly known as \s-1WML\s0 BRowser) is an open source \&\s-1WML\s0 browser, written using the Qt toolkit. .Sp [ http://www.wmlbrowser.org/ ] .Ip "Wapsody" 4 .IX Item "Wapsody" Wapsody, developed by \s-1IBM\s0, is a freely available simulation environment that implements the \s-1WAP\s0 specification. It also features a \s-1WML\s0 browser which can be run stand-alone. As Wapsody is written in Java/Swing, it should work on any system. .Sp [ http://alphaworks.ibm.com/aw.nsf/techmain/wapsody ] .Ip "WAPreview" 4 .IX Item "WAPreview" WAPreview is a Wap emulator written in Java. As it uses an \s-1HTML\s0 based \s-1UI\s0 and needs a local web proxy, it runs quite slowly. .Sp [ http://wapreview.sourceforge.net ] .Ip "PicoWap" 4 .IX Item "PicoWap" PicoWap is a small \s-1WML\s0 browser made by three French students. .Sp [ http://membres.lycos.fr/picowap/ ] .SH "ACKNOWLEDGEMENTS" .IX Header "ACKNOWLEDGEMENTS" Werner Heuser, for his numerous ideas, advices and his help for the debugging .PP Igor Khristophorov, for his numerous suggestions and patches .PP And all the people that send me bug reports: Daniele Frijia, Axel Jerabek, Ouyang .SH "AUTHOR" .IX Header "AUTHOR" Se\*'bastien Aperghis-Tramoni <sebastien@aperghis.net<gt> .SH "COPYRIGHT" .IX Header "COPYRIGHT" Copyright (C)2000, 2001, 2002 Se\*'bastien Aperghis-Tramoni .PP This program is free software. You can redistribute it and/or modify it under the terms of the \s-1GNU\s0 General Public License, version 2 or later. ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������html2wml-0.4.11/doc/Makefile������������������������������������������������������������������������0100644�0000765�0000024�00000001404�07746772372�0015455�0����������������������������������������������������������������������������������������������������ustar�00maddingue�����������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������POD=readme.pod TITLE:="Html2Wml Documentation" help: @echo "available targets: " @echo " doc rebuild the documentation" @echo " install install the documentation" install: @install -m 444 *.pod *.html *.pdf $(DOCDIR)/ doc: @echo "[ writing html doc ]" @pod2html --infile="${POD}" --outfile="readme.html" --title=\"${TITLE}\" --norecurse --index --verbose --css=style.css @./mkhtml @rm -f pod2htm*.x~~ @echo "[ writing text doc ]" @pod2text ${POD} > readme.txt @echo "[ writing nroff doc ]" @pod2man --center=\"${TITLE}\" --release=${VERSION} ${POD} > html2wml.man @echo "[ writing pdf doc ]" @perl -p -e '/=for html/ and <>, <>, next' ${POD} > Html2Wml @pod2pdf --verbose 1 --podfile Html2Wml @mv Html2Wml.pdf readme.pdf @rm Html2Wml ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������html2wml-0.4.11/doc/mkhtml��������������������������������������������������������������������������0100755�0000765�0000024�00000000575�07746772372�0015247�0����������������������������������������������������������������������������������������������������ustar�00maddingue�����������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������#!/bin/sh perl -pi -e '/name="__index__"/i .. s|<ul>|<ul id="index"><b>Table of contents</b>|i' *.html perl -pi -e 's|^<link|<link rel="home" href="http://html2wml.org/">\n<link|i' *.html perl -pi -e 's|root\@law.uucp|mad\@maddingue.org|' *.html perl -e 'while($f=shift){open(F,$f)||die$!;$/=undef;$s=<F>;$s=~s|</pre>\n<pre>||gi;open(F,">$f")||die$!;print F $s;close(F);}' *.html �����������������������������������������������������������������������������������������������������������������������������������html2wml-0.4.11/doc/readme.html���������������������������������������������������������������������0100644�0000765�0000024�00000102370�07746772372�0016144�0����������������������������������������������������������������������������������������������������ustar�00maddingue�����������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������<html> <head> <title>"Html2Wml Documentation"


NAME

Html2Wml -- Program that can convert HTML pages to WML pages


SYNOPSIS

Html2Wml can be used as either a shell command:

  $ html2wml file.html

or as a CGI:

  /cgi-bin/html2wml.cgi?url=/index.html

In both cases, the file can be either a local file or a URL.


DESCRIPTION

Html2Wml converts HTML pages to WML decks, suitable for being viewed on a Wap device. The program can be launched from a shell to statically convert a set of pages, or as a CGI to convert a particular (potentially dynamic) HTML resource.

Althought the result is not guarantied to be valid WML, it should be the case for most pages. Good HTML pages will most probably produce valid WML decks. To check and correct your pages, you can use W3C's softwares: the HTML Validator, available online at http://validator.w3.org and HTML Tidy, written by Dave Raggett.

Html2Wml provides the following features:


OPTIONS

Please note that most of these options are also available when calling Html2Wml as a CGI. In this case, boolean options are given the value ``1'' or ``0'', and other options simply receive the value they expect. For example, --ascii becomes ?ascii=1 or ?a=1. See the file t/form.html for an example on how to call Html2Wml as a CGI.

Conversion Options

-a, --ascii
When this option is on, named HTML entities and non-ASCII characters are converted to US-ASCII characters using the same 7 bit approximations as Lynx. For example, &copy; is translated to ``(c)'', and &szlig; is translated to ``ss''. This option is off by default.

--[no]collapse
This option tells Html2Wml to collapse redundant whitespaces, tabulations, carriage returns, lines feeds and empty paragraphs. The aim is to reduce the size of the WML document as much as possible. Collapsing empty paragraphs is necessary for two reasons. First, this avoids empty screens (and on a device with only 4 lines of display, an empty screen can be quite ennoying). Second, Html2wml creates many empty paragraphs when converting, because of the way the syntax reconstructor is programmed. Deleting these empty paragraphs is necessary like cleaning the kitchen :-)

If this really bother you, you can desactivate this behaviour with the --nocollapse option.

--ignore-images
This option tells Html2Wml to completly ignore all image links.

--[no]img-alt-text
This option tells Html2Wml to replace the image tags with their corresponding alternative text (as with a text mode web browser). This option is on by default.

--[no]linearize
This option is on by default. This makes Html2Wml flattens the HTML tables (they are linearized), as Lynx does. I think this is better than trying to use the native WML tables. First, they have extremely limited features and possibilities compared to HTML tables. In particular, they can't be nested. In fact this is normal because Wap devices are not supposed to have a big CPU running at some zillions-hertz, and the calculations needed to render the tables are the most complicated and CPU-hogger part of HTML.

Second, as they can't be nested, and as typical HTML pages heavily use imbricated tables to create their layout, it's impossible to decide which one could be kept. So the best thing is to keep none of them.

[Note] Although you can desactivate this behaviour, and although there is internal support for tables, the unlinearized mode has not been heavily tested with nested tables, and it may produce unexpected results.

-n, --numeric-non-ascii
This option tells Html2wml to convert all non-ASCII characters to numeric entities, i.e., ``é'' becomes &#233;, and ``ß'' becomes &#223;. By default, this option is off.

-p, --nopre
This options tells Html2Wml not to use the <pre> tag. This option was added because the compiler from WML Tools 0.0.4 doesn't support this tag.

Links Reconstruction Options

--hreftmpl=TEMPLATE
This options sets the template that will be used to reconstruct the href-type links. See LINKS RECONSTRUCTION for more information.

--srctmpl=TEMPLATE
This option sets the template that will be used to reconstruct the src-type links. See LINKS RECONSTRUCTION for more information.

Splitting Options

-s, --max-card-size=SIZE
This option allows you to limit the size (in bytes) of the generated cards. Default is 1,500 bytes, which should be small enought to be loaded on most Wap devices. See DECK SLICING for more information.

-t, --card-split-threshold=SIZE
This option sets the threshold of the split event, which can occur when the size of the current card is between max-card-size - card-split-threshold and max-card-size. Default value is 50. See DECK SLICING for more information.

--next-card-label=STRING
This options sets the label of the link that points to the next card. Default is ``[&gt;&gt;]'', which whill be rendered as ``[>>]''.

--prev-card-label=STRING
This options sets the label of the link that points to the previous card. Default is ``[&lt;&lt;]'', which whill be rendered as ``[<<]''.

HTTP Authentication

-U, --http-user=USERNAME
Use this option to set the username for an authenticated request.

-P, --http-passwd=PASSWORD
Use this option to set the password for an authenticated request.

Proxy Support

-[no]Y, --[no]proxy
Use this option to activate proxy support. By default, proxy support is activated. See PROXY SUPPORT.

Output Options

-k, --compile
Setting this option tells Html2Wml to use the compiler from WML Tools to compile the WML deck. If you want to create a real Wap site, you should seriously use this option in order to reduce the size of the WML decks. Remember that Wap devices have very little amount of memory. If this is not enought, use the splitting options.

Take a look in wml_compilation/ for more information on how to use a WML compiler with Html2Wml.

-o, --output
Use this option (in shell mode) to specify an output file. By default, Html2Wml prints the result to standard output.

Debugging Options

-d, --debug[=LEVEL]
This option activates the debug mode. This prints the output result with line numbering and with the result of the XML check. If the WML compiler was called, the result is also printed in hexadecimal an ascii forms. When called as a CGI, all of this is printed as HTML, so that can use any web browser for that purpose.

--xmlcheck
When this option is on, it send the WML output to XML::Parser to check its well-formedness.


DECK SLICING

The deck slicing is a feature that Html2Wml provides in order to match the low memory capabilities of most Wap devices. Many can't handle cards larger than 2,000 bytes, therefore the cards must be sufficiently small to be viewed by all Wap devices. To achieve this, you should compile your WML deck, which reduce the size of the deck by 50%, but even then your cards may be too big. This is where Html2Wml comes with the deck slicing feature. This allows you to limit the size of the cards, currently only before the compilation stage.

Slice by cards or by decks

On some Wap phones, slicing the deck is not sufficient: the WML browser still tries to download the whole deck instead of just picking one card at a time. A solution is to slice the WML document by decks. See the figure below.

     _____________          _____________ 
    |    deck     |        |   deck #1   |
    |  _________  |        |  _________  |
    | | card #1 | |        | |  card   | |
    | |_________| |        | |_________| |
    |  _________  |        |_____________|
    | | card #2 | |        
    | |_________| |             . . .
    |  _________  |        
    | |   ...   | |         _____________
    | |_________| |        |   deck #n   |
    |  _________  |        |  _________  |
    | | card #n | |        | |  card   | |
    | |_________| |        | |_________| |
    |_____________|        |_____________|


      WML document           WML document
    sliced by cards        sliced by decks

What this means is that Html2Wml generates several WML documents. In CGI mode, only the appropriate deck is sent, selected by the id given in parameter. If no id was given, the first deck is sent.

Note on size calculation

Currently, Html2Wml estimates the size of the card on the fly, by summing the length of the strings that compose the WML output, texts and tags. I say ``estimates'' and not ``calculates'' because computing the exact size would require many more calculations than the way it is done now. One may objects that there are only additions, which is correct, but knowing the exact size is not necessary. Indeed, if you compile the WML, most of the strings of the tags will be removed, but not all.

For example, take an image tag: <img src="images/dog.jpg" alt="Photo of a dog">. When compiled, the string "img" will be replaced by a one byte value. Same thing for the strings "src" and "alt", and the spaces, double quotes and equal signs will be stripped. Only the text between double quote will be preserved... but not in every cases. Indeed, in order to go a step further, the compiler can also encode parts of the arguments as binary. For example, the string "http://www." can be encoded as a single byte (8F in this case). Or, if the attribute is href, the string href="http:// can become the byte 4B.

As you see, it doesn't matter to know exactly the size of the textual form of the WML, as it will always be far superior to the size of the compiled form. That's why I don't count all the characters that may be actually written.

Also, it's because I'm quite lazy ;-)

Why compiling the WML deck?

If you intent to create real WML pages, you should really consider to always compile them. If you're not convinced, here is an illustration.

Take the following WML code snipet:

    <a href='http://www.yahoo.com/'>Yahoo!</a>

It's the basic and classical way to code an hyperlink. It takes 42 bytes to code this, because it is presented in a human-readable form.

The WAP Forum has defined a compact binary representation of WML in its specification, which is called ``compiled WML''. It's a binary format, therefore you, a mere human, can't read that, but your computer can. And it's much faster for it to read a binary format than to read a textual format.

The previous example would be, once compiled (and printed here as hexadecimal):

    1C 4A 8F 03 y a h o o 00 85 01 03 Y a h o o ! 00 01

This only takes 21 bytes. Half the size of the human-readable form. For a Wap device, this means both less to download, and easier things to read. Therefore the processing of the document can be achieved in a short time compared to the tectual version of the same document.

There is a last argument, and not the less important: many Wap devices only read binary WML.


ACTIONS

Actions are a feature similar to (but with far less functionalities!) the SSI (Server Side Includes) available on good servers like Apache. In order not to interfere with the real SSI, but to keep the syntax easy to learn, it differs in very few points.

Syntax

Basically, the syntax to execute an action is:

    <!-- [action param1="value" param2='value'] -->

Note that the angle brackets are part of the syntax. Except for that point, Actions syntax is very similar to SSI syntax.

Available actions

Only few actions are currently available, but more can be implemented on request.

include
Description
Includes a file in the document at the current point. Please note that Html2Wml doesn't check nor parse the file, and if the file cannot be found, will silently die (this is the same behavior as SSI).

Parameters
virtual=url -- The file is get by http.

file=path -- The file is read from the local disk.

fsize
Description
Returns the size of a file at the current point of the document.

Parameters
virtual=url -- The file is get by http.

file=path -- The file is read from the local disk.

Notes
If you use the file parameter, an absolute path is recommend.

skip
Description
Skips everything until the first end_skip action.

Generic parameters

The following parameters can be used for any action.

for=output format
This paramater restricts the action for the given output format. Currently, the only available format is ``wml'' (when using html2chtml the format is ``chtml'').

Examples

If you want to share a navigation bar between several WML pages, you can include it this way:

    <!-- [include virtual="nav.wml"] -->

Of course, you have to write this navigation bar first :-)

If you want to use your current HTML pages for creating your WML pages, but that they contains complex tables, or unecessary navigation tables, etc, you can simply skip the complex parts and keep the rest.

    <body>
    <!--[skip for="wml"]-->
    unecessary parts for the WML pages
    <!--[end_skip]-->
    useful parts for the WML pages
    </body>


LINKS RECONSTRUCTION

The links reconstruction engine is IMHO the most important part of Html2Wml, because it's this engine that allows you to reconstruct the links of the HTML document being converted. It has two modes, depending upon whether Html2Wml was launched from the shell or as a CGI.

When used as a CGI, this engine will reconstructs the links of the HTML document so that all the urls will be passed to Html2Wml in order to convert the pointed files (pages or images). This is completly automatic and can't be customized for now (but I don't think it would be really useful).

When used from the shell, this engine reconstructs the links with the given templates. Note that absolute URLs will be left untouched. The templates can be customized using the following syntax.

Templates

HREF Template
This template controls the reconstruction of the href attribute of the A tag. Its value can be changed using the --hreftmpl option. Default value is "{FILEPATH}{FILENAME}{$FILETYPE =~ s/s?html?/wml/o; $FILETYPE}".

Image Source Template
This template controls the reconstruction of the src attribute of the IMG tag. Its value can be changed using the --srctmpl option. Default value is "{FILEPATH}{FILENAME}{$FILETYPE =~ s/gif|png|jpe?g/wbmp/o; $FILETYPE}"

Syntax

The template is a string that contains the new URL. More precisely, it's a Text::Template template. Parameters can be interpolated as a constant or as a variable. The template is embraced between curcly bracets, and can contain any valid Perl code.

The simplest form of a template is {PARAM} which just returns the value of PARAM. If you want to do something more complex, you can use the corresponding variable; for example {"foo $PARAM bar"}, or {join "_", split " ", PARAM}.

You may read the Text::Template manpage for more information on what is possible within a template.

If the original URL contained a query part or a fragment part, then they will be appended to the result of the template.

Available parameters

URL
This parameter contains the original URL from the href or src attribute.

FILENAME
This parameter contains the base name of the file.

FILEPATH
This parameter contains the leading path of the file.

FILETYPE
This parameter contains the suffix of the file.

This can be resumed this way:

  URL = http://www.server.net/path/to/my/page.html
                             ------------^^^^ ----
                                 |        |     \
                                 |        |      \
                              FILEPATH FILENAME FILETYPE

Note that FILETYPE contains all the extensions of the file, so if its name is index.html.fr for example, FILETYPE contains ``.html.fr''.

Examples

To add a path option:

    {URL}$wap

Using Apache, you can then add a Rewrite directive so that URL ending with $wap will be redirected to Html2Wml:

    RewriteRule  ^(/.*)\$wap$  /cgi-bin/html2wml.cgi?url=$1

To change the extension of an image:

    {FILEPATH}{FILENAME}.wbmp


PROXY SUPPORT

Html2Wml uses LWP built-in proxy support. It is activated by default, and loads the proxy settings from the environment variables, using the same variables as many others programs. Each protocol (http, ftp, etc) can be mapped to use a proxy server by setting a variable of the form PROTOCOL_proxy. Example: use http_proxy to define the proxy for http access, ftp_proxy for ftp access. In the shell, this is only a matter of defining the variable.

For Bourne shell:

    $ export http_proxy="http://proxy.domain.com:8080/";

For C-shell:

    % setenv http_proxy "http://proxy.domain.com:8080/";

Under Apache, you can add this directive to your configuration file:

    SetEnv http_proxy "http://proxy.domain.com:8080";

but this has the default that another CGI, or another program, can use this to access external ressources. A better way is to edit Html2Wml and fill the option proxy-server with the appropriate value.


CAVEATS

Html2Wml tries to make correct WML documents, but the well-formedness and the validity of the document are not guarantied.

Inverted tags (like ``<b>bold <i>italic</b></i>'') may produce unexpected results. But only bad softwares do bad stuff like this.


LINKS

Download

Html2Wml
This is the web site of the Html2Wml project, hosted by SourceForge.net. All the stable releases can be downloaded from this site.

[ http://www.html2wml.org/ ]

Nutialand
This is the web site of the author, where you can find the archives of all the releases of Html2Wml.

[ http://www.maddingue.org/softwares/ ]

Resources

The WAP Forum
This is the official site of the WAP Forum. You can find some technical information, as the specifications of all the technologies associated with the WAP.

[ http://www.wapforum.org/ ]

WAP.com
This site has some useful information and links. In particular, it has a quite well done FAQ.

[ http://www.wap.com/ ]

The World Wide Web Consortium
Altough not directly related to the Wap stuff, you may find useful to read the specifications of the XML (WML is an XML application), and the specifications of the different stylesheet languages (CSS and XSL), which include support for low-resolution devices.

[ http://www.w3.org/ ]

TuxMobil
This web site is dedicated to Mobile UniX systems. It leads you to a lot of useful hands-on information about installing and running Linux and BSD on laptops, PDAs and other mobile computer devices.

[ http://www.tuxmobil.org/ ]

Programmers utilities

HTML Tidy
This is a very handful utility which corrects your HTML files so that they conform to W3C standards.

[ http://www.w3.org/People/Raggett/tidy ]

Kannel
Kannel is an open source Wap and SMS gateway. A WML compiler is included in the distribution.

[ http://www.kannel.org/ ]

WML Tools
This is a collection of utilities for WML programmers. This include a compiler, a decompiler, a viewer and a WBMP converter.

[ http://pwot.co.uk/wml/ ]

WML browsers and Wap emulators

Opera
Opera is originaly a Web browser, but the version 5 has a good support for XML and WML. Opera is available for free for several systems.

[ http://www.opera.com/ ]

wApua
wApua is an open source WML browser written in Perl/Tk. It's easy to intall and to use. Its support for WML is incomplete, but sufficient for testing purpose.

[ http://fsinfo.cs.uni-sb.de/~abe/wApua/ ]

Tofoa
Tofoa is an open source Wap emulator written in Python. Its installation is quite difficult, and its incomplete WML support makes it produce strange results, even with valid WML documents.

[ http://tofoa.free-system.com/ ]

EzWAP
EzWAP, from EZOS, is a commercial WML browser freely available for Windows 9x, NT, 2000 and CE. Compared to others Windows WML browsers, it requires very few resources, and is quite stable. Its support for the WML specs seems quite complete. A very good software.

[ http://www.ezos.com/ ]

Deck-It
Deck-It is a commercial Wap phone emulator, available for Windows and Linux/Intel only. It's a very good piece of software which really show how WML pages are rendered on a Wap phone, but one of its major default is that it cannot read local files.

[ http://www.pyweb.com/tools/ ]

Klondike WAP Browser
Klondike WAP Browser is a commercial WAP browser available for Windows and PocketPC.

[ http://www.apachesoftware.com/ ]

WinWAP
WinWAP is a commercial Wap browser, freely available for Windows.

[ http://www.winwap.org/ ]

WAPman
WAPman from EdgeMatrix, is a commercial WAP browser available for Windows and PalmOS.

[ http://www.edgematrix.com/edge/control/MainContentBean?page=downloads ]

Wireless Companion
Wireless Companion, from YourWap.com, is a WAP emulator available for Windows.

[ http://www.yourwap.com/ ]

Mobilizer
Mobilizer is a Wap emulator available for Windows and Unix.

[ http://mobilizer.sourceforge.net/ ]

QWmlBrowser
QWmlBrowser (formerly known as WML BRowser) is an open source WML browser, written using the Qt toolkit.

[ http://www.wmlbrowser.org/ ]

Wapsody
Wapsody, developed by IBM, is a freely available simulation environment that implements the WAP specification. It also features a WML browser which can be run stand-alone. As Wapsody is written in Java/Swing, it should work on any system.

[ http://alphaworks.ibm.com/aw.nsf/techmain/wapsody ]

WAPreview
WAPreview is a Wap emulator written in Java. As it uses an HTML based UI and needs a local web proxy, it runs quite slowly.

[ http://wapreview.sourceforge.net ]

PicoWap
PicoWap is a small WML browser made by three French students.

[ http://membres.lycos.fr/picowap/ ]


ACKNOWLEDGEMENTS

Werner Heuser, for his numerous ideas, advices and his help for the debugging

Igor Khristophorov, for his numerous suggestions and patches

And all the people that send me bug reports: Daniele Frijia, Axel Jerabek, Ouyang


AUTHOR

Sébastien Aperghis-Tramoni <sebastien@aperghis.net


COPYRIGHT

Copyright (C)2000, 2001, 2002 Sébastien Aperghis-Tramoni

This program is free software. You can redistribute it and/or modify it under the terms of the GNU General Public License, version 2 or later.

html2wml-0.4.11/doc/readme.pdf010064400007650000024000002400220774677237200157460ustar00maddinguestaff%PDF-1.2 %âãÏÓ 1 0 obj [/CalRGB << /WhitePoint [0.9505 1 1.089] /Gamma [1.8 1.8 1.8] /Matrix [0.4497 0.2446 0.02518 0.3613 0.672 0.1412 0.1845 0.08334 0.9227] >> ] endobj 2 0 obj << /CreationDate (D:20031026172315+0100) /Producer (pod2pdf) /Title (Html2Wml) >> endobj 5 0 obj << /Type /Encoding /Differences [ 0 /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /space /exclam /quotedbl /numbersign /dollar /percent /ampersand /quoteright /parenleft /parenright /asterisk /plus /comma /hyphen /period /slash /zero /one /two /three /four /five /six /seven /eight /nine /colon /semicolon /less /equal /greater /question /at /A /B /C /D /E /F /G /H /I /J /K /L /M /N /O /P /Q /R /S /T /U /V /W /X /Y /Z /bracketleft /backslash /bracketright /asciicircum /underscore /quoteleft /a /b /c /d /e /f /g /h /i /j /k /l /m /n /o /p /q /r /s /t /u /v /w /x /y /z /braceleft /bar /braceright /asciitilde /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /emdash /dotlessi /grave /acute /circumflex /tilde /macron /breve /dotaccent /dieresis /.notdef /ring /cedilla /.notdef /hungarumlaut /ogonek /caron /space /exclamdown /cent /sterling /currency /yen /brokenbar /section /dieresis /copyright /ordfeminine /guillemotleft /logicalnot /hyphen /registered /macron /degree /plusminus /twosuperior /threesuperior /acute /mu /paragraph /periodcentered /cedilla /onesuperior /ordmasculine /guillemotright /onequarter /onehalf /threequarters /questiondown /Agrave /Aacute /Acircumflex /Atilde /Adieresis /Aring /AE /Ccedilla /Egrave /Eacute /Ecircumflex /Edieresis /Igrave /Iacute /Icircumflex /Idieresis /Eth /Ntilde /Ograve /Oacute /Ocircumflex /Otilde /Odieresis /multiply /Oslash /Ugrave /Uacute /Ucircumflex /Udieresis /Yacute /Thorn /germandbls /agrave /aacute /acircumflex /atilde /adieresis /aring /ae /ccedilla /egrave /eacute /ecircumflex /edieresis /igrave /iacute /icircumflex /idieresis /eth /ntilde /ograve /oacute /ocircumflex /otilde /odieresis /divide /oslash /ugrave /uacute /ucircumflex /udieresis /yacute /thorn /ydieresis ] >> endobj 6 0 obj << /Type /Font /Subtype /Type1 /Name /F00 /Encoding 5 0 R /BaseFont /Times-Roman >> endobj 7 0 obj << /Type /Font /Subtype /Type1 /Name /F01 /Encoding 5 0 R /BaseFont /Times-Bold >> endobj 8 0 obj << /Type /Font /Subtype /Type1 /Name /F02 /Encoding 5 0 R /BaseFont /Times-Italic >> endobj 9 0 obj << /Type /Font /Subtype /Type1 /Name /F03 /Encoding 5 0 R /BaseFont /Times-BoldItalic >> endobj 10 0 obj << /Type /Font /Subtype /Type1 /Name /F10 /Encoding 5 0 R /BaseFont /Courier >> endobj 11 0 obj << /Type /Font /Subtype /Type1 /Name /F11 /Encoding 5 0 R /BaseFont /Courier-Bold >> endobj 12 0 obj << /Type /Font /Subtype /Type1 /Name /F12 /Encoding 5 0 R /BaseFont /Courier-Oblique >> endobj 13 0 obj << /Type /Font /Subtype /Type1 /Name /F13 /Encoding 5 0 R /BaseFont /Courier-BoldOblique >> endobj 14 0 obj << /Type /Font /Subtype /Type1 /Name /F20 /Encoding 5 0 R /BaseFont /Helvetica >> endobj 15 0 obj << /Type /Font /Subtype /Type1 /Name /F21 /Encoding 5 0 R /BaseFont /Helvetica-Bold >> endobj 16 0 obj << /Type /Font /Subtype /Type1 /Name /F22 /Encoding 5 0 R /BaseFont /Helvetica-Oblique >> endobj 17 0 obj << /Type /Font /Subtype /Type1 /Name /F23 /Encoding 5 0 R /BaseFont /Helvetica-BoldOblique >> endobj 0 g 18 0 obj << /Length 19 0 R >> stream 72 792 m 523 792 l S BT 0 G 1 i 0 J 0 j 0.1 w 10 M []0 d /F21 10 Tf 1 0 0 1 72 797 Tm (pod2pdf) Tj 1 0 0 1 474.11 797 Tm (Html2Wml) Tj /F21 12 Tf 1 0 0 1 72.0 764.0 Tm 0.0000 Tw (NAME ) Tj /F00 10 Tf 1 0 0 1 102.0 749.6 Tm 0.0000 Tw (Html2Wml \217 Program that can convert HTML pages to WML pages ) Tj /F21 12 Tf 1 0 0 1 72.0 731.6 Tm 0.0000 Tw (SYNOPSIS ) Tj /F00 10 Tf 1 0 0 1 102.0 717.2 Tm 0.0000 Tw (Html2Wml can be used as either a shell command: ) Tj /F10 10 Tf 1 0 0 1 102.0 705.2 Tm 0.0000 Tw ( $ html2wml file.html ) Tj /F00 10 Tf 1 0 0 1 102.0 681.2 Tm 0.0000 Tw (or as a CGI: ) Tj /F10 10 Tf 1 0 0 1 102.0 669.2 Tm 0.0000 Tw ( /cgi-bin/html2wml.cgi?url=/index.html ) Tj /F00 10 Tf 1 0 0 1 102.0 645.2 Tm 0.0000 Tw (In both cases, the file can be either a local file or a URL. ) Tj /F21 12 Tf 1 0 0 1 72.0 615.2 Tm 0.0000 Tw (DESCRIPTION ) Tj /F00 10 Tf 1 0 0 1 102.0 600.8 Tm 1.6087 Tw (Html2Wml converts HTML pages to WML decks, suitable for being viewed on a Wap device. The) Tj 1 0 0 1 102.0 588.8 Tm 1.3748 Tw (program can be launched from a shell to statically convert a set of pages, or as a CGI to convert a) Tj 1 0 0 1 102.0 576.8 Tm 0.0000 Tw (particular \(potentially dynamic\) HTML resource. ) Tj /F00 10 Tf 1 0 0 1 102.0 564.8 Tm 1.2095 Tw (Althought the result is not guarantied to be valid WML, it should be the case for most pages. Good) Tj 1 0 0 1 102.0 552.8 Tm 0.3418 Tw (HTML pages will most probably produce valid WML decks. To check and correct your pages, you can) Tj 1 0 0 1 102.0 540.8 Tm 0.2714 Tw (use W3C`s softwares: the ) Tj /F02 10 Tf 0.2714 Tw (HTML Validator) Tj /F00 10 Tf 0.2714 Tw (, available online at http://validator.w3.org and ) Tj /F02 10 Tf 0.2714 Tw (HTML Tidy) Tj /F00 10 Tf 0.2714 Tw (,) Tj 1 0 0 1 102.0 528.8 Tm 0.0000 Tw (written by Dave Raggett. ) Tj /F00 10 Tf 1 0 0 1 102.0 516.8 Tm 0.0000 Tw (Html2Wml provides the following features: ) Tj /F20 10 Tf 1 0 0 1 102.0 490.4 Tm 0.0000 Tw () Tj ET q 102 491.4 4 4 re f Q BT 1 0 0 1 110 490.4 Tm /F20 10 Tf 0.0000 Tw ( ) Tj /F00 10 Tf 1 0 0 1 126.0 490.4 Tm 0.0000 Tw (translation of the links ) Tj /F20 10 Tf 1 0 0 1 102.0 476.0 Tm 0.0000 Tw () Tj ET q 102 477 4 4 re f Q BT 1 0 0 1 110 476 Tm /F20 10 Tf 0.0000 Tw ( ) Tj /F00 10 Tf 1 0 0 1 126.0 476.0 Tm 0.0000 Tw (limitation of the cards size by splitting the result into several cards ) Tj /F20 10 Tf 1 0 0 1 102.0 461.6 Tm 0.0000 Tw () Tj ET q 102 462.6 4 4 re f Q BT 1 0 0 1 110 461.6 Tm /F20 10 Tf 0.0000 Tw ( ) Tj /F00 10 Tf 1 0 0 1 126.0 461.6 Tm 0.0000 Tw (inclusion of files \(similar to the SSI\) ) Tj /F20 10 Tf 1 0 0 1 102.0 447.2 Tm 0.0000 Tw () Tj ET q 102 448.2 4 4 re f Q BT 1 0 0 1 110 447.2 Tm /F20 10 Tf 0.0000 Tw ( ) Tj /F00 10 Tf 1 0 0 1 126.0 447.2 Tm 0.0000 Tw (compilation of the result \(using the WML Tools, see ) Tj /F02 10 Tf 0 0 0.8 rg 0.0000 Tw ("LINKS") Tj /F00 10 Tf 0 g 0.0000 Tw (\) ) Tj /F20 10 Tf 1 0 0 1 102.0 432.8 Tm 0.0000 Tw () Tj ET q 102 433.8 4 4 re f Q BT 1 0 0 1 110 432.8 Tm /F20 10 Tf 0.0000 Tw ( ) Tj /F00 10 Tf 1 0 0 1 126.0 432.8 Tm 0.0000 Tw (a debug mode to check the result using validation functions ) Tj /F21 12 Tf 1 0 0 1 72.0 402.8 Tm 0.0000 Tw (OPTIONS ) Tj /F00 10 Tf 1 0 0 1 102.0 388.4 Tm 0.2163 Tw (Please note that most of these options are also available when calling Html2Wml as a CGI. In this case,) Tj 1 0 0 1 102.0 376.4 Tm 0.3521 Tw (boolean options are given the value "1" or "0", and other options simply receive the value they expect.) Tj 1 0 0 1 102.0 364.4 Tm 0.4850 Tw (For example, ) Tj /F10 10 Tf 0.4850 Tw (\217ascii) Tj /F00 10 Tf 0.4850 Tw ( becomes ) Tj /F10 10 Tf 0.4850 Tw (?ascii=1) Tj /F00 10 Tf 0.4850 Tw ( or ) Tj /F10 10 Tf 0.4850 Tw (?a=1) Tj /F00 10 Tf 0.4850 Tw (. See the file ) Tj /F03 10 Tf 0.4850 Tw (t/form.html) Tj /F00 10 Tf 0.4850 Tw ( for an example on how) Tj 1 0 0 1 102.0 352.4 Tm 0.0000 Tw (to call Html2Wml as a CGI. ) Tj /F21 10 Tf 1 0 0 1 72.0 322.4 Tm 0.0000 Tw (Conversion Options ) Tj /F20 10 Tf 1 0 0 1 102.0 308.0 Tm 0.0000 Tw (-a, \217ascii ) Tj /F00 10 Tf 1 0 0 1 126.0 296.0 Tm 2.5879 Tw (When this option is on, named HTML entities and non-ASCII characters are converted to) Tj 1 0 0 1 126.0 284.0 Tm 1.5821 Tw (US-ASCII characters using the same 7 bit approximations as Lynx. For example, ) Tj /F10 10 Tf 1.5821 Tw (©) Tj /F00 10 Tf 1.5821 Tw ( is) Tj 1 0 0 1 126.0 272.0 Tm 0.0000 Tw (translated to "\(c\)", and ) Tj /F10 10 Tf 0.0000 Tw (ß) Tj /F00 10 Tf 0.0000 Tw ( is translated to "ss". This option is off by default. ) Tj /F20 10 Tf 1 0 0 1 102.0 245.6 Tm 0.0000 Tw (\217[no]collapse ) Tj /F00 10 Tf 1 0 0 1 126.0 233.6 Tm 0.4382 Tw (This option tells Html2Wml to collapse redundant whitespaces, tabulations, carriage returns, lines) Tj 1 0 0 1 126.0 221.6 Tm 1.4624 Tw (feeds and empty paragraphs. The aim is to reduce the size of the WML document as much as) Tj 1 0 0 1 126.0 209.6 Tm 2.3683 Tw (possible. Collapsing empty paragraphs is necessary for two reasons. First, this avoids empty) Tj 1 0 0 1 126.0 197.6 Tm 1.0411 Tw (screens \(and on a device with only 4 lines of display, an empty screen can be quite ennoying\).) Tj 1 0 0 1 126.0 185.6 Tm 2.0717 Tw (Second, Html2wml creates many empty paragraphs when converting, because of the way the) Tj 1 0 0 1 126.0 173.6 Tm 1.0982 Tw (syntax reconstructor is programmed. Deleting these empty paragraphs is necessary like cleaning) Tj 1 0 0 1 126.0 161.6 Tm 0.0000 Tw (the kitchen :-\) ) Tj /F00 10 Tf 1 0 0 1 126.0 149.6 Tm 0.0000 Tw (If this really bother you, you can desactivate this behaviour with the ) Tj /F01 10 Tf 0.0000 Tw (\217nocollapse) Tj /F00 10 Tf 0.0000 Tw ( option. ) Tj /F20 10 Tf 1 0 0 1 102.0 123.2 Tm 0.0000 Tw (\217ignore-images ) Tj /F00 10 Tf 1 0 0 1 126.0 111.2 Tm 0.0000 Tw (This option tells Html2Wml to completly ignore all image links. ) Tj /F20 10 Tf 1 0 0 1 102.0 84.8 Tm 0.0000 Tw (\217[no]img-alt-text ) Tj /F21 10 Tf 1 0 0 1 72 37 Tm (26 October 2003) Tj 1 0 0 1 517.44 37 Tm (1) Tj ET 72 50 m 523 50 l S endstream endobj 19 0 obj 6016 endobj 20 0 obj << /ProcSet [/PDF /Text] /ColorSpace <> /Font << /F00 6 0 R /F01 7 0 R /F02 8 0 R /F03 9 0 R /F10 10 0 R /F20 14 0 R /F21 15 0 R >> >> endobj 21 0 obj << /Type /Page /Parent 4 0 R /Resources 20 0 R /Contents 18 0 R >> endobj 22 0 obj << /Length 23 0 R >> stream 72 792 m 523 792 l S BT 0 G 1 i 0 J 0 j 0.1 w 10 M []0 d /F21 10 Tf 1 0 0 1 72 797 Tm (Html2Wml) Tj 1 0 0 1 483.56 797 Tm (pod2pdf) Tj /F00 10 Tf 1 0 0 1 126.0 770.0 Tm 0.1547 Tw (This option tells Html2Wml to replace the image tags with their corresponding alternative text \(as) Tj 1 0 0 1 126.0 758.0 Tm 0.0000 Tw (with a text mode web browser\). This option is on by default. ) Tj /F20 10 Tf 1 0 0 1 102.0 731.6 Tm 0.0000 Tw (\217[no]linearize ) Tj /F00 10 Tf 1 0 0 1 126.0 719.6 Tm 3.3393 Tw (This option is on by default. This makes Html2Wml flattens the HTML tables \(they are) Tj 1 0 0 1 126.0 707.6 Tm 0.0822 Tw (linearized\), as Lynx does. I think this is better than trying to use the native WML tables. First, they) Tj 1 0 0 1 126.0 695.6 Tm 1.5142 Tw (have extremely limited features and possibilities compared to HTML tables. In particular, they) Tj 1 0 0 1 126.0 683.6 Tm 0.8717 Tw (can`t be nested. In fact this is normal because Wap devices are not supposed to have a big CPU) Tj 1 0 0 1 126.0 671.6 Tm 2.2707 Tw (running at some zillions-hertz, and the calculations needed to render the tables are the most) Tj 1 0 0 1 126.0 659.6 Tm 0.0000 Tw (complicated and CPU-hogger part of HTML. ) Tj /F00 10 Tf 1 0 0 1 126.0 647.6 Tm 1.5181 Tw (Second, as they can`t be nested, and as typical HTML pages heavily use imbricated tables to) Tj 1 0 0 1 126.0 635.6 Tm 0.3558 Tw (create their layout, it`s impossible to decide which one could be kept. So the best thing is to keep) Tj 1 0 0 1 126.0 623.6 Tm 0.0000 Tw (none of them. ) Tj /F00 10 Tf 1 0 0 1 126.0 611.6 Tm 1.3579 Tw () Tj /F01 10 Tf 1.3579 Tw ([Note]) Tj /F00 10 Tf 1.3579 Tw ( Although you can desactivate this behaviour, and although there is internal support for) Tj 1 0 0 1 126.0 599.6 Tm 0.6844 Tw (tables, the unlinearized mode has not been heavily tested with nested tables, and it may produce) Tj 1 0 0 1 126.0 587.6 Tm 0.0000 Tw (unexpected results. ) Tj /F20 10 Tf 1 0 0 1 102.0 561.2 Tm 0.0000 Tw (-n, \217numeric-non-ascii ) Tj /F00 10 Tf 1 0 0 1 126.0 549.2 Tm 1.9036 Tw (This option tells Html2wml to convert all non-ASCII characters to numeric entities, i.e., "\351") Tj 1 0 0 1 126.0 537.2 Tm 0.0000 Tw (becomes ) Tj /F10 10 Tf 0.0000 Tw (é) Tj /F00 10 Tf 0.0000 Tw (, and "sz" becomes ) Tj /F10 10 Tf 0.0000 Tw (ß) Tj /F00 10 Tf 0.0000 Tw (. By default, this option is off. ) Tj /F20 10 Tf 1 0 0 1 102.0 510.8 Tm 0.0000 Tw (-p, \217nopre ) Tj /F00 10 Tf 1 0 0 1 126.0 498.8 Tm 0.0294 Tw (This options tells Html2Wml not to use the
 tag. This option was added because the compiler) Tj
1 0 0 1 126.0 486.8 Tm
0.0000 Tw
(from WML Tools 0.0.4  doesn`t support this tag.  ) Tj
/F21 10 Tf
1 0 0 1 72.0 456.8 Tm
0.0000 Tw
(Links Reconstruction Options ) Tj
/F20 10 Tf
1 0 0 1 102.0 442.4 Tm
0.0000 Tw
(\217hreftmpl=) Tj
/F22 10 Tf
0.0000 Tw
(TEMPLATE) Tj
/F20 10 Tf
0.0000 Tw
( ) Tj
/F00 10 Tf
1 0 0 1 126.0 430.4 Tm
1.0320 Tw
(This options sets the template that will be used to reconstruct the ) Tj
/F10 10 Tf
1.0320 Tw
(href) Tj
/F00 10 Tf
1.0320 Tw
(-type links. See ) Tj
/F02 10 Tf
0 0 0.8 rg
1.0320 Tw
("LINKS) Tj
1 0 0 1 126.0 418.4 Tm
0.0000 Tw
(RECONSTRUCTION") Tj
/F00 10 Tf
0 g
0.0000 Tw
( for more information.  ) Tj
/F20 10 Tf
1 0 0 1 102.0 392.0 Tm
0.0000 Tw
(\217srctmpl=) Tj
/F22 10 Tf
0.0000 Tw
(TEMPLATE) Tj
/F20 10 Tf
0.0000 Tw
( ) Tj
/F00 10 Tf
1 0 0 1 126.0 380.0 Tm
1.6913 Tw
(This option sets the template that will be used to reconstruct the ) Tj
/F10 10 Tf
1.6913 Tw
(src) Tj
/F00 10 Tf
1.6913 Tw
(-type links. See ) Tj
/F02 10 Tf
0 0 0.8 rg
1.6913 Tw
("LINKS) Tj
1 0 0 1 126.0 368.0 Tm
0.0000 Tw
(RECONSTRUCTION") Tj
/F00 10 Tf
0 g
0.0000 Tw
( for more information.  ) Tj
/F21 10 Tf
1 0 0 1 72.0 338.0 Tm
0.0000 Tw
(Splitting Options ) Tj
/F20 10 Tf
1 0 0 1 102.0 323.6 Tm
0.0000 Tw
(-s, \217max-card-size=) Tj
/F22 10 Tf
0.0000 Tw
(SIZE) Tj
/F20 10 Tf
0.0000 Tw
( ) Tj
/F00 10 Tf
1 0 0 1 126.0 311.6 Tm
0.8388 Tw
(This option allows you to limit the size \(in bytes\) of the generated cards. Default is 1,500 bytes,) Tj
1 0 0 1 126.0 299.6 Tm
1.4273 Tw
(which should be small enought to be loaded on most Wap devices. See ) Tj
/F02 10 Tf
0 0 0.8 rg
1.4273 Tw
("DECK SLICING") Tj
/F00 10 Tf
0 g
1.4273 Tw
( for) Tj
1 0 0 1 126.0 287.6 Tm
0.0000 Tw
(more information.  ) Tj
/F20 10 Tf
1 0 0 1 102.0 261.2 Tm
0.0000 Tw
(-t, \217card-split-threshold=) Tj
/F22 10 Tf
0.0000 Tw
(SIZE) Tj
/F20 10 Tf
0.0000 Tw
( ) Tj
/F00 10 Tf
1 0 0 1 126.0 249.2 Tm
0.1968 Tw
(This option sets the threshold of the split event, which can occur  when the size of the current card) Tj
1 0 0 1 126.0 237.2 Tm
1.3437 Tw
(is between ) Tj
/F10 10 Tf
1.3437 Tw
(max-card-size) Tj
/F00 10 Tf
1.3437 Tw
( -  ) Tj
/F10 10 Tf
1.3437 Tw
(card-split-threshold) Tj
/F00 10 Tf
1.3437 Tw
( and ) Tj
/F10 10 Tf
1.3437 Tw
(max-card-size) Tj
/F00 10 Tf
1.3437 Tw
(. Default) Tj
1 0 0 1 126.0 225.2 Tm
0.0000 Tw
(value is  50. See ) Tj
/F02 10 Tf
0 0 0.8 rg
0.0000 Tw
("DECK SLICING") Tj
/F00 10 Tf
0 g
0.0000 Tw
( for more information.  ) Tj
/F20 10 Tf
1 0 0 1 102.0 198.8 Tm
0.0000 Tw
(\217next-card-label=) Tj
/F22 10 Tf
0.0000 Tw
(STRING) Tj
/F20 10 Tf
0.0000 Tw
( ) Tj
/F00 10 Tf
1 0 0 1 126.0 186.8 Tm
0.5844 Tw
(This options sets the label of the link that points to the next card.  Default is "[>>]", which) Tj
1 0 0 1 126.0 174.8 Tm
0.0000 Tw
(whill be rendered as "[) Tj
/F00 10 Tf
0.0000 Tw
() Tj
/F00 10 Tf
0.0000 Tw
(]".  ) Tj
/F20 10 Tf
1 0 0 1 102.0 148.4 Tm
0.0000 Tw
(\217prev-card-label=) Tj
/F22 10 Tf
0.0000 Tw
(STRING) Tj
/F20 10 Tf
0.0000 Tw
( ) Tj
/F00 10 Tf
1 0 0 1 126.0 136.4 Tm
1.4518 Tw
(This options sets the label of the link that points to the previous card.  Default is "[<<]",) Tj
1 0 0 1 126.0 124.4 Tm
0.0000 Tw
(which whill be rendered as "[<<]".  ) Tj
/F21 10 Tf
1 0 0 1 72.0 94.4 Tm
0.0000 Tw
(HTTP Authentication ) Tj
/F20 10 Tf
1 0 0 1 102.0 80.0 Tm
0.0000 Tw
(-U, \217http-user=) Tj
/F22 10 Tf
0.0000 Tw
(USERNAME) Tj
/F20 10 Tf
0.0000 Tw
( ) Tj
/F21 10 Tf
1 0 0 1 72 37 Tm
(2) Tj
1 0 0 1 445.74 37 Tm
(26 October 2003) Tj
ET
72 50 m
523 50 l
S
endstream
endobj
23 0 obj
6093
endobj
24 0 obj
<<
/ProcSet [/PDF /Text]
/ColorSpace <>
/Font
<<
/F00 6 0 R
/F01 7 0 R
/F02 8 0 R
/F10 10 0 R
/F20 14 0 R
/F21 15 0 R
/F22 16 0 R
>>
>>
endobj
25 0 obj
<<
/Type /Page
/Parent 4 0 R
/Resources 24 0 R
/Contents 22 0 R
>>
endobj
26 0 obj
<<
/Length 27 0 R
>>
stream
72 792 m
523 792 l
S
BT
0 G
1 i 0 J 0 j 0.1 w 10 M []0 d
/F21 10 Tf
1 0 0 1 72 797 Tm
(pod2pdf) Tj
1 0 0 1 474.11 797 Tm
(Html2Wml) Tj
/F00 10 Tf
1 0 0 1 126.0 770.0 Tm
0.0000 Tw
(Use this option to set the username for an authenticated request.  ) Tj
/F20 10 Tf
1 0 0 1 102.0 755.6 Tm
0.0000 Tw
(-P, \217http-passwd=) Tj
/F22 10 Tf
0.0000 Tw
(PASSWORD) Tj
/F20 10 Tf
0.0000 Tw
( ) Tj
/F00 10 Tf
1 0 0 1 126.0 743.6 Tm
0.0000 Tw
(Use this option to set the password for an authenticated request.  ) Tj
/F21 10 Tf
1 0 0 1 72.0 713.6 Tm
0.0000 Tw
(Proxy Support ) Tj
/F20 10 Tf
1 0 0 1 102.0 699.2 Tm
0.0000 Tw
(-[no]Y, \217[no]proxy ) Tj
/F00 10 Tf
1 0 0 1 126.0 687.2 Tm
1.2627 Tw
(Use this option to activate proxy support. By default, proxy support  is activated. See ) Tj
/F02 10 Tf
0 0 0.8 rg
1.2627 Tw
("PROXY) Tj
1 0 0 1 126.0 675.2 Tm
0.0000 Tw
(SUPPORT") Tj
/F00 10 Tf
0 g
0.0000 Tw
(.  ) Tj
/F21 10 Tf
1 0 0 1 72.0 645.2 Tm
0.0000 Tw
(Output Options ) Tj
/F20 10 Tf
1 0 0 1 102.0 630.8 Tm
0.0000 Tw
(-k, \217compile ) Tj
/F00 10 Tf
1 0 0 1 126.0 618.8 Tm
1.1147 Tw
(Setting this option tells Html2Wml to use the compiler from WML Tools to compile the WML) Tj
1 0 0 1 126.0 606.8 Tm
0.3284 Tw
(deck. If you want to create a real Wap site, you should seriously use this option in order to reduce) Tj
1 0 0 1 126.0 594.8 Tm
0.7594 Tw
(the size of the WML decks.  Remember that Wap devices have very little amount of memory. If) Tj
1 0 0 1 126.0 582.8 Tm
0.0000 Tw
(this is not enought, use the splitting options.  ) Tj
/F00 10 Tf
1 0 0 1 126.0 570.8 Tm
1.4456 Tw
(Take a look in ) Tj
/F03 10 Tf
1.4456 Tw
(wml_compilation/) Tj
/F00 10 Tf
1.4456 Tw
( for more information on how to use  a WML compiler with) Tj
1 0 0 1 126.0 558.8 Tm
0.0000 Tw
(Html2Wml.  ) Tj
/F20 10 Tf
1 0 0 1 102.0 532.4 Tm
0.0000 Tw
(-o, \217output ) Tj
/F00 10 Tf
1 0 0 1 126.0 520.4 Tm
0.0500 Tw
(Use this option \(in shell mode\) to specify an output file.  By default, Html2Wml prints the result to) Tj
1 0 0 1 126.0 508.4 Tm
0.0000 Tw
(standard output.  ) Tj
/F21 10 Tf
1 0 0 1 72.0 478.4 Tm
0.0000 Tw
(Debugging Options ) Tj
/F20 10 Tf
1 0 0 1 102.0 464.0 Tm
0.0000 Tw
(-d, \217debug[=) Tj
/F22 10 Tf
0.0000 Tw
(LEVEL) Tj
/F20 10 Tf
0.0000 Tw
(] ) Tj
/F00 10 Tf
1 0 0 1 126.0 452.0 Tm
0.5250 Tw
(This option activates the debug mode. This prints the output result  with line numbering and with) Tj
1 0 0 1 126.0 440.0 Tm
1.9356 Tw
(the result of the XML check. If the WML  compiler was called, the result is also printed in) Tj
1 0 0 1 126.0 428.0 Tm
0.0986 Tw
(hexadecimal an ascii  forms. When called as a CGI, all of this is printed as HTML, so that can  use) Tj
1 0 0 1 126.0 416.0 Tm
0.0000 Tw
(any web browser for that purpose.  ) Tj
/F20 10 Tf
1 0 0 1 102.0 389.6 Tm
0.0000 Tw
(\217xmlcheck ) Tj
/F00 10 Tf
1 0 0 1 126.0 377.6 Tm
0.0000 Tw
(When this option is on, it send the WML output to XML::Parser to check  its well-formedness.  ) Tj
/F21 12 Tf
1 0 0 1 72.0 347.6 Tm
0.0000 Tw
(DECK SLICING ) Tj
/F00 10 Tf
1 0 0 1 102.0 333.2 Tm
0.3367 Tw
(The ) Tj
/F02 10 Tf
0.3367 Tw
(deck slicing) Tj
/F00 10 Tf
0.3367 Tw
( is a feature that Html2Wml provides in order to  match the low memory capabilities of) Tj
1 0 0 1 102.0 321.2 Tm
2.4433 Tw
(most Wap devices. Many can`t handle cards larger than 2,000 bytes, therefore the cards must be) Tj
1 0 0 1 102.0 309.2 Tm
1.3156 Tw
(sufficiently small to be viewed by all Wap devices. To achieve this, you should compile your WML) Tj
1 0 0 1 102.0 297.2 Tm
0.2900 Tw
(deck, which reduce the size of the deck by 50%, but even then your cards may be too big. This is where) Tj
1 0 0 1 102.0 285.2 Tm
0.4700 Tw
(Html2Wml comes with the deck slicing feature. This allows you to limit the size of the cards, currently) Tj
1 0 0 1 102.0 273.2 Tm
0.0000 Tw
(only ) Tj
/F02 10 Tf
0.0000 Tw
(before) Tj
/F00 10 Tf
0.0000 Tw
( the compilation stage.  ) Tj
/F21 10 Tf
1 0 0 1 72.0 243.2 Tm
0.0000 Tw
(Slice by cards or by decks ) Tj
/F00 10 Tf
1 0 0 1 102.0 231.2 Tm
0.8139 Tw
(On some Wap phones, slicing the deck is not sufficient: the WML browser  still tries to download the) Tj
1 0 0 1 102.0 219.2 Tm
1.2325 Tw
(whole deck instead of just picking one  card at a time. A solution is to slice the WML document by) Tj
1 0 0 1 102.0 207.2 Tm
0.0000 Tw
(decks.  See the figure below.  ) Tj
/F10 10 Tf
1 0 0 1 102.0 195.2 Tm
0.0000 Tw
(     _____________          _____________  ) Tj
1 0 0 1 102.0 183.2 Tm
0.0000 Tw
(    |    deck     |        |   deck #1   | ) Tj
1 0 0 1 102.0 171.2 Tm
0.0000 Tw
(    |  _________  |        |  _________  | ) Tj
1 0 0 1 102.0 159.2 Tm
0.0000 Tw
(    | | card #1 | |        | |  card   | | ) Tj
1 0 0 1 102.0 147.2 Tm
0.0000 Tw
(    | |_________| |        | |_________| | ) Tj
1 0 0 1 102.0 135.2 Tm
0.0000 Tw
(    |  _________  |        |_____________| ) Tj
1 0 0 1 102.0 123.2 Tm
0.0000 Tw
(    | | card #2 | |         ) Tj
1 0 0 1 102.0 111.2 Tm
0.0000 Tw
(    | |_________| |             . . . ) Tj
1 0 0 1 102.0 99.2 Tm
0.0000 Tw
(    |  _________  |         ) Tj
1 0 0 1 102.0 87.2 Tm
0.0000 Tw
(    | |   ...   | |         _____________ ) Tj
1 0 0 1 102.0 75.2 Tm
0.0000 Tw
(    | |_________| |        |   deck #n   | ) Tj
1 0 0 1 102.0 63.2 Tm
0.0000 Tw
(    |  _________  |        |  _________  | ) Tj
/F21 10 Tf
1 0 0 1 72 37 Tm
(26 October 2003) Tj
1 0 0 1 517.44 37 Tm
(3) Tj
ET
72 50 m
523 50 l
S
endstream
endobj
27 0 obj
5365
endobj
28 0 obj
<<
/ProcSet [/PDF /Text]
/ColorSpace <>
/Font
<<
/F00 6 0 R
/F02 8 0 R
/F03 9 0 R
/F10 10 0 R
/F20 14 0 R
/F21 15 0 R
/F22 16 0 R
>>
>>
endobj
29 0 obj
<<
/Type /Page
/Parent 4 0 R
/Resources 28 0 R
/Contents 26 0 R
>>
endobj
30 0 obj
<<
/Length 31 0 R
>>
stream
72 792 m
523 792 l
S
BT
0 G
1 i 0 J 0 j 0.1 w 10 M []0 d
/F21 10 Tf
1 0 0 1 72 797 Tm
(Html2Wml) Tj
1 0 0 1 483.56 797 Tm
(pod2pdf) Tj
/F10 10 Tf
1 0 0 1 102.0 758.0 Tm
0.0000 Tw
(    | | card #n | |        | |  card   | | ) Tj
1 0 0 1 102.0 746.0 Tm
0.0000 Tw
(    | |_________| |        | |_________| | ) Tj
1 0 0 1 102.0 734.0 Tm
0.0000 Tw
(    |_____________|        |_____________| ) Tj
1 0 0 1 102.0 710.0 Tm
0.0000 Tw
(      WML document           WML document ) Tj
1 0 0 1 102.0 698.0 Tm
0.0000 Tw
(    sliced by cards        sliced by decks ) Tj
/F00 10 Tf
1 0 0 1 102.0 674.0 Tm
2.5327 Tw
(What this means is that Html2Wml generates several WML documents.  In CGI mode, only the) Tj
1 0 0 1 102.0 662.0 Tm
0.0000 Tw
(appropriate deck is sent, selected by the id  given in parameter. If no id was given, the first deck is sent.  ) Tj
/F21 10 Tf
1 0 0 1 72.0 632.0 Tm
0.0000 Tw
(Note on size calculation ) Tj
/F00 10 Tf
1 0 0 1 102.0 620.0 Tm
0.0979 Tw
(Currently, Html2Wml estimates the size of the card on the fly, by  summing the length of the strings that) Tj
1 0 0 1 102.0 608.0 Tm
0.3306 Tw
(compose the WML output, texts and  tags. I say "estimates" and not "calculates" because computing the) Tj
1 0 0 1 102.0 596.0 Tm
0.9626 Tw
(exact  size would require many more calculations than the way it is done now.  One may objects that) Tj
1 0 0 1 102.0 584.0 Tm
0.9550 Tw
(there are only additions, which is correct, but knowing  the ) Tj
/F02 10 Tf
0.9550 Tw
(exact) Tj
/F00 10 Tf
0.9550 Tw
( size is not necessary. Indeed, if you) Tj
1 0 0 1 102.0 572.0 Tm
0.0000 Tw
(compile the WML, most of  the strings of the tags will be removed, but not all.  ) Tj
/F00 10 Tf
1 0 0 1 102.0 560.0 Tm
0.2658 Tw
(For example, take an image tag:  ) Tj
/F10 10 Tf
0.2658 Tw
(Photo of a dog) Tj
/F00 10 Tf
0.2658 Tw
(.) Tj
1 0 0 1 102.0 548.0 Tm
1.3856 Tw
(When compiled, the string ) Tj
/F10 10 Tf
1.3856 Tw
("img") Tj
/F00 10 Tf
1.3856 Tw
( will be replaced by a one byte value.  Same thing for the strings) Tj
1 0 0 1 102.0 536.0 Tm
1.7276 Tw
() Tj
/F10 10 Tf
1.7276 Tw
("src") Tj
/F00 10 Tf
1.7276 Tw
( and ) Tj
/F10 10 Tf
1.7276 Tw
("alt") Tj
/F00 10 Tf
1.7276 Tw
(, and the spaces, double  quotes and equal signs will be stripped. Only the text) Tj
1 0 0 1 102.0 524.0 Tm
0.5545 Tw
(between double quote  will be preserved... but not in every cases.  Indeed, in order to go a step further,) Tj
1 0 0 1 102.0 512.0 Tm
4.9413 Tw
(the compiler can also encode  parts of the arguments as binary. For example, the string) Tj
1 0 0 1 102.0 500.0 Tm
0.5890 Tw
() Tj
/F10 10 Tf
0.5890 Tw
("http://www.") Tj
/F00 10 Tf
0.5890 Tw
(  can be encoded as a single byte \() Tj
/F10 10 Tf
0.5890 Tw
(8F) Tj
/F00 10 Tf
0.5890 Tw
( in this case\). Or, if the attribute  is ) Tj
/F10 10 Tf
0.5890 Tw
(href) Tj
/F00 10 Tf
0.5890 Tw
(, the) Tj
1 0 0 1 102.0 488.0 Tm
0.0000 Tw
(string ) Tj
/F10 10 Tf
0.0000 Tw
(href="http://) Tj
/F00 10 Tf
0.0000 Tw
( can become the byte ) Tj
/F10 10 Tf
0.0000 Tw
(4B) Tj
/F00 10 Tf
0.0000 Tw
(.  ) Tj
/F00 10 Tf
1 0 0 1 102.0 476.0 Tm
0.3810 Tw
(As you see, it doesn`t matter to know exactly the size of the textual form of the WML, as it will always) Tj
1 0 0 1 102.0 464.0 Tm
0.4295 Tw
(be far superior to the size of the compiled form. That`s why I don`t count all the characters that may be) Tj
1 0 0 1 102.0 452.0 Tm
0.0000 Tw
(actually written.  ) Tj
/F00 10 Tf
1 0 0 1 102.0 440.0 Tm
0.0000 Tw
(Also, it`s because I`m quite lazy ;-\) ) Tj
/F21 10 Tf
1 0 0 1 72.0 410.0 Tm
0.0000 Tw
(Why compiling the WML deck? ) Tj
/F00 10 Tf
1 0 0 1 102.0 398.0 Tm
0.7700 Tw
(If you intent to create real WML pages, you should really  consider to always compile them. If you`re) Tj
1 0 0 1 102.0 386.0 Tm
0.0000 Tw
(not convinced, here is an  illustration.  ) Tj
/F00 10 Tf
1 0 0 1 102.0 374.0 Tm
0.0000 Tw
(Take the following WML code snipet:  ) Tj
/F10 10 Tf
1 0 0 1 102.0 362.0 Tm
0.0000 Tw
(    Yahoo! ) Tj
/F00 10 Tf
1 0 0 1 102.0 338.0 Tm
2.1174 Tw
(It`s the basic and classical way to code an hyperlink. It takes 42 bytes to code this, because it is) Tj
1 0 0 1 102.0 326.0 Tm
0.0000 Tw
(presented in a human-readable form.  ) Tj
/F00 10 Tf
1 0 0 1 102.0 314.0 Tm
1.3673 Tw
(The WAP Forum has defined a compact binary representation of WML in its specification, which is) Tj
1 0 0 1 102.0 302.0 Tm
0.9571 Tw
(called "compiled WML". It`s a binary format,  therefore you, a mere human, can`t read that, but your) Tj
1 0 0 1 102.0 290.0 Tm
0.0000 Tw
(computer can. And  it`s much faster for it to read a binary format than to read a textual  format.  ) Tj
/F00 10 Tf
1 0 0 1 102.0 278.0 Tm
0.0000 Tw
(The previous example would be, once compiled \(and printed here as  hexadecimal\):  ) Tj
/F10 10 Tf
1 0 0 1 102.0 266.0 Tm
0.0000 Tw
(    1C 4A 8F 03 y a h o o 00 85 01 03 Y a h o o ! 00 01 ) Tj
/F00 10 Tf
1 0 0 1 102.0 242.0 Tm
0.4074 Tw
(This only takes 21 bytes. Half the size of the human-readable form.  For a Wap device, this means both) Tj
1 0 0 1 102.0 230.0 Tm
0.0300 Tw
(less to download, and easier things  to read. Therefore the processing of the document can be achieved in) Tj
1 0 0 1 102.0 218.0 Tm
0.0000 Tw
( a short time compared to the tectual version of the same document.  ) Tj
/F00 10 Tf
1 0 0 1 102.0 206.0 Tm
0.0000 Tw
(There is a last argument, and not the less important: many Wap devices only read binary WML.  ) Tj
/F21 12 Tf
1 0 0 1 72.0 176.0 Tm
0.0000 Tw
(ACTIONS ) Tj
/F00 10 Tf
1 0 0 1 102.0 161.6 Tm
2.4973 Tw
(Actions are a feature similar to \(but with far less functionalities!\) the SSI \(Server Side Includes\)) Tj
1 0 0 1 102.0 149.6 Tm
0.3932 Tw
(available on good servers like Apache. In order not to interfere with the real SSI, but to keep the syntax) Tj
1 0 0 1 102.0 137.6 Tm
0.0000 Tw
(easy to learn, it differs in very few points.  ) Tj
/F21 10 Tf
1 0 0 1 72.0 107.6 Tm
0.0000 Tw
(Syntax ) Tj
/F00 10 Tf
1 0 0 1 102.0 95.6 Tm
0.0000 Tw
(Basically, the syntax to execute an action is:  ) Tj
/F10 10 Tf
1 0 0 1 102.0 83.6 Tm
0.0000 Tw
(     ) Tj
/F21 10 Tf
1 0 0 1 72 37 Tm
(4) Tj
1 0 0 1 445.74 37 Tm
(26 October 2003) Tj
ET
72 50 m
523 50 l
S
endstream
endobj
31 0 obj
6221
endobj
32 0 obj
<<
/ProcSet [/PDF /Text]
/ColorSpace <>
/Font
<<
/F00 6 0 R
/F02 8 0 R
/F10 10 0 R
/F21 15 0 R
>>
>>
endobj
33 0 obj
<<
/Type /Page
/Parent 4 0 R
/Resources 32 0 R
/Contents 30 0 R
>>
endobj
34 0 obj
<<
/Length 35 0 R
>>
stream
72 792 m
523 792 l
S
BT
0 G
1 i 0 J 0 j 0.1 w 10 M []0 d
/F21 10 Tf
1 0 0 1 72 797 Tm
(pod2pdf) Tj
1 0 0 1 474.11 797 Tm
(Html2Wml) Tj
/F00 10 Tf
1 0 0 1 102.0 770.0 Tm
0.0121 Tw
(Note that the angle brackets are part of the syntax. Except for that point, Actions syntax is very similar to) Tj
1 0 0 1 102.0 758.0 Tm
0.0000 Tw
(SSI syntax.  ) Tj
/F21 10 Tf
1 0 0 1 72.0 728.0 Tm
0.0000 Tw
(Available actions ) Tj
/F00 10 Tf
1 0 0 1 102.0 716.0 Tm
0.0000 Tw
(Only few actions are currently available, but more can be implemented on request.  ) Tj
/F20 10 Tf
1 0 0 1 102.0 689.6 Tm
0.0000 Tw
(include ) Tj
/F20 10 Tf
1 0 0 1 126.0 675.2 Tm
0.0000 Tw
(Description ) Tj
/F00 10 Tf
1 0 0 1 174.0 663.2 Tm
2.4046 Tw
(Includes a file in the document at the current point. Please note that Html2Wml) Tj
1 0 0 1 174.0 651.2 Tm
0.4835 Tw
(doesn`t check nor parse the file, and if the file  cannot be found, will silently die \(this) Tj
1 0 0 1 174.0 639.2 Tm
0.0000 Tw
(is the same behavior as SSI\).  ) Tj
/F20 10 Tf
1 0 0 1 126.0 624.8 Tm
0.0000 Tw
(Parameters ) Tj
/F00 10 Tf
1 0 0 1 174.0 612.8 Tm
0.0000 Tw
() Tj
/F10 10 Tf
0.0000 Tw
(virtual=url) Tj
/F00 10 Tf
0.0000 Tw
( \217 The file is get by http. ) Tj
/F00 10 Tf
1 0 0 1 174.0 600.8 Tm
0.0000 Tw
() Tj
/F10 10 Tf
0.0000 Tw
(file=path) Tj
/F00 10 Tf
0.0000 Tw
( \217 The file is read from the local disk. ) Tj
/F20 10 Tf
1 0 0 1 102.0 574.4 Tm
0.0000 Tw
(fsize ) Tj
/F20 10 Tf
1 0 0 1 126.0 560.0 Tm
0.0000 Tw
(Description ) Tj
/F00 10 Tf
1 0 0 1 174.0 548.0 Tm
0.0000 Tw
(Returns the size of a file at the current point of the document.  ) Tj
/F20 10 Tf
1 0 0 1 126.0 533.6 Tm
0.0000 Tw
(Parameters ) Tj
/F00 10 Tf
1 0 0 1 174.0 521.6 Tm
0.0000 Tw
() Tj
/F10 10 Tf
0.0000 Tw
(virtual=url) Tj
/F00 10 Tf
0.0000 Tw
( \217 The file is get by http. ) Tj
/F00 10 Tf
1 0 0 1 174.0 509.6 Tm
0.0000 Tw
() Tj
/F10 10 Tf
0.0000 Tw
(file=path) Tj
/F00 10 Tf
0.0000 Tw
( \217 The file is read from the local disk. ) Tj
/F20 10 Tf
1 0 0 1 126.0 495.2 Tm
0.0000 Tw
(Notes ) Tj
/F00 10 Tf
1 0 0 1 174.0 483.2 Tm
0.0000 Tw
(If you use the file parameter, an absolute path is recommend.  ) Tj
/F20 10 Tf
1 0 0 1 102.0 456.8 Tm
0.0000 Tw
(skip ) Tj
/F20 10 Tf
1 0 0 1 126.0 442.4 Tm
0.0000 Tw
(Description ) Tj
/F00 10 Tf
1 0 0 1 174.0 430.4 Tm
0.0000 Tw
(Skips everything until the first ) Tj
/F10 10 Tf
0.0000 Tw
(end_skip) Tj
/F00 10 Tf
0.0000 Tw
( action.  ) Tj
/F21 10 Tf
1 0 0 1 72.0 400.4 Tm
0.0000 Tw
(Generic parameters ) Tj
/F00 10 Tf
1 0 0 1 102.0 388.4 Tm
0.0000 Tw
(The following parameters can be used for any action.  ) Tj
/F20 10 Tf
1 0 0 1 102.0 362.0 Tm
0.0000 Tw
(for=) Tj
/F22 10 Tf
0.0000 Tw
(output format) Tj
/F20 10 Tf
0.0000 Tw
( ) Tj
/F00 10 Tf
1 0 0 1 126.0 350.0 Tm
2.0121 Tw
(This paramater restricts the action for the given output format.  Currently, the only available) Tj
1 0 0 1 126.0 338.0 Tm
0.0000 Tw
(format is ") Tj
/F10 10 Tf
0.0000 Tw
(wml) Tj
/F00 10 Tf
0.0000 Tw
(" \(when using ) Tj
/F10 10 Tf
0.0000 Tw
(html2chtml) Tj
/F00 10 Tf
0.0000 Tw
(  the format is ") Tj
/F10 10 Tf
0.0000 Tw
(chtml) Tj
/F00 10 Tf
0.0000 Tw
("\).  ) Tj
/F21 10 Tf
1 0 0 1 72.0 308.0 Tm
0.0000 Tw
(Examples ) Tj
/F00 10 Tf
1 0 0 1 102.0 296.0 Tm
0.0000 Tw
(If you want to share a navigation bar between several WML pages, you can ) Tj
/F10 10 Tf
0.0000 Tw
(include) Tj
/F00 10 Tf
0.0000 Tw
( it this way:  ) Tj
/F10 10 Tf
1 0 0 1 102.0 284.0 Tm
0.0000 Tw
(     ) Tj
/F00 10 Tf
1 0 0 1 102.0 260.0 Tm
0.0000 Tw
(Of course, you have to write this navigation bar first :-\) ) Tj
/F00 10 Tf
1 0 0 1 102.0 248.0 Tm
1.4333 Tw
(If you want to use your current HTML pages for creating your WML pages,  but that they contains) Tj
1 0 0 1 102.0 236.0 Tm
0.4244 Tw
(complex tables, or unecessary navigation tables,  etc, you can simply ) Tj
/F10 10 Tf
0.4244 Tw
(skip) Tj
/F00 10 Tf
0.4244 Tw
( the complex parts and keep) Tj
1 0 0 1 102.0 224.0 Tm
0.0000 Tw
(the rest.  ) Tj
/F10 10 Tf
1 0 0 1 102.0 212.0 Tm
0.0000 Tw
(     ) Tj
1 0 0 1 102.0 200.0 Tm
0.0000 Tw
(     ) Tj
1 0 0 1 102.0 188.0 Tm
0.0000 Tw
(    unecessary parts for the WML pages ) Tj
1 0 0 1 102.0 176.0 Tm
0.0000 Tw
(     ) Tj
1 0 0 1 102.0 164.0 Tm
0.0000 Tw
(    useful parts for the WML pages ) Tj
1 0 0 1 102.0 152.0 Tm
0.0000 Tw
(     ) Tj
/F21 12 Tf
1 0 0 1 72.0 134.0 Tm
0.0000 Tw
(LINKS RECONSTRUCTION ) Tj
/F00 10 Tf
1 0 0 1 102.0 119.6 Tm
0.2173 Tw
(The links reconstruction engine is IMHO the most important part of Html2Wml, because it`s this engine) Tj
1 0 0 1 102.0 107.6 Tm
1.3524 Tw
(that allows you to reconstruct the  links of the HTML document being converted. It has two modes,) Tj
1 0 0 1 102.0 95.6 Tm
0.0000 Tw
(depending  upon whether Html2Wml was launched from the shell or as a CGI.  ) Tj
/F00 10 Tf
1 0 0 1 102.0 83.6 Tm
0.5105 Tw
(When used as a CGI, this engine will reconstructs the links of the HTML  document so that all the urls) Tj
1 0 0 1 102.0 71.6 Tm
0.6594 Tw
(will be passed to Html2Wml in order to  convert the pointed files \(pages or images\). This is completly) Tj
/F21 10 Tf
1 0 0 1 72 37 Tm
(26 October 2003) Tj
1 0 0 1 517.44 37 Tm
(5) Tj
ET
72 50 m
523 50 l
S
endstream
endobj
35 0 obj
5208
endobj
36 0 obj
<<
/ProcSet [/PDF /Text]
/ColorSpace <>
/Font
<<
/F00 6 0 R
/F10 10 0 R
/F20 14 0 R
/F21 15 0 R
/F22 16 0 R
>>
>>
endobj
37 0 obj
<<
/Type /Page
/Parent 4 0 R
/Resources 36 0 R
/Contents 34 0 R
>>
endobj
38 0 obj
<<
/Length 39 0 R
>>
stream
72 792 m
523 792 l
S
BT
0 G
1 i 0 J 0 j 0.1 w 10 M []0 d
/F21 10 Tf
1 0 0 1 72 797 Tm
(Html2Wml) Tj
1 0 0 1 483.56 797 Tm
(pod2pdf) Tj
/F00 10 Tf
1 0 0 1 102.0 770.0 Tm
0.0000 Tw
(automatic  and can`t be customized for now \(but I don`t think it would be really  useful\).  ) Tj
/F00 10 Tf
1 0 0 1 102.0 758.0 Tm
0.0776 Tw
(When used from the shell, this engine reconstructs the links with the  given templates. Note that absolute) Tj
1 0 0 1 102.0 746.0 Tm
0.0000 Tw
(URLs will be left untouched. The  templates can be customized using the following syntax.  ) Tj
/F21 10 Tf
1 0 0 1 72.0 716.0 Tm
0.0000 Tw
(Templates ) Tj
/F20 10 Tf
1 0 0 1 102.0 701.6 Tm
0.0000 Tw
(HREF Template ) Tj
/F00 10 Tf
1 0 0 1 126.0 689.6 Tm
1.5588 Tw
(This template controls the reconstruction of the ) Tj
/F10 10 Tf
1.5588 Tw
(href) Tj
/F00 10 Tf
1.5588 Tw
( attribute of  the ) Tj
/F10 10 Tf
1.5588 Tw
(A) Tj
/F00 10 Tf
1.5588 Tw
( tag. Its value can be) Tj
1 0 0 1 126.0 677.6 Tm
0 Tw
(changed using the ) Tj
/F01 10 Tf
0 Tw
(\217hreftmpl) Tj
/F00 10 Tf
0 Tw
( option.  Default value is) Tj
1 0 0 1 126.0 665.6 Tm
0.0000 Tw
() Tj
/F10 10 Tf
0.0000 Tw
("\{FILEPATH\}\{FILENAME\}\{$FILETYPE =~ s/s?html?/wml/o; $FILETYPE\}") Tj
/F00 10 Tf
0.0000 Tw
(.  ) Tj
/F20 10 Tf
1 0 0 1 102.0 651.2 Tm
0.0000 Tw
(Image Source Template ) Tj
/F00 10 Tf
1 0 0 1 126.0 639.2 Tm
1.2059 Tw
(This template controls the reconstruction of the ) Tj
/F10 10 Tf
1.2059 Tw
(src) Tj
/F00 10 Tf
1.2059 Tw
( attribute of  the ) Tj
/F10 10 Tf
1.2059 Tw
(IMG) Tj
/F00 10 Tf
1.2059 Tw
( tag. Its value can be) Tj
1 0 0 1 126.0 627.2 Tm
0 Tw
(changed using the ) Tj
/F01 10 Tf
0 Tw
(\217srctmpl) Tj
/F00 10 Tf
0 Tw
( option.  Default value is) Tj
1 0 0 1 126.0 615.2 Tm
0 Tw
() Tj
/F10 10 Tf
0 Tw
("\{FILEPATH\}\{FILENAME\}\{$FILETYPE =~ s/gif|png|jpe?g/wbmp/o;) Tj
1 0 0 1 126.0 603.2 Tm
0.0000 Tw
($FILETYPE\}") Tj
/F00 10 Tf
0.0000 Tw
( ) Tj
/F21 10 Tf
1 0 0 1 72.0 573.2 Tm
0.0000 Tw
(Syntax ) Tj
/F00 10 Tf
1 0 0 1 102.0 561.2 Tm
1.3331 Tw
(The template is a string that contains the new URL. More precisely, it`s  a Text::Template template.) Tj
1 0 0 1 102.0 549.2 Tm
0.4253 Tw
(Parameters can be interpolated as a constant  or as a variable. The template is embraced between curcly) Tj
1 0 0 1 102.0 537.2 Tm
0.0000 Tw
(bracets, and can  contain any valid Perl code.  ) Tj
/F00 10 Tf
1 0 0 1 102.0 525.2 Tm
0.0490 Tw
(The simplest form of a template is ) Tj
/F10 10 Tf
0.0490 Tw
(\{PARAM\}) Tj
/F00 10 Tf
0.0490 Tw
( which just returns the  value of PARAM. If you want to do) Tj
1 0 0 1 102.0 513.2 Tm
1.8592 Tw
(something more complex, you can use  the corresponding variable; for example ) Tj
/F10 10 Tf
1.8592 Tw
(\{"foo $PARAM) Tj
1 0 0 1 102.0 501.2 Tm
0.0000 Tw
(bar"\}) Tj
/F00 10 Tf
0.0000 Tw
(, or  ) Tj
/F10 10 Tf
0.0000 Tw
(\{join "_", split " ", PARAM\}) Tj
/F00 10 Tf
0.0000 Tw
(.  ) Tj
/F00 10 Tf
1 0 0 1 102.0 489.2 Tm
0.0000 Tw
(You may read ) Tj
/F02 10 Tf
0 0 0.8 rg
0.0000 Tw
(Text::Template) Tj
/F00 10 Tf
0 g
0.0000 Tw
( for more information on what is possible  within a template.  ) Tj
/F00 10 Tf
1 0 0 1 102.0 477.2 Tm
0.0781 Tw
(If the original URL contained a query part or a fragment part, then they  will be appended to the result of) Tj
1 0 0 1 102.0 465.2 Tm
0.0000 Tw
(the template.  ) Tj
/F21 10 Tf
1 0 0 1 72.0 435.2 Tm
0.0000 Tw
(Available parameters ) Tj
/F20 10 Tf
1 0 0 1 102.0 420.8 Tm
0.0000 Tw
(URL ) Tj
/F00 10 Tf
1 0 0 1 126.0 408.8 Tm
0.0000 Tw
(This parameter contains the original URL from the ) Tj
/F10 10 Tf
0.0000 Tw
(href) Tj
/F00 10 Tf
0.0000 Tw
( or ) Tj
/F10 10 Tf
0.0000 Tw
(src) Tj
/F00 10 Tf
0.0000 Tw
( attribute.  ) Tj
/F20 10 Tf
1 0 0 1 102.0 394.4 Tm
0.0000 Tw
(FILENAME ) Tj
/F00 10 Tf
1 0 0 1 126.0 382.4 Tm
0.0000 Tw
(This parameter contains the base name of the file.  ) Tj
/F20 10 Tf
1 0 0 1 102.0 368.0 Tm
0.0000 Tw
(FILEPATH ) Tj
/F00 10 Tf
1 0 0 1 126.0 356.0 Tm
0.0000 Tw
(This parameter contains the leading path of the file.  ) Tj
/F20 10 Tf
1 0 0 1 102.0 341.6 Tm
0.0000 Tw
(FILETYPE ) Tj
/F00 10 Tf
1 0 0 1 126.0 329.6 Tm
0.0000 Tw
(This parameter contains the suffix of the file.  ) Tj
/F00 10 Tf
1 0 0 1 102.0 305.6 Tm
0.0000 Tw
(This can be resumed this way:  ) Tj
/F10 10 Tf
1 0 0 1 102.0 293.6 Tm
0.0000 Tw
(  URL = http://www.server.net/path/to/my/page.html ) Tj
1 0 0 1 102.0 281.6 Tm
0.0000 Tw
(                             ------------^^^^ ---- ) Tj
1 0 0 1 102.0 269.6 Tm
0.0000 Tw
(                                 |        |     \\ ) Tj
1 0 0 1 102.0 257.6 Tm
0.0000 Tw
(                                 |        |      \\ ) Tj
1 0 0 1 102.0 245.6 Tm
0.0000 Tw
(                              FILEPATH FILENAME FILETYPE ) Tj
/F00 10 Tf
1 0 0 1 102.0 221.6 Tm
0.2606 Tw
(Note that ) Tj
/F10 10 Tf
0.2606 Tw
(FILETYPE) Tj
/F00 10 Tf
0.2606 Tw
( contains all the extensions of the file, so if its name  is ) Tj
/F03 10 Tf
0.2606 Tw
(index.html.fr) Tj
/F00 10 Tf
0.2606 Tw
( for example,) Tj
1 0 0 1 102.0 209.6 Tm
0.0000 Tw
() Tj
/F10 10 Tf
0.0000 Tw
(FILETYPE) Tj
/F00 10 Tf
0.0000 Tw
( contains ") Tj
/F10 10 Tf
0.0000 Tw
(.html.fr) Tj
/F00 10 Tf
0.0000 Tw
(".  ) Tj
/F21 10 Tf
1 0 0 1 72.0 179.6 Tm
0.0000 Tw
(Examples ) Tj
/F00 10 Tf
1 0 0 1 102.0 167.6 Tm
0.0000 Tw
(To add a path option:  ) Tj
/F10 10 Tf
1 0 0 1 102.0 155.6 Tm
0.0000 Tw
(    \{URL\}$wap ) Tj
/F00 10 Tf
1 0 0 1 102.0 131.6 Tm
0.5317 Tw
(Using Apache, you can then add a Rewrite directive so that URL ending with  ) Tj
/F10 10 Tf
0.5317 Tw
($wap) Tj
/F00 10 Tf
0.5317 Tw
( will be redirected) Tj
1 0 0 1 102.0 119.6 Tm
0.0000 Tw
(to Html2Wml:  ) Tj
/F10 10 Tf
1 0 0 1 102.0 107.6 Tm
0.0000 Tw
(    RewriteRule  ^\(/.*\)\\$wap$  /cgi-bin/html2wml.cgi?url=$1 ) Tj
/F00 10 Tf
1 0 0 1 102.0 83.6 Tm
0.0000 Tw
(To change the extension of an image:  ) Tj
/F10 10 Tf
/F21 10 Tf
1 0 0 1 72 37 Tm
(6) Tj
1 0 0 1 445.74 37 Tm
(26 October 2003) Tj
ET
72 50 m
523 50 l
S
endstream
endobj
39 0 obj
5871
endobj
40 0 obj
<<
/ProcSet [/PDF /Text]
/ColorSpace <>
/Font
<<
/F00 6 0 R
/F01 7 0 R
/F02 8 0 R
/F03 9 0 R
/F10 10 0 R
/F20 14 0 R
/F21 15 0 R
>>
>>
endobj
41 0 obj
<<
/Type /Page
/Parent 4 0 R
/Resources 40 0 R
/Contents 38 0 R
>>
endobj
42 0 obj
<<
/Length 43 0 R
>>
stream
72 792 m
523 792 l
S
BT
0 G
1 i 0 J 0 j 0.1 w 10 M []0 d
/F21 10 Tf
1 0 0 1 72 797 Tm
(pod2pdf) Tj
1 0 0 1 474.11 797 Tm
(Html2Wml) Tj
/F00 10 Tf
1 0 0 1 102.0 770.0 Tm
0.0000 Tw
(    \{FILEPATH\}\{FILENAME\}.wbmp ) Tj
/F21 12 Tf
1 0 0 1 72.0 752.0 Tm
0.0000 Tw
(PROXY SUPPORT ) Tj
/F00 10 Tf
1 0 0 1 102.0 737.6 Tm
1.3137 Tw
(Html2Wml uses LWP built-in proxy support. It is activated by default, and  loads the proxy settings) Tj
1 0 0 1 102.0 725.6 Tm
0.1453 Tw
(from the environment variables, using the same  variables as many others programs. Each protocol \(http,) Tj
1 0 0 1 102.0 713.6 Tm
1.0722 Tw
(ftp, etc\) can be  mapped to use a proxy server by setting a variable of the form ) Tj
/F10 10 Tf
1.0722 Tw
(PROTOCOL_proxy) Tj
/F00 10 Tf
1.0722 Tw
(.) Tj
1 0 0 1 102.0 701.6 Tm
1.2750 Tw
(Example: use ) Tj
/F10 10 Tf
1.2750 Tw
(http_proxy) Tj
/F00 10 Tf
1.2750 Tw
( to define the proxy for http access, ) Tj
/F10 10 Tf
1.2750 Tw
(ftp_proxy) Tj
/F00 10 Tf
1.2750 Tw
(  for ftp access. In the) Tj
1 0 0 1 102.0 689.6 Tm
0.0000 Tw
(shell, this is only a matter of defining the variable.  ) Tj
/F00 10 Tf
1 0 0 1 102.0 677.6 Tm
0.0000 Tw
(For Bourne shell:  ) Tj
/F10 10 Tf
1 0 0 1 102.0 665.6 Tm
0.0000 Tw
(    $ export http_proxy="http://proxy.domain.com:8080/" ) Tj
/F00 10 Tf
1 0 0 1 102.0 641.6 Tm
0.0000 Tw
(For C-shell:  ) Tj
/F10 10 Tf
1 0 0 1 102.0 629.6 Tm
0.0000 Tw
(    % setenv http_proxy "http://proxy.domain.com:8080/" ) Tj
/F00 10 Tf
1 0 0 1 102.0 605.6 Tm
0.0000 Tw
(Under Apache, you can add this directive to your configuration file:  ) Tj
/F10 10 Tf
1 0 0 1 102.0 593.6 Tm
0.0000 Tw
(    SetEnv http_proxy "http://proxy.domain.com:8080" ) Tj
/F00 10 Tf
1 0 0 1 102.0 569.6 Tm
0.2611 Tw
(but this has the default that another CGI, or another program, can use  this to access external ressources.) Tj
1 0 0 1 102.0 557.6 Tm
0.0000 Tw
(A better way is to edit Html2Wml and  fill the option ) Tj
/F10 10 Tf
0.0000 Tw
(proxy-server) Tj
/F00 10 Tf
0.0000 Tw
( with the appropriate value.  ) Tj
/F21 12 Tf
1 0 0 1 72.0 527.6 Tm
0.0000 Tw
(CAVEATS ) Tj
/F00 10 Tf
1 0 0 1 102.0 513.2 Tm
1.5887 Tw
(Html2Wml tries to make correct WML documents, but the well-formedness and the  validity of the) Tj
1 0 0 1 102.0 501.2 Tm
0.0000 Tw
(document are not guarantied.  ) Tj
/F00 10 Tf
1 0 0 1 102.0 489.2 Tm
3.1233 Tw
(Inverted tags \(like "bold italic"\)  may produce unexpected results. But only bad) Tj
1 0 0 1 102.0 477.2 Tm
0.0000 Tw
(softwares do bad stuff like this.  ) Tj
/F21 12 Tf
1 0 0 1 72.0 447.2 Tm
0.0000 Tw
(LINKS ) Tj
/F21 10 Tf
1 0 0 1 72.0 425.6 Tm
0.0000 Tw
(Download ) Tj
/F20 10 Tf
1 0 0 1 102.0 411.2 Tm
0.0000 Tw
(Html2Wml ) Tj
/F00 10 Tf
1 0 0 1 126.0 399.2 Tm
0.5619 Tw
(This is the web site of the Html2Wml project, hosted by SourceForge.net.  All the stable releases) Tj
1 0 0 1 126.0 387.2 Tm
0.0000 Tw
(can be downloaded from this site.  ) Tj
/F00 10 Tf
1 0 0 1 126.0 375.2 Tm
0.0000 Tw
([ http://www.html2wml.org/ ] ) Tj
/F20 10 Tf
1 0 0 1 102.0 360.8 Tm
0.0000 Tw
(Nutialand ) Tj
/F00 10 Tf
1 0 0 1 126.0 348.8 Tm
2.5363 Tw
(This is the web site of the author, where you can find the archives of  all the releases of) Tj
1 0 0 1 126.0 336.8 Tm
0.0000 Tw
(Html2Wml.  ) Tj
/F00 10 Tf
1 0 0 1 126.0 324.8 Tm
0.0000 Tw
([ http://www.maddingue.org/softwares/ ] ) Tj
/F21 10 Tf
1 0 0 1 72.0 294.8 Tm
0.0000 Tw
(Resources ) Tj
/F20 10 Tf
1 0 0 1 102.0 280.4 Tm
0.0000 Tw
(The WAP Forum ) Tj
/F00 10 Tf
1 0 0 1 126.0 268.4 Tm
1.6724 Tw
(This is the official site of the WAP Forum. You can find some technical  information, as the) Tj
1 0 0 1 126.0 256.4 Tm
0.0000 Tw
(specifications of all the technologies associated with  the WAP.  ) Tj
/F00 10 Tf
1 0 0 1 126.0 244.4 Tm
0.0000 Tw
([ http://www.wapforum.org/ ] ) Tj
/F20 10 Tf
1 0 0 1 102.0 218.0 Tm
0.0000 Tw
(WAP.com ) Tj
/F00 10 Tf
1 0 0 1 126.0 206.0 Tm
0.0000 Tw
(This site has some useful information and links. In particular, it has  a quite well done FAQ.  ) Tj
/F00 10 Tf
1 0 0 1 126.0 194.0 Tm
0.0000 Tw
([ http://www.wap.com/ ] ) Tj
/F20 10 Tf
1 0 0 1 102.0 167.6 Tm
0.0000 Tw
(The World Wide Web Consortium ) Tj
/F00 10 Tf
1 0 0 1 126.0 155.6 Tm
0.1917 Tw
(Altough not directly related to the Wap stuff, you may find useful  to read the specifications of the) Tj
1 0 0 1 126.0 143.6 Tm
0.5250 Tw
(XML \(WML is an XML application\), and the  specifications of the different stylesheet languages) Tj
1 0 0 1 126.0 131.6 Tm
0.0000 Tw
(\(CSS and XSL\), which  include support for low-resolution devices.  ) Tj
/F00 10 Tf
1 0 0 1 126.0 119.6 Tm
0.0000 Tw
([ http://www.w3.org/ ] ) Tj
/F20 10 Tf
1 0 0 1 102.0 93.2 Tm
0.0000 Tw
(TuxMobil ) Tj
/F00 10 Tf
1 0 0 1 126.0 81.2 Tm
1.7639 Tw
(This web site is dedicated to Mobile UniX systems. It leads you to a lot  of useful hands-on) Tj
1 0 0 1 126.0 69.2 Tm
1.7107 Tw
(information about installing and running Linux and BSD on  laptops, PDAs and other mobile) Tj
/F21 10 Tf
1 0 0 1 72 37 Tm
(26 October 2003) Tj
1 0 0 1 517.44 37 Tm
(7) Tj
ET
72 50 m
523 50 l
S
endstream
endobj
43 0 obj
5016
endobj
44 0 obj
<<
/ProcSet [/PDF /Text]
/ColorSpace <>
/Font
<<
/F00 6 0 R
/F10 10 0 R
/F20 14 0 R
/F21 15 0 R
>>
>>
endobj
45 0 obj
<<
/Type /Page
/Parent 4 0 R
/Resources 44 0 R
/Contents 42 0 R
>>
endobj
46 0 obj
<<
/Length 47 0 R
>>
stream
72 792 m
523 792 l
S
BT
0 G
1 i 0 J 0 j 0.1 w 10 M []0 d
/F21 10 Tf
1 0 0 1 72 797 Tm
(Html2Wml) Tj
1 0 0 1 483.56 797 Tm
(pod2pdf) Tj
/F00 10 Tf
1 0 0 1 126.0 770.0 Tm
0.0000 Tw
(computer devices.  ) Tj
/F00 10 Tf
1 0 0 1 126.0 758.0 Tm
0.0000 Tw
([ http://www.tuxmobil.org/ ] ) Tj
/F21 10 Tf
1 0 0 1 72.0 728.0 Tm
0.0000 Tw
(Programmers utilities ) Tj
/F20 10 Tf
1 0 0 1 102.0 713.6 Tm
0.0000 Tw
(HTML Tidy ) Tj
/F00 10 Tf
1 0 0 1 126.0 701.6 Tm
1.7376 Tw
(This is a very handful utility which corrects your HTML files  so that they conform to W3C) Tj
1 0 0 1 126.0 689.6 Tm
0.0000 Tw
(standards.  ) Tj
/F00 10 Tf
1 0 0 1 126.0 677.6 Tm
0.0000 Tw
([ http://www.w3.org/People/Raggett/tidy ] ) Tj
/F20 10 Tf
1 0 0 1 102.0 651.2 Tm
0.0000 Tw
(Kannel ) Tj
/F00 10 Tf
1 0 0 1 126.0 639.2 Tm
3.0625 Tw
(Kannel is an open source Wap and SMS gateway.  A WML compiler is included in the) Tj
1 0 0 1 126.0 627.2 Tm
0.0000 Tw
(distribution.  ) Tj
/F00 10 Tf
1 0 0 1 126.0 615.2 Tm
0.0000 Tw
([ http://www.kannel.org/ ] ) Tj
/F20 10 Tf
1 0 0 1 102.0 588.8 Tm
0.0000 Tw
(WML Tools ) Tj
/F00 10 Tf
1 0 0 1 126.0 576.8 Tm
0.7706 Tw
(This is a collection of utilities for WML programmers. This include  a compiler, a decompiler, a) Tj
1 0 0 1 126.0 564.8 Tm
0.0000 Tw
(viewer and a WBMP converter.  ) Tj
/F00 10 Tf
1 0 0 1 126.0 552.8 Tm
0.0000 Tw
([ http://pwot.co.uk/wml/ ] ) Tj
/F21 10 Tf
1 0 0 1 72.0 522.8 Tm
0.0000 Tw
(WML browsers and Wap emulators ) Tj
/F20 10 Tf
1 0 0 1 102.0 508.4 Tm
0.0000 Tw
(Opera ) Tj
/F00 10 Tf
1 0 0 1 126.0 496.4 Tm
1.3494 Tw
(Opera is originaly a Web browser, but the version 5 has a good support  for XML and WML.) Tj
1 0 0 1 126.0 484.4 Tm
0.0000 Tw
(Opera is available for free for several systems.  ) Tj
/F00 10 Tf
1 0 0 1 126.0 472.4 Tm
0.0000 Tw
([ http://www.opera.com/ ] ) Tj
/F20 10 Tf
1 0 0 1 102.0 458.0 Tm
0.0000 Tw
(wApua ) Tj
/F00 10 Tf
1 0 0 1 126.0 446.0 Tm
1.5956 Tw
(wApua is an open source WML browser written in Perl/Tk.  It`s easy to intall and to use. Its) Tj
1 0 0 1 126.0 434.0 Tm
0.0000 Tw
(support for WML is incomplete,  but sufficient for testing purpose.  ) Tj
/F00 10 Tf
1 0 0 1 126.0 422.0 Tm
0.0000 Tw
([ http://fsinfo.cs.uni-sb.de/~abe/wApua/ ] ) Tj
/F20 10 Tf
1 0 0 1 102.0 395.6 Tm
0.0000 Tw
(Tofoa ) Tj
/F00 10 Tf
1 0 0 1 126.0 383.6 Tm
0.4624 Tw
(Tofoa is an open source Wap emulator written in Python.  Its installation is quite difficult, and its) Tj
1 0 0 1 126.0 371.6 Tm
0.0000 Tw
(incomplete WML support  makes it produce strange results, even with valid WML documents.  ) Tj
/F00 10 Tf
1 0 0 1 126.0 359.6 Tm
0.0000 Tw
([ http://tofoa.free-system.com/ ] ) Tj
/F20 10 Tf
1 0 0 1 102.0 333.2 Tm
0.0000 Tw
(EzWAP ) Tj
/F00 10 Tf
1 0 0 1 126.0 321.2 Tm
0.3053 Tw
(EzWAP, from EZOS, is a commercial WML browser freely available for  Windows 9x, NT, 2000) Tj
1 0 0 1 126.0 309.2 Tm
0.0081 Tw
(and CE. Compared to others Windows WML browsers,  it requires very few resources, and is quite) Tj
1 0 0 1 126.0 297.2 Tm
0.0000 Tw
(stable. Its support for  the WML specs seems quite complete. A very good software.  ) Tj
/F00 10 Tf
1 0 0 1 126.0 285.2 Tm
0.0000 Tw
([ http://www.ezos.com/ ] ) Tj
/F20 10 Tf
1 0 0 1 102.0 258.8 Tm
0.0000 Tw
(Deck-It ) Tj
/F00 10 Tf
1 0 0 1 126.0 246.8 Tm
0.3793 Tw
(Deck-It is a commercial Wap phone emulator, available for Windows and  Linux/Intel only. It`s a) Tj
1 0 0 1 126.0 234.8 Tm
0.7453 Tw
(very good piece of software which really  show how WML pages are rendered on a Wap phone,) Tj
1 0 0 1 126.0 222.8 Tm
0.0000 Tw
(but one of its  major default is that it cannot read local files.  ) Tj
/F00 10 Tf
1 0 0 1 126.0 210.8 Tm
0.0000 Tw
([ http://www.pyweb.com/tools/ ] ) Tj
/F20 10 Tf
1 0 0 1 102.0 184.4 Tm
0.0000 Tw
(Klondike WAP Browser ) Tj
/F00 10 Tf
1 0 0 1 126.0 172.4 Tm
0.0000 Tw
(Klondike WAP Browser is a commercial WAP browser available for Windows  and PocketPC.  ) Tj
/F00 10 Tf
1 0 0 1 126.0 160.4 Tm
0.0000 Tw
([ http://www.apachesoftware.com/ ] ) Tj
/F20 10 Tf
1 0 0 1 102.0 134.0 Tm
0.0000 Tw
(WinWAP ) Tj
/F00 10 Tf
1 0 0 1 126.0 122.0 Tm
0.0000 Tw
(WinWAP is a commercial Wap browser, freely available for Windows.  ) Tj
/F00 10 Tf
1 0 0 1 126.0 110.0 Tm
0.0000 Tw
([ http://www.winwap.org/ ] ) Tj
/F20 10 Tf
1 0 0 1 102.0 83.6 Tm
0.0000 Tw
(WAPman ) Tj
/F21 10 Tf
1 0 0 1 72 37 Tm
(8) Tj
1 0 0 1 445.74 37 Tm
(26 October 2003) Tj
ET
72 50 m
523 50 l
S
endstream
endobj
47 0 obj
4368
endobj
48 0 obj
<<
/ProcSet [/PDF /Text]
/ColorSpace <>
/Font
<<
/F00 6 0 R
/F20 14 0 R
/F21 15 0 R
>>
>>
endobj
49 0 obj
<<
/Type /Page
/Parent 4 0 R
/Resources 48 0 R
/Contents 46 0 R
>>
endobj
50 0 obj
<<
/Length 51 0 R
>>
stream
72 792 m
523 792 l
S
BT
0 G
1 i 0 J 0 j 0.1 w 10 M []0 d
/F21 10 Tf
1 0 0 1 72 797 Tm
(pod2pdf) Tj
1 0 0 1 474.11 797 Tm
(Html2Wml) Tj
/F00 10 Tf
1 0 0 1 126.0 770.0 Tm
0.0000 Tw
(WAPman from EdgeMatrix, is a commercial WAP browser available for  Windows and PalmOS.  ) Tj
/F00 10 Tf
1 0 0 1 126.0 758.0 Tm
0.0000 Tw
([ http://www.edgematrix.com/edge/control/MainContentBean?page=downloads ] ) Tj
/F20 10 Tf
1 0 0 1 102.0 731.6 Tm
0.0000 Tw
(Wireless Companion ) Tj
/F00 10 Tf
1 0 0 1 126.0 719.6 Tm
0.0000 Tw
(Wireless Companion, from YourWap.com, is a WAP emulator available  for Windows.  ) Tj
/F00 10 Tf
1 0 0 1 126.0 707.6 Tm
0.0000 Tw
([ http://www.yourwap.com/ ] ) Tj
/F20 10 Tf
1 0 0 1 102.0 681.2 Tm
0.0000 Tw
(Mobilizer ) Tj
/F00 10 Tf
1 0 0 1 126.0 669.2 Tm
0.0000 Tw
(Mobilizer is a Wap emulator available for Windows and Unix.  ) Tj
/F00 10 Tf
1 0 0 1 126.0 657.2 Tm
0.0000 Tw
([ http://mobilizer.sourceforge.net/ ] ) Tj
/F20 10 Tf
1 0 0 1 102.0 630.8 Tm
0.0000 Tw
(QWmlBrowser ) Tj
/F00 10 Tf
1 0 0 1 126.0 618.8 Tm
1.1854 Tw
(QWmlBrowser \(formerly known as WML BRowser\) is an open source  WML browser, written) Tj
1 0 0 1 126.0 606.8 Tm
0.0000 Tw
(using the Qt toolkit.  ) Tj
/F00 10 Tf
1 0 0 1 126.0 594.8 Tm
0.0000 Tw
([ http://www.wmlbrowser.org/ ] ) Tj
/F20 10 Tf
1 0 0 1 102.0 568.4 Tm
0.0000 Tw
(Wapsody ) Tj
/F00 10 Tf
1 0 0 1 126.0 556.4 Tm
1.1185 Tw
(Wapsody, developed by IBM, is a freely available simulation  environment that implements the) Tj
1 0 0 1 126.0 544.4 Tm
0.4781 Tw
(WAP specification. It also  features a WML browser which can be run stand-alone.  As Wapsody) Tj
1 0 0 1 126.0 532.4 Tm
0.0000 Tw
(is written in Java/Swing, it should work on any  system.  ) Tj
/F00 10 Tf
1 0 0 1 126.0 520.4 Tm
0.0000 Tw
([ http://alphaworks.ibm.com/aw.nsf/techmain/wapsody ] ) Tj
/F20 10 Tf
1 0 0 1 102.0 494.0 Tm
0.0000 Tw
(WAPreview ) Tj
/F00 10 Tf
1 0 0 1 126.0 482.0 Tm
0.6358 Tw
(WAPreview is a Wap emulator written in Java. As it uses an HTML  based UI and needs a local) Tj
1 0 0 1 126.0 470.0 Tm
0.0000 Tw
(web proxy, it runs quite slowly.  ) Tj
/F00 10 Tf
1 0 0 1 126.0 458.0 Tm
0.0000 Tw
([ http://wapreview.sourceforge.net ] ) Tj
/F20 10 Tf
1 0 0 1 102.0 431.6 Tm
0.0000 Tw
(PicoWap ) Tj
/F00 10 Tf
1 0 0 1 126.0 419.6 Tm
0.0000 Tw
(PicoWap is a small WML browser made by three French students.  ) Tj
/F00 10 Tf
1 0 0 1 126.0 407.6 Tm
0.0000 Tw
([ http://membres.lycos.fr/picowap/ ] ) Tj
/F21 12 Tf
1 0 0 1 72.0 377.6 Tm
0.0000 Tw
(ACKNOWLEDGEMENTS ) Tj
/F00 10 Tf
1 0 0 1 102.0 363.2 Tm
0.0000 Tw
(Werner Heuser, for his numerous ideas, advices and his help for the debugging ) Tj
/F00 10 Tf
1 0 0 1 102.0 351.2 Tm
0.0000 Tw
(Igor Khristophorov, for his numerous suggestions and patches ) Tj
/F00 10 Tf
1 0 0 1 102.0 339.2 Tm
0.0000 Tw
(And all the people that send me bug reports: Daniele Frijia, Axel Jerabek, Ouyang ) Tj
/F21 12 Tf
1 0 0 1 72.0 309.2 Tm
0.0000 Tw
(AUTHOR ) Tj
/F00 10 Tf
1 0 0 1 102.0 294.8 Tm
0.0000 Tw
(S\351bastien Aperghis-Tramoni  ) Tj
/F21 12 Tf
1 0 0 1 72.0 264.8 Tm
0.0000 Tw
(COPYRIGHT ) Tj
/F00 10 Tf
1 0 0 1 102.0 250.4 Tm
0.0000 Tw
(Copyright \(C\)2000, 2001, 2002 S\351bastien Aperghis-Tramoni ) Tj
/F00 10 Tf
1 0 0 1 102.0 238.4 Tm
1.3094 Tw
(This program is free software. You can redistribute it and/or modify it  under the terms of the GNU) Tj
1 0 0 1 102.0 226.4 Tm
0.0000 Tw
(General Public License, version 2 or later.  ) Tj
/F21 10 Tf
1 0 0 1 72 37 Tm
(26 October 2003) Tj
1 0 0 1 517.44 37 Tm
(9) Tj
ET
72 50 m
523 50 l
S
endstream
endobj
51 0 obj
3529
endobj
52 0 obj
<<
/ProcSet [/PDF /Text]
/ColorSpace <>
/Font
<<
/F00 6 0 R
/F20 14 0 R
/F21 15 0 R
>>
>>
endobj
53 0 obj
<<
/Type /Page
/Parent 4 0 R
/Resources 52 0 R
/Contents 50 0 R
>>
endobj
54 0 obj
<<
/Length 55 0 R
>>
stream
72 792 m
523 792 l
S
BT
0 G
1 i 0 J 0 j 0.1 w 10 M []0 d
/F21 10 Tf
1 0 0 1 72 797 Tm
(Html2Wml) Tj
1 0 0 1 483.56 797 Tm
(pod2pdf) Tj
/F21 10 Tf
1 0 0 1 72 37 Tm
(10) Tj
1 0 0 1 445.74 37 Tm
(26 October 2003) Tj
ET
72 50 m
523 50 l
S
endstream
endobj
55 0 obj
235
endobj
56 0 obj
<<
/ProcSet [/PDF /Text]
/ColorSpace <>
/Font
<<
/F21 15 0 R
>>
>>
endobj
57 0 obj
<<
/Type /Page
/Parent 4 0 R
/Resources 56 0 R
/Contents 54 0 R
>>
endobj
58 0 obj
<<
/Length 59 0 R
>>
stream
S
BT
0 G
1 i 0 J 0 j 0.1 w 10 M []0 d
/F21 10 Tf
/F20 24 Tf
1 0 0 1 202.784 770 Tm
(Table of Contents) Tj
1 0 0 1 242.18 741.2 Tm
(Html2Wml) Tj
/F20 10 Tf
ET
q
0.95 g
72 680.6 451 12 re
f
Q
BT
1 0 0 1 102 683.6 Tm
(NAME) Tj
1 0 0 1 487.44 683.6 Tm
(1) Tj
ET
q
1 g
72 668.6 451 12 re
f
Q
BT
1 0 0 1 102 671.6 Tm
(SYNOPSIS) Tj
1 0 0 1 487.44 671.6 Tm
(1) Tj
ET
q
0.95 g
72 656.6 451 12 re
f
Q
BT
1 0 0 1 102 659.6 Tm
(DESCRIPTION) Tj
1 0 0 1 487.44 659.6 Tm
(1) Tj
ET
q
1 g
72 644.6 451 12 re
f
Q
BT
1 0 0 1 102 647.6 Tm
(OPTIONS) Tj
1 0 0 1 487.44 647.6 Tm
(1) Tj
ET
q
0.95 g
72 632.6 451 12 re
f
Q
BT
1 0 0 1 132 635.6 Tm
(Conversion Options) Tj
1 0 0 1 487.44 635.6 Tm
(1) Tj
ET
q
1 g
72 620.6 451 12 re
f
Q
BT
1 0 0 1 162 623.6 Tm
(-a, \217ascii) Tj
1 0 0 1 487.44 623.6 Tm
(1) Tj
ET
q
0.95 g
72 608.6 451 12 re
f
Q
BT
1 0 0 1 162 611.6 Tm
(\217[no]collapse) Tj
1 0 0 1 487.44 611.6 Tm
(1) Tj
ET
q
1 g
72 596.6 451 12 re
f
Q
BT
1 0 0 1 162 599.6 Tm
(\217ignore-images) Tj
1 0 0 1 487.44 599.6 Tm
(1) Tj
ET
q
0.95 g
72 584.6 451 12 re
f
Q
BT
1 0 0 1 162 587.6 Tm
(\217[no]img-alt-text) Tj
1 0 0 1 487.44 587.6 Tm
(1) Tj
ET
q
1 g
72 572.6 451 12 re
f
Q
BT
1 0 0 1 162 575.6 Tm
(\217[no]linearize) Tj
1 0 0 1 487.44 575.6 Tm
(2) Tj
ET
q
0.95 g
72 560.6 451 12 re
f
Q
BT
1 0 0 1 162 563.6 Tm
(-n, \217numeric-non-ascii) Tj
1 0 0 1 487.44 563.6 Tm
(2) Tj
ET
q
1 g
72 548.6 451 12 re
f
Q
BT
1 0 0 1 162 551.6 Tm
(-p, \217nopre) Tj
1 0 0 1 487.44 551.6 Tm
(2) Tj
ET
q
0.95 g
72 536.6 451 12 re
f
Q
BT
1 0 0 1 132 539.6 Tm
(Links Reconstruction Options) Tj
1 0 0 1 487.44 539.6 Tm
(2) Tj
ET
q
1 g
72 524.6 451 12 re
f
Q
BT
1 0 0 1 162 527.6 Tm
(\217hreftmpl=TEMPLATE) Tj
1 0 0 1 487.44 527.6 Tm
(2) Tj
ET
q
0.95 g
72 512.6 451 12 re
f
Q
BT
1 0 0 1 162 515.6 Tm
(\217srctmpl=TEMPLATE) Tj
1 0 0 1 487.44 515.6 Tm
(2) Tj
ET
q
1 g
72 500.6 451 12 re
f
Q
BT
1 0 0 1 132 503.6 Tm
(Splitting Options) Tj
1 0 0 1 487.44 503.6 Tm
(2) Tj
ET
q
0.95 g
72 488.6 451 12 re
f
Q
BT
1 0 0 1 162 491.6 Tm
(-s, \217max-card-size=SIZE) Tj
1 0 0 1 487.44 491.6 Tm
(2) Tj
ET
q
1 g
72 476.6 451 12 re
f
Q
BT
1 0 0 1 162 479.6 Tm
(-t, \217card-split-threshold=SIZE) Tj
1 0 0 1 487.44 479.6 Tm
(2) Tj
ET
q
0.95 g
72 464.6 451 12 re
f
Q
BT
1 0 0 1 162 467.6 Tm
(\217next-card-label=STRING) Tj
1 0 0 1 487.44 467.6 Tm
(2) Tj
ET
q
1 g
72 452.6 451 12 re
f
Q
BT
1 0 0 1 162 455.6 Tm
(\217prev-card-label=STRING) Tj
1 0 0 1 487.44 455.6 Tm
(2) Tj
ET
q
0.95 g
72 440.6 451 12 re
f
Q
BT
1 0 0 1 132 443.6 Tm
(HTTP Authentication) Tj
1 0 0 1 487.44 443.6 Tm
(2) Tj
ET
q
1 g
72 428.6 451 12 re
f
Q
BT
1 0 0 1 162 431.6 Tm
(-U, \217http-user=USERNAME) Tj
1 0 0 1 487.44 431.6 Tm
(2) Tj
ET
q
0.95 g
72 416.6 451 12 re
f
Q
BT
1 0 0 1 162 419.6 Tm
(-P, \217http-passwd=PASSWORD) Tj
1 0 0 1 487.44 419.6 Tm
(3) Tj
ET
q
1 g
72 404.6 451 12 re
f
Q
BT
1 0 0 1 132 407.6 Tm
(Proxy Support) Tj
1 0 0 1 487.44 407.6 Tm
(3) Tj
ET
q
0.95 g
72 392.6 451 12 re
f
Q
BT
1 0 0 1 162 395.6 Tm
(-[no]Y, \217[no]proxy) Tj
1 0 0 1 487.44 395.6 Tm
(3) Tj
ET
q
1 g
72 380.6 451 12 re
f
Q
BT
1 0 0 1 132 383.6 Tm
(Output Options) Tj
1 0 0 1 487.44 383.6 Tm
(3) Tj
ET
q
0.95 g
72 368.6 451 12 re
f
Q
BT
1 0 0 1 162 371.6 Tm
(-k, \217compile) Tj
1 0 0 1 487.44 371.6 Tm
(3) Tj
ET
q
1 g
72 356.6 451 12 re
f
Q
BT
1 0 0 1 162 359.6 Tm
(-o, \217output) Tj
1 0 0 1 487.44 359.6 Tm
(3) Tj
ET
q
0.95 g
72 344.6 451 12 re
f
Q
BT
1 0 0 1 132 347.6 Tm
(Debugging Options) Tj
1 0 0 1 487.44 347.6 Tm
(3) Tj
ET
q
1 g
72 332.6 451 12 re
f
Q
BT
1 0 0 1 162 335.6 Tm
(-d, \217debug[=LEVEL]) Tj
1 0 0 1 487.44 335.6 Tm
(3) Tj
ET
q
0.95 g
72 320.6 451 12 re
f
Q
BT
1 0 0 1 162 323.6 Tm
(\217xmlcheck) Tj
1 0 0 1 487.44 323.6 Tm
(3) Tj
ET
q
1 g
72 308.6 451 12 re
f
Q
BT
1 0 0 1 102 311.6 Tm
(DECK SLICING) Tj
1 0 0 1 487.44 311.6 Tm
(3) Tj
ET
q
0.95 g
72 296.6 451 12 re
f
Q
BT
1 0 0 1 132 299.6 Tm
(Slice by cards or by decks) Tj
1 0 0 1 487.44 299.6 Tm
(3) Tj
ET
q
1 g
72 284.6 451 12 re
f
Q
BT
1 0 0 1 132 287.6 Tm
(Note on size calculation) Tj
1 0 0 1 487.44 287.6 Tm
(4) Tj
ET
q
0.95 g
72 272.6 451 12 re
f
Q
BT
1 0 0 1 132 275.6 Tm
(Why compiling the WML deck?) Tj
1 0 0 1 487.44 275.6 Tm
(4) Tj
ET
q
1 g
72 260.6 451 12 re
f
Q
BT
1 0 0 1 102 263.6 Tm
(ACTIONS) Tj
1 0 0 1 487.44 263.6 Tm
(4) Tj
ET
q
0.95 g
72 248.6 451 12 re
f
Q
BT
1 0 0 1 132 251.6 Tm
(Syntax) Tj
1 0 0 1 487.44 251.6 Tm
(4) Tj
ET
q
1 g
72 236.6 451 12 re
f
Q
BT
1 0 0 1 132 239.6 Tm
(Available actions) Tj
1 0 0 1 487.44 239.6 Tm
(5) Tj
ET
q
0.95 g
72 224.6 451 12 re
f
Q
BT
1 0 0 1 162 227.6 Tm
(include) Tj
1 0 0 1 487.44 227.6 Tm
(5) Tj
ET
q
1 g
72 212.6 451 12 re
f
Q
BT
1 0 0 1 162 215.6 Tm
(Description) Tj
1 0 0 1 487.44 215.6 Tm
(5) Tj
ET
q
0.95 g
72 200.6 451 12 re
f
Q
BT
1 0 0 1 162 203.6 Tm
(Parameters) Tj
1 0 0 1 487.44 203.6 Tm
(5) Tj
ET
q
1 g
72 188.6 451 12 re
f
Q
BT
1 0 0 1 162 191.6 Tm
(fsize) Tj
1 0 0 1 487.44 191.6 Tm
(5) Tj
ET
q
0.95 g
72 176.6 451 12 re
f
Q
BT
1 0 0 1 162 179.6 Tm
(Description) Tj
1 0 0 1 487.44 179.6 Tm
(5) Tj
ET
q
1 g
72 164.6 451 12 re
f
Q
BT
1 0 0 1 162 167.6 Tm
(Parameters) Tj
1 0 0 1 487.44 167.6 Tm
(5) Tj
ET
q
0.95 g
72 152.6 451 12 re
f
Q
BT
1 0 0 1 162 155.6 Tm
(Notes) Tj
1 0 0 1 487.44 155.6 Tm
(5) Tj
ET
q
1 g
72 140.6 451 12 re
f
Q
BT
1 0 0 1 162 143.6 Tm
(skip) Tj
1 0 0 1 487.44 143.6 Tm
(5) Tj
ET
q
0.95 g
72 128.6 451 12 re
f
Q
BT
1 0 0 1 162 131.6 Tm
(Description) Tj
1 0 0 1 487.44 131.6 Tm
(5) Tj
ET
q
1 g
72 116.6 451 12 re
f
Q
BT
1 0 0 1 132 119.6 Tm
(Generic parameters) Tj
1 0 0 1 487.44 119.6 Tm
(5) Tj
ET
q
0.95 g
72 104.6 451 12 re
f
Q
BT
1 0 0 1 162 107.6 Tm
(for=output format) Tj
1 0 0 1 487.44 107.6 Tm
(5) Tj
ET
q
1 g
72 92.6 451 12 re
f
Q
BT
1 0 0 1 132 95.6 Tm
(Examples) Tj
1 0 0 1 487.44 95.6 Tm
(5) Tj
ET
q
0.95 g
72 80.6 451 12 re
f
Q
BT
1 0 0 1 102 83.6 Tm
(LINKS RECONSTRUCTION) Tj
1 0 0 1 487.44 83.6 Tm
(5) Tj
ET
q
1 g
72 68.6 451 12 re
f
Q
BT
1 0 0 1 132 71.6 Tm
(Templates) Tj
1 0 0 1 487.44 71.6 Tm
(6) Tj
/F21 10 Tf
1 0 0 1 72 37 Tm
(26 October 2003) Tj
1 0 0 1 520.22 37 Tm
(i) Tj
ET
72 50 m
523 50 l
S
endstream
endobj
59 0 obj
5990
endobj
60 0 obj
<<
/ProcSet [/PDF /Text]
/ColorSpace <>
/Font
<<
/F20 14 0 R
/F21 15 0 R
>>
>>
endobj
61 0 obj
<<
/Type /Page
/Parent 4 0 R
/Resources 60 0 R
/Contents 58 0 R
>>
endobj
62 0 obj
<<
/Length 63 0 R
>>
stream
72 792 m
523 792 l
S
BT
0 G
1 i 0 J 0 j 0.1 w 10 M []0 d
/F21 10 Tf
1 0 0 1 72 797 Tm
(Html2Wml) Tj
1 0 0 1 438.55 797 Tm
(Table of Contents) Tj
/F20 10 Tf
ET
q
0.95 g
72 767 451 12 re
f
Q
BT
1 0 0 1 162 770 Tm
(HREF Template) Tj
1 0 0 1 487.44 770 Tm
(6) Tj
ET
q
1 g
72 755 451 12 re
f
Q
BT
1 0 0 1 162 758 Tm
(Image Source Template) Tj
1 0 0 1 487.44 758 Tm
(6) Tj
ET
q
0.95 g
72 743 451 12 re
f
Q
BT
1 0 0 1 132 746 Tm
(Syntax) Tj
1 0 0 1 487.44 746 Tm
(6) Tj
ET
q
1 g
72 731 451 12 re
f
Q
BT
1 0 0 1 132 734 Tm
(Available parameters) Tj
1 0 0 1 487.44 734 Tm
(6) Tj
ET
q
0.95 g
72 719 451 12 re
f
Q
BT
1 0 0 1 162 722 Tm
(URL) Tj
1 0 0 1 487.44 722 Tm
(6) Tj
ET
q
1 g
72 707 451 12 re
f
Q
BT
1 0 0 1 162 710 Tm
(FILENAME) Tj
1 0 0 1 487.44 710 Tm
(6) Tj
ET
q
0.95 g
72 695 451 12 re
f
Q
BT
1 0 0 1 162 698 Tm
(FILEPATH) Tj
1 0 0 1 487.44 698 Tm
(6) Tj
ET
q
1 g
72 683 451 12 re
f
Q
BT
1 0 0 1 162 686 Tm
(FILETYPE) Tj
1 0 0 1 487.44 686 Tm
(6) Tj
ET
q
0.95 g
72 671 451 12 re
f
Q
BT
1 0 0 1 132 674 Tm
(Examples) Tj
1 0 0 1 487.44 674 Tm
(6) Tj
ET
q
1 g
72 659 451 12 re
f
Q
BT
1 0 0 1 102 662 Tm
(PROXY SUPPORT) Tj
1 0 0 1 487.44 662 Tm
(7) Tj
ET
q
0.95 g
72 647 451 12 re
f
Q
BT
1 0 0 1 102 650 Tm
(CAVEATS) Tj
1 0 0 1 487.44 650 Tm
(7) Tj
ET
q
1 g
72 635 451 12 re
f
Q
BT
1 0 0 1 102 638 Tm
(LINKS) Tj
1 0 0 1 487.44 638 Tm
(7) Tj
ET
q
0.95 g
72 623 451 12 re
f
Q
BT
1 0 0 1 132 626 Tm
(Download) Tj
1 0 0 1 487.44 626 Tm
(7) Tj
ET
q
1 g
72 611 451 12 re
f
Q
BT
1 0 0 1 162 614 Tm
(Html2Wml) Tj
1 0 0 1 487.44 614 Tm
(7) Tj
ET
q
0.95 g
72 599 451 12 re
f
Q
BT
1 0 0 1 162 602 Tm
(Nutialand) Tj
1 0 0 1 487.44 602 Tm
(7) Tj
ET
q
1 g
72 587 451 12 re
f
Q
BT
1 0 0 1 132 590 Tm
(Resources) Tj
1 0 0 1 487.44 590 Tm
(7) Tj
ET
q
0.95 g
72 575 451 12 re
f
Q
BT
1 0 0 1 162 578 Tm
(The WAP Forum) Tj
1 0 0 1 487.44 578 Tm
(7) Tj
ET
q
1 g
72 563 451 12 re
f
Q
BT
1 0 0 1 162 566 Tm
(WAP.com) Tj
1 0 0 1 487.44 566 Tm
(7) Tj
ET
q
0.95 g
72 551 451 12 re
f
Q
BT
1 0 0 1 162 554 Tm
(The World Wide Web Consortium) Tj
1 0 0 1 487.44 554 Tm
(7) Tj
ET
q
1 g
72 539 451 12 re
f
Q
BT
1 0 0 1 162 542 Tm
(TuxMobil) Tj
1 0 0 1 487.44 542 Tm
(7) Tj
ET
q
0.95 g
72 527 451 12 re
f
Q
BT
1 0 0 1 132 530 Tm
(Programmers utilities) Tj
1 0 0 1 487.44 530 Tm
(8) Tj
ET
q
1 g
72 515 451 12 re
f
Q
BT
1 0 0 1 162 518 Tm
(HTML Tidy) Tj
1 0 0 1 487.44 518 Tm
(8) Tj
ET
q
0.95 g
72 503 451 12 re
f
Q
BT
1 0 0 1 162 506 Tm
(Kannel) Tj
1 0 0 1 487.44 506 Tm
(8) Tj
ET
q
1 g
72 491 451 12 re
f
Q
BT
1 0 0 1 162 494 Tm
(WML Tools) Tj
1 0 0 1 487.44 494 Tm
(8) Tj
ET
q
0.95 g
72 479 451 12 re
f
Q
BT
1 0 0 1 132 482 Tm
(WML browsers and Wap emulators) Tj
1 0 0 1 487.44 482 Tm
(8) Tj
ET
q
1 g
72 467 451 12 re
f
Q
BT
1 0 0 1 162 470 Tm
(Opera) Tj
1 0 0 1 487.44 470 Tm
(8) Tj
ET
q
0.95 g
72 455 451 12 re
f
Q
BT
1 0 0 1 162 458 Tm
(wApua) Tj
1 0 0 1 487.44 458 Tm
(8) Tj
ET
q
1 g
72 443 451 12 re
f
Q
BT
1 0 0 1 162 446 Tm
(Tofoa) Tj
1 0 0 1 487.44 446 Tm
(8) Tj
ET
q
0.95 g
72 431 451 12 re
f
Q
BT
1 0 0 1 162 434 Tm
(EzWAP) Tj
1 0 0 1 487.44 434 Tm
(8) Tj
ET
q
1 g
72 419 451 12 re
f
Q
BT
1 0 0 1 162 422 Tm
(Deck-It) Tj
1 0 0 1 487.44 422 Tm
(8) Tj
ET
q
0.95 g
72 407 451 12 re
f
Q
BT
1 0 0 1 162 410 Tm
(Klondike WAP Browser) Tj
1 0 0 1 487.44 410 Tm
(8) Tj
ET
q
1 g
72 395 451 12 re
f
Q
BT
1 0 0 1 162 398 Tm
(WinWAP) Tj
1 0 0 1 487.44 398 Tm
(8) Tj
ET
q
0.95 g
72 383 451 12 re
f
Q
BT
1 0 0 1 162 386 Tm
(WAPman) Tj
1 0 0 1 487.44 386 Tm
(8) Tj
ET
q
1 g
72 371 451 12 re
f
Q
BT
1 0 0 1 162 374 Tm
(Wireless Companion) Tj
1 0 0 1 487.44 374 Tm
(9) Tj
ET
q
0.95 g
72 359 451 12 re
f
Q
BT
1 0 0 1 162 362 Tm
(Mobilizer) Tj
1 0 0 1 487.44 362 Tm
(9) Tj
ET
q
1 g
72 347 451 12 re
f
Q
BT
1 0 0 1 162 350 Tm
(QWmlBrowser) Tj
1 0 0 1 487.44 350 Tm
(9) Tj
ET
q
0.95 g
72 335 451 12 re
f
Q
BT
1 0 0 1 162 338 Tm
(Wapsody) Tj
1 0 0 1 487.44 338 Tm
(9) Tj
ET
q
1 g
72 323 451 12 re
f
Q
BT
1 0 0 1 162 326 Tm
(WAPreview) Tj
1 0 0 1 487.44 326 Tm
(9) Tj
ET
q
0.95 g
72 311 451 12 re
f
Q
BT
1 0 0 1 162 314 Tm
(PicoWap) Tj
1 0 0 1 487.44 314 Tm
(9) Tj
ET
q
1 g
72 299 451 12 re
f
Q
BT
1 0 0 1 102 302 Tm
(ACKNOWLEDGEMENTS) Tj
1 0 0 1 487.44 302 Tm
(9) Tj
ET
q
0.95 g
72 287 451 12 re
f
Q
BT
1 0 0 1 102 290 Tm
(AUTHOR) Tj
1 0 0 1 487.44 290 Tm
(9) Tj
ET
q
1 g
72 275 451 12 re
f
Q
BT
1 0 0 1 102 278 Tm
(COPYRIGHT) Tj
1 0 0 1 487.44 278 Tm
(9) Tj
/F21 10 Tf
1 0 0 1 72 37 Tm
(ii) Tj
1 0 0 1 445.74 37 Tm
(26 October 2003) Tj
ET
72 50 m
523 50 l
S
endstream
endobj
63 0 obj
4410
endobj
64 0 obj
<<
/ProcSet [/PDF /Text]
/ColorSpace <>
/Font
<<
/F20 14 0 R
/F21 15 0 R
>>
>>
endobj
65 0 obj
<<
/Type /Page
/Parent 4 0 R
/Resources 64 0 R
/Contents 62 0 R
>>
endobj
66 0 obj
<<
/Type /Page
/Parent 4 0 R
/Resources 69 0 R
/Contents 67 0 R
>>
endobj
67 0 obj
<<
/Length 68 0 R
>>
stream
q
1 0 0 rg
180 626 8 130 re
F
Q
0 G
1 i 0 J 0 j 0.1 w 10 M []0 d
210 626 m
523 626 l
s
BT
/F21 30 Tf
1 0 0 1 210 706 Tm
0 -30 TD
(POD Translation) Tj
T* (by ) Tj
0 0 0.8 rg
/F22 30 Tf
(pod2pdf) Tj
/F21 9 Tf
T* (ajf@afco.demon.co.uk) Tj
/F03 48 Tf
0 g
1 0 0 1 188.132 371 Tm
(Html2Wml) Tj
ET
endstream
endobj
68 0 obj
291
endobj
69 0 obj
<<
/ProcSet [/PDF /Text]
/ColorSpace <>
/Font
<<
/F03 9 0 R
/F21 15 0 R
/F22 16 0 R
>>
>>
endobj
70 0 obj
<<
/Length 71 0 R
>>
stream
72 792 m
523 792 l
S
BT
0 G
1 i 0 J 0 j 0.1 w 10 M []0 d
/F21 10 Tf
1 0 0 1 72 797 Tm
(Title Page) Tj
1 0 0 1 474.11 797 Tm
(Html2Wml) Tj
/F21 10 Tf
1 0 0 1 72 37 Tm
(26 October 2003) Tj
1 0 0 1 488.54 37 Tm
(Fly leaf) Tj
ET
72 50 m
523 50 l
S
endstream
endobj
71 0 obj
244
endobj
72 0 obj
<<
/ProcSet [/PDF /Text]
/ColorSpace <>
/Font
<<
/F21 15 0 R
>>
>>
endobj
73 0 obj
<<
/Type /Page
/Parent 4 0 R
/Resources 72 0 R
/Contents 70 0 R
>>
endobj
75 0 obj
<<
/Parent 74 0 R
/Dest [61 0 R /Fit]
/First 76 0 R
/Last 169 0 R
/Count 94 
/Title (Table of Contents)
>>
endobj
76 0 obj
<<
/Parent 75 0 R
/Dest [21 0 R /FitH 778.4]
/Next 77 0 R
/Title (NAME)
>>
endobj
77 0 obj
<<
/Parent 75 0 R
/Dest [21 0 R /FitH 746]
/Previous 76 0 R
/Next 78 0 R
/Title (SYNOPSIS)
>>
endobj
78 0 obj
<<
/Parent 75 0 R
/Dest [21 0 R /FitH 629.6]
/Previous 77 0 R
/Next 79 0 R
/Title (DESCRIPTION)
>>
endobj
79 0 obj
<<
/Parent 75 0 R
/Dest [21 0 R /FitH 417.2]
/Previous 78 0 R
/Next 107 0 R
/First 80 0 R
/Last 104 0 R
/Count 27 
/Title (OPTIONS)
>>
endobj
80 0 obj
<<
/Parent 79 0 R
/Dest [21 0 R /FitH 334.4]
/Next 88 0 R
/First 81 0 R
/Last 87 0 R
/Count 7 
/Title (Conversion Options)
>>
endobj
81 0 obj
<<
/Parent 80 0 R
/Dest [21 0 R /FitH 320]
/Next 82 0 R
/Title (-a, \217ascii)
>>
endobj
82 0 obj
<<
/Parent 80 0 R
/Dest [21 0 R /FitH 257.6]
/Previous 81 0 R
/Next 83 0 R
/Title (\217[no]collapse)
>>
endobj
83 0 obj
<<
/Parent 80 0 R
/Dest [21 0 R /FitH 135.2]
/Previous 82 0 R
/Next 84 0 R
/Title (\217ignore-images)
>>
endobj
84 0 obj
<<
/Parent 80 0 R
/Dest [21 0 R /FitH 96.8000000000002]
/Previous 83 0 R
/Next 85 0 R
/Title (\217[no]img-alt-text)
>>
endobj
85 0 obj
<<
/Parent 80 0 R
/Dest [25 0 R /FitH 743.6]
/Previous 84 0 R
/Next 86 0 R
/Title (\217[no]linearize)
>>
endobj
86 0 obj
<<
/Parent 80 0 R
/Dest [25 0 R /FitH 573.2]
/Previous 85 0 R
/Next 87 0 R
/Title (-n, \217numeric-non-ascii)
>>
endobj
87 0 obj
<<
/Parent 80 0 R
/Dest [25 0 R /FitH 522.8]
/Previous 86 0 R
/Title (-p, \217nopre)
>>
endobj
88 0 obj
<<
/Parent 79 0 R
/Dest [25 0 R /FitH 468.8]
/Previous 80 0 R
/Next 91 0 R
/First 89 0 R
/Last 90 0 R
/Count 2 
/Title (Links Reconstruction Options)
>>
endobj
89 0 obj
<<
/Parent 88 0 R
/Dest [25 0 R /FitH 454.4]
/Next 90 0 R
/Title (\217hreftmpl=TEMPLATE)
>>
endobj
90 0 obj
<<
/Parent 88 0 R
/Dest [25 0 R /FitH 404]
/Previous 89 0 R
/Title (\217srctmpl=TEMPLATE)
>>
endobj
91 0 obj
<<
/Parent 79 0 R
/Dest [25 0 R /FitH 350]
/Previous 88 0 R
/Next 96 0 R
/First 92 0 R
/Last 95 0 R
/Count 4 
/Title (Splitting Options)
>>
endobj
92 0 obj
<<
/Parent 91 0 R
/Dest [25 0 R /FitH 335.6]
/Next 93 0 R
/Title (-s, \217max-card-size=SIZE)
>>
endobj
93 0 obj
<<
/Parent 91 0 R
/Dest [25 0 R /FitH 273.2]
/Previous 92 0 R
/Next 94 0 R
/Title (-t, \217card-split-threshold=SIZE)
>>
endobj
94 0 obj
<<
/Parent 91 0 R
/Dest [25 0 R /FitH 210.8]
/Previous 93 0 R
/Next 95 0 R
/Title (\217next-card-label=STRING)
>>
endobj
95 0 obj
<<
/Parent 91 0 R
/Dest [25 0 R /FitH 160.4]
/Previous 94 0 R
/Title (\217prev-card-label=STRING)
>>
endobj
96 0 obj
<<
/Parent 79 0 R
/Dest [25 0 R /FitH 106.4]
/Previous 91 0 R
/Next 99 0 R
/First 97 0 R
/Last 98 0 R
/Count 2 
/Title (HTTP Authentication)
>>
endobj
97 0 obj
<<
/Parent 96 0 R
/Dest [25 0 R /FitH 92.0000000000001]
/Next 98 0 R
/Title (-U, \217http-user=USERNAME)
>>
endobj
98 0 obj
<<
/Parent 96 0 R
/Dest [29 0 R /FitH 767.6]
/Previous 97 0 R
/Title (-P, \217http-passwd=PASSWORD)
>>
endobj
99 0 obj
<<
/Parent 79 0 R
/Dest [29 0 R /FitH 725.6]
/Previous 96 0 R
/Next 101 0 R
/First 100 0 R
/Last 100 0 R
/Count 1 
/Title (Proxy Support)
>>
endobj
100 0 obj
<<
/Parent 99 0 R
/Dest [29 0 R /FitH 711.2]
/Title (-[no]Y, \217[no]proxy)
>>
endobj
101 0 obj
<<
/Parent 79 0 R
/Dest [29 0 R /FitH 657.2]
/Previous 99 0 R
/Next 104 0 R
/First 102 0 R
/Last 103 0 R
/Count 2 
/Title (Output Options)
>>
endobj
102 0 obj
<<
/Parent 101 0 R
/Dest [29 0 R /FitH 642.8]
/Next 103 0 R
/Title (-k, \217compile)
>>
endobj
103 0 obj
<<
/Parent 101 0 R
/Dest [29 0 R /FitH 544.4]
/Previous 102 0 R
/Title (-o, \217output)
>>
endobj
104 0 obj
<<
/Parent 79 0 R
/Dest [29 0 R /FitH 490.4]
/Previous 101 0 R
/First 105 0 R
/Last 106 0 R
/Count 2 
/Title (Debugging Options)
>>
endobj
105 0 obj
<<
/Parent 104 0 R
/Dest [29 0 R /FitH 476]
/Next 106 0 R
/Title (-d, \217debug[=LEVEL])
>>
endobj
106 0 obj
<<
/Parent 104 0 R
/Dest [29 0 R /FitH 401.6]
/Previous 105 0 R
/Title (\217xmlcheck)
>>
endobj
107 0 obj
<<
/Parent 75 0 R
/Dest [29 0 R /FitH 362]
/Previous 79 0 R
/Next 111 0 R
/First 108 0 R
/Last 110 0 R
/Count 3 
/Title (DECK SLICING)
>>
endobj
108 0 obj
<<
/Parent 107 0 R
/Dest [29 0 R /FitH 255.2]
/Next 109 0 R
/Title (Slice by cards or by decks)
>>
endobj
109 0 obj
<<
/Parent 107 0 R
/Dest [33 0 R /FitH 644]
/Previous 108 0 R
/Next 110 0 R
/Title (Note on size calculation)
>>
endobj
110 0 obj
<<
/Parent 107 0 R
/Dest [33 0 R /FitH 422]
/Previous 109 0 R
/Title (Why compiling the WML deck?)
>>
endobj
111 0 obj
<<
/Parent 75 0 R
/Dest [33 0 R /FitH 190.4]
/Previous 107 0 R
/Next 126 0 R
/First 112 0 R
/Last 125 0 R
/Count 14 
/Title (ACTIONS)
>>
endobj
112 0 obj
<<
/Parent 111 0 R
/Dest [33 0 R /FitH 119.6]
/Next 113 0 R
/Title (Syntax)
>>
endobj
113 0 obj
<<
/Parent 111 0 R
/Dest [37 0 R /FitH 740]
/Previous 112 0 R
/Next 123 0 R
/First 114 0 R
/Last 122 0 R
/Count 9 
/Title (Available actions)
>>
endobj
114 0 obj
<<
/Parent 113 0 R
/Dest [37 0 R /FitH 701.6]
/Next 115 0 R
/Title (include)
>>
endobj
115 0 obj
<<
/Parent 113 0 R
/Dest [37 0 R /FitH 687.2]
/Previous 114 0 R
/Next 116 0 R
/Title (Description)
>>
endobj
116 0 obj
<<
/Parent 113 0 R
/Dest [37 0 R /FitH 636.8]
/Previous 115 0 R
/Next 117 0 R
/Title (Parameters)
>>
endobj
117 0 obj
<<
/Parent 113 0 R
/Dest [37 0 R /FitH 586.4]
/Previous 116 0 R
/Next 118 0 R
/Title (fsize)
>>
endobj
118 0 obj
<<
/Parent 113 0 R
/Dest [37 0 R /FitH 572]
/Previous 117 0 R
/Next 119 0 R
/Title (Description)
>>
endobj
119 0 obj
<<
/Parent 113 0 R
/Dest [37 0 R /FitH 545.6]
/Previous 118 0 R
/Next 120 0 R
/Title (Parameters)
>>
endobj
120 0 obj
<<
/Parent 113 0 R
/Dest [37 0 R /FitH 507.2]
/Previous 119 0 R
/Next 121 0 R
/Title (Notes)
>>
endobj
121 0 obj
<<
/Parent 113 0 R
/Dest [37 0 R /FitH 468.8]
/Previous 120 0 R
/Next 122 0 R
/Title (skip)
>>
endobj
122 0 obj
<<
/Parent 113 0 R
/Dest [37 0 R /FitH 454.4]
/Previous 121 0 R
/Title (Description)
>>
endobj
123 0 obj
<<
/Parent 111 0 R
/Dest [37 0 R /FitH 412.4]
/Previous 113 0 R
/Next 125 0 R
/First 124 0 R
/Last 124 0 R
/Count 1 
/Title (Generic parameters)
>>
endobj
124 0 obj
<<
/Parent 123 0 R
/Dest [37 0 R /FitH 374]
/Title (for=output format)
>>
endobj
125 0 obj
<<
/Parent 111 0 R
/Dest [37 0 R /FitH 320]
/Previous 123 0 R
/Title (Examples)
>>
endobj
126 0 obj
<<
/Parent 75 0 R
/Dest [37 0 R /FitH 148.4]
/Previous 111 0 R
/Next 137 0 R
/First 127 0 R
/Last 136 0 R
/Count 10 
/Title (LINKS RECONSTRUCTION)
>>
endobj
127 0 obj
<<
/Parent 126 0 R
/Dest [41 0 R /FitH 728]
/Next 130 0 R
/First 128 0 R
/Last 129 0 R
/Count 2 
/Title (Templates)
>>
endobj
128 0 obj
<<
/Parent 127 0 R
/Dest [41 0 R /FitH 713.6]
/Next 129 0 R
/Title (HREF Template)
>>
endobj
129 0 obj
<<
/Parent 127 0 R
/Dest [41 0 R /FitH 663.2]
/Previous 128 0 R
/Title (Image Source Template)
>>
endobj
130 0 obj
<<
/Parent 126 0 R
/Dest [41 0 R /FitH 585.2]
/Previous 127 0 R
/Next 131 0 R
/Title (Syntax)
>>
endobj
131 0 obj
<<
/Parent 126 0 R
/Dest [41 0 R /FitH 447.2]
/Previous 130 0 R
/Next 136 0 R
/First 132 0 R
/Last 135 0 R
/Count 4 
/Title (Available parameters)
>>
endobj
132 0 obj
<<
/Parent 131 0 R
/Dest [41 0 R /FitH 432.8]
/Next 133 0 R
/Title (URL)
>>
endobj
133 0 obj
<<
/Parent 131 0 R
/Dest [41 0 R /FitH 406.4]
/Previous 132 0 R
/Next 134 0 R
/Title (FILENAME)
>>
endobj
134 0 obj
<<
/Parent 131 0 R
/Dest [41 0 R /FitH 380]
/Previous 133 0 R
/Next 135 0 R
/Title (FILEPATH)
>>
endobj
135 0 obj
<<
/Parent 131 0 R
/Dest [41 0 R /FitH 353.6]
/Previous 134 0 R
/Title (FILETYPE)
>>
endobj
136 0 obj
<<
/Parent 126 0 R
/Dest [41 0 R /FitH 191.6]
/Previous 131 0 R
/Title (Examples)
>>
endobj
137 0 obj
<<
/Parent 75 0 R
/Dest [45 0 R /FitH 766.4]
/Previous 126 0 R
/Next 138 0 R
/Title (PROXY SUPPORT)
>>
endobj
138 0 obj
<<
/Parent 75 0 R
/Dest [45 0 R /FitH 542]
/Previous 137 0 R
/Next 139 0 R
/Title (CAVEATS)
>>
endobj
139 0 obj
<<
/Parent 75 0 R
/Dest [45 0 R /FitH 461.6]
/Previous 138 0 R
/Next 167 0 R
/First 140 0 R
/Last 152 0 R
/Count 27 
/Title (LINKS)
>>
endobj
140 0 obj
<<
/Parent 139 0 R
/Dest [45 0 R /FitH 437.6]
/Next 143 0 R
/First 141 0 R
/Last 142 0 R
/Count 2 
/Title (Download)
>>
endobj
141 0 obj
<<
/Parent 140 0 R
/Dest [45 0 R /FitH 423.2]
/Next 142 0 R
/Title (Html2Wml)
>>
endobj
142 0 obj
<<
/Parent 140 0 R
/Dest [45 0 R /FitH 372.8]
/Previous 141 0 R
/Title (Nutialand)
>>
endobj
143 0 obj
<<
/Parent 139 0 R
/Dest [45 0 R /FitH 306.8]
/Previous 140 0 R
/Next 148 0 R
/First 144 0 R
/Last 147 0 R
/Count 4 
/Title (Resources)
>>
endobj
144 0 obj
<<
/Parent 143 0 R
/Dest [45 0 R /FitH 292.4]
/Next 145 0 R
/Title (The WAP Forum)
>>
endobj
145 0 obj
<<
/Parent 143 0 R
/Dest [45 0 R /FitH 230]
/Previous 144 0 R
/Next 146 0 R
/Title (WAP.com)
>>
endobj
146 0 obj
<<
/Parent 143 0 R
/Dest [45 0 R /FitH 179.6]
/Previous 145 0 R
/Next 147 0 R
/Title (The World Wide Web Consortium)
>>
endobj
147 0 obj
<<
/Parent 143 0 R
/Dest [45 0 R /FitH 105.2]
/Previous 146 0 R
/Title (TuxMobil)
>>
endobj
148 0 obj
<<
/Parent 139 0 R
/Dest [49 0 R /FitH 740]
/Previous 143 0 R
/Next 152 0 R
/First 149 0 R
/Last 151 0 R
/Count 3 
/Title (Programmers utilities)
>>
endobj
149 0 obj
<<
/Parent 148 0 R
/Dest [49 0 R /FitH 725.6]
/Next 150 0 R
/Title (HTML Tidy)
>>
endobj
150 0 obj
<<
/Parent 148 0 R
/Dest [49 0 R /FitH 663.2]
/Previous 149 0 R
/Next 151 0 R
/Title (Kannel)
>>
endobj
151 0 obj
<<
/Parent 148 0 R
/Dest [49 0 R /FitH 600.8]
/Previous 150 0 R
/Title (WML Tools)
>>
endobj
152 0 obj
<<
/Parent 139 0 R
/Dest [49 0 R /FitH 534.8]
/Previous 148 0 R
/First 153 0 R
/Last 166 0 R
/Count 14 
/Title (WML browsers and Wap emulators)
>>
endobj
153 0 obj
<<
/Parent 152 0 R
/Dest [49 0 R /FitH 520.4]
/Next 154 0 R
/Title (Opera)
>>
endobj
154 0 obj
<<
/Parent 152 0 R
/Dest [49 0 R /FitH 470]
/Previous 153 0 R
/Next 155 0 R
/Title (wApua)
>>
endobj
155 0 obj
<<
/Parent 152 0 R
/Dest [49 0 R /FitH 407.6]
/Previous 154 0 R
/Next 156 0 R
/Title (Tofoa)
>>
endobj
156 0 obj
<<
/Parent 152 0 R
/Dest [49 0 R /FitH 345.2]
/Previous 155 0 R
/Next 157 0 R
/Title (EzWAP)
>>
endobj
157 0 obj
<<
/Parent 152 0 R
/Dest [49 0 R /FitH 270.8]
/Previous 156 0 R
/Next 158 0 R
/Title (Deck-It)
>>
endobj
158 0 obj
<<
/Parent 152 0 R
/Dest [49 0 R /FitH 196.4]
/Previous 157 0 R
/Next 159 0 R
/Title (Klondike WAP Browser)
>>
endobj
159 0 obj
<<
/Parent 152 0 R
/Dest [49 0 R /FitH 146]
/Previous 158 0 R
/Next 160 0 R
/Title (WinWAP)
>>
endobj
160 0 obj
<<
/Parent 152 0 R
/Dest [49 0 R /FitH 95.6000000000002]
/Previous 159 0 R
/Next 161 0 R
/Title (WAPman)
>>
endobj
161 0 obj
<<
/Parent 152 0 R
/Dest [53 0 R /FitH 743.6]
/Previous 160 0 R
/Next 162 0 R
/Title (Wireless Companion)
>>
endobj
162 0 obj
<<
/Parent 152 0 R
/Dest [53 0 R /FitH 693.2]
/Previous 161 0 R
/Next 163 0 R
/Title (Mobilizer)
>>
endobj
163 0 obj
<<
/Parent 152 0 R
/Dest [53 0 R /FitH 642.8]
/Previous 162 0 R
/Next 164 0 R
/Title (QWmlBrowser)
>>
endobj
164 0 obj
<<
/Parent 152 0 R
/Dest [53 0 R /FitH 580.4]
/Previous 163 0 R
/Next 165 0 R
/Title (Wapsody)
>>
endobj
165 0 obj
<<
/Parent 152 0 R
/Dest [53 0 R /FitH 506]
/Previous 164 0 R
/Next 166 0 R
/Title (WAPreview)
>>
endobj
166 0 obj
<<
/Parent 152 0 R
/Dest [53 0 R /FitH 443.6]
/Previous 165 0 R
/Title (PicoWap)
>>
endobj
167 0 obj
<<
/Parent 75 0 R
/Dest [53 0 R /FitH 392]
/Previous 139 0 R
/Next 168 0 R
/Title (ACKNOWLEDGEMENTS)
>>
endobj
168 0 obj
<<
/Parent 75 0 R
/Dest [53 0 R /FitH 323.6]
/Previous 167 0 R
/Next 169 0 R
/Title (AUTHOR)
>>
endobj
169 0 obj
<<
/Parent 75 0 R
/Dest [53 0 R /FitH 279.2]
/Previous 168 0 R
/Title (COPYRIGHT)
>>
endobj
74 0 obj
<<
/Type /Outlines
/Count 95
/First 75 0 R
/Last 169 0 R
>>
endobj
3 0 obj
<<
/Type /Catalog
/Pages 4 0 R
/PageMode /UseOutlines
/Outlines 74 0 R
>>
endobj
4 0 obj
<<
/Type /Pages
/Kids [ 66 0 R 73 0 R 61 0 R 65 0 R 21 0 R 25 0 R 29 0 R 33 0 R 37 0 R 41 0 R 45 0 R 49 0 R 53 0 R 57 0 R ]
/Count 14
/MediaBox [0 0 595 842]
>>
endobj
xref
0 170
0000000000 65535 f 
0000000015 00000 n 
0000000171 00000 n 
0000078192 00000 n 
0000078281 00000 n 
0000000268 00000 n 
0000002368 00000 n 
0000002467 00000 n 
0000002565 00000 n 
0000002665 00000 n 
0000002769 00000 n 
0000002865 00000 n 
0000002966 00000 n 
0000003070 00000 n 
0000003178 00000 n 
0000003276 00000 n 
0000003379 00000 n 
0000003485 00000 n 
0000003599 00000 n 
0000009669 00000 n 
0000009690 00000 n 
0000009860 00000 n 
0000009943 00000 n 
0000016090 00000 n 
0000016111 00000 n 
0000016282 00000 n 
0000016365 00000 n 
0000021784 00000 n 
0000021805 00000 n 
0000021976 00000 n 
0000022059 00000 n 
0000028334 00000 n 
0000028355 00000 n 
0000028491 00000 n 
0000028574 00000 n 
0000033836 00000 n 
0000033857 00000 n 
0000034006 00000 n 
0000034089 00000 n 
0000040014 00000 n 
0000040035 00000 n 
0000040205 00000 n 
0000040288 00000 n 
0000045358 00000 n 
0000045379 00000 n 
0000045516 00000 n 
0000045599 00000 n 
0000050021 00000 n 
0000050042 00000 n 
0000050167 00000 n 
0000050250 00000 n 
0000053833 00000 n 
0000053854 00000 n 
0000053979 00000 n 
0000054062 00000 n 
0000054351 00000 n 
0000054371 00000 n 
0000054473 00000 n 
0000054556 00000 n 
0000060600 00000 n 
0000060621 00000 n 
0000060735 00000 n 
0000060818 00000 n 
0000065282 00000 n 
0000065303 00000 n 
0000065417 00000 n 
0000065500 00000 n 
0000065583 00000 n 
0000065928 00000 n 
0000065948 00000 n 
0000066073 00000 n 
0000066371 00000 n 
0000066391 00000 n 
0000066493 00000 n 
0000078116 00000 n 
0000066576 00000 n 
0000066699 00000 n 
0000066790 00000 n 
0000066900 00000 n 
0000067015 00000 n 
0000067166 00000 n 
0000067308 00000 n 
0000067406 00000 n 
0000067526 00000 n 
0000067647 00000 n 
0000067782 00000 n 
0000067903 00000 n 
0000068032 00000 n 
0000068136 00000 n 
0000068305 00000 n 
0000068413 00000 n 
0000068522 00000 n 
0000068678 00000 n 
0000068791 00000 n 
0000068928 00000 n 
0000069058 00000 n 
0000069175 00000 n 
0000069335 00000 n 
0000069459 00000 n 
0000069578 00000 n 
0000069735 00000 n 
0000069831 00000 n 
0000069990 00000 n 
0000070095 00000 n 
0000070203 00000 n 
0000070352 00000 n 
0000070461 00000 n 
0000070567 00000 n 
0000070722 00000 n 
0000070838 00000 n 
0000070968 00000 n 
0000071087 00000 n 
0000071241 00000 n 
0000071337 00000 n 
0000071499 00000 n 
0000071596 00000 n 
0000071715 00000 n 
0000071833 00000 n 
0000071946 00000 n 
0000072063 00000 n 
0000072181 00000 n 
0000072294 00000 n 
0000072406 00000 n 
0000072511 00000 n 
0000072676 00000 n 
0000072767 00000 n 
0000072867 00000 n 
0000073034 00000 n 
0000073170 00000 n 
0000073273 00000 n 
0000073388 00000 n 
0000073502 00000 n 
0000073669 00000 n 
0000073762 00000 n 
0000073878 00000 n 
0000073992 00000 n 
0000074094 00000 n 
0000074196 00000 n 
0000074316 00000 n 
0000074428 00000 n 
0000074580 00000 n 
0000074717 00000 n 
0000074815 00000 n 
0000074918 00000 n 
0000075074 00000 n 
0000075177 00000 n 
0000075290 00000 n 
0000075427 00000 n 
0000075529 00000 n 
0000075695 00000 n 
0000075794 00000 n 
0000075908 00000 n 
0000076011 00000 n 
0000076175 00000 n 
0000076270 00000 n 
0000076381 00000 n 
0000076494 00000 n 
0000076607 00000 n 
0000076722 00000 n 
0000076850 00000 n 
0000076962 00000 n 
0000077087 00000 n 
0000077213 00000 n 
0000077330 00000 n 
0000077449 00000 n 
0000077564 00000 n 
0000077679 00000 n 
0000077780 00000 n 
0000077901 00000 n 
0000078014 00000 n 
trailer
<<
/Size 170
/Root 3 0 R
/Info 2 0 R
>>
startxref
78457
%%EOF
html2wml-0.4.11/doc/readme.pod010064400007650000024000000561420774677237200157670ustar00maddinguestaff=head1 NAME

Html2Wml -- Program that can convert HTML pages to WML pages

=head1 SYNOPSIS

Html2Wml can be used as either a shell command: 

  $ html2wml file.html

or as a CGI: 

  /cgi-bin/html2wml.cgi?url=/index.html

In both cases, the file can be either a local file or a URL. 



=head1 DESCRIPTION

Html2Wml converts HTML pages to WML decks, suitable for being viewed on a
Wap device. The program can be launched from a shell to statically convert 
a set of pages, or as a CGI to convert a particular (potentially dynamic) 
HTML resource. 

Althought the result is not guarantied to be valid WML, it should be the 
case for most pages. Good HTML pages will most probably produce valid 
WML decks. To check and correct your pages, you can use W3C's softwares: 
the I, available online at http://validator.w3.org 
and I, written by Dave Raggett. 

Html2Wml provides the following features: 

=over 4

=item *

translation of the links

=item *

limitation of the cards size by splitting the result into several cards

=item *

inclusion of files (similar to the SSI)

=item *

compilation of the result (using the WML Tools, see L<"LINKS">)

=item *


a debug mode to check the result using validation functions

=back



=head1 OPTIONS

Please note that most of these options are also available when calling 
Html2Wml as a CGI. In this case, boolean options are given the value 
"1" or "0", and other options simply receive the value they 
expect. For example, C<--ascii> becomes C or C. See the 
file F for an example on how to call Html2Wml as a CGI. 


=head2 Conversion Options

=over 4

=item -a, --ascii

When this option is on, named HTML entities and non-ASCII characters are 
converted to US-ASCII characters using the same 7 bit approximations as 
Lynx. For example, C<©> is translated to "(c)", and C<ß> is 
translated to "ss". This option is off by default.  


=item --[no]collapse

This option tells Html2Wml to collapse redundant whitespaces,
tabulations, carriage returns, lines feeds and empty paragraphs. The aim
is to reduce the size of the WML document as much as possible. Collapsing
empty paragraphs is necessary for two reasons. First, this avoids empty
screens (and on a device with only 4 lines of display, an empty screen can 
be quite ennoying). Second, Html2wml creates many empty paragraphs when
converting, because of the way the syntax reconstructor is programmed.
Deleting these empty paragraphs is necessary like cleaning the kitchen :-)

If this really bother you, you can desactivate this behaviour with the
B<--nocollapse> option. 


=item --ignore-images

This option tells Html2Wml to completly ignore all image links. 


=item --[no]img-alt-text

This option tells Html2Wml to replace the image tags with their 
corresponding alternative text (as with a text mode web browser). 
This option is on by default. 


=item --[no]linearize

This option is on by default. This makes Html2Wml flattens the HTML
tables (they are linearized), as Lynx does. I think this is better than
trying to use the native WML tables. First, they have extremely limited
features and possibilities compared to HTML tables. In particular, they
can't be nested. In fact this is normal because Wap devices are not
supposed to have a big CPU running at some zillions-hertz, and the
calculations needed to render the tables are the most complicated and
CPU-hogger part of HTML. 

Second, as they can't be nested, and as typical HTML pages heavily use 
imbricated tables to create their layout, it's impossible to decide which 
one could be kept. So the best thing is to keep none of them. 

B<[Note]> Although you can desactivate this behaviour, and although 
there is internal support for tables, the unlinearized mode has not 
been heavily tested with nested tables, and it may produce unexpected 
results. 


=item -n, --numeric-non-ascii

This option tells Html2wml to convert all non-ASCII characters to 
numeric entities, i.e., "E" becomes C<é>, and "E" 
becomes C<ß>.  By default, this option is off. 


=item -p, --nopre

This options tells Html2Wml not to use the EpreE
tag. This option was added because the compiler from WML Tools 0.0.4 
doesn't support this tag. 

=back


=head2 Links Reconstruction Options

=over 4

=item --hreftmpl=I