# Shogi/ Vorlage:Diagramm

* a
* b
* c
* d
* e
* f
* g
* h
* i
{{{84}}} :

### Verwendung

Mit dieser Vorlage können auf einfache Art Diagramme für Positionen beim Spiel Shogi erstellt werden.

### Syntax

Ein Beispiel für die Startposition bei Shogi steht im Abschnitt Even game between players of same rank dieser Beschreibung.

#### Parameter

* <1>: "tright" and "tleft" sets the horizontal placement of the diagram in the article space: "tright" means diagram will be floated to the right allowing any text to flow to the left, and "tleft" means diagram will be floated to the left allowing any text to flow to the right. No entry for this parameter means that the diagram will simply be displayed in the default position on the left.
* <2>: Explanation added to top of diagram; For example, a player's name, etc. (optional)
* <3> to <83>: Each number represents a square on the board, from square 3 (9th file, ath rank: "9a") in the upper left of the board to square 83 (1st file, ith rank: "1i") in the lower right of the board. Codes for "piece types" (see below) can be entered to display pieces on the board. No entry of a code means no piece will be displayed on that particular square.
* <84>: Explanation added to bottom of diagram; For example, a player's name, etc. (optional)
* <85>: Festlegung, ob auf der linken Seite einer jeden Zeile japanische Zahlzeichen angezeigt werden sollen oder nicht (optional) – ohne Angabe keine Anzeige, bei beliebigem Wert mit Anzeige (siehe das erste Beispiel unten)

#### Hinweis für Erweiterungen der Vorlage

Sofern die Vorlage um weitere Parameter erweitert werden soll, müssen diese unbedingt am Ende angefügt werden, damit die Nummerierung der vorhandenen Parameter nicht zerstört wird.

### Eintrag für "Piece type"

Felder ohne Eintrag für "piece type" (siehe die Erläuterung im Shogi-Buch) werden als "leeres Feld" angezeigt.
A "piece type" is designated by a combination of two to fice letters like XXYZS.

#### The XX part represents a one or two letter combination which indicates the piece type.

    The piece type codes are as follows:
   * / k - 玉将 (gyokushō) or 王将 (Ōshō) (king)
   * r - 飛車 (hisha) (rook)
   * b - 角行 (kakugyō) (bishop)
   * g - 金将 (kinshō) (gold)
   * s - 銀将 (ginshō) (silver)
   * n - 桂馬 (keima) (knight)
   * l - 香車 (kyōsha) (lance)
   * p - 歩兵 (fuhyō) (pawn)
   * d - 龍王 (ryūō) (dragon or promoted rook)
      * dx - 竜王 (ryūō) (simplified character for promoted rook)
   * h - 龍馬 (ryūma) (horse or promoted bishop)
   * ps - 成銀 (narigin) (promoted silver)
   * pn - 成桂 (narikei) (promoted knight)
      * pnx - (variant character for promoted knight)
   * pl - 成香 (narikyō) (promoted lance)
      * plx - (variant character for promoted lance)
   * t - と金 (tokin) (tokin or promoted pawn)
      * tx - (variant character for promoted pawn)
    Sho shogi codes:
   * e - 酔象 (suizō) (elephant)
   * t - 太子 (taishi) (crown prince or promoted elephant)
    Please note that all of the above combinations are case sensitive, so lower case letters must be used.
    All things considered equal, the "king" of the player who is "sente" (i.e., the player who moves first) is indicated by 玉 and the "king" of the player who is "gote" (i.e., the player moves second) is indicated by 王. In even games between players of different ranks, the "king" of the higher ranked player is 王, and the "king" of the lower ranked player is 玉. In handicap shogi, even though the player giving the handicap (上手, uwate) moves first, their "king" is 王 and the "king" of the player receiving the handicap (下手, shitate) is 玉. In problems, the "king" of the attacking (or mating) side is 玉 and the "king" of the defending side is 王. To indicate 玉 for "gote" (e.g., the lower ranked player in an even game is "gote") or 王 for "sente", insert ak instead of k into the template.

#### Sente oder gote

The Y indicates sente (black) or gote (white). For "sente" add the letter s, and for "gote" add the letter g to the end of the character string. Sente's pieces will be displayed at the bottom of the board facing up and gote's pieces will be displayed at the top of the board facing down. So a "pawn" for "sente" is indicated as ps, while a "rook" for "gote" is indicated as rg.
   * - ps
   * - pg

#### Last move played

The Z indicates the last move played. To indicate a piece that has just been moved, add the letter l (for last) to the end of the character string. For example, the show indicate that the last piece moved was a "rook" by "gote", use rgl.
   * - rg
   * - rgl

#### Pieces-in-hand

Pieces-in-hand can be entered directly into parameters 2 and 84. The following characters and templates can be used: 歩 for "pawn", 香 for "lance", 桂 for "knight", 銀 for "silver", 金 for "gold", 角 for "bishop", and 飛 for "rook". To indicate that a player is holding more than one of the same type of piece in hand use piece type + (number); for example, having two pawns in hand can be indicated as 歩 (2).

### Exhaustive piece exemplification

| ps | pg | psl | pgl |
| ts | tg | tsl | tgl |
| txs | txg | txsl | txgl |
| ls | lg | lsl | lgl |
| pls | plg | plsl | plgl |
| plxs | plxg | plxsl | plxgl |
| ns | ng | nsl | ngl |
| pns | png | pnsl | pngl |
| pnxs | pnxg | pnxsl | pnxgl |
| ss | sg | ssl | sgl |
| pss | psg | pssl | psgl |
| gs | gg | gsl | ggl |
| bs | bg | bsl | bgl |
| hs | hg | hsl | hgl |
| rs | rg | rsl | rgl |
| ds | dg | dsl | dgl |
| dxs | dxg | dxsl | dxgl |
| ks | kg | ksl | kgl |
| aks | akg | aksl | akgl |
| es | eg | esl | egl |
| as | ag | asl | agl |

#### Other diagram files

These files can be used to create diagrams for explaining certain positions or indicating piece movement.
   * yy - highlighted yellow square (yy is for 'yellow')
   * gr - highlighted gray square (gr is for 'gray')
   * rat - indicate movement from left to right (rat is for 'right arrow tip')
   * lat - indicate movement from right to left (lat is for 'left arrow tip')
   * uat - indicate movement from bottom to top (uat is for 'upward arrow tip')
   * dat - indicate movement from top to bottom (dat is for 'downward arrow tip')
   * lra - indicate movement from right to left or left to right (lra is for 'left right arrow')
   * las - indicate start positiong for movement from left to right (las is for 'left arrow start')
   * ras - indicate start position from right to left (ras is for 'right arrow start')
   * uda - indicate movement from bottom to top or top to bottom (uda is for 'up down arrow')
   * das - indicate start position for movement from top to bottom (das is for 'down arrow start')
   * uas - indicate start position for movement from bottom to top (uas is for 'up arrow start')
   * da - indicate movement diagonally left to right (da is for 'diagonal arrow')
   * dau - indicate movement diagonally upward to the right (dau is for 'diagonal arrow upward')
   * dad - indicate movement diagonally downward to the left (dad is for 'diagonal arrow downward')
   * daus - indicate start position for movement diagonally upward to right (daus is for 'diagonal arrow upward start')
   * dads - indicate start position for movement diagonally downward to left (dads is for 'diagonal arrow downward start')
   * daa - indicate movement diagonally right to left (daa is for 'diagonal arrow averse')
   * daad - indicate movement diagonally downward to right (daad is for 'diagonal arrow averse downward')
   * daau - indicate movement diagonally upward to left (daau is for 'diagonal arrow averse upward')
   * daaus - indicate start position for movement diagonally upward to left (daaus is for 'diagonal arrow averse upward start')
   * daads - indicate start position for movement diagonally downward to right (daads is for 'diagonal arrow averse downward start')
   * kar - indicate movement of knight upward to the right (kar is for 'knight arrow right')
   * kal - indicate movement of knight upward to the left (kal is for 'knight arrow left')
   * kadr - indicate movement of knight downward to the right (kadr is for 'knight arrow down right')
   * kadl - indicate movement of knight downward to the left (kadl is for 'knight arrow down left')
   * ‎ rah - indicate start position for a move one square to the right (rah is for 'right arrow half')
   * lah - indicate start position for a move one square to the left (lah is for 'left arrow half')
   * dah - indicate start position for a move one square downward (dah is for 'down arrow half')
   * uah - indicate start position for a move one square upward (kadl is for 'up arrow half')
   * durh - indicate start position for a move one square diagonally upward to the right (durh is for 'diagonal up right half')
   * dulh - indicate start position for a move one square diagonally upward to the left (dulh is for 'diagonal up left half')
   * ddrh - indicate start position for a move one square diagonally downward to the right (ddrh is for 'diagonal down right half')
   * ddlh - indicate start position for a move one square diagonally downward to the left (ddlh is for 'diagonal down left half')
   * ddl - indicate movement of silver downward to the left (ddl is for 'diagonal down left')
   * ddr - indicate movement of silver downward to the right (ddr is for 'diagonal down right')
   * dul - indicate movement of silver downward to the left (dul is for 'daigonal up left')
   * dur - indicate movement of silver downward to the right (dur is for 'diagonal up right')

### Beispiele

The following are examples of the types of diagrams which can be created.

#### Even game between players of same rank

Diagrams for such positions typically show "sente" at the bottom of the board, and "gote" at the top. Relevant information such as player names, tournament names, etc. may be entered into parameters <2> and <84> if desired.
Zusätzlich wird hier der Parameter <85> festgelegt; deshalb stehen links die japanischen Zahlzeichen.
| 一 | a |
| 二 | b |
| 三 | c |
| 四 | d |
| 五 | e |
| 六 | f |
| 七 | g |
| 八 | h |
| 九 | i |
Sente Pieces-in-hand: none :

#### Even game, sente and gote reversed

* a
* b
* c
* d
* e
* f
* g
* h
* i
Gote Pieces-in-hand: none :

#### Even game, gote lower ranked player

* a
* b
* c
* d
* e
* f
* g
* h
* i
Sente Pieces-in-hand: none :

#### Handicap game (rook handicap)

* a
* b
* c
* d
* e
* f
* g
* h
* i
Shitate Pieces-in-hand: none :

#### Last move played (e.g., Position after ....)

The diagram for the position after the moves 1. P-2f, 2. P-8d, 3. P-2e, 4. P-8e, 5. G-7h, 6. G-3b, 7. P-2d, 8. Px2d, 9. Rx2d is created as follows:
* a
* b
* c
* d
* e
* f
* g
* h
* i
Sente Pieces-in-hand: 歩 :

#### Tsumeshogi problems

Example of how this diagram can be used for "tsumeshogi" problems
* a
* b
* c
* d
* e
* f
* g
* h
* i
Sente Pieces-in-hand: 銀 :

#### Highligting squares and indicating piece movement

Examples of how specific square can be highlighted and piece movement indicated.
* a
* b
* c
* d
* e
* f
* g
* h
* i
Sente :
* a
* b
* c
* d
* e
* f
* g
* h
* i
Sente :

### Alternative Versionen

This diagram uses an Arabic numeral to designate each file, and a lowercase alphabetic character to designate each rank.
This template can be easily edited to use Arabic numerals or kanji numerals to designate ranks by simply replacing the number text.
To create a diagram with no rank or file designations, simply delete rows of number and letter (oder benutze weitere Parameter ähnlich der Verwendung von <85>).
Regardless of how the ranks are designated, care should be taken to use a form of notation consistent with the diagram to avoid confusion.

### Siehe auch

* Japanese Wikipedia shogi diagram template
* Diese Vorlage ersetzt sowohl w:en:Template:Shogi diagram dual num als auch w:en:Template:Shogi diagram.
* Verwendung der Vorlage
* Diese Dokumentation befindet sich auf einer eingebundenen Unterseite.
* Druckversion erstellen.
* Liste der Unterseiten.