<oXygen/> User Guide |
As with most editing applications, Oxygen lets you open existing documents, save your changes and close them as required.
Documents can be opened using:
Ctrl+O) : Displays the Open dialog used to discover, select and open one or more files.
-> (-> : Displays a list of recently opened document files. Select a file to open.
: Opens the selected file from the Project View.
In addition Oxygen supports direct opening of files from the command prompt. Use the following command syntax: sh ./oxygen.sh FileToOpen.xml
When the Tree View is started the Oxygen will display the current document from the Main Window.
Oxygen supports editing remote files, using the FTP and WebDAV protocols. The remote opened files can be edited exactly as the local ones. They can be added to the project, and can be subject to XSL and FO transformations.
![]() | Note |
---|---|
The WebDAV access is implemented using the Slide package of the Apache Software Foundation. The FTP part is using passive access to the FTP servers. Make sure the server you are trying to connect to is supporting passive connections. The FTP/WebDAV capabilities have been extensively tested with various servers running on Windows (IIS), Mac OS X and Linux (Apache). |
To open the remote files, choose from the main menu "File/Open URL". The displayed dialog is composed of three parts.
![]() | Note |
---|---|
If you have set a proxy server to be used by Oxygen, make sure it supports the WebDAV protocol. If it does not, make sure you uncheck the "Use proxy server" from the Options/Preferences/Proxy Configuration pane, otherwise you will not be able to connect to a WebDAV server. |
The first one is an editable combo box, in which it can be specified directly the URL to be opened or saved.
Example 4.1. URLs that can be directly opened
You can type in here an URL like http://some.site/test.xml, in case the file is accessible through normal HTTP protocol, or ftp://anonymous@some.site/home/test.xml if the file is accessible through anonymous FTP.
This combo box is also displaying the current selection when the user changes selection in the browsing tree.
The second part is controlling the access credentials. If you want to browse for a file on a server, you have to specify the user and password. This information is bound to the selected URL displayed in the "File URL" combo box, and used further in opening/saving the file. If the check box "Save" is selected, then the user and password are saved between editing sessions. The password is kept encrypted into the options file.
![]() | Note |
---|---|
Your password is well protected. In the case the options file is moved to another installation, on other machine, the password will become unreadable, since the encryption is user and machine dependent. This is also true if you add URLs having user and password to your project. |
The third part contains the server combo and the "Autoconnect" check box. Into the server combo it may be specified the protocol (HTTP, HTTPS or FTP), the name or IP of the server and, in case of WebDAV, the path to the WebDAV directory.
Example 4.2. Server URLs
When accessing a FTP server, you need to specify only the protocol and the host, like: ftp://server.com, ftp://ftp.apache.org, or if using a nonstandard port: ftp://server.com:7800/ etc.
When accessing a WebDAV server, along with the protocol and the host, it must be specified also the directory of the WebDAV repository. Ex: https://www.some-webdav-server.com:443/webdav-repository/, http://devel:9090/webdav/
By pressing the "Browse" button the directory listing will be shown in the component bellow. When "Autoconnect" is selected then at every time the dialog is shown, the browse action will be performed.
The last part consists of a tree view of the documents stored on the server. You can browse the directories, and make multiple selections. Additionally, you may use the "Rename", "Delete", and "New Folder" to manage the file repository.
If you want to access a WebDAV repository across an insecure network Oxygen allows you to load and save the documents over the HTTPS protocol (if the server understands this protocol) so that any data exchange with the WebDAV server is encrypted.
When a WebDAV repository is first accessed over HTTPS the server hosting the repository will present a security certificate to Oxygen as part of the HTTPS protocol, without any user intervention. Oxygen will use this certificate to decrypt any data stream received from the server. For the authentication to succeed you should make sure the security certificate of the server hosting the repository can be read by Oxygen. This means that Oxygen can find the certificate in the key store of the Java Runtime Environment in which it runs. You know the server certificate is not in the JRE's key store if you get the error "No trusted certificate found" when trying to access the WebDAV repository:
You can add a certificate to the key store by exporting it to a local file using any HTTPS-capable Web browser (for example Internet Explorer) and then importing this file into the JRE using the keytool executable bundled with the JRE. The steps are the following using Internet Explorer (if you use other browser the procedure is similar):
Procedure 4.2. Import a HTTPS server certificate
Export the certificate into a local file
Point your HTTPS-aware Web browser to the repository URL. If this is your first visit to the repository it will be displayed a security alert stating that the security certificate presented by the server is not trusted.
Press the button "View Certificate".
Select the "Details" tab.
Press the button "Copy to file ...". This will start the Certificate Export Wizard on Windows
Follow the indications of the wizard to save the certificate to a local file, for example server.cer.
Import the local file into the JRE running Oxygen
Open a text-mode console.
Go to the lib/security subdirectory of your JRE directory, that is of the directory where it is installed the JRE running Oxygen, for example on Windows C:\Program Files\Java\j2re1.4.2\lib\security
Run the following command:..\..\bin\keytool.exe -import -trustcacerts -file local-file.cer -keystore cacerts where local-file.cer is the file containing the server certificate, created during the previous step. Keytool requires a password before adding the certificate to the JRE keystore. The default password is "changeit". If somebody changed the default password then he is the only one who can perform the import. As a workaround you can delete the cacerts file, re-type the command and enter as password any combination of at least 6 characters. This will set the password for future operations with the key store.
Restart Oxygen
There are three save methods:
Ctrl+S) : Saves the current document. If the document does not have a file, displays the "Save As" dialog.
-> (-> : Saves all open documents. If any document does not have a file, displays the "Save As" dialog.
-> : Displays the Save As dialog, used to name and save an open document to a file; or save an exiting file with a new name.
To close documents use the following methods:
Ctrl+W) : Closes only the selected tab. All other tab instances remain.
-> (-> : Closes all open documents. If a document is modified or has no file, a prompt to save, not to save, or cancel the save operation is displayed.
: Displayed when a tab is right-clicked. Closes the selected tab when selected.
: Displayed when a tab is right-clicked. Closes the other files except the selected tab.
: Closes all open tabs within the panel.