Sdílet prostřednictvím

Přizpůsobení nápovědy k portálu pro správu sady Azure Pack Windows rozšíření

  • Článek

 

Platí pro: Windows Azure Pack

Soubor TOCMapping zodpovídá za vykreslení odkazů levého navigačního podokna. Následující diagram znázorňuje, kde na portálu pro správu Windows sady Azure Pack existuje levé navigační podokno.

Windows Azure Pack Left Navigation Pane

Každý odkaz má kontext, který je obsažen v elementu <sady> v souboru mapování obsahu. Podřízené téma> související s elementem <obsahuje skutečný odkaz na obsah nápovědy a související informace o atributech. Následující příklad XML ukazuje soubor mapování XML pro příponu MySQL.

<?xml version="1.0" encoding="utf-8"?>
<site xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" locale="en-us">
  <set setContextId="mysqlextension.databases" title="mysqlextension.databases">
    <relatedTopic topicContextId="0" title="Change the Password for a MySQL Database" id="jj822102(en-us,azure.100)" />
    <relatedTopic topicContextId="1" title="View MySQL Database Information" id="jj822123(en-us,azure.100)" />
    <relatedTopic topicContextId="2" title="Delete a MySQL Database" id="jj822141(en-us,azure.100)" />
    <relatedTopic topicContextId="3" title="Create a MySQL Database" id="jj822150(en-us,azure.100)" />
    <relatedTopic topicContextId="4" title="Navigate MySQL Databases" id="jj822106(en-us,azure.100)" />
  </set>
</site>

Atributy souvisejícího <tématu> jsou následující:

Atribut

Popis

topicContextId

Pořadové číslo, které jednoznačně identifikuje téma v rámci sady odkazů. Dvě témata v rámci sady nemůžou sdílet stejné témaContextId.

title

Text odkazu zobrazený v levém navigačním podokně portálu pro správu

Id

Toto je název souboru obsahu .xhtml, který se má vykreslit. Pokud je například soubor obsahu myhelp.xhtml, id je "myhelp".

Obsah vykreslené nápovědy je uložený v souborech .xhtml. Rozšíření poskytnutá ve výchozím nastavení Windows instalaci sady Azure Pack poskytují obsah obsahu .xhtml, který lze použít jako vodítko k vytváření vlastního obsahu nápovědy.

Vlastní úkoly nápovědy

  1. Vyhledejte soubor TOCMapping.xml pro levé navigační podokno rozšíření, které chcete aktualizovat. Další informace najdete v tématu Windows přehled vlastní nápovědy sady Azure Pack.

  2. Otevřete TOCMapping.XML v Poznámkový blok a vyhledejte kontext (<sadu>) odkazu, který potřebuje aktualizaci.

  3. Aktualizujte požadovaný <související prvek tématu> sady kontextových <odkazů>.

Jak upravit existující obsah nápovědy pro rozšíření

  1. Vyhledejte soubor TOCMapping.xml. Další informace najdete v tématu Windows přehled vlastní nápovědy sady Azure Pack.

  2. Otevřete TOCMapping.xml v Poznámkový blok a identifikujte kontextové <sady> nápovědy, která obsahuje požadované téma> související s odkazem na nápovědu<.

  3. Identifikujte soubor obsahu nápovědy .xhtml kontrolou atributu ID> souvisejícího <prvku tématu>.<

  4. Upravte a uložte soubor .xhtml a upravte obsah nápovědy.

Přidání nového obsahu nápovědy do rozšíření

  1. Vytvořte obsah nápovědy a uložte ho jako soubor .xhtml do příslušné složky obsahu nápovědy. Obvykle se jedná o stejnou složku jako soubor TOCMapping.xml pro příponu, ale to není zaručené. Informace o vyhledání obsahu nápovědy pro rozšíření najdete v tématu Windows Přehled vlastní nápovědy sady Azure Pack.

  2. Otevřete TOCMapping.xml rozšíření v Poznámkový blok a identifikujte kontextovou <sadu> nápovědy, do které se má přidat nový obsah nápovědy. Informace o vyhledání TOCMapping.xml rozšíření najdete v tématu Windows Přehled vlastní nápovědy sady Azure Pack.

  3. <Přidejte související prvek tématu> do kontextové <sady> nápovědy. Atribut <ID souvisejícítopic> by měl být název souboru obsahu nápovědy vytvořený v prvním kroku bez přípony .xhtml.

Vykreslení obrázků nápovědy

  1. Vytvoření image jako souboru .PNG nebo .GIF

  2. Umístěte obrázek do stejné složky jako soubory nápovědy rozšíření .xhtml. Informace o vyhledání obsahu nápovědy pro rozšíření najdete v tématu Windows Přehled vlastní nápovědy sady Azure Pack.

  3. V souboru nápovědy .xhtml, který obrázek vykresluje, použijte následující formát k odkazování na obrázek ve <značce img> :

    <src="/HelpContent/GetImage/<extensionName>/<FileName>.<extension>" class="mtpsimage" alt="note"  />

    Například <img src="/HelpContent/GetImage/websystemadminextension/jj205510.note(en-us;MSDN.10).gif" class="mtpsimage" alt="note" />

Viz také

vlastní nápověda k rozšíření sady Azure Pack Windows