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.
Moon is a system of tactile writing wherein the raised characters mostly resemble the print characters for which they stand, thereby making the system especially easy to learn for people who become blind late in life. It was invented by Dr. William Moon in 1845. Although it is not a form of braille, Moon can be used as a stepping-stone to the learning of braille. A new "Moon Literacy" web site was launch early in 2006 - http://moonliteracy.org.uk/. The RNIB web site at http://www.rnib.org.uk is also a source of information about the Moon system.
The English Moon tables support print-to-Moon translation for three English literary grades (grade two, which is the default, grade one, and grade "one-half" [fully spelled]).
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: firstname.lastname@example.org. Please be sure to include sample files!
An Enabling Technologies embosser with "Moon mode" setting, or equivalent, must be used to emboss the output. Make sure that the page dimensions (under Global/Embosser) have been set appropriately -- e.g. 22 characters per line, 21 lines per page would be typical for a Juliet embosser with paper 13 inches in depth and 10-3/4 inches in width (excluding the tractor-feed border).
The print file can be prepared in any of the standard ways, e.g. by direct keying or by importing from a word processor file, and also may be viewed and edited normally in DBT. However, the translated output cannot, at this writing (August 2000), be viewed naturally (i.e. in a Moon font) within DBT. Generally, when viewing that Moon output (which is labelled as "braille"), the most sensible viewing option is to select the "print font" under the "View" menu. The print characters stand one-for-one with Moon characters, and mostly have a mnemonic relationship to them even if they are not always shaped similarly. You may edit this Moon file, save it to a .DXB or .BRF file, emboss to a suitably set embosser, etc., just as you would a regular braille file.
Capital letters are usually not indicated as such in Moon, and so the [caplv1] code should be used except in exceptional circumstances, as explained in the Moon Transcribers Instruction Manual, section 3.4. When those exceptional circumstances pertain and capitals are to be indicated in Moon, the user should prepare the input file so that only those initial capitals that are to be indicated are actually uppercase, and either no [caplv...] command should be given or equivalently [caplv3] should be used. (Usually any [caplv...] code is automatically supplied in the "initial" style of a suitable template, so it is just a matter of picking the right template.)
True Moon-to-print translation is not supported. This means that it is not generally useful to translate the Moon output to print. It also means that the "translated line" will typically contain gibberish when viewing the Moon file -- you may prefer to turn off the "translated line" under the View menu, or even under Global/Default if you wish it to be off by default.
No secondary languages are supported.
No technical codes are supported.
The following DBT translation codes are available when using the English/Moon 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]
[caplv1] starts suppressing the indication of capital letters.
[caplv3] restores the indication of capital letters. This is the default mode for this table, in order to be consistent with the other English tables, i.e. those for braille. However, see the paragraph on capitals under "Special Requirements and Limitations" above.
[g1] switches to "grade 1" Moon, as defined in the Transcribers Instruction Manual. (Note that some contractions, such as "and," are used even in grade 1.)
[g2] switches to "grade 2" Moon (the normal mode), where all contractions are used.
[g0.5] switches to "grade one-half," where all words are fully spelled out. (Note that the character after the letter "g" is the digit zero.)
[in] is equivalent to [g1]
[lnb~...] (for switching to another base [primary] language table) (Note that when translating to Moon, table switching would generally be useful only from one Moon table to another [i.e. not from a Moon to a braille table, nor vice versa], and as of July 2010, this English/Moon table is the only one defined in DBT.)
[vrn~rq] causes outer and inner quotes to be understood according to the reverse of the normal convention. The normal convention, since April 2004, is that the double print quote (") stands for an outer quote and an accent-grave (`) stands for an inner quote, as has always been customary in the English braille tables. Prior to April 2004 the convention for the English Moon table was the reverse of that, and so this "variation" code is provided as an easy way to tag older files so that they will be treated the same as they were formerly.
[vrn] restores the normal convention for outer and inner quotes.
The table is designed to work with the following groups of characters:
All ASCII printable characters
Note that some ASCII characters do not have a defined Moon equivalent; the output for those is arbitrary.
These tables are based upon the "Moon Transcribers Instruction Manual" (April 1996), written and used by the Royal National Institute for the Blind (RNIB). They were originally developed in May 1999 by Duxbury Systems, Inc., with the guidance and assistance of RNIB and Enabling Technologies.
(Documentation reviewed: July 2010.)