Innovasys是一家成立于1997年的文檔和幫助創(chuàng)作工具提供商，致力于使廣大開發(fā)人員和技術(shù)方面的作家能夠生成專業(yè)質(zhì)量的文檔、幫助系統(tǒng)和程序。本系列教程主要討論Innovasys的實(shí)用性提示與技巧，有任何建議或提示請(qǐng)?jiān)谙路皆u(píng)論區(qū)留言，我們會(huì)及時(shí)處理。

點(diǎn)擊下載最新版Document! X v2019.1

點(diǎn)擊下載最新版HelpStudiov2019.1

    本主題包含有關(guān)Microsoft Help Viewer的信息，該幫助系統(tǒng)是Visual Studio 2010以上的幫助系統(tǒng)。Microsoft Help Viewer只能用于創(chuàng)建與Visual Studio幫助系統(tǒng)集成的幫助材料，不適用于通用幫助系統(tǒng)。    

    如果要將多個(gè)不同的幫助系統(tǒng)部署為單個(gè)產(chǎn)品的一部分，您可能希望創(chuàng)建一個(gè)父項(xiàng)目，包括登錄頁(yè)面或其他一些傘形主題，以便為用戶提供方便的鏈接鏈接到不同的幫助系統(tǒng)。在Microsoft Help Viewer中，可以通過在子幫助系統(tǒng)中的根主題上設(shè)置TocParentId來標(biāo)識(shí)公共父主題，并使用特定的Microsoft Help Viewer鏈接格式從父主題鏈接到子幫助系統(tǒng)中的主題來實(shí)現(xiàn)。 。    

創(chuàng)建父項(xiàng)目

    父項(xiàng)目要包含在Microsoft Help Viewer目錄的根目錄中顯示的主題。編寫所需主題，并使用目錄編輯器組織所需層次結(jié)構(gòu)中的主題。   

    在此示例中，組件文檔主的題是我們希望子項(xiàng)目中主題出現(xiàn)的位置。這可以是項(xiàng)目中的任何主題，這個(gè)由您決定哪個(gè)主題在您的方案中會(huì)比較有意義。

    為了將子項(xiàng)目中的主題連接到父項(xiàng)目主題，我們將需要組件文檔主題的主題ID。我們可以通過構(gòu)建項(xiàng)目，在生成的輸出中打開該主題，右鍵單擊內(nèi)容并從幫助查看器上下文菜單中選擇查看源來實(shí)現(xiàn)此目的。在顯示的源中，您可以在Microsoft.Help.Id元標(biāo)記中找到主題ID，例如 ： 

    主題是content屬性中的值 - 在此示例中為53468d8a-a886-482e-8bce-90c32091a564。

配置子項(xiàng)目

    現(xiàn)在，您需要設(shè)置子項(xiàng)目中每個(gè)根主題的TocParentId屬性，設(shè)置為您希望它們顯示在Microsoft幫助查看器目錄下面父項(xiàng)目中主題的主題ID。您可以通過在Project Explorer中選擇Topic來設(shè)置此屬性 - 然后在Properties窗口中顯示屬性。如果您有多個(gè)與同一TocParentId關(guān)聯(lián)的主題，則可以將TocOrdinal設(shè)置為將用于對(duì)子主題進(jìn)行排序的數(shù)字。   

    注意：僅當(dāng)您將構(gòu)建配置文件配置為生成Microsoft Help Viewer輸出時(shí)（在構(gòu)建配置文件編輯器中的格式頁(yè)面上），才會(huì)顯示這些屬性。    

    為了保持結(jié)構(gòu)簡(jiǎn)單，并避免在目錄中混淆，您可能需要在子幫助系統(tǒng)中創(chuàng)建單個(gè)根主題，在該主題下可以包含所有其他主題。這也將簡(jiǎn)化配置 - 您只需要在該單個(gè)根節(jié)點(diǎn)上設(shè)置TocParentId即可。    

建立兩個(gè)項(xiàng)目

    您現(xiàn)在應(yīng)該構(gòu)建這兩個(gè)項(xiàng)目，并在Microsoft Help Viewer中檢查布局是否符合要求。

父與子主題之間的鏈接

    您可以使用主題ID在父與子主題之間創(chuàng)建鏈接。

    注意：通過在Microsoft Help Viewer中查看主題，右鍵單擊內(nèi)容并從幫助查看器菜單中選擇查看源，可以在生成的輸出中找到給定主題的主題ID。在顯示的源中，您可以在Microsoft.Help.Id元標(biāo)記的content屬性中找到主題ID。

    例如，您可以在父項(xiàng)目中的主題內(nèi)創(chuàng)建指向子項(xiàng)目中主題的鏈接。您可以通過在鏈接到網(wǎng)頁(yè)或其他Internet URL頁(yè)面上的鏈接設(shè)計(jì)器中鍵入Microsoft Help Viewer特定的鏈接格式來完成此操作。  

    鏈接格式為：ms-xhelp：///？method = page＆id = [target_topic_id] ，其中[target_topic_id]是您要鏈接到的主題的主題ID。

    您可以通過這種方式在Parent>Child、Child>Parent或者不同的Child項(xiàng)目中創(chuàng)建鏈接。

示例項(xiàng)目

  ;  下載父項(xiàng)目和子項(xiàng)目的示例，該項(xiàng)目說明了本主題中描述的模塊化Microsoft Help Viewer幫助的技術(shù)。以下是示例圖片：

項(xiàng)目示例：mshv modular

    關(guān)注慧聚IT微信公眾號(hào) ???，了解產(chǎn)品的最新動(dòng)態(tài)及最新資訊。