home *** CD-ROM | disk | FTP | other *** search
-
-
-
- TURBO BRAILLE
-
-
- Another Sound Alternative
-
-
-
-
- For IBM Compatible Personal Computers
-
-
-
- Version 2.59
-
-
-
-
-
-
- Copyright (C) 1989-1991
-
- by
- KANSYS, Inc.
- 1016 Ohio Street
- Lawrence, KS 66044
-
-
-
- Telephone: 913-843-0351
- or 800-279-4880
-
- INTRODUCTION
-
- Turbo Braille is a computer program designed to produce
- Grade II English Braille. This production includes translation
- and formatting. In addition to producing Grade II braille, Turbo
- Braille will produce Grade I and/or computer braille. The
- program should run on all IBM and compatible personal computers
- under MS-DOS or PC-DOS version 3.0 or later, as well as a number
- of non-IBM compatible MS-DOS machines, such as the Zenith Z-100,
- DEC Rainbow and Texas Instruments TI Professional. Not only is
- Turbo Braille able to run on many MS-DOS machines, but it also
- works well with many screen review/speech synthesizer
- combination. Turbo Braille requires DOS Version 3.0 or higher
- and 128K of free memory to run. It will work with either a
- floppy drive or hard disk equipped computer. While a braille
- printer is necessary to print hard copy braille, it is not
- necessary to have a braille printer to run Turbo Braille. The
- program should support any braille printer. You can establish up
- to ten printer definitions, which are available for use at any
- time. Instructions for installing Turbo Braille on your system
- can be found in the file called "READ.ME"
-
- As you learn more about Turbo Braille, you will find that it
- has two personalities. It can either be a simple and easy-to-use
-
-
-
-
-
-
- program, or it can be a complex and powerful tool, with many
- formatting commands available for your use. The choice is yours.
- In its basic mode of operation, Turbo Braille will accept as
- input any standard ASCII text file, any WordPerfect Version 4.2
- or 5.0 file, many WordPerfect 5.1 files, or any WordStar
- Professional Version 4, 5, or 6.x file. Using one of these file
- types, Turbo Braille will produce well-formatted accurate
- braille. Our intention is to make Turbo Braille a program which
- will produce acceptable braille for personal use without a lot of
- user intervention. To this end, Turbo Braille will handle a
- number of display/formatting attributes including centering,
- unusual mixes of capitalization, boldfacing, italics and page
- numbers--both print and braille, In its basic mode of operation.
- An upcoming version will also handle running headers and footers
- automatically. Turbo Braille is unique among braille translators
- in its ability to use WordPerfect and WordStar files directly as
- input and in its ability to handle many formatting tasks
- automatically. Further, Turbo Braille has available a powerful
- set of "dot commands" which precisely control braille formatting.
- This manual is divided into two sections. Section One will
- discuss the basic operation of the program while Section Two will
- discuss braille formatting and the dot commands in some detail.
- If you have any questions, problems or suggestions, please feel
- free to write or call. You can reach us at 913-843-0351 or call
- our toll-free number, 800-279-4880.
-
- DEMONSTRATION VERSION
-
- Turbo Braille is available in a demonstration version.
- Although the program is fully functional, it will only produce
- one page of output. (Specify the page to be printed by "Jumping
- Pages" with the "/J" command.) However, this will allow you to
- see how all the commands work, experiment with the dot commands,
- and it will also show you how fast Turbo Braille is.
-
- SECTION ONE
- BASIC OPERATION
-
- QUICK START
-
- You can easily produce well-formatted braille for your day-
- to-day use with Turbo Braille. All you have to do is type
- "TBRL", a space and the name of any supported file type (that is
- any ASCII text file, WordPerfect, or WordStar file) at the DOS
- prompt and hit "Return." Turbo Braille will automatically write a
- translated file with the same name and a .BRL extension. Use the
- DOS "PRINT" command to print the file on your braille printer, or
- use the Slash W 1 (/W1) switch to automatically print to the PRN
- device. This switch must be placed between the "TBRL" and the
- name of the file on the command line. The default printer
- settings are 40 cells per line, 25 lines per page, with
- formfeeds, no page offset, and continuous paper. That is all
- there is to using Turbo Braille in its most basic mode. Read on
- to see how to change these defaults, should you need to.
-
-
-
-
-
-
-
- MODES OF OPERATION
-
- Turbo Braille has two modes of operation, an interactive
- mode and a batch mode. Either mode is entered from the DOS ">"
- prompt. In batch mode you enter the program name, any applicable
- switches, the filename(s) to be translated, and hit the "carriage
- return" or "enter" key. The program executes, performs the
- translation/formatting tasks as instructed, and exits, leaving
- you at the DOS prompt once again. The switches and filenames are
- processed strictly from left to right just as they are
- encountered, so that switches affecting a particular file must
- appear before the name of that file.
-
- To enter Turbo Braille's Interactive Mode, simply type
- "TBRL" at the DOS ">" prompt. (Do not type the quotation marks;
- they are included to indicate that the enclosed text is a
- command.) Further, case is not important when typing a command
- from the DOS prompt. The program will run, giving you a sign-on
- message and the Turbo Braille prompt, which is TB->. When you
- see the TB-> prompt you know that you are in Interactive Mode.
- From this mode, you can enter filename(s) and/or other commands
- which will be immediately executed. When each file or command has
- been processed, you will be returned to the TB-> prompt. To
- return to the DOS prompt from the interactive mode, simply press
- "return" or "enter" at the TB-> prompt.
-
- In the Interactive Mode, filenames and commands are entered
- one at a time. It is possible to use the DOS wild card characters
- "?" and "*" when specifying files to be processed. The wild card
- characters are also available for use in Batch Mode. When using
- these wild card characters, it is possible to specify more files
- or different files than you intended to process. For this reason,
- files with certain extensions have been excluded. These include
- files with the extensions .COM, .EXE, .LIB, .OBJ AND .SYS. The
- backup file extensions .BAK and .BK! have also been excluded.
- Finally, the data compression extensions .ARC and .ZIP and the
- KANSYS, Inc. extensions .BRL, .CFG and .PV3 have been excluded.
- You would not normally want to translate one of these files into
- braille. If you do, you will have to rename it first.
-
-
- ENTERING COMMANDS
-
- In the Batch Mode, TBRL commands are called switches. In the
- Interactive Mode, they will be referred to as commands. Each
- command or switch is started with a forward slash "/". It is
- followed by a command letter and possibly by a number or other
- information. A dash "-" can be used in place of the slash, if you
- prefer. All filenames and switches should be separated with
- spaces when entering them on the command line in Batch Mode. In
- Interactive Mode, filenames and commands are entered one at a
- time from the TB-> prompt.
-
- HELP
-
-
-
-
-
-
-
- Turbo Braille has available an extensive Help facility. To
- enter Help, type Slash H "/H" from the TB-> prompt or follow the
- "TBRL" command with a Slash H. You can then read through the
- Help information a screen at a time learning about the program.
- To navigate within the Help system you type a letter followed by
- a press of the "carriage return" or "enter" key. The available
- letters are "N" for the next screen, "P" for the previous screen,
- "F" for the first screen and "D" for done. Upon exiting Help,
- you will be back at the TB-> prompt.
-
- INPUT AND OUTPUT FILES
-
- As mentioned earlier, Turbo Braille accepts three standard
- file formats as its input. These file types are ASCII text
- files, WordPerfect Version 4.2 and 5.0 files, and WordStar
- Professional Version 4, 5, and 6 files. Those of you who have
- used earlier versions of Turbo Braille will notice that the
- ability to handle later versions of WordPerfect and WordStar
- files is the major difference with Version 2.0 of Turbo Braille.
- In addition, a number of translation errors have been corrected
- and the program can now handle long lines of text, such as those
- produced by spreadsheet programs.
-
- Actually, Turbo Braille will accept a fourth kind of file as
- input, a "BIF" or Braille Intermediate File. BIF files are
- produced by Turbo Braille itself and are ASCII files interspersed
- with the dot commands which Turbo Braille uses to control
- formatting. Turbo Braille appends a three-letter extension to
- file names so their type can be identified. All translated
- braille files will be followed by ".BRL" and all BIF files will
- be followed by ".BIF".
-
- When using Turbo Braille, it is possible to: produce a
- braille file which can be printed at a later time; produce a BIF
- file which can be edited and/or printed at a later time; or
- produce braille and BIF files at the same time. The default for
- Turbo Braille is to produce Braille files, although this can be
- easily changed.
-
- There are two switches/commands which control the kind of
- file produced, Slash M "/M" and Slash W "/W". Each of these is
- followed by a number in the range of 0 through 3. Further,
- either can be followed by a Question Mark "?" which will show you
- the current setting. The choices are as follows: /M0 produces no
- output, /M1 makes a BIF file, /M2 makes a braille file, and /M3
- makes both a braille and BIF file. What happens to files is
- controlled by the "W" switch or command. The choices here are:
- /W0 discards all braille output, /W1 sends output to a printer,
- /W2 writes to a file with the .BRL extension, and /W3 sends
- output to a printer and to a file. The default setting is 2,
- which of course means that a braille file is written.
-
- Setups
-
- As you have seen so far, Turbo Braille has a number of
-
-
-
-
-
-
- options which can be easily changed while you are using the
- program. The values for all the commands and switches plus all
- printer definitions and Global dot commands are saved in a file
- called "TBRL.CFG". Two kinds of Setups are available, Local and
- Global.
-
- As you recall, in the "README.DOC" file you were advised to
- put Turbo Braille in a subdirectory called "\TB" if you use a
- hard disk equipped computer. You were then advised to put this
- subdirectory on your "path." This will allow you to run Turbo
- Braille from any subdirectory on your computer.
-
- Another reason for this advice has to do with Setups. Two
- kinds of Setups are available to you when using Turbo Braille,
- Global and Local. A Global Setup is located in the same
- directory as Turbo Braille itself. Any commands found here will
- be applied to all files processed by the program. A Local Setup
- can be located in any subdirectory other than the one which
- contains Turbo Braille. This means that you can establish sub-
- directories for different kinds of data or output files, with
- appropriate Local Setups for each.
-
- When you execute the program, Turbo Braille first checks the
- subdirectory into which you are logged for a TBRL.CFG file and,
- if one is found, it is used to establish the default settings.
- If there is none there, Turbo Braille checks in the directory in
- which the program is located. If one is found here, it is used
- as the Global Setup.
-
- If you make any changes while using the program, such as
- defining a printer, and you wish to make these changes permanent,
- you must save the changes as either a Local or Global Setup.
- This is done with the Slash SL (/SL) or Slash SG (/SG) commands
- or switches respectively. To make any setup a Local Setup you
- must also be logged into a directory other than that in which
- Turbo Braille is located. Remember that Global Setups are the
- default unless a Local Setup has been established. If it has, it
- becomes the default.
-
- You can also review and save Setups from within Turbo
- Braille. This is done with the Slash S "/S" command or switch.
- The "/S" is followed by one of three choices, "?" "G" or "L".
- The "/S?" command will display information about the Setup
- currently being used, "/SG" will save a Global Setup and "/SL"
- will save a Local Setup in the current subdirectory.
-
- PRINTING
-
- Turbo Braille has the ability to store information on up to
- ten printers. They are numbered 0 through 9 with 0 being the
- default. Thus, Turbo Braille will automatically format for
- printer 0 unless you tell it otherwise. Printer 0 is not
- redefinable by the user.
-
- To define a printer, Turbo Braille needs to know the page
-
-
-
-
-
-
- length in lines, the line length in braille cells, whether or not
- you want a page offset and if so how much, whether your printer
- uses continuous paper or single sheets, and finally whether or
- not form feeds are necessary. Page offset is space which is
- automatically inserted at the beginning or left side of each
- line. This space may be necessary to allow for the binding of
- pages. A form feed is a command which advances your printer to
- the next page. Most printers require a form feed from the
- software. Try providing a form feed, and if you get a blank
- sheet between printed pages, change this selection.
-
- Printers are handled with the Slash P "/P" command or
- switch. The possible modifiers are Question Mark "?" or a digit
- 0 through 9 which allows you to work with a specific printer
- definition. The command or switch "/p?" will display information
- on all defined printers while /P# (where # is the number, 0
- through 9, of a specific printer) will allow you to work with
- that printer definition. After you press "/P#" you will be
- prompted to press "C" to change the definition, "D" to delete the
- definition or "K" to keep the definition. If you change it, you
- will be prompted to fill in each necessary item of information.
- For the page offset, you can enter "N" for No or enter a number
- of cells to use as an offset. Typing "0" will also have the same
- effect as typing "N". All printer definitions are saved as a
- part of a Local or Global Setup file.
-
- As mentioned earlier, printer 0 is the default. If you are
- using any other definition for printing, you must specify
- formatting for that printer with the Slash F "/F" command or
- switch. To use this command or switch, enter "/F" followed
- immediately by a digit 0 through 9 corresponding to the desired
- printer. This information, if changed, should also be saved in a
- Setup file.
-
- In Section Two of this manual you will learn in detail about
- the many dot commands used to control braille formatting in BIF
- files. These dot commands can be embedded in a BIF file and/or
- added to a Setup file so that they will apply to the entire
- document. Dot commands are added with the Slash A "/A" command
- or switch and deleted with the Slash D "/D" command or switch.
- The "A" or "D" are followed immediately by any legal dot command
- including its leading period. The command Slash D* "/D*" will
- delete all dot commands from the Setup.
-
- The Slash W (/w) command or switch is used to control
- printing. It is followed by a number 0 through 3. At setting 0,
- no printing will take place. Setting 1 will direct output to a
- printer, setting 2 directs output to a file, and setting 3
- directs output to both a printer and a file. You will remember
- that the type of file, .BIF, .BRL or both is controlled by the
- Slash M "/m" switch or command.
-
- The Slash W "/w" command or switch directs output to the DOS
- PRN device. This is normally LPT1, but can be redefined with the
- Mode command. You can also print by producing a .BRL file,
-
-
-
-
-
-
- exiting to DOS and using the "PRINT" command. While the "PRINT"
- command is slightly different in various versions of DOS, it is
- easy to use. You normally enter "PRINT filename" on the command
- line and the file will be printed to the PRN device. For the
- exact details on using the "Print" command, consult your DOS
- manual.
-
- As mentioned earlier, you can also jump over a specific
- number of pages before printing is started. This command could
- be useful, for example, if your printer malfunctioned in the
- middle of a printing job. You could re-process the input file
- telling it to start printing on the first page which was bad.
- This is done with the Slash J "/J" command or switch. The "J" is
- followed immediately by the number of the last good page. Turbo
- Braille would then jump over the number of pages specified by the
- number following the "/j" command or switch, restarting printing
- on the next page. This command can also be used to specify a
- specific page to be printed by the Demonstration Version of Turbo
- Braille . The default is 0, which means that the program does not
- jump over any pages. Remember that the command or switch "/J1"
- would jump over one page, starting printing on page two.
-
- VERBOSITY LEVEL
-
- There is one final command/switch in Turbo Braille. This is
- the Verbosity command which is changed with the Slash V "/v"
- command or switch. The "V" is followed immediately by a number
- in the range of 0 through 9. The default is 0. Verbosity
- controls the number and length of messages which Turbo Braille
- displays while it is running. At this time, levels 0, 1, 2 and 3
- have been implemented.
-
- While Turbo Braille is translating, you will hear it report
- a number regularly. The program uses an 8K buffer to handle data
- and what you are hearing is a count of buffers full of data being
- translated. While this count will help you gauge the programs
- progress, this is not a page count. As you increase the
- Verbosity level you will be given more information on what is
- happening. Experiment until you get the level you like -- you
- can't hurt anything.
-
- SECTION TWO
-
- FORMATTING COMMANDS
-
- RULES FOR TURBO BRAILLE
-
-
- Dot Commands and Imbedded commands
-
- Turbo Braille, from KANSYS, Inc., is a powerful braille
- translator. It takes files produced in WordStar and WordPerfect,
- as well as regular text files, and turns them into properly
- formatted braille files, often with no extra effort from the
- person entering the data.
-
-
-
-
-
-
-
- The formatting is accomplished by use of a number of dot
- commands--commands made up of two alpha letters preceded by a
- period. These commands center lines (.ce), skip lines (.sp),
- determine when to change to a new paragraph and indent it (.pp),
- just to name a few. The idea for these commands comes from a
- program called "Text," (by James Gillogly) a text formatting
- program for PC's. "Text" is a look-alike program for "Roff" a
- text formatter that could be found on mainframe Computers.
-
- Another type of commands prominently used by Turbo Braille
- for formatting braille is the imbedded or backslash command, a
- two-character command made up of a backslash followed by a
- character such as 0, 1, 2, :, etc.
-
- When the data entry person has produced a WordStar,
- WordPerfect or text file, Turbo Braille should be run to create a
- ".BIF" (Braille Intermediate File)." This file will contain some
- of the dot commands and imbedded commands. It will be easy to add
- more by just entering the file and editing it. It will look
- unusual, for there are to be no added blank spaces. The dot
- commands will always begin in Column one of the line, as will all
- of the text. Your finished copy's placement will be determined by
- what commands you use.
-
- Centering, Blank Lines, and Paragraphs
-
- CENTERING. (.ce) You are writing a document which has a
- title at the top of the page. You will, of course, want this
- title centered. Here is how it is done.
-
- Open the file. We'll call this file "Rules." To enter a
- ".BIF" file, you may use any ASCII Editor, such as Edlin, or the
- Nondocument Mode of WordStar. You will then enter the "insert
- mode" of that editor and type:
-
- .ce
- RULES FOR THE USE OF TURBO BRAILLE
-
- Remember, the command and the title will both begin in
- Column 1 of the screen. When you have processed the file, the
- ".ce" will have disappeared, and you will see the following:
-
- RULES FOR THE USE OF TURBO BRAILLE
-
- If the title is too long to be centered nicely on the
- braille page, the program will divide it into two or more equal
- parts.
-
- Suppose I want more than one line centered? This is no
- problem. Simply enter a space following the command, then follow
- the space with a digit which indicates the number of lines to be
- centered. (This principle is used with some of the other commands
- you will see later.) It will be done like this:
-
-
-
-
-
-
-
- .ce 3
- RULES FOR THE USE OF TURBO BRAILle
- Produced by KANSYS, Inc.
-
- When processed, the material will be centered. If you don't
- know how many lines you will be centering, you will place a large
- number after the command--one so large that there is no way you
- could possibly be centering that many lines. Upon completion of
- the entry, the centering is terminated by typing the ".ce"
- Command followed by a 0.
-
- .ce 99
- RULES FOR THE USE OF TURBO BRAILLE
- Produced by KANSYS, Inc.
- Your Sound Alternative
- ...
- .ce 0
-
- When the braille output has been produced, all of the lines
- requiring centering will be centered, and those too long to have
- balanced centering as they are will be split.
-
- THE LINE SPACE (.SP). While entering data to be processed,
- it is often necessary to leave one or more blank lines between
- parts of the text, such as between the title and the body
- The command used for this purpose is ".sp." Remember, when the
- data is entered and shown on the screen, it should all appear,
- along with the commands, in column 1. In our file "Rules" we have
- now entered the title:
-
- RULES FOR THE USE OF TURBO BRAILLE
- PRODUCED BY KANSYS, Inc.
-
- Next we want to leave a blank line between the title and the
- first paragraph.
-
- .sp
- Turbo Braille is a powerful braille translator ... .
-
- The document will have the title centered, a blank line, and
- the beginning of the paragraph.
-
- .ce 99
- RULES FOR THE USE OF TURBO BRAILLE
- Produced by
- KANSYS, Inc.
- .ce 0
- .sp
- Turbo Braille is a powerful braille translator ... .
-
- If there is to be more than one blank line between parts of
- the document, follow the command with a digit:
-
- .sp 2
-
-
-
-
-
-
-
- INDENTING THE PARAGRAPH (.PP). So far we have centered the
- title and skipped a blank line between the title of the document
- and its body. However, we want the paragraph in the braille
- output file to begin in Column three. This is done by use of the
- command ".pp." When Turbo Braille is reading a file and sees
- ".pp", it automatically writes the line of text immediately
- following the command with its FIRST CHARACTER in Column Three.
-
- .pp
- Turbo Braille is a powerful braille translator ... .
-
- After the ".pp" command, output would look like this.
-
- Turbo Braille is a powerful braille translator ... .
-
- MAKING AN UNFILLED LINE (.nf) or (.br). At times when
- working on a document, a data entry person doesn't want to fill
- lines. In letters, for instance, the street address, city and
- state, and date appear on separate lines; as do the lines of the
- inside address. In some word processors, such as WordStar, the
- solution to this problem is simply to enter a "hard" carriage
- return "<." However, this method does not work in Turbo Braille.
- This is true partially because there are fewer columns in the
- braille file. Therefore, there must be another method of dealing
- with the problem. This problem can be solved by one of two dot
- commands ".br" and ".nf."
-
- The ".br" is entered before each line of text that you
- desire to stand alone. Therefore, it would look something like
- this:
-
- .br
- 1016 Ohio
- .br
- Lawrence, KS 66044
- .br
- August 10, 1989.
-
- The final copy would take out the ".br"'s in print but show
- the document correctly. This command is used when one wishes to
- respect line breaks in a short passage. If, however, there is a
- lot of material which requires that the lines not be filled, a
- ".nf" should be entered on the line before the text. Turbo
- Braille will place on the lines only as much material as is
- entered in that line of text. This will, of course, often spill
- over into more than one braille line. The ".br" and ".nf"
- commands have the affect of executing all carriage returns in the
- source document. They are used for short and long passages
- respectively. Normally, Turbo Braille ignores carriage returns
- and puts as much braille as will fit on each line. The exception
- to this rule is two carriage returns, which it turns into one .sp
- command.
-
- THE FILLING COMMAND (.FI) You must be wondering: If I use
- the .nf command and I then want to start filling lines again,
-
-
-
-
-
-
- what do I do? There is a command to achieve this function called
- the ".fi" command. It is placed on a line by itself immediately
- before the text with which the line filling will begin.
-
- Dot Commands for Margins
-
- We have seen how dot commands make it possible to center
- lines, skip blank lines, indent for paragraphs, cease the filling
- of lines, and resume the filling of lines. We will now consider
- the dot commands used to provide varied right margins, varied
- left margins, hanging indents, and regular indents.
-
- THE RIGHT MARGIN (.RM). Most of the braille printers that
- are available have a maximum line width of 40 columns on 11.5
- inch paper. Forty Columns, therefore, is the default for Turbo
- Braille. However, the time may come when you will need a narrower
- line, such as when 8.5 by 11 inch paper is being used. This is
- easily accomplished with the right margin command ".rm." The
- command is entered beginning in column 1 and is the only item
- typed on the line. It is followed by the number of the last
- column to be found on the longest possible line. It will appear
- like this:
-
- .rm 28
-
- remember, always start the dot commands in column 1 of the
- line on which they are found.
-
- THE LEFT MARGIN COMMANDS (.PO) (.IN). Perhaps a wider left
- margin is required. Although the Library of Congress is now
- allowing a 40 space line for transcribed materials, YOU MAY FIND
- binding more easily accomplished if two spaces are left at the
- beginning of the lines, producing a wider left margin. This is
- done with the ".in" command. This command, like the others is
- typed on a line by itself, and it will be followed by a digit.
- The command would appear as follows:
-
- .in 2
-
- Making a wider left margin can also be accomplished by
- adjusting the paper a little in the printer, or by using the page
- offset command ".po" followed by a digit.
-
- .po 2
-
- TEMPORARY INDENT (.TI) From time to time in the preparation
- of a document, it becomes necessary to temporarily change a
- margin for one line. Such instances occur in the formatting of
- documents such as outlines, in which the first braille line of
- each subdivision must be indented two spaces. Doing this is easy
- with the ".ti" command. In column 1 of a new line enter ".ti"
- followed by a space and either a digit to indicate how many
- spaces to indent, or the plus sign "+" and a digit to say the
- left margin plus a certain number of spaces.
-
-
-
-
-
-
-
- I. Planning my trip
- .ti +2
- A. Making Reservations
- .ti +4
- 1. Choose a travel agent
- .ti +4
- 2. Determining the best time for me
- .ti +4
- 3. Determining best rates
- .ti +4
- 4. Flight availability
- .ti +2
- B. Hotel Reservations
- II Making arrangements ...
-
- The ".ti" command can also be used in documents in which
- material is set in several spaces but the first line of each
- segment of data is found to the left of the rest of the material.
- Using the ".in" command, the data entry person will enter the
- number of spaces the material is to be set in, then with the
- ".ti" command will set the line back the same number of spaces by
- typing .ti 0.
-
- .in 3
- .ti 0
- Truck Driver's Delight--a half pound of ground round on a
- toasted sesame seed bun with mounds of fries and
- plenty of delectable garnishes on the side. $3.95.
-
- The command can also be formed in this way:
-
- .in +3
- .ti -3
-
- Dot Commands for Page Variations
-
- The standard length for a page of braille is twenty-five
- (25) lines, so Turbo Braille uses the twenty-five line page
- length as the default. However, from time to time it may be
- desirable to have a shorter page length or to force the end of a
- given page. Several dot commands are available to help in this
- kind of formatting. While discussing the manipulation of pages,
- we will also see how a dot command can be used to create a
- running head, as well as a command which will automatically
- insert print page numbers.
-
- CREATING A RUNNING HEAD (.RH). Often in preparing documents
- (print or braille) a running head must be provided so that each
- page will contain the document's title or something to identify
- it as part of the document. This is accomplished in Turbo Braille
- with the use of the dot command ".rh." The format for this
- command is slightly different from that which we have seen for
- the other dot commands in that it does not appear on a line by
- itself. While it is, like the others, found in column 1 of the
- line, it is followed by the material to be used as the running
-
-
-
-
-
-
- head.
-
- .rh RULES FOR TURBO BRAILLE
-
- If the running head is to appear on all pages of the
- document beginning with the first page, it should appear at the
- top of the data file before any other commands. If the running
- head is not to appear on the first page, it should be entered
- after the beginning material, so long as it is not entered so far
- into the file that it affects the running head's appearance on
- subsequent pages.
-
- THE INCLUSION OF PRINT PAGE NUMBERS (.PN). Often,
- particularly in the production of braille books, it is necessary
- to include not only braille page numbers, but also the
- corresponding print page numbers. This is done at the beginning
- of the file. Once the ".pn" command has been issued, the document
- will contain the first print page NUMBER, and on each page
- FOLLOWING it will contain the same page number preceded by an
- alpha letter "a" "b" "c" etc., until the print page advances one
- page. Should the print page change in the middle of a braille
- page, a row of dots 2 and 5 will appear with the new print page
- NUMBER at the end of it.
-
- If you wish to begin with a print page other than PAGE 1,
- you should follow the ".pn" command with the number of the print
- page.
-
- .pn
-
- .pn 30
-
- The program will then begin numbering the print pages with
- 30, or whatever number you have inserted.
-
- CHANGING THE PAGE LENGTH OF YOUR DOCUMENT (.PL) Although the
- ".pl" command is rarely used, a data entry person may find at
- some point the need to change the length of the pages of a
- document. This command would only be used if the entire document
- was to have a number of lines in EACH PAGE OTHER THAN 25. Though
- it can be placed anywhere in the file, the best place logically
- is to place it before any other data or commands in the file. If
- this is not done, it could easily be forgotten until so far into
- the file that the first page or two would have one page length
- and the rest would have the new length. The command is found
- beginning in column 1 of a line and followed by one or two digits
- to indicate the number of lines desired on each page.
-
- .pl 20
-
- .pl 9
-
- PREMATURELY FORCING THE END OF A PAGE (.NE) OR (.BP) Braille
- rules require that a new centered title be placed on a new page
- if it cannot be preceded by a blank line and followed by a blank
-
-
-
-
-
-
- line and two lines of text. If this rule is being used in the
- processing of your braille document, it will not be possible for
- you to determine on the computer either by looking at the screen
- or using speech if the final copy will turn out that way. This is
- when the ".ne" command will come in handy. If you want to
- guarantee that you will never have the title of an article on the
- final line of your braille page, enter the ".sp" command, then
- enter the ".ne" command followed by a digit which includes the
- number of lines to be found in the title, the next blank line,
- and two lines of the paragraph following the title.
-
- .sp
- .ne 4
- .ce
- Dot Commands for Margins
- .sp
- .pp
- We have seen how dot commands make it possible to center
- lines, skip blank lines, indent for paragraphs, ...
-
- If it is desirable to terminate a page early, such as for a
- new topic, a new section, etc., enter the ".bp" command. This
- will cause the paper to advance to a new page. It, like most of
- the other commands we have discussed, will be on a line alone
- beginning in column 1.
-
- MORE DOT COMMANDS
-
- By consulting the Help facility of Turbo Braille, you will
- see that there are many other dot commands, designed to
- accomplish a variety of formatting tasks. The Help facility is
- accessed with the Slash H "/H" command or switch.
-
- This section of the documentation is designed to give you an
- introduction to dot commands. We will be adding to it in the
- upcoming months, as Turbo Braille grows and matures.
-
- You can also learn more about dot commands by examining a
- "BIF" file produced by Turbo Braille. After all, as you will
- remember from Section One of this document, BIF files are nothing
- more than ASCII text interspersed with dot commands.
-
- If you have any questions, give us a call at: (913) 843-0351
- or drop us a line at:
-
- KANSYS, Inc.
- 1016 Ohio Street
- Lawrence, KS 66044
-
-
-
-