Using the Project View

The Project view is designed to assist the user in organizing and managing related files grouped in the same XML project. The actions available on the context menu and toolbar associated to this panel, enable the creation of XML projects and shortcuts to various operations on the project documents.

The Project View

The default layout initialized by the Window > Reset Layout menu item positions the Project view on the left side of the Oxygen XML Developer window, above A closed view can be quickly reopened at any time with the Project > Show Project View menu action.

The tree structure occupies most of the view area. In the upper left side of the view, there is a drop-down list that holds all recently used projects and project management actions:
The following actions are grouped in the upper right corner:

The files are organized in an XML project usually as a collection of folders. There are two types of folders:

Creating New Project Items

A series of actions are available in the contextual menu:
  • New > File - Creates a new file and adds it to the project structure.
  • Add Folder - Adds a link to a physical folder, whose name and content mirror a real folder existing in the file system on disk. The icon of this action is different on Mac OS X () as the standard folder icon on Mac OS X is not the usual one from Windows and Unix/Linux systems.
  • New > Logical Folder - Creates a logical folder in the tree structure (the icon is a magenta folder on Mac OS X - ).
  • New > Logical Folders from Web - Replicates the structure of a remote folder accessible over FTP/SFTP/WebDAV, as a structure of logical folders. The newly created logical folders contain the file structure of the folder it points to.
  • New > Project - Creates a new project, after closing the current project and all open files.

Add Content to a Logical Folder

You can add content to a logical folder using one of the actions available in the contextual menu:
  • Add Folder - Adds a link to a physical folder, whose name and content mirror a real folder existing in the file system on disk. The icon of this action is different on Mac OS X () as the standard folder icon on Mac OS X is not the usual one from Windows and Unix/Linux systems.
  • Add Files - Adds links to files on disk.
  • Add Edited File - Adds a link to the current edited file to the project.

Managing Project Content

You can create linked folders by dragging and dropping a folder from the Windows Explorer / Mac OS X Finder over the project tree or by selecting in the contextual menu Add Folder. Also the structure of the project tree can be changed with drag and drop operations on the files and folders of the tree.

When adding files to a project, the default target is the project root. To change a target, select a new folder. Files may have multiple instances within the folder system, but cannot appear twice within the same folder.

To remove one or more files or folders, select them in the project tree and press the Delete key or run the contextual menu action Remove from Project. To remove a file or folder both from project and disk, run the contextual menu action Remove from Disk (Shift+Delete) which is available for both logic and linked files.
CAUTION:
In most cases this action is irreversible, deleting the file permanently. Under particular circumstances (if you are running a Windows installation of Oxygen XML Developer and the Recycle Bin is active) the file is moved to Recycle Bin.

To create a file inside a linked folder, choose the New > File action from the contextual menu.

There are three ways yo rename an item in the Project view: To begin editing an item name in the Project view, select the item and do one of the following:
  • invoke the Rename action from the contextual menu;
  • press F2;
  • click the selected item.
To finish editing the item name press Enter.
Note:
  • Files or folders are renamed both in the Oxygen XML Developer Project view and on the local disk;
  • The Rename action is also available on logic files.

If a project folder contains many documents, a certain document can be quickly located in the project tree if the user selects with the mouse the folder containing the desired document (or some arbitrary document in this folder) and types the first characters of the document name. The desired document is automatically selected as soon as the typed characters uniquely identify its name in the folder. The selected document can be opened by pressing the Enter key, by double-clicking it and with one of the Open actions from the pop-up menu. The files with known types are opened in the associated editor while the are opened with the associated system application. To open a file of known type with other editor than the default one, use the Open with action.

The project file is saved automatically on disk, every time the content of the Project view is modified by actions like adding or removing files or folders and drag and drop to/from the Project view.

Validate Files

The currently selected files in the Project view can be validated against a schema of type Schematron, XML Schema, Relax NG, NVDL, or a combination of the later with Schematron with one of the following contextual menu actions:

Applying Transformation Scenarios

The currently selected files in the Project view can be transformed in one step with one of the actions Transform > Apply Transformation Scenario, Transform > Configure Transformation Scenario ... and available on the right-click menu of the Project view. This, together with the logical folder support of the project allows you to group your files and transform them very easily.

If the resources from a linked folder in the project have been changed outside the view, you can refresh the content of the folder by using the Refresh action from the contextual menu. The action is also performed when selecting the linked resource and pressing F5 key

A list of useful file properties like the ones available in can be obtained with the Properties action of the contextual menu invoked on a file node of the Project view tree, in the following dialog:

The Properties Dialog

Right-clicking any object in the tree view displays the Project menu with functions that can be performed on, or from the selected object. Options available from the Project menu are specific to the object type selected in the tree view.

You can also use drag and drop to arrange the files in logical folders (but not in linked folders). Also, dragging and dropping files from the project tree to the editor area results in the files being opened.

Other Context-Dependent Actions

Many of the actions available in the Project view are grouped in a contextual menu. This menu is displayed after selecting a file or folder and then pressing right-click (or Ctrl+Click on Mac OS X)
  • Show in Explorer (or Show in Finder on Mac OS X) - Opens an OS-specific finder/explorer window, with the file or folder in question selected in the finder/explorer window.
  • Open with - Open selected file with one of internal tools: SVG Viewer , Hex Viewer , Large File Viewer , , WSDL/SOAP Analyzer, , Archive Browser .
  • Open All Files - Action available only when at least one folder is selected. Opens in the editor view all files contained by the selected resources.
  • Find/Replace in Files - Allows you to find and replace text in multiple files.
  • Check Spelling in Files - Allows you to
  • Open in SVN Client - Syncro SVN Client tool is opened and it highlights the selected resource in its corresponding working copy.

Menu Level Actions

The following actions are available in the Project menu:
  • New Project - Creates a new, empty project.
  • Open Project ... (Ctrl+F2) - Opens an existing project. An alternate way to open a project is to drop an Oxygen XML Developer XPR project file from the file explorer in the Project panel.
  • Save Project As... - Allows you to save the current project under a different name.
  • Validate all project files - Checks if the project files are well-formed and their mark-up conforms with the specified DTD, XML Schema, or Relax NG schema rules. It returns an error list in the message panel.
  • Show Project View - Displays the project view.
  • Reopen Project - Contains a list of links of previously used projects. This list can be emptied by invoking the Clear history action.
Related information
Working with EPUB