Advanced HTML TOC 2.0 www.zzee.com | Index | You are here: Contents > 4. Source and destination files

4. Source and destination files

4.1. Single file

Use this option if you need to process just one file. The file can be overwritten or you can save modified file under a different name.

See also: How program creates TOC.

4.2. Multiple files

Use this option if you need to build TOC for several files. Order of files is significant, because TOC items are located in the same order. Add Files button allows you to select multiple files simultaneously.

If you have a file that you want to contain a TOC, then provide its name as a destination file. Destination file in this case is parsed and previous TOC (if any) and <!--TOC--> tag are found. TOC is inserted or overwritten. Header tags of the destination file are not handled. If you need to handle header tags of the destination file and put them to TOC, then include it into list of source files. The same file can serve as a destination file and can be included into the list of the source files.

If you need to create a destination file with a TOC in it, just provide a new file name in a dialog box which comes when you click Select... button. The file with the TOC will be created. If you decide to overwrite the TOC that was written into the new file, then you have to either delete the file [containing TOC] and then build the TOC or just build it twice, otherwise the destination file will be empty. 

<!--TOC--> tag of the source files is parsed as well and all headers prior to this tag are not processed.

The program creates relative links from TOC to files. This should work both for off-line content and for files served by a web server. But this implies a limitation on origin of source and destination files: they must come from the same drive (such as "c:\").

4.2.1. Interface hints

• You can add multiple files at a time
• Use drag & drop to change the order of the files
• Use DEL key to remove files from list

See also: Where program inserts TOC, How program creates TOC, Named and hyperlink anchors.

4.3. What is a project

To facilitate building TOC for the same set of files, a concept of project is involved. Project keeps information about source and destination files, format options and template used. Next time you start the program you can open a project instead of filling in all fields again. Use menu items and toolbar buttons to create, save and modify projects.

You can save project file with any extension, though ".toc" is the preferred one, which can have Windows Explorer association [set on installation], so you can open project files easily.