Quelltext der Seite Wikiup:Archiv/Vorlagen/TitelFormat/Doku

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>

Diese Vorlage dient der Formatierung von Titelangaben innerhalb anderer Vorlagen.

Der übergebene ''Titel'' wird in Kursivschrift gesetzt und mit einem Punkt beendet, wenn dies sinnvoll ist.

Anzuwenden wäre dies etwa innerhalb von [[Vorlage:Literatur]] oder
[[Vorlage:Internetquelle]] sowie diversen Vorlage:cite.

Kein Punkt wird angefügt, wenn der ''Titel'' bereits mit einem Punkt endet – oder mit Fragezeichen oder Ausrufezeichen. Dabei kann ''Titel'' auch in Anführungszeichen eingeschlossen sein oder als Link enden. Punkt, Fragezeichen oder Ausrufezeichen können für Titel in CJK auch aus den [[Unicode-Block Halbbreite und vollbreite Formen|halbbreiten und vollbreiten Formen]] stammen: U+FF01, U+FF0E, U+FF1F.

== Einbindung ==

# <code><nowiki>{{TitelFormat|T=</nowiki></code>''TITEL''<code>}}</code>
# <code><nowiki>''</nowiki></code>''TITEL''<code><nowiki>{{TitelFormat/core|T=</nowiki></code>''TITEL''<code><nowiki>|L={{Str&nbsp;len|1=</nowiki></code>''TITEL''<code>}}|M=>}}</code>
Die zweite Form erspart eine Schachtelungsebene an eingebundenen Untervorlagen und verbessert die [[Wikipedia:Archiv/Vorlagen/TitelFormat/Test#Performance|Performance]]; bei den wenigen Fällen werden geübte Vorlagenprogrammierer keine Schwierigkeiten damit haben. ''TITEL'' ist der Parameter innerhalb der einbindenden Vorlage.

== Parameter ==

; T
: ''TITEL'', auch auf Fragezeichen oder Ausrufezeichen endend, auch auf Punkt sowie Anführungszeichen und Verlinkung.
: Ein leerer (fehlender) Parameter ist nicht vorgesehen.
:* Aus Effizienzgründen wird dies nicht überprüft. Bei den vorgesehenen und bekannten Verwendungen wird nur eingebunden, wenn das ohnehin bereits der Fall ist.
: Schließende Leerzeichen wären unzulässig, können jedoch beim Durchreichen innerhalb von Vorlagen nicht auftreten.

== Beispiele ==

Auszug:
<pre style="white-space:pre-wrap;">
{{TitelFormat|T=Ein Titel}}
{{TitelFormat|T=Vorwärts!}}
{{TitelFormat|T=Das Buch zum Thema.}}
{{TitelFormat|T=Das Zitat «même vous, Brutus?»}}
{{TitelFormat|T=[http://example.com example.com]}}
{{TitelFormat|T=[http://example.com Wer besitzt die Domain example.com?]}}
{{TitelFormat|T=[[Is’ was, Doc?]]}}
{{TitelFormat|T=[[Hilfe:Vorlagenprogrammierung]]}}
</pre>
* {{Wikipedia:Archiv/Vorlagen/TitelFormat|T=Ein Titel}}
* {{Wikipedia:Archiv/Vorlagen/TitelFormat|T=Vorwärts!}}
* {{Wikipedia:Archiv/Vorlagen/TitelFormat|T=Das Buch zum Thema.}}
* {{Wikipedia:Archiv/Vorlagen/TitelFormat|T=Das Zitat «même vous, Brutus?»}}
* {{Wikipedia:Archiv/Vorlagen/TitelFormat|T=[http://example.com example.com]}}
* {{Wikipedia:Archiv/Vorlagen/TitelFormat|T=[http://example.com Wer besitzt die Domain example.com?]}}
* {{Wikipedia:Archiv/Vorlagen/TitelFormat|T=[[Is’ was, Doc?]]}}
* {{Wikipedia:Archiv/Vorlagen/TitelFormat|T=[[Hilfe:Vorlagenprogrammierung]]}}

Weitere Fälle auf der [[Wikipedia:Archiv/Vorlagen/TitelFormat/Test|Testseite]].

== Programmierung ==

Die Hauptarbeit wird von der Untervorlage <tt>[[Wikipedia:Archiv/Vorlagen/TitelFormat/core|/core]]</tt> erledigt.

Die Performance wurde [[Wikipedia:Archiv/Vorlagen/TitelFormat/Test#Performance|untersucht]].
<includeonly>
[[Kategorie:Wikipedia:Archiv/Vorlagen|TitelFormat]]
</includeonly>