The texts

For this assignment, we set you free to write XSLT on your own project files. Alternatively, you may choose to work on files prepared by another team, or with TEI XML files you have discovered and downloaded from the Digital Mitford (including the full Digital Mitford Site Index) or the Digital Archives and Pacific Cultures project. As a resource for XML files, here is the GitHub for the Nell Nelson project and here is the GitHub for the Emily Dickinson project. Because the XML texts for all of these projects are under development, they may be inconsistently or incompletely marked up. As long as they are well formed, however, they can be explored with XML tools, including XSLT. While you are welcome to use XML files from any of these sources, we will be especially pleased to see you do something interesting with your own project XML files to begin building interesting and useful pages for your projects.

The assignment

Select an XML file from one of the projects and spend a few minutes looking at it to familiarize yourself with its overall structure. (Notice whether it’s in a namespace and change your stylesheet template accordingly!) Visit the project site to learn more about the general project. You may use your own XML files or someone else’s. Download an XML file from whichever project you choose into <oXygen/>.

Advice in case you need it: Downloading files from GitHub

The easiest way to download a file from GitHub is to clone the project onto your own machine, which will copy all files, and then open the file you need. If you want to download just one file (which is all you need for this assignment), you can’t just right-click and download because you’ll download a version with extraneous GitHub specific markup mixed into the file, which will render the file unusable for your purposes. What you can do instead is

  1. Connect to the repo in a browser;
  2. Click on the file you want, which will display its contents;
  3. Click on the button labeled Raw at the top of the code window, which will display its contents without any extraneous GitHub-specific material; and
  4. Either right-click and do a Save as or select all the text in the window, copy it to the clipboard, and paste it into a new XML document in <oXygen/>.

What to do with the file or collection once you’ve downloaded it

Transform the XML into some form of HTML using XSLT, whether that’s a reading view or some sorts of lists or tables or other reports. You should decide yourself on the type of output you would find interesting or useful, but so that you’ll gain practice with some of the techniques we’ve introduced recently, your transformation must require meaningful use of at least two of the following:

Please upload your XSLT and the XML to CourseWeb. You do not have to upload the HTML output of your transformation (we’re going to run the transformation and generate the HTML ourselves anyway). If your HTML is going to be styled with CSS, though, be sure that your XSLT generates the necessary <link> element inside HTML document, and upload the CSS file along with the XSLT.