» Help & Manual

Господа.
Такая проблема: при декомпиляции первоначального файла справки .СНМ постоянно происходят ошибки распознавания ID-разделов. Одну из пяти ссылок делает с ID, которое отличается от оригинала добавлением единички вместо последнего знака.
Как побороть?

Добавлено:
mickolam2004
Даю выдержку из справки к самой программе.

Добавить ссылку к разделу в отдельном справочном файле

1. Переместите курсор в позицию в тексте, где Вы хотите вставить ссылку. Если Вы напечатали слово или фразу, которую Вы хотите сделать заголовком ссылки, выберите это слово.

2. Из меню Insert, выберите Link.

Отобразится диалог вставки ссылки.

3. Введите заголовок ссылки.

4. Выберите файл справки, где расположен целевой раздел. Нажмите [...], чтобы определить местонахождение этого справочного файла.

5. В поле Topic ID entry, введите ID раздела этого целевого раздела. Вы должны знать точный адрес.

Самое главное, при добавлении ссылки на другой файл справки необходимо, чтобы целевой файл уже! находился там, куда будет помещаться скомпилированный файл справки с этой ссылкой. В это же место должна производиться и сама компиляция. В дальнейшем, чтобы ссылка работала эти файлы должны быть всегда в одном месте компьютера, т.е., если нужно переместить куда-то нашу справку, то перемещать необходимо их обе!
Второе условие - ID разделов целевого файла справки Вы должны знать заранее. Для этого можно в холстую декомпилировать целевой файл справки, вычитать все необходимые ID и их использовать. Также можно попробовать для этого сторонние программы, работающие с .chm файлами.

ershiki

нет, мне немного не так надо...
у меня есть набор законченных CHM-файлов, или же есть проекты HMX
из которых собираю эти CHMы. у каждого проекта уже есть контекст и все необходимое внутри.
создаю новый основной проект, который БУДЕТ ВКЛЮЧАТЬ все готовые проекты,
подключаю посредством указания внешнего проекта - каждый файл отображается
в виде синенькой папочки... компилю все в одну папку.
смотрю основной CHM - все топики видны,
по ним можно ходить, открывать папки, смотреть страницы...
пытаюсь из программы вызвать топик, который есть в основном файле - без проблем.
как только указываю топик вложенного проекта (точно знаю, что он там есть!) -
ошибка, нет такого индекса. пробовал по-разному указывать в основном проекте
Merge method для хтмл-хелпа (Modular Help Options), подставлял разные Table of contents,
руками прописывал секции алиас и мап в расширенных установках .hhp - не помогло...
самое интересное, что если оставить временные файлы и потом скомпилить их например,
хепваровским ФАРом то можно собрать готовый проект, в котором все работает.
если декомпилировать потом основной файл, то в нем присутсвуют невидимые топики, со страницами из вложенных файлов.
такая вот штука...

mickolam2004

Правильно ли я понял? У тебя не получается вызвать из программы топик, который принадлежит дочернему проекту?
Мне кажется тут вот в чем дело. Вот смотри опять цитату из файла помощи к программе:

Недостатки слияния проектов во время компиляции

· Так как все разделы находятся в одном справочном файле, Вы должны заботиться, чтобы все ID раздела были уникальны! То же самое и для номеров! контекстной справки.
...

Из программы топик вызывается по его номеру контекста. Но когда ты компилируешь, то при совпадении номеров основного и дочернего проекта, Хелп и Мануал сам меняет этот номер у дочернего автоматически. Вот и получается, что программа видит один проект, а второй нет.

Это моя версия, может я и не прав.

Добавлено:
mickolam2004
К слову, забыл спросить: как насчет моей проблемы? У тебя не бывает таких ошибок, при декомпиляции оригинала. (Речь про ошибки в ID топиков.)
Например, вместо ID раздела select_background_image_dialog_ после декомпиляции получается select_background_image_dialog1. Добавляет, собака, единицу в конце вместо прочерка.
Если у тебя такого нет, то скажи свою версию Хелп&Мануала, и где ее брал...

ershiki

нет. все топики уникальны - ручаюсь. РТФМ читал...
я делал тестовый проект для выяснения проблемы
и тестовую прогу которая пыталась по индексу перейти на страницу.
мне кажется, что в Н&М не реализована ПРАВИЛЬНО данная фича
или я все-таки что-то делаю неправильно при описании проекта...
по-идее я бы мог включить в основной файл свой контекст, который бы
содержал ссылки на дочерние файлы, но при импорте ссылки на не существующие топики
просто игнорируются или по-другому: я бы мог добавить невидимый топик,
со ссылкой на страницу дочернего, но опять же индекс нельзя указать для этой страницы
(задизеблено!). в общем куда ни ткнись... везде нет доступа.
---
декомпиляцией я не так часто занимался, только если требовалась
реанимация старых хелпов без исходников... но и при этом глюков предостаточно.
например: линк, растянутый на весь раздел, или имя картинки длиной в 100 символов...
единичку добавляет скорей всего, если есть два линка на одну и ту же картинку
или имя картинок совпадает для разных страниц. как-то так...
---
версия последняя "стандартная" на р-боарде взятая: 866

У меня идеи закончились... Но в твоем случае, судя по всему, это таки очередной баг! компилятора. Потому что в настройках проекта особо настраивать то и нечего...
Извини, что не помог.
Интересно, чего-йто наши профи молчат?

а у меня вот такой вопрос:
есть готовый проект созданный в HTML Help Workshop
стоит задача сделать pdf версию справки
перегнал его в Help & Manual, но встала проблема:
используются ссылки из топиков в середины страницы с помощью якорей, при этом получается, что при сборке pdf страница копируется столько раз, сколько на нее ссылок.
при этом, если собрать chm версию, все нормально
посмотрел их примеры - они на каждый линк делают новую страницу.
переделать так мой проект сложно
как это побороть?

Зугруженый chm с сетевого ресурса, в названии каталога содержится символ # или кирилица - пишет "Невозможно отобразить страницу". Это только у меня такое?

JbBaD Когда-то писал

Цитата:

Помогите решить проблему...
Запускаю H&M (4.03), создаю проект из стандартного темплэйта, ничег не меняя компилирую в CHM. При компиляции выдает ошибку HHC5007: Error: Fatal navigational compilation error.
А при запуске вышеуказанного CHM вылазит "The window name "main" passed to HH_GET_WIN_TYPE has not been specified" и запускается.

Что делать?

Как это решалось? Ни кто не знает ответ?

Добавлено:
Разобрался: Это случилось в результате подмены библиотек компилятора, когда устанавливался "Генератор CHM 1.2.0.20" Скада-Софт (о чем они честно предупреждают в информационном окне: «Включает HTML Help Compiller»). Причем в последующем установка HTML Help родным инсталлятором от MS не решает эту проблему. Приходится все делать руками.

Будьте осторожны.

Добрый день всем!
Пишу "универсальный" хелп - т. е., чтобы можно было его оформить одинаково красиво и в электронный вариант и в печатный. Задача не из простых. Столкнулась с тем, что не могу найти, где задать параметры для локальных ссылок для печатного варианта, чтобы по topic-ID в результате выводились номера страниц или номера разделов.
Помогите, пожалуйста.
H&M вообще такое умеет?

magrit

1. При печати из H&M в диалоговом окне "Предварительный просмотр..." и "Печать руководства..." есть опция "Ссылки со ссылающейся страницей (если доступно)"
2. При формировании PDF-файла в «свойствах проекта…», раздел "PDF", "PDF layout" имеется опция "вставить страницу ссылок (значки страницы с номерами страниц)"

Я правильно понял проблему?

Такая проблема, в самих CHM всё отображается нормально, всё настроил,
а вот названия файлов пишутся кракозябрами(декомпилировал с помощью плагина CHMview в TC), причём все работает отлично, переходит по ссылкам и так далее.

Проблема с H&M версии 4.15

При подготовке документации некоторые ссылки преобразовываются в звёздочки при переключении между разделами. Т.е. есть текст ссылки "ЛКМ", переключаюсь туда-обратно - вместо ЛКМ появляется
[****]

Причём это не отображение, а именно символы - они же есть в XML сырцах, и естественно в компилированном CHM. Условия при которых это появляется не могу отследить, т.к. в другом месте такая же ссылка живёт без проблем.
Одно условие обнаружено: все символы текста ссылки должны быть заглавными кириллическими. Тогда глюк почти гарантирован.

Sergey1970

Спасибо.

Цитата:

При подготовке документации некоторые ссылки преобразовываются в звёздочки [****]

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


А вот есть ещё проблема при генерации HLP: компилятор hcrtf.exe пишет в лог:

HC4011: Warning:
There are 20 opening braces without intervening closing braces.
HC4002: Warning:
The RTF file C:\Working\~tmphlp\TRANSYT-7F.rtf is corrupted at offset 8561728.
HC3025: Warning: topic #106 of C:\Working\~tmphlp\TRANSYT-7F.rtf :
Jump to undefined Topic ID: "Calibration".
... и т.п. перечисляет кучу отсутствующих топиков, которые на самом деле есть и в HnM интерфейсе и в rtf файле даже. Но кучу топиков не включает в результат такие вот глюки

Тестировал на машинах с MS Word2000 и 2003 - реакция одинаковая. А то я подозревал программную несовместимость (типа hcrtf компилятор устарел уже...) - ан нет, дело в другом: Word-ы открывали rtf нормально.

CHM файл генерирует на ура (по крайней мере не последняя версия v4.1.5.906 - с последней хуже), так что простая невнимательность при вёрстке исключена.

Из-за чего это может быть?

Добавлено:

Цитата:

проблема при генерации HLP: ... кучу топиков не включает в результат такие вот глюки

Кажеться, нашёл решение: надо
- сказать HnM генери мне HLP, но не удаляй "временные файлы"
- зайти во временные файлы, открыть rtf в Word - и пересохранить его заново в rtf - получиться файл раза в два меньше! Явно - более "прямой".
- после этого, вручную, через hpj файл компилируем - компилируется нормально.

p.s. Блин! Почитал я эту тему и у меня создалось впечатление, что Help and Manual нас методично "натягивает": этот инструмент имеет очень востребованную функциональность, но реализация сильно глючная - как у первых Windows... простите, что не в тему

Celeron


Цитата:

и у меня создалось впечатление,

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

Подскажите, какая версия Help&Manual надежнее - 3.6 или 4.2,
для создания CHM файлов с ссылками, содержащими русские символы?

в 4.2 больше фич, работать ЗНАЧИТЕЛЬНО удобнее, но только последняя версия. Что значит ссылки, содержащие русские буквы? Имеется ввиду TOPIC_ID? Тогда, чем быстрее избавитесь от русских букв, тем лучше. Дело даже не H&M а в компиляторе, который на дух русский не переносит. Кстати, e-book куда милостивие! Если вопрос по отображаемому тексту, например "см. ссылку", то по-фиг. И тот и другой нормально это делают.

Подскажите пожалуйста!
В ворде есть функция вставки колонтитула. Есть ли чтото подобное в Help & Manua? Как этим пользоваться?

Подскажите пожалуйста что делать с глюками после компиляции?
1. Не отображаються 2 ссылки
2. 1 топик отображен частично
3. Тон рисунка не совпадает с фоном заголовка в колонтитуле
(по всему документу)

Попытки устранения ошибок
1. Ссылки переделывались заново тремя способами (Copy-Paste, "Перетягивание", Insert Hyperlink)
2. Изначально подраздел документы был сделан в Невидимых топиках, с целью устранения ошибки раздел Документы был перенесен в контекстное дерево, ссылки были переделаны заново но ошибка не устранилас.
3. Место ссылки менялось - результат оставил желать лучшего.
4. Что касаеться цвета - в некомпелированом документе фон рисунка полностью совпадает с фоном колонтитула. Изменеия цвета для меня загадочны.
5. То же касаеться и частичного отображения последнего топика.

С топиками ID в Tpic options все в порядке

Идеи по устранению ошибок кончилис...

В голову приходит только следующее. 1. Рисунок - проверить размеры. имеется ввиду, что H&M может сам "оптимально" с его точки зрения менять размеры рисунка. Это может давать кривизну при компиляции. (Хотя сама не сталкивалась с подобным).
В топиках, на которы ссылки тип окна какой?

Цитата:

Подскажите пожалуйста что делать с глюками после компиляции?
1. Не отображаються 2 ссылки

Попробуй переименовать текст ссылки. Не адрес, куда ссылаться, а именной текст. Например возьми в кавычки. У меня был глюк, когда H&M портил ссылок (см. выше я писал), если текст - абривиатура, т.е. несколько заглавных букв, причём только некоторые сочетания :-\


Цитата:

2. 1 топик отображен частично

Подобное у меня тоже бывало, даже бывало, что некоторые топики вообще не отображены или форматирование топика безнадёжно портилось. Полагаю глюк в алгоритме генерации source для компилятора. Шаманить можно по разному - в зависимости от случая.
Следует помнить, что у H&M запросто может не найтись настроек, которые можно покрутить и проблема может оказаться нерешаемой или решаемой через ж... Во что компилируешь? Если HLP, то смотри выше.


Цитата:

3. Тон рисунка не совпадает с фоном заголовка в колонтитуле (по всему документу)

Я бы и тут попробовал не удалять "временные файлы" которые генерирует H&M - посмотрел бы там, чем стал твой рисунок, заменил если надо оригинальным или подфиксеным и вручную докомпилировал. И так при каждой компиляции. (ну или только при финальной компиляции)

Возможно ли в этой программе создать e-book (или др.) с привязкой серийного номера к железу компьютера?

Цитата:

с привязкой серийного номера к железу компьютера?

а это как ? .hlp, .chm или .pdf со встроенной программой внутри ?

Цитата:

ShamaNВозможно ли в этой программе создать e-book (или др.) с привязкой серийного номера к железу компьютера?

Нельзя. Привязка к железу - это весьма сложная функция. Для этого нужно использовать что-то спецаильно заточенное под это. HLP, CHM или HTML явно не подходят для этого.

mickolam2004
ну вообще-то прога может и e-book-и делать...

Цитата:

прога может и e-book-и делать

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

в pdf пароль можно указать (не знаю НиМ может ли?),
но привязать его к компу... не слышал про такое.

Никогда не писал справки, а тут потребовалось... И сразу же прблема... При компиляции *.chm появляется сообщение "Cannot display report file *.~html. Сам *.chm файл создается, но когда его запускаю, то "Невозможно отобразить страницу". А когда его заархивировал RAR-ом, и запускаю из архива, то все нормально. И еще, пример из H&M запускается на ура, никаких различий в опциях примера и моего проекта вроде нет.
Может что нибудь посоветуете новичку в H&M?

Цитата:

"Cannot display report file *.~html

Что это за название файла, то с тильдой? Это явно временный файл, который генерируется как промежуточный, а в chm не должен зашиваться. Это же просто глюки H&M попробуй компилировать в другой программе. H&M хорош для вёрстки, а при компиляции - много глюков (тут ранее обсуждалось).

Цитата:

А когда его заархивировал RAR-ом, и запускаю из архива, то все нормально.

Возможно, это потому, что из архива запускается - временно разархивировавшись в твой Temp folder, в котором могут также остаться некоторые файлы после H&M. Короче - не смотри на RAR - это не поможет. А смотри на опции компиляции H&M и другой компилятор.

Другой компилятор - это в смысле тот же стандартный "HTML Help workshop", который и используется H&M, но запускать его вручную - тогда и баги есть возможность править вручную.

Ключевой момент: как достать из H&M, чтобы потом скомпилировать CHM? А ты "не удаляй временный файлов" при компиляции в H&M - это и есть подготовленные файлы, которые отдаются компилятору. Их можно затем вручную пофиксить и вручную скомпилить.

Shvg

Цитата:

Сам *.chm файл создается, но когда его запускаю, то "Невозможно отобразить страницу".

Читай здесь http://helpman.it-authoring.com/viewtopic.php?t=3364.
Вкратце: Обновление Microsoft 896358 для WinXP, в Windows Vista по умолчанию не
позволяет открывать CHM-справки с сетевых дисков.
Надо добавить ключ в реестр:
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\HTMLHelp\1.x\ItssRestrictions]
"UrlAllowList"="file://путь chm-файла"

добрый день! надеюсь тема еще жива )
возник вопрос по работе с h&m версия 4.1.5 build 906

скомпиленный файл *.chm на машине разработчика открывается без пробелм
файл выложен в общий доступ
при попытке открыть файл удаленно слетают все кодировки, после восстановления кодировок при открытии слева полностью отображается дерево разделов, но! вообще не отображается ни одна страница с текстом вообще!!!!

пишет "Action canceled Internet Explorer was unable to link to the Web page you requested. The page might be temporarily unavailable."

затем при попытке посмотреть содержание других вкладок пишет "The page cannot be displayed The page you are looking for is currently unavailable. The Web site might be experiencing technical difficulties, or you may need to adjust your browser settings. "

причем исходники лежат в одной папке как в общем доступе, так и у разработчика

та же штука происходит если открывать файл через сеть с машины разработчика...

в чем причина? и как это можно исправить! мозг сломан (