Transformation

Once you have your XML file nice and complete and you have validated it and all is fine, you might wish to test what you have done and see without tags. We have a test HTML view which you can use for this. it can be useful to check for white spaces, for information missing of mistyped, etc. This assumes you have set up your machine to have all the project repositories in one folder called BetMes as described in the GitHub setup and that you have checked out and updated you BetaMasaheft repository.

Here is what you need to do to set up the transformation

  1. Open in Oxygen the file you want to see in HTML

  2. Click the little tool icon on the top which says Configure Transformation scenario.

  3. Now click on NEW and select "XML Transformation with XSLT" .

  4. First thing, select from the Transformer menu the highest version of SAXON available.

  5. Now name your preview transformation.

  6. You need now to tell Oxygen where to find the XSLT to start the transformation. Click on the browse icon and navigate into your local BetaMasaheft repository.

  7. You will find there a preview folder with several XSLT files, select only <preview.xslt>.

  8. You should be back to the previous window, then click the Output tab on top and lets set where the results of your transformation will be saved.

  9. Save it to an appropriate location .

  10. Leave a random name, we will then change it.

  11. Once you have selected the folder and given a mock name, we will substitute that name with a function which will give the same name as your original file. click on the little green arrow pointing down and select ${cfn} current file name. We want to change the extension, so, after entering that type .html .

  12. I would suggest also to open directly in your browser the saved file, ticking the option right there.

  13. All set! Apply and enjoy!

Attention!

  • if Oxygen says the file ended prematurely, it is highly likely that something is wrong with your pointers to Zotero, as this is the only live API call being done.

  • To correctly see bibliography citations and maps you need to be online when you transform.

  • There are a series of tests embedded in this transformation, to help check your contents. For example, if a person ID does not exist, you will see a bold red sentence telling you about it. Fix the issue and the transform will be fine.

  • The Transformation will first check the type of file and will return a slightly different view for each different entity type. Note that THE HTML IS SCHOOL BASIC as this serves only the purpose of testing contents.

guidelines

This page is referred to in the following pages

Revisions of this page

  • Pietro Maria Liuzzo on 2018-04-30: first version of guidelines from Wiki