Шаблон:Брайль

⠀

Документація шаблону[перегляд] [редагувати] [історія] [очистити кеш]

• Стандартне використання, створює символи: {{Брайль|A|B|C}} → ⠁⠃⠉
• У вигляді картинок: {{Брайль|A|B|C|type=image|size=15px}} →
• Всі параметри:

{{Брайль|code1|code2|code3|...|lang=|type=|size=|caption=|background=}}

За замовчуванням використовується Англійський шрифт Брайля.

• Підстановка: {{subst:Брайль|code1}}

Використання

code1, 2, 3, …. Літери, що треба відобразити абеткою Брайля (не залежить від регістру, A=a). При підстановці працює лиш перший параметр, приймається лише визначення літери по точках.

lang — вибір мови/шрифта брайля. Підтримуються чотири мови: Англійська (grade 2), французька, японська, корейська. За замовчуванням використовується (grade 2), інші мови треба вказувати вручну (e.g. lang=Japanese).

type. Тип виводу Брайля: картинка із 6 точками, картинка із 8-ма, текстовий символ 6, 6dot, 8, 8dot, image, text. За замовчуванням — текст. Для японської та корейської, при type=Korean відображається ілюстративна кольорова версія (див. статтю Korean braille у англійській вікі).

size. Ширина зображення у пкс або розмір тексту у %, em, пкс. Одиницю вимірювання вказувати необхідно. (size=20px для зображень, 10px, 2em, 150% для тексту).

caption. Опис символу, що видно при наведенні курсором (caption= (<blank>). Можна приховати: (caption=no).

background / bg. Визначає колір фону. Лише для тексту (type=text). За замовчуванням: #f4f4f4. Приклади:

• {{Брайль|K|L|M|type=text}} → ⠅⠇⠍
• {{Брайль|K|L|M|type=text|background=yellow}} → ⠅⠇⠍
• {{Брайль|K|L|M|type=text|background=transparent}} → ⠅⠇⠍

Вхідні значення

Possible input: plain text and various Брайль 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. {{Брайль|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 Брайльs 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.

Визначення літери по точках

8-dot Braille cell dot numbers. Dots 7 and 8 are not found on a 6-dot Брайль.

Four options can be used in this Брайль template to produce a cell, and all are case-insensitive (A=a).

• {{Брайль|1234|1423|⠏|U+280F|u+280f}} → ⠏⠏⠏⠏⠏

Note that this cell definition is unrelated to any language (no «A» assigned).

A Брайль 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 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 by 1234 or by 1423. A dot pattern in rising numeric order is the only valid input when substituting this template.

Another identification is the Unicode character, ⠏, that is U+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.

Визначення у нотації 1829

Нумерація за схемою 1829 (із горизонтальними лініями).

• {{Брайль|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 by AC25 or by A25C.

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 Брайль.

Особливі опції

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

Нумерація клітинок

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

• {{Брайль|dot numbers|type=image|size=40px}} →

Пробіли

null or whitespace produces a true space, not the blank Брайль:

• {{Брайль|type=text|H|e|l|l|o|NULL|w|o|r|l|d}} → ⠓⠑⠇⠇⠕ ⠺⠕⠗⠇⠙

lang

• 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 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)
<not used>	8dot	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

• 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

• 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).

• {{Брайль|K|L|M}} → ⠅⠇⠍
• {{Брайль|K|L|M|background=yellow}} → ⠅⠇⠍
• {{Брайль|K|L|M|bg=yellow}} → ⠅⠇⠍ (shortcut)
• {{Брайль|K|L|M|background=transparent}} → ⠅⠇⠍

caption

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:

• Input is not recognised as a braille code:

{{Брайль|xyz}} →

• Too many characters are requested:

{{Брайль|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}} → ⠁⠃⠉⠙⠑⠋⠛⠓⠊⠚⠅⠇⠍⠝⠕⠏⠟⠗⠎⠞

Article pages with a red error message also are listed in Категорія: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:

{{Брайль|#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:

{{Брайль|X}} → ⠭

• Japanese multi-cell:

{{Брайль|y dakuten|か|chōon|type=kana}} →

• Korean multi-cell:

{{Брайль|h-|ᅡ|ᆫ|type=hangul}} →

• 8-dot cell, basic letter input:

{{Брайль|type=8|X}} →

• Unicode text character, large size, basic letter input:

{{Брайль|type=Unicode|size=300%|X}} → ⠭

• 6-dot cell, small size, title text:

{{Брайль|size=25|X|text=a small braille X}} → ⠭

• 6-dot, dot order input:

{{Брайль|12536}} → ⠷

• bottom dots, numeric order input:

{{Брайль|type=8|2478}} -=→

• Same input, but substituted (note that only the first unnamed parameter is evaluated):

{{subst:Брайль|type=8|2478}} → ⣊

Огляд

• {{Брайль/overview Japanese and Korean braille}}

Технічні деталі

The parameter name «dot-id» is used to define a Брайль. 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».

• {{Брайль}}: separates numbered parameters into individual calls to /main.
• {{Брайль/main}}: calls /main2. Converts a single input code plus named parameters into appropriate Брайль id («dot-id») and input code. Contains the list with non-English code translations (other languages).
• {{Брайль/main2}}: Calls /core. Prepares input texts and codes, using the now determined cell id. Checks for and shows error message.
• {{Брайль/core}}: Produces the actual cell output (text or image) using the settings.
• {{Брайль/styles.css}}: Injects proper spacing between two cells.
• {{Брайль/main2singlecell}}
• {{Брайль/lang2lang-id}}

Input is evaluated and processed using these lists:

• {{Брайль/english&cell2dot-id}}: analyse input code against default list (English and generic)
• {{Брайль/dot-id2character}}: cell id into text character (Unicode)
• {{Брайль/dot-id2article}}: cell id into Wikipedia article name
• {{Брайль/dot-id2unicode-id}}: cell id into textual Unicode definition, pattern U+28xx
• {{Брайль/dot-id2filename}}: cell id into a specific filename (6dot, Japanese, Korean)
• {{Брайль/dot-id2filename-8dot}}: cell id into a default 8-dot filename

Error tracking category:

• Категорія:Unsupported braille input: tracks transclusions with invalid input.
• T: braille/subs
• Template:Брайль — sbx
  • Категорія:Unsupported braille input
  • Template talk:Брайль

Пов'язане

• Commons: Category: Braille letters (6 dots)
• Commons: Category: Braille letters (8 dots)
• Файл:Pictograms-nps-accessibility-braille.svg
• Файл:Braille8dotCellNumbering.svg

⠀