Dieser Artikel ist die Übersetzung des Artikels Wiki: How to Automatically Add a Table of Contents (TOC) to Your TechNet Wiki Article von Peter Geelen.


Dieser TechNet-Wiki-Artikel zeigt, wie Sie mit Hilfe des Tags "[ TOC ]" automatisch ein Inhaltsverzeichnis zu Ihrem Artikel hinzufügen können: Sie fügen Sie in Ihrem Artikel Überschriften ein. Danach wird das TOC-Tag durch ein Inhaltsverzeichnis ersetzt, das auf die entsprechenden Überschriften des Artikels verlinkt.


Schritte

Schritt 1: In den Editiermodus wechseln
Erzeugen Sie ein neues Wiki-Dokument oder bearbeiten Sie einen existierenden Artikel.
Klicken Sie auf  den Reiter Edit, um in den Editiermodus zu gelangen.
Schritt 2: Das Dokument bearbeiten 
Schritt 3: Ein Überschriftenformat benutzen
Formatieren Sie Überschriften mit einem Heading-Absatzformat wie z.B. "Heading 1" - Sie finden es im Dropdown-Listenfeld links oberhalb der Werkzeugleiste.
Schritt 4: Das Tag [TOC] nutzen
Fügen Sie das Tag [TOC] (<öffnende eckige Klammer>TOC<schließende eckige Klammer>, ohne Leerzeichen!) wei im Beispiel gezeigt in Ihr Dokument ein.


Schritt 5: Den Artikel speichern
Schritt 6: Das Wunder ansehen
Achtung: Wenn eine Überschrift Nullen enthält...

Wenn eine Überschrift das Zeichen "0" enthält, müssen Sei sie im HTML-Editor bearbeiten. Der Überschriftentext darf Nullen enthalten, jedoch müssen Sie nach dem Speichern des Artikels  aus dem Tag <a name>, das in der Überschriftenzeile steht,  alle Nullen entfernen oder ersetzen. Solange Nullzeichen vorhanden sind, wird die Überschrift nicht im Inhaltsverzeichnis erscheinen.

Achtung: Wenn Überschriften doppelt vorkommen...

Wenn Überschriften doppelt vergeben wurden, müssen Sie im HTML-Editor bearbeitet werden. Der Überschriftentext darf mehrfach vorkommen, jedoch muss das Tag <a name> eindeutig sein. Bearbeiten Sie das Tag <a name>, so dass es eindeutig wird.

Für eine Demonstration des Problems mit doppelten Überschriften klicken Sie auf die Beispielüberschriftenzeilen weiter unten im nächsten Abschnitt. Sie wurden so erstellt,  dass sie einen Überschriftenhierarchie im Inhaltsverzeichnis zu Beginn dieses Artikels zeigen. Beachten Sie jedoch, dass drei Überschriften den gleichen Überschriftentext  "Beispielüberschrift 3" besitzen. Wenn Sie das Inhaltsverzeichnis ausprobieren, werden Sie feststellen, dass alle drei Einträge des Inhaltsverzeichnisses auf dieselbe Position im Artikel verlinken. Alle drei Überschriften besitzen das gleiche Tag <a name>.

Achtung: Wenn eine Überschrift führende Ziffern besitzt...

Wenn eine Überschrift führende Ziffern, wie z. B. "1" oder "2" besitzt, werden diese im automatisch erstellten Tag <a name> ignoriert, wenn der Artikel gespeichert wird. Das bedeutet, dass das Tag <a name> eventuell nicht mehr eindeutig ist. Ein Beispiel: Die Überschriftentexte "1.2 Referenzen" und "3.1 Referenzen" besitzen das gleiche Tag <a name> und sind deshalb nicht eindeutig. Sie müssen das Tag <a name> im HTML-Editor bearbeiten, so dass es wieder eindeutig wird und das Inhaltsverzeichnis korrekt angezeigt wird. Im Tag <a name> werden führende Ziffern ignoriert, sie sind aber an anderen Stellen im Namen erlaubt. Sie können etwa im Beispiel das Tag <a name> in <a name="Referenzen_1_2"> und <a name="Referenzen_3_1"> ändern.

Hinweis: Leerzeichen und Punkte müssen durch Unterstriche ersetzt werden.

Wichtiger Hinweis: Wenn Ihr Inhaltsverzeichnis nicht wie erwartet aussieht, dann sehen Sie sich die unten stehende Hilfe oder den Abschnitt TOC reparieren an!

Zurück zum Anfang


Beispielüberschrift 1

Beispielüberschrift 2

Beispielüberschrift 3

Beispielüberschrift 3

Beispielüberschrift 4
Beispielüberschrift 5
Beispielüberschrift 6

Zurück zum Anfang


Hierarchisches Inhaltsverzeichnis

Wie Sie im obigen Abschnitt gesehen haben, definieren Überschriften im Inhaltsverzeichnis durch den Grad ihrer Einrückung eine Hierarchie. Ihre Überschriften führen automatisch zu Tags der Form <a name=example></a> im HTML-Code, und das TOC-Feature nutzt diese Tags zusammen mit der Nummer der Überschriftenebene, um die Tiefe in der Hierarchie des Inhaltsverzeichnisses zu ermitteln.

Ein Beispiel: Im Artikel "Feature Requests for TechNet and MSDN Profiles and Social Platform Tools" habe ich Übeerschriftenebene 3 genutzt, um die Oberüberschriften für jedes soziale Plattformwerkzeug (wie z.B. Wiki, Foren, Blogs, Profile und Gallerien). Danach habe ich die Überschriftenebene 2 genutzt, um weiter unten den Abschnitt "Completed/Closed Requests" zu erstellen. Obwohl es sich um eine höhere Überrschriftenebene handelt - H3s kam zuerst, H2 danach - werden sie alle auf der Überschriftenebene von H3 eingeordent (was m.E. richtig ist). Danach habe ich unterhalb von H2 ("Completed/Closed Requests") mehrere H3-Abschnitte für jedes soziale Plattfromwerkzeug  engefügt. Da es sich um H3-tags unterhalb eines H2-tags handelt, werden sie in diesem Fall im Inhaltsverzeichnis nach rechts eingerückt.:

http://social.technet.microsoft.com/wiki/contents/articles/feature-requests-for-technet-and-msdn-profiles-and-social-platform-tools.aspx

Ein fantastisches und intelligentes System! Dies ist einer der Vorteile des TechNet Wiki TOC gegenüber Inhaktsverezeichnissen anderer Wikis... Sie können die Hierarchie und die geswünschten Hierarchieebenen steuern!

Zurück zum Anfang


Der "Zurück zum Anfang"-Link

Es gibt keinen Automatismus für einen Link an den Anfang Ihres Artikels. Sie können einen neuen Anker zu Beginn Ihres Artikels einfügen, Text schreiben und anschließend an den Anfang des Artikels verlinken (und diesen Link dann per Copy/Paste unterhalb jedes Artikelabschnitts einfügen).

Schneller geht es, wenn Sie den den Link kopieren und einmal im Artikel (im untersten Abschnitt) einfügen:

Zurück zum Anfang

Klicken Sie eine beliebige des Stelle des Link-Texts an, klicken Sie dann das Icon "Insert Link or Anchor" in der Werkzeugleiste an und aktualisieren Sie den Artikelnamen in der URL-Textbox (Sie erhalten die URL aus der Adresszeile Ihres Browsers). Ein Beispiel: Sie möchten "3329" mit der ID Ihres Artikels oder dem textuellen Namen ersetzen.

Sobald Sie den Link Zurück zum Anfang geändert haben,kopieren Sie ihn und fügen ihn an beliebiger Stelle in Ihrem Artikel ein, um Ihre Änderungen zu behalten.

Wenn Sie möchten, dass der der Link auf den Beginn ihres Artikels (und nicht den Beginn der Seite) verweist, dann müssen Sie einen Anker auf ihrer ersten Seite erzeugen (klicken Sie auf den Artikelanfang, klicken Sie auf das Icon "Insert Link or Anchor" in der Werkzeugleiste, klicken Sie auf den Reiter Anchor, geben Sie "Top" in der Textbox für den Namen ein und klicken Sie OK).

Beispiel:

Zurück zum Anfang


TOC reparieren

Bei Problemen mit dem Inhaltsverzeichnis sollten Sie sich diesen Artikel ansehen:

Und wenn Ihre Probleme danach immer noch nicht gelöst sind:

Zurück um Anfang


Community-Ressourcen 


Andere Sprachen

Dieser Artikel ist auch in folgenden Sprachen verfügbar:
Zurück zum Anfang