Bearbeiten von Vorlage:Artikelvorschau/Doku

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

{{Information:Vorlage | Lizenz={{CC-by-sa-3.0|was=Diese Vorlage}} 
  | Note       = [[Benutzer:Kobold]] 08.01.2012 
  | Bilder     = yes
}}

Die Vorlage '''Artikelvorschau''' präsentiert eine Kurzfassung eines Artikels in einer Box.

== Beispiel ==
{{Artikelvorschau|Rind|align=right}}
<pre width="40">
{{Artikelvorschau|Rind|align=right}}
</pre>

== Funktion ==
Die Vorlage stellt den vorgegebenen oder als Vorlage eingebundenen Text in einer Box dar.
Die Fußzeile enthält einen Link auf den in Kurzform vorgestellten Artikel.
Oberhalb der hier optionalen Hauptüberschrift des Artikels kann in der Kopfzeile der Box eine weitere Titelzeile dargestellt werden.

== Benutzung ==
=== Kopiervorlage ===
Kurzform
<pre width="40">
{{Artikelvorschau|<Artikel>}}
</pre>

Eingebundener Artikel, ausführlich
<pre width="40">
{{Artikelvorschau|<Artikel>
| length = {500}
| align  = {left}|right|center|full|here
| width  = {32em}
| height = {auto} 
| head   = <ggf. Kopfzeile>
| foot   = {mehr...}
| h1     = {0}
}}
</pre>

Manuell vorgegebener Text
<pre width="40">
{{Artikelvorschau|<Artikel>
| align  = {left}|right|center|full|here
| width  = {32em}
| height = {auto} 
| head   = <ggf. Kopfzeile>
| foot   = {mehr...}
| h1     = {0}
| text   = <Inhalt ...>
}}
</pre>

=== Parameter ===
* Der erste, namenlose Parameter ist der ''Artikel'', der in Kurzform dargestellt wird und auf den die Fußzeile verlinkt ist.
* Als ''text'' kann der Inhalt der Vorschau angegeben werden.
* Ist kein ''text'' angegeben, werden die ersten ''length'' Zeichen aus dem ''Artikel'' transkludiert (Standardwert: 500; Höchstwert: 500).
* Als Ausrichtung ''align'' stehen zur Verfügung: ''left'' links, ''right'' rechts, ''center'' zentriert; ''full'' volle Seitenbreite (''width'' hat keine Wirkung); ''here'' an Ort und Stelle im Text ("display:inline-block")
* ''width'' Breite, Standardwert 32em (außer bei ''align=full'')
* ''height'' Höhe 
* ''head'' Kopfzeile, optional
* ''foot'' Fußzeile, die zum ''Artikel'' verlinkt; Standard "mehr..."
* Mit ''h1=1'' kann die Hauptüberschrift des Artikels aktiviert werden (Standardwert 0)

=== Automatische Transklusion ===
Wird kein ''text'' explizit angegeben, so werden die ersten ''length'' Zeichen aus dem ''Artikel'' in die Box übernommen.
Dies geschieht im Sinne einer Vorlageneinbindung, d.h. beim späteren Bearbeiten des ''Artikel''s wird die Vorschau automatisch angepasst.

Da eine fest vorgegebene Anzahl von Zeichen übernommen wird, wird der Text ''irgendwo'', i.d.R. mitten im Wort abgeschnitten (siehe auch [[Vorlage:Str left]]). Durch Variation des Parameters ''length'' (&le;500) kann, wenn dies gewünscht wird, der Text an einer geeigneten Stelle abgebrochen werden. Der Parameter ''length'' muss dann aber jedesmal angepasst werden, wenn der eingebundene Artikel (bzw. dessen Anfang) bearbeitet wird.

Es kann ebenso vorkommen, dass Elemente der Formatierung unvollständig in die Vorschau übernommen werden, z.B. dass zu öffnenden <nowiki>{| [[ </nowiki> die schließenden Gegenstücke <nowiki>]] |}</nowiki> fehlen. Für die einfachen, häufiger vorkommenden Fälle wird dies von der [[Vorlage:Artikelvorschau]] durch das Einfügen unsichtbarer Zeichen kompensiert. Kompliziertere Layouts (z.B. die [[Vorlage:Infobox Film|Infobox Film]]) überstehen diese Art der Einbindung leider nicht unbeschadet.

Da das Bearbeiten des eingebundenen Artikels unbemerkt zu einer "Zerstörung" der Vorschau an anderer Stelle führen kann, ist bei der Benutzung dieses Features einige Zurückhaltung geboten.
Es empfiehlt sich eher auf nachgelagerten Seiten wie z.B. Kategorieseiten, die ohnehin automatisch generiert werden, als auf Haupt- und Portalseiten von hoher Sichtbarkeit.

<small><p>'''Bemerkungen''' &ensp; Die Länge ''length'' bezieht sich auf die Anzahl der Zeichen ''nach der Expansion'' aller in den ''Artikel'' ggf. eingebundenen Vorlagen.</p>

<p>Für den häufig vorkommenden Fall "Link-in-Bildunterschrift-in-Tabelle" (<nowiki>{| ... [[Datei:...| [[...</nowiki>) wird "auf Verdacht" das Gegenstück <nowiki>]] ]] |}</nowiki> ''unsichtbar'' eingefügt; damit sind auch einfachere Fälle abgedeckt. (Dieses Feature lässt sich mit ''safe=0'' abschalten.) Kompliziertere Fälle (z.B. Tabelle-in-Tabelle) werden dadurch nicht abgedeckt. Unvollständige HTML-Tags lassen sich nicht "auf Verdacht" ergänzen; ein fehlendes &lt;/div> führt i.d.R. dazu, dass der nachfolgende Text "durcheinanderpurzelt".
</p></small>

=== Vorsicht: bei Überschriften, Kategorien ===
Unabhängig davon, ob der Text der Vorschau automatisch erzeugt oder von Hand geschrieben wird, darf nicht vergessen werden, dass Überschriften und Kategorien auch in der "Box" ihre volle Wirkung entfalten:
* Überschriften in der Vorschau-Box erscheinen mit im Inhaltsverzeichnis der einbindenden Seite. Da dies für Verwirrung sorgen und auch die Hierarchie der Überschriften durcheinanderbringen kann, empfiehlt es sich, das Inhaltsverzeichnis ggf. ''global'' (d.h. für die gesamte Seite) mit <nowiki>__NOTOC__</nowiki> [http://www.mediawiki.org/wiki/Help:Magic_words#Behavior_switches] zu unterdrücken.
* Neben den Überschriften in der Vorschau-Box erscheinen "Bearbeiten"-Links, die überraschenderweise zum Bearbeiten der Langform des in Kurzform eingebundenen Artikels führen. Diese "Bearbeiten"-Links lassen sich ''global'' durch <nowiki>__NOEDITSECTION__</nowiki> [http://www.mediawiki.org/wiki/Help:Magic_words#Behavior_switches] unterdrücken.
* Der einbindende Artikel wird zu Kategorien hinzugefügt, die in der Box enthalten sind. Dies ist nur bei der Einbindung sehr kurzer Artikel ein Problem, da Kategorien üblicherweise am Ende der Seite weit jenseits des Limits von 500 Zeichen stehen.

Nachfolgend das automatisch generierte (und nicht durch <nowiki>__NOTOC__</nowiki> unterdrückte) Inhaltsverzeichnis dieser bunt zusammengestellten Seite:
<!-- __NOEDITSECTION__ -->
__TOC__

== Beispiele ==
=== align=left/right, +/- Kopfzeile ===
<pre width="78">
{{Artikelvorschau|Bär|width=40em|align=left|h1=1}}
{{Artikelvorschau|Bär|width=26em|align=right|length=100|head=Bären im Mosaik}}
</pre>
{{Artikelvorschau|Bär|width=40em|align=left|h1=1}}
{{Artikelvorschau|Bär|width=26em|align=right|length=100|head=Bären im Mosaik}}
<div style="clear:both"></div>

=== Manuell vorgegebener Text ===
Die [[Vorlage:Dieser Artikel|Begriffsklärung]] am Anfang des Artikels [[Anna]] ist hier entbehrlich.
<pre width="100">
{{Artikelvorschau|Anna|width=28em|align=left}}

{{Artikelvorschau|Anna|width=28em|align=right|text=
[[Bild:Anna ABC001.jpg|right|framed|Anna in 
[[Mosaik - Die unglaublichen Abenteuer von Anna, Bella & Caramella|ihrer eigenen Serie]]]]
'''Anna''' ist eine der [[Anna, Bella und Caramella|drei Hauptfiguren]] des 
[[Mosaik - Die unglaublichen Abenteuer von Anna, Bella & Caramella]]. 
Ihren ersten Auftritt hatte sie aber in der [[Johanna-Serie]] des [[Mosaik ab 1976]].
}}
</pre>

{{Artikelvorschau|Anna|width=28em|align=left}}
{{Artikelvorschau|Anna|width=28em|align=right|text=
[[Bild:Anna ABC001.jpg|right|framed|Anna in 
[[Mosaik - Die unglaublichen Abenteuer von Anna, Bella & Caramella|ihrer eigenen Serie]]]]
'''Anna''' ist eine der [[Anna, Bella und Caramella|drei Hauptfiguren]] des 
[[Mosaik - Die unglaublichen Abenteuer von Anna, Bella & Caramella]]. 
Ihren ersten Auftritt hatte sie aber in der [[Johanna-Serie]] des [[Mosaik ab 1976]].
}}

<div style="clear:both"></div>

=== Kurzer, vollständig dargestellter Artikel; align=center; foot ===
Dies
<pre width="58">
'''HC''' ist eine Abkürzung für Hardcover und meint ein gebundenes Comicalbum mit festem Einband = Buch.

[[Kategorie:Publikationsformat]]
</pre>
ist mit einer Länge von 140 Zeichen ein sehr kurzer Artikel. Bei der "automatischen" Einbindung mittels
<pre width="58">
{{Artikelvorschau|HC|align=center|h1=1|foot=Zum Artikel}}
</pre>
würde die einbindende Seite (hier die [[Vorlage:Artikelvorschau/Doku]]) ungewollt zur [[:Kategorie:Publikationsformat]] hinzugefügt werden. Daher:
<pre width="58">
{{Artikelvorschau|HC|align=center|h1=1|foot=Zum Artikel
 |text= '''HC''' ist eine Abkürzung für Hardcover und meint ein gebundenes Comicalbum mit festem Einband = Buch.
}}
</pre>
{{Artikelvorschau|HC|align=center|h1=1|foot=Zum Artikel
 |text= '''HC''' ist eine Abkürzung für Hardcover und meint ein gebundenes Comicalbum mit festem Einband = Buch.
}}
<div style="clear:both"></div>

=== align=here; width & height ===
<pre width="104">
{{Artikelvorschau|Brieftauben|width=30em|height=28em|align=here|head=Überblicksartikel ''Brieftauben''}}
{{Artikelvorschau|Geier      |width=30em|height=28em|align=here|head=Überblicksartikel ''Geier''}}
</pre>
{{Artikelvorschau|Brieftauben|width=30em|height=28em|align=here|head=Überblicksartikel ''Brieftauben''}}
{{Artikelvorschau|Geier      |width=30em|height=28em|align=here|head=Überblicksartikel ''Geier''}}


<!-- Kategorie für Hauptseite steht _hier_, damit sie geändert werden kann, während die Hauptseite gesperrt ist -->
<includeonly>[[Kategorie:Vorlage:Formatierungshilfe|Artikelvorschau]]</includeonly>