Dela via

Så här anpassar du Windows hjälpen för azure packhanteringsportalen för ett tillägg

  • Artikel

 

Gäller för: Windows Azure Pack

TOCMapping-filen ansvarar för att återge länkarna i det vänstra navigeringsfönstret. Följande diagram visar var det vänstra navigeringsfönstret finns i Windows Azure Pack-hanteringsportalen.

Windows Azure Pack Left Navigation Pane

Varje länk har en kontext som finns i ett <set-element> i innehållsförteckningsmappningsfilen. Det underordnade elementrelaterade <ämnet> innehåller den faktiska länken till hjälpinnehållet och tillhörande attributinformation. I följande XML-exempel visas XML-mappningsfilen för MySQL-tillägget.

<?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>

Attributen för <relaterat ämne> är följande

Attribut

Beskrivning

topicContextId

Ett sekventiellt tal som unikt identifierar ämnet i uppsättningen länkar. Två ämnen i uppsättningen kan inte dela samma topicContextId.

title

Länktexten som visas i det vänstra navigeringsfönstret i hanteringsportalen.

Id

Det här är namnet på .xhtml-innehållsfilen som ska renderas. Om innehållsfilen till exempel är myhelp.xhtml är ID:t "myhelp".

Det renderade hjälpinnehållet lagras i .xhtml-filer. Tilläggen som tillhandahålls i standardinstallationen Windows Azure Pack tillhandahåller hjälpinnehåll för .xhtml-filer som kan användas som en guide för att skapa ditt eget hjälpinnehåll.

Anpassade hjälpuppgifter

  1. Leta upp TOCMapping.xml-filen för det vänstra navigeringsfönstret för tillägget som du vill uppdatera. Mer information finns i Windows anpassad hjälpöversikt för Azure Pack.

  2. Öppna TOCMapping.XML i Anteckningar och leta upp kontexten (<uppsättningen>) för länken som behöver uppdateras.

  3. Uppdatera det nödvändiga <relaterade ämneselementet> i länkkontextuppsättningen<>.

Ändra befintligt hjälpinnehåll för ett tillägg

  1. Leta upp filen TOCMapping.xml. Mer information finns i Windows anpassad hjälpöversikt för Azure Pack.

  2. Öppna TOCMapping.xml i Anteckningar och identifiera hjälpkontextuppsättningen <> som innehåller det nödvändiga hjälplänksrelaterade<ämnet>.

  3. Identifiera hjälpinnehållets .xhtml-fil genom att granska ID-attributet <> för det <relaterade ämneselementet>.

  4. Redigera och spara .xhtml-filen för att ändra hjälpinnehållet.

Så här lägger du till nytt hjälpinnehåll i ett tillägg

  1. Skapa hjälpinnehållet och spara det som en .xhtml-fil i lämplig mapp för hjälpinnehållet. Detta är vanligtvis samma mapp som TOCMapping.xml fil för tillägget, men detta är inte garanterat. Information om hur du hittar hjälpinnehållet för ett tillägg finns i Windows anpassad hjälpöversikt för Azure Pack.

  2. Öppna TOCMapping.xml för tillägget i Anteckningar och identifiera den hjälpkontextuppsättning <> som det nya hjälpinnehållet ska läggas till i. Information om hur du hittar TOCMapping.xml för ett tillägg finns i Windows anpassad hjälpöversikt för Azure Pack.

  3. Lägg till ett <relaterat ämneselement> i hjälpkontextuppsättningen<>. Id-attributet för <relatedTopic> ska vara namnet på hjälpinnehållsfilen som skapades i det första steget utan tillägget .xhtml.

Rendera hjälpbilder

  1. Skapa avbildningen som antingen en .PNG- eller .GIF fil

  2. Placera bilden i samma mapp som tilläggets hjälpinnehåll .xhtml-filer. Information om hur du hittar hjälpinnehållet för ett tillägg finns i Windows anpassad hjälpöversikt för Azure Pack.

  3. I hjälpinnehållets .xhtml-fil som återger bilden använder du följande format för att referera till bilden i en <img-tagg> :

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

    Till exempel <img src="/HelpContent/GetImage/websystemadminextension/jj205510.note(en-us,MSDN.10).gif" class="mtpsimage" alt="note" />

Se även

anpassad hjälp för Windows Azure Pack-tillägg