Блог технического писателя Ильи Жукова

Ключевые слова в Help+Manual

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

Сразу оговорюсь. В данной статье речь пойдет об обычных ключевых словах. Подробную информацию об ассоциативных ключевых словах (A-keywords) смотрите в статьях «Что такое ассоциативные ключевые слова» и «Ассоциативные ключевые слова в Help+Manual 7».

 

 

Содержание

 

 

В каких форматах поддерживаются ключевые слова

Ключевые слова поддерживаются в следующих форматах:

  • CHM
  • WebHelp
  • Word
  • PDF
  • EWriter

В форматах EPUB и MOBI ключевые слова не поддерживаются. В WebHelp и EWriter указатель можно включить или выключить.

Наверх к Содержанию

 

 

Откуда берутся ключевые слова в проекте Help+Manual

Ключевые слова добавляет в проект автор документации: либо вставляет из текста, либо вводит с клавиатуры.

Наверх к Содержанию

 

 

Как работают ключевые слова

Ключевые слова можно добавить в разделы (topics). В этом случае ключевое слово будет указывать на раздел. Для выходных форматов CHM, WebHelp и Ewriter ссылку по ключевому слову можно сделать более точной — добавить одно или несколько ключевых слов для якоря (anchor). При открытии раздела по такому ключевому слову содержимое раздела будет прокручиваться до места установки якоря.

Упорядоченный по алфавиту список ключевых слов (указатель) генерируется автоматически во время сборки документации. В форматах CHM, WebHelp и Ewriter ссылка по ключевому слову будет открывать раздел. Если ключевое слово указывает на несколько разделов, будет открыто меню для выбора раздела. В Word и PDF в предметном указателе напротив ключевого слова будет указан актуальный номер страницы раздела с ключевым словом. Если в настройках для публикации PDF выбран интерактивный документ (переключатель Similar to a Printed User Manual), то в PDF-документе номер страницы будет представлять собой ссылку на страницу.

Наверх к Содержанию

 

 

Сколько уровней ключевых слов поддерживается

В Help and Manual поддерживаются ключевые слова первого (master keywords) и второго (child keywords) уровней. Первая группа также называется простыми ключевыми словами, а вторая – дочерними.

 

ключевые слова первого и второго уровня

 

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

 

ключевое слово первого уровня - заголовок

 

При этом само ключевое слово первого уровня может и не быть ссылкой на раздел.

 

ключевое слово - не ссылка

 

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

Наверх к Содержанию

 

 

Как добавить ключевое слово

Чтобы добавить ключевое слово в раздел, в редакторе выделите одно или несколько слов и нажмите на клавиатуре Ctrl + K (пользовательское сочетание клавиш можно задать в настройках File / Program Options / Shortcuts).

 

как добавить ключевое слово

 

Выделенное слово или словосочетание будет добавлено как простое ключевое слово в поле Keywords на вкладке Topic Options.

 

ключевое слово добавлено

 

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

Наверх к Содержанию

 

 

Как добавить ключевое слово второго уровня

Установите курсор в начало строки с ключевым словом первого уровня и нажмите на клавиатуре Tab. В результате ключевое слово первого уровня станет ключевым словом второго уровня (например, documentation по отношению к projects).

 

добавление ключевого слова второго уровня

Наверх к Содержанию

 

 

Как добавить ключевые слова к якорю

Одно или несколько ключевых слов первого и второго уровня можно добавить в поле Keywords: во время создания или редактирования якоря.

 

ключевые слова для якоря

 

В этом же окне можно отредактировать ключевые слова и удалить их.

Наверх к Содержанию

 

 

Как найти и заменить ключевые слова

Функция поиска и замены в Help+Manual поддерживает работу с ключевыми словами. Для этого нужно в раскрывающемся списке поля Find Where: выбрать Topic Keywords.

 

поиск и замена ключевых слов

Наверх к Содержанию

 

 

Как найти разделы без ключевых слов

Для поиска разделов без ключевых слов можно воспользоваться отчетом Missing Keywords.

 

поиск разделов без ключевых слов

Наверх к Содержанию

 

 

Средство для работы с ключевыми словами

В версиях Professional и Server в Help+Manual есть специальное средство для работы с ключевыми словами Index Tool. Оно представляет собой панель для работы с ключевыми словами проекта в виде списка.

 

средство для работы с ключевыми словами Index Tool

Наверх к Содержанию

 

 

Как добавить алфавитные заголовки для указателя в WebHelp

Во время генерации указателя в список ключевых слов автоматически добавляются заголовки, соответствующие буквам алфавита. По умолчанию в Help+Manual заданы только буквы латинского алфавита. Чтобы в ключевые слова на русском языке были добавлены русские буквы-заголовки:

  1. В Project Explorer выберите Configuration \ Publishing Options \ WebHelp \ Keyword Index.
  2. В поле Index Separators (typically letters A-Z): после латинских букв введите заглавные буквы русского алфавита через запятую.
  3. Сохраните изменения.

 

заголовки для указателя

 

При указанных выше настройках в указателе будут работать латинские и русские алфавитные заголовки.

 

русские заголовки в указателе

Наверх к Содержанию

 

 

Как добавить алфавитные заголовки для указателя в PDF

Чтобы добавить русские буквы-заголовки в шаблон для сборки PDF документов:

  1. На вкладке Project выберите Templates&Skins \ Launch PDF Manual Designer.

 

запуск Print Manual Designer

 

  1. В окне Print Manual Designer откройте шаблон, который вы используете для генерации PDF-документов, например, Standard_manual_A4.mnl.
  2. В рабочей области перейдите на вкладку Keyword Index. Если данная вкладка скрыта, воспользуйтесь меню справа от вкладок.

 

настройки указателя в PDF

 

  1. Выберите Pages \ Page Options.

 

свойства указателя

 

  1. В окне Page Options for [Keyword Index] перейдите на вкладку Keyword Index Section.

 

буквы-заголовки

 

  1. В поле Keyword Index Separators после латинских букв введите заглавные буквы русского алфавита через запятую.
  2. Нажмите на кнопку ОК.
  3. Сохраните отредактированный шаблон в папку с проектом.
  4. Во время сборки PDF выберите данный шаблон в поле Select Print Manual Template.

При указанных выше настройках в указателе будут работать латинские и русские алфавитные заголовки.

 

заголовки указателя в PDF

Наверх к Содержанию

 

 

Добавить комментарий

Комментарии  

Алексей
# 0 Алексей 11.04.2022 00:46
Добрый вечер.
Описание вопроса такое.
Ключевое слово находится в нескольких разделах. Когда в разделе "указатель" скомпилированного файла при двойном нажатии на это слово появляется окно "Найденные разделы". Так вот в таблице "Название" разделы записаны как какая то абракадабра из букв и символов незнакомого алфавита. В чём ошибка или загвоздка?
Ответить Ответить с цитатой Цитировать
Илья Жуков
# 0 Илья Жуков 11.04.2022 11:24
Здравствуйте. Видел подобную проблему с кодировкой в HM Basic Edition -> с кириллицей корректно работает только версия HM Pro. Маловероятно, но проверьте языковые настройки в проекте: язык и кодировка должны быть русскими. В Windows в языковых настройках также везде должны быть Россия / Русский. Это нужно для корректной сборки CHM на русском языке.
Ответить Ответить с цитатой Цитировать
Алексей
# 0 Алексей 12.04.2022 00:15
Хочу спросить далее.
Я выбираю популярное слово (на русском алфавите) из текста всего проекта, затем делаю его ключевым, сохраняю всё. Опубликовываю проект, перехожу в раздел "указатель". Ключевое слово появилось.Далее, при внесении этого же слова в раздел "Поиск" и нажатии на кнопку "раздел" появляется окно с сообщением "разделы не найдены". Хотя это ключевое слово должно находиться в более чем 50-ти разделах документа.
Если проделывая аналогичные операции со словом на английском языке, то ключевое слово после внесения его в раздел "Поиск" ищется по всем разделам документа, но названия разделов в которых оно встречается прописываются абракадаброй.
Ответить Ответить с цитатой Цитировать
Алексей
# 0 Алексей 12.04.2022 00:16
Так же если одно и тоже ключевое слово было сохранено в нескольких разделах, то при нажатии на него дважды мышкой появляется окно "Найденные разделы" где указываются разделы в которых было сохранено ключевое слово, НО так же как было указанно ранее разделы записаны абракадаброй вне зависимости от того на каком языку написано ключевое слово.
Версия программы H&M 7 Professional. Язык справки Русский (Россия) Кодировка символа RUSSIAN_CHARSET
Ответить Ответить с цитатой Цитировать
Илья Жуков
# 0 Илья Жуков 13.04.2022 11:16
В редакторе на вкладке Topic Options исправьте все Topic ID до формата «latinletters_001».
Ответить Ответить с цитатой Цитировать

Последние статьи

Подключение таблицы стилей к проекту Hel…

При работе с форматами, основанными на HTML, для оформления контента в документах можно использовать каскадные таблицы стилей, cascading style sheets или CSS. Данная т...

Читать полностью...

Формулы в HTML Help (CHM)

Я по образованию филолог. Специализируюсь на разработке пользовательской документации на английском и русском языках. С формулами в документации сталкиваюсь редко и по...

Читать полностью...

Импорт документов MS Word в Help+Manual…

Часто технический писатель получает исходные данные от аналитиков, разработчиков, тестировщиков, маркетологов и других специалистов в форматах DOC, DOCX и RTF (реже, и...

Читать полностью...

Поиск в WebHelp находит удаленные раздел…

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

Читать полностью...

Контекстная справка в приложениях Window…

Понятие контекстной или контекстно-зависимой справки (от англ. context-sensitive help) появилось в 1987 году с выходом формата WinHelp. Изначально контекстная справка ...

Читать полностью...

Как поддерживать скриншоты в актуальном …

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

Читать полностью...

Книга «Разработка технической документац…

Уважаемые коллеги! Если вам нужно быстро освоить разработку документации по ГОСТ, рекомендую обратить внимание на книгу В.А. Глаголева «Разработка технической документ...

Читать полностью...

Перевод выходных документов в Help and M…

Выбрав русский язык и русскую кодировку в настройках проекта Help and Manual, многие авторы после первой сборки удивляются, увидев в выходных документах английские сло...

Читать полностью...

Размер и расположение окна CHM при перво…

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

Читать полностью...

Рваные края скриншотов в Help and Manual…

Многие платные редакторы скриншотов, например, SnagIt, FastStone Capture и др., умеют создавать эффект рваных краев. В сети Интернет можно найти множество видеоуроков ...

Читать полностью...
новое в Help and Manual 9

Новое в Help and Manual 9

23 ноября 2022 года компания EC Software к 25-летнему юбилею выпустила 9-ю версию программного комплекса Help and Manual (выходит c 1997 года). Комплект шаблонов Premi...

Читать полностью...

Создание CHM-справки в бесплатной програ…

KEL CHM Creator — это «новая» хорошо забытая программа, выпущенная в 2012 году, предназначенная для создания и декомпиляции CHM-файлов. Программа не требовательна к ре...

Читать полностью...

KEL CHM Creator — бесплатная программа д…

Если вам нужно создать CHM-файл, и вы больше не хотите пользоваться глючной программой HTML Help Workshop, тогда KEL CHM Creator — это ваш вариант. Программа позволяет...

Читать полностью...

HTML Help Workshop – бесплатная программ…

В 1997 году Microsoft выпустила новый формат справки, HTML Help (CHM), а также бесплатную программу для создания и редактирования справки в этом формате — HTML Help Wo...

Читать полностью...

HelpNDoc — бесплатная альтернатива Help+…

Еще одной альтернативой RoboHelp и Help&Manual является программа HelpNDoc от французского разработчика, компании IBE Software. Это практически полный аналог HelpS...

Читать полностью...

HelpSmith — достойная альтернатива Help+…

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

Читать полностью...

Все о справке и документации для пользователей!

Следить за новыми статьями:

© Илья Жуков, 2019-2024. Охраняется законом об авторском праве.