gecko-dev/cck/CCKDocs/browser_cck.htm
leaf%mozilla.org 2832eb9405 adding doc templates, some images, whacking NPL license to MPL. Will
update with tri-license addition at a later date.
2003-07-31 19:54:39 +00:00

1006 lines
41 KiB
HTML

<html>
<!--This html file is XHTML complaint, as set forth in the
w3c recommendations except for the following:
Lists work as they do in older versions on HTML and not as
directed in XHTML.
The <a name=" "> tags have targets that use spaces. -->
<head>
<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
<title> Guide to Customizing and Distributing Mozilla 1.4.1: Chapter&#32;5Preparing to Customize the Mozilla Browser</title>
<!--The following is a javascript which determines whether the client
is on a Windows machine, or is on another type of operating system. Once
the operating system is determined, either a windows or other operating
system cascading style sheet is used. -->
<script type="text/JavaScript">
<!-- Start hiding
window.onerror=null;
var client=navigator.userAgent.toLowerCase();
var WinStyle = "<STYLE NAME=WINDOWS>\n" +
"body,p {font-family: helvetica,arial,sans-serif; font-size:10pt; margin-bottom: 10; margin-top: 0; } \n" +
"th,tr,td,br,li,dl,dd,ul,ol,li {font-family: helvetica,arial,sans-serif; font-size:10pt; } \n" +
".bartext {font-family: helvetica,arial,sans-serif; font-weight: bold; color: #666666; margin-bottom: 0; margin-top: 0; font-size:14pt;} \n" +
".callout {font-family: helvetica,arial,sans-serif; font-size: 8pt;} \n" +
".calloutlarge {font-family: helvetica,arial,sans-serif; font-size: 9pt;} \n" +
".calloutlargebold {font-family: helvetica,arial,sans-serif; font-size: 9pt; font-weight: bold;} \n" +
".calloutsmall {font-family: helvetica,arial,sans-serif; font-size: 7pt; font-weight: normal;} \n" +
".caption {font-family: helvetica,arial,sans-serif; font-weight: bold; color: black; margin-bottom: 5; margin-top: 0; font-size: 11pt;} \n" +
".caution {font-family: helvetica,arial,sans-serif; font-size:10pt; font-weight: bold; margin-bottom: 0; margin-top: 0; } \n" +
"code {font-family: courier,couriernew,monospaced; font-size: 10pt; margin-bottom: 0; margin-bottom:0; margin-top: 0;} \n" +
".copy {align: center; font-family: helvetica,arial,sans-serif; font-size:8pt; margin-bottom: 0; margin-top: 0;} \n" +
".footnote {font-family: helvetica,arial,sans-serif; font-size:10pt; } \n" +
".gloss {font-family: helvetica,arial,sans-serif; font-size:10pt; margin-bottom: 10; margin-top: 0; } \n" +
".grouptitleix {font-family: helvetica,arial,sans-serif; font-weight: bold; color: black; margin-bottom: 10; margin-top: 20pt; font-size: 14pt;} \n" +
".h1 {font-family: helvetica,arial,sans-serif; font-weight: normal; color: black; margin-bottom: 0; margin-top: 30pt; font-size: 18pt;} \n" +
".h2 {font-family: helvetica,arial,sans-serif; font-weight: normal; color: black; margin-bottom: 10; margin-top: 30pt; font-size: 16pt;} \n" +
".h3 {font-family: helvetica,arial,sans-serif; font-weight: bold; color: black; margin-bottom: 10; margin-top: 20pt; font-size: 14pt;} \n" +
".h4 {font-family: helvetica,arial,sans-serif; font-style: italic; font-color: black;margin-bottom: 0; margin-top: 16pt; font-size: 11pt;} \n" +
".h5 {font-family: helvetica,arial,sans-serif; font-weight: normal; color: black; margin-bottom: 0; margin-top: 0; font-size: 8pt;} \n" +
".navigation {font-family: helvetica,arial,sans-serif; font-weight: bold; color: #993300; margin-bottom: 0; margin-top: 0; font-size:10pt;} \n" +
".note {font-family: helvetica,arial,sans-serif; font-size:10pt; font-weight: bold; margin-bottom: 0; margin-top: 0; } \n" +
".list1 {font-family: helvetica,arial,sans-serif; font-size:10pt; margin-bottom: 10; margin-top: 0; margin-left: 12pt; list-style-position: outside; } \n" +
".list2 {font-family: helvetica,arial,sans-serif; font-size:10pt; margin-bottom: 10; margin-top: 0; text-indent: 12pt; margin-left: 18pt; } \n" +
".list3 {font-family: helvetica,arial,sans-serif; font-size:10pt; margin-bottom: 10; margin-top: 0; text-indent: 18pt; margin-left: 24pt; } \n" +
".para1 {font-family: helvetica,arial,sans-serif; font-size:10pt; margin-bottom: 10; margin-top: 0; margin-left: 12pt; } \n" +
".para2 {font-family: helvetica,arial,sans-serif; font-size:10pt; margin-bottom: 10; margin-top: 0; margin-left: 18pt; } \n" +
".para3 {font-family: helvetica,arial,sans-serif; font-size:10pt; margin-bottom: 10; margin-top: 0; margin-left: 24pt; } \n" +
"pre {font-family: courier,couriernew,monospaced; font-size: 10pt; margin-bottom: 0; } \n" +
".refh1 {font-family: palatino,times,timesnewroman,serif; font-weight: normal; color: black;margin-bottom: 10; margin-top: 30pt; font-size: 18pt;} \n" +
".refh2 {font-family: palatino,times,timesnewroman,serif; font-weight: normal; color: black; margin-bottom: 10; margin-top: 30pt; font-size: 16pt;} \n" +
".refhead {font-family: helvetica,arial,sans-serif; font-weight: bold; color: black; margin-bottom: 4; margin-top: 15pt; font-size: 11pt;} \n" +
".tabletext {font-family: helvetica,arial,sans-serif; font-size:10pt; margin-bottom: 10; margin-top: 0; } \n" +
".tablehead {text-align: left;font-family: helvetica,arial,sans-serif; font-weight: bold; font-size:10pt; margin-bottom: 4; margin-top: 0; } \n" +
".text {font-family: helvetica,arial,sans-serif; font-size:10pt; margin-bottom: 10; margin-top: 0; } \n" +
".tip {font-family: helvetica,arial,sans-serif; font-size:10pt; font-weight: bold; margin-bottom: 0; margin-top: 0; } \n" +
".title {font-family: helvetica,arial,sans-serif; font-weight: bold; color: black;margin-bottom: 30pt; margin-top: 16pt; font-size: 16pt;} \n" +
".toc1 {font-family: helvetica,arial,sans-serif; font-size: 11pt; font-weight: bold; margin-bottom: 0; margin-top: 30; text-indent: 20;} \n" +
".tocc {font-family: helvetica,arial,sans-serif; font-size: 11pt; font-weight: bold; margin-bottom: 0; margin-top: 7; text-indent: 20;} \n" +
".tochead1 {font-family: helvetica,arial,sans-serif; font-size: 10pt; font-weight: normal; margin-bottom: 0; margin-top: 2; text-indent: 20;} \n" +
".tochead2 {font-family: helvetica,arial,sans-serif; font-size: 10pt; font-weight: normal; margin-bottom: 0; margin-top: 2; text-indent: 40;} \n" +
".tochead3 {font-family: helvetica,arial,sans-serif; font-size: 10pt; font-weight: normal; margin-bottom: 0; margin-top: 2; text-indent: 60;} \n" +
".tocnontoc {font-family: helvetica,arial,sans-serif; font-size: 10pt; font-weight: normal; text-indent: 0;} \n" +
".tocpart {font-family: helvetica,arial,sans-serif; font-size:13pt; font-weight: bold; margin-bottom: 0; margin-top: 20;} \n" +
".update {text-align: right; font-family: helvetica,arial,sans-serif; font-size:8pt; margin-bottom: 0; margin-top: 0;} \n" +
"</style>";
var OtherStyle = "<style name=NOTWINDOWS>\n" +
"body,p {font-family: helvetica,arial,sans-serif; font-size:12pt; margin-bottom: 10; margin-top: 0; } \n" +
"th,tr,td,br,li,dl,dd,ul,ol,li {font-family: helvetica,arial,sans-serif; font-size:12pt; } \n" +
".bartext {font-family: helvetica,arial,sans-serif; font-weight: bold; color: #666666; margin-bottom: 0; margin-top: 0; font-size:17pt;} \n" +
".callout {font-family: helvetica,arial,sans-serif; font-size: 10pt;} \n" +
".calloutlarge {font-family: helvetica,arial,sans-serif; font-size: 11pt;} \n" +
".calloutlargebold {font-family: helvetica,arial,sans-serif; font-size: 11pt; font-weight: bold;} \n" +
".calloutsmall {font-family: helvetica,arial,sans-serif; font-size: 8pt; font-weight: normal;} \n" +
".caption {font-family: helvetica,arial,sans-serif; font-weight: bold; color: black; margin-bottom: 5; margin-top: 0; font-size: 13pt;} \n" +
".caution {font-family: helvetica,arial,sans-serif; font-size:12pt; font-weight: bold; margin-bottom: 0; margin-top: 0; } \n" +
"code {font-family: courier,couriernew,monospaced; font-size: 12pt; margin-bottom: 0; margin-bottom:0; margin-top: 0;} \n" +
".copy {align: center; font-family: helvetica,arial,sans-serif; font-size:10pt; margin-bottom: 0; margin-top: 0;} \n" +
".footnote {font-family: helvetica,arial,sans-serif; font-size:12pt; } \n" +
".gloss {font-family: helvetica,arial,sans-serif; font-size:12pt; margin-bottom: 10; margin-top: 0; } \n" +
".grouptitleix {font-family: helvetica,arial,sans-serif; font-weight: bold; color: black; margin-bottom: 10; margin-top: 20pt; font-size: 17pt;} \n" +
".h1 {font-family: helvetica,arial,sans-serif; font-weight: normal; color: black; margin-bottom: 0; margin-top: 30pt; font-size: 22pt;} \n" +
".h2 {font-family: helvetica,arial,sans-serif; font-weight: normal; color: black; margin-bottom: 10; margin-top: 30pt; font-size: 19pt;} \n" +
".h3 {font-family: helvetica,arial,sans-serif; font-weight: bold; color: black; margin-bottom: 10; margin-top: 20pt; font-size: 17pt;} \n" +
".h4 {font-family: helvetica,arial,sans-serif; font-style: italic; font-color: black;margin-bottom: 0; margin-top: 16pt; font-size: 14pt;} \n" +
".h5 {font-family: helvetica,arial,sans-serif; font-weight: normal; color: black; margin-bottom: 0; margin-top: 0; font-size: 10pt;} \n" +
".navigation {font-family: helvetica,arial,sans-serif; font-weight: bold; color: #993300; margin-bottom: 0; margin-top: 0; font-size:12pt;} \n" +
".note {font-family: helvetica,arial,sans-serif; font-size:12pt; font-weight: bold; margin-bottom: 0; margin-top: 0; } \n" +
".list1 {font-family: helvetica,arial,sans-serif; font-size:12pt; margin-bottom: 10; margin-top: 0; margin-left: 12pt; list-style-position: outside; } \n" +
".list2 {font-family: helvetica,arial,sans-serif; font-size:12pt; margin-bottom: 10; margin-top: 0; text-indent: 12pt; margin-left: 18pt; } \n" +
".list3 {font-family: helvetica,arial,sans-serif; font-size:12pt; margin-bottom: 10; margin-top: 0; text-indent: 18pt; margin-left: 24pt; } \n" +
".para1 {font-family: helvetica,arial,sans-serif; font-size:12pt; margin-bottom: 10; margin-top: 0; margin-left: 12pt; } \n" +
".para2 {font-family: helvetica,arial,sans-serif; font-size:12pt; margin-bottom: 10; margin-top: 0; margin-left: 18pt; } \n" +
".para3 {font-family: helvetica,arial,sans-serif; font-size:12pt; margin-bottom: 10; margin-top: 0; margin-left: 24pt; } \n" +
"pre {font-family: courier,couriernew,monospaced; font-size: 12pt; margin-bottom: 0; } \n" +
".refh1 {font-family: palatino,times,timesnewroman,serif; font-weight: normal; color: black;margin-bottom: 10; margin-top: 30pt; font-size: 22pt;} \n" +
".refh2 {font-family: palatino,times,timesnewroman,serif; font-weight: normal; color: black; margin-bottom: 10; margin-top: 30pt; font-size: 19pt;} \n" +
".refhead {font-family: helvetica,arial,sans-serif; font-weight: bold; color: black; margin-bottom: 4; margin-top: 15pt; font-size: 13pt;} \n" +
".tabletext {font-family: helvetica,arial,sans-serif; font-size:12pt; margin-bottom: 10; margin-top: 0; } \n" +
".tablehead {text-align: left;font-family: helvetica,arial,sans-serif; font-weight: bold; font-size:12pt; margin-bottom: 4; margin-top: 0; } \n" +
".text {font-family: helvetica,arial,sans-serif; font-size:12pt; margin-bottom: 10; margin-top: 0; } \n" +
".tip {font-family: helvetica,arial,sans-serif; font-size:12pt; font-weight: bold; margin-bottom: 0; margin-top: 0; } \n" +
".title {font-family: helvetica,arial,sans-serif; font-weight: bold; color: black;margin-bottom: 30pt; margin-top: 16pt; font-size: 19pt;} \n" +
".toc1 {font-family: helvetica,arial,sans-serif; font-size: 13pt; font-weight: bold; margin-bottom: 0; margin-top: 30; text-indent: 20;} \n" +
".tocc {font-family: helvetica,arial,sans-serif; font-size: 13pt; font-weight: bold; margin-bottom: 0; margin-top: 7; text-indent: 20;} \n" +
".tochead1 {font-family: helvetica,arial,sans-serif; font-size: 12pt; font-weight: normal; margin-bottom: 0; margin-top: 2; text-indent: 20;} \n" +
".tochead2 {font-family: helvetica,arial,sans-serif; font-size: 12pt; font-weight: normal; margin-bottom: 0; margin-top: 2; text-indent: 40;} \n" +
".tochead3 {font-family: helvetica,arial,sans-serif; font-size: 12pt; font-weight: normal; margin-bottom: 0; margin-top: 2; text-indent: 60;} \n" +
".tocnontoc {font-family: helvetica,arial,sans-serif; font-size: 12pt; font-weight: normal; text-indent: 0;} \n" +
".tocpart {font-family: helvetica,arial,sans-serif; font-size:15pt; font-weight: bold; margin-bottom: 0; margin-top: 20;} \n" +
".update {text-align: right; font-family: helvetica,arial,sans-serif; font-size:10pt; margin-bottom: 0; margin-top: 0;} \n" +
"</style>";
if ( client.indexOf("win") != -1 ){
document.write( WinStyle );
}else{
document.write( OtherStyle );
}
// End hiding -->
</script>
</head>
<body text="#000000" link="#666699" vlink="#666699" alink="#333366" bgcolor="#FFFFFF">
<!--maincontent defines everything between the body tags -->
<!--start maincontent-->
<!--navigationcontent defines the top row of links and the banner -->
<!--start navigationcontent-->
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>
<td><table border="0" cellspacing="0" cellpadding="0">
<tr>
<td valign="bottom" width="67">
<img src="netscape48.gif" height="48" width="48" border="0" alt="Netscape logo" />
</td>
<td valign="middle">
<span class="bartext"> <br />Guide to Customizing and Distributing Mozilla
1.4.1
</span>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td>
<hr size="4" noshade="noshade" />
<span class="navigation">
<a style="text-decoration: none" href="info_cck.htm">
Previous
</a>
</span>
&nbsp;&nbsp;&nbsp;&nbsp;
<span class="navigation">
<a style="text-decoration: none" href="guide.html">
Contents
</a>
</span>
&nbsp;&nbsp;&nbsp;&nbsp;
<span class="navigation">
<a style="text-decoration: none" href="mail_news_cck.htm">
Next
</a>
</span>
&nbsp;&nbsp;&nbsp;&nbsp;
</td>
</tr>
</table>
<!--end navigationcontent-->
<!--bookcontent defines the actual content of the file, sans headers and footers -->
<!--start bookcontent-->
<blockquote>
<br />
<p class="title">
<a name="13832"> </a>
<a name=""> </a>
<font color="#666666">
Chapter&#32;5
&nbsp;
</font>
<a name="13833"> </a>
<a name="Preparing to Customize the Mozilla Browser"> </a>
Preparing to Customize the Mozilla Browser
</p><p class="text">
<a name="14668"> </a>
The CCK tool presents three screens that allow you to customize different aspects of the Mozilla browser. This chapter describes the information and files you need to prepare for these three screens.
</p>
<p class="text">
<a name="14688"> </a>
This chapter contains these sections:
</p>
<p class="text">
<a name="14380"> </a>
<a href="browser_cck.htm#14288" >Creating a Custom Animated Logo</a><br /><a href="browser_cck.htm#14231" >Determining a Help URL and Menu Item</a><br /><a href="browser_cck.htm#14427" >Determining the Name of the Program Folder in the Windows Start Menu</a><br /><a href="browser_cck.htm#14438" >Preparing a Customized Read-me File</a><br /><a href="browser_cck.htm#14439" >Creating Your Own Sidebar Tab</a><br /><a href="browser_cck.htm#14523" >Specifying the Default Home Page</a><br /><a href="browser_cck.htm#14404" >Preparing Your Customized Bookmarks and Personal Toolbar</a><br /><a href="browser_cck.htm#14562" >Determining Text for the Browser Window's Title Bar</a><br /><a href="browser_cck.htm#14650" >Checklists for Customizing the Browser</a>
</p>
<p class="h1">
<a name="14288"> </a>
<a name="Creating a Custom Animated Logo"> </a>
Creating a Custom Animated Logo
<hr size="2" noshade="noshade" />
</p>
<p class="text">
<a name="14290"> </a>
You can replace the standard Mozilla animated logo that appears in the browser and mail windows with an animated logo for your own company, such as this one for MyISP:<br /><br><img src="gifs/button.gif">
<br><br />
</p>
<p class="text">
<a name="14296"> </a>
If you wish, you can also change the URL for the animated logo button to the URL for your home page, so that when users click the animated logo, they go to your home page instead of <code>www.mozilla.org</code>.
</p>
<p class="text">
<a name="14298"> </a>
The animated logo consists of a composite <code>.GIF</code> file that contains two or more individual <code>.GIF</code> images, or frames, laid end-to-end. When the individual frames in the composite <code>.GIF</code> file are displayed in rapid succession, one after the other, the logo graphic takes on the appearance of motion.
</p>
<p class="text">
<a name="14300"> </a>
Here is a series of separate <code>.GIF</code> files that can be used to construct an animated <code>.GIF</code> file:<br /><br><img src="gifs/myisp.gif">
<br><br />
</p>
<p class="text">
<a name="14306"> </a>
To create your own animated logo, you'll need these tools:
</p>
<ul>
<li>
A graphics editing program or 3D animation program to create the individual <code>.GIF</code> files, or frames.
<a name="14307"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li>
A <code>.GIF</code> file animation program that assembles individual .GIF files into one continuous animated <code>.GIF</code> file.
<a name="14309"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
</ul>
<p class="text">
<a name="14310"> </a>
You'll need to create the following:
</p>
<ul>
<li>
A static <code>.GIF</code> file (32 by 32 pixels) for the at-rest logo.
<a name="14311"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li>
An animated <code>.GIF</code> file (32 by 32 pixels) for the animated logo.
<a name="14313"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
</ul>
<p class="text">
<a name="14989"> </a>
The browser uses the static <code>.GIF</code> file whenever the animated logo is at rest (not animating). When both files are ready, put them in the <code>Workspace\AnimLogo </code>directory for your configuration.
</p>
<p class="text">
<a name="14958"> </a>
The sections that follow outline the steps involved in creating your static and animated <code>.GIF</code> files.
</p>
<p class="h2">
<a name="14316"> </a>
<a name="Step 1: Create the Animation Frames"> </a>
Step 1: Create the Animation Frames
</p>
<p class="text">
<a name="14318"> </a>
You'll need to create the following <code>.GIF</code> files (frames):
</p>
<ul>
<li>
Up to 40 (32 pixels by 32 pixels) <code>.GIF</code> files for assembling into the animated logo
<a name="14319"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li>
One GIF file (32 pixels by 32 pixels) that will be used as the "still" image when the animation is at rest
<a name="14321"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
</ul>
<p class="text">
<a name="14322"> </a>
Using a graphics editing program or a 3D animation program, create and save each individual animation frame as a separate <code>.GIF</code> file. Keep the animation as simple as possible by using the fewest number of frames that convey the motion you want to achieve.
</p>
<p class="text">
<a name="14324"> </a>
Follow these guidelines:
</p>
<ul>
<li>
Create no more than 40 frames (files) for the animated logo
<a name="14325"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li>
Save your files in <code>.GIF</code> format
<a name="14327"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li>
Use no more than 30 colors in each file; 16 colors are best.
<a name="14329"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
</ul>
<p class="h2">
<a name="14332"> </a>
<a name="Step 2: Assemble Your Frames Using a GIF Animation Program"> </a>
Step 2: Assemble Your Frames Using a GIF Animation Program
</p>
<p class="text">
<a name="14334"> </a>
Using your GIF file animation program:
</p>
<ol type="1">
<li value="1">
Assemble the animation frames in the order in which you want them to appear.
<a name="14335"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="2">
Set the duration that each frame will appear.
<a name="14337"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="3">
Set the animation to loop infinitely.
<a name="14339"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="4">
Preview the animation and make any changes until you're satisfied with the results.
<a name="14341"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="5">
Save the animation as a <code>.GIF</code> file.
<a name="14343"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="6">
Optimize the animation file. Most <code>.GIF</code> animation programs allow you to perform some optimization operations that will reduce the size of your animation file.
<a name="14345"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
</ol>
<p class="text">
<a name="14347"> </a>
<b>Note:</b> The animation will play more slowly on computers with slower processors.
</p>
<p class="h1">
<a name="14231"> </a>
<a name="Determining a Help URL and Menu Item"> </a>
Determining a Help URL and Menu Item
<hr size="2" noshade="noshade" />
</p>
<p class="text">
<a name="15039"> </a>
The CCK Tool allows you to add a Help menu item to the Help menu. The name you specify appears as a new menu item above the Release Notes menu item near the bottom of the browser's Help menu. For example: My ISP Customer Support.
</p>
<p class="text">
<a name="15040"> </a>
If you specify a new Help menu item, you must also specify a live URL for the page to which your menu item will take users and provide appropriate content for that page.
</p>
<p class="h1">
<a name="14427"> </a>
<a name="Determining the Name of the Program Folder in the Windows Start Menu"> </a>
Determining the Name of the Program Folder in the Windows Start Menu
<hr size="2" noshade="noshade" />
</p>
<p class="text">
<a name="14408"> </a>
To increase customer awareness of your company name and promote your company's identity to your customers, you can add your company name to the Mozilla 1.4.1 program folder name in the Windows Start menu.
</p>
<p class="text">
<a name="15086"> </a>
For example, if you specify MyIsp for use with the Start menu, the program folder name in the Start menu appears as "Mozilla by MyIsp" as shown here:<br /><br><img src="gifs/start.gif">
<br><br />
</p>
<p class="h1">
<a name="14438"> </a>
<a name="Preparing a Customized Read-me File"> </a>
Preparing a Customized Read-me File
<hr size="2" noshade="noshade" />
</p>
<p class="text">
<a name="14441"> </a>
Mozilla includes a standard read-me file, which you might want to customize if you want to provide additional information to your customers.
</p>
<p class="text">
<a name="14443"> </a>
Under the terms of the Browser Customization Guidelines, you can edit the existing read-me file or replace it with one of your own, but you must not rename it.
</p>
<p class="text">
<a name="14447"> </a>
To edit the read-me file:
</p>
<ol type="1">
<li value="1">
Locate the standard Mozilla Read Me (<code>readme.txt</code>) file:
<a name="14448"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<dl><dl><p>
<code>
<a name="14450"></a>
<em>installation_directory</em>\CCKTool\Configs\Default\Workspace
</code>
</p></dl></dl> <dl>
<dt> <a name="14452"> </a>
where <em>installation_directory</em> is the directory where you installed the CCK tool.
<br />&nbsp;</dt> </dl>
<li value="2">
Copy the <code>readme.txt</code> file to your own Workspace directory
<a name="14454"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<dl><dl><p>
<code>
<a name="14456"></a>
<em>installation_directory</em>\CCKTool\Configs\<em>my_config</em>\Workspace
</code>
</p></dl></dl> <dl>
<dt> <a name="14458"> </a>
where <em>my_config</em> is the name of the configuration you are customizing.
<br />&nbsp;</dt> </dl>
</ol>
<p class="text">
<a name="15144"> </a>
Using a standard text editor such as WordPad, edit <code>readme.txt</code> or replace its contents with your own information. When the file is ready, put it at the top level of the <code>Workspace</code> directory for your configuration (for easy access when you run the CCK tool).
</p>
<p class="h1">
<a name="14439"> </a>
<a name="Creating Your Own Sidebar Tab"> </a>
Creating Your Own Sidebar Tab
<hr size="2" noshade="noshade" />
</p>
<p class="text">
<a name="15934"> </a>
Sidebar tabs provide a place within the Mozilla 1.4.1 browser for users to keep connected to what is most important to them. Tabs are a great place for favorite information, such as stock quotes, local weather, news headlines, sports headlines, local events, or horoscopes. Users can choose from a wide variety of tabs in the Sidebar Directory.
</p>
<p class="text">
<a name="15937"> </a>
Mozilla 1.4.1 comes with several sidebar tabs already set up. However, you can customize the browser by adding, removing, and rearranging tabs for your users. By creating a sidebar tab, you give your content constant presence within the user's client software. This means that users always have access to your service or content even when they are on another web site or using email. Links in your tab can lead back to your web site, driving increased traffic; and you can reduce service calls by making technical information easily accessible through your sidebar tab.
</p>
<p class="text">
<a name="15941"> </a>
The sidebar can appear on the left side of browser and mail windows of Mozilla 1.4.1. Here's an example of a custom sidebar tab for MyISP:<br /><br><img src="gifs/sidebar.gif">
<br><br />
</p>
<p class="text">
<a name="16017"> </a>
To create a sidebar tab, see the instructions posted at
</p>
<dl><dl><p>
<code>
<a name="16178"></a>
<!-- XXX do we need www.mozilla.org equiv? -->
<a href="http://home.netscape.com/sidebar">http://home.netscape.com/sidebar</a>
</code>
</p></dl></dl><p class="text">
<a name="16177"> </a>
To add or rearrange the tabs that appear, see the following sections. After you have created your own sidebar tab and made other modifications to the sidebar tabs displayed, you should store the file <code>panels.rdf</code> in your <code>Workspace/Sidebar</code> directory for easy access when you run the CCK tool.
</p>
<p class="h2">
<a name="16024"> </a>
<a name="Adding Sidebar Tabs"> </a>
Adding Sidebar Tabs
</p>
<p class="text">
<a name="15181"> </a>
In addition to providing your own sidebar tab, you can select from a wide range of existing sidebar tabs to customize the default tabs available when your customers open a new Mozilla profile for the first time.
</p>
<p class="text">
<a name="16239"> </a>
For a continuously updated directory of available sidebar tabs, see
</p>
<dl><dl><p>
<code>
<a name="16242"></a>
<!-- XXX need one on mozilla.org, damnit -->
<a href="http://channel.netscape.com/sidebar/sbd/index.tmpl">http://channel.netscape.com/sidebar/sbd/index.tmpl</a>
</code>
</p></dl></dl><p class="text">
<a name="16232"> </a>
For additional information about developing sidebar tabs, see
</p>
<dl><dl><p>
<code>
<a name="16158"></a>
<a href="http://developer.netscape.com/evangelism/sidebar/">http://developer.netscape.com/evangelism/sidebar/</a>
</code>
</p></dl></dl><p class="text">
<a name="16228"> </a>
It possible to add a sidebar tab simply by clicking a link. You can also control which sidebar tabs appear from within the Sidebar frame itself:
</p>
<ol type="1">
<li value="1">
Start the Mozilla browser.
<a name="16229"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="2">
Click Tabs at the top of Sidebar, then choose Customize Sidebar.
<a name="14488"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="3">
Select one or more tabs from the list on the left. You can open and close folders by double-clicking their names.
<a name="14490"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="4">
Click Add.
<a name="14492"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="5">
Click OK to finish.
<a name="14496"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
</ol>
<p class="h2">
<a name="14507"> </a>
<a name="Rearranging Sidebar Tabs"> </a>
Rearranging Sidebar Tabs
</p>
<p class="text">
<a name="16208"> </a>
To change the position of one of the Sidebar tabs displayed by the browser, follow these steps:
</p>
<ol type="1">
<li value="1">
In the browser, click Tabs at the top of Sidebar, then choose Customize Sidebar.
<a name="16139"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="2">
Select a tab from the list on the right.
<a name="16140"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="3">
Click Up or Down to change the tab's placement.
<a name="16141"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="4">
Click OK to finish.
<a name="14516"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
</ol>
<p class="text">
<a name="14518"> </a>
</p>
<ul>
<li>
Change the Sidebar tab that is open by default when you open a new profile with Mozilla 1.4.1 (currently the News tab).
<a name="14520"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li>
Remove the Search or Today's Tips sidebar tabs from the Sidebar tabs shown by default when you open a new profile with Mozilla 1.4.1.
<a name="14521"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li>
Remove any of the Sidebar tabs from the list of tabs available to an end user in the default drop-down list of sidebar tabs available when you open a new profile with Mozilla 1.4.1. (It's OK to add additional tabs).
<a name="14522"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
</ul>
<p class="text">
<a name="14540"> </a>
All the changes you make to Sidebar are stored in the <code>panels.rdf </code>file, which is located in the directory for the Mozilla profile you were using when you made the changes. For information on the location of Mozilla profiles on different platforms, see <a href="profile_appx_cck.htm#11284" >Appendix&#32;C "Mozilla Profile Locations by Platform</a>."
</p>
<p class="text">
<a name="15298"> </a>
When you are finished making your changes, put <code>panels.rdf</code> in the <code>Workspace\Sidebar</code> directory for your configuration (for easy access when you run the CCK tool).
</p>
<p class="h1">
<a name="14523"> </a>
<a name="Specifying the Default Home Page"> </a>
Specifying the Default Home Page
<hr size="2" noshade="noshade" />
</p>
<p class="text">
<a name="15305"> </a>
If you wish to change the home page to a URL of your choice, you can do so by typing the URL in the CCK tool screen entitled "Customize the Browser - Part Three." The URL you specify determines both the first page launched and the page users will see when they click the Home button.
</p>
<p class="h1">
<a name="14404"> </a>
<a name="Preparing Your Customized Bookmarks and Personal Toolbar"> </a>
Preparing Your Customized Bookmarks and Personal Toolbar
<hr size="2" noshade="noshade" />
</p>
<p class="text">
<a name="14564"> </a>
You can create a complete set of customized bookmarks (URLs that direct users to web pages) for your users. You can also customize the buttons that appear in the Personal Toolbar. Bookmarks and Personal Toolbar buttons are stored together in the Bookmarks menu.
</p>
<p class="text">
<a name="14566"> </a>
You can use Personal Toolbar buttons to call attention to value-added services you provide and to make it easy for users to find information you want them to see:<br /><br><img src="gifs/bkmk.gif">
<br><br />
</p>
<p class="text">
<a name="14570"> </a>
<b>Note:</b> For new users who are installing Mozilla for the first time, your customized bookmarks remain visible even if the user subsequently upgrades to a later version. However, users who are upgrading from a previous version of Mozilla or Netscape Communicator to the version you are providing will not get your customized bookmarks because, for upgraders, Mozilla preserves their existing set of bookmarks. Therefore, for upgraders, you may want to create a Sidebar tab that includes some of the links you want to make available to customers. For details, see "<a href="browser_cck.htm#14439" >Creating Your Own Sidebar Tab</a>."
</p>
<p class="text">
<a name="14573"> </a>
To customize Navigator's bookmarks, you'll first create a new user profile that contains the default set of bookmarks that come with Mozilla. You'll then modify the default bookmarks list so that it includes your custom bookmarks.
</p>
<p class="h2">
<a name="14575"> </a>
<a name="Creating a New User Profile"> </a>
Creating a New User Profile
</p>
<p class="text">
<a name="14577"> </a>
To create a new user profile, follow these steps:
</p>
<ol type="1">
<li value="1">
Quit Mozilla if it is running.
<a name="14578"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="2">
Open the Start Menu, choose Programs, Mozilla 1.4.1, and then Profile Manager.
<a name="14580"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="3">
Click Create Profile to create a new user profile.
<a name="14582"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="4">
Enter a name for the profile, for example, "bookmarks", and click Next.
<a name="14584"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="5">
Follow the instructions to finish entering profile information.
<a name="14586"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="6">
When you click Finish, Mozilla starts using the new profile.
<a name="14588"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
</ol>
<p class="h2">
<a name="14591"> </a>
<a name="Creating Custom Bookmarks and Personal Toolbar Buttons"> </a>
Creating Custom Bookmarks and Personal Toolbar Buttons
</p>
<p class="text">
<a name="14593"> </a>
To create a set of custom bookmarks and Personal Toolbar buttons using your new profile:
</p>
<ol type="1">
<li value="1">
Choose Manage Bookmarks from the Bookmarks menu. A window similar to this appears:<br /><br><img src="gifs/bkmkswindow.gif">
<br><br />
<a name="14594"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<dl>
<dt> <a name="15418"> </a>
<br />&nbsp;</dt> </dl>
<li value="2">
Use the Bookmarks window to add, delete, import, and rearrange (drag) bookmarks to produce the set that you want.
<a name="14603"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="3">
To add an item to the Personal Toolbar, either drag and drop a bookmark onto the Personal Toolbar folder, or highlight the Personal Toolbar folder and use the File menu options to add a new bookmark. Bookmarks you create in the Personal Toolbar folder will appear as buttons on the user's Personal Toolbar.
<a name="14605"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="4">
To remove an item, highlight the associated bookmark in the Toolbar Folder and press Delete, or go to the Edit menu and select Delete.
<a name="14607"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li value="5">
Close the Bookmarks window when you are finished.
<a name="14608"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
</ol>
<p class="text">
<a name="15449"> </a>
You can also add a bookmark button to the Personal Toolbar for the page currently displayed in your browser by dragging the bookmark icon (located to the left of URL in the Navigation Toolbar) to a desired place on the Personal Toolbar:<br /><br><img src="gifs/quicklink.gif">
<br><br />
</p>
<p class="text">
<a name="14616"> </a>
The pointer changes from an arrow into a hand when it is pointing at the bookmark icon
</p>
<p class="text">
<a name="15768"> </a>
Mozilla 1.4.1 creates the customized <code>bookmarks.html</code> file in the directory for the profile you were using when you set up your customized bookmarks. For information on the location of Mozilla profiles on different platforms, see <a href="profile_appx_cck.htm#11284" >Appendix&#32;C "Mozilla Profile Locations by Platform</a>."
</p>
<p class="text">
<a name="15484"> </a>
When you are finished making your changes, put <code>bookmarks.html</code> in the <code>Workspace\Bkmks</code> directory for your configuration (for easy access when you run the CCK tool).
</p>
<p class="h1">
<a name="14562"> </a>
<a name="Determining Text for the Browser Window's Title Bar"> </a>
Determining Text for the Browser Window's Title Bar
<hr size="2" noshade="noshade" />
</p>
<p class="text">
<a name="14646"> </a>
You can add your company name to the browser window's title bar, so that your company name appears at the top of every browser window. For example, this illustrates the customized browser window's title bar for a company called MyIsp:
</p>
<p class="text">
<a name="14647"> </a>
<br><img src="gifs/coname.gif">
<br><br />
</p>
<p class="text">
<a name="14649"> </a>
If you decide you want to customize the browser in this way, you simply specify your company name when the CCK tool displays the screen entitled "Customize the Browser - Part Three."
</p>
<p class="h1">
<a name="14650"> </a>
<a name="Checklists for Customizing the Browser"> </a>
Checklists for Customizing the Browser
<hr size="2" noshade="noshade" />
</p>
<p class="h2">
<a name="14644"> </a>
<a name="Customize the Browser - Part One"> </a>
Customize the Browser - Part One
</p>
<p class="text">
<a name="14791"> </a>
The screen called Customize the Browser - Part One specifies the following:
</p>
<ul>
<li>
Animated logo:
<a name="14789"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<ul>
<li>
Logo button URL
<a name="14821"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li>
<li>
Path to animated GIF file (stored in <code>Workspace\AnimLogo</code>)
<a name="14822"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li>
<li>
Path to "at rest" GIF file (stored in <code>Workspace\AnimLogo</code>)<br />&nbsp;
<a name="14823"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li> </ul>
<li>
Help Menu Item:
<a name="14824"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<ul>
<li>
Menu item text
<a name="14825"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li>
<li>
Menu item URL<br />&nbsp;
<a name="14826"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li> </ul>
</ul>
<p class="h2">
<a name="14764"> </a>
<a name="Customize the Browser - Part Two"> </a>
Customize the Browser - Part Two
</p>
<p class="text">
<a name="14798"> </a>
The screen called Customize the Browser - Part Two specifies the following:
</p>
<ul>
<li>
Text added to "Mozilla by" in the name of the Mozilla program folder in the Windows Start menu
<a name="14817"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li>
Path to custom read-me file (stored at top level of <code>Workspace</code>)
<a name="14831"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li>
Path to custom Sidebar tabs (stored in <code>Workspace\Sidebar</code>)
<a name="14842"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
</ul>
<p class="h2">
<a name="14770"> </a>
<a name="Customize the Browser - Part Three"> </a>
Customize the Browser - Part Three
</p>
<p class="text">
<a name="14762"> </a>
The screen called Customize the Browser - Part Three specifies the following:
</p>
<ul>
<li>
Home page URL (first page launched and Home button)
<a name="14818"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li>
Path to bookmarks.html (stored in <code>Workspace\Bkmks</code>)
<a name="14859"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
<li>
Text that appears after the page title in the title bar
<a name="14871"> </a>
<img src="pixel.gif" align="top" height="22" alt="" />
</li><br>
</ul>
</blockquote>
<!--end bookcontent-->
<!--footercontent defines the bottom navigation and the copyright. It also includes
the revision date-->
<!--start footercontent-->
<blockquote>
<br />
<br />
<span class="navigation">
<a style="text-decoration: none" href="info_cck.htm">
Previous
</a>
</span>
&nbsp;&nbsp;&nbsp;&nbsp;
<span class="navigation">
<a style="text-decoration: none" href="guide.html">
Contents
</a>
</span>
&nbsp;&nbsp;&nbsp;&nbsp;
<span class="navigation">
<a style="text-decoration: none" href="mail_news_cck.htm">
Next
</a>
</span>
&nbsp;&nbsp;&nbsp;&nbsp;
<hr noshade="noshade" size="1" />
<p class="copy">Copyright &#169; 2003 Netscape Communications Corp. All rights reserved.</p>
<br />
<p class="update">Last Updated <b>July 30, 2003</b></p>
</blockquote>
<!--end footercontent-->
<!--end maincontent-->
</body>
</html>