Vorlage:Box: Unterschied zwischen den Versionen

Aus ZUM-Unterrichten
KKeine Bearbeitungszusammenfassung
Markierung: 2017-Quelltext-Bearbeitung
Keine Bearbeitungszusammenfassung
Markierung: 2017-Quelltext-Bearbeitung
(5 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
<noinclude>
<onlyinclude>
[[Kategorie:Vorlage:Standard]]
== Boxen erstellen mittels Template ==
=== Das schreibt man: ===
<pre>
{{Box| Titel | Inhalt | class }}
</pre>
 
Als Klassen/class stehen einige Varianten zur Verfügung wie Hervorhebung1, Hervorhebung2, Zitat, ... , allerdings ist dies optional (siehe Beispiele!)
=== Das sieht man: ===
</noinclude><onlyinclude>
<div style="margin: 0 auto .5rem; overflow:hidden; border-left: 7px solid {{{Farbe|{{Farbe | {{{3|unspezifisch}}}}}}}};">
<div style="margin: 0 auto .5rem; overflow:hidden; border-left: 7px solid {{{Farbe|{{Farbe | {{{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|}}}
<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|}}}
Zeile 32: Zeile 22:
{{{2}}}</div></div></div></onlyinclude><noinclude>
{{{2}}}</div></div></div></onlyinclude><noinclude>


=== andere Beispiele ===
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|


{{Box|Hervorhebung1|mit Text für Hervorhebungen| Hervorhebung1 }}
Hier steht der Inhalt, der in der Box angezeigt wird.


{{Box|Hervorhebung2|mit Text für Hervorhebungen|Hervorhebung2}}
|Merksatz}}</pre>
</div>


{{Box|Zitat|mit Text für Zitate und Quellen|Zitat }}
<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>


{{Box|Arbeitsmethode|mit Text für Arbeitsmethoden|Arbeitsmethode }}
==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">


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


{{Box|Meinung|mit Text für Meinungen|Meinung}}


{{Box|Lernpfad |mit Text für Lernpfade|Lernpfad }}
*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:


{{Box|Experimentieren|mit Text für Experimente und Versuche|Experimentieren}}
<div class="grid">
<div class="width-1-2">


{{Box|Lösung|mit Text für Lösungen|Lösung}}
'''Hervorhebung 1'''
<pre>
{{Box|Hervorhebung1|...| Hervorhebung1}}
</pre>
</div>
<div class="width-1-2">
{{Box|Hervorhebung1|...| Hervorhebung1}}
</div>
</div>


{{Box|Üben|mit Text für Übungen und Aufgaben|Üben}}
<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>


{{Box|Merksatz|mit Text für Definitionen und Merksätzen|Merksatz}}
<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}}
{{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}}
{{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 ====


{{Box|Kurzinfo|mit Text oder integrierten Vorlagen für Kurzinfos|Kurzinfo}}
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&nbsp;→&nbsp;[[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}}




=== Hinweise zur Gestaltung dieser Vorlage ===
Diese Vorlage kann für verschiedene Elemente angepasst werden. Dazu kann die Farbe des linken Balkens und das in der Titelzeile eingeblendete Bild an dieser zentralen Stelle für alle Seiten festgelegt werden.




Zeile 85: Zeile 406:
<div class="box ueben">
<div class="box ueben">
== Üben ==
== Üben ==
...
mit Text für Übungen und Aufgaben
</div>
</div>


Zeile 189: Zeile 510:
{
{
"params": {
"params": {
"Typ": {},
"1": {
"Überschrift": {},
"label": "Überschrift",
"Text": {}
"type": "content"
},
"2": {
"label": "Inhalt",
"type": "content"
},
"3": {
"label": "Typ",
"type": "string"
}
},
},
"paramOrder": [
"paramOrder": [
"Typ",
"1",
"Überschrift",
"2",
"Text"
"3"
],
],
"format": "block"
"format": "block"

Version vom 26. Mai 2022, 05:47 Uhr

{{{1}}}
{{{2}}}

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

Beispiel

Das schreibt man:

{{Box|Hier ist die Überschrift|Hier steht der Inhalt, der in der Box angezeigt wird.|Merksatz}}

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

{{Box|Hier ist die Überschrift|

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

|Merksatz}}

Das sieht man:

Hier ist die Überschrift
Hier steht der Inhalt, der in der Box angezeigt wird.

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.

Verkürzt wird die Vorlage so verwendet:

{{Box|<Überschrift>|<Inhalt>|<Klasse>}}


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

Hervorhebung 1

{{Box|Hervorhebung1|...| Hervorhebung1}}
Hervorhebung1
...

Hervorhebung 2

{{Box|Hervorhebung2|...|Hervorhebung2}}
Hervorhebung2
...

Üben

{{Box|Üben|...|Üben}}
Üben
...

Zitat

{{Box|Zitat|....|Zitat}}
Zitat
....

Arbeitsmethode

{{Box|Arbeitsmethode|...|Arbeitsmethode}}
Arbeitsmethode
...

Unterrichtsidee

{{Box|Idee|...|Unterrichtsidee }}
Idee
...

Meinung

{{Box|Meinung|...|Meinung}}
Meinung
...

Lernpfad

{{Box|Lernpfad|...|Lernpfad}}
Lernpfad
...

Lösung

{{Box|Lösung|...|Lösung}}
Lösung
...

Merksatz

{{Box|Merke|...|Merksatz}}
Merke
...

Kurzinfo

{{Box|Info|...|Kurzinfo}}
Info
...

Experimentieren

{{Box|Experiment|...|Experimentieren}}
Experiment
...

Download

{{Box|Download|mit (möglichst internen) Links zu herunterladbarem Material|Download}}
Download
mit (möglichst internen) Links zu herunterladbarem Material

Frage

{{Box|Frage|mit einer Frage|Frage}}
Frage
mit einer Frage


Mögliche Probleme

Es gibt verschiedene Gründe, warum das Box_Design nicht richtig verwendet wird.

= 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 1, 2 oder 3

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

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

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.

Tabellensyntaxersetzungen innerhalb von Boxen (oder anderen Templates)
Wikisyntax Ersetzung innerhalb einer Box
Tabellenbeginn {| {{(!}}
Tabellenüberschrift |+ {{!+}}
Zeilenbeginn |- {{!-}}
Zellenbeginn | {{!}}
Zelle mit Zusatzsyntax |colspan=2| {{!}}colspan=2{{!}}
Überschriftenzelle ! ! (keine Ersetzung notwendig)
Tabellenende |} {{!)}}


Vergleich der Tabellensyntaxelemente
Ergebnis
Zeile 1 / Spalte A Zeile 1 / Spalte B
Zeile 2 / Spalte A Zeile 2 / Spalte B
Normale Tabellensyntax
{| class=wikitable
|-
| Zeile 1 / Spalte A
| Zeile 1 / Spalte B
|-
| Zeile 2 / Spalte A
| Zeile 2 / Spalte B
|}
Tabellensyntax innerhalb einer Box
{{(!}} class=wikitable
{{!-}}
{{!}} Zeile 1 / Spalte A 
{{!}} Zeile 1 / Spalte B
{{!-}}
{{!}} Zeile 2 / Spalte A 
{{!}} Zeile 2 / Spalte B
{{!)}}


Hier ein komplizierteres Beispiel:

Eine Tabellenüberschrift
Spaltenkopf A Spaltenkopf B
Zeilenkopf Zeile 1 / Spalte A Zeile 1 / Spalte B
Zeile 2 / Spalte A Zeile 2 / Spalte B
Zeile 3 / Spalte A und B

Und hier der zugehörige Quelltext für die Tabelle innerhalb einer Box (oder eines anderen TemplateS)

{{(!}} 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
{{!)}}

Die Namen der Klassen und das Aussehen aller Varianten, sowie die alternative Nutzungsmöglichkeit, findet man auf der Seite → 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.




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:

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


Das sieht man:

Üben

mit Text für Übungen und Aufgaben


Folgende Boxen stehen zur Verfügung (analog oben)

<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>


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 Icon.

Das schreibt man

{{Box|Titel|Inhalt|Lösung|Icon=brainy hdg-school}}

Das sieht man

Titel
Inhalt

Farbe ändern

Die Farbe lässt sich auch überschreiben mit dem Parameter Farbe.

Das schreibt man

{{Box|Titel|Inhalt|Lösung|Farbe={{Farbe|orange|dunkel}} }}

Das sieht man

Titel
Inhalt


{{{1}}}
{{{2}}}



Keine Beschreibung.

Vorlagenparameter

Diese Vorlage bevorzugt Blockformatierung von Parametern.

ParameterBeschreibungTypStatus
Überschrift1

keine Beschreibung

Inhaltoptional
Inhalt2

keine Beschreibung

Inhaltoptional
Typ3

keine Beschreibung

Zeichenfolgeoptional