Inserting Images

To insert an image in a document while editing in Author mode, use one of the following methods:
  • Click the Insert Image action from the toolbar. This opens a dialog box that allows you to choose the image file you want to insert and configure some properties. Oxygen XML Author plugin tries to reference the image with a path that is relative to that of the document you are currently editing. For example, if you want to add the file:/C:/project/xml/dir/img1.jpg image into the file:/C:/project/xml/doc1.xml document, Oxygen XML Author plugin inserts a reference to dir/img1.jpg. This is useful when multiple users work on a common project and they have it stored in multiple locations.
    Note: The Insert Image action is available for the following document types: DITA, DocBook, TEI, XHTML, JATS.
  • Drag an image from other application and drop it in the Author editing mode. If it is an image file, it is inserted as a reference to the image file. For example, in a DITA topic the path of the image file is inserted as the value of the href attribute in an image element:
    <image href="../images/image_file.png"/>
    Tip: To replace an image, just drag and drop a new image over the existing one. Oxygen XML Author plugin will automatically update the reference to the new image.
  • Copy an image file from another document or another application (such as a system file browser or web browser) and paste it into your document. Oxygen XML Author plugin will insert it as a reference to the image file the same as the drag/drop method.
  • Select an image (or part of an image) from another application (such as an image editor), copy it, and paste it into your document. Oxygen XML Author plugin will prompt you to save it. After saving the image, a reference to that file path is inserted at the paste position.