ESP comes pre-installed in your Oracc project with certain files and folders/directories which are explained in more detail here. This page is mostly for ESP site managers but it may be helpful for editors to read too.
00res/ downloads/ images/ 00web/ 00config/ parameters.xml referents.xml structure.xml about/ 404.xml accesskeys.xml cookies.xml licensing.xml sitemap.xml standards.xml about.xml glossarypage.xml home.xml indexpage.xml techtermspage.xml template-blank.xml
In the course of making your website you will be editing some of these files, as well as adding more as you need them.
Put all static content for your portal site in here. Images, PDFs, etc. are typically rather large, and need to be uploaded only once, so we keep them out of the way in a separate folder.
Any files for the site that are intended to be downloadable, such as copies of PDFs, large images, Google Earth and Google Maps KML/KMZ content, etc.
When creating links to downloadable content, use the <esp:link> tag with the
url attribute and the file name in the project's downloads folder. E.g., for the project
doc, the downloads URL would be:
<esp:link url="/doc/downloads/example.kmz" title="example file">Example text</esp:link>
<esp:image>tag to insert images into a page, the processor will look for the images in the
00res/imagesfolder by default. You can create subfolders with the same names as your site folder structure to organise your images, but remember to specify the correct location of the image in the
This folder contains the text pages for the website. You will also find a copy of it in your templates bundle.
00web/about. You can add to it if you want to add further files to that folder, but we strongly recommend that you do not delete anything from it, as all these files are necessary to comply with basic web accessibility standards and EU Cookies law.
00web/to house new files if you want. Any file not listed in
structure.xmlwill not appear on the website, so you can keep
template-blank.xmlwherever is convenient.
This folder contains the files that set the basic appearance of the website. You will need to edit these at least once.
parameters.xml. Most of these parameters will need to be set up initially and then do not need to be altered. There are instructions on the ESP setup page on how to do this.
The pages in this folder are important for compliance with international web standards on accessibility and EU cookies law. You should not edit them unless you notice a problem with them. Ask your liaison for advice if necessary.
accesskeys-listingelement and should not be edited. To set which pages can be accessed like this, use the
Once you have understood the structure of ESP, you are ready to set it up on your Oracc project.23 Aug 2014
Eleanor Robson, 'Overview of ESP folder/directory structure', Oracc: The Open Richly Annotated Cuneiform Corpus, Oracc, 2014 [http://oracc.museum.upenn.edu/doc/help/portals/espfolders/]