***************************************** * `HTMLess' v1.3 * * An OriginalWare release by * * Troglobyte/Darkness * ***************************************** $VER:HTMLess.doc v1.3 16.April.96 Troglobyte/Darkness Warning! : from next version, HTMLess will be uploaded in "aminet/text/HYPER" Contents ======== 1. Introduction 2. History 3. Bugs 4. OriginalWare? 5. Also available... 6. Thanks to... 7. Credits 1. Introduction =============== HTMLess is just another utility to extract the text inside HTML files (Web pages) and convert it to a readable text format.The main features are: - Fast, written 100% in assembler. (Even faster since v1.2, and the fastest with the new in v1.3 CLI option -w) - Small but powerful utility (only 10000 bytes long). - CLI and Workbench usage. - Admit filenames as CLI parameters (can be launched from a DiskMaster/DirOpus type program to autoconvert HTML's). - Output text could be formatted to easy reading. - Can keep [href's] (like WWW adresses) in the output text. - .HTML or .HTM filename suffix will be changed to .Text or .txt - The program will report any kind of errors. - Very easy to use...just try it. - Great results (complex AI routines used *8). - All non-ASCII chars are converted. - HTML Lists converted to text lists. - `HTMLess' is a wonderful name. - It's OriginalWare (OriginalWhat?) and it's only Amiga (Yeah!). - No annoying requesters when starting/using/quitting program. Workbench usage: Just launch the program and use the file requester to select the HTML file to load and to choose the name to save the text file. (Since v1.1 this `complex' option works *8) [New since v1.2] The program will ask for another filename after saving the converted file, when you don't have more HTML files to convert, Cancel or Close the file requester to exit. CLI usage : `HTMLess [-Cxxxx] [-H] [-W] [-P] [filename/path]' Write just the options or the options and the path or filename (if not filename is given or if there is any kind of problem a file requester will be used with your defined path). Options must be ahead of the file name and must be after a "-" char. Options can be together or alone (-c20h or -c -h20) and written in capital or small letters (-HC5, -hc5 or -hC5) The available options are: -h : if used "href's" will be removed.By default "href's" are included in the output text betwen "[...]" chars. -cXXXX : XXXX are 1 to 4 numbers (-c10,-c200,-c0080) to select the size of the columns of the formated text (default size is 80 columns). If the number is zero, text won't be formatted (-c0,-c0000) [New since v1.2] ?, -? or -help : give CLI USAGE: info. [New since v1.3] -w : when used HTMLess window won't be opened.And the conversion will be really faster; try it.Errors will be reported to the CLI window, if it's opened. -p : you can define the path to your favourite HTML directory Used without [path] is useless. Examples: 1. HTMLess -hc80 File1.html Results : A text file "File1.text" without [href's] and formated to 80 columns will be saved. 2. HTMLess -h -c0040 File2.htm Results : A text file "File2.txt" without [href's] and formated to 40 columns will be saved. 3. HTMLess -c0 File3.txt Results : A text file with the same name "File3.txt" with [href's] and unformated text will be saved. 4. HTMLess -p RAM:Temp/HTML (RAM:Temp/HTML is a path, not a file) Results : File requester with the files in the directory: `RAM:Temp/HTML/...' Common errors : 1. Options must be after a "-" char always. BAD: HTMLess -h c80 File1.html OK : HTMLess -hc80 File1.html or HTMLess -h -c80 File1.html 2. Options must be ahead of the filename. BAD: HTMLess File1.htm -c20h OK : HTMLess -c20h File1.htm The only requirement is the "ReqTools.library" by Nico Francois and by Magnus Holmgren who fortunately is continuing the development of the indispensable reqtools library. If you need a custom version of this program (for a personal necessity); contact me and I will try to make a customized version for you (if it isn't to difficult or too much work). If you think the sources (100% assembler) could be useful for you (to include in a program you are developing or for learning purposes) just contact me and ask for them. 2. History ========== Version 1.0 ( 1.April.1996) : - First official release. Version 1.1 ( 5.April.1996) : - Fixed Workbench icon bug (Sorry about that stupid icon type error). - All non-ASCII chars are supported now. (Not really, try v1.2) - Improved conversion of HTML Lists (now are more readable). - Some extra Line Feeds are removed (but not all, to make readable a lot of not-very-standard HTML Web pages) - A rarely Guru bug with small files fixed. - Last char of the text isn't deleted now. Version 1.2 (12.April.1996) : - Even more speed: a lot faster when Fast memory is available. (Test it) - You can convert several files without reloading HTMLess. (Otto von Ruggins) - ">" by "}", and "<" by "{" bug removed. (Markus Krajewski) - CLI Usage info. (Alfredo Soro) - All non-ASCII chars are supported now (I said the same in v1.1 *8) - Some rare and little system-unfriendly bugs removed. - Improved conversion for some HTML commands (

,
y ) - Spaces removed at the end of lines. - More helpful people included in this doc (Look: 6.Thanks to... *8) Version 1.3 (16.April.1996) : - New CLI option. -w : no window will be opened and the conversion is FASTER. - New CLI option. -p : will permit define your own path as default dir. - Problem with YAK commodity detected, but not fixed yet. (John Turgoose) - Even more helpful people included in this doc (Look: 6.Thanks to... *8) ToDo List: - Fix the strange BUG listed in `3. Bugs'. - Fix all the bugs that will be discovered by users (Don't try so hard *8) - Display improved formated Lists. - More CLI options and ToolTypes support. - Option to convert bold and italic tags as ANSI. - Option to convert HTML to RTF text (useful for a future use in a word processor) 3. Bugs ======= [New since v1.3] There is an unknown bug in some Amigas, looks like there is a compatibility problem with the YAK commodity (thanks to John Turgoose for this info).So try to unload/stop/turn off YAK when using HTMLess. The problem is a warning Guru (yellow) each time you run HTMLess, after that you can close the HTMLess window.Since v1.3 I included a new CLI option (-w), when used HTMLess don't open his own window, but will report errors to the CLI window, if it's open.As an added bonus with this option turned on the conversion is a lot faster. There isn't anymore KNOWN bugs at the moment in all the Amigas tested but... If you find any bug or problem, contact me at the previous address.Please, send me a detailed report of the problem and of your Amiga computer if possible; thanks. If you found the problem with a particular file, send me too a copy of the file. Don't forget to tell me the current version of my program you are using. 4. OriginalWare ? ================= This utility is OriginalWare.That means if you like this program you must buy an original Amiga program or game, or send the money to the author of any ShareWare program or game you are using often. (This includes me, $5 or $10 will be welcome *8) There are lots of great Amiga software like `DiskMaster', `Remind', `MultiCX', `Spot', `ReqTools.library', `Deluxe Galaga', `APlayer' and a lot more that you won't never regret to spend your money. If you do this you support the Amiga, and if you support AMIGA you support US. Support software authors and you will get more and better software. This program could be included in any PD compilation at a symbolic price. This program could be freely included in any Web page or FTP site, but send me an EMail to know it.(I can include the address in this doc) Aminet and Fred Fish collections are specifically allowed to include it. To Magazines : You can give away this utility on your coverdisk, but please send me a copy of the magazine. 5. Also available... ==================== Others quality Amiga PD products available from me : Aminet recent uploads : HTMLess.lha v1.3 text/misc 10K v1.3. Converts HTML files in text files. Warning! : from next version, HTMLess will be uploaded in "text/HYPER" DarkSound.lha v2.2 util/boot 53K Changes Workbench Sounds at each boot. MagiCA64.lha v1.1 misc/emu 6K Converts A64/64 files to MagiC64 format. Progress.lha v1.0 demo/intro 73K In Progress/Darkness.1st at Euskal Party Vector13.lha v1.3 dev/misc 15K Draw and edit 2D vectors for demos/games TheRace5.lha v1.5 game/2play 59K Great 100m Running game, 0-4 players. Available soon: ELF.lha v1.0 text/misc Erase Line Feeds.Use for Word Procesors. FormaText.lha v1.0 text/misc Format texts to your chosen columns size All them are 100% written in pure assembler for speed and are very system friendly in all types of Amiga computers (or that is what I hope *8). 6. Thanks to... =============== Alfredo Soro for the first ßeta testing. Otto Von Ruggins for the first bug report and some tests. Philippe Duchenne for reporting some bugs and interesting ideas. Markus Krajewski for some bugs and nice ideas. Geoff Milnes for another bug report. John Turgoose for the problem with the YAK commodity. Jerome Chesnot for EMail support (even "TheRace" support) David Cassidy for don't forget me *8) . Hipnooxis for ALL the help and show me to use and respect the Amiga O.S. Knackosoft/TRSI for being my best `invisible' friend. To the `Atletico de Madrid', the best football team in Spain. To all the Amiga developers for all the new, fun and useful stuff. To all the Amiga users worldwide for their trust in the Amiga. To Amiga Technologies for continue the development of the Amiga. To the Amiga... 7. Credits ========== All code © 1996 by Troglobyte/Darkness. Send money ($), JOB offers, BUGS, comments, improvements, ideas, advices, suggestions, mags, complains, and nice PD stuff (like Demos, Games or Utilities). M. Martin Vivaldi Av. America 60 Madrid 28028 SPAIN Or NetMail me at : Internet : bitabit@servicom.es (Faster and safer) FidoNet : 2:341/28.55 Manuel Martin AmigaNet : 39:192/1.29 Manuel Martin Remember: Only Amiga make it possible... Only Amiga make it fun.