Home > Resources for Contributors > Accessing 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

The oXygen XML editor is available to UNF users via the Virtual Lab in MyWings, which uses Citrix remote-access software to let you access, via your local machine, software that actually runs on a UNF server.

You can access the Virtual Lab directly through MyWings > Student Tools* > Virtual Lab. However, if you take this route, by default the now-deprecated client tool Citrix Receiver will launch. Furthermore, the version that launches is the “light” version runs in the browser, not on your machine itself, and as a result it can sometimes be difficult or impossible to access your local file system. *For faculty/staff, this is [Employee Resources > Employee Tools].

Therefore, this is the recommended approach:

  1. Download the proper version (for PC or Mac) of Citrix Workspace (the current application) from the Citrix website: https://www.citrix.com/downloads/workspace-app/
  2. Double click on the downloaded file to run the installer, and say yes to any questions it asks you.
  3. 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.
  4. When it prompts you to add an account, enter this server address: vlab.unf.edu
  5. It will then prompt you for your network credentials (N# and password).
  6. 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.
  7. When oXygen launches, you may see the following prompt: "How do you want to access files from this application?". Select "Read and Write." 

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."