--- Snap2HTML -----------------------------------------------------------
 
  Freeware by RL Vision (http://www.rlvision.com)
  
  "Portable" (but requires .Net Framework 2.0)
 
 
 --- About ---------------------------------------------------------------
 
  This application takes a snapshot of the folder structure on your
  harddrive and saves it as an HTML file. What's unique about Snap2HTML is
  that the HTML file uses modern techniques to make it feel like a "real"
  application, displaying a "treeview with folders that you can click to 
  view the files contained within. There is also a built in file search.
  Still, everything is contained in a single HTML file that you can easily
  store or distribute.
  
  Exported file listings can be used in many ways. One is as a complement
  to your backups (note however that this program does not backup your
  files! It only creates a list of the files and directories). You can
  also keep a file list on your "other" computer in case you need to look
  something up, or save for historic reasons and documentation. When
  helping your friends with their computer problems you can ask them to
  send a snapshop of their folders so you can better understand their
  problem. It's really up to you to decide what it can be used for!


--- Linking Files --------------------------------------------------------

  Linking allows you open the listed files directly in your web browser. 
  This is designed to be flexible, which also sometimes makes it tricky
  to get right. Here are some examples that shows how to use it:

	-> Link to fully qualified local path
		Root folder:	"c:\my_root\"
		Link to:		"c:\my_root\"
		Save snapshot:	[anywhere locally]

	-> Link to relative local path
		Root folder:	"c:\my_root\"
		Link to:		"my_root\"
		Save snapshot:	"c:\snapshot.html"

	-> Link to same folder as snapshot is saved in
		Root folder:	"c:\my_root\"
		Link to:		[leave textbox empty]
		Save snapshot:	"c:\my_root\snapshot.html"

	-> Link to a web server with mirror of local folder
		Root folder:	"c:\my_www_root\"
		Link to:		"http://www.mywebserver.com"
		Save snapshot:	[anywhere]

	-> Link to a relative path on a web server with mirror of local folder
		Root folder:	"c:\my_www_root\subfolder"
		Link to:		"subfolder/"
		Save snapshot:	"http://www.mywebserver.com/snapshot.html"


  Note:
  
    Different browsers handle local links in different ways, probably for 
    security reasons. For example, Internet Explorer will not let you open
    links to files on your local machine at all. (You can however copy the
    link and paste into the location field.)


--- Command Line ---------------------------------------------------------

  You can automate Snap2HTML by starting it with command line options:

  Simple:   Snap2HTMl.exe "c:\path\to\root\folder"
    
              Starts the program with the given root path already set


  Full:     Snap2HTMl.exe [-path:"root folder path"] [-outfile:"filename"] [-link:"link to path"] [-hidden] [-system]

              -path:"root folder path"   - The root path to load.
                                           Example: -path:"c:\temp"
                                         
              -outfile:"filename"        - The filename to save the snapshot as.
                                           Don't forget the html extension!
                                           Example: -outfile:"c:\temp\out.html"

              -link:"link to path"       - The path to link files to.
                                           Example: -link:"c:\temp"
                                         
              -hidden                    - Include hidden items
            
              -system                    - Include system items

  Notes:    Using -path and -outfile will cause the program to automatically
            start generating the snapshot, and quit when done!

            Always surround paths and filenames with "quotes"!


--- Template Design ------------------------------------------------------

  If you are good at web design, you may want to have a look at the file
  "template.html" in the application folder. This is the base for the
  output, and you can modify it with your own enhancements, or why not
  change the design all together! If you make something nice you are 
  welcome, to send it to me and I might distribute it with future versions
  of the program.


--- Version History ------------------------------------------------------

  v1.0 (2011-07-25)
	Initial release

  v1.1 (2011-08-11)
	Added tooltips when hovering folders
	Bugfixes

  v1.2 (2011-08-18)
	Fixed some folder sorting problems
	Better error handling when permissions do not allow reading

  v1.5 (2012-06-18)
	Added command line support
	Files can now be linked to a target of your choice
	Option to automatically open snapshots when generated
	Several bugfixes and tweaks

  v1.51 (2012-07-11)
	Improved error handling