HomeResources for ContributorsAccessing oXygen and Working with Files

Accessing oXygen and Working with Files

We use the oXygen XML editor to produce the TEI-XML files that contain our transcriptions/editions. This page explains the steps you need to take to get started.

1. Accessing oXygen

  1. The Oxygen XML editor is available through the UNF Virtual Lab. You can access the Virtual Lab through MyWings, but we have experienced issues with that approach, so we recommend instead the following:

    a. Download the proper version (for PC or Mac) of Citrix Workspace from the Citrix website: https://www.citrix.com/downloads/workspace-app/

    b. Double click on the downloaded file to run the installer, and say yes to any questions it asks you.

    c. Once it is installed, click on the Citrix Workspace icon in the task bar of your computer (if you're using Windows) or launch Citrix Workspace from the application menu.

    d. When it prompts you to add an account, enter this server address: vlab.unf.edu

    e. It will then prompt you for your network credentials (N# and password).

    f. The first time you enter the Citrix Workspace app, you will need to click on the "+" sign to expand the list of applications, and then choose Oxygen. 

2. Working with Files

a. Opening your file

Select File > Open, and then browse your local machine, following this path: Local Disk > C$ > Users > YOUR NAME (or the name of your user account on your computer). Please realize that when you are browsing for a file under File > Open, the high-level folders “This PC,” “Desktop,” “Documents,” etc. (which you will see whether you are on a PC or a Mac), refer to the virtual machine on which the software is running, not to your local computer. 

Please note that you won't be able to just double-click on the file on your local machine to open it in oXygen.* If you do attempt to do so, it will most likely launch in a browser, where it will look like a mess of jumbled text. You may also get an error message about no stylesheet being associated with it. You have to go into oXygen first, and open it from there, as explained above.

*The exception to this would be if you had oXygen installed on your local machine (that's not the case if you're using it through the Virtual Lab) and had configured your machine to open XML files by default in oXygen.

b. Saving files

If you use File > Save, you will save your file in its current location on your machine.

If you use File > Save As, you will, of course, be prompted to select a new location. If you do so for whatever reason, please make sure you are always saving files to the file structure of own user account under “Local Disk” (which is located on your machine itself), not to the remote locations mentioned above. You may not be able to recover later files saved to the remote machine.

3. Turn on Line Wrap

Line Wrap is off by default in oXygen, and this can make it very difficult to work in TEI-XML. To turn it on, do the following: Options > Preferences > Editor (click on little triangle to expand) > Edit modes (click again to expand) > Text, and then click the checkbox next to "Line Wrap."