Files
Mozilla/l10nkits/client/windows/docs/nav40/localizeConfigPref.html
relliott 767fcda0dd First release of universal localization program kits
git-svn-id: svn://10.0.0.236/trunk@206 18797224-902f-48f8-a5cc-f745e15eee43
1998-04-13 23:32:42 +00:00

109 lines
3.7 KiB
HTML

<HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<META NAME="Author" CONTENT="Rick Elliott">
<META NAME="GENERATOR" CONTENT="Mozilla/4.04 [en] (Win95; I) [Netscape]">
<TITLE>Localizing CONFIG_PREFS</TITLE>
</HEAD>
<BODY TEXT="#000000" BGCOLOR="#FFFFFF" LINK="#0000EE" VLINK="#551A8B" ALINK="#FF0000">
<H4>
<A NAME="locnote_configprefs"></A>Localization Notes for CONFIG_PREFS</H4>
These entries make up the configurable Guide Toolbar and Help menu items
and their functions. As part of the Unlimited Localization Program, you
may define your own set of Guide Toolbar and Help Menu items.&nbsp; You
MUST remove or replace with your own links the following Help Menu items:
<UL>
<LI>
Release Notes</LI>
<LI>
Product Information and Support</LI>
<LI>
Software Updates</LI>
<LI>
Register Now</LI>
<LI>
Member Services</LI>
</UL>
CONFIG_PREF items are identified in the localization notes as "CONFIG_PREFSRCDATA"
followed by the Javascript function name.&nbsp; For example,
<UL><TT>CONFIG_PREFSRCDATAtoolbar.places.default_url</TT></UL>
Most items in this list of preferences consist of two related components:
a label and a URL.&nbsp; To localize a label, only edit the portion of
the preference that are within the second set of quotes.&nbsp; For example,
<UL>
<LI>
config("toolbar.places.item_0.label","<FONT COLOR="#FF00FF">The Internet</FONT>");</LI>
</UL>
The words, "The Internet" are contained in the second set of quotes; that
is the part you localize.&nbsp; Because these are button labels, you should
try to keep them as short as possible.&nbsp; If you find that you must
use a long word or phrase in your translation, you may discover that the
buttons no longer display the entire text.&nbsp; You can increase the maximum
number of characters the Toolbar buttons will display by increasing the
value of the <TT>browser.personal_toolbar_button.max_chars </TT>preference.
<P>You can use the "-" character in a label to create a separator.
<P>You can specify a sub-folder in the Guide Toolbar by specifying the
URL to be the word "FOLDER".&nbsp; For example:
<UL>
<LI>
config("personal_toolbar.item_1.url","<FONT COLOR="#FF0000">FOLDER</FONT>");</LI>
</UL>
This lets the code that lays out the toolbar know that the current item
is a folder with sub-folders.&nbsp; <FONT COLOR="#FF0000">DO NOT </FONT>localize
the word "FOLDER".
<H4>
Forbidden CONFIG_PREFS Resources</H4>
There are some URLs in CONFIG_PREFS which must not be changed in any way.&nbsp;
The first kind is the about: page URLs:
<UL>
<LI>
config("menu.help.item_12.url","about:plugins");</LI>
<LI>
config("menu.help.item_13.url","about:fonts");</LI>
</UL>
You may translate the associated labels but not these URLs. (You can, of
course, delete them entirely, but then you won't have access to these "about"
pages via the menus.)&nbsp; Refer to the <A HREF="#localizeURLs">Localizing
URLs</A> section for more information.
<BR>Finally, some items in CONFIG_PREFS are non-localizable Javascript
preference values.&nbsp; For example,
<UL>
<LI>
config("toolbar.logo.frames",<FONT COLOR="#FF0000">-1</FONT>);</LI>
<LI>
config("personal_toolbar.CreateNewToolbar", <FONT COLOR="#FF0000">false</FONT>);</LI>
<LI>
config("personal_toolbar.NewToolbarFolderName", <FONT COLOR="#FF0000">""</FONT>);</LI>
</UL>
Don't alter these.
<BR>&nbsp;
<CENTER><TABLE COLS=2 WIDTH="50%" >
<TR>
<TD>
<CENTER>[<A HREF="usingKit.html#locnote_configprefs">BACK</A>]</CENTER>
</TD>
<TD>
<CENTER>[<A HREF="toc.html">CONTENTS</A>]</CENTER>
</TD>
</TR>
</TABLE></CENTER>
<CENTER>&nbsp;<BR>
<FONT FACE="Arial, Helvetica"><FONT SIZE=-2>1998, Copyright Netscape Communications
Corp. All Rights Reserved</FONT></FONT></CENTER>
&nbsp;
<BR>&nbsp;
</BODY>
</HTML>