Introduction

Overview

This document defines a metadata standard tailored for the eBraille specification, facilitating consistent and accurate identification of braille codes, grades, and specializations across various languages and contexts. It provides a structured framework for identifying the braille system in use, including details on contraction levels, specialized braille systems (such as computer or music braille), and additional elements relevant to braille production. The goal of this document is to clearly define braille code metadata to enhance interoperability, backtranslation, and accessibility within eBraille documents.

About the registry

Registering new codes

The process for registering new codes through the group's github repository will be added in a future update.

Code syntax

These rules intend to identify braille codes clearly using a single string. The goal is to have a unified system that makes it easier for software developers and braille library mantainers to

Codes MUST be of the following form after whitespace normalization [[xml]]:

(EBNF productions ISO/IEC 14977)
All terminal symbols are in the Unicode Block 'Basic Latin' (U+0000 to U+007F).
brl-code = code space grade [ space specialization ] ;
code = ? character data ? ;
grade = "grade0" | "grade1" | "grade2" | "no-grade" ;
specialization = "comp8" | "comp6" | "math" | "music" | "phonetic" ;
space = #x20 ;

The following list defines each component of a braille code in greater detail:

Code

The REQUIRED code identifies the specific braille system in use, such as Unified English Braille (UEB), Nemeth, or Bharati for Indian languages. For interoperabilty, braille code names SHOULD be in English.

Grade

The REQUIRED grade specifies the level of contraction or complexity in the braille code, such as grade1 for uncontracted braille and grade2 for contracted braille. If the braille system does not follow a specific grading system, no-grade is used.

Allowed values:

  • grade0 - means no contractions are used
  • grade1 - means only some contractions within that code are used
  • grade2 - means all contractions within that code are used
  • no-grade - means that the code does not use contractions or a grading system

More feedback is needed about how each braille code views braille grades. In many braille regions, grades are not used.

Specialization

The OPTIONAL specialization identifies specialized systems like computer or music braille.

Allowed values:

  • comp8 - 8-dot computer braille
  • comp6 - 6-dot computer braille
  • math - code is only concerned with mathematics
  • music - code is only concerned with music
  • phonetic - code is only concerned with phonetics

Braille codes

Registered codes

No codes have been registered at this time.

Proposed codes

Afrikaans grade2
Afrikaans contracted
Afrikaans grade1
Afrikaans uncontracted
Akkadian-Borger grade1
Akkadian Borger
Akkadian grade1
Akkadian U.S.
Arabic no-grade comp8
Arabic computer
Arabic grade2
Arabic contracted
Arabic grade1
Arabic uncontracted
Armenian no-grade comp8
Armenian computer
Bashkir grade1
Bashkir
Belarusian grade1
Belarusian
Belarusian no-grade comp8
Belarusian computer
Belarusian capitals grade0
Belarusian with capitals
Bharati grade1
Bharati
Bulgarian grade1
Bulgarian
Bulgarian no-grade comp8
Bulgarian computer
Burmese grade2
Burmese contracted
Burmese grade1
Burmese uncontracted
Cantonese grade1
Cantonese
Catalan grade1
Catalan
Cherokee grade1
Cherokee
Chichewa grade1
Chichewa
Coptic no-grade comp8
Coptic computer
Croatian grade1
Croatian
Croatian no-grade comp8
Croatian computer
Cuneiform-Transliteration grade1
Cuneiform transliterated
Czech grade1
Czech
Czech no-grade comp8
Czech computer
Danish-1993 no-grade comp8
Danish computer 1993
Danish-2022 no-grade comp8
Danish computer 2022
Danish-6dot-1993 grade2
Danish contracted 6 dot 1993
Danish-6dot-2022 grade2
Danish contracted 6 dot 2022
Danish-8dot-1993 grade2
Danish contracted 8 dot 1993
Danish-8dot-2022 grade2
Danish contracted 8 dot 2022
Danish-6dot-1993 grade1
Danish partially contracted 6 dot 1993
Danish-8dot-1993 grade1
Danish partially contracted 8 dot 1993
Danish-6dot-1993 grade1
Danish uncontracted 6 dot 1993
Danish-6dot-2022 grade1
Danish uncontracted 6 dot 2022
Danish-8dot-1993 grade1
Danish uncontracted 8 dot 1993
Danish-8dot-2022 grade1
Danish uncontracted 8 dot 2022
Dravidian no-grade comp8
Dravidian computer
Dutch grade1
Dutch
Dutch no-grade comp8
Dutch computer
CBC no-grade comp8
English Canada computer
SEB no-grade comp8
English U.K. computer
SEB grade2
English U.K. contracted
SEB grade1
English U.K. uncontracted
CBC 6dot no-grade comp6
English U.S. computer 6 dot
CBC 8dot no-grade comp8
English U.S. computer 8 dot
NABCC no-grade comp8
English U.S. computer NABCC
EBAE grade2
English U.S. contracted
EBAE grade1
English U.S. uncontracted
ueb grade2
English unified contracted
ueb grade1
English unified uncontracted
Esperanto grade1
Esperanto
Esperanto-x-system no-grade
Esperanto x system
Estonian no-grade comp8
Estonian computer
Ethiopic grade1
Ethiopic
Filipino grade2
Filipino contracted
Finnish grade1
Finnish
Finnish no-grade comp8
Finnish computer
French no-grade comp8
French computer
French grade2
French contracted
French grade1
French uncontracted
Georgian grade1
Georgian
German-6dot no-grade comp6
German computer 6 dot
German-8dot no-grade comp8
German computer 8 dot
German grade2
German contracted
German-capitals grade2
German contracted with capitals
German grade1
German partially contracted
German-capitals grade1
German partially contracted with capitals
German grade0
German uncontracted
German-capitals grade0
German uncontracted with capitals
Gondi grade1
Gondi
Greek grade1
Greek
Greek-international-English-composed grade0
Greek international English composed
Greek-international-English-decomposed grade0
Greek international English decomposed
Greek-international-Spanish grade1
Greek international Spanish
Hawaiian grade1
Hawaiian
Hebrew-Biblical grade1
Hebrew Biblical
Hebrew grade1
Hebrew modern
Hebrew no-grade comp8
Hebrew modern computer
Hungarian no-grade comp8
Hungarian computer
Hungarian grade2
Hungarian contracted
Hungarian grade1
Hungarian partially contracted
Icelandic grade1
Icelandic
IPA-Braille-2005 no-grade phonetic
International Phonetic Alphabet 2005
Inuktitut grade1
Inuktitut
Irish grade2
Irish contracted
Irish grade1
Irish uncontracted
isiXhosa grade2
isiXhosa contracted
isiXhosa grade1
isiXhosa uncontracted
isiZulu grade2
isiZulu contracted
isiZulu grade1
isiZulu uncontracted
Italian grade1
Italian
Italian no-grade comp8
Italian computer
Kantenji grade0
Japanese Kantenji
Kazakh grade1
Kazakh
Khasi grade1
Khasi
Khmer grade1
Khmer
Kinyarwanda grade1
Kinyarwanda
Korean grade2
Korean contracted
Korean-2006 grade2
Korean contracted 2006
Korean grade1
Korean uncontracted
Korean-2006 grade1
Korean uncontracted 2006
Kurdish grade1
Kurdish
Lao grade1
Lao
Latvian grade1
Latvian
Lithuanian grade1
Lithuanian 6 dot
Lithuanian grade1
Lithuanian 8 dot
Luganda grade1
Luganda
Malay grade1
Malay
Maltese no-grade comp8
Maltese computer
Mandarin-common grade1
Mandarin mainland China common braille scheme
Mandarin-double-phonic grade2
Mandarin mainland China double phonic
Mandarin-with-tones grade1
Mandarin mainland China with tones
Mandarin-no-tones grade1
Mandarin mainland China without tones
Bopomofo grade1
Mandarin Taiwan bopomofo
Manipuri grade1
Manipuri
Maori grade1
Maori
Marwari grade1
Marwari
Mongolian grade2
Mongolian contracted
Mongolian grade1
Mongolian uncontracted
Munda grade1
Munda
Braille-music no-grade music
Music
Nemeth no-grade math
Nemeth
Kurdish grade1
Northern Kurdish
Norwegian no-grade comp8
Norwegian computer
Norwegian grade1
Norwegian contracted grade 1
Norwegian grade2
Norwegian contracted grade 2
Norwegian grade3
Norwegian contracted grade 3
Norwegian-6dot grade1
Norwegian uncontracted 6 dot
Norwegian-8dot grade1
Norwegian uncontracted 8 dot
Norwegian-8dot-6dot-fallback grade1
Norwegian uncontracted 8 dot 6 dot fallback
Pali grade1
Pali
Persian grade1
Persian
Persian no-grade comp8
Persian computer
Polish grade1
Polish
Polish no-grade comp8
Polish computer
Portuguese no-grade comp8
Portuguese computer
Portuguese grade2
Portuguese contracted
Portuguese grade1
Portuguese uncontracted
Romanian no-grade comp8
Romanian computer
Romanian grade1
Romanian uncontracted
Russian grade1
Russian
Russian no-grade comp8
Russian computer
Russian grade2
Russian contracted
Russian-program grade0
Russian for program sources
Russian-capitals grade1
Russian with capitals
Gaelic no-grade comp8
Scottish Gaelic computer
Sepedi grade2
Sepedi contracted
Sepedi grade1
Sepedi uncontracted
Serbian grade1
Serbian
Serbian grade1 Cyrl
Serbian Cyrillic
Sesotho grade2
Sesotho contracted
Sesotho grade1
Sesotho uncontracted
Setswana grade2
Setswana contracted
Setswana grade1
Setswana uncontracted
Slovak grade1
Slovak
Slovenian grade1
Slovenian
Slovenian no-grade comp8
Slovenian computer
Spanish no-grade comp8
Spanish computer
Spanish grade2
Spanish contracted
Spanish grade1
Spanish uncontracted
Swahili-grade-1.2 grade1
Swahili contracted grade 1.2
Swahili-grade-1.3 grade1
Swahili contracted grade 1.3
Swahili-grade-1.4 grade1
Swahili contracted grade 1.4
Swahili-grade-1.5 grade1
Swahili contracted grade 1.5
Swahili grade2
Swahili contracted grade 2
Swahili grade1
Swahili uncontracted
Swedish-1989 no-grade comp8
Swedish computer 1989
Swedish-1996 no-grade comp8
Swedish computer 1996
Swedish grade2
Swedish contracted
Swedish grade1
Swedish partially contracted
Swedish grade0
Swedish uncontracted
Syriac grade1
Syriac
Bharati no-grade comp8
Tamil computer
Tatar grade1
Tatar
Thai no-grade comp8
Thai computer
Thai grade1
Thai partially contracted
Thai grade1
Thai uncontracted
Tibetan no-grade comp8
Tibetan computer
Tshivenda grade2
Tshivenda contracted
Tshivenda grade1
Tshivenda uncontracted
Turkish no-grade comp8
Turkish computer
Turkish grade2
Turkish contracted
Turkish grade1
Turkish uncontracted
Ugaritic grade1
Ugaritic
Ukrainian grade1
Ukrainian
Ukrainian no-grade comp8
Ukrainian computer
Ukrainian capitals grade1
Ukrainian with capitals
Urdu grade2
Urdu contracted
Urdu grade1
Urdu uncontracted
Uzbek grade1
Uzbek
Vietnamese no-grade comp8
Vietnamese computer
Vietnamese grade2
Vietnamese contracted
Vietnamese grade1
Vietnamese partially contracted
Vietnamese-Saigon grade2
Vietnamese Saigon contracted
Vietnamese grade0
Vietnamese uncontracted
Welsh grade2
Welsh contracted
Welsh grade1
Welsh uncontracted
Yakut grade1
Yakut
Yiddish grade1
Yiddish