suite/locales/en-US/chrome/common/help/composer_help.xhtml
 author rsx11m Fri, 11 May 2018 16:27:59 -0500 changeset 28219 b6dbcbdec1163a132c30ece7f118ac29e7b73d08 parent 19354 9653167e62738f3a18f4e9d10542f97b6ab13711 permissions -rw-r--r--
Bug 1268031 - Missing space in composer_help.xhtml; r=frg, a=IanN

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"[
<!ENTITY % brandDTD SYSTEM "chrome://branding/locale/brand.dtd" >
%brandDTD;
]>

<html xmlns="http://www.w3.org/1999/xhtml">
<title>Creating Web Pages with &brandShortName; Composer</title>
type="text/css"/>
<body>

<h1 id="creating_web_pages_with_mozilla_composer">Creating Web Pages with
&brandShortName; Composer</h1>

<p>&brandShortName; Composer lets you create your own web pages and publish
them on the web. You don&apos;t have to know HTML to use Composer; it is as
easy to use as a word processor.</p>

<p>Toolbar buttons let you add lists, tables, images, links to other pages,
colors, and font styles. You can see what your document will look like on
the Web as you create it, and you can easily share your document with
other users, no matter what type of browser or HTML-capable email program
they use.</p>

<p>To start using &brandShortName; Composer:</p>

<ul>
<li>Click the Composer icon in the lower-left corner of any
&brandShortName; window.</li>
</ul>

<div><img src="images/composer_icon.png" alt="" /></div>
<div style="margin-inline-start: 50px;"><strong>Composer icon</strong></div>

<div class="contentsBox">In this section:
<ul>
<li><a href="#starting_a_new_page">Starting a New Page</a></li>
Page</a></li>
Mathematical Formulas to Your Web Page</a></li>
<li><a href="#setting_page_properties">Setting Page Properties</a></li>
Composer</a></li>
the Web</a></li>
<li><a href="#composer_preferences">Composer Preferences</a></li>
</ul>
</div>

<h1 id="starting_a_new_page" style="margin-top: 50px;">Starting a New Page</h1>

<div class="contentsBox">In this section:
<ul>
<li><a href="#creating_a_new_page">Creating a New Page</a></li>
<li><a href="#saving_and_browsing_your_new_page">Saving and Browsing Your
New Page</a></li>
</ul>
</div>

<h2 id="creating_a_new_page">Creating a New Page</h2>

<p>&brandShortName; Composer is an HTML (Hypertext Markup Language) editor that
allows you to create and edit web pages. Composer is a <em>WYSIWYG</em> (What
You See Is What You Get) editor, so you can display how your page will look
to the reader as you&apos;re creating it. It is not necessary for you to know
HTML, since most of the basic HTML functions are available as commands from

<p>Composer also lets you edit the HTML source if you want. To view or edit the
HTML source code, open the View menu, and choose HTML Source, or click the
&lt;HTML&gt; Source tab in the Edit Mode toolbar at the bottom of the
Composer window.</p>

<p>To create a web page, use one of the methods described below. Once
you&apos;ve started a page, you can add and edit text just as you would
in a word processor.</p>

<p><strong>To create a new page from the browser</strong>:</p>

<ul>
<li>Open the File menu, choose New, and then Composer Page. A Composer
window containing a blank page opens.</li>
</ul>

<p><strong>To edit a page you&apos;re currently viewing in the
browser</strong>:</p>

<ul>
<li>In the browser window of the page you&apos;re viewing, open the File
menu and choose Edit Page. You see a Composer window that contains the
page you&apos;re viewing.</li>
</ul>

<p><strong>To create a new page in Composer</strong>:</p>

<ul>
<li>Click the New button in Composer&apos;s toolbar.</li>
</ul>

<p><strong>To start from an HTML file stored on your local drive</strong>:</p>

<ol>
<li>Open the Window menu and choose Composer. You see the Composer
window.</li>
<li>Open the File menu and choose Open File. You see the Open HTML File
dialog box.</li>
<li>On your local drive, locate the file that you want to edit.</li>
<li>Click Open to display the specified file in a Composer window.</li>
</ol>

<p><strong>To edit a web page</strong>:</p>

<ol>
<li>Open the Window menu and choose Browser.</li>
<li>Go to a web page: type the URL of the page (for example,
<tt>http://www.mozilla.org</tt>) in the Location Bar and press
<kbd class="mac">Return</kbd><kbd class="noMac">Enter</kbd>.</li>
<li>Open the File menu and choose Edit Page.</li>
</ol>

<p><strong>Tip</strong>: In the Composer window you can quickly open the most
recent file you&apos;ve been working on by opening the File menu, choosing
Recent Pages, and then selecting the file you want from the list.</p>

<h2 id="saving_and_browsing_your_new_page">Saving and Browsing Your New
Page</h2>

<p>You can save Composer documents in HTML or text-only format. Saving a
document in HTML format preserves the document&apos;s formatting, such
as text styles (for example, bold or italic), tables, links, and images.
Saving a document in text-only format removes all the HTML tags but
preserves the document&apos;s text.</p>

<p>To save a document as an HTML file:</p>

<ul>
<li>Open the File menu and choose Save or click the Save button on the
Composition toolbar.

you to do so. Composer displays the page title in the browser
window&apos;s title bar when you view the page in the browser. The
document&apos;s page title also appears in your list of bookmarks
if you bookmark the page.</p>

<p>Composer then prompts you to enter a filename and specify the location
where you want to save the file. Make sure you preserve the .html
extension in the filename.</p>
</li>
</ul>

<p>To change the filename or location of an existing HTML file:</p>

<ul>
<li>Choose Save As and select a different filename or location.</li>
</ul>

<p>When you save a page in Composer, all parts of the page (the HTML, images
and other files, such as sound files and style sheets), are saved locally
on your hard drive. If you only want to save the HTML part of the page, you
must change the Composer preference for saving pages. See
on changing Composer&apos;s setting for saving pages.</p>

<p>If an image location is absolute (starts with <q>http://</q>) and you are
connected to the Internet, you will still see that image in the document in
Composer and the browser. However, if the image location is relative to the
page location (starts with <q>file:///</q>), then you won&apos;t see the
image in the local version of the document.</p>

<p>To save a document as a text-only file:</p>

<ol>
<li>Open the File menu and choose Export to Text.</li>
<li>Enter the filename and specify the location where you want to save the
file.</li>
</ol>

<p><strong>Note</strong>: Images do not appear in documents saved in the
text-only format.</p>

<p><strong>Tip</strong>: You can choose Revert to Last Saved from the File
menu to retrieve the most recently saved copy of the document in which
you&apos;re working. Keep in mind that your current changes will be lost.</p>

<ul>
<li>Open the File menu and choose Browse Page (or click Browse in the
Composition toolbar). If you have not yet saved your document, Composer
prompts you to enter a page title, filename, and location. The Composer
window remains open behind the new browser window.</li>
</ul>

<div class="contentsBox">In this section:
<ul>
<li><a href="#working_with_lists">Working with Lists</a></li>
<li><a href="#changing_text_color_style_and_font">Changing Text Color,
Style, and Font</a></li>
<li><a href="#removing_or_discontinuing_text_styles">Removing or
Discontinuing Text Styles</a></li>
<li><a href="#finding_and_replacing_text">Finding and Replacing
Text</a></li>
<li><a href="#inserting_horizontal_lines">Inserting Horizontal
Lines</a></li>
<li><a href="#inserting_special_characters">Inserting Special
Characters</a></li>
<li><a href="#inserting_html_elements_and_attributes">Inserting HTML
Elements and Attributes</a></li>
<li><a href="#validating_the_html">Validating the HTML</a></li>
<li><a href="#choosing_the_right_editing_mode">Choosing the Right Editing
Mode</a></li>
</ul>
</div>

<p>To apply a format to a paragraph, begin from the Composer window:</p>

<ol>
<li>Click to place the insertion point where you want the format to begin,
or select the text you want to format.</li>
<li>Choose a paragraph format using the drop-down list in the Format toolbar:
<ul>
<li><strong>Body Text</strong>: Applies the application default font and
style for regular text, without affecting the spacing before or after
the text.</li>
<li><strong>Paragraph</strong>: Inserts a paragraph tag (use this to
begin a new paragraph). The paragraph includes top and bottom
margins.</li>
<li><strong>Address</strong>: Can be used for a web page <q>signature</q>
that indicates the author of the page and the person to contact for

<p>You might want to include the date and a copyright notice. This
format usually appears at the bottom of the web page under a
horizontal line. The browser displays the address format in
italics.</p>
</li>
<li><strong>Preformat</strong>: This is useful for elements such as code
examples, column data, and mail messages that you want displayed in a
fixed-width font. In normal text, most browsers remove extra spaces,
tabs, and paragraph returns. However, text that uses the Preformatted
style is displayed with the white space intact, preserving the layout
of the original text.</li>
</ul>
</li>
</ol>

<p>To format text as a heading:</p>

<ol>
<li>Click to place the insertion point anywhere within the text that you
want to format.</li>
<li>Using the drop-down list in the Format toolbar, choose the level of
heading you want, from 1 (largest) to 6 (smallest). Choose <q>Heading 1</q>
forth.</li>
</ol>

<p>To apply a list item format:</p>

<ol>
<li>Click to place the insertion point within the line of text that you want
to format.</li>
<li>Open the Format menu and choose List.</li>
<li>Choose the list style:
<ul>
<li><strong>Bulleted</strong>: Each item has a bullet (dot) next to it
(as in this list).</li>
<li><strong>Numbered</strong>: Items are numbered.</li>
<li><strong>Term</strong> and <strong>Definition</strong>: These two
styles work together, creating a glossary-style appearance. Use the
Term tag for the word being defined, and the Definition tag for the
definition. The Term text appears flush left, and the Definition
text appears indented.</li>
</ul>
</li>
</ol>

<p><strong>Tip</strong>: You can quickly apply a list style to a block of
text by selecting the text and clicking the Numbered List
<img src="images/numbers.gif" width="21" height="21" alt="" />
or Bulleted List
<img src="images/bullets.gif" width="20" height="20" alt="" />
buttons on the Format toolbar.</p>

<p>To change the style of bullets or numbers:</p>

<ol>
<li>Click to place the insertion point within the text of the list item you
want to change, or select one or more items in the list if you want to
apply a new style to the entire list.</li>
<li>Open the Format menu and choose List Properties.</li>
<li>Select a bullet or number style from the drop-down list. For numbered
lists, you can specify a starting number. For bulleted lists, you can
change the bullet style.</li>
</ol>

<p><strong>Tip</strong>: You can also double-click on a bullet or number in a
list to display the List Properties dialog box.</p>

<p>To align a paragraph or text in your page, for example, centering or
aligning to the left or right:</p>

<ol>
<li>Click to place the insertion point within the paragraph or line of text
you want to align.</li>
<li>Open the Format menu and choose Align; then choose an alignment
option.</li>
</ol>

<p><strong>Note</strong>: You can also use the Format toolbar to align
text.</p>

section</a>]</p>

<h2 id="working_with_lists">Working with Lists</h2>

<p>To end a list and continue typing body text:</p>

<ul>
<li>Click to place the insertion point at the end of the last list item and
press <kbd class="mac">Return</kbd><kbd class="noMac">Enter</kbd> twice to
end the list.</li>
</ul>

<p>To change one or more list items to body text:</p>

<ol>
<li>Click to place the insertion point within the list item, or select the
list items.</li>
<li>In a numbered list, click the numbered list button (or in a bulleted
list, click the bulleted list button) in the Format toolbar.</li>
</ol>

<p>To position indented text below a list item:</p>

<ol>
<li>Click to place the insertion point within the list item.</li>
<li>Press <kbd>Shift</kbd>+<kbd class="mac">Return</kbd><kbd
class="noMac">Enter</kbd> to create the hanging indent.</li>
<li>Type the text you want to indent.</li>
<li>Press <kbd>Shift</kbd>+<kbd class="mac">Return</kbd><kbd
class="noMac">Enter</kbd> to create another indented paragraph, or press
<kbd class="mac">Return</kbd><kbd class="noMac">Enter</kbd> to create the
next list item.</li>
</ol>

<p><strong>Tip</strong>: You can increase or decrease the indentation of list
items by clicking anywhere in a list item and then clicking the Indent or
Outdent button on the Format toolbar. Alternatively, click anywhere in a
list item and press <kbd>Tab</kbd> to indent one level. Press
<kbd>Shift</kbd>+<kbd>Tab</kbd> to outdent one level.</p>

<ol>
<li>Select the two lists that you want to merge. Be sure to select all of
the elements in both lists. Note that any text in between the two lists
will also become part of the merged list.</li>
<li>Click the bulleted or numbered list button in the Format toolbar to
merge the lists.</li>
</ol>

section</a>]</p>

<h2 id="changing_text_color_style_and_font">Changing Text Color, Style, and
Font</h2>

<p>To change the style, color, or font of selected text:</p>

<ol>
<li>Select the text you want to format.</li>
<li>Open the Format menu and choose one of the following:
<ul>
<li><strong>Font</strong>: Use this to choose a font. If you prefer to
use fonts specified by the reader&apos;s browser, select Variable
Width or Fixed Width.

<p><strong>Note</strong>: The fonts Helvetica, Arial, Times, and
Courier generally look the same when viewed on different computers.
If you select a different font, it may not look the same when viewed
using a different computer.</p>
</li>
<li><strong>Size</strong>: Use this to choose a <em>relative</em> font
size or select an option to increase or decrease text size (relative
to the surrounding text).</li>
<li><strong>Text Style</strong>: Use this to select a style, such as
italic, bold, or underline, or to apply a structured style, for
example, Code.</li>
<li><strong>Text Color</strong>: Use this to choose a color from the
color picker. If you are familiar with HTML hexadecimal color codes,
you can type a specific code or you can just type a color name (for
example, <q>blue</q>). You&apos;ll find the official W3C list of CSS
supported color names
<a href="http://www.w3.org/TR/CSS21/syndata.html#color-units">here</a>,
and another list of commonly supported color names
<a href="http://www.w3schools.com/html/html_colornames.asp">here</a>.
</li>
</ul>
</li>
</ol>

<p>To change the background color of the page:</p>

<ol>
<li>Click anywhere in the page.</li>
<li>Click the background color block in the Format toolbar.</li>
<li>Choose a background color from the Block Background Color dialog
box.</li>
<li>Click OK.</li>
</ol>

<p><strong>Tip</strong>: To quickly change the color of text to the color
last used, select the text, then press Shift and click on the text color
block in the Format toolbar. This is useful when you want to use one
color for separate lines of text.</p>

<p>You can also use an image as a background. See
<a href="#setting_page_colors_and_backgrounds">Setting Page Colors and
Backgrounds</a>.</p>

section</a>]</p>

<h2 id="removing_or_discontinuing_text_styles">Removing or Discontinuing Text
Styles</h2>

<p>To remove all text styles (bold, italic, and so on) from selected text:</p>

<ol>
<li>Select the text.</li>
<li>Open the Format menu and choose Remove All Text Styles.</li>
<li>Continue typing.</li>
</ol>

<p>To continue typing text with all text styles removed:</p>

<ol>
<li>Place the insertion point where you want to discontinue the text
styles.</li>
<li>Open the Format menu and choose Discontinue Text Styles.</li>
<li>Continue typing.</li>
</ol>

section</a>]</p>

<h2 id="finding_and_replacing_text">Finding and Replacing Text</h2>

<p>To find text in the page you&apos;re currently working on:</p>

<ol>
<li>Click to place the insertion point where you want to begin your
search.</li>
<li>Open the Edit menu and choose Find and Replace. You see the Find and
Replace dialog box.</li>
<li>Type the text you want to locate in the <q>Find what</q> field. To narrow
the search, check one or more of the following options:
<ul>
<li><strong>Match exact case</strong>: Use this to specify whether
the search is for case-sensitive text.</li>
<li><strong>Wrap around</strong>: Use this to search to the end of the
page and then start again from the top or bottom, depending on whether
you are searching forward or backwards.</li>
<li><strong>Search backwards</strong>: Use this to search back from the
insertion point to the beginning of the page.</li>
</ul>
</li>
<li>Click Find Next to begin searching. When Composer locates the first
occurrence of the text, click Find Next to search for the next
occurrence.</li>
<li>Click Close when you are done.</li>
</ol>

<p>To find and replace text in the page you&apos;re currently working on:</p>

<ol>
<li>Click to place the insertion point where you want to begin your
search.</li>
<li>Open the Edit menu and choose Find and Replace. You see the Find and
Replace dialog box.</li>
<li>Type the text you want to find and then type the replacement text.</li>
<li>To narrow the search, check one or more of the following options:
<ul>
<li><strong>Match exact case</strong>: Use this to specify whether
the search is for case-sensitive text. If you don&apos;t select this
option, the search will find matching text in both upper and lower
case.</li>
<li><strong>Wrap around</strong>: Use this to search to the end of the
page and then start again from the top.</li>
<li><strong>Search backwards</strong>: Use this to search from the end
to the beginning of the page.</li>
</ul>
</li>
<li>Click Find Next to search for the next occurrence. Composer selects the
next occurrence of the text.</li>
<li>Click Replace to replace the selected text with the replacement text.
Click Replace and Find to replace the selected text and find the next
occurrence. Click Replace All to replace every occurrence in the document
with the replacement text.</li>
<li>Click Close when you are done.</li>
</ol>

section</a>]</p>

<h2 id="inserting_horizontal_lines">Inserting Horizontal Lines</h2>

<p>Horizontal lines are typically used to separate different sections of a
document visually. To insert a horizontal line (also called a <em>rule</em>)
in your page, begin from the Composer window:</p>

<ol>
<li>Click to place the insertion point where you want the line to
appear.</li>
<li>Open the Insert menu and choose Horizontal Line.</li>
</ol>

<h3 id="setting_horizontal_line_properties">Setting Horizontal Line
Properties</h3>

<p>You can customize a line&apos;s height, length, width, alignment, and

<ol>
<li>Double-click the line to display the Horizontal Line Properties dialog
box.</li>
<li>Edit any of these properties:
<ul>
<li><strong>Width</strong>: Enter the width and then choose <q>% of
window</q> or <q>pixels</q>. If you specify width as a percentage,
the line&apos;s width changes whenever the Composer window&apos;s
or browser window&apos;s width changes.</li>
<li><strong>Height</strong>: Type a number for the line&apos;s height
(in pixels).</li>
<li><strong>Alignment</strong>: Specify where you want to place the
line (left, center, or right).</li>
</ul>
</li>
<li>Click Use as Default to use these settings as the default the next time
you insert a horizontal line.</li>
<li>To edit the properties of a horizontal line manually, click Advanced
Edit. See the section,
for details.</li>
</ol>

<p><strong>Tip</strong>: You can select <q>HTML Tags</q> from the View menu to
show all the HTML elements in yellow boxes. Click any yellow box to select
everything within that HTML tag or element. Double-click any yellow box to
display the
dialog box for that HTML tag or element.</p>

section</a>]</p>

<h2 id="inserting_special_characters">Inserting Special Characters</h2>

<p>To insert special characters such as accent marks, copyrights, or currency
symbols:</p>

<ol>
<li>Click to place the insertion point where you want the special character
to appear.</li>
<li>Open the Insert menu and choose Characters and Symbols. You see the
Insert Character dialog box.</li>
<li>Select a category of characters.
<ul>
<li>If you choose Accent Uppercase or Accent Lowercase, then open the
Letter drop-down list and select the letter you wish to apply an
accent to. (Note: not all letters have accented forms.) Select
Common Symbols to insert special characters such as copyright symbols
or fractions.</li>
</ul>
</li>
<li>From the Character drop-down list, select the character you want to
insert.</li>
<li>Click Insert.

<p>You can continue typing in your document (or in a mail compose window)
while you keep this dialog box open, in case you want to use it
again.</p>
</li>
<li>Click Close when you are done inserting special characters.</li>
</ol>

section</a>]</p>

<h2 id="inserting_html_elements_and_attributes">Inserting HTML Elements and
Attributes</h2>

<p>If you understand how to work with HTML source code, you can insert
additional tags, style attributes, and JavaScript into your page. If you are
not sure how to work with HTML source code, it&apos;s best not to change it.
To work with HTML code, use one of these methods:</p>

<ul>
<li>Place the insertion point where you want to insert the HTML code, or
select the text you want to edit, and then open the Insert menu and choose
HTML. In the Insert HTML dialog box, enter HTML tags and text, and then
click Insert.</li>
<li>Select an element such as a table, named anchor, image, link, or
horizontal line. Double-click the element to open the associated properties
dialog box for that item. Click Advanced Edit to open the Advanced Property
Editor. You can use the Advanced Property Editor to add HTML attributes,
JavaScript, and CSS to objects.</li>
<li>Open the View menu, and choose HTML Source, or click the &lt;HTML&gt;
Source tab in the Edit Mode toolbar at the bottom of the Composer window.
(If you don&apos;t see the Edit Mode toolbar, open the View menu and choose
Show/Hide; then make sure the Edit Mode Toolbar is checked.)</li>
</ul>

Editor</h3>

<p>To add HTML attributes and JavaScript to objects such as tables, images,
and horizontal lines, you can use the Advanced Property Editor.</p>

<p><strong>Note</strong>: Unless you clearly understand how to add, delete, or
modify HTML attributes and their associated values, it&apos;s best not to do
so.</p>

<p>If you are not currently viewing the Advanced Property Editor dialog box,

<ol>
<li>From the View menu (or the Edit Mode toolbar), choose HTML Tags.</li>
<li>Double-click the object that you want to modify to open its Properties
dialog box.</li>
The Advanced Property Editor has three tabs, each of which lists the
current properties for the selected object:
<ul>
<li><strong>HTML Attributes</strong>: Click this tab to view or enter
<li><strong>Inline Style</strong>: Click this tab to view or enter
in Composer, see
<a href="#composer">Composer Preferences -Composer</a>.</li>
<li><strong>JavaScript Events</strong>: Click this tab to view or enter
JavaScript events.</li>
</ul>
</li>
<li>To edit a property or attribute in any of the three lists, select the
attribute you want to edit. You can then edit the attribute&apos;s name
or value using the editable Attribute and Value fields at the bottom of
the dialog box. To add a new attribute, type it in the Attribute field
at the bottom of the dialog box. The new attribute is automatically added
when you click in the Value field. To remove an attribute, select it in
the list, and click Remove Attribute.

<p><strong>Note</strong>: Required attributes are highlighted in the
Attribute list.</p>
</li>
<li>Click OK to apply your changes to the Advanced Property Editor dialog
box.</li>
<li>Click OK again to exit the Properties dialog box.</li>
</ol>

<p>Composer automatically places quotation marks around any attribute text.</p>

section</a>]</p>

<h2 id="validating_the_html">Validating the HTML</h2>

<p>Before you put your document on a web server so that others can see it, you
should first check the document&apos;s HTML formatting to make sure it
conforms to web standards. Documents containing validated HTML are less
likely to cause problems when viewed by different browsers. Just visually
checking your web pages in the browser doesn&apos;t ensure that your document
will appear correctly when viewed in other web browsers.</p>

<p>Composer provides a convenient way for you to check that your document
conforms to W3C (World Wide Web Consortium) HTML standards. Composer uses
the W3C HTML Validation Service, which checks your document&apos;s HTML
syntax for compliance with HTML 4.01 standards. This service also provides
information on how to correct errors.</p>

<p><strong>Note</strong>: You must be connected to the Internet to use this
feature.</p>

<p>To validate your document&apos;s HTML syntax:</p>

<ol>
<li>Open the Tools menu, and choose Validate HTML. If you have unsaved
changes, Composer asks you to save them before proceeding.</li>
<li>When the W3C HTML Validation Service page appears, click <q>Browse</q>
and locate the file on your hard disk that you want to validate.</li>
<li>Click <q>Check</q>.</li>
</ol>

section</a>]</p>

<h2 id="choosing_the_right_editing_mode">Choosing the Right Editing Mode</h2>

<p>Typically, you won&apos;t need to change the editing mode from the default
(Normal). However, if you want to work with the document&apos;s HTML source
code, you may want to change editing modes.</p>

<p>Composer allows you to quickly switch between four editing modes or views.
Each editing mode allows you to continue working on your document, but
displays varying levels of HTML tags (and tag icons).</p>

<p>Before you choose an editing mode:</p>

<ul>
<li>Open the View menu, choose Show/Hide, and then make sure there is a
checkmark next to Edit Mode Toolbar.</li>
</ul>

<p>The Edit Mode toolbar has four tabs:</p>

<ul>
<li><strong>Normal</strong>: Choose this editing mode to see how the document
will look online while you are creating it. Choose this mode to
show table borders and named anchor icons. All other HTML tag icons
are hidden.</li>
<li><strong>HTML Tags</strong>: Choose this mode to show all HTML tag
icons.</li>
<li><strong>&lt;HTML&gt; Source</strong>: Choose this mode to view and edit
the document as unformatted HTML source code. When you save the
document, the Normal mode reappears.</li>
<li><strong>Preview</strong>: Choose this mode to display and edit the
document exactly as it would appear in a browser window, except
that links and JavaScript functions will not be active.</li>
</ul>

<p><strong>Note</strong>: JavaScript functions, frames, links, Java,
embedded objects and animated GIF files are not active in any of
the editing modes. To display these items in their active
state, click the Browse button on the Composition toolbar to
load the page into a browser window.</p>

section</a>]</p>

<div class="contentsBox">In this section:
<ul>
<li><a href="#inserting_a_table">Inserting a Table</a></li>
<li><a href="#changing_a_tables_properties">Changing a Table&apos;s
Properties</a></li>
Deleting Rows, Columns, and Cells</a></li>
<li><a href="#selecting_table_elements">Selecting Table Elements</a></li>
<li><a href="#moving_copying_and_deleting_tables">Moving, Copying, and
Deleting Tables</a></li>
<li><a href="#converting_text_into_a_table">Converting Text into a
Table</a></li>
</ul>
</div>

<h2 id="inserting_a_table">Inserting a Table</h2>

<p>Tables are useful for organizing text, pictures, and data into formatted
rows and columns. To insert a table:</p>

<ol>
<li>Click to place the insertion point where you want the table to appear.</li>
<li>Click the Table button
<img src="images/table.gif" width="25" height="26" alt="" /> on the
Composition toolbar. The Insert Table dialog box appears.</li>
<li>Type the number of rows and columns you want.
<ul>
<li>(Optional) Enter a size for the table width, and select either
percentage of the window or pixels.</li>
</ul>
</li>
<li>Enter a number for the border thickness (in pixels); enter zero for no
border.

<p><strong>Note</strong>: Composer uses a red dotted line to indicate
tables with a zero border; the dotted line disappears when the page
is viewed in a browser.</p>
</li>
to display the
</li>
</ol>

<a href="#changing_a_tables_properties">Changing a Table&apos;s
Properties</a>.
</p>

<p><strong>Tip</strong>: To insert a table within a table, open the

section</a>]</p>

<h2 id="changing_a_tables_properties">Changing a Table&apos;s Properties</h2>

<p>This section describes how to modify properties that apply to an entire
table as well as the rows, columns, or individual cells within a table. If
you are not currently viewing the Table Properties dialog box, follow these
steps:</p>

<ol>
<li>Select the table, or click anywhere inside it.</li>
<li>Click the Table button
<img src="images/table.gif" width="25" height="26" alt="" /> on the
toolbar, or open the Table menu and choose Table Properties. The Table
Properties dialog box contains two tabs: Table and Cells.</li>
<li>Click the Table tab to edit these properties:
<ul>
<li><strong>Size</strong>: Use this to specify the number of rows and
columns. Enter the width of the table and then choose <q>% of
window</q> or <q>pixels</q>. If you specify width as a percentage, the
table&apos;s width changes whenever the Composer window&apos;s or
browser window&apos;s width changes.</li>
<li><strong>Borders and Spacing</strong>: Use this to specify, in pixels,
the border line width, the space between cells, and the cell padding
(the space between the contents of the cell and its border).

<p><strong>Note</strong>: Composer uses a dotted outline to display
tables with a zero border; the dotted line disappears when the page
is viewed in a browser.</p>
</li>
<li><strong>Table Alignment</strong>: Use this to align the table within
the page. Choose an option from the drop-down list.</li>
<li><strong>Caption</strong>: Choose the caption placement from the
drop-down list.</li>
<li><strong>Background Color</strong>: Use this to choose a color for
the table background, or leave it as transparent.</li>
</ul>
</li>
Property Editor</a>.
</li>
<li>Click Apply to preview your changes without closing the dialog box, or
click OK to confirm them.</li>
</ol>

<p>To view, change, or add properties for one or more cells:</p>

<ol>
<li>Select the row, column, or cell, then open the Table menu and choose
Table Properties. The Table Properties dialog box appears.</li>
<li>Click the Cells tab to edit the following properties:
<ul>
<li><strong>Selection</strong>: Choose Cell, Row, or Column from the
drop-down list. Click Previous or Next to move through rows, columns,
or cells.</li>
<li><strong>Size</strong>: Type a number for Height and Width, and then
choose <q>% of table</q> or <q>pixels</q>.</li>
<li><strong>Content Alignment</strong>: Select a vertical and horizontal
alignment type for the text or data inside each cell.</li>
<li><strong>Cell Style</strong>: Select Header from the drop-down list
for column or row headers (which centers and bolds the text in the
cell); otherwise choose Normal.</li>
<li><strong>Text Wrap</strong>: Select <q>Don&apos;t wrap</q> from the
drop-down list to keep text from wrapping to the next line unless you
insert a paragraph break. Otherwise, choose Wrap.</li>
<li><strong>Background Color</strong>: Select a color for the cell
background or leave it as transparent.

<p><strong>Note</strong>: To apply additional attributes or JavaScript
events, click Advanced Edit to display the
Editor</a>
</p>
</li>
</ul>
</li>
<li>Click Apply to preview your changes without closing the dialog box, or
click OK to confirm them.</li>
</ol>

<p><strong>Tip</strong>: To change the text color or background color of one
or more selected cells or the entire table, select the cells or click
anywhere in the table and then click the text color or background color
icon in the Format toolbar.</p>

<p><strong>Tip</strong>: To change the color of cells to the color last used,
select the cell, then press Shift and click on the background color picker.
This is useful when you want to use one color for individual cells.</p>

section</a>]</p>

Columns, and Cells</h2>

<p>Composer allows you to quickly add or delete one or more cells, columns,
or rows in a table. In addition, you can set options that allow you to
maintain the original rectangular structure or layout of the table while

<ol>
<li>Click inside the table where you want to add a cell (or cells).</li>
<li>Open the Table menu and then choose Insert.</li>
<li>Choose one of the cell groupings. (You can also insert a new table
within a table cell.)</li>
</ol>

<p>To delete a cell, row, or column:</p>

<ol>
<li>Click a row, column, or cell to place the insertion point. Or,
select neighboring cells to delete more than one row at a time. To
select neighboring cells, drag over the cells you want to select.
To select individual cells in a table, hold down the
<kbd class="mac">Cmd</kbd><kbd class="noMac">Ctrl</kbd> key and click
on the cells you want to select.</li>
<li>Open the Table menu and choose Delete.</li>
<li>Choose the item you want to delete.</li>
</ol>

<p>To join (or merge) a cell with the cell on its right:</p>

<ul>
<li>Click inside the cell on the left, open the Table menu, and
choose Join with Cell to the Right.</li>
</ul>

<p>To join (or merge) adjacent cells:</p>

<ul>
<li>Select adjacent cells by dragging over them.</li>
<li>Open the Table menu, and choose Join Selected Cells.</li>
</ul>

<p>To split a joined cell back into two or more cells:</p>

<ul>
<li>Click inside the joined cell, open the Table menu, and then
choose Split Cell. Composer puts the entire contents of the joined
cell into the first of the two cells.</li>
</ul>

<p>Refer to <a href="#selecting_table_elements">Selecting Table Elements</a>
for information on how to select non-adjacent cells, rows, and
columns.</p>

<h3 id="changing_the_default_table_editing_behavior">Changing the Default Table
Editing Behavior</h3>

<p>By default, when you delete one or more cells, Composer preserves the
table&apos;s structure by adding cells at the end of a row, wherever
needed. This allows you to delete one or more cells but still maintain
the table&apos;s original rectangular layout, or structure. Otherwise,
deleting cells can result in a table with empty spaces, or whose outline
appears irregular due to an uneven number of cells.</p>

<p>To change the default table editing behavior, begin from the Composer
window:</p>

<ol>
<li>Open the <span class="mac">&brandShortName;</span>
<span class="noMac">Edit</span> menu, choose Preferences, and then choose
Composer.</li>
<li>Under Editing, set the following preference:
<ul>
<li>Make sure that <q>Maintain table layout when inserting or
deleting cells</q> is checked to ensure that you don&apos;t get an
irregularly shaped table.</li>
</ul>
</li>
<li class="win">Click OK.</li>
</ol>

section</a>]</p>

<h2 id="selecting_table_elements">Selecting Table Elements</h2>

<p>You can use one of two ways to quickly select a table, cell, or group of
cells:</p>

<ul>
<li>Click in the table, open the Table menu, choose Select, and then choose
an item from the submenu. For example, to select a table, click anywhere
inside the table, open the Table menu, choose Select, and then choose
Table.</li>
<li>Or, you can use the mouse as a selection tool:
<ul>
<li>To select a group of adjacent cells: click in a cell, and then
drag to select the cells you want. Drag the mouse left or right to
select a row; up or down to select a column.</li>
<li>To select non-adjacent cells: press <kbd class="mac">Cmd</kbd>
<kbd class="noMac">Ctrl</kbd> and then click inside a cell. Keep
pressing <kbd class="mac">Cmd</kbd> <kbd class="noMac">Ctrl</kbd>
as you click to select additional cells.</li>
<li>To extend a selection to include adjacent cells: click inside a
cell and then drag over additional cells to extend the selection.</li>
<li>To select one or more adjacent columns or rows: drag up or down
to select the first column or row, and then drag left or right to
and drag to the right to select an entire row. Press <kbd>Shift</kbd>
and drag up or down to select an entire column.</li>
</ul>
</li>
</ul>

section</a>]</p>

<h2 id="moving_copying_and_deleting_tables">Moving, Copying, and Deleting
Tables</h2>

<p>To move a table:</p>

<ol>
<li>Click inside the table.</li>
<li>Open the Table menu, choose Select, and then choose Table.</li>
</ol>

<ul>
<li>To copy or move the table: Use the Edit menu&apos;s cut, copy, and
paste options.</li>
<li>To delete the table: Open the Table menu again, choose Delete, and
then choose Table.</li>
</ul>

section</a>]</p>

<h2 id="converting_text_into_a_table">Converting Text into a Table</h2>

<p>To convert text into a table:</p>

<ol>
<li>Select the text that you want to convert into a table. Keep in mind that
Composer creates a new table row for each paragraph in the selection.</li>
<li>Open the Table menu and choose Create Table from Selection. You see the
Convert to Table dialog box.</li>
<li>Choose the character Composer uses to separate the selection into
columns, or specify a different character to use. If you choose Space as
the separator for columns, choose whether or not you want Composer to
ignore multiple space and treat them as one space.</li>
<li>Leave <q>Delete separator character</q> checked to have Composer remove
the separator character when it converts the text into a table. If you
don&apos;t want Composer to delete the separator character, uncheck this
option.</li>
<li>Click OK.</li>
</ol>

<p><strong>Note</strong>: Text formatting is removed when the selected text
is converted to a table.</p>

section</a>]</p>

Page</h1>

<div class="contentsBox">In this section:
<ul>
<li><a href="#inserting_an_image_into_your_page">Inserting an Image into
<li><a href="#editing_image_properties">Editing Image Properties</a></li>
</ul>
</div>

<h2 id="inserting_an_image_into_your_page">Inserting an Image into Your
Page</h2>

<p>You can insert GIF, JPEG, BMP, and PNG (Portable Network Graphics) images
into your web page. You can also use them to
Composer saves a reference to the image in your page.</p>

<p><strong>Note</strong>: If you plan to publish your pages to the web,
it&apos;s best not to use BMP images in your pages.</p>

<p><strong>Tip</strong>: It&apos;s best to first save or publish your page
before you insert images into it. This allows Composer to automatically
use relative references to images once you insert them.</p>

<p>To insert an image:</p>

<ol>
<li>Click to place the insertion point where you want the image to
appear.</li>
<li>Click the Image button
<img src="images/image.gif" width="23" height="25" alt="" />
on the toolbar, or open the Insert menu and choose Image. You see the
Image Properties dialog box.</li>
<li>Type the location and filename of the image file, or click Choose File
to search for an image file on your hard drive or network.</li>
<li>Type a simple description of your image as the alternate text that will
appear in text-only browsers (as well as other browsers) when an image is

<p>Alternatively, you can choose not to include alternate text.</p>
</li>
<li>If needed, click other tabs so you can adjust the settings (for
example, alignment) in the
<a href="#editing_image_properties">Image Properties</a> dialog box.</li>
</ol>

<p><strong>Tip</strong>: To quickly insert an image: Drag and drop it onto

<p><strong>Tip</strong>: To insert a line break after all images in a
paragraph, choose Break Below Images from the Insert menu.</p>

section</a>]</p>

<h2 id="editing_image_properties">Editing Image Properties</h2>

<p>Once you&apos;ve inserted an image into your page, you can edit its
properties and customize the layout in your page, such as the height,
width, spacing, and text alignment. If you are not currently viewing
the Image Properties dialog box, follow these steps:</p>

<ol>
<li>Double-click the image, or select it and click the Image button
<img src="images/image.gif" width="23" height="25" alt="" /> on the toolbar
to display the Image Properties dialog box.</li>
<li>Click the Location tab to edit these properties:
<ul>
<li><strong>Image Location</strong>: Type the filename and location of
the image file. Click Choose File to search for an image file on your
hard drive or network.</li>
<li><strong>URL is relative to page location</strong>: If checked,
Composer converts the URL to be relative to the page&apos;s location.
This is especially useful if you plan to publish your pages on a web
server so that others can view them. Using relative URLs allows you
to keep all your linked files in the same place relative to each other,
regardless of their location on your hard disk or a web server.

<p>Unchecking this box causes Composer to convert the URL to a full
(absolute) URL. You typically use absolute URLs when linking to
images on other web servers (not stored locally on your hard
disk).</p>

<p>If you have never saved or published the page, you must first save
the page in order to enable this checkbox. (This checkbox is not
available if you open the Image Properties dialog box in a message
compose window.)</p>
</li>
<li><strong>Attach this image to the message</strong>: If checked,
the image is attached to the message you are sending. If unchecked, a
link to the image location is inserted instead. (This checkbox is only
available if you open the Image Properties dialog box in a message
compose window.)</li>
<li><strong>Alternate Text</strong>: Enter text that will display in
place of the original image; for example, a caption or a brief
description of the image. It&apos;s a good practice to specify
alternate text for readers who use text-only web browsers or who have
<li><strong>Don&apos;t use alternate text</strong>: Choose this option
if the image does not require alternate text or if you don&apos;t want
to include it.</li>
</ul>
</li>
<li>Click the Dimensions tab to edit these properties:
<ul>
<li><strong>Actual Size</strong>: Select this option to undo any changes
you&apos;ve made to the dimensions and return the image to its original
size.</li>
<li><strong>Custom Size</strong>: Select this option and specify the new
height and width, in pixels or as a percentage. This setting
doesn&apos;t affect the original image file, just the image inserted
<li><strong>Constrain</strong>: If you change the image size, it&apos;s
a good idea to select this in order to maintain the image&apos;s aspect
ratio (so that it doesn&apos;t appear distorted). If you choose this
option, then you only need to change the height or width, but not
both.</li>
</ul>
</li>
<li>Click the Appearance Tab to edit these properties:
<ul>
<li><strong>Spacing</strong>: Specify the amount of space surrounding
the image; between the image and adjoining text. You can also put a
solid black border around the image and specify its width in pixels.
Specify zero for no border.</li>
<li><strong>Align Text to Image</strong>: If you&apos;ve placed your
image next to any text, select an alignment icon to indicate how you
want text positioned relative to the image.</li>
<li><strong>Image Map</strong>: Click Remove to remove any image map
settings.</li>
</ul>
</li>
<li>Click the Link tab to edit these properties:
<ul>
<li><strong>Enter a web page location</strong>: If you want to define
a link for this image, enter the URL of a remote or local page, or
select a named anchor or heading from the drop-down list. Click Choose
File to search for a file on your hard drive or network.</li>
<li><strong>URL is relative to page location</strong>: If checked,
Composer converts the URL to be relative to the page&apos;s location.
This is especially useful if you plan to publish your pages to a web
server so that others can view them. Using relative URLs allows you to
keep all your linked files in the same place relative to each other,
regardless of their location on your hard disk or a web server.

<p>Unchecking this box causes Composer to convert the URL to a full
(absolute) URL. You typically use absolute URLs when linking to files
on other web servers (not stored locally on your hard disk).</p>

<p>If you have unsaved changes, you must first save the page in order
to enable this checkbox. (This checkbox is not available if you open
the Image Properties dialog box in a message compose window.)</p>
</li>
<li><strong>Show border around linked image</strong>: If checked,
displays the link highlight color around the image.</li>
</ul>
</li>
to display the
</li>
<li>Click OK to confirm your changes.</li>
</ol>

section</a>]</p>

<h2 id="inserting_a_mathematical_formula_into_your_page">Inserting a
Mathematical Formula into Your Web Page</h2>

<p>&brandShortName; Composer allows you to write mathematical formulas, encoded
in your web page as <a href="glossary.xhtml#mathml">MathML</a> and
generated from a convenient
<a href="glossary.xhtml#latex">LaTeX</a>-like syntax.</p>

<p>To insert a formula:</p>

<ol>
<li>Click to place the insertion point where you want the formula to
appear.</li>
<li>Open the Insert menu and choose Math. You see the Math Insert dialog
box.</li>
<li>Enter your LaTeX source code, for example <tt>\frac{\sqrt{\pi}}{3}</tt>
to write
<math display="inline" xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mfrac><msqrt><mi>π</mi></msqrt><mn>3</mn></mfrac><annotation encoding="TeX">\frac{\sqrt{\pi}}{3}</annotation></semantics></math>.
In order to help you, a preview of the formula as well as a panel of
predefined constructions are available. For details, see
<a href="#editing_the_latex_source">Editing the LaTeX source</a>.
</li>
<li>Choose the style for your formula:
<ul>
<li><strong>Inline mode</strong>: If selected, the formula is inserted
inside the current paragraph of text and rendered in a way that
minimizes its height as much as possible. This mode is typically used
for small expressions. For example this is an expression in inline mode:
<math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><msub><mo>∫</mo><mi>D</mi></msub><mi>x</mi><mi>d</mi><mi>x</mi></mrow><annotation encoding="TeX">\int_D x dx</annotation></semantics></math>.</li>
<li><strong>Display mode</strong>: If selected, the formula is inserted
in its own block and uses the standard rendering. This mode is typically
used for large expressions. For example this is an expression in display
mode:
<math display="block" xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><msubsup><mo>∫</mo><mi>a</mi><mi>b</mi></msubsup><mrow><mi>f</mi><mo stretchy="false">(</mo><mi>x</mi><mo stretchy="false">)</mo></mrow><mspace width="thinmathspace"/><mi>d</mi><mi>x</mi></mrow><annotation encoding="TeX">\int_a^b {f(x)}\, dx</annotation></semantics></math></li>
</ul>
</li>
<li>Choose the overall direction of your formula:
<ul>
<li><strong>Left-to-right direction</strong>: If selected, the formula
will be laid out from left to right, e.g. <math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><msqrt><mi>x</mi></msqrt><annotation encoding="TeX">\sqrt{x}</annotation></semantics></math>.
This is the standard orientation in most countries.</li>
<li><strong>Right-to-left direction</strong>: If selected, the formula
will be laid out from right to left, e.g.
<math xmlns="http://www.w3.org/1998/Math/MathML" dir="rtl"><semantics><msqrt><mi>ج</mi></msqrt><annotation encoding="TeX">\sqrt{ج}</annotation></semantics></math>.
This is the standard orientation in some Arabic countries.</li>
</ul>
</li>
<li>Verify that the LaTeX source does not contain any syntax error and click
Insert to create your new formula.</li>
</ol>

<p>To modify a mathematical formula, move the insertion point inside it.
<a href="#editing_the_latex_source">edit the LaTeX source</a> again.
Alternatively, you can open the Insert menu and choose Math.
</p>

<p><strong>Note</strong>: &brandShortName; Composer attaches the LaTeX source to
the generated MathML expressions so that they can be edited again. In
general it is currently not possible to edit an arbitrary MathML expression
unless it has a LaTeX expression associated that is supported by
&brandShortName; Composer.
</p>

<h2 id="editing_the_latex_source">Editing the LaTeX Source</h2>

<p>The Insert Math box contains a text field where you can enter mathematical
expressions using a <a href="glossary.xhtml#latex">LaTeX</a>-like syntax.
If you are not familiar with LaTeX, here are the basics:
</p>

<ul>
<li>Use standard plain text notations for simple expressions:
<tt>x_1 + 2^y</tt> generates
<math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><msub><mi>x</mi><mn>1</mn></msub><mo>+</mo><msup><mn>2</mn><mi>y</mi></msup></mrow><annotation encoding="TeX">x_1 + 2^y</annotation></semantics></math>.
</li>
<li>Use braces to define groups: <tt>2^x+y</tt> generates
<math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><msup><mn>2</mn><mi>x</mi></msup><mo>+</mo><mi>y</mi></mrow><annotation encoding="TeX">2^x+y</annotation></semantics></math>
while <tt>2^{x+y}</tt> generates
<math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><msup><mn>2</mn><mrow><mi>x</mi><mo>+</mo><mi>y</mi></mrow></msup><annotation encoding="TeX">2^{x+y}</annotation></semantics></math>
</li>
<li>Use LaTeX commands of the form
<tt>\commandname[option1,option2,...] argument1 argument2 ...</tt> to define
complex expressions: <tt>\gamma</tt>, <tt>\frac a b</tt>, <tt>\sqrt x</tt>
and <tt>\sqrt[3]x</tt> generate
<math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mi>γ</mi><annotation encoding="TeX">\gamma</annotation></semantics></math>,
<math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mfrac><mi>a</mi><mi>b</mi></mfrac><annotation encoding="TeX">\frac a b</annotation></semantics></math>,
<math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><msqrt><mi>x</mi></msqrt><annotation encoding="TeX">\sqrt x</annotation></semantics></math> and
<math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mroot><mi>x</mi><mn>3</mn></mroot><annotation encoding="TeX">\sqrt[3] x</annotation></semantics></math> respectively.
</li>
<li>Use LaTeX environments
of the form <tt>\begin{environmentname}  ... \end{environmentname}</tt>
to define blocks with a special syntax. This is typically used for arrays:
<tt>\begin{matrix} a &amp; b &amp; c \\ d &amp; e &amp; f \end{matrix}</tt>
generates
<math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mtable displaystyle="false" rowspacing="0.5ex"><mtr><mtd><mi>a</mi></mtd><mtd><mi>b</mi></mtd><mtd><mi>c</mi></mtd></mtr><mtr><mtd><mi>d</mi></mtd><mtd><mi>e</mi></mtd><mtd><mi>f</mi></mtd></mtr></mtable><annotation encoding="TeX">\begin{matrix}a &amp; b &amp; c \\ d &amp; e &amp; f \end{matrix}</annotation></semantics></math>.
</li>
<li>Use special commands to escape characters:
<tt>\backslash \&amp; \{ \}</tt> generates
<math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mo>\</mo><mi>&amp;</mi><mo stretchy="false">{</mo><mo stretchy="false">}</mo></mrow><annotation encoding="TeX">\backslash \&amp; \{ \}</annotation></semantics></math>.
</li>
</ul>

<p>There exists a large collection of LaTeX commands and there is not any
finite and well-defined list of them. &brandShortName; Composer only supports
the <a href="https://github.com/fred-wang/TeXZilla/wiki/TeXZilla-Commands">TeXZilla commands</a>
which are themselves based on the <a href="https://golem.ph.utexas.edu/~distler/blog/itex2MMLcommands.html">itex2MML commands</a>
and should cover the most popular constructions. One of the nice features of
TeXZilla is that it accepts arbitrary characters as input so that
<tt>\left⌊α^2\right⌋</tt> is equivalent to the more verbose
<tt>\left\lfloor\alpha^2\right\rfloor</tt> and generates
<math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mo>⌊</mo><msup><mi>α</mi><mn>2</mn></msup><mo>⌋</mo></mrow><annotation encoding="TeX">\left⌊α^2\right⌋</annotation></semantics></math>.</p>

<p>You do not need to know all the LaTeX commands to edit formulas. Instead, a
panel of predefined expressions is available. Click any of the panel buttons
to insert the corresponding LaTeX expression. Arguments in LaTeX expressions
are represented by ellipses. You can just edit the LaTeX source to
replace them with the actual content you want.</p>

<p><strong>Tip</strong>: If you select a subexpression in the LaTeX source field
and use the construction panel to insert a LaTeX expression with at least one
argument, that subexpression will be used as the first argument of the
new expression.</p>

beginning of section</a>]</p>

<h1 id="setting_page_properties">Setting Page Properties</h1>

<div class="contentsBox">In this section:
<ul>
<li><a href="#setting_page_properties_and_meta_tags">Setting Page
Properties and Meta Tags</a></li>
<li><a href="#setting_page_colors_and_backgrounds">Setting Page Colors and
Backgrounds</a></li>
</ul>
</div>

<h2 id="setting_page_properties_and_meta_tags">Setting Page Properties and Meta
Tags</h2>

<p>Use the Page Properties dialog box to enter properties such as the title,
author, and description of the document you&apos;re currently working on.
This information is useful if you plan to use the page on a website, since
search engines use this type of information to index your page. You can view
this information from the browser window by opening the View menu and
choosing Page Info.</p>

<ol>
<li>Open the Format menu and choose Page Title and Properties.</li>
<li>Edit any of the following properties:
<ul>
<li><strong>Title</strong>: Type the text you want to appear as the
window title when someone views the page through a browser. This
is how most web search tools locate web pages, so choose a title
<li><strong>Author</strong>: Type the name of the person who created the
document by using a web search tool to search on name.

<p><strong>Tip</strong>: If you enter the Author name in
Composer&apos;s <a href="#new_page_settings">preferences</a>, then
you won&apos;t have to enter it each time you create a new page.</p>
</li>
<li><strong>Description</strong>: Enter a brief description of the
document&apos;s contents.</li>
</ul>
</li>
</ol>

<h2 id="setting_page_colors_and_backgrounds">Setting Page Colors and
Backgrounds</h2>

<p>You can change the background color or specify a background
image for the page you&apos;re currently working on. These choices
affect the way text and links in your page appear to people viewing
the page through a browser.</p>

<p>To set the colors and background for the current page, begin
from the Composer window:</p>

<ol>
<li>Open the Format menu and choose Page Colors and Background.</li>
<li>Edit any of the following properties:
<ul>
<li><strong>Reader&apos;s default colors</strong>: Select this if you
want your page to use the color settings from the viewer&apos;s browser
<li><strong>Use custom colors</strong>: Select this if you want to
specify the colors of text and links. For each element, select a color
from the Color selection dialog. Sample output for each type of link
appears in the pane on the right.</li>
<li><strong>Background image</strong>: Select this if you want the
background of your page to be an image. Type the name of the image
file or click Choose File to locate the image file on your hard
drive or network.

<p><strong>Note</strong>: Background images are tiled and override
background color selections.</p>
</li>
<li><strong>URL is relative to page location</strong>: If checked,
Composer converts the URL to be relative to the page&apos;s location.
This is especially useful if you plan to publish your pages on a web
server so that others can view them.

<p>Using relative URLs allows you to keep all your linked files in
the same place relative to each other, regardless of their location
on your hard disk or a web server.</p>

<p>Deselecting this option causes Composer to convert the URL to a
full (absolute) URL. You typically use absolute URLs when linking
to images on other web servers (not stored locally on your hard
disk).</p>

<p>If you have unsaved changes, you must first save the page in
order to enable this checkbox.</p>
</li>
</ul>
</li>
</ol>

<p><strong>Note</strong>: To apply additional attributes or JavaScript events,
click Advanced Edit to display the
Editor</a>.</p>

<p>You can also set the <a href="#new_page_settings">default page
background and colors</a> for every new page you create in Composer.</p>

<div class="contentsBox">In this section:
<ul>
the Same Page</a></li>
Pages</a></li>
</ul>
</div>

Page</h2>

can use to jump from one section to another, you must create an
<em>anchor</em> (target location), and then create a link that points to the
anchor. Anchors are also called <em>named anchors</em>. To create an anchor,

<ol>
<li>Click to place the insertion point at the beginning of a line where you
want to create an anchor, or select some text.</li>
<li>Open the Insert menu and choose Named Anchor. You see the Named Anchor
Properties dialog box.</li>
<li>Type a unique name for the anchor in the Anchor Name field (up to 30
characters). If you include spaces, they will be converted to underscores
( _ ). If you selected some text in step 1, this box already contains a
name.</li>
<li>Click OK. An anchor icon appears in your document to mark the
anchor&apos;s location:
<img src="images/anchor-in-doc.gif" width="20" height="17" alt="" /></li>
</ol>

<ol>
<li>Select the text or image that you want to link to the anchor.</li>
<ul>
<li>If you&apos;re creating a link to an HTML file on your computer,
click Choose File to locate it.</li>
<li>If you&apos;re creating a link to a named anchor (target), select
it from the list of the anchors currently available in the page.</li>
available in the page.</li>
</ul>
</li>
<li>Click OK.</li>
</ol>

<p><strong>Note</strong>: To test the link you just created, open the File

<p><strong>Tip</strong>: If you did not first create named anchors, you can
the page.</p>

section</a>]</p>

on your workplace&apos;s network, or to remote pages on the Internet.</p>

<p><strong>Tip</strong>: It&apos;s best to first save or publish your page
before you create links to other pages. This allows Composer to automatically
use relative references for links once you create them.</p>

<p>To create a link to another page:</p>

<ol>
<li>Click to place the insertion point where you want to create a link, or
select the text or image that you want to link to the anchor.</li>
<ul>
file or text before clicking the Link button, the selected text or
file will be entered here. Otherwise, you must enter the text that you
want to use as the link.</li>
<li><strong>Link Location</strong>: Type the local path and filename or
remote URL of the page you want to link to. If you&apos;re not sure of
the path and filename for a local file, click Choose File to look for
it on your hard disk or network. For remote URLs, you can copy the URL
from the browser&apos;s Location Bar. Alternatively, you can select a
named anchor or a heading in the current page that you want to link
to.</li>
<li><strong>URL is relative to page location</strong>: If checked,
Composer converts the URL to be relative to the page&apos;s location.
This is especially useful if you plan to publish your pages to a web
server so that others can view them. Using relative URLs allows you to
keep all your linked files in the same place relative to each other,
regardless of their location on your hard disk or a web server.

<p>Deselecting this option causes Composer to convert the URL to a full
(absolute) URL. You typically use absolute URLs when linking to pages
on other web servers (not stored locally on your hard disk).</p>

<p>If you have unsaved changes, you must first save the page in order
to enable this checkbox. (This checkbox is not available if you open
the Link Properties dialog box in a message compose window.)</p>
</li>
<li><strong>Attach the source of this link to the message</strong>: If
checked, the source of the specified link is added as an attachment to
the message you are sending. If unchecked, just a link to the location
is inserted instead. (This checkbox is only available if you open the
Link Properties dialog box in a message compose window.)</li>
</ul>
</li>
to display the
</li>
<li>Click OK.</li>
<li>To test the link you just created, click the Browse button and then click
the link to make sure it works as expected.</li>
</ol>

<p><strong>Tip</strong>: You can copy a link quickly by clicking and dragging
the link from another window and then dropping it onto your page. For
example, you can click and drag a link from a web page, bookmark, or Mail
window and drop it onto your page. You can also right-click<span class="mac">
or, if you have a one-button mouse, <kbd>Ctrl</kbd>-click</span> a link on a
web page and choose Copy Link Location from the menu. Then you can paste the
box.</p>

section</a>]</p>

<p>You can make images, such as JPEG, GIF, or PNG files, behave like links in
displays the page that the image is linked to.</p>

<p>To make an image behaving like a link:</p>

<ol>
<li>Select an image on your page.</li>
<img src="images/link.gif" width="22" height="20" alt="" />
<li>Use the Link Properties dialog box to link the image to a
within the page</a>, or to a
<a href="#creating_links_to_other_pages">separate local or remote page</a>.
</li>
</ol>

<p><strong>Tip</strong>: Drag and drop a linked image from the browser window
into a Composer window to copy both the image and the link.</p>

<p><strong>Note</strong>: To remove the blue border that can appear around

<ol>
<li>In the dialog box, select the Link tab.</li>
<li>Uncheck <q>Show border around linked image</q>.</li>
<li>Click OK.</li>
</ol>

section</a>]</p>

<ol>
<li>Select the linked text (normally blue and underlined) or image.</li>
</ol>

<p>To discontinue a link, so that text you type after the link is not included

<ol>
<li>Click to place the insertion point where you want the link to end.</li>
</ol>

section</a>]</p>

<h1 id="publishing_your_pages_on_the_web">Publishing Your Pages on the Web</h1>

but no one else can. Composer lets you publish your pages to a remote
computer called a web server.</p>

<p>When you publish your pages to a web server, Composer copies (uploads) your
pages to a computer that lets others browse your pages. Most ISPs provide
space on their web servers for web page publishing. To find a web server

<div class="contentsBox">In this section:
<ul>
<li><a href="#publishing_a_document">Publishing a Document</a></li>
<li><a href="#updating_a_published_document">Updating a Published
Document</a></li>
<li><a href="#changing_the_filename_or_publishing_location">Changing the
Filename or Publishing Location</a></li>
<li><a href="#creating_a_new_publishing_site">Creating a New Publishing
Site</a></li>
<li><a href="#choosing_the_default_publishing_site">Choosing the Default
Publishing Site</a></li>
<li><a href="#deleting_a_publishing_site">Deleting a Publishing
Site</a></li>
<li><a href="#solving_common_publishing_problems">Solving Common Publishing
Problems</a></li>
<li><a href="#publishing_settings">Publishing Settings</a></li>
</ul>
</div>

<h2 id="publishing_a_document">Publishing a Document</h2>

<p><strong>Tip</strong>: It&apos;s best to first save or publish your page
before you insert links or images into it. This allows Composer to
automatically use relative references for links and images once you insert
them.</p>

<p>To publish a document:</p>

<ol>
<li>Open the HTML document that you want to publish, or create a new Composer
document.</li>
<li>When you&apos;re ready to publish the document remotely, click the
Publish button.

<p>If you have published this document before, Composer remembers the
document&apos;s publishing settings and starts publishing the document.
While publishing is in progress, Composer displays a publishing status
dialog box.</p>
<ul>
<li>If you have never published this document before, Composer displays
the Settings tab in the Publish Page dialog box so you can enter
information about the document&apos;s remote publishing location. See
<a href="#publish_page_settings">Publish Page - Settings</a> for more
information. When you&apos;re done entering information, click Publish.
</li>
<li>If you have never saved the document, Composer displays the Publish
tab in the Publish Page dialog box, so you can enter the
document&apos;s filename. See
<a href="#publish_page_publish">Publish Page - Publish</a> for more
information. After entering the filename, click Publish.</li>
</ul>
</li>
<li>To browse your published page, click the Browse button. Test the
page&apos;s links and make sure there are no missing images.</li>
<li>Continue editing the page as necessary. When you&apos;re ready to update
the remote page with your changes, click the Publish button.</li>
</ol>

<p>When you publish a document for the first time, Composer changes the
document&apos;s <tt>file:///</tt> URL to an <tt>http://</tt> URL to indicate
that you are now editing the published document. If you want to save the
document locally (on your computer&apos;s hard disk), click the Save button.
You&apos;ll be prompted to choose a filename and location on your hard disk
for the document.</p>

section</a>]</p>

<ul>
<li>Make sure your Composer filenames end with the .html or .htm file
extension. Make sure your image filenames end with the .JPG, .GIF, or .PNG
file extension. Don&apos;t use spaces or other special symbols in your
filenames. Keep your filenames short and only use lowercase or uppercase
letters and numbers.</li>
<li>If your images appear as broken links when you browse a document on the
web server, you may have forgotten to include the images when you
published. Open the File menu, and choose Publish As to display the Publish
Page dialog box. In the Publish tab, make sure you check <q>Include images
and other files</q> and then click Publish.</li>
</ul>

<p>For more troubleshooting tips, see
<a href="#solving_common_publishing_problems">Solving Common Publishing
Problems</a>.
</p>

section</a>]</p>

<h2 id="updating_a_published_document">Updating a Published Document</h2>

<p>To update a published document:</p>

<ol>
<li>In a Composer window, open the File menu, and choose Recent Pages, then
select the document from the list. <p>Alternatively, browse to the location
of the document you want to update by entering the document&apos;s HTTP
Location Bar.</p></li>
<li>Edit the document as necessary.</li>
<li>When you&apos;re ready to update the remote page with your changes, click
Publish in Composer&apos;s toolbar.</li>
</ol>

<p><strong>Tip</strong>: To delete a page or image you&apos;ve published on a
web server, you must use an <a href="glossary.xhtml#ftp">FTP (File Transfer
Protocol)</a> program. You also must use an FTP program if you want to create
provider if they recommend a particular FTP program. You can usually find
provider&apos;s website. FTP programs are also available from shareware sites

section</a>]</p>

<h2 id="changing_the_filename_or_publishing_location">Changing the Filename or
Publishing Location</h2>

<p>To change a document&apos;s filename or publishing location:</p>

<ol>
<li>In a Composer window, open the File menu, and choose Recent Pages, then
select the document from the list.

<p>Alternatively, browse to the location of the document you want to update
by entering the document&apos;s HTTP address (the document&apos;s web
address) in the browser&apos;s Location Bar.</p>
</li>
<li>Edit the document as necessary.</li>
<li>Open Composer&apos;s File menu and choose Publish As. Composer displays
the Publish tab in the Publish Page dialog box.</li>
<li>Enter a different page title, if necessary.</li>
<li>Enter a different filename for the page, if necessary.</li>
<li>From the Site Name list, choose the publishing location you want to use.
To set up a new publishing location, click New Site. See
<a href="#publish_page_settings">Publish Page - Settings</a> for more
information.</li>
<li>Click Publish to save the document to the new location.</li>
</ol>

section</a>]</p>

<h2 id="creating_a_new_publishing_site">Creating a New Publishing Site</h2>

<p>If you plan to publish documents to more than one remote location, you can
set up Composer to save the publishing information for each remote site you
use, so that you don&apos;t have to enter it each time you want to
publish.</p>

<p>To create a new publishing site, begin from a Composer window:</p>

<ol>
<li>Open the Edit menu and choose Publishing Site Settings. Composer
displays the Publish Settings dialog box.</li>
<li>Click New Site.</li>
<li>For <q>Site Name</q>, enter the nickname by which you want to refer to
this publishing site.

<p>For example, if you will use the new site to publish documents
related to the <q>Meteor</q> project, you might want to use the site
name <q>Meteor</q>. Site names remind you about the types of documents
you publish at each site.</p>
</li>
<li>For <q>Publishing address</q>, enter the complete URL provided to
URL must begin with either <tt>ftp://</tt> or <tt>http://</tt>.

<p>The publishing address specifies the location where documents are
published (uploaded) at this site. If you are not sure what to enter,
</li>
that you would enter in the browser to view pages at this
site. Do not include a filename or subdirectory as part of the URL.

<p>This URL must always begin with <tt>http://</tt>. In some cases,
this URL is the same as the publishing address. If you are not sure
it blank.</p>
</li>
or web hosting service.</li>
Password Manager so that you don&apos;t have to enter it each time you
publish pages at this site.</li>
<li>Click OK.</li>
</ol>

section</a>]</p>

<h2 id="choosing_the_default_publishing_site">Choosing the Default Publishing
Site</h2>

<p>If you have set up more than one publishing site, but you typically use
only one site for most of your publishing needs, you can designate the site
you use most often as the default publishing site. Composer will use the
default publishing site for all documents that you publish, unless you
specifically choose an alternate site.</p>

<p>Regardless of how many sites you&apos;ve set up, you can always publish a
document to a different site by choosing Publish As from Composer&apos;s
<a href="#changing_the_filename_or_publishing_location">Changing the Filename

<p>To choose the default publishing site, begin from a Composer
window:</p>

<ol>
<li>Open the Edit menu, and choose Publishing Site Settings.
Composer displays the Publish Settings dialog box.</li>
<li>Select a publishing site from the list.

<p>If you only have one publishing site set up, Composer uses that
one as the default site.</p>
</li>
<li>Click Set as Default.</li>
<li>Click OK to confirm your changes.</li>
</ol>

section</a>]</p>

<h2 id="deleting_a_publishing_site">Deleting a Publishing Site</h2>

<p>Deleting a publishing site removes the site&apos;s settings from Composer.
If you later wish to publish to the site, you must re-enter the site&apos;s
settings.</p>

<p>To delete a publishing site&apos;s settings, begin from a Composer
window:</p>

<ol>
<li>Open the Edit menu, and choose Publishing Site Settings. Composer
displays the Publish Settings dialog box.</li>
<li>Select a publishing site from the list.</li>
<li>Click Remove Site.

<p>Composer only removes the site&apos;s settings; the remote site itself
is not affected.</p>
</li>
<li>Click OK to confirm your changes.</li>
</ol>

section</a>]</p>

<h2 id="solving_common_publishing_problems">Solving Common Publishing
Problems</h2>

<p>If one or more of your files fail to publish, the Publishing
determine what went wrong and how to fix it.</p>

<p>If you are still unable to publish a file, save the file to your
hard disk by opening Composer&apos;s File menu, and choosing Save. You
can then open the file at a later time to try to publish it. To
quickly locate the file later, open Composer&apos;s File menu, and
choose Recent Pages.</p>

<div class="contentsBox">In this section:
<ul>
Settings</a></li>
<li><a href="#fixing_publishing_errors">Fixing Publishing Errors</a></li>
</ul>
</div>

Settings</h3>

<ol>
<li>Close the Publishing Status dialog box, if it is open.</li>
<li>Open the Edit menu and choose Publishing Site Settings.</li>
<li>In the Publish Settings dialog box, confirm that the site settings are
correct for the site you are trying to publish to. If you&apos;re not
sure, check with your ISP or web hosting service.
<ul>
<li><strong>Verify that you correctly entered the publishing
settings</strong>: You may have accidentally mis-typed one of the
settings.</li>
<li><strong>Verify that you entered the correct publishing
address</strong>: Web hosting services or ISPs may refer to the
publishing address as the <q>server name</q>, the <q>hostname</q>, or
the <q>server/host</q>. They often specify the publishing location as
user name.

<p>For the publishing address to be correct, you must precede the
publishing location with either <tt>ftp://</tt> or <tt>http://</tt>.
For example, the correct publishing address for the above-mentioned
</li>
</ul>
</li>
</ol>

<p>Examine the names of any files that failed to publish. Make sure that the
filenames:</p>

<ul>
<li>Use only numbers or lowercase or uppercase letters. While it&apos;s
acceptable to create filenames that use uppercase letters, you can avoid
potential errors in later locating the published file if you only use

<p>When you publish files to a web server, filenames become
case-sensitive on the web server. It may be harder for you to remember
files names that use only uppercase letters or that use a mix of
uppercase and lowercase letters.</p>

<p>For example, when you try to locate a published file by typing the
filename&apos;s web address into the browser&apos;s Location Bar, you
must enter the filename exactly as you created it, using the same
combination of uppercase and lowercase letters.</p>
</li>
<li>Don&apos;t use punctuation characters or spaces. Underscores ( _ )
or hyphens ( - ) are OK.</li>
<li>End with .html or .htm (for Composer filenames).</li>
<li>Use less than 32 characters.</li>
</ul>

<h3 id="fixing_publishing_errors">Fixing Publishing Errors</h3>

<p>If one or more of your files fails to publish, look at the messages
Composer displays in the Publishing Status area of the Publishing dialog box.
You can use these error messages to help determine what went wrong and what
to do to fix the problem.</p>

<div class="contentsBox" style="background-color: #ebebeb;">
<p>Error Messages:</p>
<p><a href="#file_not_found"><tt><var>X</var> of <var>Y</var> files failed to
publish.</tt></a></p>
<p><a href="#subdir_not_found"><tt>The subdirectory <var>directory name</var>
doesn&apos;t exist on this site or the filename <var>filename</var> is
already in use by another subdirectory.</tt></a></p>
<p><a href="#subdir_not_found"><tt>The filename <var>filename</var> is
already in use by another subdirectory.</tt></a></p>
<p><a href="#server_not_found"><tt>The server is not available. Check your
connection and try again later.</tt></a></p>
<p><a href="#no_permission"><tt>You do not have permission to publish to this
location.</tt></a></p>
<p><a href="#offline_error"><tt>You are currently offline. Click the icon
near the lower-right corner of any window to go online.</tt></a></p>
<p><a href="#no_disk_space"><tt>There is not enough disk space available to
save the file <var>filename</var>.</tt></a></p>
<p><a href="#name_too_long"><tt>The filename or subdirectory name is too
long.</tt></a></p>
</div>

<div class="errorMessage">
<p id="file_not_found"><strong>Error Message</strong>:</p>

<div class="contentsBox" style="background-color: #ebebeb;">
<p>or</p>
<tt><var>X</var> of <var>Y</var> files failed to publish.</tt>
</div>

<p><strong>Error Description</strong>: One or more image files or CSS files
failed to publish because Composer could not find them. Some typical
reasons might be:</p>

<ul>
<li>The file location you typed is incorrect.</li>
<li>The file&apos;s location on the web is not accessible.</li>
<li>The file&apos;s location was changed or the file was deleted or
moved to another location.</li>
</ul>

<p><strong>Possible Solutions</strong>:</p>

<ul>
<li>Look for broken images in the page you are trying to publish. Broken
images will appear with this icon
<img src="images/broken.gif" width="20" height="20" alt="" /> in the
page. To correct the image&apos;s address, double-click the broken
image to display the Image Properties dialog box so you can enter the
<li>Remove the broken image from the page by selecting it (click once on
the image), and then pressing <kbd>Backspace</kbd> or <kbd>Delete</kbd>
<li>If the image is unavailable because the server where the image resides
is inaccessible, try publishing the page at a later time.</li>
<li>If the missing file is a CSS file, you must first verify the correct
location of the CSS file. To fix the file&apos;s address in Composer,
click the HTML Source tab and edit the file&apos;s location in the HTML
source code. You should only edit the HTML source if you are familiar
with HTML tags.</li>
</ul>
</div>

<div class="errorMessage">
<p id="subdir_not_found"><strong>Error Message</strong>:</p>

<div class="contentsBox" style="background-color: #ebebeb;">
<tt>The subdirectory <var>directory name</var> doesn&apos;t exist on this
site or the filename <var>filename</var> is already in use by another
subdirectory</tt>
<p>or</p>
<tt>The filename <var>filename</var> is already in use by another
subdirectory</tt>
</div>

<p><strong>Error Description</strong>: You specified the name of a remote
subdirectory that does not exist at the publishing site. Composer can only
publish to a remote subdirectory that already exists at the publishing
location. Or, you specified a filename that is identical to the name of an
existing subdirectory at the publishing site.</p>

<p>For example, in the Publish Page dialog box, under the Publish tab:</p>

<ul>
<li>for <q>Site subdirectory for this page</q>, you may have typed the name
of a subdirectory that does not exist at the publishing location.</li>
<li>you checked <q>Include images and other files</q>, and then you typed
the name of a subdirectory that does not exist at the publishing
location.</li>
<li>one of the files you are attempting to publish has the same name as a
subdirectory at the publishing site.</li>
</ul>

<p><strong>Possible Solutions</strong>:</p>

<ul>
<li>Use a separate FTP program if you want to create, rename, or delete
recommend a particular FTP program. You can usually find information on
provider&apos;s website. FTP programs are also available from shareware
<li>Don&apos;t use subdirectory names that end with <q>.html</q> or
<q>.htm</q>. Only your Composer filenames should end with <q>.html</q>
or <q>.htm</q>.</li>
<li>Subdirectory names are case-sensitive, so be sure to enter a
subdirectory name exactly as it appears at the publishing location.</li>
</ul>
</div>

<div class="errorMessage">
<p id="server_not_found"><strong>Error Message</strong>:</p>

<div class="contentsBox" style="background-color: #ebebeb;">
<tt>The server is not available. Check your connection and try again
later.</tt>
</div>

<p><strong>Error Description</strong>: This error can have many causes. For
example:</p>

<ul>
<li>Your publishing site settings may not be correct.</li>
<li>Your Internet connection may have been lost.</li>
<li>Your modem or other equipment that you use to connect to the Internet
might not be functioning correctly.</li>
<li>The web server that you are trying to publish to might be unavailable
due to a technical problem or to an unknown circumstance.</li>
<li>Your ISP or web hosting service may be experiencing technical
problems.</li>
</ul>

<p><strong>Possible Solutions</strong>:</p>

<ul>
<li>Verify that your publishing settings are correct and that you entered
them correctly. See
<li>Make sure your Internet connection is working by attempting to view a
web page using the browser. For example, confirm that you can
successfully view the page <tt>http://www.mozilla.org</tt>.</li>
<li>If your Internet connection is not working, verify that all hardware,
telephone connections, modems, and network connections are functioning
properly.</li>
<li>Use the browser to try to view a page at the website you are
attempting to publish to. If you can successfully view other websites but
cannot view a page at the publishing site, your ISP or web hosting
service may be experiencing technical problems.</li>
<li>Try publishing again later. Your ISP, web hosting service, or the web
server may be experiencing temporary technical difficulties.</li>
</ul>
</div>

<div class="errorMessage">
<p id="no_permission"><strong>Error Message</strong>:</p>

<div class="contentsBox" style="background-color: #ebebeb;">
<tt>You do not have permission to publish to this location.</tt>
</div>

<p><strong>Error Description</strong>: You are attempting to publish to a
location that you are not authorized to use. You can only publish to sites
where you have been granted access by your ISP or web hosting service.</p>

<p><strong>Possible Solutions</strong>:</p>

<ul>
<li>Verify that you entered the correct user name and password in the
Publishing Site Settings dialog box, or in the Publish tab of the
Publish dialog box.</li>
<li>Contact your ISP to find out where you can publish your pages at their
site.</li>
<li>Find a web hosting service that you can use to publish your pages. In
the browser, search for <q>web hosting</q>.</li>
</ul>
</div>

<div class="errorMessage">
<p id="offline_error"><strong>Error Message</strong>:</p>

<div class="contentsBox" style="background-color: #ebebeb;">
<tt>You are currently offline. Click the icon near the lower-right corner
of any window to go online.</tt>
</div>

<p><strong>Error Description</strong>: You are attempting to publish, but
your &brandShortName; Internet connection is currently in the
<q>offline</q> state. Your Internet connection must be in the <q>online</q>
state (connected to the Internet) in order to publish your pages.</p>

<p>Verify that your Internet connection is currently offline by looking at
the online/offline icon in the lower right corner of any &brandShortName;
window. If you are currently offline, the icon appears as
<img src="images/offline.png" width="32" height="21" alt="" />.</p>

<p><strong>Possible Solutions</strong>:</p>

<ul>
<li>Click the online/offline icon to go online. In the online state, the
icon should look like this:
<img src="images/online.png" width="32" height="20" alt="" />.</li>
<li>Make sure your Internet connection is working by attempting to view a
web page using the browser. For example, confirm that you can
successfully view the page <tt>http://www.mozilla.org</tt>.</li>
</ul>
</div>

<div class="errorMessage">
<p id="no_disk_space"><strong>Error Message</strong>:</p>

<div class="contentsBox" style="background-color: #ebebeb;">
<tt>There is not enough disk space available to save the file
<var>filename</var>.</tt>
</div>

<p><strong>Error Description</strong>: The remote web server&apos;s hard
disk is full, or you may have exceeded the amount of disk space allocated
to you by your ISP or web hosting service.</p>

<p><strong>Possible Solutions</strong>:</p>

<ul>
<li>Use a separate FTP program to delete unnecessary files at your
particular FTP program. You can usually find information on FTP programs
FTP programs are also available from shareware sites such as ZDNet
<li>Find out from your ISP or web hosting service about increasing your
disk space allocation, or switch to a different service that can satisfy
<li>If the web server is located at your company or school, contact the
network administrator to find out if you can publish to a different
location that has more disk space, or if you can request that
location.</li>
</ul>
</div>

<div class="errorMessage">
<p id="name_too_long"><strong>Error Message</strong>:</p>

<div class="contentsBox" style="background-color: #ebebeb;">
<tt>The filename or subdirectory name is too long.</tt>
</div>

<p><strong>Error Description</strong>: The number of characters in the
filename or the subdirectory name is not supported by the web server
computer that you are trying to publish to.</p>

<p><strong>Possible Solutions</strong>:</p>

<ul>
<li>Limit the length of your filenames and subdirectory names to less than
32 characters. Some operating systems do not support names longer than 32
characters.</li>
</ul>
</div>

section</a>]</p>

<h2 id="publishing_settings">Publishing Settings</h2>

<p>This section describes Composer&apos;s publishing settings. For
information on Composer&apos;s general and new page settings, see
<a href="#composer_preferences">Composer Preferences</a>.</p>

<div class="contentsBox">In this section:
<ul>
<li><a href="#publish_page_publish">Publish Page - Publish</a></li>
<li><a href="#publish_page_settings">Publish Page - Settings</a></li>
<li><a href="#publish_settings">Publish Settings</a></li>
</ul>
</div>

<h3 id="publish_page_publish">Publish Page - Publish</h3>

<p>The Publish Page - Publish tab lets you specify where you want
to publish a document. These settings apply to the current
document.</p>

<p>If you are not already viewing the Publish Page - Publish tab,

<ol>
<li>Open the File menu and choose Publish As. The Publish Page
dialog box appears.</li>
<li>Click the Publish tab.</li>
</ol>

<ul>
<li><strong>Site Name</strong>: Lists all the publishing sites you&apos;ve
created, so you can choose the site that you want to publish to. To
create a new site, click New Site.</li>
<li><strong>Page Title</strong>: Specifies the document&apos;s page title as
it appears in the browser window&apos;s title bar when you view the page in
the browser. The document&apos;s page title also appears in your list of
bookmarks if you bookmark the page.</li>
<li><strong>Filename</strong>: Specifies the document&apos;s filename. Make
sure you include the .html or .htm extension in the filename.

<p><strong>Warning</strong>: If a file on the remote site you&apos;re
newly uploaded file will replace the existing one. You will not be
</li>
blank, Composer publishes the page to the main (root) publishing
directory at this site. If you want to publish the page to a remote
subdirectory that resides underneath the main publishing directory
at this site, enter the name of the subdirectory or choose it from
the list. Composer keeps track of the locations you type here, so
you can select from a list of remote locations you&apos;ve previously
used. Keep in mind that subdirectory names are case-sensitive.

<p><strong>Note</strong>: The site subdirectory you choose must
already exist at the remote server.</p>
</li>
<li><strong>Include images and other files</strong>: If checked,
Composer publishes any images and other files referenced by this
page. You can choose to publish these files to the same location as
the page, or else you can choose to publish these files into a
remote subdirectory that exists underneath the main publishing
directory.</li>
</ul>

<p><strong>Tip</strong>: To create remote subdirectories or delete
published pages or images, you must use an FTP (File Transfer
particular FTP program. You can usually find information on FTP
website. FTP programs are also available from shareware sites such

section</a>]</p>

<h3 id="publish_page_settings">Publish Page - Settings</h3>

<p>The Publish Page - Settings tab lets you specify your login information for
the remote publishing site, as well as the publishing settings for the remote
site. These settings apply to the current document and any other files you
publish to this location.</p>

<p>If you are not already viewing the Publish Page - Settings tab, follow
these steps:</p>

<ol>
<li>Open the File menu and choose Publish As. The Publish Page dialog box
appears.</li>
<li>Click the Settings tab.</li>
</ol>

<ul>
<li><strong>Site Name</strong>: Specifies the nickname you want to use for
this publishing site. Enter a short name that will help you identify this
publishing site.</li>
<li><strong>Publishing address</strong>: Specifies the complete URL provided
to you by your ISP or system administrator. This URL should begin with
either <tt>ftp://</tt> or <tt>http://</tt>. This name is often referred to
as the <q>host name</q> or the <q>host server name</q>.

<p>The publishing address specifies the location where documents are
published (uploaded) at this site. If you are not sure what to enter,
</li>
part of the URL.

<p>This URL must always begin with <tt>http://</tt>. In some cases, this
URL is the same as the publishing address. If you are not sure what to
</li>
name.</li>
<li><strong>Save Password</strong>: Select this to encrypt and save your
enter it each time you publish pages at this site.</li>
</ul>

section</a>]</p>

<h3 id="publish_settings">Publish Settings</h3>

<p>The Publish Settings dialog box lets you create, edit, and
delete publishing site settings, and also lets you set the default
publishing site.</p>

<p>If you are not already viewing the Publish Settings dialog box,

<ol>
<li>Open the Edit menu and choose Publishing Site Settings.
Composer displays the Publish Settings dialog box.</li>
</ol>

<ul>
<li><strong>New Site</strong>: Lets you specify settings for a new publishing
site. Composer adds the name of the new publishing site to the list
of available publishing sites.</li>
<li><strong>Set as Default</strong>: Sets the selected publishing site as the
default publishing site. Typically, the default publishing site is
the remote location that you most often use for publishing
documents. All documents you create or edit will be published to
the default publishing site, unless you specifically choose an
alternate site in the Publish Page dialog box.

<p>To publish a document to a different remote location, open the
File menu and choose Publish As to choose a different publishing
destination.</p>
</li>
<li><strong>Remove Site</strong>: Removes the selected site and its settings
from Composer.</li>
<li><strong>Site Name</strong>: Specifies the name by which you want to refer
to this publishing site.</li>
<li><strong>Publishing address</strong>: Specifies the complete URL provided
to you by your ISP or system administrator. This URL should begin
with either <tt>ftp://</tt> or <tt>http://</tt>.

<p>The publishing address specifies the location where documents
are published (uploaded) at this site. If you are not sure what to
</li>
filename or subdirectory as part of the URL.

<p>This URL must always begin with <tt>http://</tt>. In some cases,
this URL is the same as the publishing address. If you are not sure
it blank.</p>
</li>
<li><strong>User name</strong>: Specifies the user name you use to log in to
name.</li>
<li><strong>Save Password</strong>: Select this to save your
it each time you publish pages at this site.</li>
</ul>

section</a>]</p>

<h1 id="composer_preferences">Composer Preferences</h1>

<p>This section describes the settings in the Composer preferences panel. If
you are not currently viewing the panel, follow these steps:</p>

<ol>
<li>Open the <span class="mac">&brandShortName;</span>
<span class="noMac">Edit</span> menu and choose Preferences.</li>
<li>Double-click the Composer category to expand the list.</li>
</ol>

<p>For information on Composer&apos;s publishing settings, see
<a href="#publishing_settings">Publishing Settings</a>.</p>

<div class="contentsBox">In this section:
<ul>
<li><a href="#composer">Composer</a></li>
<li><a href="#new_page_settings">New Page Settings</a></li>
</ul>
</div>

<h2 id="composer">Composer Preferences - Composer</h2>

<p>Composer preferences allow you to specify settings for saving files and for
table editing. These settings apply to every document you create.</p>

steps:</p>

<ol>
<li>Open the <span class="mac">&brandShortName;</span>
<span class="noMac">Edit</span> menu and choose Preferences.</li>
<li>Click the Composer category.</li>
</ol>

<ul>
<li><strong>Maximum number of pages listed</strong>: Specify the maximum
number of pages that are listed under Recent Pages in the File menu.</li>
<li><strong>Preserve original source formatting</strong>: Select this if you
want to preserve the original white space (extra lines, tabs, etc.) in the
HTML source code. Deselect this if you prefer Composer to indent and add
linebreaks to the code in order to make it more readable. <em>This
preference does not affect how your pages appear in a browser
window.</em></li>
<li><strong>Save images and other associated files when saving
pages</strong>: If checked, all images, JavaScript (JS), Cascading Style
Sheet (CSS), and other associated files are saved in the same location as
the document when the document is saved for the first time or when the
document is saved to a new location. If unchecked, only the HTML file is
saved.

<p>For example, when editing a remote page, this setting ensures that all
related files associated with the remote page will be saved locally when
you save the page to your hard disk.</p>
</li>
<li><strong>Always show Publish dialog when publishing pages</strong>: If
checked, Composer always displays the Publish Page dialog box when you
click the Publish button or choose Publish from the File menu. If not
checked, Composer only displays the Publish Page dialog box if it needs
<li><strong>Maintain table layout when inserting or deleting cells</strong>:
Select this if you want Composer to always preserve the table&apos;s
layout (that is, keep it in a rectangular shape) by adding cells where
needed. If you deselect this option, when you delete one or more cells,
Composer removes the cell border as well, which can result in a table with
empty spaces, or an outline that appears irregular due to an uneven number
of cells.</li>
<li><strong>Use CSS styles instead of HTML elements and attributes</strong>:
Enables the use of Cascading Style Sheet (CSS) formatting in your Composer
documents. With this preference enabled, Composer generates HTML 4.01
formatting with CSS inline styles for elements.

<p>If this preference is not enabled, Composer generates HTML 4.01
formatting, but does not use CSS styles.</p>

<p>Compared to HTML, HTML with CSS formatting is more portable, more
maintainable, and more compatible when viewed with different browsers.
If you enable this preference and then edit a document created without
CSS, Composer replaces the edited elements with CSS styles.</p>

<p>If you enable CSS styles, you can choose a text highlight color for
selected text using the text highlight color button on the Format
toolbar. You can also choose a color background for any element on the
page. (These features are not available if this preference is not
enabled.)</p>
</li>
<li><strong><kbd class="mac">Return</kbd><kbd class="noMac">Enter</kbd> in a
paragraph always creates a new paragraph</strong>: If selected, a new
paragraph will be added everytime you press the <kbd class="mac">Return
</kbd><kbd class="noMac">Enter</kbd> key inside a paragraph. If
deselected, a linebreak will be added when you press the <kbd
class="mac">Return</kbd><kbd class="noMac">Enter</kbd> key.</li>
</ul>

<h2 id="new_page_settings">Composer Preferences - New Page Settings</h2>

<p>New page preferences allow you to specify settings for colors and
background images that apply to every document you create.</p>

<p>If you are not already viewing the New Page Settings, follow these
steps:</p>

<ol>
<li>Open the <span class="mac">&brandShortName;</span>
<span class="noMac">Edit</span> menu and choose Preferences.</li>
<li>Double-click the Composer category and click New Page Settings.</li>
</ol>

<ul>
HTML source code for each new page you create.</li>
<li><strong>Reader&apos;s default colors</strong>: Select this if you always
want your pages to use the color settings from the viewer&apos;s browser
<li><strong>Use custom colors</strong>: Select this if you always want to
specify the colors that are applied to text and link elements. Then for
each element, select a color by clicking the color button next to each
element.</li>
<li><strong>Background image</strong>: Type the location and name of an image
file, or click Choose File to locate the image file on your hard disk or
network.

<p><strong>Note</strong>: Background images are tiled and override
background color.</p>
</li>
</ul>

<p>To change the author name for an individual page: Open the Format menu and
choose Page Title and Properties.</p>

<p>To change the page colors and background image for an individual page: Open
the Format menu and choose Page Colors and Background.</p>