INTRODUCTION ============ AmigaGuide Windows Viewer (AGWViewer) (Freeware) A tool that will display and convert any AmigaGuide .guide file and let you browse around just as the original AmigaGuide viewer for Amiga machines. But, naturally, it features more than the original, such as powerful search, automated index generator, conversion to HTML/TXT/PDF, fixes/workarounds for cranky .guide files, PowerPacker (PP20) and XPK decompressing on the fly! Works on any Windows Operating System (Win95/98 will only convert, since internal html browser engine is not supported). Outputs are: HTML, TXT or PDF (via printing text file) THINGS TO KNOW ============== Tested and works fine with WinME/Win2000/2003/XP/Vista/Win7 Limited functionality in Win95/98, but converts and exports to .HTML and TXT including Powerpacker support. Require WinUAE v2.3.1 (or lower, not tested) for decompressing XPK compressed guides, works transparently, just config path and rom file. Will ignore (hopefully) V40 tags and convert it to V39 look. CONTACT ======= post@stone-oakvalley-studios.com http://www.stone-oakvalley-studios.com/0004_00_dashboard_index.php HISTORY ======= v1.39 - 20 July 2019 - Fixed support or "ALink" query. Its basically "new window" for "Link". Discovered in "EP_Main.Guide" (EaglePlayer). Now converted properly into clickable button. - Added support for "@REM " and "@REMARK ", which are just ignored and never displayed (just like AmigaGuide on Amiga does). Reported by user v1.38 - 24 November 2018 - Seems like my previous fixes made havoc for already working guides :-(, but inserted some tricks to make sure at least more would work as well as those pesky "sc.guide" and "cpr.guide" from Lattice C works pretty much ok - Fixed a bug which concerns endless looping. - Rewrote the detection of actual LINK @ nodes and buttons, seems to be more stable - I believe the preservation of TABS was messed up, at least now TAB is converted to 4   to act as TAB for html output v1.37 - 19 July 2018 - Improved reading of guide files, as for example "sc.guide" and "cpr.guide" from Lattice C on Amiga caused AGWV to hang forever. Works now. - Compiled with latest PB5.62 just to make sure v1.36 - 16 Apr 2017 - Made search hits more "loose" to find more hits. Probably some inversion on the "Exact" flag was messed up too. - Fixed a bug where the INI flag "Show WinUAE window?" was not properly saved! - Compiled with the latest PureBasic compiler (5.60) and adjusted some code to be compatible v1.35 - 22 Apr 2016 / 05 May 2016 - Fixed output bug if text contained word "link", would always appear uppercase, now fixed AGAIN (better detection for @ tag start and isolation). It should have been detected in v1.33 or v1.34, but now reported by user, so hopefully fixed now. - Added Drag'n'Drop a AmigaGuide file into the AGWviewer window. - Fixed a bug where any character that appeared just after "}" endtag, it would actually be ignored and not exported. Fixed now. All bugs above reported observant and helpful user of AGWViewer. Thanks so much for helping me out. v1.34 - 12 Jul 2015 - Fixed output bug if text contained word "link", would always appear uppercase, now fixed (better detection for @LINK). - Minor tweak to better display title in HTML field (</title), sometimes ended up as @node keyword name, or blank. Both issues reported by user. - Additional minor tweaks here and there regarding detection and uppercase/lowercase throughout the entire code. - Removed duplicated errors (if found) from listview. v1.33 - 11 Dec 2014 - Removed output of "@REM LINK" that is probably just a REMark comment. No need to see this in the output. - Added support for Links that refers to line numbers (solution was to use #xx anchors in html) - Reported by user. v1.32 - 07 Dec 2014. - Added checkbox for storing converted .guide to .HTML output in program dir (as before) or now into Windows Temporary Directory. If stored in Temp directory, everything converted will be deleted during program exit. The option is now available in "Configure AGWViewer / WinUAE for XPK Unpacking..." menu. Note: Due to this option needed at program start, a default AGWViewer.ini is included in the setup package. - Small minifix in code regarding http:// links - Updated this readme by removing some old rant and bs. v1.31 - 02 Dec 2014. - Fixed a forced lowercase wrong case during http: and ftp: links detection. Fixed now. Reported by user. - Added missing guide.css definitions style sheet to search results file too (goes into temp dir). - Removed some garble code and fixed broken and messed up autogeneration "guide_index.html". v1.3 - 27 Nov 2014. - Hard to believe, years pass by quickly. Been busy with other projects (namely SOTDS Project), getting married, having a babygirl (now 2 years old) + fixing the house and 1000 of other things. - Fixed bug for \@ and \\ to come out as @ and \ instead. Ref: http://eab.abime.net/showthread.php?t=58754 - Increased some error buffers, probably causing some guide to crash AGWViewer. - Found buggy code related to probably changes in Windows API GUI, cause v1.2 to crash everytime. Fixed now. - Fixed (probably) some garbled output if FTP:// and HTTP:// was detected. Unknown, but might work. - Removed some old now unsupported code due to updated PureBasic Compiler, now compiled with PB5.31 - Due to new compiler, I have no time to test if AGWV does the job as it did back in 2011. - Remove forced static CSS code from my code, and exported now into "guide.css", tweak as you like. - Due to new "guide.css", this file will be copied into "_HTML" directory naturally, where all .HTML files will link to that one instead. - Tested on Win7 64bit, IE11, Firefox 33.1.1 v1.2 - 10 Jan 2011. - Added a filter for guides where space was replaced by TAB instead. Most likely due to manual/hand edited guides. Now it will show buttons as intended again. Reported by user. - Changed "Show Warnings" button to "Show Warnings (on/off)" to make it clear it is a toggle button functionality. Click once= show window, click once more=hide window. v1.1 - 15 June 2011. - Added more support for V40 AmigaGuide tags (ergo, will just ignore, fallback mode to v39 look) - Increased the error command storage from 10000 to 20000 errors, so that certain V40 will probably load, but will be filled with debug information to detect possible removal filters for an update to the next AGWViewer version - Added a link to this document on the menu. v1.0 - 23 April 2011. - Replaced xpkGZIP.library so unpacking seems to work good now, v0.99 would be stuck in a crazy endless crazy loop generating bad filenames. No danger. - Small redesign of top button strip so all of them show on a 800x600 resolution too. - Added some support for V40 AmigaGuide tags (ergo, will just ignore, fallback mode to v39 look) v0.99beta - April 2011: - Even more filtering and bugtesting performed, several hours of detailed surveilance - Added History window to menu - Added Automatic INDEX creator of all buttons (overrides any embedded INDEX the original author did, seldom never did, and mine's more trustable and complete!) - Added XPK unpacking support via transparent loading of .adf image into a known winuae config that the user gives us, then loads up the winuae! - Beta Release Version! v0.98 - February 2011: - Added Powerpacker unpacking support, works fully transparent - Added title support on viewer window, follows the @TITLE tag or create own automatically! - Squeezed a lot of scanning bugs and workarounds for cranky written .guides = a debug mess insanity for days v0.97 - February 2011: - Added search And browse functions v0.96 - February 2011: - Added more scanning functions To remove bad chars, bad output, bad amigaguide files etc. v0.90 November 2010: - Finally a useable internal working version at a beta stage at least.