КАК УПРАВЛЯТЬ ПРОГРАММОЙ HREF

Ключи командной строки

-t число - задать размер части в килобайтах
-r файл - указать файл откуда читаются внешние ссылки (пока не реализовано)

Что можно указать самом файле:
Все команды, управляющие поведением программы задаются в виде
комментариев html.

1. <!--CONTENT--> - задает место в файле, где будет расположено 
                    оглавление. Все заголовки, встретившиеся до
                    этой команды, в оглавление не попадают.
         Эта команда также используется для задания стиля оглавления.
         За словом CONTENT могут следовать через пробел параметры.
    Параметры:
  а) NUMBERED - генерировать OL вместо UL
                Если надо генерировать OL не для всех уровней
                заголовков, а только для некотрых, то надо перечислить
                их уровне черз запятую. Например NUMBERED=1,3
  б) NESTED - генерировать иерархическое оглавление.
  в) BACKREFS - превратить заголовки в тексте в ссылки на оглавление
  г) DEPTH=n - где n от 1 до 6 не включать в оглавление заголовки
             более низкого уровня чем n.
  д) SPLIT=n - максимальная глубина заголовка, по которой можно
               резать файл на части
               Если написать SPLIT=0, то файл не порежется, независимо
               от размера.
  e) PARTSIZE=n задать размер части в килобайтах. Опция -t в командной 
                 строке имеет приоритет.
  ж) STRIP=буква - обрезать из заголовков номера при помещении их в 
                 оглавление. Заголовки в тексте останутся нетронутыми
                 Возможные буквы
                 n - арабские цифры
                 r - римские цифры i ii iii и т.д
                 R - то же, но большими буквами I II  III
                 a - латинские буквы a b c 
                 A - латиские буквы A B C...
                 Можно в любой момент добавить еще.
3. Способы указать параметры конкретного заголовка
   <!--NO TOC--> - не включать в оглавление следующий заголовок
   <!--TOC LEVEL=n--> - считать следующий заголовок заголовком
                 уровня n
           (например <!--TOC LEVEL=1--><H6>
          приведет к тому что заглоовок в тексте будет выглядит как H6
          а в оглавление попадет на самом верхнем уровне.
   <!--KEEP REFS--> - не очищать список использованных ссылок

4. Прочие параметры
   <!--REFFILE=имя файла-->  Использовать для расстановки внешних
       ссылок  указанный файл, а не стандартный.
    
5. Общие заголовки и подвалы при резке файла на части:

   Если в файле имеется
   управляющий комментарий
   <!--HEADER-->, то все строки который были до него, 
   будут повторены в начале всех частей разрезанного файла
   Аналогично <!--FOOTER--> и все что после него, будут повторены
   в конце каждой части

   Если в этих разделах имеются комментарии 
   <!--PREV="кусок html"-->
   <!--NEXT="кусок html"-->
   <!--UP="кусок html"--> 

   то во всех фрагментах кроме оглавления они будут заменены
  на ссылки на предыдущую/последующую часть,
   
  Конструкция <!--ANY="кусок html"--> будет раскомментирована,
  во всех частях кроме оглавления. Это позволяет например отделить
  ссылки на предыдущий/последующий от текста с помощью <HR>, написав
  <!--ANY="<HR>"-->
  
 6. Расстановка внешних ссылок.

   Программа считывает файл внешних ссылок в каждой строчке которого
   написано слово или словосочетание, отделенное двоеточием от URL и,
   если находит в тексте это слово, превращает его в ссылку на эту URL.
   В ссылку превращается только первое вхождение этого слова в данном 
   разделе. Если несколько разных ключевых слов указывают на одну и ту
   же url. то в ссылку превратится только первое вхождение любого из
   этих слов. Если в разделе уже есть ссылка на эту URL, вторая создана
   не будет. 

   Файл с ссылками ищется следующим образом:
   1. Если в командной строке указан ключ -r, то используется указанный
      файл.
   2. Если нет, а в обрабатываемом файле указан <!--REFFILE=filename-->,
      то используется файл указанынй в этом комментарии
   3. Если файл явным образом не задан, но в текущей директории
      существует файл href.lst, используется он
   4. Если ни одним из перечисленных способов найти файл не удалось,
      но существует стандартный файл ссылок (c:\lib\href\href.lst или 
       /usr/local/lib/href/href.lst), то используется он.
   5. Если и стандартного файла нет, то автоматической расстановки
      ссылок не производится
 
   Правила сопоставления текста с ключевыми словами
   1. Текст содержащий тэги html никогда не соответствует (а то могут
       получиться некорректные конструкции вида <B> слово<A HREF=url>еще
       </B> слово</A>)
   2. Несколько пробелов в тексте эквивалентны одному, а переводы строки
      скорее всего помешают сопоставлению.
   3. Регистр букв несущественен
   4. Символы * и ? в ключевых словах имеют специальный смысл - *
      соответствует любому набору букв, а ? одной любой букве. 
   5. Совпадения в середине слова не считаются. Например, если есть
      ключевое слово ice -> http://www.ice.ru/, а в тексте встречается
      слово nice, то n<A HREF="http://www.ice.ru/>ice</A> не получится.