diff options
Diffstat (limited to 'l10n-an/suite/chrome/common/help/composer_help.xhtml')
| -rw-r--r-- | l10n-an/suite/chrome/common/help/composer_help.xhtml | 2494 |
1 files changed, 2494 insertions, 0 deletions
diff --git a/l10n-an/suite/chrome/common/help/composer_help.xhtml b/l10n-an/suite/chrome/common/help/composer_help.xhtml new file mode 100644 index 0000000000..c0eabe63f1 --- /dev/null +++ b/l10n-an/suite/chrome/common/help/composer_help.xhtml @@ -0,0 +1,2494 @@ +<?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"> +<head> +<title>Creating Web Pages with &brandShortName; Composer</title> +<link rel="stylesheet" href="helpFileLayout.css" + type="text/css"/> +</head> +<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'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" width="128" height="23" + alt="" /></div> +<div style="-moz-margin-start: 80px;"><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> + <li><a href="#formatting_your_web_pages">Formatting Your Web Pages</a></li> + <li><a href="#adding_tables_to_your_web_page">Adding Tables to Your Web + Page</a></li> + <li><a href="#adding_images_to_your_web_page">Adding Pictures (Images) to + Your Web Page</a></li> + <li><a href="#setting_page_properties">Setting Page Properties</a></li> + <li><a href="#creating_links_in_composer">Creating Links in + Composer</a></li> + <li><a href="#publishing_your_pages_on_the_web">Publishing Your Pages on + 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're creating it. It is not necessary for you to know + HTML, since most of the basic HTML functions are available as commands from + the toolbars and menus.</p> + +<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 + <HTML> 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'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're currently viewing in the + browser</strong>:</p> + +<ul> + <li>In the browser window of the page you're viewing, open the File + menu and choose Edit Page. You see a Composer window that contains the + page you're viewing.</li> +</ul> + +<p><strong>To create a new page in Composer</strong>:</p> + +<ul> + <li>Click the New button in Composer'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've been working on by opening the File menu, choosing + Recent Pages, and then selecting the file you want from the list.</p> + +<p>[<a href="#starting_a_new_page">Return to beginning of section</a>]</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'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'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. + + <p>If you haven't already given your page a title, Composer prompts + you to do so. Composer displays the page title in the browser + window's title bar when you view the page in the browser. The + document'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 + <a href="#composer">Composer Preferences - Composer</a> for more information + on changing Composer'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'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're working. Keep in mind that your current changes will be lost.</p> + +<p>To view your page in a browser window in order to test your links:</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> + +<p>[<a href="#starting_a_new_page">Return to beginning of section</a>]</p> + +<h1 id="formatting_your_web_pages">Formatting Your Web Pages</h1> + +<div class="contentsBox">In this section: + <ul> + <li><a href="#formatting_paragraphs_headings_and_lists">Formatting + Paragraphs, Headings, and Lists</a></li> + <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> + +<h2 id="formatting_paragraphs_headings_and_lists">Formatting Paragraphs, + Headings, and Lists</h2> + +<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>Heading 1</strong> - <strong>Heading 6</strong>: Formats the + paragraph as a heading. Heading 1 is the highest-level heading, while + Heading 6 is the lowest-level heading.</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 + more information, for example: <tt>user@example.com</tt> + + <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> + for your main heading, <q>Heading 2</q> for the next level, and so + 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> + +<p>[<a href="#formatting_your_web_pages">Return to beginning of + 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> + +<p>To merge two adjacent lists:</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> + +<p>[<a href="#formatting_your_web_pages">Return to beginning of + 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'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'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> + +<p>[<a href="#formatting_your_web_pages">Return to beginning of + 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> + +<p>[<a href="#formatting_your_web_pages">Return to beginning of + section</a>]</p> + +<h2 id="finding_and_replacing_text">Finding and Replacing Text</h2> + +<p>To find text in the page you'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'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'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> + +<p>[<a href="#formatting_your_web_pages">Return to beginning of + 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's height, length, width, alignment, and + shading.</p> + +<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's width changes whenever the Composer window's + or browser window's width changes.</li> + <li><strong>Height</strong>: Type a number for the line's height + (in pixels).</li> + <li><strong>3-D Shading</strong>: Select this to add depth to the line + by adding a bevel shading.</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, + <a href="#using_the_advanced_property_editor">Advanced Property Editor</a>, + 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 + <a href="#using_the_advanced_property_editor">Advanced Property Editor</a> + dialog box for that HTML tag or element.</p> + +<p>[<a href="#formatting_your_web_pages">Return to beginning of + 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> + +<p>[<a href="#formatting_your_web_pages">Return to beginning of + 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'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 <HTML> + Source tab in the Edit Mode toolbar at the bottom of the Composer window. + (If you don'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> + +<h3 id="using_the_advanced_property_editor">Using the Advanced Property + 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's best not to do + so.</p> + +<p>If you are not currently viewing the Advanced Property Editor dialog box, + follow these steps:</p> + +<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> + <li>Click Advanced Edit to open the object's Advanced Property Editor. + 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 + additional HTML attributes.</li> + <li><strong>Inline Style</strong>: Click this tab to view or enter + additional CSS (cascading style sheet) properties through the + <style> attribute. For more information on using CSS styles + 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'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> + +<p>[<a href="#formatting_your_web_pages">Return to beginning of + 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'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'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'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'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> + +<p>[<a href="#formatting_your_web_pages">Return to beginning of + section</a>]</p> + +<h2 id="choosing_the_right_editing_mode">Choosing the Right Editing Mode</h2> + +<p>Typically, you won't need to change the editing mode from the default + (Normal). However, if you want to work with the document'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><HTML> 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> + +<p>[<a href="#formatting_your_web_pages">Return to beginning of + section</a>]</p> + +<h1 id="adding_tables_to_your_web_page">Adding Tables to Your Web Page</h1> + +<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's + Properties</a></li> + <li><a href="#adding_and_deleting_rows_columns_and_cells">Adding and + 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> + <li>To apply additional table attributes or JavaScript, click Advanced Edit + to display the + <a href="#using_the_advanced_property_editor">Advanced Property Editor</a>. + </li> + <li>Click OK to confirm your settings and view your new table.</li> +</ol> + +<p>To change additional properties for your new table, see + <a href="#changing_a_tables_properties">Changing a Table's + Properties</a>. +</p> + +<p><strong>Tip</strong>: To insert a table within a table, open the + Insert menu and choose Table.</p> + +<p>[<a href="#adding_tables_to_your_web_page">Return to beginning of + section</a>]</p> + +<h2 id="changing_a_tables_properties">Changing a Table'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's width changes whenever the Composer window's or + browser window'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> + <li>To apply additional attributes or JavaScript events, click Advanced Edit + to display the <a href="#using_the_advanced_property_editor">Advanced + 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'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 + <a href="#using_the_advanced_property_editor">Advanced Property + 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> + +<p>[<a href="#adding_tables_to_your_web_page">Return to beginning of + section</a>]</p> + +<h2 id="adding_and_deleting_rows_columns_and_cells">Adding and Deleting Rows, + 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 + you perform editing tasks.</p> + +<p>To add a cell, row, or column to your table:</p> + +<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'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'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't get an + irregularly shaped table.</li> + </ul> + </li> + <li class="win">Click OK.</li> +</ol> + +<p>[<a href="#adding_tables_to_your_web_page">Return to beginning of + 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 + select additional adjacent columns or rows. Press <kbd>Shift</kbd> + 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> + +<p>[<a href="#adding_tables_to_your_web_page">Return to beginning of + 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'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> + +<p>[<a href="#adding_tables_to_your_web_page">Return to beginning of + 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'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> + +<p>[<a href="#adding_tables_to_your_web_page">Return to beginning of + section</a>]</p> + +<h1 id="adding_images_to_your_web_page">Adding Pictures (Images) to Your Web + Page</h1> + +<div class="contentsBox">In this section: + <ul> + <li><a href="#inserting_an_image_into_your_page">Inserting an Image into + Your Page</a></li> + <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 + <a href="#using_images_as_links">create links</a>. When you insert an image, + 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's best not to use BMP images in your pages.</p> + +<p><strong>Tip</strong>: It'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 + loading or when image loading is disabled. + + <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 + your page.</p> + +<p><strong>Tip</strong>: To insert a line break after all images in a + paragraph, choose Break Below Images from the Insert menu.</p> + +<p>[<a href="#adding_images_to_your_web_page">Return to beginning of + section</a>]</p> + +<h2 id="editing_image_properties">Editing Image Properties</h2> + +<p>Once you'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'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's a good practice to specify + alternate text for readers who use text-only web browsers or who have + image loading turned off.</li> + <li><strong>Don't use alternate text</strong>: Choose this option + if the image does not require alternate text or if you don'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'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't affect the original image file, just the image inserted + in your page.</li> + <li><strong>Constrain</strong>: If you change the image size, it's + a good idea to select this in order to maintain the image's aspect + ratio (so that it doesn'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'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'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> + <li>To apply additional attributes or JavaScript events, click Advanced Edit + to display the + <a href="#using_the_advanced_property_editor">Advanced Property Editor</a>. + </li> + <li>Click OK to confirm your changes.</li> +</ol> + +<p>[<a href="#adding_images_to_your_web_page">Return to 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'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 + that conveys what your page is about.</li> + <li><strong>Author</strong>: Type the name of the person who created the + document. This information is helpful to readers who locate the + document by using a web search tool to search on name. + + <p><strong>Tip</strong>: If you enter the Author name in + Composer's <a href="#new_page_settings">preferences</a>, then + you won'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's contents.</li> + </ul> + </li> +</ol> + +<p>[<a href="#setting_page_properties">Return to beginning of section</a>]</p> + +<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'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's default colors</strong>: Select this if you + want your page to use the color settings from the viewer's browser + for text and links.</li> + <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'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 + <a href="#using_the_advanced_property_editor">Advanced Property + 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> + +<p>[<a href="#setting_page_properties">Return to beginning of section</a>]</p> + +<h1 id="creating_links_in_composer">Creating Links in Composer</h1> + +<div class="contentsBox">In this section: + <ul> + <li><a href="#creating_links_within_the_same_page">Creating Links Within + the Same Page</a></li> + <li><a href="#creating_links_to_other_pages">Creating Links to Other + Pages</a></li> + <li><a href="#using_images_as_links">Using Images as Links</a></li> + <li><a href="#removing_or_discontinuing_links">Removing or Discontinuing + Links</a></li> + </ul> +</div> + +<h2 id="creating_links_within_the_same_page">Creating Links Within the Same + Page</h2> + +<p>To create a link within the same page, for example a link that the reader + 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, + follow these steps:</p> + +<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's location: + <img src="images/anchor-in-doc.gif" width="20" height="17" alt="" /></li> +</ol> + +<p>To create the link on which readers can click to jump to the object:</p> + +<ol> + <li>Select the text or image that you want to link to the anchor.</li> + <li>Click the Link button or open the Insert menu and choose Link. You see + the Link Properties dialog box. + <ul> + <li>If you're creating a link to an HTML file on your computer, + click Choose File to locate it.</li> + <li>If you're creating a link to a named anchor (target), select + it from the list of the anchors currently available in the page.</li> + <li>If you're creating a link to a level heading (for example, + Heading 1 - Heading 6), select it from the list of headings currently + 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 + menu and choose Browse Page, then click the link.</p> + +<p><strong>Tip</strong>: If you did not first create named anchors, you can + use the Link dialog box to create links to headings that already occur in + the page.</p> + +<p>[<a href="#creating_links_in_composer">Return to beginning of + section</a>]</p> + +<h2 id="creating_links_to_other_pages">Creating Links to Other Pages</h2> + +<p>You can create links from your page to local pages on your own computer or + on your workplace's network, or to remote pages on the Internet.</p> + +<p><strong>Tip</strong>: It'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> + <li>Click the Link button. You see the Link Properties dialog box.</li> + <li>Define your link: + <ul> + <li><strong>Link text</strong>: If you've already selected an image + 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'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'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'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> + <li>To apply additional attributes or JavaScript events, click Advanced Edit + to display the + <a href="#using_the_advanced_property_editor">Advanced Property Editor</a>. + </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 + link location into the Link Location field in the Link Properties dialog + box.</p> + +<p>[<a href="#creating_links_in_composer">Return to beginning of + section</a>]</p> + +<h2 id="using_images_as_links">Using Images as Links</h2> + +<p>You can make images, such as JPEG, GIF, or PNG files, behave like links in + your pages. When the reader clicks a linked image, the browser window + 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> + <li>Click the Link button + <img src="images/link.gif" width="22" height="20" alt="" /> + on the toolbar, or open the Insert menu and choose Link.</li> + <li>Use the Link Properties dialog box to link the image to a + <a href="#creating_links_within_the_same_page">named anchor or heading + 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 + images used as links:</p> + +<ol> + <li>Select the linked image.</li> + <li>Open the Format menu and choose Image and Link Properties.</li> + <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> + +<p>[<a href="#creating_links_in_composer">Return to beginning of + section</a>]</p> + +<h2 id="removing_or_discontinuing_links">Removing or Discontinuing Links</h2> + +<p>To remove a link:</p> + +<ol> + <li>Select the linked text (normally blue and underlined) or image.</li> + <li>Open the Format menu and choose Remove Links.</li> +</ol> + +<p>To discontinue a link, so that text you type after the link is not included + as part of the link:</p> + +<ol> + <li>Click to place the insertion point where you want the link to end.</li> + <li>Open the Format menu and choose Discontinue Link.</li> +</ol> + +<p>[<a href="#creating_links_in_composer">Return to beginning of + section</a>]</p> + +<h1 id="publishing_your_pages_on_the_web">Publishing Your Pages on the Web</h1> + +<p>If your pages exist only on your local hard disk, you can browse your pages, + 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 + where you can publish your pages, ask your ISP, help desk, or system + administrator.</p> + +<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'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're ready to publish the document remotely, click the + Publish button. + + <p>If you have published this document before, Composer remembers the + document'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's remote publishing location. See + <a href="#publish_page_settings">Publish Page - Settings</a> for more + information. When you'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'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's links and make sure there are no missing images.</li> + <li>Continue editing the page as necessary. When you'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'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's hard disk), click the Save button. + You'll be prompted to choose a filename and location on your hard disk + for the document.</p> + +<p>[<a href="#publishing_your_pages_on_the_web">Return to beginning of + section</a>]</p> + +<h3 id="tips_for_avoiding_broken_links_or_missing_images">Tips for Avoiding + Broken Links or Missing Images</h3> + +<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'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> + +<p>[<a href="#publishing_your_pages_on_the_web">Return to beginning of + 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's HTTP + address (the document's web address) in the browser's + Location Bar.</p></li> + <li>Edit the document as necessary.</li> + <li>When you're ready to update the remote page with your changes, click + Publish in Composer's toolbar.</li> +</ol> + +<p><strong>Tip</strong>: To delete a page or image you'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 + subdirectories or to rename files on the web server. Ask your service + provider if they recommend a particular FTP program. You can usually find + information on FTP programs in the Help or Support sections of your service + provider's website. FTP programs are also available from shareware sites + such as ZDNet Downloads.</p> + +<p>[<a href="#publishing_your_pages_on_the_web">Return to beginning of + section</a>]</p> + +<h2 id="changing_the_filename_or_publishing_location">Changing the Filename or + Publishing Location</h2> + +<p>To change a document'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's HTTP address (the document's web + address) in the browser's Location Bar.</p> + </li> + <li>Edit the document as necessary.</li> + <li>Open Composer'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> + +<p>[<a href="#publishing_your_pages_on_the_web">Return to beginning of + 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'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 + you by your ISP, system administrator, or web hosting service. This + 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, + ask your ISP or system administrator.</p> + </li> + <li>For <q>HTTP address of your home page</q>, enter the complete URL + 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 + what to enter, ask your ISP or system administrator, or else leave + it blank.</p> + </li> + <li>For <q>user name</q>, enter the user name you use to log in to your ISP + or web hosting service.</li> + <li>For <q>password</q>, enter the password for your user name.</li> + <li>Select <q>Save Password</q> to save your password securely using + Password Manager so that you don't have to enter it each time you + publish pages at this site.</li> + <li>Click OK.</li> +</ol> + +<p>[<a href="#publishing_your_pages_on_the_web">Return to beginning of + 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've set up, you can always publish a + document to a different site by choosing Publish As from Composer's + File menu. See + <a href="#changing_the_filename_or_publishing_location">Changing the Filename + or Publishing Location</a> for more information.</p> + +<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> + +<p>[<a href="#publishing_your_pages_on_the_web">Return to beginning of + section</a>]</p> + +<h2 id="deleting_a_publishing_site">Deleting a Publishing Site</h2> + +<p>Deleting a publishing site removes the site's settings from Composer. + If you later wish to publish to the site, you must re-enter the site's + settings.</p> + +<p>To delete a publishing site'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's settings; the remote site itself + is not affected.</p> + </li> + <li>Click OK to confirm your changes.</li> +</ol> + +<p>[<a href="#publishing_your_pages_on_the_web">Return to beginning of + 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 + Status dialog box displays an error message that can help you + 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'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's File menu, and + choose Recent Pages.</p> + +<div class="contentsBox">In this section: + <ul> + <li><a href="#verifying_your_publishing_settings">Verifying Your Publishing + Settings</a></li> + <li><a href="#checking_your_filenames">Checking Your Filenames</a></li> + <li><a href="#fixing_publishing_errors">Fixing Publishing Errors</a></li> + </ul> +</div> + +<h3 id="verifying_your_publishing_settings">Verifying Your Publishing + Settings</h3> + +<p>To verify your publishing settings:</p> + +<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'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 + <tt>ftp.myisp.com/username</tt>, where <tt>username</tt> is your + 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 + site would be <tt>ftp://ftp.myisp.com/username</tt>.</p> + </li> + </ul> + </li> +</ol> + +<h3 id="checking_your_filenames">Checking Your Filenames</h3> + +<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's + acceptable to create filenames that use uppercase letters, you can avoid + potential errors in later locating the published file if you only use + lowercase letters in your filenames. + + <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's web address into the browser'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'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>Filename</var> not found.</tt></a></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'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;"> + <tt><var>Filename</var> not found.</tt> + <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's location on the web is not accessible.</li> + <li>The file'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's address, double-click the broken + image to display the Image Properties dialog box so you can enter the + correct address.</li> + <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> + on your keyboard.</li> + <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's address in Composer, + click the HTML Source tab and edit the file'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'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 + subdirectories at the publishing site. Ask your service provider if they + recommend a particular FTP program. You can usually find information on + FTP programs in the Help or Support sections of your service + provider's website. FTP programs are also available from shareware + sites such as ZDNet Downloads.</li> + <li>Don'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 + <a href="#verifying_your_publishing_settings">Verifying Your Publishing + Settings</a> for more information.</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> + <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'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 + publishing site. Ask your service provider if they recommend a + particular FTP program. You can usually find information on FTP programs + in the Help or Support sections of your service provider's website. + FTP programs are also available from shareware sites such as ZDNet + Downloads.</li> + <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 + your needs.</li> + <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 + additional disk space be allocated to your current publishing + 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> + +<p>[<a href="#publishing_your_pages_on_the_web">Return to beginning of + section</a>]</p> + +<h2 id="publishing_settings">Publishing Settings</h2> + +<p>This section describes Composer's publishing settings. For + information on Composer'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, + follow these steps:</p> + +<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'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's page title as + it appears in the browser window's title bar when you view the page in + the browser. The document's page title also appears in your list of + bookmarks if you bookmark the page.</li> + <li><strong>Filename</strong>: Specifies the document'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're + publishing to has the same filename as one you're uploading, the + newly uploaded file will replace the existing one. You will not be + asked to confirm the action.</p> + </li> + <li><strong>Site subdirectory for this page</strong>: If you leave this + 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'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 + Protocol) program. Ask your service provider if they recommend a + particular FTP program. You can usually find information on FTP + programs in the Help or Support sections of your service provider's + website. FTP programs are also available from shareware sites such + as ZDNet Downloads.</p> + +<p>[<a href="#publishing_your_pages_on_the_web">Return to beginning of + 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, + ask your ISP or system administrator.</p> + </li> + <li><strong>HTTP address of your home page</strong>: Specifies the complete + address of your publishing home directory. This is the web address of the + home page at your website. 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 what to + enter, ask your ISP or system administrator, or else leave it blank.</p> + </li> + <li><strong>User name</strong>: Specifies the user name you use to log into + your ISP or network.</li> + <li><strong>Password</strong>: Specifies the password for your user + name.</li> + <li><strong>Save Password</strong>: Select this to encrypt and save your + password securely using Password Manager so that you don't have to + enter it each time you publish pages at this site.</li> +</ul> + +<p>[<a href="#publishing_your_pages_on_the_web">Return to beginning of + 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, + follow these steps:</p> + +<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 + enter, ask your ISP or system administrator.</p> + </li> + <li><strong>HTTP address of your homepage</strong>: Specifies the HTTP + address of your publishing home directory. 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 + what to enter, ask your ISP or system administrator, or else leave + it blank.</p> + </li> + <li><strong>User name</strong>: Specifies the user name you use to log in to + your ISP or network.</li> + <li><strong>Password</strong>: Specifies the password for your user + name.</li> + <li><strong>Save Password</strong>: Select this to save your + password securely using Password Manager so you don't have to enter + it each time you publish pages at this site.</li> +</ul> + +<p>[<a href="#publishing_your_pages_on_the_web">Return to beginning of + 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'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> + +<p>If you are not already viewing the Composer preferences, follow these + 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 + more information in order to publish the page.</li> + <li><strong>Maintain table layout when inserting or deleting cells</strong>: + Select this if you want Composer to always preserve the table'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> + +<p>[<a href="#composer_preferences">Return to beginning of section</a>]</p> + +<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> + <li><strong>Author</strong>: Enter your name. This will add your name to the + HTML source code for each new page you create.</li> + <li><strong>Reader's default colors</strong>: Select this if you always + want your pages to use the color settings from the viewer's browser + for text and link elements.</li> + <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> + +<p>[<a href="#composer_preferences">Return to beginning of section</a>]</p> + +</body> +</html> |