Confluence Cloud Dokumentation

Einfügen des Verzeichnisbereich Makros



Du kannst das Verzeichnisbereich Makro verwenden, um einen Abschnitt (Zone) auf der Seite zu markieren, in dem du ein Inhaltsverzeichnis erstellen willst. Du kannst die Überschriften als flache Liste gestalten und die Liste der Links am oberen und unteren Rand des Abschnitts oder der Seite platzieren, um Navigationsleisten ähnlich der Webnavigation zu erstellen.


Verwende das Verzeichnisbereich Makro

So fügst du ein Makro hinzu:


  1. Beim Bearbeiten klickst du in der Symbolleiste auf .
  2. Finde das Makro mithilfe seines Namens und wähle es aus.
  3. Richte es nach Bedarf ein.


Du kannst auch / auf der Seite eintippen, um die gleiche Liste aufzurufen, die du auch bei der Auswahl in der Symbolleiste siehst. Tippe weiter den Namen des Makros ein, um die Liste zu filtern.

So bearbeitest du ein Makro:

  1. Wähle den Makroplatzhalter aus.
  2. Klicke auf das Symbol Bearbeiten, um das Konfigurationsfenster zu öffnen.
  3. Richte die Einstellungen ein. Deine Änderungen werden während der Bearbeitung gespeichert.
  4. Setze die Bearbeitung der Seite fort und schließe das Panel.


Du kannst auch die Symbole Zurück zur Mitte, Verbreitern und Volle Breite auswählen, um die Breite einiger Makros anzupassen. Wähle das Mülleimersymbol aus, um das Makro zu entfernen.


Parameter

Parameter sind Optionen, die du einstellen kannst, um zu steuern, was und wie der Inhalt des Makros auf der Seite erscheint. 

Wenn der Parametername, der im Confluence Cloud-Speicherformat oder in wikimarkup verwendet wird, sich von den Stichwörtern unterscheidet, die beim Einfügen von Makros über den Browser oder den Slash-Befehl verwendet werden, wird er unten in Klammern aufgeführt ( Beispiel ).


Parameter

Standard

Beschreibung

location
(location

both

Legt fest, wo in der Zone die Ausgabeliste angezeigt wird: top, bottom oder both, was den Inhalt der Seitenzone einschließt.

Ausgabetyp
(type)

list

Legt das Layout des Inhaltsverzeichnisses fest:

  • list → erzeugt eine vertikale Liste, typisch für ein Inhaltsverzeichnis.
  • flat → erzeugt eine horizontale menüartige Reihe von Links, zum Beispiel: [Überschrift 1] [Überschrift 2] [Überschrift 3].

Abschnittsnummerierung anzeigen
(outline

Falsch

(false)

Wähle diese Option, um deine Überschriften mit einer Gliederungsnummerierung zu versehen, zum Beispiel: 1.1, 1.2, 1.3.

Listenstil
(style

none

Legt den Stil des Aufzählungspunkts für jedes Listenelement fest.  Du kannst jeden gültigen CSS-Stil verwenden.  Zum Beispiel:

  • none → es wird kein Listenstil angezeigt.
  • circle → der Listenstil ist ein Kreis.
  • disc → der Listenstil ist ein gefüllter Kreis. Das ist die typische Aufzählungsliste, die wir für diese Beispielliste verwenden.
  • square → die Liste wird als Quadrat dargestellt.
  • decimal → die Liste ist nummeriert (1, 2, 3, 4, 5).
  • lower-alpha → die Liste wird kleingeschrieben und alphabetisch geordnet (a, b, c, d, e).
  • lower-roman → die Liste wird mit kleinen römischen Ziffern erstellt (i, ii, iii, iv, v, vi).
  • upper-roman → die Liste wird in großen römischen Ziffern geschrieben (I, II, III, IV, V, VI).

Überschrifteneinzug
(indent


Legt den Einzug für einen Listenausgabetyp gemäß den CSS-Mengen fest. Wenn du "10px" eingibst, werden die Überschriftenebenen der Liste nacheinander um 10px eingerückt. Zum Beispiel werden h1-Überschriften um 10px und h2-Überschriften um weitere 10px eingerückt.

Trennzeichen
(separator

brackets

Gilt nur für den flachen Ausgabetyp. Legt den Anzeigestil der Links fest.  Du kannst einen der folgenden Werte eingeben:

  • brackets → Jedes Element wird von eckigen Klammern umschlossen: [ ].
  • braces → Jedes Element wird von geschweiften Klammern umschlossen: { }.
  • parens → Jeder Eintrag wird von Klammern umschlossen: ( ).
  • pipe → Jeder Eintrag wird durch eine Pipe getrennt:
  • irgendetwas → Jedes Element wird durch den von dir eingegebenen Wert getrennt. Du kannst einen beliebigen Text als Trennzeichen eingeben, zum Beispiel "***". Wenn du ein benutzerdefiniertes Trennzeichen verwendest, beachte, dass der Text genau so angezeigt wird, wie du ihn eingegeben hast, ohne zusätzlichen Leerraum, um die Zeichen weiter zu trennen.

Minimale Überschriftenebene
(minLevel

1

Wähle die größte Überschriftenebene aus, mit der dein Inhaltsverzeichnis beginnen soll.  Mit der Stufe 2 werden zum Beispiel die Überschriften h2, h3 und h4 aufgelistet, nicht aber die Überschriften h1.

Maximale Überschriftenebene
(maxLevel

7

Wähle die kleinste Überschriftenebene aus, die in das Inhaltsverzeichnis aufgenommen werden soll.  Bei 2 werden z. B. h1 und h2 aufgelistet, aber h3 und darunter werden nicht berücksichtigt.

Überschriften einschließen
(include


Filtere die enthaltenen Überschriften nach bestimmten Kriterien. Du kannst Platzhalterzeichen verwenden. In der Regex-Dokumentation von Sun (Englisch) findest du Beispiele für die Erstellung von regulären Ausdrücken.

Überschriften ausschließen
(exclude


Schließe Überschriften nach bestimmten Kriterien aus. Du kannst Platzhalterzeichen verwenden. In der Regex-Dokumentation von Sun (Englisch) findest du Beispiele für die Erstellung von regulären Ausdrücken.

Bei Export drucken
(printable

Wahr

(true)

In der Standardeinstellung ist das Inhaltsverzeichnis auf "Bei Export drucken" eingestellt. Wenn du diesen Parameter deaktivierst, ist das Inhaltsverzeichnis nicht sichtbar, wenn du die Seite druckst.

CSS-Klassename
(class


Wenn du ein benutzerdefiniertes Inhaltsverzeichnis in deinem CSS-Stylesheet hast, kannst du diesen Parameter verwenden, um das Inhaltsverzeichnis mit dem angegebenen "Klasse"-Attribut auszugeben.






Beispiele

Die folgenden Beispiele basieren auf dieser Inhaltsstruktur: 

Gefilterter Inhalt


In diesem Beispiel werden die Überschriften so gefiltert, dass sie "Lieblings" enthalten, aber Überschriften, die mit "Dinge" enden, ausgeschlossen werden. Die Liste ist mit römischen Ziffern formatiert.


Parameter

Wert

Ausgabetyp


list

Listenstil

upper-roman

Überschriften einschließen


Lieblings.*

Überschriften ausschließen


.*Dinge

Das Ergebnis ist das folgende Inhaltsverzeichnis:


Flache Liste

In diesem Beispiel werden alle Überschriften so gefiltert, dass eine flache Liste mit "Unbekannt" in eckigen Klammern angezeigt wird (der Standard-Listenstil).


Parameter

Wert

Ausgabetyp

flat
Trennzeichen


brackets

Maximale Überschriftenebene


2

Überschriften einschließen


Unbekannte.*

Das Ergebnis ist das folgende Inhaltsverzeichnis:


Wiki Markup Beispiel


Wiki Markup wird nur im Legacy Editor unterstützt.

Wiki-Markup ist nützlich, wenn du ein Makro außerhalb des Editors hinzufügen musst, zum Beispiel als benutzerdefinierten Inhalt in der Seitenleiste, der Kopfzeile oder der Fußzeile eines Bereichs.

Makroname: toc-zone

Makrokörper: Akzeptiert Rich Text.

            {toc-zone:printable=false|maxLevel=2|minLevel=2|location=top|type=flat|outline=true|separator=pipe}
Only headings within this block are included in the table of contents.
{toc-zone}


Hinweise

  • Aufgrund eines ungelösten Vorgangs im Verzeichnisbereich Makro (CONF-10619 (Englisch)) zeigt die Funktion Aktualisieren des Makrobrowsers keine Parameteränderungen an. Derzeit werden Änderungen an den Parameterwerten des Verzeichnisbereich Makros erst angezeigt, nachdem die Seite gespeichert wurde.





Zurück zum Hauptmenü   Nächstes Thema  







Confluence

Diese Seite wurde zuletzt am 06.03.2023 geändert.