Creating a proxy (parasite) project

Notes for the Oracc workshop participants at RAI64, Innsbruck, July 2018. Updated for the Oracc for online teaching workshop, August 2020

Setting up

1. I've emailed you your password and userID. Let me know if you haven't got it or if it doesn't work!
2. Get yourself a free FTP programme such as Fugu, Cyberduck or WinSCP. You'll use this a lot to upload stuff to Oracc. Make sure you use SFTP (secure FTP) when you log in to build-oracc.museum.upenn.edu (you can't log in with insecure FTP.)
3. You'll also need to connect to Oracc with a line-command unix terminal, to give commands to Oracc. Read this page for basic instructions on how to find and use one, including how to change your Oracc password.

Basics

4. Creating a list of texts for your corpus
   • On your own computer, make a list of the P-numbers and/or Q-numbers you want in your corpus. Follow these instructions (but ignore the last sentence as I've already done that for you).
   • Save it as a text-only file with the name proxy.lst.
5. Uploading your text-list to Oracc
   • Open your FTP programme and log in to build-oracc.museum.upenn.edu on the SFTP setting. Use your Oracc user ID and password.
   • You'll see a list of folders, most of which begin with 00. Look for 00lib and open it by double-clicking.
   • Drag and drop your proxy.lst file into this folder. You can edit and replace it as many times as you like, but make sure the file name stays the same.
6. Building your corpus
   • Open Terminal or PuTTy and type: ssh [your userID]@build-oracc.museum.upenn.edu. Press return, enter your password, and press return again.
   • The first time you do this you'll get a scary message about security. Typ yes and continue.
   • Now you're in Oracc. Type oracc build clean and press return to build your project from proxy.lst.
   • When the process has finished, see what it looks like at http://build-oracc.museum.upenn.edu/[your user ID].

You can repeat steps 4–6 as many times as you like.

Next steps

7. Organising your corpus into lists
• If you want your texts to appear all together online but want to link to groups of them from your VLE, for instance to set weekly readings, you have two choices.
• Both are described on Oracc here.
8. Organising your corpus into subprojects
• If you're using Oracc for several different classes, or want to keep each week's corpus separate, then you can very simply set up one or more subprojects. Each of them behaves like its own project. 
• See the Oracc website for more information
9. Building your glossary/glossaries
• In the Terminal or PuTTy, type: oracc harvest. Press return. This command "harvests" all the available lemmatisations in your corpus across all ancient languages and the proper nouns. It will also generate a list of glossaries with the number of new entries in each.
• Merge those entries, glossary by glossary, by typing: oracc merge [lang-code], e.g., oracc merge sux or oracc merge akk-x-stdbab or oracc merge qpn and press return.
• If you want, there are more detailed instructions on the Oracc website.
• Follow the instructions under step 4 to build the new glossary entries into the website.

Going further

10. Managing the look and feel of your corpus
11. Creating an XTML portal page/site for your corpus
12. Editing your corpus

Contact me for a further tutorial on any or all of these things — and/or read up on the Oracc website.
Also contact me if any of this is wrong or confusing please!

RAI64 workshop resources

This post links to the online resources used in Eleanor's part of the Oracc workshop at RAI64 in Innsbruck, 18 July 2018.

1. New Easy Oracc (NEO)
   • Home page in English and Arabic, and search (beta-version!): http://build-oracc.museum.upenn.edu:4300/home
   • Give feedback to our programmers on bugs, ease of use, desired features, etc. : https://github.com/oracc/oracc-search-front-end/issues (you'll need to quickly create a free Github account first)
2. Nammu text-editor
   • The Arabic-enabled version isn't yet ready for beta-release but you can get the current, stable version here: https://github.com/oracc/nammu
   • Tiny test corpus with Arabic translations (NB word order in mixed AR-EN translations is still incorrect): http://build-oracc.museum.upenn.edu/cams/arabic/corpus
   • Oracc keyboards for easy entry of unicode characters used for alphabetic transliteration of cuneiform (Windows and Mac): http://oracc.org/doc/help/visitingoracc/keyboards/
   • Digital Orientalist keyboards for Arabic and Arabic transliteration (Windows and Mac): https://digitalorientalist.com/2017/07/11/improved-keyboard-layout-for-mac/
3. Virtual Oracc projects for teaching
   • Eleanor's teaching corpus for her undergraduate history course Temple Life in Assyria and Babylonia: http://oracc.org/cams/tlab/
   • Email osc @ oracc . org to be assigned a login ID and a project liaison
   • Instructions on making a list of P-numbers to borrow ("proxy") from other projects for your virtual corpus: http://oracc.org/doc/help/managingprojects/configuration/#h_proxies
   • Introduction to re-using Oracc texts online (& in print): http://org/doc/help/visitingoracc/citingurls/
   • More detailed instructions: http://oracc.org/doc/help/portals/projecturls/

Planning for Oracc projects

Are you planning to apply for large-scale funding to work on an Oracc-related project?

If so, please consult the Oracc Steering Committee (OSC) as early as possible in the process (osc@oracc.org). We’ve recently seen some big and exciting project proposals rejected because they didn’t meet the funding body’s technical expectations.

We can help you maximise your chances of funding success by helping you to:

• develop your proposal in line with the latest appropriate methods and theories in digital humanities;
• write a convincing technical plan
• construct a realistic timetable for staff training, data input, and/or data extraction and analysis;
• review whether Oracc has the resources and functionalities that your project needs or needs to be developed further;
• plan and budget for time for a member of the Oracc Steering Committee and/or the RITS programming team at UCL to work on your project;
• develop an appropriate set of outputs, outreach and dissemination strategies.

If you need to work on Oracc without funding, or on a shoe-string budget, as many colleagues do, go ahead and get in touch with us too, at osc@oracc.org. We are fundamentally committed to offering free support and resources to everyone who needs them.

The Oracc Advisory Committee

The Oracc Advisory Committee (OAC) will work with the Oracc Steering Committee (OSC) to broaden the consultative framework within which Oracc planning and implementation takes place.

The OAC’s responsibilities are to work with the OSC on various matters relating to Oracc development, maintenance, use and evangelism. The OAC will develop the agendas for the meetings and advise the OSC on matters of interest and concern, and on the priority of those matters.

The OAC will be constituted as a group of up to 6 members, with 3 joining the group in year one; a further 3 in year 2; and an annual rotation of up to 3 members after that. Initial terms will be for two years, renewable for up to a further two years.

The OAC will meet regularly via Skype and annually in person, with the first face-to-face meeting taking place in Philadelphia on Monday/Tuesday 5-6^th November 2018. Some travel funds may be available to support those attending the face-to-face. In addition, members of the Steering Committee and the Advisory Committee present at the annual Rencontre Assyriologique Internationale will have a “working lunch”, typically on the Wednesday of the meeting.

How to apply

Please send a letter of interest, stating briefly why you would like to join, with a CV (two pages maximum) to the ORACC Steering Committee osc@oracc.org before April 25th 2018. We will get back to you by mid-May.