por
(The initial translation table for a translation is determined by the selected template, and may be changed using the Document / Translation Tables menu. Using those menus does not involve explicit use of the table designator. However, in cases where it is necessary to switch to a different translation table partway through a file, the designator for the table being switched to is required; see the general description of the [lnb~...] command for further details.)
The Portuguese tables support print-to-braille translation of Portuguese-language literary text in uncontracted (grade 1) braille as customarily used in Portugal and Brazil. English text may also be processed as a sub-language, and converted to contracted or uncontracted English braille (generally following American conventions in those minor instances where they differ from English ones). Spanish and several other languages may also be processed as sub-languages, and transcribed as uncontracted braille, except for Maori, which may be transcribed as contracted or uncontracted. The American Computer Braille Code (CBC) is also supported.
True braille-to-print translation is supported only within the Portuguese text, not within any embedded secondary language. This implies that the "translated line" will typically contain gibberish when viewing the braille file with the cursor in secondary language text.
English text may be entered as a secondary language, and converted to contracted or uncontracted English braille. That is, the grade switches affect the translation of the English text even though the Portuguese text is always transcribed in grade 1 regardless of the grade setting in effect. In literary text, American conventions are generally followed, to the extent that they sometimes differ slightly from British ones. Spanish, French, German, Latin, Italian and Maori may also be entered as secondary languages, the latter to be transcribed in either grade 1 or grade 2, the others to be transcribed in grade 1. Use the [lng...] code to switch. For instance, [lng~fr] (or [lng~fra]) would introduce a French passage, which would be terminated, i.e. reverting to Portuguese, at [lng] (or [lng~pt]). The available languages, together with their associated "lng" codes, are:
de (or deu) -- German
en (or eng) -- English
es (or esp) -- Spanish
fr (or fra) -- French
it (or ita) -- Italian
la (or lat) -- Latin
mi (or mao) -- Maori
pt -- Portuguese
In Maori text, one contraction ("wh") is normally used, and it will be used as long as grade two is in effect. The standard English contractions will be used in that language, as long as grade two is in effect. The other secondary languages are all transcribed in grade 1 regardless of the grade setting, as is the primary language, Portuguese. That is, the [g1] and [g2] codes affect the English text and any Maori text, but not the other languages.
Note that in addition to the above-listed "secondary languages" supported within the Portuguese table itself, it is also possible to switch to any of the available translation tables listed in DBT. (See the [lnb~...] code below.)
Computer Braille Code (CBC), as defined by the Braille Authority of North America, is supported.
In addition, it is 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 Portuguese 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.
[/] may be embedded within letter-groups that would normally be contracted, to prevent the contraction.
[ab] is equivalent to [g2]
[atx0] turns off the "all ASCII is literal" mode (see next code description), so that certain traditional "codes" typed in as direct text will continue to have effect. (For a list of these, see "Special Print Text Codes" within the "Codes Quick Reference" on DBT's Help menu.) This is presently the default (initial) condition, but as that is likely to change in future versions, it is advisable to put an [atx0] code at the beginning of any file in which the traditional in-text codes are used.
[atx1] turns on an "all ASCII is literal" mode, which will cause all ordinary printable ASCII characters to be considered as literal text, even those sequences that have traditionally been used as special "codes".
[cap-invert]
[cap-normal]
[cb-&]
[cb-de]
[cb-ds]
[cb-ee]
[cb-es]
[cb-ne]
[cb-ns]
[cb-se]
[cb-ss]
[cb-t1]
[cb-t2]
[cb-ue]
[cb-us]
[cb]
[cbi]
[cbn]
[cs-off]
[cs]
[cz]
[fte~b]
[fte~i]
[fte~u]
[fts~b]
[fts~i]
[fts~u]
[g1] switches to "grade 1" (uncontracted) braille. This does not affect the Portuguese text, which is uncontracted anyway, but does affect any embedded English and Maori text.
[g2] switches to "grade 2" (contracted) braille. This is the normal mode, but actually applies only to any embedded English and Maori text as the Portuguese text is always uncontracted.
[in] is equivalent to [g1]
[lnb]
[lnb~...] (for switching to another base [primary] language table)
[lng]
[lng~...] (see "Secondary Languages Supported," above)
[tx] resumes normal translation, ending "direct braille."
[txi]
[txn]
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, Spanish and Portuguese
British pound sign (£)
The above is a general guide only (see "General Notes" section at the beginning of this document).
These tables are based in part upon the information given for Portuguese in "World Braille Usage," a joint publication of UNESCO and the National Library Service for the Blind and Physically Handicapped, Washington, D.C. (1990).
The tables were developed from March 1994 by Duxbury Systems, Inc., originally for what was then the Brazilian variant of Portuguese braille, at the request of the Hadley School, which also provided valuable feedback. They were updated in September 2003 to conform to the unified standard, "Grafia Braille da Lingua Portuguesa", applicable in both Portugal and Brazil.
(Documentation reviewed: July 2010.)