directory / file
| rickdrive@phpbbstar | nextaris |
| html#1@toast.net | i2hp |
| rick.co.tv | usa map #1 |
| ataja.es:rick3 (see also rick, rick1, rick2) | url zspev |
| list, 283156 |
Copyright© 2000-2006 Rick Boyd.
Flipdrive can be found here.
Folder, File Options
| Folder (F4) | The root folder to build the html file(s) from. The folder can be entered manually, by clicking the folder button, or by selecting a recent folder from the drop-down list. |
| File Specification | Files to include as links in the html file. Multiple file types can be included by separating them with semicolons (for example: *.cpp;*.h;*.rc). |
| Filenames Include | One or more strings that filenames must include to be added to the generated files (for example: lease;indenture). File matches are not case sensisitive. |
| Output File | The name of the file(s) to be generated. |
| Script (F5) | HTML code to include, see scripts for more information. Different files are used when building a framed site. |
| Skip These Files | Files you don't want to link to. Multiple file types can be specified by using semicolons (for example: *.pch;*.rh;*.obj). |
| Skip These Folders | Folders you don't want searched. Skipped folders won't appear in the folder table and are ignored while searching recursively. |
| Include File Size | Includes the size of file links |
| Include File Date | Includes the date of file links |
| Include File Time | Includes the timestamp of file links |
| Summary At Bottom | Adds a summary of links to the bottom of the page |
| Include Folder Links | Creates a table with links to all subfolders above the file table |
| Suppress Parent Link | There is no link to the parent folder in the folder table |
| Use /r/n For Line Breaks | End of line markers in html files use /r/n instead of /n |
| Insert Commas Into File Sizes | Formats sizes with commas (for example: 1,234 instead of 1234). '.' Is used instead of ',' if 'European Style Dates' is selected. |
| File Sizes Shown in K's | Shows file sizes in multiples of 1,024 bytes (1K) |
| Suppress Headers | Table columns have no headers |
| Suppress Extensions | Links are shown without the extension (for example, 'something.txt' would appear as 'something'). |
| Suppress Visible Link Text | Generated link text is not visible. This is only useful when building a site of thumbnailed images.
Example script, which is required to have usable invisible links: /FILE_HREF_APPEND target="_new"><img src="%%F" alt="%%F" border="0" |
| European Style | Formats dates as DD/MM/YY (instead of MM/DD/YY) and times in 24 hour format without am/pm |
| Build 16-bit Unicode Files | Generated html files use 16-bit unicode character encoding instead of 8-bit. Use of a custom content-type and/or configuring your web server to transmit files in big-endian order is recommended. Note: 16-bit files are twice as large as 8-bit files. |
| Use HTML <title> As Link Text | Uses the <title> of a .html, .shtml, .xhtml or .htm file as the link text instead of the filename |
| Fully Qualified Path To Links | HREF links are fully qualified (for example <a href="C:/folder/folder/file.txt">file.txt</a>). By default, links are relative (for example <a href="folder/file.txt">file.txt</a>) |
| Convert &() to ISO chars | Converts &, (, ) to their html equivalents |
| Convert HREF Spaces To %20 | Converts spaces in <a> links to the html equivalent of %20. This should always be selected. |
| Convert Latin Characters | Converts non-english characters (for example ä, ö, ü) to equivalent html codes. This is generally not necessary, and can result in a very time consuming build process. |
| Non Functional Links | If selected, file links have no href component and aren't functional. Folder links still work. |
| Force Rectangular Tables | Adds extra td's as needed to make all <tr>'s have the same number of <td>'s. |
| Doctype | Selects html 4.01 transititional, html 4.01 strict, xhtml 1.0 transitional or xhtml 1.0 strict file generation |
| File Columns | Number of columns in the file table |
| Folder Columns | Number of columns in the folder table |
| Anchor Columns | Number of columns in the anchor table |
| Sorting Options: | |||||||||||||||||||||||||
| Sort By | Determines the primary key for the sorting filenames. If "Filename" is not selected, the filename will be used as the secondary sort key. | ||||||||||||||||||||||||
| Sort Order | Selects the sort order | ||||||||||||||||||||||||
| Sort Folders First | If selected, folders are sorted before the "Sort By" key. This is only relevant for recursive builds with "All links in one file." | ||||||||||||||||||||||||
| Sort By Columns | If selected, a column-wise sort is performed after the primary sort.
|
||||||||||||||||||||||||
Default Words:
Changes the default words used in generated html files.
| Recursive Build Type: | |
| One HTML File Per Folder | Builds a file in every folder with matching files in the branch under the main folder |
| All Links In One File | Builds a single file linked to all matching files in the folder branch |
| Build A Framed Site | Builds a frameset, a file for the left frame with folder links only, and a file in every folder in the branch with matching files. |
| Include Folder Anchors | Creates a separate table with links to each section of the file table. This only applies if the file is built recursively with 'All Links In One File', 'Show Folder Names,' and sort by folder first |
| Build Files Recursively | Toggles recursive builds on and off. A recursive build includes all subfolders of the main folder. |
| All Links In One File Options: | |
| Show Folders | Shows the folder name before each subsection of links. |
| Include Folder Anchors | Creates a table below the folder table with ID= links to each folder subsection. |
| Note: Both of these options are only relevant when folders are sorted first and a single file is being built recursively. | |
| One HTML File Per Folder Options: | |
| Page Title Options | Selects the html <title> for generated files. |
| Don't Build File In The Root Folder | Does not build a file in the topmost folder. This is useful if a different sort of build is needed for the root file. |
| Link Folders To The Default Output Filename | Appends the default output filename to all folders links. If this is not selected, most browsers will look for index.html in folders instead of the files being built. |
| Framed Site Options | Manages the scripts used for frameset components. The frameset file is copied wholesale and not altered. Filenames for the left and right frames are extracted from the frameset file. |
| Launch Output File | Launches the generated file in your default browser (F12) |
| Edit Script | Launches the current script in your default text editor (F11) |
| Read Initialization File | Reads all dirhtml options from an .ini file (F8) |
| Write Initialization File | Writes all dirhtml options to a .ini file (F9) |
| Save Batch File | Creates a batch file that builds the same file(s) that would be built if you clicked 'Build.' (F3) |
Dirhtml can generate html files compliant with strict or transitional xhtml 1.0.
Some of the differences between xhtml 1.0 and html 4.0 include:
You can change the target doctype on the Miscellaneous page or by redefining /DOCTYPE in a script.
Dirhtml can incorporate code into generated files by parsing a script. Please test all the built-in dirhtml scripts.
If you are not comfortable with coding html by hand, copy code from the html editor of your choice. F11 opens the current script in your default text editor.
Script sections: File, Anchor, Link
Below is a description of possible sections in a script file:
| Section | Description, Use |
| /DOCTYPE | Replaces the default <!DOCTYPE... > with a new html specification
(e.g. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">) |
| /HEAD | Text goes into the HEAD
(e.g. <meta name="Author" content="FUBAR" />) |
| /START | Text is inserted after the <body> line
(e.g. <p><b>Below is a list of files...</b></p>) Note: variables are allowed in this section |
| /END | Text is added at the end of the file, before </body>
(e.g. <p><a href="mailto:me@mydomain.com"><i>Email The Webmaster</i></a></p>) Note: variables are allowed in this section |
| /BODYHEADER | Text REPLACES the <body> line
(e.g. <body background="www.mydomain.com/marble.jpg">) |
| /CONTENT_TYPE | Replaces the default Content-Type line in the <head>
section
(e.g. <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>) Note: to have no Content-Type, add a blank line with one space |
| /BEFORE_ANCHORS | Text appears after the folder table but before the anchor table
Note: variables are allowed in this section |
| /BETWEEN_FILES_AND_FOLDERS | Text appears after the folder and anchor tables, just before the file table
Note: variables are allowed in this section |
| /BEFORE_SUMMARY | Inserts text just before the summary statistics at the bottom of the
page
(e.g. <p><b>Summary statistics for links on this page:</b></p>) |
| /SUMMARY_STYLE | Inserts text into the the <p> that contains the summary statistics
(e.g. style="font-weight: bold") |
File, Folder Table Related: Script sections: Document, Anchor, Link
| Section | Description, Use |
| /TABLEHEADER | Text REPLACES the file <table> header line
(e.g. <table cellpadding="0" cellspacing="0" border="2" width="100%">) |
| /FILE_HEADER_TD | Adds text to <td>"s in the header row of the file table
(e.g. bgcolor="lightgrey") |
| /FILE_TD | Replaces <td> for filename links
(e.g. <td class="some_class">) |
| /FILE_TD2 | The same as /FILE_TD, but for even numbered rows |
| /SIZE_DATE_TD | Replaces <td align="right"> for size and date cells
(e.g. <td class="size_td_class">) |
| /SIZE_DATE_TD2 | The same as /SIZE_DATE_TD, but for even numbered rows |
| /FILE_TABLE_ROW2 | Adds text to <tr> for even numbered rows in the file table
(e.g. class="even_file_row_class") |
| /FOLDER_TABLE_HEADER | Text REPLACES the <table> line for the folder table, see /TABLEHEADER |
| /FOLDER_HEADER_TD | Adds text to <td>'s in the header row of the folder table
(e.g. class="header_class") |
| /FOLDER_TD | Replaces <td align="left"> with a new TD type for items in the
folder table
(e.g. <td class="folder_td_class">) |
| /FOLDER_TD2 | The same as /FOLDER_TD, but for even numbered rows |
| /FOLDER_TABLE_ROW2 | Adds text to <tr> for even numbered rows in the folder table
(e.g. class="even_folder_row_class") |
Anchor Related Script sections: Document, File, Link
| Section | Description, Use |
| /ANCHOR | Adds text after a folder anchor
(e.g. <a href="#top">Top of page</a>) Notes: Only relevant when folder anchors are generated. This applies to anchors inside the file table, not to the list of anchors. |
| /ANCHOR_TABLE_HEADER | Replaces the anchor table definition
(e.g. <table border="0" cellspacing="1" cellpadding="2" width="100%">) |
| /ANCHOR_TD | Adds text to the <td> section of a cell containing an anchor in the
file table
(e.g. style="font-weight: bold") |
| /ANCHOR_TABLE_TD | Adds text to the <td> section of a cell in the anchor table
(e.g. class="anchor_element_td") |
| /ANCHOR_TABLE_TD2 | The same as /ANCHOR_TABLE_TD, but for even numbered rows |
| /ANCHOR_TABLE_ROW2 | Adds text to <tr> for even numbered rows in the anchor table
(e.g. class="even_anchor_row_class") |
| /ANCHOR_HEADER_TD | Adds text to the <td> of cells in the anchor table header
(e.g. class="header_td") |
Link Related Script sections: Document, File, Anchor
| Section | Description, Use |
| /FOLDER_HREF_APPEND | Text is appended to folder HREF links (e.g. target="frame2")
Example: <a href="folder_link" target="frame2">folder_link</a> |
| /FOLDER_FILE_LINK | Text is added to folder links (e.g. index.html)
Example: <a href="folder_link/index.html">folder_link</a> |
| /FILE_HREF_APPEND | Text is appended to file HREF links (e.g. target="_new")
Example: <a href="file.html target="_new">file.html</a> Note: %%F will insert the current filename in the append text, e.g. alt="%%F" would become <a href="file.html" alt="file.html">file.html</a> |
| /POST_HREF_FILE | Text is added after the closing file link HREF </a>, but
before the filename </td>
(e.g. Here is the filename: %%F) |
| /PRE_FNAME_FILE | Text is added before visible file links, not in the href
Example: given "ZZ " as /PRE_FNAME_FILE, links will look like <a href="file.doc">ZZ file.doc</a> |
| /POST_FNAME_FILE | Text is added after visible file links, not in the href |
| /PRE_FNAME_FOLDER | Text is added before visible folder links, not in the href |
| /POST_FNAME_FOLDER | Text is added after visible folder links, not in the href |
| /FOLDER_PREFIX | Text here is added before ALL links, including folder links
(e.g. some_folder/) Example: given a script with... /FOLDER_PREFIX ftp://mydomain.com/ ... links will look like this: <a href="ftp://mydomain.com/file.html">file.html</a> (Note: You MUST include a trailing slash.) |
Use scripts to add your own, HTML code to the generated pages. Section names can be absent, repeated, or be in random order. If a section is repeated, the text within it is appended to any existing data.
If you are not sure what a particular section does, create a script with that section only and examine the file it builds.
If you need an HTML reference, try this site. If you are reading this, you probably also use (or should use) an html validator. I recommend W3C for online validation, CSE HTML Validator for offline validation and Web Developer if you are using Firefox.
Anything in a script file before the first section section name is ignored, and can be used for commenting the file.
The following variables can be used in /START, /END, /BETWEEN_FILES_AND_FOLDERS, /BEFORE_ANCHORS and /BEFORE_SUMMARY:
| %%DIR | inserts the current fully qualified path (for example: C:\Windows\Desktop) |
| %%FOLDER | inserts the current folder (for example: Desktop) |
| %%DATE | inserts the date and time |
| %%F | inserts the current filename (only works in /FILE_HREF_APPEND and /POST_HREF_FILE sections) |
| %%FILE | inserts the contents of a text file. The filename must be followed by %.
Example: %%FILEwhatever.txt% inserts the contents of the file named whatever.txt. Note: Absent a path, dirhtml will look for the file in the folder being searched first, then in the same folder as dirhtml.exe. |
%%FILE, %%DIR and %%FOLDER can also be used in /HEAD
Once dirhtml builds html file(s) to your satisfaction, press F7 or click the "Save Batch File" button on the Input/Output page to create a batch file. Running the batch file generates the same file(s) as the gui.
Any dirhtml .ini file can be opened by pressing F8 and saved with F9.