Quelltext der Seite Hilfe:Poem

{{Hilfe}}
Das '''<code>poem</code>-Element''' ermöglicht die einfache Formatierung von Gedichten und ähnlich zeilenweise strukturierten Texten. Die Zeilenumbrüche im Quelltext bleiben dadurch erhalten, so dass keine Hilfsmittel wie <code style="white-space:nowrap">&lt;br /></code> oder Einrückungen mittels „<code>:</code>“ verwendet werden müssen (die in der Regel auch nicht benutzt werden dürfen).

Wikilinks, Kursivschrift usw. sind wie sonst auch möglich. Durch Angabe einer [[Hilfe:CSS|CSS-Eigenschaft]] wird der gesamte Text formatiert.

== Anwendung ==
<div style="border: 1px dashed #008000; overflow:auto; padding-left:.5em; margin:.5em;">
{{Info}} Die Texte innerhalb des Poems sollten keine Belegtags <code>&lt;ref></code> enthalten; auch keine [[Hilfe:TeX|Formeln]] oder gar Aufzählungen oder Tabellen.<br /> [[Hilfe:Einzelnachweise#Mehrfache Referenzierung derselben Quelle|Mehrfach verwendete Tags mit Namensattributen]] führen zu Fehlern mit [[Hilfe:Wikisyntax/Validierung|unausgeglichener Syntax]].<br />
Die Poem-Blöcke sind nur für einfache Textzeilen gedacht. Verlinkungen und Änderungen des Schriftstils sind jedoch möglich.
</div>
{|
| '''Eingabe:'''
|rowspan="2" style="width: 1em;"|
| '''Ausgabe:'''
|-
| '''<code>&lt;poem></code>'''<br />
Ob ich Biblio- was bin?<br />
phile? „Freund von Büchern“ meinen Sie?<br />
Na, und ob ich das bin!<br />
Ha! und wie!<br />
<br />
Mir sind Bücher, was den andern Leuten<br />
Weiber, Tanz, Gesellschaft, Kartenspiel,<br />
Turnsport, Wein, und weiß ich was, bedeuten.<br />
Meine Bücher – – – wie beliebt? Wieviel?<br />
<br />
Was, zum Henker, kümmert mich die Zahl.<br />
Bitte, doch mich auszureden lassen.<br />
Jedenfalls: Viel mehr, als mein Regal<br />
Halb imstande ist zu fassen.<br />
<br />
Unterhaltung? Ja, bei Gott, das geben<br />
Sie mir reichlich. Morgens zwölfmal nur<br />
Nüchtern zwanzig Brockhausbände heben – – –<br />
Hei! das gibt den Muskeln die Latur.<br />
'''<code>&lt;/poem></code>'''
|
<poem>
Ob ich Biblio- was bin?
phile? „Freund von Büchern“ meinen Sie?
Na, und ob ich das bin!
Ha! und wie!

Mir sind Bücher, was den andern Leuten
Weiber, Tanz, Gesellschaft, Kartenspiel,
Turnsport, Wein, und weiß ich was, bedeuten.
Meine Bücher – – – wie beliebt? Wieviel?

Was, zum Henker, kümmert mich die Zahl.
Bitte, doch mich auszureden lassen.
Jedenfalls: Viel mehr, als mein Regal
Halb imstande ist zu fassen.

Unterhaltung? Ja, bei Gott, das geben
Sie mir reichlich. Morgens zwölfmal nur
Nüchtern zwanzig Brockhausbände heben – – –
Hei! das gibt den Muskeln die Latur.
</poem>
|}
(Ausschnitt aus ''[[s:Der Bücherfreund|Der Bücherfreund]]'' von [[Joachim Ringelnatz]])

== Anmerkungen oder Belegtags ==
Um innerhalb des Poems eine Anmerkung einzufügen, verwende bitte die Vorlagenkombination {{Vorlage|FN}}, {{Vorlage|FNZ}}, {{Vorlage|FNBox}}. Belege wie Einzelnachweise oder gruppierte Anmerkungen bitte vor oder hinter der Poemeinbindung im Fließtextbereich anfügen. Das könnte wie folgt aussehen.
{| class="wikitable toptextcells hintergrundfarbe-basis"
|-
! … mit Fußnoten !! Ausgabe
|-
|'''<code>&lt;poem></code>'''<poem>
Ob ich Biblio- was bin?
phile? „Freund von Büchern“ meinen Sie?
Na, und ob ich das bin!
Ha! und wie!<code><nowiki>{{FN|Anm.}}</nowiki></code>
[…]
</poem>'''<code>&lt;/poem></code>'''
{{Vorlage|FNBox|<br />
{{Vorlage|FNZ|Anm.|(Ausschnitt aus ''[[s:Der Bücherfreund|Der Bücherfreund]]'' von [[Joachim Ringelnatz]]) }} }}
|<poem>
Ob ich Biblio- was bin?
phile? „Freund von Büchern“ meinen Sie?
Na, und ob ich das bin!
Ha! und wie!{{FN|Anm.}}
[…]
</poem>
{{FNBox|
{{FNZ|Anm.|(Ausschnitt aus ''[[s:Der Bücherfreund|Der Bücherfreund]]'' von [[Joachim Ringelnatz]]) }} }}
|-
! … mit Belegtags – außerhalb !! Ausgabe
|-
|'''<code>&lt;poem></code>'''<poem>
Ob ich Biblio- was bin?
phile? „Freund von Büchern“ meinen Sie?
Na, und ob ich das bin!
Ha! und wie!
[…]
</poem>'''<code>&lt;/poem></code>'''
(Ausschnitt aus ''Der Bücherfreund.''<code>'''&lt;ref&gt;'''<nowiki>[[Joachim Ringelnatz]]: ''[[s:Der Bücherfreund|Der Bücherfreund]].''</nowiki>'''&lt;/ref&gt;'''</code>)
: oder
(Ausschnitt aus ''Der Bücherfreund.''<code>'''&lt;ref name="Ringelnatz" /&gt;'''</code>)
|<poem>
Ob ich Biblio- was bin?
phile? „Freund von Büchern“ meinen Sie?
Na, und ob ich das bin!
Ha! und wie!
[…]
</poem>
(Ausschnitt aus ''Der Bücherfreund.''<ref>[[Joachim Ringelnatz]]: ''[[s:Der Bücherfreund|Der Bücherfreund]].''</ref>)
{{Überschriftensimulation|2|Text=Einzelnachweise}}
<references />
|}

== Attribute ==
{{Hilfe/Wikitext-tag |tag=poem |class=float-right |binary=1 |Attribute=
* [[#compact|compact]]
* #style=
* #class=
* #lang=
* #id=
* #title=
* #dir=}}
<code>Poem</code> kann mittels [[Hilfe:CSS|CSS]] formatiert werden.

=== Kursiv ===
<code>&lt;poem style="font-style:italic;"></code>

=== Sprache ===
Bei fremdsprachigen Texten kann ähnlich wie bei [[CowboysWiki:Zitate|Zitaten]] die verwendete Sprache über [[CowboysWiki:Technik/MediaWiki/Sprachen|Sprachcodes]] angegeben werden: <code>[[Hilfe:Tags#lang|&lt;poem&nbsp;lang="nl">]]</code>

=== Abgesetzt mit Rahmen ===
<code>&lt;poem class="hintergrundfarbe1" style="border: 1px dashed #2F6FAB; padding:1em;"></code>

Angewendet auf den ersten Absatz des oberen Gedichtes:

<poem class="hintergrundfarbe1" style="border: 1px dashed #2F6FAB; padding:1em;">
Ob ich Biblio- was bin?
phile? „Freund von Büchern“ meinen Sie?
Na, und ob ich das bin!
Ha! und wie!
</poem>

== Einrückung ==

=== Einrückung des gesamten Blocks ===
Beispiel für eine Einrückung mittels <code style="white-space:nowrap">&lt;poem style="margin-left:2em;"></code>:

<poem style="margin-left:2em;">
Ob ich Biblio- was bin?
phile? „Freund von Büchern“ meinen Sie?
Na, und ob ich das bin!
Ha! und wie!
</poem>

=== Einrückung einzelner Zeilen ===
Sollen einzelne Zeilen eingerückt werden, gibt es zwei Möglichkeiten:
* Einfache Leerzeichen können an den Zeilenbeginn gestellt werden. Sie bleiben im Sinne [[Geschütztes Leerzeichen|geschützter Leerzeichen]] auch in ihrer Anzahl erhalten, ohne die übliche Syntaxfunktion zu bewirken.
* Einer oder mehrere Doppelpunkte <code>:</code> können an den Zeilenbeginn gestellt werden. Sie bewirken die Standard-Einrückungen der Wikis, haben jedoch nicht die eigentlich unzulässige Syntaxwirkung einer [[Hilfe:Listen|Beschreibungsliste]].
Damit kann ggf. ein [[Refrain]] oder eine Original-Gestaltung reproduziert werden.

=== Mehrspaltig und dynamisch ===
Mehrere Spalten können für Textvergleiche zwischen unterschiedlichen Versionen oder Sprachen verwendet werden sowie um mehrere Strophen nebeneinander zu setzen. Hierbei wird mit einem dynamischen Layout gearbeitet: Wenn auf dem Bildschirm(-fenster) genügend Platz vorhanden ist, um die Blöcke nebeneinander zu zeigen, geschieht das auch so. Reicht die Breite nicht aus, erscheinen die Blöcke untereinander. Im folgenden Beispiel werden beide Versionen eingerückt dargestellt. Die zweite Einrückung garantiert zugleich auch einen Abstand zwischen den Versionen; sie sollte um denselben Betrag erfolgen wie die erste Einrückung, damit sie bei Anzeige untereinander gleich ist. Der Anfang wird mittels <code style="white-space: nowrap">&lt;poem style="margin-left:2em; ''float:left;''"></code> gesetzt. Nach dem letzten <code>&lt;/poem></code> wird mit ''<code style="white-space: nowrap">&lt;div style="clear:left;">&lt;/div></code>'' wieder die normale Textformatierung hergestellt, damit der darauffolgende Text darunter und nicht auch teilweise neben dem Zitat steht.

'''Eingabe:'''
<div class="hintergrundfarbe1" style="border: 1px solid #EAECF0; border-radius: 2px; padding: 1px 4px; font-family: monospace; display: inline-block;">
'''&lt;poem lang="nl" style="margin-left:2em; ''float:left;''"&gt;'''<br />
<nowiki>'''</nowiki>Aan eenen jongen visscher<nowiki>'''</nowiki><br />
Rozen zijn niet zoo schoon als uwe wangen,<br />
Tulpen niet als uw bloote voeten teer,<br />
En in geen oogen las ik immer meer<br />
Naar vriendschap zulk een mateloos verlangen.<br />
'''&lt;/poem&gt;'''<br />
'''&lt;poem style="margin-left:2em; ''float:left;''"&gt;'''<br />
<nowiki>'''</nowiki>An einen jungen Fischer<nowiki>'''</nowiki><br />
Rosen sind nicht so schön wie deine Wangen,<br />
Tulpen sind nicht so zart wie deine bloßen Füße,<br />
Und in keinen Augen las ich jemals mehr<br />
Nach Freundschaft ein so unendliches Verlangen.<br />
'''&lt;/poem&gt;'''<br />
'''''&lt;div style="clear:left;">&lt;/div>'''''
</div>

'''Ausgabe''':
<poem lang="nl" style="margin-left:2em; float:left;">
'''Aan eenen jongen visscher'''
Rozen zijn niet zoo schoon als uwe wangen,
Tulpen niet als uw bloote voeten teer,
En in geen oogen las ik immer meer
Naar vriendschap zulk een mateloos verlangen.
</poem>
<poem style="margin-left:2em; float:left;">
'''An einen jungen Fischer'''
Rosen sind nicht so schön wie deine Wangen,
Tulpen sind nicht so zart wie deine bloßen Füße,
Und in keinen Augen las ich jemals mehr
Nach Freundschaft ein so unendliches Verlangen.
</poem>
<div style="clear:left;"></div>
<small>(Erste Strophe eines Gedichts von [[Jacob Israël de Haan]] (1881–1924), welches am [[Homomonument]] zitiert wird.)</small>

Eine dreispaltige Formatierung in einer Sprache ist bei ''[[Hänschen klein#Originaltext (Franz Wiedemann)|Hänschen klein]]'' zu sehen.

Zur Verdeutlichung eine künstliche Verringerung der Ansichtsbreite:

'''Breite 50em:'''
<div class="hintergrundfarbe1" style="border: 1px dashed #2F6FAB; margin-left:1.6em;padding:1em; width: 50em;">
<poem lang="nl" style="margin-left:2em; float:left;">
'''Aan eenen jongen visscher'''
Rozen zijn niet zoo schoon als uwe wangen,
Tulpen niet als uw bloote voeten teer,
En in geen oogen las ik immer meer
Naar vriendschap zulk een mateloos verlangen.
</poem>
<poem style="margin-left:2em; float:left;">
'''An einen jungen Fischer'''
Rosen sind nicht so schön wie deine Wangen,
Tulpen sind nicht so zart wie deine bloßen Füße,
Und in keinen Augen las ich jemals mehr
Nach Freundschaft ein so unendliches Verlangen.
</poem>
<div style="clear:left;"></div>
</div>

'''Breite 25em:'''
<div class="hintergrundfarbe1" style="border: 1px dashed #2F6FAB; margin-left:1.6em; padding:1em; width: 25em;">
<poem lang="nl" style="margin-left:2em; float:left;">
'''Aan eenen jongen visscher'''
Rozen zijn niet zoo schoon als uwe wangen,
Tulpen niet als uw bloote voeten teer,
En in geen oogen las ik immer meer
Naar vriendschap zulk een mateloos verlangen.
</poem>
<poem style="margin-left:2em; float:left;">
'''An einen jungen Fischer'''
Rosen sind nicht so schön wie deine Wangen,
Tulpen sind nicht so zart wie deine bloßen Füße,
Und in keinen Augen las ich jemals mehr
Nach Freundschaft ein so unendliches Verlangen.
</poem>
<div style="clear:left;"></div>
</div>

== compact ==
Mit dem Attribut <code>compact</code> wird bei einem <code><nowiki><poem></nowiki></code> mit mehr als zwei Zeilen Inhalt ein besonderer Modus ausgelöst: Jede Zeile wird zu einem eigenen [[Absatz (Text)|Absatz]].
* Das zielt letztlich nicht auf eine kompaktere Darstellung ab, sondern einen kompakteren Wikitext.
* Die erste und letzte Zeile werden nicht besonders behandelt.
* Werden mehrere derartige <code style="white-space:nowrap"><nowiki><poem compact></nowiki></code> hintereinander gefügt, so ergibt sich deshalb kein Abstand.
Für die deutschsprachige Wikipedia eine kaum sinnvolle Funktionalität.

<div style="float:left;">
'''Zwei Zeilen ohne compact'''
<div style="float:left;">
<div style="display:inline-block; margin-top:1em; margin-bottom:1em;">''Darstellung''</div>
<poem>
Eins,
Zwei.
</poem>
<poem>
Drei?
Vier!
</poem>
</div>
<div style="margin-left:2em; float:left;">
<syntaxhighlight lang="html" style="display:table">
<poem>
Eins,
Zwei.
</poem>
<poem>
Drei?
Vier!
</poem>
</syntaxhighlight>
</div>
</div>
<div style="margin-left:6em; float:left;">
'''Zwei Zeilen mit compact'''
<div style="float:left;">
<div style="display:inline-block; margin-top:1em; margin-bottom:1em;">''Darstellung''</div>
<poem compact>
Eins,
Zwei.
</poem>
<poem>
Drei?
Vier!
</poem>
</div>
<div style="margin-left:2em; float:left;">
<syntaxhighlight lang="html" style="display:table">
<poem compact>
Eins,
Zwei.
</poem>
<poem>
Drei?
Vier!
</poem>
</syntaxhighlight>
</div>
</div>
<div style="clear:both"></div>
<div style="float:left;">
'''Drei Zeilen ohne compact'''
<div style="float:left;">
<div style="display:inline-block; margin-top:1em; margin-bottom:1em;">''Darstellung''</div>
<poem>
Eins,
Zwei.
Extra.
</poem>
<poem>
Drei?
Vier!
</poem>
</div>
<div style="margin-left:2em; float:left;">
<syntaxhighlight lang="html" style="display:table">
<poem>
Eins,
Zwei.
Extra.
</poem>
<poem>
Drei?
Vier!
</poem>
</syntaxhighlight>
</div>
</div>
<div style="margin-left:6em; float:left;">
'''Drei Zeilen mit compact'''
<div style="float:left;">
<div style="display:inline-block; margin-top:1em; margin-bottom:1em;">''Darstellung''</div>
<poem compact>
Eins,
Zwei.
Extra.
</poem>
<poem>
Drei?
Vier!
</poem>
</div>
<div style="margin-left:2em; float:left;">
<syntaxhighlight lang="html" style="display:table">
<poem compact>
Eins,
Zwei.
Extra.
</poem>
<poem>
Drei?
Vier!
</poem>
</syntaxhighlight>
</div>
</div>
<div style="clear:both"></div>

== Poem-Bearbeitung mit dem VisualEditor ==
{{Hilfe:Poem/VisualEditor}}

== Weitere Informationen ==
{{MediaWiki|Extension:Poem|suffix=Technische Informationen (englisch)}}
* [[Hilfe:Textgestaltung/Layoutfluss]]
<noinclude>
[[Kategorie:Hilfe:Formatieren]]
[[Kategorie:Hilfe:MediaWiki-Erweiterung]]
</noinclude>