Seiten und Blogs - Confluence Storage Format
Auf dieser Seite wird das 'XHTML-basierte' Format beschrieben, welches Confluence benutzt, um die Inhalte einer Seite, von Seitenvorlagen, Blaupausen, Blog-Einträgen und Kommentaren zu hinterlegen. Die Information richtet sich an fortgeschrittene Nutzer, die das grundlegende Markup einer Confluence-Seite interpretieren und editieren müssen.
Confluence Storage Format
Wir nennen das Confluence Storage Format hier in diesem Zusammenhang einfach 'XHTML-basiert'. Um ganz korrekt zu sein, sollten wir es eigentlich XML nennen, denn das Confluence Storage Format erfüllt nicht die Definition von XHTML. Um genauer zu sein, schließt Confluence benutzerdefinierte Elemente für Makros und für andere Dinge mit ein. Wir benutzen den Begriff 'XHTML-basiert' jedoch, um zu zeigen, dass das Confluence Storage Format einen großen Teil an HTML enthält.
Sie können das Confluence Storage Format jeder Seite ansehen, indem Sie im Ansichtsmodus der Seite auf die drei grauen Punkte
im Menü gehen und dann auf View Storage Format klicken.Diese Option funktioniert nur, wenn einer der folgenden Punkte gegeben ist:
- Sie sind Confluence-Administrator.
- Ihre Confluence-Site hat das Confluence Source Editor Plugin installiert und Sie haben die Berechtigung, den Source Editor zu benutzen.
- Wenn Sie das Storage Format der Seite bearbeiten möchten, muss Ihr Confluence-Systemadmin das Confluence Source Editor Plugin installieren.
- Begriffserklärung der Terminologie: Wenn Sie > View Source wählen, sehen Sie das Format, das im Editor Panel benutzt wird und nicht das Storage Format der Seite.
Macros
Das jeweilige Storage Format und Wiki-Markup werden in der Dokumentation der einzelnen Makros mit eingeschlossen und können dort eingesehen werden.
Überschriften
Format | In Confluence 3.5 und älter | In Confluence 4.0 und neuer | Was Sie sehen |
---|---|---|---|
Überschrift 1 |
|
| |
Überschrift 2 | h2. Heading 2 |
| |
Überschrift 3 | h3. Heading 3 |
| |
Überschriften 4 bis 6 gibt es auch und sie folgen dem gleichen Modell. |
Text Formatierung
Format | In Confluence 3.5 und älter | In Confluence 4.0 und neuer | Was Sie sehen | ||
---|---|---|---|---|---|
Fett | *strong* |
| fett | <b> funktioniert auch, wird aber nach dem Speichern zu <strong> umgewandelt. | |
Italic | _emphasis_ |
| Italic | <i> funktioniert auch, wird aber nach dem Speichern zu <em>. | |
Durchgestrichen | -strikethrough- |
| <s> und <del> funktioniert auch. | ||
Unterstreichen | +underline+ |
| unterstreichen | ||
Hochgestellt | ^superscript^ |
| hochgestellt | ||
Tiefgestellt | ~subscript~ |
| tiefgestellt | ||
Festbreitenschriftart (Monospace) | {{monospaced}} |
| monospaced | ||
Vorformatiert | n/a |
| formatierter Text | ||
Zitat | bq. block quote or {quote} |
| Zitat | ||
Farbe | {color:red}red text{color} |
| roter Text | ||
Zentriert ausrichten | n/a |
| zentrierter Text | ||
Rechtsbündig ausrichten | n/a |
| rechtsbündig ausgerichteter Text |
Textumbruch
Format | In Confluence 3.5 und älter | In Confluence 4.0 und neuer | Was Sie sehen |
---|---|---|---|
Neuer Paragraph | Paragraph 1 |
| Paragraph 1 Paragraph 2 |
Seitenumbruch | Line 1 \\ Line 2 |
Hinweis: Im Editor mit | Zeile 1 Zeile 2 |
Horizonte Trennlinie einfügen | ---- |
| |
— Symbol | --- |
| — |
– Symbol | -- |
| – |
Listen
Format | In Confluence 3.5 und älter | In Confluence 4.0 und neuer | Was Sie sehen |
---|---|---|---|
Aufzählung | * Round bullet list item |
|
|
Nummerierte Liste | # Ordered list item |
|
|
Aufgabenliste | [] Task list item |
|
|
Links
Format | In Confluence 3.5 und älter | In Confluence 4.0 und neuer | Was Sie sehen |
---|---|---|---|
Link zu einer anderen Confluence-Seite | [Link to another Confluence page|Page Title] |
| Link to another Confluence page |
Link zu einem Anhang | [Link to an attachment^atlassian_logo.gif] |
| Link to an attachment |
Link zu einer externen Seite | [Atlassian|http://www.atlassian.com/] |
| Atlassian |
Anker-Link (auf der gleichen Seite) | [Anchor Link|#anchor] |
| Anchor Link |
Anker-Link (zu einer anderen Seite) | [Anchor Link|pagetitle#anchor] |
| Anchor Link |
Link mit einem eingebetteten Image | [!google.png!|pagetitle#anchor] |
Für komplexe Inhalte, müssen Sie |
Ein Hinweis zu Link-Bodies
Alle Links, die vom Editor her geschickt werden, werden standardgemäß als einfacher Text (plain text) gespeichert, es sei denn diese enthalten die limitierte Anzahl an Markup, die in den Link-Bodies erlaubt ist. Hier sehen Sie einige Beispiele des Markups, welches in den Link-Bodies unterstützt wird:
EIN BEISPIEL VERSCHIEDENER LINK BODIES
<ac:link>
<!-- Any resource identifier -->
<ri:page ri:content-title="Home" ri:space-key="SANDBOX" />
<ac:link-body>Some <strong>Rich</strong> Text</ac:link-body>
</ac:link>
<ac:link>
<ri:page ri:content-title="Plugin developer tutorial stuff" ri:space-key="TECHWRITING" />
<ac:plain-text-link-body><![CDATA[A plain <text> link body]]></ac:plain-text-link-body>
</ac:link>
<ac:link>
<ri:page ri:content-title="Plugin developer tutorial stuff" ri:space-key="TECHWRITING" />
<!-- A link body isn't necessary. Auto-generated from the resource identifier for display. -->
</ac:link>
Die Markup Tags, die im <ac:link-body> erlaubt sind, sind <b>, <strong>, <em>, <i>, <code>, <tt>, <sub>, <sup>, <br> und <span>.
Bilder
Format | In Confluence 3.5 und älter | In Confluence 4.0 und neuer | Was Sie sehen | |
---|---|---|---|---|
Angehängte Bilder | !atlassian_logo.gif! |
| ||
Externe Bilder | !http://confluence.atlassian.com/images/logo/confluence_48_trans.png! |
|
Unterstützte Bild-Eigenschaften (einige dieser Attribute sind das Spiegelbild des entsprechenden HTML 4 IMG Elements):
Name | Beschreibung |
---|---|
ac:align | Bildausrichtung |
ac:border | Anklicken, um einen Rahmen zu setzen |
ac:class | CSS Class Attribute |
ac:title | Bild Tooltip |
ac:style | CSS Stil |
ac:thumbnail | Anklicken, um das Bild als Thumbnail anzeigen zu lassen |
ac:alt | Alt Text |
ac:height | Bildhöhe |
ac:width | Bildbreite |
ac:vspace | Der weiße Rand über und unter dem Bild |
ac:hspace | Der weiße Rand links und rechts von dem Bild |
Tabellen
Tabellen-Überschrift Zelle 1 | Tabellen-Überschrift Zelle 2 |
---|---|
Zusammengeführte Zelle | Normal Zelle 1 |
Normal Zelle 2 |
Tabellen-Überschrift Zelle 1 | Tabellen-Überschrift Zelle 2 |
---|---|
Zusammengeführte Zelle | Normal Zelle 1 |
Normal Zelle 2 |
Format | In Confluence 3.5 und älter | In Confluence 4.0 und neuer | Was Sie sehen | |||||
---|---|---|---|---|---|---|---|---|
Zwei Spalten, zwei Zeilen (oberste Überschriftenzeile) | ||Table Heading Cell 1||Table Heading Cell 2|| |
|
| |||||
Zwei Spalten, drei Zeilen, 2. und 3. mit zusammengeführten Zellen in der ersten Zeile | Nicht zutreffend |
|
|
Seiten- Layouts
Confluence unterstützt Seiten-Layouts direkt, wie ein auf ein Makro basiertes Layout (z. B. durch die Benutzung des Section and Column Makros). Dieser Abschnitt dokumentiert das erstellte Storage Format XML, wenn diese Layouts auf einer Seite benutzt werden.
Hinweise:
- Seiten-Layouts wurden ursprünglich seit Confluence 4.2 eingeführt, sind nun aber in früheren Versionen von Confluence verfügbar. Wenn Sie Confluence 4.2 - 5.1 benutzen, sollten Sie sich die jeweilige Dokumentation der Version ansehen:
- Seiten mit einem Layout, welches im alten Format erstellt wurde, werden zum Format 5.2 konvertiert.
- Confluence 5.2 ermöglicht flexiblere Layouts mit einem präziserem Storage Format.
Element Name | In Confluence 5.2 und älter | Attribute |
---|---|---|
ac:layout | Zeigt an, dass die Seite ein Layout hat. Das sollte das Element des obersten Levels auf der Seite sein. | Keins |
ac:layout-section | Steht für eine Zeile im Layout. Es muss direkt im | ac:type |
ac:layout-cell | Steht für eine Spalte im Layout. Es muss direkt im ac:layout Tag sein. Der Typ des Seitenbereichs zeigt die entsprechende Anzahl der Zellen in dem Layout-Bereich an, die sich dem ac:type anpassen. | Keins |
Dieses sind die anerkannten Werte des ac:type
für ac:layout-section
:
| Erwartete Anzahl der Zellen | Beschreibung |
---|---|---|
| 1 | Einspaltenbereich |
two_equal | 2 | Zweispaltenbereich. Zwei Zellen mit gleicher Breite. |
two_left_sidebar | 2 | Zweispaltenbereich mit linker Seitenleiste (~30% schmaler). |
two_right_sidebar | 2 | Zweispaltenbereich mit rechter Seitenleiste (~30% schmaler). |
three_equal | 3 | Dreispaltenbereich |
three_with_sidebars | 3 | Dreispaltenbereich mit Seitenleisten (~20% schmaler). |
Das folgende Beispiel beschreibt kompliziertere Layouts, die vom alten Format neu erstellt wurden. Das Wort {content}
zeigt an, wo weiteres XHTML oder Confluence Storage Format als Block Content eingegeben werden würde, so wie <p>
oder <table>
Tags.
<ac:layout>
<ac:layout-section ac:type="single">
<ac:layout-cell>
{content}
</ac:layout-cell>
</ac:layout-section>
<ac:layout-section ac:type="three_with_sidebars">
<ac:layout-cell>
{content}
</ac:layout-cell>
<ac:layout-cell>
{content}
</ac:layout-cell>
<ac:layout-cell>
{content}
</ac:layout-cell>
</ac:layout-section>
<ac:layout-section ac:type="single">
<ac:layout-cell>
{content}
</ac:layout-cell>
</ac:layout-section>
</ac:layout>
Emoticons ![(Lächeln)](/s/-7kwi53/9012/1d0vx1s/_/images/icons/emoticons/smile.svg)
Format | In Confluence 3.5 und älter | In Confluence 4.0 und neuer | Was Sie sehen |
---|---|---|---|
Emoticons | :) |
| |
:( |
| ||
:P |
| ||
:D |
| ||
;) |
| ||
(y) |
| ||
(n) |
| ||
(i) |
| ||
(/) |
| ||
(x) |
| ||
(!) |
|
Ressourcenbezeichner (URI) Format
Resourcenbezeichner werden dazu benutzt, um "Links" oder "Referenzen" im Storage Format zu beschreiben. Beispiele der Ressourcen sind u. a. Seiten, Blog-Einträge, Kommentare, Shortcuts und Bilder.
Ressource | Ressourcenbezeichner (URI) Format |
---|---|
Seite |
Hinweise:
|
Blog-Eintrag |
Hinweise:
|
Anhang |
Hinweise:
Beispiele:
ABSOLUTE ATTACHMENT REFERENCE
|
URL |
Hinweis:
|
Shortcut |
Hinweise:
|
User |
Hinweis:
|
Bereich |
Hinweis:
|
Content Entity |
Hinweis:
|
Vorlagen Variablen
Dieser Screenshot zeigt eine einfache Vorlage:
Die Vorlage enthält die folgenden Variablen:
Name der Variable | Typ | Werte |
---|---|---|
$MyText | Einzeiliger Text | |
$MyMulti | Mehrzeiliger Text | Größe: 5 x 100 |
$MyList | Liste | Listen Items: Äpfel, Birnen, Pfirsiche |
Der XML-Export stellt den folgenden Code für die Vorlage her:
<at:declarations>
<at:string at:name="MyText" />
<at:textarea at:columns="100" at:name="MyMulti" at:rows="5" />
<at:list at:name="MyList">
<at:option at:value="Apples" />
<at:option at:value="Pears" />
<at:option at:value="Peaches" />
</at:list>
</at:declarations>
<p>This is Sarah's template</p>
<p>A single-line text variable: <at:var at:name="MyText" /></p>
<p>A multi-line text variable: <at:var at:name="MyMulti" /></p>
<p>A selection list: <at:var at:name="MyList" /></p>
<p>End of page.</p>
Anleitungs-Text
Anleitungs-Text gibt Ihnen die Möglichkeit, Informationen für den Benutzer der Vorlage, also denjenigen, der aus der Vorlage eine Seite erstellt, einzuschliessen. Es wird angegeben, wie dieser die Vorlage ausfüllen soll.
Beim Ausfüllen passiert folgendes:
- der Anleitungs-Text wird automatisch entfernt, wenn der Benutzer der Vorlage den Text eingibt und
- es wird eine automatische @mention Aufforderung erstellt (bei @mention Anleitungs-Texten).
<ul>
<li><ac:placeholder> Dieses ist ein Beispiel für einen Anleitungs-Text, der ersetzt wird, wenn der Nutzer der Vorlage den Text auswählt und mit dem Tippen beginnt.</ac:placeholder></li>
</ul>
<ac:task-list>
<ac:task>
<ac:task-status>incomplete</ac:task-status>
<ac:task-body><ac:placeholder ac:type="mention">@mention example. Dieser Platzhalter sucht automatische nach einem User, um diesen auf der Seite zu erwähnen, wenn der Benutzer mit dem Tippen beginnt.</ac:placeholder></ac:task-body>
</ac:task>
</ac:task-list>