Vorlage:Box - Versionsgeschichte

Stefansvw: Die Seite wurde neu angelegt: „

2023-07-23T10:37:18Z

Die Seite wurde neu angelegt: „<onlyinclude> <div style="margin: 0 auto .5rem; overflow:hidden; border-left: 7px solid {{{Farbe|{{Farbe | {{{Klasse|{{{3|unspezifisch}}}}}}}}}}};"> <div style…“

Neue Seite
<onlyinclude>
<div style="margin: 0 auto .5rem; overflow:hidden; border-left: 7px solid {{{Farbe|{{Farbe | {{{Klasse|{{{3|unspezifisch}}}}}}}}}}};">
<div style="height: 100%; padding: 0 1rem .5rem;"><div style="font-size: 110%; font-weight: bold; margin-bottom: .5rem; padding: .25rem"><span style="font-size: 1.95rem; vertical-align: middle;">{{#if: {{{Icon|}}}
|<span class="{{{Icon}}}"></span>
|{{#switch: {{{Klasse|{{{3}}}}}}
| Hervorhebung1 = {{icon hervorhebung}}
| Hervorhebung2 = {{icon hervorhebung}}
| Zitat = {{icon zitat}}
| Arbeitsmethode = {{icon pencil}}
| Unterrichtsidee = {{icon idea}}
| Meinung = {{icon comment}}
| Lernpfad = {{icon compass}}
| Experimentieren = {{icon flask}}
| Lösung = {{icon checked}}
| Üben = {{icon edit}}
| Merksatz = {{icon pin}}
| Download = {{icon download}}
| Frage = {{icon question}}
| Kurzinfo = {{icon info}}
| {{icon point}} }}
}}</span> {{{Titel|{{{1}}}}}}</div><div>
{{{Inhalt|{{{2}}}}}}</div></div></div></onlyinclude><noinclude>

Für das einheitliche Hervorheben von ähnlichen Inhalten soll die Vorlage "Box" verwendet werden.

==Beispiel==
<div class="grid">
<div class="width-1-2">
'''Das schreibt man:'''
<pre>{{Box|Hier ist die Überschrift|Hier steht der Inhalt, der in der Box angezeigt wird.|Merksatz}}</pre>

Man kann zur besseren Übersichtlichkeit auch Zeilenumbrüche einfügen:

<pre>{{Box|Hier ist die Überschrift|

Hier steht der Inhalt, der in der Box angezeigt wird.

|Merksatz}}</pre>
</div>

<div class="width-1-2">
'''Das sieht man:'''
{{Box|Hier ist die Überschrift|Hier steht der Inhalt, der in der Box angezeigt wird.|Merksatz}}
</div>
</div>

==Vorlagen für Boxen==
Für das einheitliche Hervorheben von ähnlichen Inhalten soll möglichst die Vorlage "Box" verwendet werden.
Mehr Infos dazu findet man auf der Seite [[Vorlage:Box|Vorlage:Box]].
<div class="grid">
<div class="width-1-2">

Verkürzt wird die Vorlage so verwendet:
<pre>{{Box|<Überschrift>|<Inhalt>|<Klasse>}}</pre>
</div>
<div class="width-1-2"></div>
</div>

Die Überschrift (nach <code><nowiki>{{Box|</nowiki></code> und vor dem nächsten <code><nowiki>|</nowiki></code>) ist frei wählbar.
Die '''Klasse''' gibt an, welche Farbe und welches Icon verwendet wird. Als '''Klassen '''stehen folgende Varianten zur Verfügung:

<div class="grid">
<div class="width-1-2">

'''Hervorhebung 1'''
<pre>
{{Box|Hervorhebung1|...| Hervorhebung1}}
</pre>
</div>
<div class="width-1-2">
{{Box|Hervorhebung1|...| Hervorhebung1}}
</div>
</div>

<div class="grid">
<div class="width-1-2">
'''Hervorhebung 2'''
<pre>
{{Box|Hervorhebung2|...|Hervorhebung2}}
</pre>
</div>
<div class="width-1-2">
{{Box|Hervorhebung2|...|Hervorhebung2}}
</div>
</div>
<div class="grid">
<div class="width-1-2">
'''Üben'''
<pre>
{{Box|Üben|...|Üben}}
</pre>
</div>
<div class="width-1-2">
{{Box|Üben|...|Üben}}
</div>
</div>

<div class="grid">
<div class="width-1-2">
'''Zitat'''
<pre>
{{Box|Zitat|....|Zitat}}
</pre>
</div>

<div class="width-1-2">
{{Box|Zitat|....|Zitat}}
</div>
</div>

<div class="grid">
<div class="width-1-2">
'''Arbeitsmethode'''
<pre>
{{Box|Arbeitsmethode|...|Arbeitsmethode}}
</pre>
</div>

<div class="width-1-2">
{{Box|Arbeitsmethode|...|Arbeitsmethode}}
</div>
</div>

<div class="grid">
<div class="width-1-2">
'''Unterrichtsidee'''
<pre>
{{Box|Idee|...|Unterrichtsidee }}
</pre>
</div>
<div class="width-1-2">
{{Box|Idee|...|Unterrichtsidee }}
</div>
</div>

<div class="grid">
<div class="width-1-2">
'''Meinung'''
<pre>
{{Box|Meinung|...|Meinung}}
</pre>
</div>

<div class="width-1-2">
{{Box|Meinung|...|Meinung}}
</div>
</div>

<div class="grid">
<div class="width-1-2">
'''Lernpfad'''
<pre>
{{Box|Lernpfad|...|Lernpfad}}
</pre>
</div>
<div class="width-1-2">
{{Box|Lernpfad|...|Lernpfad}}
</div>
</div>

<div class="grid">
<div class="width-1-2">
'''Lösung'''
<pre>
{{Box|Lösung|...|Lösung}}
</pre>
</div>
<div class="width-1-2">
{{Box|Lösung|...|Lösung}}
</div>
</div>

<div class="grid">
<div class="width-1-2">
'''Merksatz'''
<pre>
{{Box|Merke|...|Merksatz}}
</pre>
</div>
<div class="width-1-2">
{{Box|Merke|...|Merksatz}}
</div>
</div>

<div class="grid">
<div class="width-1-2">
'''Kurzinfo'''
<pre>
{{Box|Info|...|Kurzinfo}}
</pre>
</div>
<div class="width-1-2">
{{Box|Info|...|Kurzinfo}}
</div>
</div>

<div class="grid">
<div class="width-1-2">
'''Experimentieren'''
<pre>
{{Box|Experiment|...|Experimentieren}}
</pre>
</div>
<div class="width-1-2">
{{Box|Experiment|...|Experimentieren}}
</div>
</div>

<div class="grid">
<div class="width-1-2">
'''Download'''
<pre>
{{Box|Download|mit (möglichst internen) Links zu herunterladbarem Material|Download}}
</pre>
</div>

<div class="width-1-2">
{{Box|Download|mit (möglichst internen) Links zu herunterladbarem Material|Download}}
</div>
</div>

<div class="grid">
<div class="width-1-2">
'''Frage'''
<pre>
{{Box|Frage|mit einer Frage|Frage}}
</pre>
</div>

<div class="width-1-2">
{{Box|Frage|mit einer Frage|Frage}}
</div>
</div>

{{Box|1=Mögliche Probleme|2=
Es gibt '''verschiedene Gründe, warum das Box_Design nicht richtig verwendet wird'''.

==== <code>=</code> das Gleichheitszeichen ====

Tritt vor allem in Links auf. Wenn der ein solches Zeichen im Text auftaucht so muss der passende Parameter für die Box explizit benannt werden. Die Parameter für die Box Vorlage sind durchnummeriert, heißen also dementsprechend <code>1</code>, <code>2</code> oder <code>3</code>

Folgende beiden Varianten sind im Ergebnis identisch. Die benannte Variante kann allerdings auch das <code>=</code> im Text enthalten.

{{2Spalten
|1=
Normale Box Syntax

<pre>{{Box | Überschrift | Inhalt | Klasse }}</pre>
|2=
benannte Box Syntax
<pre>{{Box|1=<Überschrift>|2=<Inhalt>|3=<Klasse>}}</pre>
}}

==== Tabellen ====

Weiterhin machen Tabellen in dem Inhalt ein Problem. Bei diesem und allen anderen Problemen gibt es eine alternative Möglichkeit, wie man diese "Box" erzeugen kann.

Wenn möglich sollte man auf die Verwendung von Tabellen verzichten. Falls das nicht möglich ist gibt es einige Vorlagen die man für Tabellen innerhalb einer Box verwenden kann. Es ist darauf zu achten, dass die Zeichen (Vorlagen) für die Tabellenerstellung jeweils am Anfang einer Zeile stehen.
{{(!}} class="wikitable"
{{!+}} Tabellensyntaxersetzungen innerhalb von Boxen (oder anderen Templates)
{{!-}}
!
! Wikisyntax
! Ersetzung innerhalb einer Box
{{!-}}
! Tabellenbeginn
{{!}} <code><nowiki>{|</nowiki></code>
{{!}} <code><nowiki>{{(!}}</nowiki></code>
{{!-}}
! Tabellenüberschrift
{{!}} <code><nowiki>|+</nowiki></code>
{{!}} <code><nowiki>{{!+}}</nowiki></code>
{{!-}}
! Zeilenbeginn
{{!}} <code><nowiki>|-</nowiki></code>
{{!}} <code><nowiki>{{!-}}</nowiki></code>
{{!-}}
! Zellenbeginn
{{!}} <code><nowiki>|</nowiki></code>
{{!}} <code><nowiki>{{!}}</nowiki></code>
{{!-}}
! Zelle mit Zusatzsyntax
{{!}} <code><nowiki>|colspan=2|</nowiki></code>
{{!}} <code><nowiki>{{!}}colspan=2{{!}}</nowiki></code>
{{!-}}
! Überschriftenzelle
{{!}} <code><nowiki>!</nowiki></code>
{{!}} <code><nowiki>!</nowiki></code> (keine Ersetzung notwendig)
{{!-}}
! Tabellenende
{{!}} <code><nowiki>|}</nowiki></code>
{{!}} <code><nowiki>{{!)}}</nowiki></code>
{{!)}}

===== Vergleich der Tabellensyntaxelemente =====

{{3Spalten
|1=
Ergebnis
{{(!}} class=wikitable
{{!-}}
{{!}} Zeile 1 / Spalte A
{{!}} Zeile 1 / Spalte B
{{!-}}
{{!}} Zeile 2 / Spalte A
{{!}} Zeile 2 / Spalte B
{{!)}}
|2=
Normale Tabellensyntax
<pre>
{| class=wikitable
|-
| Zeile 1 / Spalte A
| Zeile 1 / Spalte B
|-
| Zeile 2 / Spalte A
| Zeile 2 / Spalte B
|}
</pre>
|3=
Tabellensyntax innerhalb einer Box
<pre>
{{(!}} class=wikitable
{{!-}}
{{!}} Zeile 1 / Spalte A
{{!}} Zeile 1 / Spalte B
{{!-}}
{{!}} Zeile 2 / Spalte A
{{!}} Zeile 2 / Spalte B
{{!)}}
</pre>
}}

Hier ein komplizierteres Beispiel:

{{(!}} class="wikitable"
{{!+}} Eine Tabellenüberschrift
{{!}}
! Spaltenkopf A
! Spaltenkopf B
{{!-}}
! Zeilenkopf
{{!}} Zeile 1 / Spalte A
{{!}} Zeile 1 / Spalte B
{{!-}}
{{!}}
{{!}} Zeile 2 / Spalte A
{{!}} Zeile 2 / Spalte B
{{!-}}
{{!}}
{{!}} colspan=2 {{!}} Zeile 3 / Spalte A und B
{{!)}}

Und hier der zugehörige Quelltext für die Tabelle innerhalb einer Box (oder eines anderen TemplateS)
<pre>
{{(!}} class="wikitable"
{{!+}} Eine Tabellenüberschrift
{{!}}
! Spaltenkopf A
! Spaltenkopf B
{{!-}}
! Zeilenkopf
{{!}} Zeile 1 / Spalte A
{{!}} Zeile 1 / Spalte B
{{!-}}
{{!}}
{{!}} Zeile 2 / Spalte A
{{!}} Zeile 2 / Spalte B
{{!-}}
{{!}}
{{!}} colspan=2 {{!}} Zeile 3 / Spalte A und B
{{!)}}
</pre>

|3=Hervorhebung2}}

Die Namen der Klassen und das Aussehen aller Varianten, sowie die alternative Nutzungsmöglichkeit, findet man auf der Seite → [[Vorlage:Box|'''Vorlage mit verschiedenen Kästen''']]

Wenn die Auswahl nicht ausreicht gibt es mit der [[:Vorlage:Box-spezial]] die Möglichkeit viele Parameter der Vorlage beim Einbinden selbst anzupassen.

{{Hilfe Navigation}}

== Alternativ: Boxen mittels div-Containern und CSS-Klassen erstellen ==
Nicht alle Inhalte können als Parameter an Vorlagen (Templates) übergeben werden, z.B. HTML Tags im Wikitext, Tabellen und anderes.
Um trotzdem Boxen im gleichen Layout wie mittels obigen Vorlagen zu erstellen, gibt es auch korrespondierende CSS-Klassen.
Dazu muss der Text, der in einer Box stehen soll in einen div-Container eingefasst werden:

=== Das schreibt man: ===
<pre>
<div class="box ueben">
== Üben ==
...
</div>
</pre>

=== Das sieht man: ===
<div class="box ueben">
== Üben ==
mit Text für Übungen und Aufgaben
</div>

=== Folgende Boxen stehen zur Verfügung (analog oben) ===

<pre>
<div class="box hervorhebung1">
== Hervorhebung 1 ==
...
</div>

<div class="box hervorhebung2">
== Hervorhebung 2 ==
...
</div>

<div class="box zitat">
== Zitat ==
...
</div>

<div class="box arbeitsmethode">
== Arbeitsmethode ==
...
</div>

<div class="box unterrichtsidee">
== Unterrichtsidee ==
...
</div>

<div class="box meinung">
== Meinung ==
...
</div>

<div class="box lernpfad">
== Lenrpfad ==
...
</div>

<div class="box experimentieren">
== Experimentieren ==
...
</div>

<div class="box loesung">
== Lösung ==
...
</div>

<div class="box ueben">
== Üben ==
...
</div>

<div class="box kurzinfo">
== Kurzinfo ==
...
</div>

<div class="box experimentieren">
== Experimentieren ==
...
</div>

<div class="box download">
== Download ==
...
</div>
</pre>

Es müssen immmer die CSS-Klassen 'box' und ggf. die Art der Box im Beispiel oben also 'ueben' angegeben werden.

'''WICHTIG:''' Die CSS-Klassennamen müssen klein geschrieben sein, Umlaute müssen ersetzt werden (ü zu ue, ß zu sz usw.)

'''HINWEIS:''' Im Unterschied zur Verwendung des Templates werden die Überschriften im div-Container im Inhaltsverzeichnis aufgeführt. Insofern kann darüber auch gesteuert werden, welche Boxen im Inhaltsverzeichnis erscheinen sollen.

== Icon ändern ==
Das Icon lässt sich auch überschreiben mit dem Parameter <code>Icon</code>.

'''Das schreibt man'''
<pre>{{Box|Titel|Inhalt|Lösung|Icon=brainy hdg-school}}</pre>
'''Das sieht man'''
{{Box|Titel|Inhalt|Lösung|Icon=brainy hdg-school}}

== Farbe ändern ==
Die Farbe lässt sich auch überschreiben mit dem Parameter <code>Farbe</code>.

'''Das schreibt man'''
<pre>{{Box|Titel|Inhalt|Lösung|Farbe={{Farbe|orange|dunkel}} }}</pre>
'''Das sieht man'''
{{Box|Titel|Inhalt|Lösung|Farbe={{Farbe|orange|dunkel}} }}

{{Approved template}}
</noinclude>

NOEDITSECTION
<noinclude>
<templatedata>
{
"params": {
"Titel": {
"label": "Überschrift",
"type": "content",
"aliases": [
"1"
]
},
"Inhalt": {
"label": "Inhalt",
"type": "content",
"aliases": [
"2"
],
"required": true
},
"Klasse": {
"label": "Klasse",
"type": "string",
"aliases": [
"3"
],
"example": "Hervorhebung1, Frage, Lernpfad, Hervorhebung2, Merksatz, Üben, Ueben, Arbeitsmethode, Unterrichtsidee, Experimentieren, Arbeitsmethode, Unterrichtsidee, Experimentieren, Meinung, Lösung, Loesung, Download, Kurzinfo, Zitat, "
},
"Farbe": {
"type": "string"
},
"Icon": {
"type": "string"
}
},
"paramOrder": [
"Klasse",
"Titel",
"Inhalt",
"Farbe",
"Icon"
],
"format": "block"
}
</templatedata>
</noinclude>