Quelltext der Seite Benutzer:Thornard/Vorlage:Schachbrett/Doku

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
Die Vorlage „Standard chess diagram“ ist das Ergebnis von Diskussionen und Abstimmungen, die in [[:meta:WikiProject_Chess|WikiProject Chess on Meta-Wiki]] stattgefunden haben. Sie basiert auf einer Vorlage „Chess position“, die in der englischsprachigen Wikipedia verbreitet benutzt wird. Sowohl die Vorlage als auch die Bilder der Figuren wurden verändert.

== Syntax ==

<pre style="overflow:auto; min-width:250px;">
{{Benutzer:Thornard/Schachbrett
| Ausrichtung=
| Titel=
| Z8=<a8>/<b8>/<c8>/<d8>/<e8>/<f8>/<g8>/<h8>/
| Z7=<a7>/<b7>/<c7>/<d7>/<e7>/<f7>/<g7>/<h7>/
| Z6=<a6>/<b6>/<c6>/<d6>/<e6>/<f6>/<g6>/<h6>/
| Z5=<a5>/<b5>/<c5>/<d5>/<e5>/<f5>/<g5>/<h5>/
| Z4=<a4>/<b4>/<c4>/<d4>/<e4>/<f4>/<g4>/<h4>/
| Z3=<a3>/<b3>/<c3>/<d3>/<e3>/<f3>/<g3>/<h3>/
| Z2=<a2>/<b2>/<c2>/<d2>/<e2>/<f2>/<g2>/<h2>/
| Z1=<a1>/<b1>/<c1>/<d1>/<e1>/<f1>/<g1>/<h1>/
| Beschreibung=
| center=
}}
</pre>
oder

<pre style="overflow:auto; min-width:250px;">
{{Benutzer:Thornard/Schachbrett
| Ausrichtung=
| Titel=
| FEN=
| Beschreibung=
| center=
}}
</pre>

Parameter:
* <code>Ausrichtung</code> – legt die horizontale Ausrichtung des Diagramms auf der Seite fest; zulässige Werte: "tright" und "tleft"
* <code>Titel</code> – der Text, der oberhalb des Diagramms erscheint; darf leer sein
* <code>FEN</code> – die Stellung als in FEN codiert; darf leer sein, dann muss die Stellung mit den Parametern <code>Z8</code> bis <code>Z1</code> beschrieben werden.
* <code>Z8</code> bis <code>Z1</code> - die Stellung: <code><nowiki><a8>, <b8></nowiki>, … <nowiki><h1></nowiki></code> – jeweils zwei Zeichen, welche die Belegung des betreffenden Felds festlegen. Zulässige Werte siehe unter "Legende".
* <code>Beschreibung</code> – der Text, der unterhalb des Diagramms erscheint; darf leer sein
* <code>center=1</code> – zentriert die Beschreibung unter dem Schachbrett, wenn ein beliebiger Wert angegeben ist (üblicherweise wird <code>1</code> verwendet)
;Hinweise:

* Einbindungen oder externe Beispiele nach der alten Syntax können mit [[Vorlage:Schachbrett/Konvertieren]] umgeformt werden.

== Kopiervorlage ==

Das leere Brett:
{{Benutzer:Thornard/Schachbrett
| Ausrichtung =
| Titel =
<!-- a   b  c  d  e  f  g  h -->
| Z8=--/--/--/--/--/--/--/--/
| Z7=--/--/--/--/--/--/--/--/
| Z6=--/--/--/--/--/--/--/--/
| Z5=--/--/--/--/--/--/--/--/
| Z4=--/--/--/--/--/--/--/--/
| Z3=--/--/--/--/--/--/--/--/
| Z2=--/--/--/--/--/--/--/--/
| Z1=--/--/--/--/--/--/--/--/
<!-- a   b  c  d  e  f  g  h -->
| Beschreibung = 
| center = 
}}<pre style="white-space:pre-wrap;">
{{Benutzer:Thornard/Schachbrett
| Ausrichtung =
| Titel =
<!-- a   b  c  d  e  f  g  h -->
| Z8=--/--/--/--/--/--/--/--/
| Z7=--/--/--/--/--/--/--/--/
| Z6=--/--/--/--/--/--/--/--/
| Z5=--/--/--/--/--/--/--/--/
| Z4=--/--/--/--/--/--/--/--/
| Z3=--/--/--/--/--/--/--/--/
| Z2=--/--/--/--/--/--/--/--/
| Z1=--/--/--/--/--/--/--/--/
<!-- a   b  c  d  e  f  g  h -->
| Beschreibung = 
| center = 
}}
</pre>
Hier einfach für nichtleere Felder das "--" ersetzen.
{{Benutzer:Thornard/Schachbrett
| Ausrichtung =
| Titel =
| FEN = 8/8/8/8/8/8/8/8
| Beschreibung = 
| center = 
}}<pre style="white-space:pre-wrap;">
{{Benutzer:Thornard/Schachbrett
| Ausrichtung =
| Titel =
| FEN = 8/8/8/8/8/8/8/8
| Beschreibung = 
| center = 
}}
</pre>

== Beispiele ==
Ein paar praktische Hinweise:
* Falls du das Zeichen "=" im Titel oder in der Beschreibung verwenden möchtest, musst du es in nowiki-Elemente einschließen oder durch <code>&amp;#61;</code> ersetzen.
* Du kannst Formatierungen wie '''fett''' oder ''kursiv'' benutzen.

{{Benutzer:Thornard/Schachbrett
| Titel=
| Ausrichtung= tright
| Beschreibung= Ubi scacci stant ad initium ludi. "X" est in loco primi motus solitissimi. Puncta indicat motus possibiles equitum.
<!-- a  b  c  d  e  f  g  h -->
| Z8=rd/nd/bd/qd/kd/bd/nd/rd/
| Z7=pd/pd/pd/pd/pd/pd/pd/pd/
| Z6=xo/--/xo/--/--/xo/--/xo/
| Z5=--/--/--/--/--/--/--/--/
| Z4=--/--/--/--/xx/--/--/--/
| Z3=oo/--/oo/--/--/oo/--/oo/
| Z2=pl/pl/pl/pl/pl/pl/pl/pl/
| Z1=rl/nl/bl/ql/kl/bl/nl/rl/
<!-- a  b  c  d  e  f  g  h -->
}}
<pre style="overflow:auto; min-width:250px;">
{{Benutzer:Thornard/Schachbrett
| Titel=
| Ausrichtung= tright
| Beschreibung= Ubi scacci stant ad initium ludi. "X" est in loco primi motus solitissimi. Puncta indicat motus possibiles equitum.
<!-- a  b  c  d  e  f  g  h -->
| Z8=rd/nd/bd/qd/kd/bd/nd/rd/
| Z7=pd/pd/pd/pd/pd/pd/pd/pd/
| Z6=xo/--/xo/--/--/xo/--/xo/
| Z5=--/--/--/--/--/--/--/--/
| Z4=--/--/--/--/xx/--/--/--/
| Z3=oo/--/oo/--/--/oo/--/oo/
| Z2=pl/pl/pl/pl/pl/pl/pl/pl/
| Z1=rl/nl/bl/ql/kl/bl/nl/rl/
<!-- a  b  c  d  e  f  g  h -->
}}
</pre>

=== Standarddiagramm ===

{{Benutzer:Thornard/Schachbrett
| Titel=
| Ausrichtung= tright
| Beschreibung=Königsgambit
| center=1
<!-- a  b  c  d  e  f  g  h -->
| Z8=rd/nd/bd/qd/kd/bd/nd/rd/
| Z7=pd/pd/pd/pd/--/pd/pd/pd/
| Z6=--/--/--/--/--/--/--/--/
| Z5=--/--/--/--/pd/--/--/--/
| Z4=--/--/--/--/pl/pl/--/--/
| Z3=--/--/--/--/--/--/--/--/
| Z2=pl/pl/pl/pl/--/--/pl/pl/
| Z1=rl/nl/bl/ql/kl/bl/nl/rl/
<!-- a  b  c  d  e  f  g  h -->
}}
<pre style="overflow:auto; min-width:250px;">
{{Benutzer:Thornard/Schachbrett
| Titel=
| Ausrichtung= tright
| Beschreibung=Königsgambit
| center=1
<!-- a  b  c  d  e  f  g  h -->
| Z8=rd/nd/bd/qd/kd/bd/nd/rd/
| Z7=pd/pd/pd/pd/--/pd/pd/pd/
| Z6=--/--/--/--/--/--/--/--/
| Z5=--/--/--/--/pd/--/--/--/
| Z4=--/--/--/--/pl/pl/--/--/
| Z3=--/--/--/--/--/--/--/--/
| Z2=pl/pl/pl/pl/--/--/pl/pl/
| Z1=rl/nl/bl/ql/kl/bl/nl/rl/
<!-- a  b  c  d  e  f  g  h -->
}}
</pre>
Dieses Diagramm wird empfohlen zur allgemeinen Verwendung in Artikeln über Eröffnungen, Endspiele, Spielverläufe, Positionen usw. Siehe zugehörigen Code unten.

Weitere Beispiele:
* [[:en:Ruy Lopez|Ruy Lopez]] (englisch)
* [[:en:Lucena position|Lucena position]] (englisch)

=== Diagramm mit beiden Überschriften ===
Es ist günstig, dieses in Artikeln über Schachprobleme zu verwenden. Beachte, dass du im Titel und in der Beschreibung '''fett''' und ''kursiv'' formatieren kannst. Du kannst auch <code><nowiki><br /></nowiki></code> für Zeilenumbrüche verwenden.

Weitere Beispiele:
* [[:en:Chess problem|Chess problem]] (englisch)
* [[:en:Endgame study|Endgame study]] (englisch)

{{Benutzer:Thornard/Schachbrett
| Titel= '''W. Langstaff''', ''Chess Amateur'' 1922
| Ausrichtung= tright
| Beschreibung= Matt in zwei Zügen
Dieses Problem erfordert eine "partial retrograde analysis"-Methode.
<!-- a  b  c  d  e  f  g  h -->
| Z8=--/--/--/--/kd/--/--/rd/
| Z7=--/--/--/--/--/--/--/--/
| Z6=--/--/--/--/--/bl/--/pl/
| Z5=--/--/--/rl/--/kl/pd/pl/
| Z4=--/--/--/--/--/--/--/--/
| Z3=--/--/--/--/--/--/--/--/
| Z2=--/--/--/--/--/--/--/--/
| Z1=--/--/--/--/--/--/--/--/
<!-- a  b  c  d  e  f  g  h -->
}}
<pre style="overflow:auto; min-width:250px;">
{{Benutzer:Thornard/Schachbrett
| Titel= '''W. Langstaff''', ''Chess Amateur'' 1922
| Ausrichtung= tright
| Beschreibung= Matt in zwei Zügen
Dieses Problem erfordert eine "partial retrograde analysis"-Methode.
<!-- a  b  c  d  e  f  g  h -->
| Z8=--/--/--/--/kd/--/--/rd/
| Z7=--/--/--/--/--/--/--/--/
| Z6=--/--/--/--/--/bl/--/pl/
| Z5=--/--/--/rl/--/kl/pd/pl/
| Z4=--/--/--/--/--/--/--/--/
| Z3=--/--/--/--/--/--/--/--/
| Z2=--/--/--/--/--/--/--/--/
| Z1=--/--/--/--/--/--/--/--/
<!-- a  b  c  d  e  f  g  h -->
}}
</pre>

=== Diagramm ohne Überschriften ===

Das Diagramm ist links ausgerichtet, um den Gebrauch des ersten Parameters zu erläutern.

{{Benutzer:Thornard/Schachbrett
| Ausrichtung= tleft
<!-- a  b  c  d  e  f  g  h -->
| Z8=--/--/--/--/--/--/--/--/
| Z7=--/--/--/--/--/--/--/--/
| Z6=--/xx/xo/xx/--/--/--/--/
| Z5=--/--/pl/--/--/--/--/--/
| Z4=--/--/--/--/--/xo/--/--/
| Z3=--/--/--/--/xx/xo/xx/--/
| Z2=--/--/--/--/--/pl/--/--/
| Z1=--/--/--/--/--/--/--/--/
<!-- a  b  c  d  e  f  g  h -->
}}
<pre style="overflow:auto; min-width:250px;">
{{Schachbrett
| Ausrichtung= tleft
<!-- a  b  c  d  e  f  g  h -->
| Z8=--/--/--/--/--/--/--/--/
| Z7=--/--/--/--/--/--/--/--/
| Z6=--/xx/xo/xx/--/--/--/--/
| Z5=--/--/pl/--/--/--/--/--/
| Z4=--/--/--/--/--/xo/--/--/
| Z3=--/--/--/--/xx/xo/xx/--/
| Z2=--/--/--/--/--/pl/--/--/
| Z1=--/--/--/--/--/--/--/--/
<!-- a  b  c  d  e  f  g  h -->
}}
</pre>

=== Kleines Diagramm ===
Diese Vorlage kann zweckmäßig in Artikeln mit vielen Diagrammen sein.  Sie verwendet eine weitere Vorlage namens „Schachbrett-klein“.
{{Schachbrett-klein
| Titel=
| Ausrichtung= tright
| Beschreibung= Position nach dem 11. Zug Lg5.
<!-- a  b  c  d  e  f  g  h -->
| Z8=rd/--/--/qd/--/rd/kd/--/
| Z7=pd/pd/--/--/pd/pd/bd/pd/
| Z6=--/nd/pd/--/--/nd/pd/--/
| Z5=--/--/ql/--/--/--/bl/--/
| Z4=--/--/--/pl/pl/--/bd/--/
| Z3=--/--/nl/--/--/nl/--/--/
| Z2=pl/pl/--/--/--/pl/pl/pl/
| Z1=--/--/--/rl/kl/bl/--/rl/
<!-- a  b  c  d  e  f  g  h -->
}}

<pre style="overflow:auto; min-width:250px;">
{{Schachbrett-klein
| Titel=
| Ausrichtung= tright
| Beschreibung= Position nach dem 11. Zug Lg5.
<!-- a  b  c  d  e  f  g  h -->
| Z8=rd/--/--/qd/--/rd/kd/--/
| Z7=pd/pd/--/--/pd/pd/bd/pd/
| Z6=--/nd/pd/--/--/nd/pd/--/
| Z5=--/--/ql/--/--/--/bl/--/
| Z4=--/--/--/pl/pl/--/bd/--/
| Z3=--/--/nl/--/--/nl/--/--/
| Z2=pl/pl/--/--/--/pl/pl/pl/
| Z1=--/--/--/rl/kl/bl/--/rl/
<!-- a  b  c  d  e  f  g  h -->
}}
</pre>
<!-- Umwandlung fehlt noch. -->
=== Capablanca-Schach ===
Schachbretter mit anderen Abmessungen brauchen eigene Vorlagen.
{{Schachbrett-8x10
| tright
|
|Brett=

 8 |rd|nd|ad|bd|qd|kd|bd|cd|nd|rd| 8_=
 7 |pd|pd|pd|pd|pd|pd|pd|pd|pd|pd| 7_=
 6 |  |  |  |  |  |  |  |  |  |  | 6_=
 5 |  |  |  |  |  |  |  |  |  |  | 5_=
 4 |  |  |  |  |  |  |  |  |  |  | 4_=
 3 |  |  |  |  |  |  |  |  |  |  | 3_=
 2 |pl|pl|pl|pl|pl|pl|pl|pl|pl|pl| 2_=
 1 |rl|nl|al|bl|ql|kl|bl|cl|nl|rl| 1_=
    a  b  c  d  e  f  g  h  i  j

| Capablanca-Schach
| center=1
}}

<pre style="overflow:auto; min-width:250px;">
{{Schachbrett-8x10
| tright
|
|Brett=

 8 |rd|nd|ad|bd|qd|kd|bd|cd|nd|rd| 8_=
 7 |pd|pd|pd|pd|pd|pd|pd|pd|pd|pd| 7_=
 6 |  |  |  |  |  |  |  |  |  |  | 6_=
 5 |  |  |  |  |  |  |  |  |  |  | 5_=
 4 |  |  |  |  |  |  |  |  |  |  | 4_=
 3 |  |  |  |  |  |  |  |  |  |  | 3_=
 2 |pl|pl|pl|pl|pl|pl|pl|pl|pl|pl| 2_=
 1 |rl|nl|al|bl|ql|kl|bl|cl|nl|rl| 1_=
    a  b  c  d  e  f  g  h  i  j

| Capablanca-Schach
| center=1
}}
</pre>

=== Chaturanga ===
Die Chaturanga-Vorlage kann für alle Spiele auf einem 8x8-Brett verwendet werden.

Weitere Beispiele:
* [[:en:Shatranj|Shatranj]] (englisch)
* [[:en:Chaturaji|Chaturaji]] (englisch)
{{Schachbrett-Chaturanga
| tright
|
|Brett=

 8 |rd|nd|bd|qd|kd|bd|nd|rd| 8_=
 7 |  |  |  |  |  |  |  |  | 7_=
 6 |pd|pd|pd|pd|pd|pd|pd|pd| 6_=
 5 |  |  |  |  |  |  |  |  | 5_=
 4 |  |  |  |  |  |  |  |  | 4_=
 3 |pl|pl|pl|pl|pl|pl|pl|pl| 3_=
 2 |  |  |  |  |  |  |  |  | 2_=
 1 |rl|nl|bl|ql|kl|bl|nl|rl| 1_=
    a  b  c  d  e  f  g  h

| '''Makruk''' – Anfangsstellung
}}
<pre style="overflow:auto; min-width:250px;">
{{Schachbrett-Chaturanga
| tright
|
|Brett=

 8 |rd|nd|bd|qd|kd|bd|nd|rd| 8_=
 7 |  |  |  |  |  |  |  |  | 7_=
 6 |pd|pd|pd|pd|pd|pd|pd|pd| 6_=
 5 |  |  |  |  |  |  |  |  | 5_=
 4 |  |  |  |  |  |  |  |  | 4_=
 3 |pl|pl|pl|pl|pl|pl|pl|pl| 3_=
 2 |  |  |  |  |  |  |  |  | 2_=
 1 |rl|nl|bl|ql|kl|bl|nl|rl| 1_=
    a  b  c  d  e  f  g  h

| '''Makruk''' – Anfangsstellung
}}
</pre>

== Konversion FEN --> Wiki-Vorlage ==
* [[Spezial:Vorlagen expandieren]] aufrufen.
* Im Eingabefenster <code><nowiki>{{Schachbrett/Fen2Wiki|Fen= }}</nowiki></code> eingeben und hinter "Fen=" die FEN-Notation einfügen.
* auf "Vorlage expandieren" klicken.
Als Ergebnis erhält man die Kopiervorlage für die acht Parameter Z8, Z7, Z6, Z5, Z4, Z3, Z2, und Z1, welche man im Artikel für die Einbindung der [[Vorlage:Schachbrett]] braucht. Für die Richtigkeit der FEN-Notation muss der Anwender sorgen, denn das Tool überprüft nichts.

== Legende ==
{{Schachbrett/Legende}}

[[Kategorie:Vorlage:Schach|Schachbrett]]