Template:BridgeHandNWES/doc

Purpose
This template generates a diagram typical of those used in literature to present a full or partial deal in contract bridge.

Usage
The template receives up to 18 elements of data:
 * 1 for a descriptive label of up to 4 short lines (may be left blank)
 * 1 for designation of the lead (may be left blank) and
 * 16 for the card rank holdings in each of four suits for each of four players.

Either create or copy the blank template sample below, insert in article and complete as follows:

1. Add an optional Label parameter to appear in the upper left quadrant of the diagram. It allows context details of the hand to be added if relevant or appropriate.
 * Separate entries by use of a line break . Typical entries may include:

Data length must be short to fit aesthetically in upper left quadrant of the diagram; use a line break where necessary. Use line breaks between data entries. The parameter may be left blank or removed entirely.
 * 1) A deal or board number, e.g. "Board 16" or "Deal 5"
 * 2) Scoring method, e.g. "Matchpoints", "IMPs" or "Rubber"
 * 3) Contract, e.g. "South in 4"
 * 4) Vulnerability: "E-W vulnerable", "N-S vulnerable", "Both vulnerable", "None vulnerable"

2. Add an optional Lead parameter to appear in the lower left quadrant of the diagram. It can indicate the specific card led or who is on lead, e.g. "Lead: 2", or "East leads A", or "South on lead". The parameter may be left blank or removed entirely.

3. After the Lead parameter line, each of the next four lines of code represents a hand in the order of: North, West, East, South with suits in each line in the order of: spades, hearts, diamonds, clubs. When using the blank template sample from below, replace each emdash ( &amp;mdash; ) with the card ranks (A, K, Q, etc.) of each suit held by each player. Use an emdash to show a void.

4. While not required, adding a thin space ( &amp;thinsp; ) between ranks of cards improves readability and aesthetics and is preferred. Very long card holdings may require the use of hair spacing ( &amp;#8202; ) to keep the suit rank listing to a single line; two-line card holdings are possible but are aesthetically disruptive.

With optional labels
Text beside diagram.

Text below diagram.

which results in: Text beside diagram.

Text below diagram.

Without optional labels
Text beside diagram.

Text below diagram.

which results in: Text beside diagram.

Text below diagram.

With optional labels
Copy, paste and complete the following blank template into your article in accordance with the instructions at the top of this documentation page and the examples illustrated above.

Text beside diagram.

Text below diagram.

which renders the following blank deal diagram: Text beside diagram.

Text below diagram.

Without optional labels
Copy, paste and complete the following blank template into your article in accordance with the instructions at the top of this documentation page and the examples illustrated above.

Text beside diagram.

Text below diagram.

which renders the following blank deal diagram: Text beside diagram.

Text below diagram.

Surrounding text
1. The diagram is programmed to be placed to the left margin of the page.
 * Text relevant to the diagram should be added to its right by continuing it immediately after the last closing brace of the template.
 * Text for a new subject or topic should be started below the diagram by inserting the template clear after the last closing brace and then continuing with text.

2. If appropriate, a separate auction table may be used to supplement the deal diagram. It will normally be placed immediately to the right.