Inserting Images

the RDT allows you to add images to your documents in an easy and intuitive way.

In order to insert an image, simply press the  button on the toolbar. The Image Properties dialog window that will open lets you set configuration options that define image source, its size, display properties, or other advanced properties.

The Image Properties dialog window includes four tabs that group image options:

• Image Info
• Link
• Upload
• Advanced

For general information on using dialog windows please refer to the Dialog Windows section of the User's Guide.

Image Info

The Image Info tab is the default tab that opens after you press the  button on the toolbar. It allows you to set the image URL and configure the way it will appear in the document.

Below is an overview of all Image Info tab elements:

• URL – the web address of the image. The image may be located on the same server as the web site you are currently in or on an external server.
  • External server: If you want to use an external address, use the full absolute path.

    Example: http://example.com/image1.jpg

  • Local server: If the image is located on the same server, you can use a relative path that omits the domain name and starts with a slash.

    Example: /images/image2.jpg If the RTE is integrated with a file browser, you can also use the Browse Server button to select an image from the ones that are available on the server.

• Browse Media Manager - Opens the webCentral media manager to add documents or images
• Alternative Text – a short textual description of the image that tells users with assistive devices (like screen readers) what the image is about. You should always provide your images with meaningful alternative text in order to make it accessible to users with disabilities.
• Width – the width of the image in pixels. By default this is the size of the original image.
• Height – the height of the image in pixels. By default this is the size of the original image.
• Border – the size of the solid border around the image in pixels.
• HSpace – the horizontal spacing (or margin) between the image border (if present) or the image itself and other document elements that surround the image, in pixels.
• VSpace – the vertical spacing (or margin) between the image border (if present) or the image itself and other document elements that surround the image, in pixels.
• Align – the alignment of the image in the document. Available options are Right and Left.
• Preview – a preliminary view of the selected image formatted according to the options chosen on the left.

Image manipulation

With the RTE you do not have to worry about resizing your image.

If the image is too big, you can alter its dimensions by entering new values into the Width and Height fields. By default the image ratio is locked, which you can see thanks to a button. This means that when you change one of the size values (width or height), the other one will be adjusted automatically.

If you want to freely modify both dimensions, click the button in order to unlock the ratio. The button will now change to and modification of one dimension will not automatically cause the other one to be adjusted. To lock the image ratio again, click the button once more.

You can easily return to original image size by pressing the button. This will reset the image size; the original width and height will now appear in appropriate text boxes.

Link

The Link tab lets you assign a link to an image inserted into the document, effectively converting the image into a clickable link. The link can point to any kind of object available in the Internet, like a simple URL address, a PDF document, or an online video.

This might prove especially useful if, for example, you want to add a thumbnail that would lead the reader of your document to a full-size copy of the image or add a company logo and point to its website.

To use the Link functionality, first you need to insert an image into a document using the Image Info tab. After you configure the display options, switch to the Link tab and configure the image target using the available options.

Below is the overview of all Link tab elements:

• URL – the web address that the image should be pointing at. This may be a plain website address, an image, or other file that is located on the same server as the web site you are currently in or on an external server.
  • External server: If you want to use an external address, use the full absolute path.

    Example: http://example.com/ http://example.com/largeimage1.jpg

  • Local server: If the target location is on the same server, you can use an absolute path that omits the domain name and starts with a slash.

    Example: /howto/images /images/largeimage2.jpg If the RDT is integrated with a file browser, you can also use the Browse Server button to select an image or a file from the ones that are available on the server.

• Target – the window where the assigned link will open after clicking the image. You can choose between New Window (_blank), Topmost Window (_top), Same Window (_self), or Parent Window (_parent).