﻿
Скомпилируйте справку с помощью UDF_Help_Builder.au3

============= Описание каталогов и файлов =============
Исходники необходимо редактировать в папках DynamicSRC (указан в helpbuilder.ini)
au3UserExamples - примеры кода справки
txtUserFunctions - тексты справки

Forge - каталог, в который происходит преобразование исходников и копирование темы, далее он используется для создания CHM

MainSRC_BlackTheme - тема Black
MainSRC_WhiteThemehiteTheme - тема White

UDF_Help_Builder.au3 - файл запускающий сборку справки. Он использует:
SciTE.au3 для конвертирования примеров в HTML-формат с помощью команд управления
SD_TxtToHtm_Mod.au3 - содержит функцию конвертации исходного TXT-файла в HTM-файл
SD_RegExp.au3 - содержит регулярные выражения для вставки ссылок в код

Для каждого CHM-файла в MainSRC есть файл "html\css\default.css", который содержит стиль оформления. Все цвета перенесены default.css, поэтому темы White и Black идентичны по контенту, кроме "default.css" и некоторых файлов в папке "images".


Используйте "HTML_Help_Workshop_1.3_ru__s2_100420_10-03" для редактирования справки. С помощью него можно изменить настройки справки: панель инструментов, вид дерева, количество вкладок. Для этого откомпилируйте нужную справку и при открытии проекта используйте "\Forge\src\UDFs3\CustomUDFs.hhp". Попробуйте изменить настройки и откомпилировать файл. Если устроит результат настроек, то сохраните проект и полученный CustomUDFs.hhp скопируйте в папку "\MainSRC_WhiteTheme\UDFs3", заменив одноимённый файл. Для темы "MainSRC_BlackTheme" достаточно скопировать эти же файлы.
Если вас не устраивают названия разделов в дереве, можно исправить это в файле "\MainSRC_WhiteTheme\UDFs3\CustomUDFs_TOC.hhc". При установке параметров дерева также сохраняется в CustomUDFs_TOC.hhc

CustomUDFs_TOC.hhc - вкладка Содержание, дерево справки
CustomUDFs_Index.hhk - вкладка Указатель, почти тоже что CustomUDFs_TOC.hhc, но нет тегов вложенности.
CustomUDFs.hhp - файл проекта, настройка панели инструментов, стартовый размер окна и др.

На основе этих двух файлов формируются список функций раздела
CustomUDFsMgt.txt

Файл "\MainSRC_WhiteTheme\UDFs3\html\css\default.css" - стилевой файл, содержит цвет и оформления результирующих HTML-файлов.
В папке "\MainSRC_WhiteTheme\UDFs3\html\images" находятся рисунки используемые в справке в качестве скринов и элементов интерфейса.

При обновлении примеров в папке "DynamicSRC\au3UserExamples" файлы пересоздаются в каталоге "\AutoIt_compile_UDF\Forge\examples", но с добавлением в начало текста " Background (фон для всех)">". Этот текст удалить автозаменой с помощью утилиты TextReplace, указав " Background (фон для всех)">~" в качестве поискового шаблона, выбрать символ переноса строки "~", заменить на пустую строку. После замены пересобрать вторично с уже исправленными примерами.