Бесплатная программа 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
- HelpNDoc — бесплатная альтернатива Help+Manual
- Создание проекта в бесплатной программе HelpNDoc
- Добавление разделов в проект HelpNDoc
- Создание CHM-файла в бесплатной программе HelpNDoc