--- Snap2HTML ----------------------------------------------------------------
 
  Freeware by RL Vision (c) 2011-2017
  Homepage: http://www.rlvision.com
  
  Portable:
    - Just unzip and run
    - Settings are saved in the application folder

  Free Open Source Software:
    - Source code available at GitHub: https://github.com/rlv-dan
  

 --- 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 navigate to 
  view the files contained within. There is also a built in file search and
  ability to export data as plain text, csv or json. 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 of e.g. external HDDs and other computers, in case 
  you need to look something up or to save for historic reasons and 
  documentation. When helping your friends with their computer problems 
  you can ask them to send a snapshot of their folders so you can better 
  understand their problem. It's really up to you to decide what Snap2HTML 
  can be used for!


 --- Search -------------------------------------------------------------------

  The built in search box accepts the following modifiers:
  
    Wildcards * and ? can be used. * matches zero or more characters. ? matches
    exactly one character.
  
    Prefix your search with > to search only the current folder. >> searches 
    the current folder and its sub folders.
 
  Tip: Search for * to list all files. This is especially useful together with 
  the export functionality to get all data out of the html file.


 --- 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\"
		Use snapshot from:	[anywhere locally]

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

	-> Link to same folder as snapshot is saved in
		Root folder:		"c:\my_root\"
		Link to:			[leave textbox empty]
		Use snapshot from:	"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.example.com/"
		Use snapshot from:	[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/"
		Use snapshot from:	"http://www.example.com/snapshot.html"

  Notes:
    
	Only files can be linked. Folders are automatically linked to browse the
	path in the snapshot.

    Different browsers handle local links in different ways, usually 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 from the command line with the 
  following 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"] [-title:"page title"] 
						  [-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"
                                         
              -title:"page title"        - Set the page title
			  
			  -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 ("")!
            
            Do not include the [sqaure brackets] when you write your command 
            line. (Sqaure brackets signify optional command line parameters)


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

  If you know html and javascript 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 and design changes. 
  If you make something nice you are welcome, to send it to me and I might 
  distribute it with future versions of the program!


  --- Known Problems ----------------------------------------------------------

  The finished HTML file contains embedded javascript. Web browsers (especially 
  Internet Explorer) may limit execution of scripts as a security measure. 
  If the page is stuck on "loading..." (with no cpu activity - large files may 
  take a while to load) this is probably your problem.

  One user reported needing to start Snap2HTML with "Run as Administrator"
  on Win7 Basic, otherwise it would hang when clicking on the browse for 
  folders button.

  Internet Explorer may fail to load very large files. The problems seems 
  to be a hard limit in some versions of IE. I have seen this problem in 
  IE11 myself. Being a hard limit there is no easy solution right now.

  Large file tables can be slow to render and appear to have hung the 
  browser, especially in Internet Explorer. The same can happen when 
  navigating away from such a large folder and freeing the memory.

 
  --- 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

  v1.9 (2013-07-24)
    Major overhaul of HTML template
    MUCH faster HTML loading
	Reduced HTML size by about 1/3
	Folders are now also displayed in the HTML file list
	Added option to set page title
	Application now saves it settings (in application folder)
	GUI enhancements: Drag & Drop a source folder, tooltips
	Many smaller fixes to both application and HTML

  v1.91 (2013-12-29)
    Smaller change to hide root folder when linking files

  v1.92 (2014-06-12)
    Fixed various bugs reported by users lately
	Slight changes to the internals of the template file

  v2.0 (2017-04-22)
	Added export functionality to get data "out" of the HTML
	Export data as plain text, CSV or JSON
	Added support for searching with wildcards
	Search can be limited to current folder and/or subfolders
	Breadcrumb path is now clickable
	Current path is tracked in URL. Copy URL to link directly to that folder
	Opens previous folder when going back after opening a linked file
	Data format was tweaked to give slightly smaller output
	Fixed some bugs concerning filenames with odd characters
	Many other tweaks and fixes to improve the HTML template


 --- End User License Agreement -----------------------------------------------
  
  RL Vision can not be held responsible for any damages whatsoever, direct or 
  indirect, caused by this software or other material from RL Vision.