CHM/HHP: максимальная длина имен переменных в разделе [ALIAS]

Question

Какова максимальная длина имен переменных в разделе [ALIAS] файлов HHP?

I_AM_WONDERING_ABOUT_THE_MAXIMUM_LENGTH_OF_THIS_STRING_RIGHT_HERE=this-is-some-really-helpful-html-file.html

Я нашел спецификацию CHM/HHP прямо здесь:

https://www-user.tu-chemnitz.de/~heha/viewchm.php/hs/chmspec.chm/hhp.html

Эта страница говорит только о длине всей строки (но не о длине имени переменной). Я знаю очень конкретный вопрос. Тем не менее, кто-то может указать мне куда-нибудь.

Answer 1

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

Назначение двух файлов, например alias.h и map.h, - облегчить координацию между разработчиком и автором справки. Файл сопоставления связывает идентификатор с номером карты - как правило, он может быть легко создан разработчиком и передан автору справки. Затем автор справки создает файл псевдонима, связывающий идентификаторы с именами тем. Эта идея была заложена Ральфом Уолденом (бывшим Microsoft) несколько лет назад.

Обратите внимание, что HTMLHelp около 20 лет, и эти строки идентификаторов контекста в файле alias.h были получены из WinHelp как предшественник HTMLHelp.

Дополнительную информацию вы найдете в разделе "Создание контекстно-зависимой справки для приложений".

В общем, я бы рекомендовал использовать идентификаторы с фиксированным форматом из-за лучшей читаемости, как показано ниже:

;-------------------------------------------------------------
; alias.h file example for HTMLHelp (CHM)
; www.help-info.de
;
; All IDH's > 10000 for better format
; last edited: 2006-07-09
;---------------------------------------------------
IDH_90001=index.htm
IDH_10000=Context-sensitive_example\contextID-10000.htm
IDH_10010=Context-sensitive_example\contextID-10010.htm
IDH_20000=Context-sensitive_example\contextID-20000.htm
IDH_20010=Context-sensitive_example\contextID-20010.htm

Я бы рекомендовал использовать менее 1024 байта на строку.