From 0a890b9fff1b9c3f124b6aea31293a66046925ca Mon Sep 17 00:00:00 2001 From: "kairo%kairo.at" Date: Wed, 18 Oct 2006 13:14:01 +0000 Subject: [PATCH] bug 356650 - Cleanup composer_help, p=giacomo.magnini@portalis.it r=IanN --- .../chrome/common/help/composer_help.xhtml | 455 +++++++++++------- 1 file changed, 279 insertions(+), 176 deletions(-) diff --git a/suite/locales/en-US/chrome/common/help/composer_help.xhtml b/suite/locales/en-US/chrome/common/help/composer_help.xhtml index fa1e2cd707d0..13758d174a64 100644 --- a/suite/locales/en-US/chrome/common/help/composer_help.xhtml +++ b/suite/locales/en-US/chrome/common/help/composer_help.xhtml @@ -14,7 +14,8 @@ -

Creating Web Pages with &brandShortName; Composer

+

Creating Web Pages with + &brandShortName; Composer

&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 @@ -33,18 +34,23 @@ &brandShortName; window. -

+
Composer icon
In this section:
@@ -54,7 +60,8 @@
In this section:
@@ -125,7 +132,8 @@

[Return to beginning of section]

-

Saving and Browsing Your New Page

+

Saving and Browsing Your New + Page

You can save Composer documents in HTML or text-only format. Saving a document in HTML format preserves the document's formatting, such @@ -200,20 +208,29 @@

In this section:
-

Formatting Paragraphs, Headings, and Lists

+

Formatting Paragraphs, + Headings, and Lists

To apply a format to a paragraph, begin from the Composer window:

@@ -257,7 +274,8 @@ want to format.
  • Using the drop-down list in the Format toolbar, choose the level of heading you want, from 1 (largest) to 6 (smallest). Choose Heading 1 - for your main heading, Heading 2 for the next level, and so forth.
    • + for your main heading, Heading 2 for the next level, and so + forth.

    To apply a list item format:

    @@ -315,7 +333,8 @@

    Note: You can also use the Format toolbar to align text.

    -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    Working with Lists

    @@ -340,12 +359,13 @@
    1. Click to place the insertion point within the list item.
      2. -
    2. Press Shift+Return - Enterto create the hanging indent.
      3. +
    3. Press Shift+ReturnEnterto create the hanging indent.
    4. Type the text you want to indent.
      5. -
    5. Press Shift+Return - Enter to create another indented paragraph, or - press Return to create the next list item.
      6. +
    6. Press Shift+ReturnEnter to create another indented paragraph, or press + ReturnEnter to create the + next list item.

    Tip: You can increase or decrease the indentation of list @@ -364,9 +384,11 @@ merge the lists. -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    -

    Changing Text Color, Style, and Font

    +

    Changing Text Color, Style, and + Font

    To change the style, color, or font of selected text:

    @@ -422,11 +444,14 @@ color for separate lines of text.

    You can also use an image as a background. See - Setting Page Colors and Backgrounds.

    + Setting Page Colors and + Backgrounds.

    -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    -

    Removing or Discontinuing Text Styles

    +

    Removing or Discontinuing Text + Styles

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

    @@ -445,14 +470,16 @@
  • Continue typing.
    • -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    Finding and Replacing Text

    To find text in the page you're currently working on:

      -
    1. Click to place the insertion point where you want to begin your search.
      2. +
    2. Click to place the insertion point where you want to begin your + search.
    3. Open the Edit menu and choose Find and Replace. You see the Find and Replace dialog box.
    4. Type the text you want to locate in the Find what field. To narrow @@ -468,14 +495,16 @@
    5. Click Find Next to begin searching. When Composer locates the first - occurrence of the text, click Find Next to search for the next occurrence.
      6. + occurrence of the text, click Find Next to search for the next + occurrence.
    6. Click Close when you are done.

    To find and replace text in the page you're currently working on:

      -
    1. Click to place the insertion point where you want to begin your search.
      2. +
    2. Click to place the insertion point where you want to begin your + search.
    3. Open the Edit menu and choose Find and Replace. You see the Find and Replace dialog box.
    4. Type the text you want to find and then type the replacement text.
      5. @@ -500,7 +529,8 @@
    5. Click Close when you are done.
    -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    Inserting Horizontal Lines

    @@ -509,13 +539,16 @@ in your page, begin from the Composer window:

      -
    1. Click to place the insertion point where you want the line to appear.
      2. +
    2. Click to place the insertion point where you want the line to + appear.
    3. Open the Insert menu and choose Horizontal Line.
    -

    Setting Horizontal Line Properties

    +

    Setting Horizontal Line + Properties

    -

    You can customize a line's height, length, width, alignment, and shading.

    +

    You can customize a line's height, length, width, alignment, and + shading.

    1. Double-click the line to display the Horizontal Line Properties dialog @@ -523,7 +556,7 @@
    2. Edit any of these properties:
      • Width: Enter the width and then choose % of - window or pixels. If you specify width as a percentage, + window or pixels. If you specify width as a percentage, the line's width changes whenever the Composer window's or browser window's width changes.
      • Height: Type a number for the line's height @@ -542,14 +575,15 @@ for details.
    -

    Tip: You can select HTML Tags from the View menu to +

    Tip: You can select HTML Tags 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 Advanced Property Editor dialog box for that HTML tag or element.

    -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    Inserting Special Characters

    @@ -575,14 +609,17 @@
  • Click Insert.

    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.

    + while you keep this dialog box open, in case you want to use it + again.

  • Click Close when you are done inserting special characters.
    • -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    -

    Inserting HTML Elements and Attributes

    +

    Inserting HTML Elements and + Attributes

    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 @@ -605,7 +642,8 @@ Show/Hide; then make sure the Edit Mode Toolbar is checked.) -

    Using the Advanced Property Editor

    +

    Using the Advanced Property + Editor

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

    @@ -654,7 +692,8 @@

    Composer automatically places quotation marks around any attribute text.

    -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    Validating the HTML

    @@ -684,7 +723,8 @@
  • Click Validate this document.
    • -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    Choosing the Right Editing Mode

    @@ -726,18 +766,23 @@ state, click the Browse button on the Composition toolbar to load the page into a browser window.

    -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    Adding Tables to Your Web Page

    In this section:
    @@ -772,13 +817,15 @@

    To change additional properties for your new table, see - Changing a Table's Properties. + Changing a Table's + Properties.

    Tip: To insert a table within a table, open the Insert menu and choose Table.

    -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    Changing a Table's Properties

    @@ -797,7 +844,7 @@
  • To apply additional attributes or JavaScript events, click Advanced Edit - to display the - Advanced Property Editor. + to display the Advanced + Property Editor.
  • Click Apply to preview your changes without closing the dialog box, or click OK to confirm them.
    • @@ -835,7 +882,7 @@ drop-down list. Click Previous or Next to move through rows, columns, or cells.
  • Size: Type a number for Height and Width, and then - choose % of table or pixels.
    • + choose % of table or pixels.
  • Content Alignment: Select a vertical and horizontal alignment type for the text or data inside each cell.
  • Cell Style: Select Header from the drop-down list @@ -849,7 +896,8 @@

    Note: To apply additional attributes or JavaScript events, click Advanced Edit to display the - Advanced Property Editor + Advanced Property + Editor

    • @@ -867,9 +915,11 @@ 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.

    -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    -

    Adding and Deleting Rows, Columns, and Cells

    +

    Adding and Deleting Rows, + Columns, and Cells

    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 @@ -924,7 +974,8 @@ for information on how to select non-adjacent cells, rows, and columns.

    -

    Changing the Default Table Editing Behavior

    +

    Changing the Default Table + Editing Behavior

    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 @@ -950,7 +1001,8 @@

    See also Setting General Composer Preferences.

    -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    Selecting Table Elements

    @@ -982,9 +1034,11 @@ -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    -

    Moving, Copying, and Deleting Tables

    +

    Moving, Copying, and Deleting + Tables

    To move a table:

    @@ -1000,7 +1054,8 @@ then choose Table. -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    Converting Text into a Table

    @@ -1025,18 +1080,22 @@

    Note: Text formatting is removed when the selected text is converted to a table.

    -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    -

    Adding Pictures (Images) to Your Web Page

    +

    Adding Pictures (Images) to Your Web + Page

    In this section:
    -

    Inserting an Image into Your Page

    +

    Inserting an Image into Your + Page

    You can insert GIF, JPEG, BMP, and PNG (Portable Network Graphics) images into your web page. You can also use them to @@ -1078,7 +1137,8 @@

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

    -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    Editing Image Properties

    @@ -1087,8 +1147,6 @@ width, spacing, and text alignment. If you are not currently viewing the Image Properties dialog box, follow these steps:

    -

    To edit the properties for a selected image:

    -
    1. Double-click the image, or select it and click the Image button on the toolbar @@ -1107,7 +1165,8 @@

      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).

      + images on other web servers (not stored locally on your hard + disk).

      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 @@ -1163,7 +1222,7 @@

    2. Enter a web page location: 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 an image file on your hard drive or network.
      3. + File to search for a file on your hard drive or network.
    3. URL is relative to page location: 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 @@ -1172,8 +1231,8 @@ regardless of their location on your hard disk or a web server.

      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).

      + (absolute) URL. You typically use absolute URLs when linking to files + on other web servers (not stored locally on your hard disk).

      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 @@ -1190,18 +1249,22 @@

    4. Click OK to confirm your changes.
    -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    Setting Page Properties

    In this section:
    -

    Setting Page Properties and Meta Tags

    +

    Setting Page Properties and Meta + Tags

    Use the Page Properties dialog box to enter properties such as the title, author, and description of the document you're currently working on. @@ -1234,7 +1297,8 @@

    [Return to beginning of section]

    -

    Setting Page Colors and Backgrounds

    +

    Setting Page Colors and + Backgrounds

    You can change the background color or specify a background image for the page you're currently working on. These choices @@ -1286,7 +1350,8 @@

    Note: To apply additional attributes or JavaScript events, click Advanced Edit to display the - Advanced Property Editor.

    + Advanced Property + Editor.

    You can also set the default page background and colors for every new page you create in Composer.

    @@ -1297,19 +1362,24 @@
    In this section:
    -

    Creating Links Within the Same Page

    +

    Creating Links Within the Same + Page

    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 anchor (target location), and then create a link that points to the - anchor. Anchors are also called named anchors.

    + anchor. Anchors are also called named anchors. To create an anchor, + follow these steps:

    1. Click to place the insertion point at the beginning of a line where you @@ -1325,7 +1395,7 @@
    -

    To create the link on which readers can click to jump to the anchor:

    +

    To create the link on which readers can click to jump to the object:

    1. Select the text or image that you want to link to the anchor.
      2. @@ -1351,7 +1421,8 @@ use the Link dialog box to create links to headings that already occur in the page.

      -

      [Return to beginning of section]

      +

      [Return to beginning of + section]

      @@ -1420,7 +1491,8 @@ link location into the Link Location field in the Link Properties dialog box.

      -

      [Return to beginning of section]

      +

      [Return to beginning of + section]

      @@ -1428,14 +1500,16 @@ your pages. When the reader clicks a linked image, the browser window displays the page that the image is linked to.

      +

      To make an image behaving like a link:

      +
      1. Select an image on your page.
      2. Click the Link button on the toolbar, or open the Insert menu and choose Link.
      3. Use the Link Properties dialog box to link the image to a - named anchor or heading within the page, - or to a + named anchor or heading + within the page, or to a separate local or remote page.
      @@ -1447,7 +1521,8 @@ open the Link Properties dialog box, click the Link tab, and uncheck Show border around linked image.

      -

      [Return to beginning of section]

      +

      [Return to beginning of + section]

      @@ -1466,7 +1541,8 @@
    2. Open the Format menu and choose Discontinue Link.
    -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    Publishing Your Pages on the Web

    @@ -1483,12 +1559,18 @@
    In this section:
    @@ -1539,9 +1621,11 @@ You'll be prompted to choose a filename and location on your hard disk for the document.

    -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    - +

    For more troubleshooting tips, see - Solving Common Publishing Problems. + Solving Common Publishing + Problems.

    -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    Updating a Published Document

    @@ -1572,24 +1658,25 @@ of the document you want to update by entering the document's HTTP address (the document's web address) in the Navigator browser's Location field.

    -
  • Open the File menu, and choose Edit Page.
  • Edit the document as necessary.
  • When you're ready to update the remote page with your changes, click Publish in Composer's toolbar.
    • -

    Tip: To delete a page or image you've published on a web - server, you must use an FTP (File Transfer Protocol) - program. You also must use an FTP program if you want to create +

    Tip: To delete a page or image you've published on a + web server, you must use an FTP (File Transfer + Protocol) 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.

    -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    -

    Changing the Filename or Publishing Location

    +

    Changing the Filename or + Publishing Location

    To change a document's filename or publishing location:

    @@ -1601,7 +1688,6 @@ by entering the document's HTTP address (the document's web address) in the Navigator browser's Location field.

    -
  • Open the File menu, and choose Edit Page.
  • Edit the document as necessary.
  • Open Composer's File menu and choose Publish As. Composer displays the Publish tab in the Publish Page dialog box.
    • @@ -1614,13 +1700,15 @@
  • Click Publish to save the document to the new location.
    • -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    Creating a New Publishing Site

    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.

    + use, so that you don't have to enter it each time you want to + publish.

    To create a new publishing site, begin from a Composer window:

    @@ -1653,18 +1741,20 @@ what to enter, ask your ISP or system administrator, or else leave it blank.

    -
  • For user name, enter the user name you use to log in to your ISP or - web hosting service.
    • -
  • For password, enter the password for your user name.
    • +
  • For user name, enter the user name you use to log in to your ISP + or web hosting service.
    • +
  • For password, enter the password for your user name.
  • Select Save Password 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.
  • Click OK.
    • -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    -

    Choosing the Default Publishing Site

    +

    Choosing the Default Publishing + Site

    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 @@ -1675,8 +1765,8 @@

    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 - Changing the Filename or Publishing Location - for more information.

    + Changing the Filename + or Publishing Location for more information.

    To choose the default publishing site, begin from a Composer window:

    @@ -1693,7 +1783,8 @@
  • Click OK to confirm your changes.
    • -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    Deleting a Publishing Site

    @@ -1716,9 +1807,11 @@
  • Click OK to confirm your changes.
    • -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    -

    Solving Common Publishing Problems

    +

    Solving Common Publishing + Problems

    If one or more of your files fail to publish, the Publishing Status dialog box displays an error message that can help you @@ -1734,13 +1827,15 @@

    In this section:
    -

    Verifying Your Publishing Settings

    +

    Verifying Your Publishing + Settings

    To verify your publishing settings:

    @@ -1752,10 +1847,10 @@ sure, check with your ISP or web hosting service. -

    Possible Solutions:

    +

    Possible Solutions:

    • Look for broken images in the page you are trying to publish. Broken @@ -1869,7 +1964,7 @@
      -

      Error Message:

      +

      Error Message:

      The subdirectory directory name doesn't exist on this @@ -1880,7 +1975,7 @@ subdirectory
      -

      Error Description: You specified the name of a remote +

      Error Description: 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 @@ -1898,7 +1993,7 @@ subdirectory at the publishing site.

    -

    Possible Solutions:

    +

    Possible Solutions:

     -

    [Return to beginning of section]

    +

    [Return to beginning of + section]

    Composer Preferences

    @@ -2290,7 +2390,7 @@

    [Return to beginning of section]

    @@ -2353,7 +2455,8 @@

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

    -

    If you are not already viewing the New Page Settings, follow these steps:

    +

    If you are not already viewing the New Page Settings, follow these + steps:

    1. Open the &brandShortName;