Справочные окна используются во всех выходных форматах?

Нет. Окна справки используются только в электронных форматах справки.

Окна справки уместны только в электронной справке, то есть Справке HTML, классическом Winhelp, Броузерной справке (HTML) и eBook. Вы можете утверждать, что Adobe PDF является также электронным, но по крайней мере насколько это касается справочных окон, они обработаны как печатная документация, наряду с Word RTF.

Хм... Я уже смущен. Так что является "справочным окном" и что оно делает?

В основном, справочное окно - все "средство просмотра справки", в котором отображена ваша справка.

Традиционная электронная справка – что означает Winhelp и Справка HTML в мире Windows – всегда отображается в "средстве просмотра". Это средство просмотра является и программой, которая отображает справку, и справочным окном. Оно имеет два основных компонента, панель Содержания и панель раздела, в которой отображены разделы.

Помните, по определению справочное окно - все средство просмотра справки, включая все его навигационные управления, Содержание и панель раздела. Это не только окно раздела!

Средство просмотра Справки HTML. Это размещение также используется в Броузерной справке и eBook.

Начиная со введения Справки HTML, справка всегда отображалась в одном окне, которое разделено на две "панели", с Содержанием в панели слева и текущим разделом в панели справа. Help & Manual воспроизводит это размещение и в его выводе Броузерной справки, и в его eBook с размещениями средства просмотра, которые соответствуют появлению средства просмотра Справки HTML настолько близко, насколько возможно. (Help & Manual также использует это размещение, между прочим.)

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

OK, таким образом средство просмотра справки - справочное окно. Так какое?

Определение справочного окна управляет цветом, позицией и появлением средства просмотра справки и навигационных управлений, отображенных в средстве просмотра справки.

Так как Вы всегда имеете средство просмотра справки, Вы также всегда имеете справочное окно, и определение этого окна определяет начальное появление и поведение средства просмотра справки, в котором пользователь рассматривает вашу справку. (Пользователь может изменить много вещей после того, как средство просмотра отображено, конечно.)

Вы обращаетесь к этим определениям Help & Manual в Проект > Свойства проекта > Окна справки. Эти определения упоминаются как "типы справочного окна".

В Help & Manual Вы управляете появлением и поведением основного справочного окна, и таким образом средства просмотра справки, редактируя определение типа справочного окна по имени Main. Это определение типа окна всегда существует, и Вы не можете удалить или переименовать его.

Это - также, где это начинает усложняться, однако:

Степень управления определением типа справочного окна фактически дает Вам диапазон появления средства просмотра справки от очень обширного (в Справка HTML) до почти нулевого (в Броузерной справке и eBook).

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

Определение справочного окна управляет только появлением средства просмотра?

Нет, больше. Вы можете также определить "вторичные" справочные окна с другими свойствами.

Если бы было только одно справочное окно, то мы не должны были бы обсуждать тему так детально. То, что делает справочные окна действительно полезными, - что Вы можете определить дополнительные типы справочного окна (столько, сколько хотите) с другими свойствами и видом. И Вы можете использовать эти окна, чтобы отобразить отдельные разделы по-разному и с разными стилями.

Эти дополнительные типы справочного окна упоминаются как "вторичные справочные окна".

Как только Вы определили одно или более вторичных справочных окон, Вы можете назначить их на отдельные разделы, так, чтобы вторичный тип окна использовался автоматически, когда отображен соответствующий раздел. Вы можете также определить вторичные окна на определения ссылки, чтобы отображать "нормальный" раздел во вторичном окне, когда пользователь нажимает на ссылку.

Таким образом вторичные окна могут иметь свойства, отличные от окна Main?

Да, вторичные окна могут иметь свойства, полностью отличные от окна Main.

Вы можете сделать вторичные окна совсем другого вида, чем основное окно средства просмотра справки, хотя количество управления, которое Вы имеете, зависит от выходного формата (см. другие разделы в этой главе для деталей). Между прочим Вы можете выключить заголовок, изменить цвет фона, определить другой размер окна и активизировать или выключить навигационные управления.

В Help & Manual вторичные окна также связаны с Шаблонами раздела HTML, который дает Вам даже больше управления.

Стандартное окно Main с
заголовком и белым фоном.

Здесь раздел связан с
желтым справочным окном без заголовка.

Важно:
В Справке HTML большинство этих изменений возможно только во внешних окнах (см. ниже), однако! Например, если основное средство просмотра справки имеет Содержание и навигационные управления, Вы можете только выключить их во вторичном окне, если Вы отображаете вторичное окно во внешнем окне.

В примере выше, желтое вторичное окно не может выключить Содержание или навигационные кнопки в средстве просмотра, потому что оно не отображено во внешнем окне. См. Окна справки в Справке HTML для деталей относительно этого. (В Winhelp вторичные окна всегда открываются во внешних окнах.)

Я видел справку, которая открывает некоторые разделы во внешних окнах, когда Вы нажимаете на ссылку...

Правильно! Вы можете также использовать вторичные справочные окна, чтобы отобразить отдельные разделы во внешних окнах.

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

Это вторичное окно желтое и
не имеет никакого заголовка или навигационных управлений.

Интересно. Что относительно шаблонов? Как они касаются справочных окон?

Во всех HTML-основанных выходных форматах каждое определение справочного окна, включая Main, имеет собственный шаблон раздела HTML, который может быть отредактирован отдельно.

Это - очень важный пункт для понимания, и это - одна из особенностей, которая делает Help & Manual настолько мощным и гибким.

В форматах, которые их поддерживают (Справка HTML, Броузерная справка и eBook) Шаблоны HTML значительно увеличивают управление тем, что дают Вам справочные окна по появлению ваших разделов, даже в Броузерной справке и eBook, где определения справочного окна дают Вам только очень ограниченное управление.

Так как каждый тип справочного окна связан с собственным шаблоном HTML, Вы можете назначить другой шаблон только на раздел, изменяя его тип справочного окна. См. Использование шаблонов HTML для получения дополнительной информации о том, что Вы можете сделать с шаблонами HTML.

Так в дополнение к определению вида справочных окон разделов - также путь выбора шаблонов HTML для разделов?

Бинго! Это - очень важный пункт для понимания, и это - одна из особенностей, которая делает Help & Manual настолько мощным и гибким.

Окна справки имеют собственные определения, но они также связаны с шаблонами HTML, и это является критическим для всех HTML-основанных выходных форматов. Вы можете изменить весь код HTML, определяющий размещение раздела, просто изменяя тип справочного окна во вкладке Опции раздела.

Теперь Вы вероятно начинаете видеть, почему мы чувствовали, что было необходимо посвятить так много времени объяснению справочных окон!

Я не могу редактировать тип окна Popup! Что это?

Тип окна "Popup" - одно из двух специальных стандартных определений окна. Другой - "Main".

Как Main, это - специальный тип окна, который не может быть переименован. В отличие от Main, Popup также не может быть отредактирован. Это - стандартный тип окна, используемый для всех разделов, определенных, как всплывающий (всем разделам, созданным в секции Невидимые разделы, назначен тип окна Popup по умолчанию).

Этот тип окна не может быть отредактирован, потому что форматирование всплывания обрабатывается по-другому, чем в нормальных разделах. См. Окна справки и всплывание и Стандартные типы справочного окна для деталей.