Re: AutoHotkey: проект перевода, ветка #2
Руководство по программе HTML Help Workshop
Декомпиляция
File --> Decompile.
В Destination folder назначаем папку, куда будут распакованы исходники.
В Compiled help file выбраем документ, который следует декомпилировать.
После нажатия OK в Destination folder появятся файлы «Index.hhk», «Table of Contents.hhc» и папка «docs», содержащая htm-файлы.
Компиляция
Для компиляции справки нам потребуются:
htm-файлы, содержащие основную информацию
файл - содержание
файл - алфавитный указатель
файл - проект
Как создать Файл-проект описано ниже, остальное мы получили при декомпиляции оригинальной справки.
File --> Compile.
В поле Project file выбираем файл проекта и нажимаем Compile. Готово!
Создание файла-проекта
File --> New --> Project. Программа предложит преобразовать проект старого образца. Игнорируем, нажимаем кнопку «Далее».
В поле «Specify the name of your project file…» необходимо указать путь и имя создаваемого файла. Далее.
Нам предлагают выбрать содержание, алфавитный указатель и файлы. Ставим две первые галочки. Далее.
В качестве содержания выбираем Table of Contents.hhc. Далее.
В качестве алфавитного указателя выбираем Index.hhk. Далее.
Созданный проект откроется в окне программы.
Имеем вкладки Project, Contents, и Index. Во вкладке Project нажимаем кнопку «Add/modify window definitions». Пишем имя для нового типа окон, например My_window_type. OK.
Появится окно Window Types.
Во вкладке «General» в поле «Title bar text» вбиваем заголовок будущего окна справки. К примеру “Документация по AutoHotkey. Русский перевод”.
Во вкладке «Navigation Pane» проставляем галочки «Search tab», «Advanced» и «Favorites tab». Это нам даст при компиляции Поиск (продвинутый) и Избранное. В связи с этим откроется дополнительное диалоговое окно Resolve window definition, в котором задаются опции для типа окон My_window_type. Убедимся, что стоит галочка напротив «Search tab». «Compile full-text Information» нам не требуется.
Во вкладке «Buttons» можно прикрутить дополнительные кнопки навигации по вкусу. OK.
В некоторых системах шрифт Содержания по умолчанию может отличаться. Рекомендуется во вкладке Contents нажать кнопку «Contents Properties» и выбрать шрифт MS Sans Serif 8.
В основном всё, можно сохранять файл проекта: File --> Save Project.
Чтобы в окне справки появилось главное меню и кнопка «Шрифт», нужно немного поколдовать.
Если открыть файл проекта в текстовом редакторе, то мы увидим секцию [WINDOWS] со множеством параметров. Десятый параметр записан в виде шестнадцатеричного числа. Представим его в виде двоичного, а затем поставим единичку в 17ый и 21ый бит (если считать не по номеру бита, а просто справа налево). Теперь преобразуем его обратно в шестнадцатеричное число и подставим на место десятого параметра (если это слишком сложно, замените десятый параметр на 0x33520). Сохраняем файл - проект.
Готово!
How To Add a Font Button to an HTML Help Window Toolbar
My_window_type="Title bar text" Название данного типа окон и заголовок окна
"Table of Contents.hhc" файл - содержание
"new.hhk" файл - алфавитный указатель
"docs\AutoHotkey.htm" Страница по умолчанию
"docs\AutoHotkey.htm" Переход по кнопке меню “Home”
"docs\commands\index.htm" Переход по кнопке меню “Jump 1”
"Commands" Надпись под кнопкой “Jump 1”
"docs\Variables.htm" Переход по кнопке меню “Jump 2
"Variables" Надпись под кнопкой “Jump 2”
0x33520 Опции главного меню окна, опции кнопок (в т. ч. Шрифт), опции панели навигации, позиция окна (двоичный код)
[0,0,800,600] Сохраняет пользовательские размеры и позицию окна справки. Координаты левого верхнего и правого нижнего углов окна [x1,y1,x2,y2]
0x3006 неизв. (двоичный код)
Стили окна (двоичный код)
Расширенные стили окна (двоичный код)
Отдельная благодарность alexii и YMP за информацию по HHW!