braillebasefrench 0.2.9__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- braillebasefrench-0.2.9/LICENSE +17 -0
- braillebasefrench-0.2.9/PKG-INFO +109 -0
- braillebasefrench-0.2.9/README.md +93 -0
- braillebasefrench-0.2.9/braillebasefrench/__init__.py +45 -0
- braillebasefrench-0.2.9/braillebasefrench.egg-info/PKG-INFO +109 -0
- braillebasefrench-0.2.9/braillebasefrench.egg-info/SOURCES.txt +9 -0
- braillebasefrench-0.2.9/braillebasefrench.egg-info/dependency_links.txt +1 -0
- braillebasefrench-0.2.9/braillebasefrench.egg-info/requires.txt +1 -0
- braillebasefrench-0.2.9/braillebasefrench.egg-info/top_level.txt +1 -0
- braillebasefrench-0.2.9/pyproject.toml +25 -0
- braillebasefrench-0.2.9/setup.cfg +4 -0
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
Apache License
|
|
2
|
+
Version 2.0, January 2004
|
|
3
|
+
http://www.apache.org/licenses/
|
|
4
|
+
|
|
5
|
+
Copyright (c) 2026 Yuu
|
|
6
|
+
|
|
7
|
+
Licensed under the Apache License, Version 2.0 (the "License");
|
|
8
|
+
you may not use this file except in compliance with the License.
|
|
9
|
+
You may obtain a copy of the License at:
|
|
10
|
+
|
|
11
|
+
http://www.apache.org/licenses/LICENSE-2.0
|
|
12
|
+
|
|
13
|
+
Unless required by applicable law or agreed to in writing, software
|
|
14
|
+
distributed under the License is distributed on an "AS IS" BASIS,
|
|
15
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
16
|
+
See the License for the specific language governing permissions and
|
|
17
|
+
limitations under the License.
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: braillebasefrench
|
|
3
|
+
Version: 0.2.9
|
|
4
|
+
Summary: A complete and extensible Unicode Braille processing library. French language version
|
|
5
|
+
Author: Nagao Yuji
|
|
6
|
+
License: Apache-2.0
|
|
7
|
+
Project-URL: Homepage, https://github.com/DukaCrazy/braillebasefrench
|
|
8
|
+
Project-URL: Documentation, https://github.com/DukaCrazy/braillebasefrench
|
|
9
|
+
Project-URL: Source, https://github.com/DukaCrazy/braillebasefrench
|
|
10
|
+
Keywords: braille,unicode,accessibility,API,binary,blind,education
|
|
11
|
+
Requires-Python: >=3.6
|
|
12
|
+
Description-Content-Type: text/markdown
|
|
13
|
+
License-File: LICENSE
|
|
14
|
+
Requires-Dist: braillebase>=0.2.9
|
|
15
|
+
Dynamic: license-file
|
|
16
|
+
|
|
17
|
+
### - pip install braillebasefrench
|
|
18
|
+
|
|
19
|
+
# French
|
|
20
|
+
|
|
21
|
+
### NOTE 1: Antoine number notation
|
|
22
|
+
|
|
23
|
+
This library provides text-to-Braille translation for French. However, it
|
|
24
|
+
does not currently implement all rules defined by the French Braille standard
|
|
25
|
+
(CBFU).
|
|
26
|
+
|
|
27
|
+
In particular, French Braille uses the **Antoine number notation** for the
|
|
28
|
+
transcription of numbers, which is not currently supported by this library.
|
|
29
|
+
|
|
30
|
+
Therefore, while regular text can be translated to Braille, texts containing
|
|
31
|
+
numbers may not be fully compliant with the French Braille standard.
|
|
32
|
+
|
|
33
|
+
Support for Antoine number notation and additional French Braille
|
|
34
|
+
transcription rules may be added in future versions.
|
|
35
|
+
|
|
36
|
+
### NOTE 2: Unsupported French Characters
|
|
37
|
+
|
|
38
|
+
We could not find an official French Braille representation for the character
|
|
39
|
+
`ÿ` in the references consulted. However, this character can occur in French
|
|
40
|
+
words and proper names.
|
|
41
|
+
|
|
42
|
+
To avoid translation or execution errors, the library currently falls back to
|
|
43
|
+
the Braille representation of the base letter `y`.
|
|
44
|
+
|
|
45
|
+
The same approach is used for the character `æ`. Since we did not identify a
|
|
46
|
+
dedicated French Braille representation for `æ`, it is currently handled as
|
|
47
|
+
the character sequence `ae`.
|
|
48
|
+
|
|
49
|
+
> **Note:** These are compatibility fallbacks implemented by the library and
|
|
50
|
+
> should not be interpreted as official French Braille transcriptions.
|
|
51
|
+
|
|
52
|
+
### NOTE 3: Uppercase and Lowercase Indicators
|
|
53
|
+
|
|
54
|
+
For uppercase characters, the library currently uses `⠨` as the uppercase
|
|
55
|
+
indicator.
|
|
56
|
+
|
|
57
|
+
We did not find sufficient information in the references consulted to confirm
|
|
58
|
+
the use of `⠨⠨` for multiple consecutive uppercase characters. For lowercase
|
|
59
|
+
characters, the library currently uses `⠐`, following the convention used by
|
|
60
|
+
the Portuguese Braille standard.
|
|
61
|
+
|
|
62
|
+
These rules are configurable and can be easily changed using:
|
|
63
|
+
|
|
64
|
+
```python
|
|
65
|
+
self.setting_braille_rules_uppercase("⠨", "⠨⠨", "⠐")
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
|
|
69
|
+
## How to use?
|
|
70
|
+
```python
|
|
71
|
+
from braille import *
|
|
72
|
+
|
|
73
|
+
bb = bbf()
|
|
74
|
+
print(bb.output_braille_txt("Bibliothèque développée pour gérer le braille simple et complexe 2026."))
|
|
75
|
+
```
|
|
76
|
+
Output: ⠨⠃⠊⠃⠇⠊⠕⠞⠓⠮⠟⠥⠑⠀⠙⠿⠧⠑⠇⠕⠏⠏⠿⠑⠀⠏⠕⠥⠗⠀⠛⠿⠗⠑⠗⠀⠇⠑⠀⠃⠗⠁⠊⠇⠇⠑⠀⠎⠊⠍⠏⠇⠑⠀⠑⠞⠀⠉⠕⠍⠏⠇⠑⠭⠑⠀⠼⠃⠚⠃⠋⠲
|
|
77
|
+
|
|
78
|
+
|
|
79
|
+
# Announcement
|
|
80
|
+
- This package is part of an ecosystem called Braille Base. This name does not represent a company or business; it is an independent initiative aimed at providing registered braille tables for all of humanity.
|
|
81
|
+
|
|
82
|
+
- We constantly need help to register, update, and validate braille tables. There is still no official contact channel, but you can find new information on the blog braillebase.blogspot.com or brailletable.blogspot.com.
|
|
83
|
+
|
|
84
|
+
## Pre-registered Letters and Characters
|
|
85
|
+
|
|
86
|
+
- 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;
|
|
87
|
+
- é, à, è, ù, â, ê, î, ô, û, ë, ï, ü, ç, œ;
|
|
88
|
+
|
|
89
|
+
- 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;
|
|
90
|
+
- É, À, È, Ù, Â, Ê, Î, Ô, Û, Ë, Ï, Ü, Ç, Œ
|
|
91
|
+
|
|
92
|
+
- ., ,, ;, :, ?, !, (, ), [, ], “, ”, «, »;
|
|
93
|
+
|
|
94
|
+
- ⠼, 1, 2, 3, 4, 5, 6, 7, 8, 9, 0;
|
|
95
|
+
|
|
96
|
+
ÿ == y
|
|
97
|
+
Ÿ == Y
|
|
98
|
+
æ == ae
|
|
99
|
+
Æ == AE
|
|
100
|
+
|
|
101
|
+
|
|
102
|
+
```python
|
|
103
|
+
from braille import *
|
|
104
|
+
|
|
105
|
+
bb = bbf()
|
|
106
|
+
print(bb.confidence_test("Bibliothèque développée pour gérer le braille simple et complexe 2026."))
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
Output: {0: ['⠨', ['⠨']], 1: ['B', ['⠃']], 2: ['i', ['⠊']], 3: ['b', ['⠃']], 4: ['l', ['⠇']], 5: ['i', ['⠊']], 6: ['o', ['⠕']], 7: ['t', ['⠞']], 8: ['h', ['⠓']], 9: ['è', ['⠮']], 10: ['q', ['⠟']], 11: ['u', ['⠥']], 12: ['e', ['⠑']], 13: [' ', ['⠀']], 14: ['d', ['⠙']], 15: ['é', ['⠿']], 16: ['v', ['⠧']], 17: ['e', ['⠑']], 18: ['l', ['⠇']], 19: ['o', ['⠕']], 20: ['p', ['⠏']], 21: ['p', ['⠏']], 22: ['é', ['⠿']], 23: ['e', ['⠑']], 24: [' ', ['⠀']], 25: ['p', ['⠏']], 26: ['o', ['⠕']], 27: ['u', ['⠥']], 28: ['r', ['⠗']], 29: [' ', ['⠀']], 30: ['g', ['⠛']], 31: ['é', ['⠿']], 32: ['r', ['⠗']], 33: ['e', ['⠑']], 34: ['r', ['⠗']], 35: [' ', ['⠀']], 36: ['l', ['⠇']], 37: ['e', ['⠑']], 38: [' ', ['⠀']], 39: ['b', ['⠃']], 40: ['r', ['⠗']], 41: ['a', ['⠁']], 42: ['i', ['⠊']], 43: ['l', ['⠇']], 44: ['l', ['⠇']], 45: ['e', ['⠑']], 46: [' ', ['⠀']], 47: ['s', ['⠎']], 48: ['i', ['⠊']], 49: ['m', ['⠍']], 50: ['p', ['⠏']], 51: ['l', ['⠇']], 52: ['e', ['⠑']], 53: [' ', ['⠀']], 54: ['e', ['⠑']], 55: ['t', ['⠞']], 56: [' ', ['⠀']], 57: ['c', ['⠉']], 58: ['o', ['⠕']], 59: ['m', ['⠍']], 60: ['p', ['⠏']], 61: ['l', ['⠇']], 62: ['e', ['⠑']], 63: ['x', ['⠭']], 64: ['e', ['⠑']], 65: [' ', ['⠀']], 66: ['⠼', ['⠼']], 67: ['2', ['⠃']], 68: ['0', ['⠚']], 69: ['2', ['⠃']], 70: ['6', ['⠋']], 71: ['.', ['⠲']]}
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
### - pip install braillebasefrench
|
|
2
|
+
|
|
3
|
+
# French
|
|
4
|
+
|
|
5
|
+
### NOTE 1: Antoine number notation
|
|
6
|
+
|
|
7
|
+
This library provides text-to-Braille translation for French. However, it
|
|
8
|
+
does not currently implement all rules defined by the French Braille standard
|
|
9
|
+
(CBFU).
|
|
10
|
+
|
|
11
|
+
In particular, French Braille uses the **Antoine number notation** for the
|
|
12
|
+
transcription of numbers, which is not currently supported by this library.
|
|
13
|
+
|
|
14
|
+
Therefore, while regular text can be translated to Braille, texts containing
|
|
15
|
+
numbers may not be fully compliant with the French Braille standard.
|
|
16
|
+
|
|
17
|
+
Support for Antoine number notation and additional French Braille
|
|
18
|
+
transcription rules may be added in future versions.
|
|
19
|
+
|
|
20
|
+
### NOTE 2: Unsupported French Characters
|
|
21
|
+
|
|
22
|
+
We could not find an official French Braille representation for the character
|
|
23
|
+
`ÿ` in the references consulted. However, this character can occur in French
|
|
24
|
+
words and proper names.
|
|
25
|
+
|
|
26
|
+
To avoid translation or execution errors, the library currently falls back to
|
|
27
|
+
the Braille representation of the base letter `y`.
|
|
28
|
+
|
|
29
|
+
The same approach is used for the character `æ`. Since we did not identify a
|
|
30
|
+
dedicated French Braille representation for `æ`, it is currently handled as
|
|
31
|
+
the character sequence `ae`.
|
|
32
|
+
|
|
33
|
+
> **Note:** These are compatibility fallbacks implemented by the library and
|
|
34
|
+
> should not be interpreted as official French Braille transcriptions.
|
|
35
|
+
|
|
36
|
+
### NOTE 3: Uppercase and Lowercase Indicators
|
|
37
|
+
|
|
38
|
+
For uppercase characters, the library currently uses `⠨` as the uppercase
|
|
39
|
+
indicator.
|
|
40
|
+
|
|
41
|
+
We did not find sufficient information in the references consulted to confirm
|
|
42
|
+
the use of `⠨⠨` for multiple consecutive uppercase characters. For lowercase
|
|
43
|
+
characters, the library currently uses `⠐`, following the convention used by
|
|
44
|
+
the Portuguese Braille standard.
|
|
45
|
+
|
|
46
|
+
These rules are configurable and can be easily changed using:
|
|
47
|
+
|
|
48
|
+
```python
|
|
49
|
+
self.setting_braille_rules_uppercase("⠨", "⠨⠨", "⠐")
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
## How to use?
|
|
54
|
+
```python
|
|
55
|
+
from braille import *
|
|
56
|
+
|
|
57
|
+
bb = bbf()
|
|
58
|
+
print(bb.output_braille_txt("Bibliothèque développée pour gérer le braille simple et complexe 2026."))
|
|
59
|
+
```
|
|
60
|
+
Output: ⠨⠃⠊⠃⠇⠊⠕⠞⠓⠮⠟⠥⠑⠀⠙⠿⠧⠑⠇⠕⠏⠏⠿⠑⠀⠏⠕⠥⠗⠀⠛⠿⠗⠑⠗⠀⠇⠑⠀⠃⠗⠁⠊⠇⠇⠑⠀⠎⠊⠍⠏⠇⠑⠀⠑⠞⠀⠉⠕⠍⠏⠇⠑⠭⠑⠀⠼⠃⠚⠃⠋⠲
|
|
61
|
+
|
|
62
|
+
|
|
63
|
+
# Announcement
|
|
64
|
+
- This package is part of an ecosystem called Braille Base. This name does not represent a company or business; it is an independent initiative aimed at providing registered braille tables for all of humanity.
|
|
65
|
+
|
|
66
|
+
- We constantly need help to register, update, and validate braille tables. There is still no official contact channel, but you can find new information on the blog braillebase.blogspot.com or brailletable.blogspot.com.
|
|
67
|
+
|
|
68
|
+
## Pre-registered Letters and Characters
|
|
69
|
+
|
|
70
|
+
- 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;
|
|
71
|
+
- é, à, è, ù, â, ê, î, ô, û, ë, ï, ü, ç, œ;
|
|
72
|
+
|
|
73
|
+
- 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;
|
|
74
|
+
- É, À, È, Ù, Â, Ê, Î, Ô, Û, Ë, Ï, Ü, Ç, Œ
|
|
75
|
+
|
|
76
|
+
- ., ,, ;, :, ?, !, (, ), [, ], “, ”, «, »;
|
|
77
|
+
|
|
78
|
+
- ⠼, 1, 2, 3, 4, 5, 6, 7, 8, 9, 0;
|
|
79
|
+
|
|
80
|
+
ÿ == y
|
|
81
|
+
Ÿ == Y
|
|
82
|
+
æ == ae
|
|
83
|
+
Æ == AE
|
|
84
|
+
|
|
85
|
+
|
|
86
|
+
```python
|
|
87
|
+
from braille import *
|
|
88
|
+
|
|
89
|
+
bb = bbf()
|
|
90
|
+
print(bb.confidence_test("Bibliothèque développée pour gérer le braille simple et complexe 2026."))
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
Output: {0: ['⠨', ['⠨']], 1: ['B', ['⠃']], 2: ['i', ['⠊']], 3: ['b', ['⠃']], 4: ['l', ['⠇']], 5: ['i', ['⠊']], 6: ['o', ['⠕']], 7: ['t', ['⠞']], 8: ['h', ['⠓']], 9: ['è', ['⠮']], 10: ['q', ['⠟']], 11: ['u', ['⠥']], 12: ['e', ['⠑']], 13: [' ', ['⠀']], 14: ['d', ['⠙']], 15: ['é', ['⠿']], 16: ['v', ['⠧']], 17: ['e', ['⠑']], 18: ['l', ['⠇']], 19: ['o', ['⠕']], 20: ['p', ['⠏']], 21: ['p', ['⠏']], 22: ['é', ['⠿']], 23: ['e', ['⠑']], 24: [' ', ['⠀']], 25: ['p', ['⠏']], 26: ['o', ['⠕']], 27: ['u', ['⠥']], 28: ['r', ['⠗']], 29: [' ', ['⠀']], 30: ['g', ['⠛']], 31: ['é', ['⠿']], 32: ['r', ['⠗']], 33: ['e', ['⠑']], 34: ['r', ['⠗']], 35: [' ', ['⠀']], 36: ['l', ['⠇']], 37: ['e', ['⠑']], 38: [' ', ['⠀']], 39: ['b', ['⠃']], 40: ['r', ['⠗']], 41: ['a', ['⠁']], 42: ['i', ['⠊']], 43: ['l', ['⠇']], 44: ['l', ['⠇']], 45: ['e', ['⠑']], 46: [' ', ['⠀']], 47: ['s', ['⠎']], 48: ['i', ['⠊']], 49: ['m', ['⠍']], 50: ['p', ['⠏']], 51: ['l', ['⠇']], 52: ['e', ['⠑']], 53: [' ', ['⠀']], 54: ['e', ['⠑']], 55: ['t', ['⠞']], 56: [' ', ['⠀']], 57: ['c', ['⠉']], 58: ['o', ['⠕']], 59: ['m', ['⠍']], 60: ['p', ['⠏']], 61: ['l', ['⠇']], 62: ['e', ['⠑']], 63: ['x', ['⠭']], 64: ['e', ['⠑']], 65: [' ', ['⠀']], 66: ['⠼', ['⠼']], 67: ['2', ['⠃']], 68: ['0', ['⠚']], 69: ['2', ['⠃']], 70: ['6', ['⠋']], 71: ['.', ['⠲']]}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
from braillebase import BrailleBase
|
|
2
|
+
|
|
3
|
+
class BrailleBaseFrench(BrailleBase):
|
|
4
|
+
def __init__(self):
|
|
5
|
+
|
|
6
|
+
"""
|
|
7
|
+
"""
|
|
8
|
+
super().__init__()
|
|
9
|
+
self.setting_braille_rules_uppercase("⠨", "⠨⠨", "⠐")
|
|
10
|
+
#lowercase
|
|
11
|
+
self.append_braille_letter("é", ["⠿"]) #2026/09/10
|
|
12
|
+
self.append_braille_letter("à", ["⠷"]) #2026/09/10
|
|
13
|
+
self.append_braille_letter("è", ["⠮"]) #2026/09/10
|
|
14
|
+
self.append_braille_letter("ù", ["⠾"]) #2026/09/10
|
|
15
|
+
self.append_braille_letter("â", ["⠡"]) #2026/09/10
|
|
16
|
+
self.append_braille_letter("ê", ["⠣"]) #2026/09/10
|
|
17
|
+
self.append_braille_letter("î", ["⠩"]) #2026/09/10
|
|
18
|
+
self.append_braille_letter("ô", ["⠹"]) #2026/09/10
|
|
19
|
+
self.append_braille_letter("û", ["⠱"]) #2026/09/10
|
|
20
|
+
self.append_braille_letter("ë", ["⠫"]) #2026/09/10
|
|
21
|
+
self.append_braille_letter("ï", ["⠻"]) #2026/09/10
|
|
22
|
+
self.append_braille_letter("ü", ["⠳"]) #2026/09/10
|
|
23
|
+
self.append_braille_letter("ç", ["⠯"]) #2026/09/10
|
|
24
|
+
self.append_braille_letter("œ", ["⠪"]) #2026/09/10
|
|
25
|
+
self.append_braille_letter("ÿ", ["⠽"]) #2026/09/10
|
|
26
|
+
self.append_braille_letter("æ", ["⠁", "⠑"]) #2026/09/10
|
|
27
|
+
#uppercase
|
|
28
|
+
self.append_braille_letter("É", ["⠿"],1) #2026/09/10
|
|
29
|
+
self.append_braille_letter("À", ["⠷"],1) #2026/09/10
|
|
30
|
+
self.append_braille_letter("È", ["⠮"],1) #2026/09/10
|
|
31
|
+
self.append_braille_letter("Ù", ["⠾"],1) #2026/09/10
|
|
32
|
+
self.append_braille_letter("Â", ["⠡"],1) #2026/09/10
|
|
33
|
+
self.append_braille_letter("Ê", ["⠣"],1) #2026/09/10
|
|
34
|
+
self.append_braille_letter("Î", ["⠩"],1) #2026/09/10
|
|
35
|
+
self.append_braille_letter("Ô", ["⠹"],1) #2026/09/10
|
|
36
|
+
self.append_braille_letter("Û", ["⠱"],1) #2026/09/10
|
|
37
|
+
self.append_braille_letter("Ë", ["⠫"],1) #2026/09/10
|
|
38
|
+
self.append_braille_letter("Ï", ["⠻"],1) #2026/09/10
|
|
39
|
+
self.append_braille_letter("Ü", ["⠳"],1) #2026/09/10
|
|
40
|
+
self.append_braille_letter("Ç", ["⠯"],1) #2026/09/10
|
|
41
|
+
self.append_braille_letter("Œ", ["⠪"],1) #2026/09/10
|
|
42
|
+
self.append_braille_letter("Ÿ", ["⠽"],1) #2026/09/10
|
|
43
|
+
self.append_braille_letter("Æ", ["⠁", "⠑"]) #2026/09/10
|
|
44
|
+
|
|
45
|
+
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: braillebasefrench
|
|
3
|
+
Version: 0.2.9
|
|
4
|
+
Summary: A complete and extensible Unicode Braille processing library. French language version
|
|
5
|
+
Author: Nagao Yuji
|
|
6
|
+
License: Apache-2.0
|
|
7
|
+
Project-URL: Homepage, https://github.com/DukaCrazy/braillebasefrench
|
|
8
|
+
Project-URL: Documentation, https://github.com/DukaCrazy/braillebasefrench
|
|
9
|
+
Project-URL: Source, https://github.com/DukaCrazy/braillebasefrench
|
|
10
|
+
Keywords: braille,unicode,accessibility,API,binary,blind,education
|
|
11
|
+
Requires-Python: >=3.6
|
|
12
|
+
Description-Content-Type: text/markdown
|
|
13
|
+
License-File: LICENSE
|
|
14
|
+
Requires-Dist: braillebase>=0.2.9
|
|
15
|
+
Dynamic: license-file
|
|
16
|
+
|
|
17
|
+
### - pip install braillebasefrench
|
|
18
|
+
|
|
19
|
+
# French
|
|
20
|
+
|
|
21
|
+
### NOTE 1: Antoine number notation
|
|
22
|
+
|
|
23
|
+
This library provides text-to-Braille translation for French. However, it
|
|
24
|
+
does not currently implement all rules defined by the French Braille standard
|
|
25
|
+
(CBFU).
|
|
26
|
+
|
|
27
|
+
In particular, French Braille uses the **Antoine number notation** for the
|
|
28
|
+
transcription of numbers, which is not currently supported by this library.
|
|
29
|
+
|
|
30
|
+
Therefore, while regular text can be translated to Braille, texts containing
|
|
31
|
+
numbers may not be fully compliant with the French Braille standard.
|
|
32
|
+
|
|
33
|
+
Support for Antoine number notation and additional French Braille
|
|
34
|
+
transcription rules may be added in future versions.
|
|
35
|
+
|
|
36
|
+
### NOTE 2: Unsupported French Characters
|
|
37
|
+
|
|
38
|
+
We could not find an official French Braille representation for the character
|
|
39
|
+
`ÿ` in the references consulted. However, this character can occur in French
|
|
40
|
+
words and proper names.
|
|
41
|
+
|
|
42
|
+
To avoid translation or execution errors, the library currently falls back to
|
|
43
|
+
the Braille representation of the base letter `y`.
|
|
44
|
+
|
|
45
|
+
The same approach is used for the character `æ`. Since we did not identify a
|
|
46
|
+
dedicated French Braille representation for `æ`, it is currently handled as
|
|
47
|
+
the character sequence `ae`.
|
|
48
|
+
|
|
49
|
+
> **Note:** These are compatibility fallbacks implemented by the library and
|
|
50
|
+
> should not be interpreted as official French Braille transcriptions.
|
|
51
|
+
|
|
52
|
+
### NOTE 3: Uppercase and Lowercase Indicators
|
|
53
|
+
|
|
54
|
+
For uppercase characters, the library currently uses `⠨` as the uppercase
|
|
55
|
+
indicator.
|
|
56
|
+
|
|
57
|
+
We did not find sufficient information in the references consulted to confirm
|
|
58
|
+
the use of `⠨⠨` for multiple consecutive uppercase characters. For lowercase
|
|
59
|
+
characters, the library currently uses `⠐`, following the convention used by
|
|
60
|
+
the Portuguese Braille standard.
|
|
61
|
+
|
|
62
|
+
These rules are configurable and can be easily changed using:
|
|
63
|
+
|
|
64
|
+
```python
|
|
65
|
+
self.setting_braille_rules_uppercase("⠨", "⠨⠨", "⠐")
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
|
|
69
|
+
## How to use?
|
|
70
|
+
```python
|
|
71
|
+
from braille import *
|
|
72
|
+
|
|
73
|
+
bb = bbf()
|
|
74
|
+
print(bb.output_braille_txt("Bibliothèque développée pour gérer le braille simple et complexe 2026."))
|
|
75
|
+
```
|
|
76
|
+
Output: ⠨⠃⠊⠃⠇⠊⠕⠞⠓⠮⠟⠥⠑⠀⠙⠿⠧⠑⠇⠕⠏⠏⠿⠑⠀⠏⠕⠥⠗⠀⠛⠿⠗⠑⠗⠀⠇⠑⠀⠃⠗⠁⠊⠇⠇⠑⠀⠎⠊⠍⠏⠇⠑⠀⠑⠞⠀⠉⠕⠍⠏⠇⠑⠭⠑⠀⠼⠃⠚⠃⠋⠲
|
|
77
|
+
|
|
78
|
+
|
|
79
|
+
# Announcement
|
|
80
|
+
- This package is part of an ecosystem called Braille Base. This name does not represent a company or business; it is an independent initiative aimed at providing registered braille tables for all of humanity.
|
|
81
|
+
|
|
82
|
+
- We constantly need help to register, update, and validate braille tables. There is still no official contact channel, but you can find new information on the blog braillebase.blogspot.com or brailletable.blogspot.com.
|
|
83
|
+
|
|
84
|
+
## Pre-registered Letters and Characters
|
|
85
|
+
|
|
86
|
+
- 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;
|
|
87
|
+
- é, à, è, ù, â, ê, î, ô, û, ë, ï, ü, ç, œ;
|
|
88
|
+
|
|
89
|
+
- 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;
|
|
90
|
+
- É, À, È, Ù, Â, Ê, Î, Ô, Û, Ë, Ï, Ü, Ç, Œ
|
|
91
|
+
|
|
92
|
+
- ., ,, ;, :, ?, !, (, ), [, ], “, ”, «, »;
|
|
93
|
+
|
|
94
|
+
- ⠼, 1, 2, 3, 4, 5, 6, 7, 8, 9, 0;
|
|
95
|
+
|
|
96
|
+
ÿ == y
|
|
97
|
+
Ÿ == Y
|
|
98
|
+
æ == ae
|
|
99
|
+
Æ == AE
|
|
100
|
+
|
|
101
|
+
|
|
102
|
+
```python
|
|
103
|
+
from braille import *
|
|
104
|
+
|
|
105
|
+
bb = bbf()
|
|
106
|
+
print(bb.confidence_test("Bibliothèque développée pour gérer le braille simple et complexe 2026."))
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
Output: {0: ['⠨', ['⠨']], 1: ['B', ['⠃']], 2: ['i', ['⠊']], 3: ['b', ['⠃']], 4: ['l', ['⠇']], 5: ['i', ['⠊']], 6: ['o', ['⠕']], 7: ['t', ['⠞']], 8: ['h', ['⠓']], 9: ['è', ['⠮']], 10: ['q', ['⠟']], 11: ['u', ['⠥']], 12: ['e', ['⠑']], 13: [' ', ['⠀']], 14: ['d', ['⠙']], 15: ['é', ['⠿']], 16: ['v', ['⠧']], 17: ['e', ['⠑']], 18: ['l', ['⠇']], 19: ['o', ['⠕']], 20: ['p', ['⠏']], 21: ['p', ['⠏']], 22: ['é', ['⠿']], 23: ['e', ['⠑']], 24: [' ', ['⠀']], 25: ['p', ['⠏']], 26: ['o', ['⠕']], 27: ['u', ['⠥']], 28: ['r', ['⠗']], 29: [' ', ['⠀']], 30: ['g', ['⠛']], 31: ['é', ['⠿']], 32: ['r', ['⠗']], 33: ['e', ['⠑']], 34: ['r', ['⠗']], 35: [' ', ['⠀']], 36: ['l', ['⠇']], 37: ['e', ['⠑']], 38: [' ', ['⠀']], 39: ['b', ['⠃']], 40: ['r', ['⠗']], 41: ['a', ['⠁']], 42: ['i', ['⠊']], 43: ['l', ['⠇']], 44: ['l', ['⠇']], 45: ['e', ['⠑']], 46: [' ', ['⠀']], 47: ['s', ['⠎']], 48: ['i', ['⠊']], 49: ['m', ['⠍']], 50: ['p', ['⠏']], 51: ['l', ['⠇']], 52: ['e', ['⠑']], 53: [' ', ['⠀']], 54: ['e', ['⠑']], 55: ['t', ['⠞']], 56: [' ', ['⠀']], 57: ['c', ['⠉']], 58: ['o', ['⠕']], 59: ['m', ['⠍']], 60: ['p', ['⠏']], 61: ['l', ['⠇']], 62: ['e', ['⠑']], 63: ['x', ['⠭']], 64: ['e', ['⠑']], 65: [' ', ['⠀']], 66: ['⠼', ['⠼']], 67: ['2', ['⠃']], 68: ['0', ['⠚']], 69: ['2', ['⠃']], 70: ['6', ['⠋']], 71: ['.', ['⠲']]}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
LICENSE
|
|
2
|
+
README.md
|
|
3
|
+
pyproject.toml
|
|
4
|
+
braillebasefrench/__init__.py
|
|
5
|
+
braillebasefrench.egg-info/PKG-INFO
|
|
6
|
+
braillebasefrench.egg-info/SOURCES.txt
|
|
7
|
+
braillebasefrench.egg-info/dependency_links.txt
|
|
8
|
+
braillebasefrench.egg-info/requires.txt
|
|
9
|
+
braillebasefrench.egg-info/top_level.txt
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
braillebase>=0.2.9
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
braillebasefrench
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
requires = ["setuptools"]
|
|
3
|
+
build-backend = "setuptools.build_meta"
|
|
4
|
+
|
|
5
|
+
[project]
|
|
6
|
+
name = "braillebasefrench"
|
|
7
|
+
version = "0.2.9"
|
|
8
|
+
description = "A complete and extensible Unicode Braille processing library. French language version"
|
|
9
|
+
authors = [
|
|
10
|
+
{ name = "Nagao Yuji" }
|
|
11
|
+
]
|
|
12
|
+
readme = "README.md"
|
|
13
|
+
license = { text = "Apache-2.0" }
|
|
14
|
+
requires-python = ">=3.6"
|
|
15
|
+
|
|
16
|
+
dependencies = [
|
|
17
|
+
"braillebase>=0.2.9"
|
|
18
|
+
]
|
|
19
|
+
|
|
20
|
+
keywords = ["braille", "unicode", "accessibility", "API", "binary", "blind", "education"]
|
|
21
|
+
|
|
22
|
+
[project.urls]
|
|
23
|
+
Homepage = "https://github.com/DukaCrazy/braillebasefrench"
|
|
24
|
+
Documentation = "https://github.com/DukaCrazy/braillebasefrench"
|
|
25
|
+
Source = "https://github.com/DukaCrazy/braillebasefrench"
|