Етапи розробки

Розробка Help-служби вимагає вирішення таких основних задач.

• Планування системи довідок.На цьому етапі складається перелік розділів довідкової служби і необхідних перехресних
посилань.

• Створення текстових файлів,що містять описи
довідкових розділів. Текстові файли готуються за допомогою будь-якого текстового редактора, що підтримує розширений
текстовий формат RTF. В них включаються спеціальні керуючі символи
для створення перехресних посилань і підключення растрових зображень.

• Розробка проектного файла,що містить спеціальні команди для Help-компілятора. Проектний файл описує структуру
довідкової служби в цілому, у ньому кожному розділу присвоюється унікальний цілочислений ідентифікатор.

• Розробка файла змісту.Зміст активізується при
запуску HLP-файла, а також після клацання по кнопці зміст у
вікні довідкової служби.

• КомпіляціяHelp-файлів.

• Тестування і налагодженняHelp-служби.

• Зв'язок програмиз розділами Help-служби.

• Розробка файла змісту.Зміст активізується при
запуску HLP-файла, а також після клацання по кнопці зміст у
вікні довідкової служби.

• КомпіляціяHelp-файлів.

• Тестування і налагодженняHelp-служби.

• Зв'язок програмиз розділами Help-служби.

 

1.3. Створення текстових файлів

Вся довідкова інформація міститься в одному або декількох текстових файлів у форматі RTF. Для їхнього створення може використовуватися будь-який текстовий редактор, що підтримує цей формат

При створенні текстових файлів врахуйте такі особливості їхнього підготування:

• Кількість RTF-файлів може бути довільна. Ви можете
помістити всю довідкову інформацію в один файл або передбачити для кожного розділу окремий файл - все залежить від обсягу і структуризації Help-служби і ваших особистих пристрастей.

• У межах одного файла кожний розділ відокремлюється від іншого
службовим символом кінця сторінки (за допомогою Word цей
символ вставляється клавішами Ctrl+Enter).

• Будь-який розділ, доступний за допомогою перехресних посилань або індексних покажчиків, повинний мати пов'язаний із ним ідентифікатор - унікальний текстовий рядок.

• Розділ може мати назву і пов'язаний із ним список ключових
слів.

У текстовий файл включаються такі керуючі символи:

Виноска «#»   Перекреслений або двічі підкреслений текст     Підкреслений текст   Схований текст     Виноска «$»   Виноска «К»   Виноска «+»     Виноска «^»   Виноска «>»     Виноска «! » Вказує ідентифікатор розділу   Визначає відображення пов'язаного з текстом розділу (перехресного посилання) у стандартному довідковому вікні Визначає відображення розділу перехресного посилання у вікні пояснень («спливаючому» вікні) Визначає ідентифікатор розділу, пов'язаного з перехресним посиланням   Задає назву розділу   Вказує список ключових слів для пошуку розділу   Задає порядковий номер розділу в списку перегляду зв'язаних розділів   Визначає умови компіляції розділу   Визначає тип додаткового вікна, у якому буде відображатися розділ   Вказує макрокоманду, що буде виконуватися при відкритті вікна з розділом

1.3.1. Вставка графіки

Якщо ви створюєте RTF-файл за допомогою редактора Word, ви можете вставляти в текст графічні зображення засобами редактора. Єдине обмеження: файли з графікою повинні відповідати формату bmp. Проте Help-компілятор має і власні засоби вставки графічних зображень за допомогою зовнішніх вмр-файлів. Нижче описується, як це зробити.

Щоб вставити в текст графічний образ, необхідно помістити на призначене для розміщення графіки місце спеціальну директиву в однім із таких форматів:

{bmc filename. bmp}

{bml filename. bmp}

{bmr filename. bmp}

Тут filename - ім'я вмр-файла; bmc, bml, bmr - команди, що керують положенням картинки щодо тексту.

Команда bmc (від BitMap Char) наказує розглядати графічний образ як символ. У цьому випадку він розташовується точно на тому місці в тексті довідки, де зазначена директива вставки. Частина тексту, що залишилася, зліва і справа від директиви розміститься відповідно зліва і справа від зображення, а висота рядка з зображенням буде автоматично обрана так, щоб текст не накладався на картинку. Команди bml (BitMap Left) і bmr (BitMap Righf) змусять картинку притиснутися відповідно до лівого або правого краю вікна довідки. Всі перераховані в директивах ВМР-файли повинні розташовуватися в каталозі, зазначеному в опції BMROOT секції [Options] проектного файла.

Графічний образ може служити посиланням на пояснення або бути перехресним посиланням. Щоб додати йому такі властивості, необхідно набрати текст директиви в фігурних дужках, перекресленим або двічі підкресленим шрифтом, якщо графічне зображення використовується в якості перехресного посилання, або підкресленим одною лінією, якщо вона служить посиланням на пояснення. Відразу за виділеною в такий спосіб директивою потрібно зазначити схованим текстом ідентифікатор зв'язаного розділу. Наприклад:

Цей графічний образ (bmc flower.bmp)Bitmap Cross вставлений безпосередньо в текст і служить перехресним посиланням. {bml hardware.bmp}Bitmap Comment Якщо клацнути мишею по розташованій зліва картинці, з'явиться додаткове вікно з поясненнями. Таке вікно зручно використовувати для пояснення другорядних деталей довідки.

{bmr legal.bmp} Права картинка не є перехресним посиланням. Вона просто ілюструє одне з численних зображень, що поставляються для текстового редактора MS Word.

Мал. 1.1. Використання графічних зображень

На мал. 1.1 показаний екран Help-служби з графічними зображеннями. Для його створення використовувався приведений вище фрагмент RTF-файла.