This is the technical description of a DBT Translation table. If you want more general information about languages and template choices, please see the list of templates.
Initially, the language table for braille translation is determined by the selected template, and may be changed using the Document / Translation Tables menu. Using those menus does not require use of the table designator. However, to switch to a different translation table partway through a file, one must enter a DBT code and the designator for the table to switch to. For switching secondary languages within a base language table, see the [lng~X] command. For switching from one base language to another, see the [lnb~...] command.
The French tables support print-to-braille translation of French-language literary text and mathematical and computer notation, following the codes and customs established by the Association Valentin Hauy (AVH), Paris, and widely used for French by AVH and others until an international agreement on unification of French codes was reached in 2005.
Braille-to-print translation is supported for this language. However, braille-to-print translation may not be perfect, therefore beware that errors can occur. If you find errors or have suggestions, please send both the *.dxb and *.dxp files along with an explanation to: languages@duxsys.com. Please be sure to include sample files!
True braille-to-print translation is supported within French text, but not in technical notation. This means that any mathematics or computer-notation portions of a braille file will not translate correctly to print. It also means that the "translated line" will typically contain gibberish when the cursor is in mathematics or computer notation.
No secondary languages are supported.
Note however that it is possible to switch to any of the available translation tables listed in DBT. (See the [lnb~...] code below.)
The mathematics-oriented technical notation code is defined in "Notation Mathematique," published by AVH. The computer-notation code, "Informatique," is also defined by AVH.
It is also possible to switch to any of the available translation tables listed in DBT (see the [lnb~...]code below), many of which do support various technical codes, such as for mathematics or computer notation, or which support “unified” treatment of technical notation as well as literary text in the base language associated with the table.
The following DBT translation codes are available when using the French (pre-Unified) table.Any other translation codes used will be ignored, or indeed may cause unexpected results.If using an alternative translation table, i.e.when switching to another base language table by means of the [lnb~...] code, please refer to the relevant topic and available codes for that table.
[/]
[ab] is equivalent to [g2]
[bar]
[beN] where N is a number in the range 0 through 4 is a special variant of [be] to end a subscript with "forced" treatment; see [bsN] below.
[be]
[bline] -- ignored.
[bsN] where N is a number in the range 0 through 4 is a special variant form of the [bs] code that forces treatment of a subscript as (0) simple, (1) medium, (2) high, (3) framed by parentheses, or (4) framed by brackets. (If treatment is not forced, the simple treatment is used if it can be determined that such treatment is OK and otherwise parenthesis framing is used.)
[bs]
[cb] is a synonym for [iq], which see below.
[cbi] is a synonym for [iq], which see below.
[cbn] is a synonym for [iq], except that no indicator is generated.
[cz]
[cz;f] is like [cz]except that the ASCII characters correspond to braille according to French conventions (CBFR-1252).
[e]
[feN] where N is 0 or 1 is a special variant form of the [fe] code used when forcing the denominator to have (0) "simple" or (2) "framed" treatment of a fraction; see [fsN] and [flMN] below.
[fe]
[flMN] where M and N are each 0 or 1 is a special variant form of the [fl] code used when forcing both the numerator and denominator to have simple or framed treatment. For example,
[fs0]numerator[fl01]denominator[fe1]
would force the numerator to have simple treatment and the denominator to have framed treatment. (If forcing is not used, simple treatment is used if it can be determined that such treatment is clearly OK, otherwise the framed treatment is used.)
[fl]
[fsN] where N is 0 or 1 is a special variant form of the [fs] code used when forcing the numerator to have (0) "simple" or (2) "framed" treatment of a fraction; see [feN] and [flMN] above.
[fs]
[fte~b]
[fte~i]
[fte~u]
[fts~b]
[fts~i]
[fts~u]
[g1]
[g2]
[i]
[ii]
[in] is equivalent to [g1]
[iq] begins "informatique" (computer braille); see also [tx] below.
[ixrtdN] where N is 0, 1 or 2 is a special variant of [ixrtd] used for forcing (1) simple, (2) medium or (3) framed treatment of the radicand. (If forcing is not used, simple treatment is used if it can be determined that such treatment is clearly OK, otherwise the framed treatment is used.)
[ixrtd]
[ixrteN] where N is 0, 1 or 2 is a special variant of [ixrte] used for forcing (1) simple, (2) medium or (3) framed treatment of the radicand. See [ixrtdN], above.
[ixrte]
[ixrtsN] where N is 0, 1 or 2 is an allowed special variant form of [ixrts] that is always equivalent to [ixrts]; see [ixrtdN], above.
[ixrts]
[lnb]
[lnb~...] (for switching to another base [primary] language table)
[lng] -- ignored.
[oeN] where N is a number in the range 0 through 4 is a special variant of [oe] to end an "over" index with "forced" treatment; see [osN] below.
[oe]
[osN] where N is a number in the range 0 through 4 is a special variant form of the [os] code that forces treatment of an "over" index as (0) simple, (1) medium, (2) high, (3) framed by parentheses, or (4) framed by brackets. (If treatment is not forced, the simple treatment is used if it can be determined that such treatment is OK and otherwise parenthesis framing is used.)
[os]
[peN] where N is a number in the range 0 through 4 is a special variant of [pe] to end a superscript with "forced" treatment; see [psN] below.
[pe]
[psN] where N is a number in the range 0 through 4 is a special variant form of the [ps] code that forces treatment of a superscript as (0) simple, (1) medium, (2) high, (3) framed by parentheses, or (4) framed by brackets. (If treatment is not forced, the simple treatment is used if it can be determined that such treatment is OK and otherwise parenthesis framing is used.)
[ps]
[sqrteN] where N is 0, 1 or 2 is a special variant of [sqrte] used for forcing (1) simple, (2) medium or (3) framed treatment of the radicand. See [sqrtsN], below.
[sqrte]
[sqrtsN] where N is 0, 1 or 2 is a special variant of [sqrts] used for forcing (1) simple, (2) medium or (3) framed treatment of the radicand. (If forcing is not used, simple treatment is used if it can be determined that such treatment is clearly OK, otherwise the framed treatment is used.)
[sqrts]
[tce] cancels the effect of [tcs], restoring literary treatment (which is the default).
[tcs] is required in this table to enable math (technical) context, i.e.for general treatment of technical material including the surrounding text. See the Topical How-To Guide, under Help, for general instructions.
[te] cancels the effect of [ts], restoring normal text mode (even though "technical context" may remain in effect).
[ts] initiates "technical notation," i.e."math mode" within technical context.
[tx] cancels "informatique" (computer braille -- see [iq]) or "no translate" (see [cz]), reverting to ordinary text.
[txn] is like [tx]) except that no indicator is generated.
[ueN] where N is a number in the range 0 through 4 is a special variant of [ue] to end an "under" index with "forced" treatment; see [usN] below.
[ue]
[usN] where N is a number in the range 0 through 4 is a special variant form of the [us] code that forces treatment of an "under" index as (0) simple, (1) medium, (2) high, (3) framed by parentheses, or (4) framed by brackets. (If treatment is not forced, the simple treatment is used if it can be determined that such treatment is OK and otherwise parenthesis framing is used.)
[us]
[vrn] cancels any "variation" in effect, reverting to standard treatment of all punctuation. Note that only at most one of the variations listed below can be in effect at any one time. Also, all variation codes are subject to removal or change in subsequent versions.
[vrn~003] forces dot 3 to be used for all instances of period/fullstop (.)
[vrn~256] forces dots 256 to be used for all instances of period/fullstop (.) and also other marks, such as the percent sign (%), to be treated in accordance with current proposals of the International Forum on French Braille Standardization.
[vrn~gpt] forces "old" treatment of parentheses, quotes and dashes.
The table is designed to work with the following groups of characters:
All ASCII printable characters
Accented characters and punctuation marks typical of French, German, Italian, and Spanish
British pound and other miscellaneous signs (DUSCI page D+ee...)
Mathematical signs, shapes, etc. (in "technical context" only) (DUSCI pages D+e2..., D+e5..., D+ef..., D+f0..., D+f1...)
Note that, for historical reasons, certain printable characters are reserved for "forcing" symbols and indicators, namely:
D+9b (cent sign): indicator for start of continuous (multi-word) capitals
D+9d (yen sign): indicator for one word in full capitals D+9f (small script f with hook): indicator for last word in continuous (multi-word) capitals D+f9 (middle dot): forces "abbreviation point" instead of full stop
The above is a general guide only (see "General Notes" section at the beginning of this document).
The development of the literary portions of these tables commenced in March 1987, under the sponsorship of the Association Valentin Hauy (AVH), Paris, and as a joint technical effort of Duxbury Systems, Inc. and AVH. The primary specification for French literary braille usage with contractions is "Abrege; Orthographique Etendu," a publication of AVH."Table de Transcription pour la Production du Braille Abrege par Ordinateur," by Michel Jacquin and published by AVH (1986) was also instrumental in this early development.
An "informatique" (computer notation) code was also included in the early work, and revised considerably in 1999-2000 in response to a change in specifications.
The braille-to-print translation tables were added starting in November 1990, with the same sponsors and developers.
Mathematics translation facilities, following "Notation Mathematique" as prepared by AVH, were added in 1999-2000, with AVH again providing sponsorship and collaborating in the technical work with Duxbury Systems, Inc.
(Documentation reviewed: July 2010.)