ВНИМАНИЕ: В ВЕРСИИ x64 НЕ РАБОТАЕТ УПАКОВКА, УДАЛЕНИЕ и Т.Д. — TC ПАДАЕТ!
Автор использует 32-битную систему и не имеет достаточно времени
отладить 64-битный вариант плагина.
Тестировался с Total Commander 7.x (32 бит) под WinXP (rus), 8.0 (64 бит) под Win7 (x64). Необходимо WinNT 3.5 или Win95 или новее.
Хотелось бы, чтобы программа была полезной, однако, НИКАКИХ ГАРАНТИЙ, ПОДДЕРЖКИ и всё такое...
Соображения по поводу плагина можно высказать автору.
CHMlib, CHMtools и библиотека сжатия LZX Copyright 2001 Matthew T. Russotto — http://www.speakeasy.org/~russotto/.
В CHMDir использована информация с сайта Paul Wise aka pabs —
http://pabs.zip.to и немного кода из
Info-ZIP (файл match.c
).
CHMDir добавляет в Total Commander поддержку файлов формата ITSS/CHM (компилированный HTML), позволяя распаковывать и искать файлы в архиве, а также упаковывать и удалять файлы.
Плагин позволяет распаковывать файлы HtmlHelp 2 (.Hx?
).
Кроме того, он может работать и как информационный плагин, предоставляя информацию о заголовке окна справки, компиляторе и времени компиляции.
Наличие Internet Explorer`а в системе не требуется.
NB: Плагин не может создавать полноценные CHM-ы с содержанием, индексом и т.д., но его достаточно для того, чтобы сделать CHM из скачанного сайта, если среди упаковываемых файлов есть хотя бы один файл с расширением .htm или .html. Для примера можно перепаковать этот архив в CHM. Для создания полноценного файла справки HtmlHelp можно использовать HTML Help Workshop или htm2chm.
Если файлы пакуются в новый архив, и в корне будущего архива нет файла
'#SYSTEM', то он будет создан. В качестве главной страницы будет взят первый
встретившийся файл из 'default_topics
' (см. CHMDir.ini),
а, если такового нет, то первый
встретившийся файл с расширением '.htm' или '.html'. Если в списке на
добавление нет файла содержания (.hhc), то он тоже будет создан с именем
'stub.hhc'. В этом файле будут перечислены все .htm*, .php-файлы с
подкаталогами в том порядке, в каком они перечислены в списке на добавление.
Т.е. их порядок с содержании зависит от сортировки, принятой в TC.
Для сохранения структуры файла перед перепаковкой он должен быть распакован с включенной опцией 'Показывать файлы CHM' (CHMDir.ini или диалог настроек), чтобы сохранить файлы типа '#SYSTEM' (в нем указана такая информация как заголовок окна справки, имя файла содержания и проч.).
File_Id.diz | краткое описание пакета | |
index_en.htm | описание пакета на английском | |
index_ru.htm | то же, что и выше, на русском (вы это читаете) | |
chmdir.css | Таблица стилей для index_*.htm | |
pluginst.inf | INF-файл для автоматической установки плагина | |
CHMDir.wcx | собственно плагин | |
sample.ini | примерный INI-файл плагина | |
chmdir.lng | языковой файл для информационного плагина | |
CHMView.exe | программа для просмотра файлов CHM без hh.exe | |
UnCHMw.exe | консольная версия распаковщика | |
wtdump.exe | консольная программа для вывода свойств окна HtmlHelp | |
wtedit.exe | программа для редактирования свойств окна HtmlHelp | |
descript.ion | описания файлов |
chmdir.wcx
в каталог по желанию.
chm
'
chmdir.wcx
.hxs
sample.ini
.
NB: Иконка файлов и действие по умолчанию (по нажатию <Enter>) не изменятся. Для входа в архив нужно использовать сочетание <Ctrl-PgDn>. При желании входить в архив при помощи клавиши <Enter> и показывать у файла иконку архива нужно сделать следующее:
- В главном меню выбрать Конфигурация/Настройка... и открыть страницу Архиваторы, в которой нажать кнопку Настройка архиваторных плагинов.
- В выпадающем списке 'Файлы с расширением' выбрать 'chm'.
- В поле 'Открывать с помощью программы:' заменить число NNN перед запятой на MMM, где MMM=NNN-256.
или
- Закрыть Total Commander
- Открыть INI-файл Total Commander`а (обычно
<каталог_windows>\WINCMD.INI
) в текстовом редакторе.- В секции
[PackerPlugins]
изменить NNN в строке, похожей на 'chm=NNN,C:\wincmd\chmdir.wcx
' на MMM, где MMM=NNN-256.Для просмотра CHM-файла можно использовать:
- команду hh <chm-file>,
- сочетание <Ctrl-Enter> для вставки имени файла в командную строку, а затем <Enter> для запуска ассоциированной программы (hh.exe),
- правый клик на имени файла и действие по умолчанию (выделено полужирным шрифтом).
Плагины
и в группе Информационные плагины нажать
Настройка.
При загрузке плагин считывает настройки из файла CHMDir.ini
,
стандартного ini-файла Windows,
который должен находиться в одном с плагином каталоге
(или каталоге, который указывает при загрузке TC).
Описание см. в файле sample.ini.
Чтобы изменения вступили в силу, нужно либо перезапустить TC, либо выгрузить все плагины и зайти в другой CHM (TC помнит список файлов последнего архива).
NB: Чтобы плагин использовал CHMDir.ini
в своём каталоге,
нужно добавить в INI-файл в секцию [CHMDir]
строку ini_in_plugdir=1
.
Программа предназначена для просмотра CHM-файлов без участия hh.exe. В качестве параметра ей нужно передать имя файла CHM. CHMView распакует этот файл во временный каталог и попытается запустить зарегистрированный просмотрщик HTML.
wtdump.exe выводит свойства окна HtmlHelp (или свойства по умолчанию для текущего каталога) и примерный HHP-файл (файл проекта HtmlHelp), который можно использовать для создания такого файла справки.
wtedit.exe позволяет редактировать свойства окна HtmlHelp для файла, переданного в качестве параметра программы.
Для работы обеих программ необходимо, чтобы файл CHMDir.wcx
находился в одном с ними
каталоге или в каталоге, указанном в переменной окружения 'PATH
'.
Более подробно см. HTML Help Web page или Help for HTML Help из HTML Help Workshop.
Эта программа — версия распаковщика с интерфейсом командной строки.
UnCHMw.exe использует настройки из CHMDir.ini.
См. http://wincmd.ru/plugring/chmdir.html
Отредактировать Makefile
, создать каталог 'obj' и запустить 'Nmake.exe'.
Олег Бондарь aka Hobo (hobo-mts at mail pnt ru
).
Заменить 'at' на 'собаку', а 'pt' на '.'.
В теме письма должно присутствовать слово 'CHMDir'.
'!!! Hobo'
.
Ничего не получилось. :-(