Language Editor - (Shift-F5)

ProBoard allows you to change the text and the color for every prompt in the system to create a custom “look and feel” for your BBS. ProBoard also allows you to display your system prompts to users in several different languages.

Language files end with the file extension “.PBL” and are stored in your ProBoard system directory (usually C:\PB). You can create and install up to 30 different language files at any one time.

To create a different language file, first you must select one to work with as a model. You then copy the model to a language file with a new name. Refer to the following example:

COPY ENGLISH.PBL STARTREK.PBL

This would create a new language file called “STARTREK.PBL” from the “ENGLISH.PBL” file (supplied with ProBoard). All of the system prompts in “STARTREK.PBL” would at this point be exactly the same as the ones in ENGLISH.PBL.

You should then start up PROCFG.EXE and select “Language Editor” (Shift+F5). A window will be displayed showing the currently installed languages. Position the highlight on STARTREK (notice that the name in the right column still says “English”) and press <ENTER> to begin working with it.

You will now see a full screen window with all of the prompts for your new STARTREK language file. Note on the top line the following options:

Alt-D

Restores the default prompt for the system prompt you are currently positioned on. So if you change the “Please enter your first and last name” prompt to read “Enter your name”, and then decide you liked the default prompt better, press Alt-D while positioned on the “Enter your name” prompt and the default prompt will be restored. The default prompt is always displayed on the bottom line of the Language Editor.

Alt-P

Opens the “Language Properties” dialog. This is where you define the properties for this language file. You'll notice the description for the STARTREK language file still says ENGLISH in the description. This needs to be changed to STARTREK so your users can select the new language, otherwise they will have two ENGLISH languages to choose from.

Alt-S

Opens the “Search” dialog. Enter a text string to search for in the language and ProBoard will move to the first prompt in the language file that matches. To repeat the search, in the prompts for the next occurrence of the text string you entered, press <Alt-N>. This allows you to easily search your entire language file for specified text, making changes to the prompts as the text is found.

A description of the fields in the “Language Properties” dialog is as follows:

Description

his is the name your users will see when choosing from language files they have access to.

Available

Whether this language is available to callers with the proper security level.

Level

The minimum security level required to select this language file.

Flags

The security flags needed in a users record to be able to select this language file.

Menu Path

The full path to your language specific menus. If specified ProBoard will look for language specific menus in this path when users select this language. If left blank, ProBoard will display the menus in the path specified in PROCFG, Options, Paths, Menus.

Text Path

The full path to your language specific text files. If specified ProBoard will display language specific versions of your A?? text files if you create them. RIP files need to be in one common directory (in other words, ProBoard does not support RIP language specific text files at this time. If left blank, ProBoard will display the textfiles in the path specified in PROCFG, Options, Paths, Textfiles.

Questionnaire Path

The full path to your language specific questionnaire files. If specified ProBoard will use language specific versions of your questionnaires if you create them. If left blank, ProBoard will look for questionnaire files (files with the .Q-A file extension) in the ProBoard System Directory.

Once you are positioned on a prompt that you want to change, press <ENTER> to invoke the “Edit Language String” dialog. Each language string can be up to eight lines long. The color for each string is fully configurable (just like in the menu editor). You can insert the following control codes in your language string.

@a<file>@

Shows <file>.ANS/ASC/AVT (depending on the user's terminal setting). You can put this code anywhere in the prompt. (Example: “@aP_ENTER@” displays P_ENTER.A??)

@p<file>@

Runs <file>.PEX when this prompt is displayed. Parameters are allowed (seperated by spaces). You can put this control code anywhere in the prompt.

(Example: "@pTEST 2@" will run TEST.PEX with the parameter 2)

^

Toggles the highlight color on/off. The actual highlight color can be changed by selecting the “Highlight” option in the Language String editor.

\\

Single Backspace.

\^

Generates a caret (the ^ character).

\<B><F>

Set background color to <B> and foreground color to <F>. The color has to be entered as one hex character (0-9,A-F).

*The colors are: 0 - Black 1 - Blue 2 - Green 3 - Cyan 4 - Red 5 - Magenta 6 - Yellow 7 - White (Grey) 8 - Bright Black 9 - Bright Blue A - Bright Green B - Bright Cyan C - Bright Red D - Bright Magenta E - Bright Yellow F - Bright White (Grey) For the background color, bright colors are not available. When you use 8-F for the background color, the color will have the blinking attribute. Other color codes you can use are: \HR → Bright red \LR → Dark red \HG → Bright green \LG → Dark green \HY → Bright yellow \LY → Dark yellow \HB → Bright blue \LB → Dark blue \HP → Bright purple \LP → Dark purple \HC → Bright cyan \LC → Dark cyan \HW → Bright white \LW → Dark white Some examples:**

\0F Bright white on black

\1B Bright cyan on blue
\8E Bright yellow (blinking)
\70 Reverse (black on grey)
\LC Dark cyan on black

A description of the fields in the Language String dialog is as follows:

String #1 - String #8 …… The actual text that will be displayed to

your users. Some prompts can be quite
simple to understand (refer to Prompt #7)
and some can seem quite difficult at first
(refer to Prompt #207) with many options
needing to be passed to the prompt, as well
as hotkey values. A careful study of the
default prompts, and how they display will
help you to gain a better idea of how they
work.

Hotkeys ………………… The hotkeys needed for the prompt. If you

study Prompt #207 you will see the hotkeys
defined are "SCRDILAE". If you look at the
text strings for this same prompt, you will
see why these hotkeys are needed. Be sure
to specify the correct number and order of
hotkeys for each prompt (if applicable).
Any prompt which does not use hotkeys will
have "n/a" displayed in the hotkey field
and you will not be able to enter anything
into the hotkey field.

Color ………………….. Allows you to define a color for the prompt

text displayed to your users. Press
<ENTER> to select the color you want to use
for your prompt text.

Highlight ………………. Allows you to define a color for the

highlight. Remember, highlight is toggled
on/off with the ^ character.

Prompt Color ……………. Allows you to select a color for the users

reply to this prompt. For example, if
your prompt reads "Enter your first AND
last name" and this color is set to cyan,
when a user types their name, what they
type will be displayed in cyan (or whatever
color you select here).

The Language Editor will allow you to see what your prompts will look like when a user sees them without showing you the control codes. Move the highlight thru the language editor until you are close to, but not on, Prompt #191. You will notice it displays “(DUPLICATE- DELETED”) and the word “DELETED” is flashing. Now move the highlight selector to prompt #191 and press <ENTER>. You will now see the prompt with the control codes that make it flash, etc.