Как я могу вручную зарегистрировать файл html-справки в онлайн-документации Delphi (RAD Studio) XE6?

Когда запускается установщик компонента delphi, такой как компоненты Developer Express, он регистрирует файлы справки html в IDE Delphi, используя h2reg и файл INI, а также некоторую магию макросов. Если бы я был открытым исходным кодом или коммерческим автором компонента Delphi и хотел бы отправить установщик, который регистрирует html-help, как бы я это сделал?

В очень старых версиях Delphi (до 2007 г.) был инструмент для регистрации дополнительных файлов winhelp. Но в последние годы, хотя многие крупные поставщики (например, Developer Express) по-прежнему поставляют справку для своих компонентов, к которой можно получить доступ с помощью контекстной справки IDE (нажмите клавишу F1), не похоже, что в Delphi 2007 и новее, включая XE6, что процесс, с помощью которого это делается, хорошо документирован, и поэтому авторы компонентов обычно игнорируют встроенную справку Delphi IDE.

Я обнаружил, что сторонняя утилита под названием h2reg может иметь какое-то отношение к этому, но я не могу раскрыть секрет создания чего-либо здесь:

введите описание изображения здесь

Я полагаю, что знаю НЕСКОЛЬКО частей головоломки, и у меня есть образец рабочего файла .ini из компонента Developer Express, но я не могу понять, как собрать эти части вместе. Я думаю, что это было бы полезно знать всем разработчикам компонентов Delphi, поэтому я задаю этот вопрос здесь.

связанный вопрос задает как отремонтировать встроенный хлам. Далее я спрашиваю, как зарегистрировать вашу собственную html-справочную (.hxs, .hxc, *. Hxt) документацию.

Обновлять:

Часть решения, похоже, знает синтаксис H2REG, который выглядит следующим образом:

   c:\path\to\H2Reg.exe -r cmdfile=c:\path\to\MyH2Reg_Cmd.ini

Остается неизвестным, что входит в этот INI-файл, чтобы он отображался в Delphi XE6.


person Warren P    schedule 04.07.2014    source источник


Ответы (1)


На сайте Embarcadero есть минимальная документация (и да, она включает h2reg):

Установка файлов справочного содержимого dexplore.exe

У которого есть ссылка на сайт этого продукта:

H2Reg

У которого есть эта страница КБ:

H2 и справка Borland

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

person Remy Lebeau    schedule 04.07.2014
comment
К сожалению, ни эта страница документации, ни центральная статья кода, в которой упоминается h2reg, не являются завершенными. Нигде не указывается, как создать работающий INI-файл, как вызвать H2Reg или добавить свои собственные файлы справки. Я надеюсь, что вместе мы сможем дать правильный ответ. Ссылка выше действительно описывает, как восстановить регистрацию html-справки для файлов, поставляемых с продуктом. Близко, но не совсем то же самое. - person Warren P; 04.07.2014
comment
ссылки на упомянутой мной странице ведут меня на сайт h2reg, где я вижу следующую страницу : H2 и справка Borland - person Remy Lebeau; 04.07.2014
comment
Это круто, но в духе StackOverflow контент лучше ссылок, я думаю, что минимальный рабочий пример был бы отличным. Я сделаю один на основе этого сайта, если меня никто не опередит. - person Warren P; 04.07.2014
comment
@Warren Вы когда-нибудь согласовывали окончательное решение? Если да, то мне было бы очень интересно увидеть ваш рабочий пример. Спасибо - person Jason Enochs; 08.07.2014