The first golden rule is that for most of your general literary work, you can define the layout of your braille document through DBT's menus.
The second golden rule with Codes is to try and avoid them wherever possible.
The third golden rule is to accept that this section is far from complete, but hopefully will point you in the right direction.
However, there are occasions when you need to do something really special.
Codes can be broadly categorized as translation codes and formatting codes. Formatting codes are supported in all DBT documents. Support for translation codes varies by translation table. See Language Translation Tables for documentation about translation tables and the formatting codes each supports.
This can be a rather technical section, so enter it with caution.
SPECIAL NOTE: Codes used in these topics will be displayed in Courier New font, and appear red. ALL DBT codes are contained within square brackets. However, it should also be noted that Codes are inserted into your text in a special way, described in the Manually Inserting and Amending Codes Topics.
The Codes in DBT basically affect the final layout of the braille document, the key word being "layout". Just as corporations and companies have their own corporate designs for their documents, so braille follows layout conventions recommended by the braille authority for individual countries. Similarly major braille producers may even have a "Corporate Style" which determines the way they lay out braille documents.
In the main, DBT will do an excellent job of formatting braille documents, but you should always try an follow any local recommendations.
All Word Processors use some form of Code, which may or may not be hidden to the user, to determine how something is displayed. An obvious example is where we want to make a word appear bold.
The following line shows what is actually "hidden" behind the word "bold" in the previous paragraph.
<span style="font-weight: bold>bold</span>
DBT is no exception, except that its codes relate to how the Braille is formatted.
For example, if we were to write, "In English Braille the letter k is a Word-sign for knowledge.", we would not want the word "knowledge" to be translated to "k".
We would therefore use the code [g1] to tell DBT NOT to translate the word, and [g2] to continue in Grade 2 Braille.
In English Braille the letter k is a Word-sign for [g1]knowledge[g2]."
A code is a special character (or group of characters) in a document that will not appear in the final output. The EFFECTS of the codes WILL appear. Codes are added to your document whenever you use the Layout Menu to produce a translation or formatting effect.
In DBT, you can opt to see the codes by going to the View Menu and selecting Codes. (Or alternatively Alt + F3)
Codes are surrounded by square brackets. For example, in a coded view, you might have:
A[SK1]B[SK1]C
which would cause the output to appear as follows:
A
B
C
Viewing codes can help track down formatting or translation errors. Without codes showing, your view is WYSIWYG and the effects of the codes are usually apparent. For further help with the syntax of the codes, see Help: Codes Quick Reference.
To view Codes in DBT, hold down the Alt key and press F3. This is what is called a "Toggle" command, and therefore pressing Alt + F3 again will turn Coded View off.