Possible uses: - Recursively read all sub directiories from a cd/dvd and make a 1 file catalog. - Make a collection of your music or books and let your friends/customers see whats available. - Quick and easy way to set up a website if you have some files you'd like to host/be hosted. - Use raw indexing for further processing (statistics, database, etc.) Why dir2html when I can use a single script: php, perl, shell commands or even +Indexes in apache? - Dir2html generates _static_ pages, which means your site will run with bare minimum of webserver's configuration thus it cannot be hacked in any way. I have seen dir2html sites on Amiga and 386's. If you use php and perl you open millions of holes to your computer, and if you take security seriosly you'd have to folow the trend and know the holes before the hackers do. You can even find the simplest existing webserver software on the net just make them distinguish text/html and image/gif mime types, and with this tool you will have a professional looking website in notime. How To Use DIR2HTML Last update: 1:41 PM 2005.10.31. ------------------------------------------------------------------------------------ [INSTALLATION] The installer should do this automatically, but in case anything went wrong: Open the app, let it make the .reg file, by pressing 'yes'. If you get an error message, you're missing some dll's just install these vb libraries: http://www.hszk.bme.hu/~cd197/Programzas/VBasic/VBRun60sp5.exe Or download the new ones from Microsoft's web. Also make sure http://www.hszk.bme.hu/~cd197/Programzas/VBasic/Dir2html/archive/TABCTL32.ocx http://www.hszk.bme.hu/~cd197/Programzas/VBasic/Dir2html/archive/MSWINSCK.ocx http://www.hszk.bme.hu/~cd197/Programzas/VBasic/Dir2html/archive/hash.dll Are in the same folder as dir2html's exe OR copy them in windows\system folder. ------------------------------------------------------------------------------------ [USAGE] dir2html can be run to make index.html for folders in 3 ways: 1. From gui: Open the tool. If you do want to make directly downloadable raw content then: Choose a folder and color scheme, lock the www root choose http as protocol, then press "Go!", view your results. Experiment with options, if you see somethnig you like then type a name for it in the drop-down box and SAVE the settings. 2. From the command-line: save some settings as in (1) and read ahead 3. From windows-explorer: Press indexilize in the explorer's content menu on the desired folder. ------------------------------------------------------------------------------------ [COMMAND LINE] syntax: dir2html.exe [path [-noquit] [-view]] [-sheme `sheme`] Path - absolute path to indexilize, NOTE: this must be the first parameter View - view the (main) page after generation in browser Noquit - don't quit after done generating Sheme - is one of saved shemes, without ".color" extension, NOTE: this must be the last parameter If a scheme is not specified, the default scheme is pre-loaded. Examples: c:\progra~1\dir2html\dir2html.exe D:\tests\ -noquit -view -sheme dark This will preload the `dark.color`, if it exists, indexilize `D:\tests\` Opens up the browser and stays open. c:\progra~1\dir2html\dir2html.exe D:\tests\ -view -sheme dark This will preload the `dark.color` if exists, indexilize `D:\tests\` Opens up the browser and quit silently. c:\progra~1\dir2html\dir2html.exe D:\tests\ -sheme dark This will preload the `dark.color`, indexilize `D:\tests\` and then quits silently. c:\progra~1\dir2html\dir2html.exe D:\tests\ This will preload the `default.color`, indexilize `D:\tests\` and then quits silently. c:\progra~1\dir2html\dir2html.exe D:\tests\ -view This will preload the `default.color`, indexilize `D:\tests\` Opens up the browser and then quits silently. In case of errors the dir2html won't quit but show the error message in the status line. Once you get it right, you can make a batch file, and put it in windows scheduler to indexilize you directory(s) on a schedule. Perfect for ever-changing server content (use this if you run http server on windows. Also can be used if you have write access through samba on a *nix box. Either way it allows you to index files available on http server). Dir2html runs smoothly under wine. No more comments for linux users. ------------------------------------------------------------------------------------ [ICONS] - Are you missing some icons? (A) Choose `Local (relative) ` and check `Download`, this will download (or fill up the icons missing) locally NOTE: make sure you locked wwwroot, and set the`pics/icons` path right so it downloads there This way only those icons are generated and downloaded which are used. (B) You can use the 'dynamic icons' function from the main site, which can manage unknown types (draws them for you) BUT icons will then be cross linked and this may work slowly, another disadvantage: accounts don't live forever you know. (C) Download the start-pack icon set from one of these sites: http://www.hszk.bme.hu/~cd197/pics/icons/index.html http://www.mad.hu/~csdani/pics/icons/index.html http://members.chello.hu/cselik/pics/icons/index.html http://www.extra.hu/cselik/pics/icons/index.html http://cselik.uw.hu/pics/icons/index.html http://www.freeweb.hu/denisa/pics/icons/index.html http://www.freeweb.hu/cselik2/pics/icons/index.html http://www.freeweb.hu/revizor/pics/icons/index.html http://fryguy.ca/ftp/pics/icons/ ftp://fryguy.ca/PICS/icons/ Save them, then you can add your own if needed. Then upload them somewhere on the server, then change the icon href by pressing the 'options/icons' and copy-paste your new href, don't forget to type '#' where you want extension to appear. NOTE: You can get you own icons by using an icon sucker/editor like Microangelo http://microangelo.us SAVE your settings: Type a name for them in the dropdown box and press 'save'. Next time select these settings before making pages. You can simply use one of these sites to access icons (but it is not recommended to steal bandwidth). (D) Download the start-pack icon set as in (C) above. Make a 'pics' folder and 'icons' inside it; copy all the icons you can get into 'icons' 'pics' folder should be on the root of your website, so it can be accessed from the entire site. Now unselect 'dynamic' and 'download from' and select 'relative' (in options/icons), set the directory correctly, SAVE those settings and use them next time. This is the best method for optimal usage of bandwidth for your site, and it will live as long as your site is up (also don't steal other sites bandwidth). -Don't like default color schemes? Press 'options/colors', edit and create your own, there's even a 'random' button if you see some scheme you like then type in the name of the sheme and press 'save'. Next time simply select your sheme. NOTE that icon-hrefs are ALSO saved, and most of the settings you see, so you can use this function to save all your settings. -Is it too hard to browse up to your folder you want indexed? Don't worry. Just open the folder in windows explorer and press 'Indexilize' on the context menu (either on folder allready open or right-click one). Note: This will work IF you allowed dir2html to register it self to windows registry, if this didn't happen automatically then double click the dir2html.reg to make it register. ------------------------------------------------------------------------------------ [HASHES] - Still not implemented in 2.x (I doubt it will ever be), please use dir2sig for this or try finding a client capable of this function, then edit the html you generated... Versions 30 (1.09) and a few below have alpha support for this, but are in no way stable (uses synchonius dos's dir/b) -Choose a folder and color scheme, go to options/protocol and choose 'sig2dat://' Go to 'options/subdirs' uncheck 'recourse subdirs' then press "Go!" ------------------------------------------------------------------------------------