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

HelpNDoc – проблемы и способы их решения

Бесплатная программа HelpNDoc активно развивается. Примерно один раз в месяц выходят новые версии программы с исправлениями ошибок и новыми функциями. Если не считать встроенного локального сервера, программа HelpNDoc в целом работает стабильно. Несмотря на это, на сайте разработчика в разделе документации FAQ and troubleshooting есть внушительный список проблем и способов их устранения. В этой статье я расскажу о проблемах, с которыми я сталкивался за 6 лет работы с программой HelpNDoc.

 

Ошибка во время запуска

Причина: несовместимость с менеджером паролей Sticky Password. Решение: добавьте исполняемый файл HelpNDoc в список исключений. Если не поможет, отключите автоматическое заполнение паролей для 32- или 64-битных приложений (по версии HelpNDoc).

 

List index out of bounds

Сбросьте настройки программы HelpNDoc до заводских.

 

Не работает локальный сервер

После сборки WebHelp локальный сервер, встроенный в HelpNDoc, не запускается из окна результатов сборки. Попробуйте запустить его вручную с вкладки Tools, указав файл в папке с выходным документом, который нужно открыть. Если встроенный локальный сервер не работает, используйте другой бесплатный локальный сервер: HM2Go, Open Server и т.д.

 

Не импортируются документы DOC или DOCX

Начиная с версии HelpNDoc 8, импорт из формата DOC не поддерживается. Используйте MS Word для преобразования документов из старого формата DOC в новый DOCX. Начиная с версии HelpNDoc 7 для импорта документов из формата DOCX установка дополнительного ПО не требуется.

При использовании более ранних версий HelpNDoc для импорта документов из форматов DOC и DOCX требуется установка бесплатного пакета совместимости Microsoft Office Compatibility Pack for Word, Excel, and PowerPoint File Formats. С современными версиями MS Office такой пакет совместимости не устанавливается. Его можно загрузить с сайта компании-разработчика HelpNDoc по ссылке.

 

Файл проекта устарел

На экран выводится сообщение "This project is too old to be opened with this version of HelpNDoc. Please open it and save it using HelpNDoc version x.9 to convert it first". Решение: установите последнюю сборку той версии HelpNDoc, в которой был создан файл проекта. Например, если файл проекта был создан в HelpNDoc 4.5, установите версию 4.9. Поэтапно конвертируйте файл проекта в актуальный формат.

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

 

Не отображается контент CHM-файла

Проверьте следующее:

  • Скопируйте CHM-файл на локальный диск.
  • Проверьте путь к файлу - он не должен содержать знаков "#".
  • Разблокируйте загруженный файл (Свойства - Разблокировать).

 

Не меняется размер и расположение окна CHM

Удалите файл hh.dat. Расположение файла:

  • в Windows XP: C:\Documents and Settings\user_name\Application Data\Microsoft\HTML Help\hh.dat
  • в Windows 7, 10: C:\Users\user_name\AppData\Roaming\Microsoft\HTML Help\Hh.dat

Подробнее смотрите статью "Размер и расположение окна CHM при первом запуске".

 

Номера страниц в оглавлении MS Word неправильные

Обновите поля - выделите оглавление и нажмите F9.

 

Не работает поиск в CHM и/или WebHelp

Проверьте следующее:

  • В проекте проверьте язык и кодировку.
  • Проверьте идентификаторы разделов и приведите их к правильному формату.
  • CHM: проверьте локализацию Windows. Чтобы в русском CHM работал поиск, необходимо разрабатывать справку на русской Windows.
  • В настройках сборки CHM-файла пометьте флажок Use project charset for topics (если пометить данный флажок, в разделах будет использоваться кодировка проекта вместо UTF-8) и пересоберите CHM.

Подробные пошаговые инструкции, как это сделать, вы найдете в книге «Разработка документации в HelpNDoc». Это первая и единственная инструкция на русском языке по работе с HelpNDoc.

 

Другие материалы о программе HelpNDoc

  1. HelpNDoc — бесплатная альтернатива Help+Manual
  2. Создание проекта в бесплатной программе HelpNDoc
  3. Добавление разделов в проект HelpNDoc
  4. Создание CHM-файла в бесплатной программе HelpNDoc 

 

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

Подключение таблицы стилей к проекту 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 — это ваш вариант. Программа позволяет...

Читать полностью...
ключевые слова

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

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

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

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

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

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

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

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

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

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

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

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