#!/usr/bin/env python3 import inkex # --------------------------------- # UTILITIES # Common standards UPPERCASE_PREFIXES = { chr(15): 0x2828, # uppercase prefix: https://codepoints.net/U+000F } LOUIS_BRAILLE_NUMBERS_PREFIX = 0x283c # Louis Braille's numbers prefix LOUIS_BRAILLE_NUMBERS = { # Louis Braille's original numbers codification "0": 0x281a, "1": 0x2801, "2": 0x2803, "3": 0x2809, "4": 0x2819, "5": 0x2811, "6": 0x280B, "7": 0x281b, "8": 0x2813, "9": 0x280a, } # --------------------- # English based locales EN_ASCII = " A1B'K2L@CIF/MSP\"E3H9O6R^DJG>NTQ,*5<-U8V.%[$+X!&;:4\\0Z7(_?W]#Y)=" # Spanish based locales ES_LETTERS = { "A": 0x2801, "B": 0x2803, "C": 0x2809, "D": 0x2819, "E": 0x2811, "F": 0x280B, "G": 0x281b, "H": 0x2813, "I": 0x280a, "J": 0x281a, "K": 0x2805, "L": 0x2807, "M": 0x280d, "N": 0x281d, "Ñ": 0x283b, "O": 0x2815, "P": 0x280f, "Q": 0x281f, "R": 0x2817, "S": 0x280e, "T": 0x281e, "U": 0x2825, "V": 0x2827, "W": 0x283a, "X": 0x282d, "Y": 0x283d, "Z": 0x2835, } ES_SIGNS = { " ": 0x2800, # braille space "ª": 0x2801, # ordinal (feminine) -> same as A "º": 0x2815, # ordinal (masculine) -> same as O "&": 0x282f, ".": 0x2804, ",": 0x2802, ":": 0x2812, ";": 0x2806, "¿": 0x2822, "?": 0x2822, "¡": 0x2816, "!": 0x2816, '"': 0x2826, "(": 0x2823, ")": 0x281c, # "[": 0x2837, collides with "Á" (Spanish and Catalan) # "]": 0x283e, collides with "Ú" (Spanish and Catalan) "*": 0x2814, # math "-": 0x2824, "=": 0x2836, "×": 0x2826, # multiplication "÷": 0x2832, # division "+": 0x2816, "@": 0x2810, } ES_ACCENT_MARKS = { "Á": 0x2837, "É": 0x282e, "Í": 0x280c, "Ó": 0x282c, "Ú": 0x283e, "Ü": 0x2833, } ES_COMBINATIONS = { # signs "%": (0x2838, 0x2834), "‰": (0x2838, 0x2834, 0x2834), # per mile "/": (0x2820, 0x2802), "\\": (0x2810, 0x2804), "<": (0x2810, 0x2805), ">": (0x2828, 0x2802), "|": (0x2838, 0x2807), "{": (0x2810, 0x2807), "}": (0x2838, 0x2802), "–": (0x2824, 0x2824), # two different unicode dashes "—": (0x2824, 0x2824), "…": (0x2804, 0x2804, 0x2804), # legal "©": (0x2823, 0x2828, 0x2809, 0x281c), # copyright "®": (0x2823, 0x2828, 0x2817, 0x281c), # registered "℗": (0x2823, 0x2828, 0x280f, 0x281c), "🄯": (0x2823, 0x2828, 0x2807, 0x281c), # currencies "€": (0x2838, 0x2811), "$": (0x2838, 0x280e), "¢": (0x2818, 0x2809), "£": (0x2810, 0x282e), "¥": (0x2838, 0x283d), "￥": (0x2838, 0x283d), } CA_ACCENT_MARKS = { "É": 0x283f, "Í": 0x280c, "Ó": 0x282a, "Ú": 0x283e, "À": 0x2837, "È": 0x282e, "Ò": 0x282c, "Ï": 0x283b, "Ü": 0x2833, "Ç": 0x282f, } # French based locales FR_LETTERS = { "A": 0x2801, "B": 0x2803, "C": 0x2809, "D": 0x2819, "E": 0x2811, "F": 0x280b, "G": 0x281b, "H": 0x2813, "I": 0x280a, "J": 0x281a, "K": 0x2805, "L": 0x2807, "M": 0x280d, "N": 0x281d, "O": 0x2815, "P": 0x280f, "Q": 0x281f, "R": 0x2817, "S": 0x280e, "T": 0x281e, "U": 0x2825, "V": 0x2827, "W": 0x283a, "X": 0x282d, "Y": 0x283d, "Z": 0x2835, } FR_ACCENT_MARKS = { "É": 0x283f, "À": 0x2837, "È": 0x282e, "Ù": 0x283e, "Â": 0x2821, "Ê": 0x2823, "Î": 0x2829, "Ô": 0x2839, "Û": 0x2831, "Ë": 0x282b, "Ï": 0x283b, "Ü": 0x2833, "Ç": 0x282f, "Œ": 0x282a, # oe ligature } FR_SIGNS = { " ": 0x2800, # braille space ",": 0x2802, ";": 0x2806, ":": 0x2812, ".": 0x2832, "?": 0x2822, "!": 0x2816, "«": 0x2836, "»": 0x2836, "“": 0x2836, "”": 0x2836, '"': 0x2836, "‘": 0x2836, "’": 0x2836, "(": 0x2826, ")": 0x2834, "'": 0x2804, "'": 0x2804, "/": 0x280c, "@": 0x281c, "^": 0x2808, # elevation exponent "-": 0x2824, "+": 0x2816, "×": 0x2814, # multiplication "÷": 0x2812, # division "=": 0x2836, } FR_COMBINATIONS = { "↔": (0x282a, 0x2812, 0x2815), # bidirectional arrow "←": (0x282a, 0x2812, 0x2812), # left arrow "→": (0x2812, 0x2812, 0x2815), # right arrow "…": (0x2832, 0x2832, 0x2832), # unicode ellipsis "–": (0x2824, 0x2824), "—": (0x2824, 0x2824), "_": (0x2810, 0x2824), "[": (0x2818, 0x2826), "]": (0x2834, 0x2803), "°": (0x2810, 0x2815), # degrees "§": (0x2810, 0x280f), # paragraph/section symbol "&": (0x2810, 0x283f), "\\": (0x2810, 0x280c), "#": (0x2810, 0x283c), "{": (0x2820, 0x2820, 0x2826), "}": (0x2834, 0x2804, 0x2804), # math "µ": (0x2818, 0x280d), # micron "π": (0x2818, 0x280f), "≤": (0x2818, 0x2823), "≥": (0x2818, 0x281c), "<": (0x2810, 0x2823), ">": (0x2810, 0x281c), "~": (0x2810, 0x2822), "*": (0x2810, 0x2814), "%": (0x2810, 0x282c), "‰": (0x2810, 0x282c, 0x282c), # per mile # legal "©": (0x2810, 0x2809), # copyright "®": (0x2810, 0x2817), # registered "™": (0x2810, 0x281e), # trademark # currencies "¢": (0x2818, 0x2809), "€": (0x2818, 0x2811), "£": (0x2818, 0x2807), "$": (0x2818, 0x280e), "¥": (0x2818, 0x283d), "￥": (0x2818, 0x283d), } # German based locales DE_ACCENT_MARKS = { "Ä": 0x281c, "Ö": 0x282a, "Ü": 0x2833, } DE_SIGNS = { " ": 0x2800, # braille space ",": 0x2802, ";": 0x2806, ":": 0x2812, "?": 0x2822, "!": 0x2816, "„": 0x2826, "“": 0x2834, "§": 0x282c, ".": 0x2804, "–": 0x2824, "‚": 0x2820, } DE_COMBINATIONS = { # signs "ß": (0x282e,), # converted to 'SS' if uppercased, so defined in combinations "|": (0x2810, 0x2824), "[": (0x2818, 0x2837), "]": (0x2818, 0x283e), "/": (0x2818, 0x280c), "`": (0x2820, 0x2826), "´": (0x2820, 0x2834), "/": (0x2810, 0x2802), "&": (0x2810, 0x2825), "*": (0x2820, 0x2814), "→": (0x2812, 0x2812, 0x2815), "←": (0x282a, 0x2812, 0x2812), "↔": (0x282a, 0x2812, 0x2812, 0x2815), "%": (0x283c, 0x281a, 0x2834), "‰": (0x283c, 0x281a, 0x2834, 0x2834), "°": (0x2808, 0x2834), "′": (0x2808, 0x2814), "″": (0x2808, 0x2814, 0x2814), "@": (0x2808, 0x281c), "_": (0x2808, 0x2838), "#": (0x2808, 0x283c), # currencies "€": (0x2808, 0x2811), "$": (0x2808, 0x280e), "¢": (0x2808, 0x2809), "£": (0x2808, 0x2807), # legal "©": (0x2836, 0x2818, 0x2809, 0x2836), "®": (0x2836, 0x2818, 0x2817, 0x2836), } # END: UTILITIES # --------------------------------- # LOCALE FUNCTIONS def en_char_map(char): """English chars mapper. Source: https://en.wikipedia.org/wiki/Braille_ASCII#Braille_ASCII_values """ try: mapint = EN_ASCII.index(char.upper()) except ValueError: return char return chr(mapint + 0x2800) def numbers_singleuppers_combinations_factory( numbers_map, singleuppers_map, combinations_map, # also individual characters that are modified if uppercased number_prefix, uppercase_prefix, ): """Wrapper for various character mappers implementations.""" def char_mapper(char): if char.isnumeric(): # numeric prefix + number return "".join([chr(number_prefix), chr(numbers_map[char])]) try: bcharint = singleuppers_map[char.upper()] except KeyError: try: # combinations return "".join([chr(num) for num in combinations_map[char]]) except KeyError: return char else: # if uppercase, add uppercase prefix before letter if char.isupper(): return "".join([chr(uppercase_prefix), chr(bcharint)]) return chr(bcharint) return char_mapper def es_char_map_loader(): """Spanish/Galician chars mappers. Source: https://sid.usal.es/idocs/F8/FDO12069/signografiabasica.pdf """ return numbers_singleuppers_combinations_factory( LOUIS_BRAILLE_NUMBERS, { **ES_LETTERS, **ES_ACCENT_MARKS, **ES_SIGNS, **UPPERCASE_PREFIXES, }, ES_COMBINATIONS, 0x283c, 0x2828, ) def eu_char_map_loader(): """Euskera chars mapper. Uses the sample implementation as Spanish but without accent marks. Source: https://sid.usal.es/idocs/F8/FDO12069/signografiabasica.pdf """ return numbers_singleuppers_combinations_factory( LOUIS_BRAILLE_NUMBERS, { **ES_LETTERS, **ES_SIGNS, **UPPERCASE_PREFIXES, }, ES_COMBINATIONS, 0x283c, 0x2828, ) def ca_char_map_loader(): """Catalan/Valencian chars mappers. Uses the same implementation as Spanish but different accent marks. Source: https://sid.usal.es/idocs/F8/FDO12069/signografiabasica.pdf """ return numbers_singleuppers_combinations_factory( LOUIS_BRAILLE_NUMBERS, { **ES_LETTERS, **CA_ACCENT_MARKS, **ES_SIGNS, **UPPERCASE_PREFIXES, }, ES_COMBINATIONS, 0x283c, 0x2828, ) def fr_char_map_loader(): """French chars mapper. Source: https://sid.usal.es/idocs/F8/FDO12069/signografiabasica.pdf """ return numbers_singleuppers_combinations_factory( LOUIS_BRAILLE_NUMBERS, { **FR_LETTERS, **FR_ACCENT_MARKS, **FR_SIGNS, **UPPERCASE_PREFIXES, }, FR_COMBINATIONS, 0x283c, 0x2828, ) def de_char_map_loader(): """German chars mapper. - For letters, uses the same dictionary as French implementation. Source: http://bskdl.org/textschrift.html """ return numbers_singleuppers_combinations_factory( LOUIS_BRAILLE_NUMBERS, { **FR_LETTERS, # Same as French implementation **DE_ACCENT_MARKS, **DE_SIGNS, **UPPERCASE_PREFIXES, }, DE_COMBINATIONS, 0x283c, 0x2828, ) # END: LOCALE FUNCTIONS LOCALE_CHARMAPS = { "en": en_char_map, # English "es": es_char_map_loader, # Spanish "fr": fr_char_map_loader, # French "de": de_char_map_loader, # German "gl": es_char_map_loader, # Galician "eu": eu_char_map_loader, # Euskera "ca": ca_char_map_loader, # Catalan/Valencian } # --------------------------------- # EXTENSION class BrailleL18n(inkex.TextExtension): """Convert to Braille giving a localized map of replacements.""" def add_arguments(self, parser): parser.add_argument( "-l", "--locale", type=str, dest="locale", default="en", choices=LOCALE_CHARMAPS.keys(), help="Locale to use converting to Braille.", ) def process_chardata(self, text): """Replaceable chardata method for processing the text.""" chars_mapper = LOCALE_CHARMAPS[self.options.locale] # `chars_mapper` could be a function loader or a characters mapper # itself, so check if the characters mapper is loaded and load it # if is created from a factory if "loader" in chars_mapper.__name__: chars_mapper = chars_mapper() return ''.join(map(chars_mapper, text)) if __name__ == '__main__': BrailleL18n().run()