Jira Server (und Data Center)
Wie sich die Erweiterung auf Jira Server verhält — Toolbar-Injection, Wiki-Markup, benutzerdefinierte Toolbar-Konfiguration.
Jira Server (auch Jira Software Server oder Jira Data Center genannt) verwendet den älteren Atlassian-Rich-Text-Editor. Die Erweiterung wird direkt in diesen Editor injiziert.
Wo die Benutzeroberfläche erscheint
Wenn Sie einen Dialog zum Erstellen eines Vorgangs öffnen, erscheinen drei Ergänzungen im und um das Beschreibungsfeld:
- Toolbar mit Template-Buttons — ein Button pro Template, bei dem der Schalter „Schnellzugriff-Buttons” aktiviert ist.
- Template-Dropdown — ein einzelnes Dropdown über dem Editor, das alle passenden Templates auflistet.
- Rechtsklick-Menüeinträge — das Browser-Kontextmenü erhält ein Untermenü „Templates”.
Wiki-Markup vs. Rich Text
Der Editor von Jira Server akzeptiert sowohl Wiki-Markup (*bold*, # Header usw.) als auch Rich Text. Die Erweiterung unterstützt beides:
- Rich-Text-Templates — Erstellen Sie diese im WYSIWYG-Modus des Editors auf der Optionsseite; sie werden als HTML eingefügt.
- Wiki-Markup-Templates — Aktivieren Sie den „Wiki-Modus” im Editor; im rechten Bereich wird eine Live-HTML-Vorschau angezeigt.
Die Wiki-Vorschau unterstützt die gängigsten Jira-Makros:
| Makro | Vorschau-Darstellung |
|---|---|
{panel:title=Story}…{panel} | Ein umrandeter Bereich mit optionaler Titelleiste |
{code:java}…{code} | Ein Monospace-Codeblock |
{quote}…{quote} | Ein eingerücktes Blockzitat |
{noformat}…{noformat} | Vorformatierter Klartext |
Hinweis: Die Vorschau ist eine Annäherung — Jira Servers tatsächlicher Renderer kann eine leicht abweichende Ausgabe erzeugen.
Beide Modi fügen korrekt in Jira Server ein. Wählen Sie den Modus, der sich für Sie natürlicher anfühlt.
Benutzerdefinierte Toolbar
Einige Jira-Server-Instanzen konfigurieren die Toolbar des Editors auf nicht standardmäßige Weise. Die Einstellung „Benutzerdefinierte Toolbar” der Erweiterung (unter Einstellungen) ermöglicht es Ihnen, anzugeben, in welche Toolbar die Template-Buttons injiziert werden sollen.
Tipp: Wenn Ihre Toolbar nicht an der üblichen Stelle erscheint, aktivieren Sie den Modus „Benutzerdefinierte Toolbar” und geben Sie den CSS-Selektor der Toolbar Ihres Editors an. Der Standard-Selektor deckt ca. 95 % aller Installationen ab.
Kommentare
Kommentare verwenden denselben Editor, aber eine leicht abweichende DOM-Struktur. Die Erweiterung erkennt Kommentarfelder automatisch und injiziert dieselbe Benutzeroberfläche. Kommentar-Templates verwenden den Vorgangstyp Comment.
Bekannte Einschränkungen
- Inline-Bearbeitungsformulare (direktes Klicken auf die Beschreibung in der Vorgangsansicht) funktionieren, werden aber manchmal durch Atlassians Auto-Save-Logik beeinträchtigt. Wenn der Template-Inhalt verschwindet, klicken Sie heraus und wieder hinein, um die Einfügung erneut auszulösen.
- Iframe-Editoren in einigen benutzerdefinierten Atlassian-Apps werden derzeit nicht unterstützt.