మూస:Braille cell/doc

వికీపీడియా నుండి
Jump to navigation Jump to search
  • Basic usage, inline: {{Braille cell|A|B|C}}
  • Images: {{Braille cell|A|B|C|type=image|size=15px}}⠁ (braille pattern dots-1)⠃ (braille pattern dots-12)⠉ (braille pattern dots-14)
  • All parameters:
{{Braille cell|code1|code2|code3|...|code20|lang=|type=|size=|caption=|background=}}

By default the braille language is English braille (grade 2), and any abstract form ("dots-136").

Usage overview

[మార్చు]

code1, 2, 3, ..., 20. Letter definitions to be translated to a braille cell (case insensitive, A=a).

lang for the braille language. Four braille languages are recognised: English (grade 2), French, Japanese and Korean 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 character 6, 6dot, 8, 8dot, image, text. The default is text (inline font character). For Japanese and Korean braille script, entering type=Korean produces illustrative colored braille cells (see Korean braille). These two types are default for their languages.

size. Width size of the image (in px) of font-size of the inline text (like %, em, px). Add the unit to the number (e.g. size=20px for 6dot/8dot images, and 10px, 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 or bg. Sets the background color. For type=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}}

Input values

[మార్చు]

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 single Braille 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, with Romaji 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.

Other characters

[మార్చు]

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, use lang=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.

Braille cell definitions (dot numbering)

[మార్చు]
8-dot Braille cell dot numbers. Dots 7 and 8 are not found on a 6-dot Braille cell.

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 by naming 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 is independent of the braille language (there is no connection with a letter A; this is for the Braille language to add).

Using the cell numbering shown here, one can simple 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 by 1234 or by 1423.

Another identification is the Unicode character, ⠏, that is Error using {{unichar}}: Input "280F" is not a hexadecimal value (expected: like "09AF") . 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.

Special options

[మార్చు]

Two input codes are available to produce special, non-braille output.

Cell numbering overview

[మార్చు]

dot numbers returns the overview of dot numbers 1–8. It can only be type=image:

Whitespace

[మార్చు]

null or whitespace 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 and Korean braille

[మార్చు]

Japanese braille and Korean braille have setting options from an earlier version of this template. They can be declared using type=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; use lang=Korean instead)
<not used> Japanese 6dot colored Japanese unchanged (deprecated; use lang=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 entered lang=Japanese. The parameter type 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 fromt the font). When dot 7 or 8 is used, always the 8-dot image is shown, any 6-dot setting is overruled.
  • When text, size=150% or 3em or 40px (Default: 100%, so regular font size).
  • When image, in px: size=20px

background

[మార్చు]

Can be set for text output (not for image output).

The cell has a caption (mouse hover text), based on the input.

Possible errors

[మార్చు]

Possible errors that are catched:

  • Input is not recognised as a braille code:
{{Braille cell|xyz}}Error using {{Braille cell}}: input "xyz" not supported.
  • More than 20 (braille) characters are requested:
{{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 in Category:Unsupported braille input.

  • Numbers and dot number: Input "#2" is for the cell meaning decimal number two, input "2" produces the dot number 2 cell:
{{Braille cell|#2|2}}⠃ (braille pattern dots-12)⠂ (braille pattern dots-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}} - ⠘ (braille pattern dots-45)⠡ (braille pattern dots-16)⠒ (braille pattern dots-25)

Korean multi-cell:{{Braille cell | h- | ᅡ | ᆫ | type=hangul}} - ⠚ (braille pattern dots-245)⠣ (braille pattern dots-126)⠒ (braille pattern dots-25)

8-dot cell, basic letter input: {{Braille cell | type=8 | X}} - ⠭ (braille pattern dots-1346)

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}} - ⣊ (braille pattern dots-2478)

Technical details

[మార్చు]

The parameter name "dot-id" is used to define a braille cell. It is the numbering of the raised dots, like 136 for . The sequence is climbing: 12345678, as is used in the Unicode character name: "Braille pattern dots-136".

  • {{Braille cell}}: separates numbered parameters into individual calls to /main.
  • {{Braille cell/main}}: calls /main2. Converts a single input code plus named parameters into appropriate braille cell id ("dot-id") and input code. Contains the list with non-English code translations (other languages).
  • {{Braille cell/main2}}: Calls /core. Prepares input texts and codes, using the now determined cell id. Checks for and shows error message.
  • {{Braille cell/core}}: Produces the actual cell output (text or image) using the settings.
  • {{braille cell/main2singlecell}}
  • {{braille cell/lang2lang-id}}

Input is evaluated and processed using these lists:

Error tracking category:

[మార్చు]
"https://te.wikipedia.org/w/index.php?title=మూస:Braille_cell/doc&oldid=783435" నుండి వెలికితీశారు