phares3757/snap-2-html
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

v2.0

Browse Source
This commit is contained in:
rlv-dan
2017-04-22 17:40:03 +02:00
parent ff20c7305f
commit 7b9f51ceb9
21 changed files with 5771 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

217
Snap2HTML/ReadMe.txt Normal file
View File

@ -0,0 +1,217 @@
--- 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.