⠀
Documentació de la plantilla [mostra ] [modifica el codi ] [mostra l'historial ] [refresca ]{{Braille cell|A|B|C}} →⠁⠃⠉{{Braille cell|A|B|C|type=image|size=15px}} →
{{Braille cell|code1|code2|code3|...|code20|lang=|type=|size=|caption=|background=}}By default the braille language isEnglish braille (grade 2), and any abstract form ("dots-136").
{{subst:Braille cell|code1}}code1, 2, 3, ..., 20. Letter definitions to be translated to a braille cell (case insensitive, A=a). Only the first unnamed parameter is evaluated when this template is substituted, and onlydot patterns in numeric order are valid input.
lang for thebraille language. Four braille languages are recognised:English (grade 2),French,Japanese andKorean braille. English (grade 2) braille is default so doesn't have to be entered, the other languages should be defined (e.g.lang=Japanese).
type. Type of braille cell to be shown: 6-dot cell image, 8-dot cell image, in-line text character6, 6dot, 8, 8dot, image, text. The default is text (inline font character). For Japanese and Korean braille script, enteringtype=Korean produces illustrative colored braille cells (seeKorean braille). These two types are default for their languages.
size. Width size of the image (inpx) of font-size of the inline text (like %, em, px). Add the unit to the number (e.g.size=20px for 6dot/8dot images, and10px, 2em, 150% for fontsize).
caption. A descriptive caption (mouse hover text) for a braille character is added. It can be shortened to the simple definition (caption= (<blank>), and be hidden (caption=no).
background orbg. Sets the background color. Fortype=text only. Default is#f4f4f4. Examples:
{{Braille cell|K|L|M|type=text}} →⠅⠇⠍{{Braille cell|K|L|M|type=text|background=yellow}} →⠅⠇⠍{{Braille cell|K|L|M|type=text|background=transparent}} →⠅⠇⠍Possible input: plain text and various braille cell definitions (see below). Up to 20 cells can be indicated in a single call to the template, each dot pattern separated with a pipe character "|". Skipping a code is read as a blank cell (e.g.{{braille cell|A||b|o|o|k introduces a blank cell after "A").All defined input values will output a singleBraille cell.
Acceptable input values to produce braille cells are of the following types:
Simple English letters - capital or lower case: "A", "c", "X", "W", "z", etc. Valid for 6-dot, 8-dot, text, and Japanese type cells.
Accented French letters - capital or lower case: "È", "Ö", "å", etc.
Double letters and words - capital or lower case: "st", "SH", "for", "Th", "ing", etc.
Japanese letters -Katakana,hiragana, and Japanese diacritics (e.g. "dakuten", "chōon", "-Y-", etc.) are valid input for 6-dot, 8-dot, text, and Japanese cell types, withRomaji valid for Japanese cells only.
Korean letters - The {{positional Hangul jamo}} are valid input for 6-dot, 8-dot, text, and Korean cell types, with Revised Romanization (X- for initial, -X for final consonants) valid for Korean cells only.
Numbers - prefixed with a number sign: "#0" (="J"), "#7" (="G"), etc.
Punctuation - signs or names: "exclamation", ".", "openquote", "bracket", etc.
Other symbols - "null" or "blank", "accent" or "`", "contraction" or "contr2", "capital", "decimal", "contr3" or "space" (dots 4+5), "correction", "cursive" or "contr1", "number" or "#".
Notes - For the question mark "?" in French, uselang=French. Otherwise it will produce (default) the English braille. The French "space" is the third English Braille contraction prefix, while English Braille space is "blank" or "null", and French "cursive" is the first English Braille contractions prefix.
Four options can be used in this Braille cell template to produce a cell, and all are case-insensitive (A=a).
{{braille cell|1234|1423|⠏|U+280F||u+280f}} →⠏⠏⠏⠏⠏Note that this cell definition is unrelated to any language (no "A" assigned).
A braille cell is defined bynaming the raised dots. In 6-dot notation there are 64 combinations, in 8-dot notation this number is 256 (including all 6-dot cells). Such a definition isindependent of the braille language (there is no connection with a letterA; this is for the Braille language to add).
Using the cell numbering shown here, one can simply mention the raised dots: say dots-1234 for⠏. The numeric order can be in raising numeric order ("123456"), or in row-by-row order ("142536"), so the same cell is uniquely identified by1234 or by1423. A dot pattern in rising numeric order is the only valid input whensubstituting this template.
Another identification is the Unicode character, ⠏, that isU+280F ⠏braille pattern dots-1234 (HTML ⠏⧼dot-separator⧽ block:Braille Patterns). The block has a mapping from raised dots to character id in the range U+28xx.
Inversely, a cell can be defined by its Unicode character id: U+280F defines cell with raised dots-1234.
{{braille cell|1234|A23|size=20|type=image}} →
The 1829 Braille standard established the option of a bar across a row in addition to any combination of the two dots. In 1829 notation, there are 125 combinations, including all 64 valid regular 6-dot cell configurations.
Using the cell numbering shown here, one can simply define the raised rows: A, B, C, AB, AC, BC, or ABC, followed by the raised dots in rows not occupied by a bar ("0" for no dots). The order of the bars and numbers can be in rising order ("ABC123456"), with letters (bars) before numbers (dots), or in row-by-row order ("A14B25C36"), so the same cell is uniquely identified byAC25 or byA25C.
The 1829 Braille standard is not compatible with the Unicode Braille specification, and neither a text character, nor a Unicode code point will output an 1829 Braille cell.
Two input codes are available to produce special, non-braille output.
dot numbers returns the overview of dot numbers 1–8. It can only betype=image:
{{braille cell|dot numbers|type=image|size=40px}} →null orwhitespace produces a true space, not the blank braille cell:
{{braille cell|type=text|H|e|l|l|o|NULL|w|o|r|l|d}} →⠓⠑⠇⠇⠕ ⠺⠕⠗⠇⠙lang= English, French, Japanese, Korean braille. English and generic is default.Japanese braille and Korean braille have setting options from an earlier version of this template. They can be declared usingtype=Japanese. Doing so returns colored braillecells for clarification.
lang= | type= | shows | note |
|---|---|---|---|
| <not used> | <not used> | English, 6dot b/w | default |
| <not used> | 6dot | 6dot b/w | unchanged |
| <not used> | Korean | 6dot colored Korean | unchanged (deprecated; uselang=Korean instead) |
| <not used> | Japanese | 6dot colored Japanese | unchanged (deprecated; uselang=Japanese instead) |
| 8dot | <not used> | 8dot b/w | unchanged |
| text | character (is always 8dot) | unchanged | |
| Japanese | 6dot | 6dot b/w | new option |
| Korean | 6dot | 6dot b/w | new option |
| Japanese | 8dot | 8dot b/w | new option |
| Korean | 8dot | 8dot b/w | new option |
In general, the language should be enteredlang=Japanese. The parametertype then is available as default (colored cells) or enforcing 6dot black/white cells for Japanese or Korean.
type=6dot, 8dot, image, text. Default: text (as a character from the font). When dot 7 or 8 is used, always the 8-dot image is shown, any 6-dot setting is overruled.size=150% or 3em or 40px (Default: 100%, so regular font size).size=20pxCan be set for text output (not for image output).
{{Braille cell|K|L|M}} →⠅⠇⠍{{Braille cell|K|L|M|background=yellow}} →⠅⠇⠍{{Braille cell|K|L|M|bg=yellow}} →⠅⠇⠍ (shortcut){{Braille cell|K|L|M|background=transparent}} →⠅⠇⠍The cell has a caption (mouse hover text), based on the input. When the template is substituted, no caption is generated.
Possible errors that are caught:
{{Braille cell|xyz}} →Error using{{Braille cell}}: input "xyz" not supported.{{Braille cell|a|b|c|d|e|f|g|h|i|j|k|l|m|n|o|p|q|r|s|t|u|v|w|x|y|z|type=text}} →⠁⠃⠉⠙⠑⠋⠛⠓⠊⠚⠅⠇⠍⠝⠕⠏⠟⠗⠎⠞Error using{{Braille cell}}: maximum input (20 braille characters) exceeded after "t".Article pages with a red error message also are listed inCategory:Unsupported braille input.
{{Braille cell|#2|2}} →
.This mistake is not caught or noted. The intention of the editor (input is dot-number or decimal number) cannot be deduced.
6-dot cell, basic letter input: {{Braille cell | X}} -⠭
Japanese multi-cell: {{Braille cell | y dakuten | か | chōon | type=kana}} -
Korean multi-cell:{{Braille cell | h- | ᅡ | ᆫ | type=hangul}} -
8-dot cell, basic letter input: {{Braille cell | type=8 | X}} -
Unicode text character, large size, basic letter input: {{Braille cell | type=Unicode | size=300% | X}} -⠭
6-dot cell, small size, title text: {{Braille cell | size=25 | X | text=a small braille X}} -⠭
6-dot, dot order input: {{Braille cell | 12536}} -⠷
bottom dots, numeric order input: {{Braille cell | type=8 | 2478}} -
Same input, but substituted (note that only the first unnamed parameter is evaluated): {{subst:Braille cell | type=8 | 2478}} - ⣊
The parameter name "dot-id" is used to define a braille cell. It is the numbering of theraised dots, like136 for⠥. The sequence is climbing: 12345678, as is used in the Unicode character name: "Braille pattern dots-136".
Input is evaluated and processed using these lists:
Error tracking category:
