This is a translation of help.html file

ZZEE Free HTML TOC 
===================


 Copyright 2000-2001 ZZEE. http://www.zzee.com

See license.txt for the license agreement. By using this software you
accept all the terms of the license agreement.

Table of Contents
=================

    *   Free HTML TOC features
    *   System requirements
    *   Installation and uninstallation
    *   Usage synopsis
    *   How program creates TOC
        *   Named and hyperlink anchors
        *   TOC tree
        *   Style and formatting
    *   Advanced HTML TOC

Of course, this TOC is created by the program itself :)

________________________________________________________________________

Table of Contents

Free HTML TOC features
======================

    *   Creates table of contents (TOC) of HTML file from header <H>
        tags.
    *   Automatically uses existing named anchors inside <H> tags or
        creates new ones if none.
    *   Automatically links TOC items to header tags.
    *   Completely re-entrant. It means that if you change the file
        after you have generated TOC, when you again supply it to the
        program, Free HTML TOC doesn't create redundant named anchors
        and doesn't duplicate TOC. This allows you to maintain just the
        HTML file itself, without having separate "source" file, which
        is required by some TOC generators.
    *   User specifies a place where to insert TOC with <!--TOC--> tag.
        Without this tag program selects a place automatically.

________________________________________________________________________

Table of Contents

System requirements
===================

    *   MS Windows 95/98/ME/NT 4.0/2000/XP

________________________________________________________________________

Table of Contents

Installation and uninstallation
===============================


You can install it using setup wizard or manually. To install it using
setup wizard, launch setup.exe after extracting the distribution. To
install it manually, unpack the distribution to the target folder and
rename "setup.exe" to "zfht.exe".

When setup is complete, use "ZZEE Free HTML TOC 1.0" link located in
Start/Programs/ZZEE Free HTML TOC to launch the program.

Note users of Windows ME and XP: you need to extract distribution zip
file prior to installation, do not run setup.exe from inside zip file.

Note users of Windows NT 4.0, 2000 and XP: you may need some
administrative rights for the installation. If you can't install the
software, ask your system administrator or log in under administrator
account.

To uninstall the software, use Add/Remove Programs link from Control
Panel or Uninstall link located in Start/Programs/ZZEE Free HTML TOC.

________________________________________________________________________

Table of Contents

Usage synopsis
==============


The program inserts TOC right after <!-- toc --> tag, or if none found,
after <body> tag, or if none found, before the first <H> tag, or if none
found [:)], in the beginning of the file.

So if you have special place where to insert TOC, put there "<!-- toc
-->" tag. All header tags prior to <!-- toc --> tag are excluded from
TOC. Note that this tag is case insensitive. If you have more than one
such tags in the file, the first of them is used.

To create a TOC, select a source file, optionally uncheck "Same as
source" checkbox and specify destination file, and then hit "Create or
remake TOC" button. When the process finishes, a pop-up message box
comes up.

________________________________________________________________________

Table of Contents

How program creates TOC
=======================


Named and hyperlink anchors
***************************


If you already have a named anchor inside <h> tag, then program uses it.
Example:

        <h1><a name="pet">Robot-pet interaction</a></h1>

Program leaves <h1> tag as is and creates this TOC entry:

        <li><a href="#pet" class="toc_item">Robot-pet
interaction</a></li>

If you don't have a named anchor in <h> tag, program creates it.
Example:

        <h1>Robot-pet interaction<h1>

Program modifies <h1> tag like follows:

        <h1><a name="zzee_link_6_1001933000"
class="header_item">Robot-pet interaction</a></h1>

And creates this TOC entry:

        <li><a href="#zzee_link_6_1001933000" class="toc_item">Robot-pet
interaction</a></li>

TOC tree
********


The tree is created based on relative relationship between two neighbor
header tags. Example: if you had <H1> followed by <H3> and then by <H2>
tags, then TOC generated would look like follows:
    *   H1
        *   H3
        *   H2

Where H3 and H2 tags go to the same level.

However if you had <H1> followed by <H2> and then by <H3> tags, then TOC
generated would look like follows:
    *   H1
        *   H2
            *   H3

Style and formatting
********************


To enable proper formatting, program inserts "class" attributes into
both named and hyperlink anchors generated. You can use CSS to provide
font, color and other style attributes to these tags. The classes are
"header_item" and toc_item" respectively. Example of "class" attributes
inserted:

        <h1><a name="zzee_link_6_1001933000"
class="header_item">Robot-pet interaction</a></h1>
        <li><a href="#zzee_link_6_1001933000" class="toc_item">Robot-pet
interaction</a></li>

________________________________________________________________________

Table of Contents

Advanced HTML TOC
=================


If you feel that you need more control over TOC generated, multiple file
TOC creation or more options available, you need Advanced HTML TOC. It
features the following:
    *   Process multiple files. It creates one common TOC for all files.
        You have an option if to insert local TOCs into each file being
        processed.
    *   Process numbering in decimal notation is like "1.4.2.". Program
        can create it both in <h> tags and TOC items. If you add or
        remove tags, numbering is recalculated. When TOC is generated
        from multiple files, then numbering is maintained throughout all
        files.
    *   User sets range of <h> tags being used in TOC. E.g.: <h1>
        through <h3>, or <h2> through <h6>.
    *   Can process page titles, which is useful for multiple file
        processing. Titles have precedence over <h1> tags.
    *   Custom user style for TOC generation. You have total control
        over tags used to delimit TOC items and lists. You can pass your
        own attributes to named and hyperlink anchors, and you can
        specify item indentation.
    *   Predefined styles such as expandable / collapsible tree are
        provided.
    *   Rollback. Program can clear all HTML code that it has inserted:
        TOC, named anchors and decimal notation.
    *   Support command line mode for external automation.

Advanced HTML TOC home page
