Първоначално в http://kb.helpwaregroup.com/ms-html-help/merge. Отиди на главната страница.

HTML Помощ - Използване на сливане

Преглед

Този документ ще ви помогне да получите слетите CHM файлове на труд.

Много благодаря на Müller-Hillebrand в Германия за това тя да заработи, когато всички останали не можех. Също така на Кейт Pearson в Varian Австралия за текстообработка Smithing.

Модулни помощ ползи

  •          Големи помощни системи, могат да бъдат разделени на по-малки под-системи, докато все още се представя една единствена система за помощ на потребителя.
  •          Слято помощ е “интелигентна”. Само тези модули, инсталирани ще покажат в прозореца за помощ.


Модулни помощ проблеми

 

  •          Cross модул хипер-връзки се нуждаят от специално форматиране.
  •          HH 1.2 не сливане елементите на раздела Favorites.
  •          Bookmarks в ТОС не работят (да се надяваме, определен в HH 1.3x).

Демонстрация проекта

     Следната демо проекта ще бъде използвана, за да илюстрира как CHM файлове могат да се слеят. Проектът демо се състои от следното:

1x магистър CHM файл (Master.chm)
2x Slave CHM файлове (SiteA.chm & SiteB.chm).

Когато отворите демо проект, трябва да видите следното:

 

  •          Ако отворите някоя CHM вие ще получите едно и също нещо, единна система за помощ с общ TOC, индекс и търсене
  •          SiteB е конфигуриран да покаже SiteB ТОС по подразбиране. Вторият определение прозорец се използва за показване на пълен ТОС.
  •          Всеки модул има различен заглавието на прозореца. В крайна проекта вие вероятно ще искате да направите всички заглавия същото, така че потребителят е наясно, че те са с помощта на модулна система за помощ.


1.  Изтеглете демо (http://helpware.net/htmlhelp/merge.zip)проекта(http://helpware.net/htmlhelp/merge.zip) (код за тази демонстрация).

2. Изтегляне(http://helpware.net/htmlhelp/merge_chapter.zip) нататъшни демонстрации (Друг пример: код и документация).

 

Стъпка 1 - магистър таблица на съдържанието (TOC)

 

Нека приемем, че имаме три модула, всеки със своя собствена таблица на съдържанието (.HHC) файл. Първата стъпка е да се обединят всички на “роб” .HHC файловете в “магистър” .HHC файл (Ние призоваваме Учителя модул, модул на другите се сливат).

Инструкции:
Етап :
Отворете Master.HHC (майсторски съдържанието на файла) чрез двойно щракване в Explorer. Това ще отвори HH Workshop и ви позволяват да редактирате Master.HHC.

Стъпка :
Кликнете с десния бутон върху елемент от TOC и изберете “Insert File”. Въведете съдържанието Sitea файла като SiteA.CHM :: \ SiteA.HHC“.

Стъпка :
Повторете стъпка 1b, този път се добавя съдържанието SiteB файла “SiteB.CHM :: \ SiteB.HHC“.

Това е главната ТОС направено. Роби HHC файлове не изискват специални промени.

 

Стъпка 2 - [MERGE FILES] изявление


Отворете Master.HHP проектен файл и добавете [MERGE FILES] раздел, съдържащ имената на всички други файлове CHM (не добавяйте проектите собствен CHM файл).

Инструкции:
Стъпка :
Отворете Master.HHP в работилница. Отворете Опции проектадиалоговия прозорец и изберете Обединяване на файлове” в раздела страница. С помощта на бутона “Добави”, добави Sitea и SiteB CHM файлове към списъка. Не добавяйте магистър CHM.

Ако искате SiteA.CHM и SiteB.CHM да отворите същата като Master.CHM преминете към Стъпка 2б.

Стъпка :
Повторете стъпка за всички модули. Отново се уверете, че не включват проекти собствен CHM в свой ​​собствен списък сливане.

 

Сега 3 HHP файловете на проекта трябва всички да съдържат препратка към всеки от CHM файлове другата проекта.

<Master.HHP>
[MERGE FILES] SiteA.CHM
SiteB.CHM

<SiteA.HHP>
[MERGE FILES] Master.CHM
SiteB.CHM

<SiteB.HHP>
[MERGE FILES] Master.CHM
SiteA.CHM

Стъпка 3 - Slave Windows Определения


Ако искате SiteA.CHM и SiteB.CHM да се отваря с една и съща ТОС като Master.CHM след това са необходими тези допълнителни стъпки.

Master.HHP е ясна и има следното определение прозорец:
[WINDOWS] TP = Master.HHC“, “Master.HHK“, “Master.htm” ….

За да бъде роб използвате майстор HHC таблица на съдържанието, които използваме следния синтаксис:

masterCHM :: \ masterHHC“.

Сайт A

Ние дадохме Сайт A, два прозореца дефиниции. Използвайте TP =” да използва капитана CHM ТОС. Използвайте TP2 =” дефиниция да се използва SiteA.HHC ТОС.

Можете да създадете колкото много определения прозорец, както се изисква.

<SiteA.HHP>

[WINDOWS] TP=,”Master.CHM::\Master.HHC”, “SiteA.HHK”,”index_a.htm”….

TP2=,”SiteA.HHC”,”SiteA.HHK”, “index_a.htm”,”index_a.htm”….

 

Сайт B

Определението на SiteB TP” прозорец показва SiteB ТОС. За да видите майстор ТОС за SiteB използвате “TP2″ дефиниция прозорец.

Забележка: .HHP файла “Default Прозореца = TP” определя дефиницията на прозорец, за да се използва, когато CHM е отворена.

<SiteB.HHP>

[WINDOWS] TP=,”SiteB.HHC”, “SiteB.HHK”, “Index_B.htm”….

TP2=,”Master.CHM::\Master.HHC”, “SiteB.HHK”, “index_b.htm”….

Обобщавайки


Помнете три стъпки.

Файлът Master.HHC TOC трябва да включва” всички други файлове HHC.

Master.HHP трябва да има [Merge Files] раздел, изброяващ всички други
CHMs. Това обединява всички Index (.HHK) и FTS (търсене в пълен текст) по време на изпълнение.

По желание, всеки роб проект .HHP също може да има [Merge Files] раздел, изброяващ всички други
CHMs. Това прави роб имат същия индекс и FTS като Учителя.

Ако искате капитана и роби, за да се покаже общ TOC, тогава всеки роб .HHP прозорец определение следва позоваване на Master.HHC съхранява във файла Master.CHM:

TP = masterCHM :: \ masterHHC“, “my.HHK“, “myHomePage.htm” ….

Стъпка 4?

Q. В обединената система за помощ, може да прилагането отворите тема в модул роб чрез главния CHM?

A. Не, ти трябва да се уточни модул, който съдържа по темата.
EG. slaveA.chm :: / slaveA_topic.htm“.
Следващият няма да работят. master.chm :: / slaveA_topic.htm“.

Да, ако използвате контекстни помощ документи за самоличност.
$ Global_

Q: Как мога да принуди всички модули, за да се отвори в един прозорец?

 A. Prefix всички имена дефиниране на прозорци с “$ global_“.
В примерите по-горе, ние ще използва “$ global_TPне TP”.

Това е, което казва Ралф Walden от KeyWorks за “$ global_“.
http://keyworks.helpmvp.com/home/keyhh

<<<
Поради начина, HTML Помощ 1.2 дръжки неназовани видове прозорци, все още можете да получите множество прозорци, когато е инсталиран HTML Помощ 1.2, особено когато се работи с множество помощни системи (например, слива CHM файлове). За да разрешите този проблем, обяви прозоречен тип, чието име започва с представка “$ global_” във всеки файл CHM. Например:

file1.chm :: / file1topic1.htm> $ global_task
file2.chm :: / file2topic1.htm> $ global_task

$ Global_ Представката на разказва HTM LHelp, че типът на прозореца може да се използва от всеки файл CHM веднъж първоначалния тип прозорец е отворен.

 

Други съвети и трикове

     Общи съвети

 

  •          Всички CHM файлове трябва да бъдат инсталирани в същата папка.
  •          Можете да инсталирате, трябва винаги да се инсталира на произволен брой Slave CHMs но магистър CHM, ако искате робите да се обръщат към капитана таблица на съдържанието.
  •          Всеки проект трябва да се даде възможност на Binary Index”, за индекса сливане, за да работят.

         - A двоичен форум няма да бъдат създадени, ако сте избрали 1.0 като версия в> раздела Compiler> диалоговия прозорец Опции на проекта от кутия за съвместимост или ако Създаване на двоичен индекс квадратче се изчиства.
         - Също така Rick Stone ми напомни, че индексът на Учителя трябва да съдържа най-малко един индекс мандат, за да може сливане, за да работят.

  •          По същия начин Binary TOC” трябва да се _disabled_ друго сливане няма да работи.
  •          Включи HHC работи рекурсивно, така че може да има групи от допълнителни модули. Т.Е. HHC файлове, включително HHC файлове, които включват други файлове HHC и така нататък.
  •          Сливането на индекса и Alink ключови думи. Това се извикани работи рекурсивно, защото те не знаят за включванията TOC. Ако искате да има единна индекс или напречно модул ALinks, което трябва да кажа, всеки CHM файл, който други биха могли да бъдат на разположение, принадлежащи към един и същ проект. Отново: Да извикани сливане себе си.
  •          Друга идея: Ако имате еднакви ключови думи от няколко файла, HTML Помощ използва <заглавие> таговете в списъка на целите. Ние предоставяме заглавието на всяка тема със заглавието на самия модул (“Книга“), което води до: <заглавие> Тази глоба в заглавието (Тази глоба заглавие на книга) </ заглавие>.
  •          An включва изявление в HHC файл може информирайте за самостоятелен HHC файл. Файлът HHC трябва да бъдат поставени в същата папка като файловете CHM.

 

Обвързването между модулите

 

Прости Връзки

Използвайте връзката котва за прости интер-модулни връзки.

Пример: Link Текст

Съвет: IE3 разработчиците трябва да използват “MK:MSITStore:” префикс

Този метод е ОК, ако определено е инсталиран на CHM, обаче не могат да бъдат инсталирани някои модули на обединената система за помощ.

 

ALinks

Присвояване идентификатор за всяка тема в помощната ви система и да се свърже с темата, използвайки, че идентификатор. Ако има повече от една тема акции същия идентификатор тогава връзката ще покаже списък скок. Истинската сила на ALinks е, че те не изискват от вас да укажете името на файла целевата CHM. Nifty!

Предимства

 

  •      ALinks не трябва да знаят целевата CHM, където темата пребивава.
  •      ALinks да не съдържат текст за превод. Идентификаторът е невидим за потребителя.
  •      ALinks могат да бъдат направени да изпълнява като нормален препратка.
  •      Създаване на динамични Вижте също скочи списъци. Само инсталираните модули ще допринесат за скок списъка.
  •      Може покаже алтернатива тема, ако не се установи, че основната връзка.


Недостатъци

 

  •      A болка за настройка. Всяка целева тема изисква специален код.
  •      В големите системи за помощ, ако целта CHM не е уточнена, тогава може да има малко забавяне, докато помощ-търсено съвпадение теми.


Обобщавайки: Използвайте ALinks да се справят Погледнете също скочи списъци. За единични връзки, където целта CHM е известно, използват Свързани теми (виж по-долу), които изискват по-просто кодиране.

 

ALinks наставник

 

1 За да настроите целевата темата

 

  1. Отвори целевата HTML документ в Workshop.
  2. Позиционирайте курсора на мястото, където искате да вмъкнете кода.
  3. Изберете “Edit> Compiler Информация” от главното меню.
  4. Изберете “Alink Namesтаб страница от “Compiler Информациядиалоговия прозорец.
  5. Щракнете върху бутона Добавяне и въведете уникален текст ID за тази тема. Пример: my_topic_id”.
  6. Кликнете OK и OK, за да приемете тези промени.


Следният код се вмъква в документа

<Object тип = “молба / X-oleobject” тип = CLSID: 1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e”>
<име на Парам = “Alink Name” стойност = “my_topic_id”>
</ Обект>

2 За да създадете връзка към темата

 

  1. Отваряне на HTML документ в Workshop.
  2. Позиционирайте курсора на мястото, където искате да вмъкнете кода за връзка.
  3. Изберете “Tags> HTML Помощ Control” от главното меню.
  4. Алтернативно кликнете върху шапката Wizards в лентата с инструменти.
  5. Изберете “Alink Търсенеот падащото меню и въведете уникално име.
  6. EG. my_alink”
  7. Натиснете Next и попълнете останалите полета. Уверете се, че добавите името на Alink ви е определено в стъпка едно.


Следният код се вмъква в документа

<OBJECT id=my_alink type=”application/x-oleobject”
classid=”clsid:adb880a6-d8ff-11cf-9377-00aa003b7a11″
codebase=”hhctrl.ocx#Version=4,73,8252,0″>
<PARAM name=”Command” value=”ALink”>
<PARAM name=”Item1″ value=””>
<PARAM name=”Item2″ value=”my_topic_id”>
</OBJECT>

И накрая, ако сте избрали да се определи връзката бутон след това работата е свършена. Събиране, открит и тествате вашия CHM.

Ако искате да активирате кода от линк след това използвайте
Някои хипертекст тук

Специална забележка:

За пренасочване на потребителя към друга страница, ако връзката не успее след това се добавя следната опция линия, за да по-горе код.

<PARAM name=”Default Topic” value=”filenotfound.htm”>

Този съвет е предоставена от Marta Arriazu<M.Arriazu (AT) Lantek.es>
Слава богу, някой чете документацията.

 

Сродни теми

Не позволявайте на името да ви заблуди. Тези връзки са лесни за код и са идеални за създаване на между-модулни връзки.

Предимства

 

  • Лесна за инсталиране. Няма специални код се изисква в документа цел.
  • Може покаже алтернатива тема, ако не се установи, че основната връзка.
  • Показва HTML Помощ вторични прозорци.
  • В действителност Относителни тема може да бъде единственият начин да се покаже средното прозорец в HH 1.2.
  • Може да се активира от стандартен хипервръзка.
  • За един елемент скача можете да заобиколят нормалните списъка появилото скок.
  • За единична бройка, скача не съществува текст, който да превежда.


Недостатъци

 

  • За множество списъци т скок се изисква превод на текст.


В следващия раздел ще ви покажем как да се кодира свързани теми.

 

Сродни теми наставник

 

Ето как можете да настроите Сродни теми връзка и използване на Workshop. След като знаете какво правите, можете просто да поставите кода във всеки HTML редактор.

1 За да добавите линк

 

  1.          Отваряне на HTML документ в Workshop.
  2.          Позиционирайте курсора на мястото, където искате да вмъкнете кода за връзка.
  3.          Изберете “Tags> HTML Помощ Control” от главното меню.
  4.          Алтернативно кликнете върху шапката Wizards в лентата с инструменти.
  5.          Изберете “Сродни теми” от падащото меню и въведете уникално име.
  6.          Пример: my_link”
  7.          Натиснете Next и махнете отметката от опции, за да използвате изскачащи списъци и диалози
  8.          Кликнете Next. Ако сте с помощта на линк бутон след това въведете текста на бутон и щракнете върху Next отново.


От страницата за добавяне / редактиране на връзки. Натиснете тук, за да добавите, за да отворите Добавяне / Редактиране Сродни темидиалогов прозорец.

 

  1.          Въведете произволно заглавие текст. Той никога няма да се види, тъй като ние сме само влизане в една връзка и да имат увреждания скок изскачащи прозорци и диалогови прозорци (по-горе).
  2.          Въведете File / URL
  3.          Пример: SiteA.chm :: / index.htm
  4.          Въведете Alternate URL и натиснете OK, за да приемете промените.
  5.          Пример: CHMFileNotFound.htm”
  6.          Ако искате да покажете темата във вторичен прозорец след това въведете името на прозореца. Забележка: Определението на прозореца трябва да бъде създаден в целта CHM не викащия CHM. Натиснете Next и Finish.


Следният код се вмъква в документа

<OBJECT id=mylink type=”application/x-oleobject”
classid=”clsid:adb880a6-d8ff-11cf-9377-00aa003b7a11″
codebase=”hhctrl.ocx#Version=4,73,8252,0″ width=100 height=100>
<PARAM name=”Command” value=”Related Topics”>
<PARAM name=”Button” value=”Text:Relative Topic Jump”>
<PARAM name=”Item1″ value=”This text never seen;SiteA.chm::/Index.htm;CHMFileNotFound.htm”>
</OBJECT>

8-Декември-2005:

Премахнато MS-му: или MK:MSITStore: префикс. Това причинява изскачащи грешка в по-новите версии на HTML Help. Ето стария код:

<PARAM name=”Item1″ value=”This text never seen;ms-its:master.chm::/topic.htm”>

2.-накрая, ако сте избрали да се определи връзката бутон след това работата е свършена. Събиране, открит и тества CHM.

Ако файлът целевата CHM не е инсталирана помощната система ще покаже Alternate файла “CHMFileNotFound.htm”, където можете да кажете на потребителя как да инсталирате допълнителна помощ модула.

Ако искате да активирате кода от нормална употреба хипер връзка
Някои хипертекст тук

 

 

Обединяване и контекстното помощ идентификатори


Ние всички знаем, как да се създаде нашите проекти за контекст изисква от основното приложение (виж how_to_context.htm). Хората са склонни да се отлепва с обединени системи за помощ. т.е.. Как заявление направи контекст разговор на тема, роб макар капитанът CHM.

Следните примери показват контекст картографиране информация от файл магистър .HHP.

Лошо решения # 1:

Това ще се провали. Системата предполага, че темата е в текущата CHM (магистър).
[Псевдоним] IDH_MyTopic = slave1_topic.htm

[Карта] #define IDH_MyTopic 1000

Решение # 1:

The ULR съдържа пълния път към темата роб. Тъй като последното критична актуализация (hhctrl.ocx 5.2.3735.x), ние открихме, че индексите не сливане с помощта на тази техника. Само главния индекс показва в раздела индекс навигация страница.

Така че това е едно добро решение, ако не използвате раздела индекс. Също Marc исляма (MSFT) посочва, че трябва да използвате $ Global_ ако искате TOC автоматичното синхронизиране да работи коректно.
[Псевдоним] IDH_MyTopic = MS-му: SlaveA.chm :: / slave1_topic.htm

[Карта] #define IDH_MyTopic1000

Решение # 2:

Тази странна URL формат фиксирана нашата TOC проблем автоматичното синхронизиране за известно време. Въпреки това, тъй като последната критична актуализация (hhctrl.ocx 5.2.3735.x) TOC автоматичното синхронизиране е напълно разбити, дори когато се използва $ Global_. Последните тестове от различни автори показват също така, че някои ден Индекса слива правилно и някои дни тя не - Ние не може да обясни това несъответствие в резултатите. Така че остана с Solution # 1, ако вие нямате индекс.
[Псевдоним] IDH_MyTopic = MS-му: master.chm :: / SlaveA.chm :: / slave1_topic.htm

[Карта] #define IDH_MyTopic1000

Решение # 3:

Можете да конфигурирате всеки роб CHM да използвате главната ТОС и се сливат с всички други CHMs (Показахме това в Стъпка 3 на проекта Демонстрация-горе). По този начин всеки Slave когато отвори директно ще има същото съдържание като Учителя. Дефиниране на всички ваши SLAVE1 преобразувания в SLAVE1 .HHP и отворен SLAVE1 CHM, когато правите връзка повикване към темата SLAVE1. Проблемът с този подход е вашата кандидатура ще трябва да се справят с няколко CHMs Вместо да направи връзка призовава макар една-единствена CHM (магистър). Също така информация като любими и размера и позицията прозорец не се сливат. Тази информация се записва под името на файла CHM.

Решение # 4:

1-Ян-2003: Най-накрая някои решения, които работят.

Context документи за самоличност в Обединения Помощ

 

Известни бъгове

 

1. HH 1.2 не сливане елементите на раздела Favorites.
2. Слято помощ HHC и HHK предмети, съдържащи Bookmarks не работят.

Изглежда, че има проблем със свързването от HHC и HHK елементи, които съдържат маркери (в слетите помощни системи). Връзки от ТОС и разделите Индекс ще отворите файла в прозореца за дясна ръка, но не ще скочи до определен маркер.

Аз всъщност нямам проблеми с раздела Index “толкова дълго, тъй като не е нужно пространства в името на отметка”. Други казват, че всичко е ОК при отваряне на CHM, съдържащи маркери, но ако други модули
се отвори след това връзките се провалят.

Надяваме се фиксира в HH 1.21
3 RoboHelp създава лоши HHC и HHK файлове. Уверете се, че вашата HHC и HHK има правилни хедъри. По-ранните версии, които се съдържат само информация възел.

Може или не може да бъде проблем.
4. Window дефиниции

Лета Herman получавах грешки, когато тя е кликнал върху TOC елементи. Открихме, че ако ние отстранени линии обичат
<param name=”WindowName” value=”Main”> от всички HHC и HHK файловете на него помогнаха.
5. Добавяне HHC Включи отчети

Има бъг в HTML помощ Workshop, което прави редактирането на HHC файл много трудно.
Буболечката е това. The включват елементи трябва да бъдат показвани една стъпка надясно.

Пример:

По-долу ще дръпнем включват файл в на ниво TOC 3 вместо TOC ниво 2, както е посочено.

Folder
Folder
Включи CHM :: \ HHC
Folder

Най-големият проблем тук е, че ние не може да включва файлове на ниво TOC 1. Тя просто не работи.

The Fix:

За да получите включва да се покаже на ниво TOC 1 трябва да редактирате HHC в тефтерче и се уверете, че включват твърдение е извън <UL> таг блок.

Пример:

<UL>

</ UL>
сливане информация
<UL>

</ UL>

Можете да използвате инструмента на третата страна, която върши работата правилно.

Пример: FAR HTML

go to the beggining: Спектрограф SOPHIE échelle
 

Leave a Comment