Edit online

Browsing Archives

Oxygen XML includes a helper view called the Archive Browser that allows you to view the contents and structure of an archive, and it offers a variety of toolbar and contextual menu actions.

To open an archive in the Archive Browser view, use one of the following methods:

  • Open an archive from the Project view.
  • Select an archive in one of the file chooser dialog boxes in Oxygen XML (such as the Open dialog box).
  • Drag an archive from a system file explorer and drop it in the Archives Browser view.

When displaying an archive, the Archive Browser view locks the archive file. It is then automatically unlocked when the Archive Browser view is closed.

To view the contents and structure of an archive, use one of the following methods:
  • Open an archive from the Project Explorer view. This opens the archive in the main editing pane. The archive is unmounted when the editor is closed.
  • Use the Eclipse File System (EFS) by right-clicking the archive in the Project Explorer view and choosing Expand Zip Archive. This expands the archive. All the standard actions are available on the mounted archive. To close the archive, you can use the Collapse ZIP Archive action and any file opened from the expanded archive is closed when the archive in unmounted.
Tip:
If a file is not recognized by Oxygen XML as a supported archive type, you can add it in the Archive preferences page.
Figure 1. Archive Browser
Figure 2. Browsing an Archive

Archive Browser Toolbar Actions

The following actions are available on the Archive Browser toolbar:

Open Archive menu
Provides access to the Open Archive action that opens a new archive in the browser. If the extension is not known as an archive extension, you will be directed to the Archive preferences page to add a new extension. The submenu keeps a list of recently open archive files and a Clear history action that allows you to delete the list.
Close
Closes the browsed archive and unlocks the archive file.
Validate (available for EPUB archives only)
Checks the EPUB archive to see if its content and structure is valid.
Add files
Adds existing files as children of the selected folder in the browsed archive.
Note:
You can also add files in the archive by dragging them from the file browser or the Project view and dropping them in the Archive Browser view.
Delete
Deletes the selected resource in the browsed archive.
Open in System Application
Opens the selected resource in the default system application that is associated with that type of file.
Archive Options
Opens the Archive preferences page.

Archive BrowserArchive Contextual Menu Actions

The following additional actions are available from the contextual menu for archivesresources in the Archive Browser view:

Open
Opens a resource from the archive in the editor.
Extract
Extracts a resource from the archive in a specified folder.
Add files
Adds existing files as children of the selected folder in the browsed archive.
Note:
On macOS, the Add file action is also available and it allows you to add one file at a time.
Rename
Renames a resource in the archive.
Find/Replace in Files
Opens the Find/Replace in Files dialog box that allows you to search for and replace specific pieces of text inside the archive.
Cut
Cuts the selected archive resource.
Copy
Copies the selected archive resource.
Paste
Pastes a file or folder into the archive.
Delete
Removes a file or folder from archive.
Preview
Previews an image contained in the archive. See the Image Preview topic for more details.
Copy location
Copies the URL location of the selected resource.
Refresh
Refreshes the selected resource.
Properties
Shows the properties of the selected resource.

Resources

For more information, watch our video demonstration about working with an EPUB in the Archive Browser view: