» HelpMaker.Net

Программа, предназначенная для создания файлов справки к приложениям (в форматах rtf, hlp, chm, html на текущий момент). Что удивительно для этого класса программ (кои все являются надстройками над MS HTML Help), программа абсолютно и бесповоротно бесплатна. Русский язык поддерживается полностью, почти все необходимые примочки есть
Официальная поддержка осуществляется в новостной конференции news://news.vizacc.com/

Последняя версия: 7.3.0.40 (сентябрь 2007 г.)
!! Nota Bene: рекомендуется обновить exe-файл до сборки 7.3.0.42 !!
Загрузить!

albel: Поскольку программа интенсивно развивается, я, как правило, сообщаю о выходе стабильных сборок, на которых можно нормально работать. Пожалуйста, при анонсе новых версий комментируйте посты. Иначе можно нарваться на неприятности, т.к. только немногие сборки имеют официальный статус "stable". Спасибо!

Раздел Английский вариант Русский перевод

Вопросы по созданию файлов справки
Q: Как изменить заголовок?
A: Перейдите к секции Window List в проекте. Заголовок, который следует изменить, находится в окне "Main".

Q: Как изменить размер изображения?
A: Щёлкните правой клавишей мыши по изображению, выберите Format picture; или в Главном меню выберите Edit|Edit Picture. В появившемся окне можно задавать размеры.

Q: Как изменить размеры Окна?
A: Следует перейти в секцию "Windows list". Она содержит два раздела - "Main" и "Popup", в которых есть информация о размерах окна - X, Y, Ширина, Высота, Цвет для HTML help/ WinHelp.

Q: Почему долго осуществляется загрузка/сохранение?
A: Механизм загрузки/сохранения использует транзакции. Это означает, что большая часть данных подвергается полной проверке, прежде чем записывается на жёсткий диск, что позволяет избежать повреждения данных.

Q: Как скомпилировать файл справки
A: Перейдите в меню Tools| выберите пункт "Compile". Будет создан CHM или HLP файл (в зависимости от ваших настроек).

Q: Как выбрать тип файла справки - WinHelp, CHM, WebHelp или RTF?
A: Перейдите в секцию "Project" свойств проекта. На вкладке имеется переключатель WinHelp/ CHM/ WebHelp/ RTF.

Q: Куда записывается сгенерированный файл справки?
A: Файл справки создаётся во временном каталоге. Это позволяет избежать путаницы с файлами BMP, HLP, HPJ, HTML, PHP, генерируемыми программой. Временный каталог создаётся как подпапка в каталоге проекта. При создании WinHelp он называется "_tmphlp", в случае HTML-Help - "_tmphhp".

Q: Как связать проект с Visual Basic?
A: Вам необходим компонент HTML-Help ActiveX. Такой компонент имеется на сайте _http://www.helpware.net/.

Q: Как связать проект с Delphi?
A: Существует модуль HTML-Help. Пожалуйста, обратитесь к информации, приведённой на сайте _http://www.helpware.net/

Q: Сообщение об ошибке "Cannot Open the File: Mk:@MSITStore:C:\Windows\Help\Windows.chm" появляется при открытии файла справки.
A: У вас устаревшая версия HHCtrl.Ocx. См.: _http://support.microsoft.com/default.aspx?scid=kb;EN-US;312456

Q: В чём разница между A-Keyword и Keyword?
A: A-Keywords выводят список дополнительных или опциональных ключевых слов, когда вы нажимаете на ссылку. Keywords формируют Индекс (Index).

Вопросы локализации
Q: Можно ли использовать HelpMaker для корейских текстов?
A: Да. Следует поступить следующим образом:
1) Перейдите в секцию Project,
2) Откройте вкладку Unicode,
3) Выберите Korean / Hungul.

Q: Можно ли использовать HelpMaker для русских текстов?
A: Да. Следует поступить следующим образом:
1) Перейдите в секцию Project,
2) Откройте вкладку Unicode,
3) Выберите Cyrillic / Russian.

Q: Можно ли использовать HelpMaker для текстов на иврите (Hebrew)?
A: Да. Вы можете использовать Helpmaker для редактирования текстов на иврите. Однако было несколько сообщений о проблемах с режимом Справа Налево (Right-To-Left); причина пока точно не выяснена; если вы используете ивриь, сообщите нам об этом, а также о проблемах, которые у вас возникают.

Q: Можно ли использовать HelpMaker для текстов на хинди (Hindi)?
A: Мы не знаем. Если вы работаете с хинди и есть какие-либо проблемы с файлом справки, сообщите нам об этом.

Q: Можно ли использовать HelpMaker для текстов на других языках?
A: Да, все элементы программы понимают Unicode - редактор, редактор свойств, дерево и т.п.

Известные проблемы сборки Build 380+
Q: Как создать гиперссылку?

Существует индексный набор команд:
'#' = Целевая закладка.
'!' = POPUP (всплывающее окно)
'$' = POPUP LINK (всплывающая ссылка)
'~' = ALINK (ссылка-закладка)
'@' = File-Link (ссылка на файл)

Если требуется создать всплывающее окно, добавьте "!" в гиперссылку.
Если требуется создать всплывающую ссылку, добавьте "$" в гиперссылку.
Если требуется создать ссылку-закладку, добавьте "~" в гиперссылку.
Если требуется создать ссылку на файл, добавьте "@" в гиперссылку.

Основные причины использования индексного набора команд - символьный анализатор и преобразователь RTF в HTML, специфика WinHelp и HTML-Help. Анализатор заменяет "a href" на ссылку ActiveX для всплывающих окон и ссылок-закладок; при ссылке на файл "a href" заменяется на ссылку "ms-its".

Примеры синтаксима:
1) Если вы хотите создать ссылку на закладку, используйте следующий синтаксис:

"topic_id#bookmark" (без кавычек),

где:
topic_id = ID главы,
bookmark = имя закладки.

2) Если вы хотите создать всплывающую ссылку (HTML-popup), используйте следующий синтаксис:
"$hello world" (без кавычек)

3) Если вы хотите создать всплывающую ссылку (HTML-Popup) на главу, используйте следующий синтаксис:
'"$topicid" (без кавычек)

где topicid = имя главы.

4)Если вы хотите создать ссылку-закладку (A-Link), используйте следующий синтаксис:
"~keyword" (без кавычек)

Это создаст ссылку A-Keyword.

5) Если вы хотите создать ссылку на другой файл справки, используйте следующий синтаксис:
"topic_id@html_help_filename".

Это приведёт к тому, что символьный анализатор выдаст ссылку "ms-its://" взамен обычной гиперссылки.
Q: e (резкое) и e (нисходящее) заменились на русские символы!
A: Это ошибка в шрифтах. Исправлено в сборках Build 375+.

Q: В выходном HTML-файле есть проблемы с отступами/форматированием!
A: Эта ошибка была вызвана символьным анализатором, отсекающим пробелы, если RTF-файл содержал более двух пробелов подряд. Исправлено в сборках Build 375+.

Известные проблемы сборки Build 70
Q: Следует ли использовать Build 70, если я найду его?
A: Следует использовать более свежие версии; в них исправлены все найденные ошибки. Пожалуйста, не используйте Build 70, т.к. это очень старая сборка, которая более не поддерживается. Большинство проблем, обнаруженных в Build 70, исправлены, за исключением относящихся к гиперссылкам, изображениям и объектам html (*).

Q: Какие проблемы сборки Build 70 остались в текущей версии? (*)
A: Эти проблемы относятся к гиперссылкам, изображениям и объектам html. Причина, по которой эти проблемы не исправлены - это "патентованный" способ, которым редактор сохранял данные. Когда мы перешли "этого" редактора на наш собственный, такие данные не могли быть преобразованы в нормальный формат.

Q: Почему вы не можете исправить ошибки, связанные с "гиперссылками", "изображениями", "объектами html"? (*)
A: Это наследие "того редактора" и "того производителя"

Пример 1: тег гиперссылки - гиперссылка RTF старого типа. Попытка изменить путь приводит к печальным последствиям, таким как несовпадение пути, битые ссылки.

Пример 2: в теге изображения некорректно хранились данные изображения. Изображения GIF или JPG неправильно отображались в WinHelp; были проблемы с отображением BMP в HTML-help.

Это создаёт проблемы как вопрос бинарной совместимости.

Q:Возникла огибка декодирвоания! Что делать?
A: Следует чаще создавать резервные копии. Ошибка декодирвоания возникает, когда алгоритму записи не удаётся корректно сохранить данные на диск. Исправлено в сборке Build 80 и выше. C того момента, не было замечено ни одной ошибки в алгоритмах чтения/записи.

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

Вопросы разработчикам
Q: Какой редактор вы использовали?
A: Мы использовали собственную разработку. Редактор, содержащийся в наших программах - helpmaker, accounting system и др. - разработан нашей компнанией. Он содержит уникальные элементы, не присутствующие в других редакторах.

Диалоги, содержащиеся в HelpMaker, уникальны.

Q: Вы упоминали о нескольких плохих третьесторонних библиотеках. Что такое библиотеки?
A: Библиотека - это коллекция процедур, продаваемая разработчиком. К сожалению, многие разработчики обанкротились (намёк: провал интернет-компаний). Из-за того, что данные библиотеки содержали достаточно серьёзные ошибки, и эти ошибки не были исправлены, качество программы HelpMaker снизилось. Позже мы удалили большинство таких библиотек и, как следствие, исправили соответствующие ошибки.

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

Q: Могу ли я скомпилировать исходный код программы?
A: Исходный код программы зависит от множества коммерческих библиотек. Более того, могут возникнуть некоторые проблемы, связанные с банкротством третьесторонних разработчиков; для некоторых библиотек, использовавшихся для компиляции сборки Build 70, нет обновлений.

Q: Можно ли получить исходные коды HelpMaker?
A: Проект поддерживается как проект с закрытыми исходными кодами.

Q: Могу ли я использовать исходные коды?
A: Исходные коды лицензируются соглашением GPL. Если вы будете использовать исходные коды, вам следует открыть исходные коды своей программы.

Q: Есть ли разница в исходных кодах текущей версии и сборки Build 70?
A: Весь исходный код переписан. Интерфейс переведён на Unicode.
Q: Содержит ли HelpMaker шпионские или рекламные модули?
A: HelpMaker не содержит ни шпионских, ни рекламных модулей. Программы не устанавливает никакие TCP/IP соединения, помимо запуска браузера для открытия страницы разработчика (пункт меню Help).

Общие вопросы
Q: Почему вы называете HelpMaker лучшим бесплатным средством для создания файлов справки?
A: Оглянитесь вокруг. Попробуйте найти бесплатное средство создания файлов справки, генерирующее WinHelp, HTML-Help, имеющее официальную поддержку в конференции новостей, активно поддерживаемое и используемое людьми.

Трое разработчиков постоянно поддерживают исходные коды программы.
HelpMaker -это работа pro-bono. Тысячи часов разработки были потрачены, чтобы создать, разработать и поддерживать данный проект.

---

(*) - в настоящее время в программе используется новый редактор, в котором не возникают указанные проблемы. Также используется новый формат файла - sh5, в то время как build 70 использовал sh4. Основные проблемы, о которых идёт речь в вышеприведённых вопросах, связаны с преобразованиями sh4 -> sh5.Прим.перев.

Q: Как создать таблицу?
A: Перейдите в пункт "Table" меню. Первая опция - "Create Table". Выберите её для создания таблицы.

Q: Как изменить форматирование таблицы?
A: Есть настройки столбца, строки и ячейки. Настройки ячейки индивидуальны для каждой ячейки.

Q: Что такое twips?
A: Twips используется в настройках форматирования ячейки. 1 mm = 8 twips. Если вы хотите удалить границу ячейки, установите twips границы в значение 0 twips. Если нужно выделить границу, установите 16 twips (граница толщиной 2mm).

Q: Как осуществить захват экрана?
A: Вместе с HelpMaker поставляется программа для захвата снимков экрана.

Q: Как создать привязку (anchor)?
A: Привязка (anchor) - это то же, что и закладка (bookmark). Перейдите в п. Insert|Bookmark. Когда вы добавляете закладку, вы создаёте привязку. Чтобы использовать привязку, создайте на неё гиперссылку.

Q: Как можно загрузить HelpMaker?
A: Со страницы загрузки. _http://vizacc.com/gen_download.php

Q: Возможна ли печать из HelpMaker?
A: В настоящее время такой возможности нет.

Обходной приём в данном случае - экспорт в RTF и использование MsWord или WordPerfect для печати.

Q: Can this create PDF?
A: В настоящее время такой возможности нет.

Обходной приём в данном случае - экспорт в RTF и затем в PDF.

Q: Каково предназначение файлов lido.dll, lidp.dll?
A: Это системные dll, используемые HelpMaker. LIDO написана в Visual C++ и содержит функцие, отвечающие за чтение/запись файлов, unicode, и захват снимков экрана, используемый в HelpMaker.

Q: Что случилось с Мастером создания руководств?
A: Код был убран для ревизии. В скором времени он будет помещён обратно.

Q: Можно ли использовать HelpMaker для французских текстов?
A: Существует французский словарь, который вы можете использовать; вы можете создать файл справки на французском.

Q: Можно ли использовать HelpMaker для испанских текстов?
A: Существует испанский словарь, который вы можете использовать; вы можете создать файл справки на испанском.

Q: Где находится xahelp?
A: XAHELP - это справка с компонентной структурой для Delphi.

Q: Как задать шрифт по умолчанию?
A: В настоящее время такой возможности нет.

Q: Как создать гиперссылку на файл?
A: См. предыдущую статтью. В ней объясняются методы создания гиперссылок.

Q: Как создать всплывающее окно (popup)?
A: Вы можете создать всплывающее окно, используя переключатель, указывающий на то, что гиперсылка ведёт на всплывающее окно.

Q: Что происходит, если возникает ошибка чтения потока?
A: Следует чаще создавать резервные копии. Это проблема существует только в сборке Build 70.

Q: Где можно найти словари для HelpMaker?
A: См. _http://www.addictivesoftware.com/, выберите "dictionary".

Q: Исполльзуется ли в HelpMaker база данных, например, VBISAM, DBISAM или Access?
A: Нет.

Q: Что такое AVMAN?
A: Это иям исполняемого файла Мастера создания руководств.

Q: Can this do JavaHelp?
A: В настоящее время такой возможности нет.

Q: Почему нет перевода интерфейса для HelpMaker?
A: У разработчиков есть "проблема сортировки". Программма содержит примерно 30,000 строк, сложный файл справки, множество текстов на английском.

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

Поэтому вся программа и тексты на английском.

Q: Как создать гиперссылку на цель на той же странице?
A: Создайте гиперссылку, содержащую ID главы и имя закладки в поле ссылки.

Например, если имя главы "sample", а закладки - "top", ссылка будет выглядеть как:
"sample#top" (без кавычек).

Q: Где хранятся настройки программы?
A: Файл конфигурации в формате CSV расположен в C:\Document and Settings\\Application Settings\HM\

Q: Что случилось с импортом?
A: Над процедурой импорта в настоящее время ведётся работа. Импорт может работать не для всех файлов или вызывать GPF (известная ошибка).

Q: Как установить направление письма справа налево (Right-To-Left)?
A: Установите Right-To-Left в меню Edit, Right-To-Left. Есть три возможности - для всего документа, для главы и абзаца. Сделайте выбор в зависимости от типа документа.

Например, если весь документ на арабском, следует выбрать "Весь документь"; если отдельная глава на арабском, выберите "глава"; если часть документа на арабском, выберите направление справа налево для абзаца.

Q: Есть проблемы с проверкой орфографии для моего языка?
A: Мы переслали информацию о вашей проблеме разработчику средства проверки орфографии. Однако решение проблемы может занять время.

Q: Как назначить Context-ID главе?
A: Перейдите на вкладку Control, назначьте номер.

Q: Почему нет автоматического возрастания нумерации?
A: Причина состоит в том, что система нумерации достаточно громоздка и данная функция начинает плохо работать при наличии большого числа глав.

Q: Есть ли в HelpMaker поддержка средств для людей с нарушениями слуха?
A: Кто-то из людей с нарушениями слуха хадал этот вопрос. Ответ таков: HelpMaker не посылает никаких сигналов на динамик PC.

Q: Есть ли в HelpMaker поддержка средств для людей с нарушениями зрения?
A: Цвета, используемые в Vizacc, совместимы с Windows. Следует перейти в Панель управления, Настройки
экрана. Если вы не можете видеть синий цвет, следует отключыить темц Windows в Windows XP, т.к. HelpMaker может использовать темы Windows XP.

Q: Как добавить рисованные стрелки к файлу справки?
A: Короткий ответ: Вам нужно создать рисунок, содержащий стрелку, и добавить его.
Длинный ответ: WinHelp не поддерживает RTF-тэг стрелки, поэтому, если документ Word содержит стрелки, последних не будет в WinHelp файле. Обходной путь - Вам нужно создать рисунок, содержащий стрелку.

Q: Мой файл очень большой. Он постоянно увеличивается в размерах. Что-либо можно сделать?
A: Основная причина - в строках, всё хранится в unicode. Unicode требует 2 байтов вместо 1. Таким образом, файл справки в 100k будет занимать 200k в Unicode, а 1mb SH5 -файл сгенерирует 500-килобайтный файл справки.

Q: Что означает сокращение SH5?
A: Так сложилось исторически. Исходное расширение было ".ahm", что было сокращением от "helpmaker". Затем было добавлено множество структур данных, расширение изменилось на ".sh2", затем ".sh3" (helpmaker v3), потом ".sh4" (с helpmaker v4 до helpmaker v7 Build 70) и наконец ".sh5" в Helpmaker v7 Build 80+).

Q: Есть проблема с пробелами и гиперссылками. Ссылки, кажется, битые?
A: Исправлено в Build 370+.

Q: Возможно ли создать файл справки для базы данных MS-ACCESS?
A: Да.

Q: HelpMaker вызывает фатальный сбой при загрузке!
A: Мы не уверены в причинах. Некоторые пользователи сообщали об этом, однако не пояснили свои сообщения.

Мы предоставили имя отладочную версию, которая точно сообщала, в какой строке ошибка. Последние известные исправления связаны с (a) ошибками тем в Windows 98, (b) Загрузкой Unicode DLL в Windows 98.

Q: Гиперссылки отображаются некорректным шрифтом.
A: Эта ошибка была связана с текстовым режимом. Исправлено в Build 315+.

Q: Есть проблемы с Firefox!
A: У вас устаревшая версия Firefox. Пожалуйста, обновитесь до версии Firefox 1.0+.

Q: Гиперссылки дают ошибку защиты.
A: Эта ошибка исправлена в сборках Build 185+; если она появится вновь, отправьте документ в службу поддержки.

Q: Тема Windows XP работает некорректно.
A: Некоторые вещи, например, станлартные элементы управления, не могут быть использованы в темах.

Q: Возможен ли импорт GIF в HelpMaker?
A: Да. HelpMaker импортирует и экспортирует GIF.

Q: Файл справки не удаётся сохранить!
A: У вас проблемы с разрешениями. ПРоверьте, не установлен ли у файла атрибут "только для чтения".

Q: Есть разрыв страницы. Как его удалить?
A: Это не влияет на WinHelp или HTML-Help. Это свойство редактора.

Q: Как получить доступ к тестовым версиям (пререлизы)?
A: Существует небольшая группа тестеров, которые первыми получают доступ к новым версиям и проверяют новые идеи. Например, мы ожидаем ответа по электронной почте от них уже в течение нескольких часов. Если вы не располагаете временем (примерно 3-4 часа раз в неделю), пожалуйста, задайте вопрос в конференции, и вы получите ответ.

Q: Можно ли хранить изображения в разных папках?
A: Да. HelpMaker корректно обрабатывает подобные ситуации.

Q: Что такое проект?
A: Проект - это вместилище файла справки. Требует двух параметров: имени проекта (ярлык в окне дерева) и имени файла.

Q: Что такое символьный анализатор (token parser)?
A: Символьный анализатор - это код, требуемый для чтения/записи RTF, HTML. В RTF-файле множество RTF-ключей. RTF-ключ - это команда или последовательность команд, которая обеспечивает вывод на экран некоторой информации, например, жирного текста, вывод курсивом, подчёркивание и т.п., почти как ключи HTML. HTML-ключи обычно называют тэгами. Имеет огромное значение качество реализации анализатора. Символьный анализатор, осуществляющий чтение и запись множества HTML-тэгов, - это значит, что всё, что вы видитев HelpMaker, прямо перекодируется в HTML.

Q: Что такое RTF?
A: RTF - это расширенный текстовый формат (Rich Text Format). Это формат файлов, используемый Microsoft Word. Редактор, встроенный в HelpMaker, распознаёт большинство RTF-ключей, используемых Microsoft Word. В значительной мере практически все документы Word могут быть скопированы в HelpMaker без потери оформления.

Q: Является ли HelpMaker программой WYGIWYS (what-you-see is what you get)?
A: Краткий ответ: Да.
Полный ответ: Многие средства создания файлов справки используют простой символьный анализатор, и интерпретируют видимые тэги в тексте, и формируют из них RTF-команды в выходном файле. При этом имеется проблема: создание симвользного анализатора, производящего HTML и RTF, достаточно сложнная задача. Поэтому не так много программ поддерживают и HTML-Help и WinHelp.

Следующая проблема заключается в том, что WinHelp, RTF, HTML-Help и HTML-Web-Help, PDF требуют различных тэгов. Например, тэг изображения в WinHelp отличается от соответствующего тэга RTF, в том смысле, что в RTF изображение хранится напрямую, а WinHelp требует тэга {PICT}. HTML требует тэга и местоположения файла, а для PDF необходимы LZH/PKZIP сжатие и тэги %PDF%.

Другим примером служат ссылки. В WinHelp это тэг {LINK} вместе с тэгами pop-up и non-popup, а также window. В HTML-Help, существуют гиперссылки Javascript, гиперссылки Pop-up HTML, Прямые ссылки , ссылки, имеющие альтернативный текст, ссылки на веб-сайты, ссылки на веб-страницы, ссылки на другие файлы HTML-Help, ссылки на закладки, ссылки на закладки на веб-странице. В PDF есть ссылки на другие PDF-файлы, закладки определённых глав, ссылка на найденный элемент. Символьный анализатор, используемый в HelpMaker, генерирует все вышеупомянутые опции ссылок RTF, HTML, PDF.

Наиболее сложная часть анализа HTML - корректное получение числа вариантов гиперссылок. Ещё один пример - обработка изображений (см. следующий вопрос).

Дополнительная иллюстрация вышесказанного - Unicode RTF и Unicode HTML, традиционный WinHelp, отчасти устаревший HTML-Help и WebHelp. Существует смесь ANSI (не-Unicode), DBCS (Китайский, Японский), Unicode (Фарси, Корейский, Тайский). Требуется переход от Unicode к DBCS для WinHelp и Индекса WinHelp, преобразование имени файла и нескольких тэгов WinHelp в ANSI. Есть преобразование в HTML. Если вы использовали HTML с другими языками, вы знаете о кодовых страницах, тэгах шрифтов и unicode-шрифтах.

Например, вы пишете файл справки на корейском. При создании WinHelp, Unicode конвертируется в DBCS (Hangul/Johab). Корейский затем преобразовывается в ANSI для HPJ, и иных настроек WinHelp. При генерации RTF, корейский конвертируется в Language: Korean, Code-Page: Korean и DBCS (У вас должны быть корейская версия Windows и корейский Microsoft Office). При конвертации в HTML_Help, происходит преобразование в корейскую кодовую страницу HTML, символы Unicode. Уфф!

Q: Почему для HTML-Help используются изображения только в формате PNG?
A: Краткий ответ: Патент GIF.
Длинный ответ: На веб-страницах используются обычно изображения в форматах GIF или JPG. Примерно в 1996, UNISYS зарегистрировала патент GIF. Это заставило нас использовать JPG. JPG использует сжатие с потерей данных, поэтому скриншоты выглядят некрасиво. Когда формат PNG стал поддерживаться IE, мы перешли на него.

Это половина истории. Вторая половина - как сформировать корректное изображение. WinHelp не поддеррживает PNG, JPG и GIF. HTML_Help не поддерживает BMP (или бльшинство браузеров не читают BMP). Следовательно, в WinHelp, PNG, JPG и GIF конвертируются "на лету" в BMP, а в HTML_Help, BMP преобразуются в PNG.

Q: Работает ли HelpMaker с терминальным сервером (Terminal Server)?
A: Краткий ответ: Да
Полный ответ: EXE и DLL-файлы были скомпилированы с ключом IMAGE_DLLCHARACTERISTICS_TERMINAL_SERVER_AWARE (см. сайт Microsoft MSDN для получения дальнейшей информации по этому вопросу). Это значит, что если HelpMaker будет запущен с терминального сервера, он будет загружен специальным образом.

Q: Зачем использовать сервер терминала (Terminal Server)?
A: Например, у вас есть компьютер и ноутбук. Вы находитесь вне офиса, вы можете использовать сервер терминала и VPN (виртуальная частная сеть), чтобы подключиться к вашему компьютеру. Также возможно, что вы не хотите устанавливать все программы на компьютер, тогда как они есть на ноутбуке. Вы можете найти удобное место, например, диван, или лучше кресло, и работать там с ноутбуком. Ещё один пример использования - если в ноутбуке есть беспроводная сеть (WIFI), то вы можете гулять вблизи офиса и работать в другом месте. Также выможете показать ваши работы заказчику, не устанавливая программы на другие машины.

Q: Можно ли вставить в файл справки картинки вместо ссылок Top, Next, Previous (Вверх, Далее, Назад)
A: Да. Зайдите в Свойства проекта, вкладка Website, в поля с заголовками Top HTML Tag, Next ..., Previous ... введите вместо текста следующее : <img src = "....">, где "..." - путь к изображению, которое должно быть добавлено

HelpMaker.NET 7.1.400
Загрузить
what's new
===========================
B = Fixed Popup Bug. The bug is that normal hyperlinks turns into pop-up links instead.
B = White color on new topic. New topics would sometimes show white color instead of the normal beige color.
B = Setting color in TOC Template. The tempate would ignore custom colours.
B = Popup with other extensions ".htm", ".asp" would give a Javascript error. That is fixed.
N = Auto-increment changed to Power Editor.
N = Power Editor. This can edit Help Context Numbers, and TopicIDs easily.
B = Horizonal Scrolling in Tree fixed.
B = After compiling, the Tree becomes black. This is fixed now.
B = Import WinHelp fixed.
B = HelpMaker would pick-up things from the trash-can on compilation. This is now fixed.
B = Table of contents now has Javascript Tree.
N = Cancel on exit added.
N = Double confirm to close program. (Incase you lose data).
B = Stream Read Error is fixed.
B = Cannot focus on a disabled window on startup. This is fixed.
B = Fixed Eastern European support. Some characters in Czech. language was not showing up correctly.
===========================

HelpMaker.NET 7.1.407
Загрузить
what's new
===========================
B - Fixed an open access error, Error 6.
N - Added MSDN Help
N - Added BinaryToc for Help
---
Version 7.0.1.405
N - Added Clear all table borders.
N - Linking to other CHM now fixed.
B - Fixed some issues with PowerEditor.
N - Added Javascript tree.
N - Complex bullet and numbering in both WinHelp and HTML-Help.
B - Menu misnamed error.
B - Bold Bullet turns entire line into bold. This is now fixed.
B - Quotes Space in hyperlink fixed.
B - Warning on File|Close added.
N - Added "Topic" Macro to WebHelp.
B - Fixed Keyword error in WebHelp.
B - Flags for WebHelp compile was wrong. This is now fixed.
B - Fixed the HLP_Import.
B - Fixed the Import/Export.
===========================

HelpMaker.NET 7.1.410
Загрузить
what's new
===========================
B = Bug Fix
N = New Feature
I = Improvement
--
Version 7.0.1.410
B - Fixed bug in WinHelp import where "?/@#$%^" characters are now filtered out in import. This caused HTML-Help compilation to fail.
B - Fixed several import issues.
N - Command Line Compile.
Command-Line compile settings:
'/ch' for CHM
'/cp' for PDF
'/cw' for WinHelp
'/cr' for RTF
The syntax is:

where
= c:\program files\avhelp\avhelp.exe
= /ch, /cp, /cw, /cr
= full path of the *.sh5 file to compile.

For example:
c:\program files\avhelp\avhelp.exe /cr c:\documents\help.sh5

That will compile the help file as WinHelp.

N - USB Thumb Drive support. (Contact us for details on how to install HelpMaker on a USB Thumb Drive.
N - Added a menu-popup option to "set as Default Topic".

N - Chapter to Text items now are shown in HTML_Website Help
N - Chapter to Text items now have Map IDs.
B - Various Bugs fixed.

===========================

HelpMaker.NET 7.1.420
Загрузить
what's new
===========================
B = Bug Fix
N = New Feature
I = Improvement
--
Build #420
B - Added prompt before sorting the whole treeview.
B - Fixed Apostrophe in spell checker.
B - Fixed Non-English Spell Checking.
N - Table Cell Width, Table Width screen redesign.
B - Fixed Hyperlink Prompts.
B - Removed "Trojan Horse" uninstall utility (disinfected by Anti-Virus).
B - Fixed the accented and diacetric keys on International Keyboard.

Build #416:
B - Fixed an issue with setup where the auto-configuration was not updated with new files.
B - Fixed an issue with Javascript tree.

Build #415:
B - Fixed all issues with Mass Spell Check.
B - Cut, Copy, Paste now works with Treeview.
B - Accented / Diacetric Works now works correctly with spell-checker.
N - Tree Popup Menu now selects nodes in Right-Click.
N - Ability to move topics around by Keyboard.
N - Clone Topic added to Tree Popup Menu.
N - Mark/ Unmark is now checked in Tree Popup Menu.
B - Spelling F7 "Always on Top" is now fixed.
B - Context menu for pages on the Recycle bin: "moved to the recycled bin"
should be replaced by "deleted"
B - hyperlink to another file issues fixed.
N - Menu item and button to run CHM file without recompiling it
N - Shell Execute added to after compilation.
N - Backup is now stamped with date/time.
N - Hyperlink Window is now resizable.
B - Insert Chapter Text is fixed.
N - Assign help context ID numbers on the fly.
N - Added "Creator", "Author" to new New Topic (for reference purposes).
N - Added Child Sort.
B - Fixed installation Error.
B - Fixed javascript tree errors.
N - Added Horizontal Ruler command.
B - Fixed Internal Screen Capture Command
B - Fixed bug over language in Hyperlink and Internet Hyperlink.
B - Fixed bug over hyperlink with images.
N - Added Free-Form HTML-Help support, Added ALIAS support.
B - Foreign Language Spell Checking now works with accented characters.
N - Added "copy" function to copy the Caption from the Tree List in the
Hyperlink.

Hyperlink:
N - Added "copy" function to copy the caption to the Link in Insert|Internet
Hyperlink.
B - Fixed a bug with Russian Popups. This respects the Charset of the
Document in
HTML_Help.

This solves the issue of overwriting an existing Hyperlink Caption and allowing people to replace the existing (hyperlink) caption with a new (hyperlink) caption.

N - Backups are now versioned with the date + time stamp. This allows
multiple
versions of the same backup file. (for safety purposes).
N - File Internal Compression. This reduces the large file sizes for large
files.

Image Editor v1.0.0.1
B -"Capture window" does not work. It always captures the whole desktop
without waiting for me to select any window.

===========================

albel
По удобству не сравнится с H&M. Настройки шрифта постоянно слетают на дефолт, при copy-paste целиком веб-страницы (1251) нарисовалось анси. (Зато хорошо кушает абзацы). С поп-апами сложновато... albel, не посоветуешь ли прогу подобного типа, но по законченности сравнимую с H&M? С поп-апами...

Iso
в том-то и дело, что для chm-файлов (я так понимаю, нужны они) с попапами больше ничего нет. Здесь, в принципе, не так всё плохо, если приноровиться , я уже пообвык.
По законченности H&M лидирует.
ps. Ежели что с попапами, говорите, я попробую помочь. Есть ещё ньюсгруппа и icq автора программы , так что не пропадём

albel
Ну и оперативность!!!
Что касается поп-апов, то как ни пытался я его родить, так и не родил - сложновато. Спасибо.

Iso
Посмотрите, я сюда положил проект HelpMaker и скомпилированный файл - вы сразу увидите, то ли это, что Вам нужно.
Ежели будут вопросы - вэлкам.

Отлично! Качаю, спасибо!

Это то, что надо!!! Мои благодарности, albel! Картинки в поп-апах со скроллами и не режутся как в H&M, если поля не хватает. Файлик, конечно, будьте-нате, но комфорт работы с ним будет окупать размеры. Еще раз спасибо.

Iso
рад, что пригодилось

Цитата:

Файлик, конечно, будьте-нате,

не совсем понял оборот
Если имеется в виду размер изображения, то всегда можно с форматами поиграться, с gif, например.

p.s. Пара хинтов по картинкам:
а) если вставляете картинки из буфера обмена, то TopicID НЕ должен содержать символов кириллицы, иначе возникнут трудности при компиляции (HTML help workshop не всегда хорошо к кириллице относится )
б) лучше не линковать картинки с файлами на диске - тяжело будет обновлять.

p.p.s. Build 420 делает бэкапы при каждом сохранении, так что надо периодически чистить каталог проекта

p.p.p.s. Все более-менее стабильные билды анонсируются здесь.
Успехов.

albel
Нет, размер самого файла. Страница + отдельно сохраненные скрины весила около 2м, а *.chm - около пяти. Я уже прочел об этом выше, а теперь убедился на опыте

Iso
странно. Очень странно. Chm обычно меньше бывает за счёт сжатия. Если не сложно, пришлите проект / исходные файлы на albel@hotmail.ru - посмотрю, почему такое возникает. (ну или что-то аналогичное).

albel
Вчера я не прочел этот пост, поэтому не смогу прислать раньше, чем завтра
Это предложение - большая любезность с вашей стороны. А вот такая штука в HM удивила меня сегодня. Вот только что скомпилированный файл справки. он открылся на картинке, помещенной во (вроде) скрытом разделе поп-апов. Скрываю левую сторону, открываю страницу оглавления, обновляю и закрываю. Обычно после этого можно открывать заново уже на оглавлении. Но справка снова и снова показывает то же окно. В чем тут может быть дело?

Iso
Projects -> <Ваш проект> -> General -> назначьте Default Topic из глав, находящихся в Main. По умолчанию назначается последняя созданная глава (поэтому в вашем случае и получается переход на popup).

albel
Спасибо, понял. Я-то крутил совсем другие настройки Теперь насчет посылки файлов. Яндекс, где у меня ящик, формально поддерживает присоединенный файл до 5м, на деле - мах 1м. Сегодня он сорвал посылку. Сделаю один архив, порежу на 8 частей и буду сбрасывать (у меня дайлап), а вот пока точные размеры:

iesvray_files 3 106 309
iesvray.htm 25 237
interior.chm 4 181 735

albel
Извините за оффтоп.
Я в привате оставил сообщение.
Жду ответа третий день.

Iso
ага, спасибо, ясно. Жду с нетерпением


Allroundman
ну да, ну да. У меня как раз третий день как провайдер накрылся

Vizacc HelpMaker.NET 7.1.427
Загрузить!
what's new
===========================
B - Fixed error for HTML compilation where old images did not export out to HTML.
B - Format Picture floating point error is fixed.
B - Missing text from "Chapter with text" problem is resolved.
B - Modified Date keeps updating when clicked, is fixed.
B - Erratic header in HTML-Website and HTML-Help issue is fixed.
B - File "Hab" now saves every 60 minutes instead of all the time.
B - Picture now can be saved in both 16m and 265 colors.
B - main menu -> HelpMaker -> Item -> Topic Status removed.
B - Fixed issue with pictures.
N - Added feature to delete a hyperlink
B - Fixed issue with Pictures.
===========================

This is a temporary release and will be updated again.

p.s. Обращаю внимание, что в свойствах проекта появилась настройка [x] Use 16-bit colour mode, которую необходимо отметить, дабы иметь полноцветные картинки в результирующем файле. Впрочем, это и так будет заметно. В ином случае картинки 8-битные.

albel

Цитата:

Жду с нетерпением

Уф, сегодня послал Вам проект, но без созданных им картинок (6м). Что мне надлежит посылать дальше, эти картинки или веб-страницу, которая послужила началом?

Iso
все картинки же в проекте уже содержатся, насколько я понимаю (проект самодостаточен, необязательно хранить картинки на диске после добавления их в проект, тем более, что при компиляции картинки всё одно видны отдельно в каталоге _tmphhp).
У меня получился результирующий файл в 2 209 045 байт за счёт использования картинок в 256 цветов (менюшки на Ваших картинках уходят в зеленоватый оттенок, в остальном ничего не меняется, так что, думаю, вполне можно пойти на такие жертвы). Советую скачать Build 427, там как раз появилась соответствующая настройка (см. мой предыдущий пост).
При установленном флажке [x] Use 16-bit colour mode размер результирующего файла 4 181 657 байт.

Пара хинтов по Вашему проекту:
(1) Лучше поменять заголовки окон по умолчанию - Main и Your Project не очень смотрятся в help-файле - см. рис 1,2 ниже.
(2) Назначьте тему по умолчанию - Default topic, чтобы Вас не выкидывало на последний popup - см. рис.2, поле подсвечено жёлтым.

рис.1.



рис.2

(3) Уберите вкладку Поиск - пока не работает поиск по русским текстам (бага сейчас в стадии устранения разработчиками, связана с Unicode)
(4) Previous, Top, Next можно сделать русскими, введя соответствующие слова на вкладке Website в свойствах проекта. Более того, можно использовать картинки вместо слов (см. один из FAQ на предыдущей странице).

Удачи.