Adding a Twitter feed to your ESP portal

for project managers

If you have a Twitter account, and your Oracc project has an ESP portal site, you can now add a Twitter timeline feed to it by following the instructions here.

You can see an example of it in use in the new Nimrud project portal (still tiny but growing fast).

In other Oracc news:

• The search functionality, which had been broken for a few days, is now up and running again.
• The GKAB portal pages have now moved closer to the CAMS/GKAB corpus; please update your bookmarks.

Knowledge and Power in the Neo-Assyrian Empire

Due to circumstances beyond our control, the original funders of the website Knowledge & Power in the Neo-Assyrian Empire no longer have access to the server on which it is hosted, which means that we cannot update it and many of the links (especially those to State Archives of Assyria online). We are currently trying to get it taken down with a redirect to the new site. Meanwhile, please update your links and bookmarks from http://knp.prs.heacademy.ac.uk/ to http://oracc.museum.upenn.edu/saao/knpp/

Installing EmacsW32 on Windows 7

The Emacs installation documentation at http://oracc.museum.upenn.edu/doc/builder/emacs/ now includes instructions for installing EmacsW32 on Windows 7 (shown in bold). Do let us know if there are any leftover problems with it.

Updated documentation

Over the past week or so I've had a jolly time checking that all the Oracc documentation is up-to-date and reflects current practice, and that all the links work. I won't list every tiny change here, but would like to draw your attention to a few points in particular:

All users: Citing Oracc URLs online and in print

Oracc 2 makes systematic use of stable URIs, so that you can be confident that print references and online links will remain valid. That means, though, that some details of the instructions on how to cite Oracc pages and resources have changed.

Mostly for editors and managers: Oracc language codes

If you have already read my overview of how the new lemmatiser works, you'll know that now you always need to specify Akkadian dialects (unless you are producing ATF for CDLI) and that glossary merges must now always specify the language. I've also worked those changes systematically through the documentation.

For editors and project managers: builder documentation

Editors and project managers will also notice that I have rearranged the list of builder documentation. It's still all there as before but now, I hope, in a more logical order.

For project managers: glossary management

I have incorporated the L2 updates into the sections on glossaries in the pages on project management with Unix and project management with Emacs (and written it into the rest of the documentation).

For project managers: The Oracc Command

This page has been reorganised and updated, so that it is easier to find help on the commands you most need for everyday project management work.

And you'll now find a Documentation full text search at the top of every documentation page.

If you notice anything wrong, broken, missing, or just plain confusing, please let me know, either in the comments or by email. The documentation is for you, the users and project creators, so please tell me if (and how) it isn't serving your needs.

ATF on Emacs

(For editors and project managers)

We still need to do a little work on updating Emacs ATF mode for Oracc 2. Until that happens, here is a list of what is and isn't working, and how to work around the latter.

ATF menu

Available when you have a .atf file open.

Check ATF

Lemmatise Buffer

Create Template

ATF Mode help

All working as usual.

Harvest Notices

Count Lemmata

Not working at the moment but neither is essential to the editing process.

Browse ATF docs

Links to a dead page. Go to the Builder Pages instead.

CBD menu

Corpus-based dictionary menu for project managers; vailable when you have a .glo file open.

Check CBD

Lemmer Update

Rebuild

Not working at the moment; you should manage glossaries through Unix instead

Project Maintenance Mode

CBD Mode help

Working as usual

Browse CBD docs

Links to a dead page. Go to the Manager Pages instead.

ORACC menu

For project managers; accessible from the Project Maintenance Mode item on the CBD menu.

Check Project

Merge Glossaries

Not working at the moment; you should manage projects through Unix instead—and note that the merge command now needs to specify the language

Harvest Glossary

Working as usual

Rebuild Project

Working but no longer recommended; use ncr or nor in Unix instead

Please do let me know if you have any problems or questions.

Adding Full Text Search to your Oracc 2 project portal

(FOR ORACC PROJECT MANAGERS)

One of Oracc 2's new functionalities is the Full Text Search across the whole of the site. There is a new documentation page about how to use it.

It is also very easy to enable users to do Full Text Search on your project alone, from one or more portal pages of your project. To do so you will need to edit them with Emacs or an XHTML editor.

• First add this line of code somewhere within the head element of the page, ideally with the other link elements:

  <link rel="stylesheet" type="/css/oraccbase.css"/>

  EDIT: This is now built into the main Oracc stylesheet.

• Then add this code wherever you want it to appear in the body of your web page, replacing [PROJECT] with the name of your project:

  <span class="find-button"><a href="/[PROJECT]/find">Full 
  Text Search</a></span>

  For instance, you might add a link to the online help:

  <p>Do a <span class="find-button"><a href="/cams/find">Full 
  Text Search</a></span> in CAMS 
  <a href="/doc/user/fulltextsearch/">[HELP]</a>.</p>

  EDITED TO ADD:

  If you are working with ESP, use <esp:link url="/[PROJECT]/find">...</esp:link> instead of <a href="/[PROJECT]/find">...</a>. The necessary CSS code is already built into ESP's stylesheet.

  This is displayed in the browser as:

  Do a Full Text Search in CAMS [HELP].

• Finally, don't forget to run oracc web to make it go live online.

Note that this does not replace the existing text, catalogue and glossary search functions, but allows users to search across the whole of your project, including portal pages. That does mean though that it is not very sensitive to the type of data it is searching, and returns rather rough and ready results. In particular, at the moment it privileges glossary entries but Steve is improving the way it returns results all the time.

As always, please let me know if you need assistance.

Analytics for Oracc 2 projects

(For Oracc project managers)

For Oracc 2, we have replaced Piwik as our user analytics software with Google Analytics (GA). There is just one Oracc account to which all project managers have access. You will still be able to see your own project's access data, but also all the other projects' and the whole of Oracc too, which we hope will be useful, for instance when writing grant applications and reports.

If you already have a Google account I have already registered you on Oracc's GA account. If you haven't (or I couldn't find it) I have already emailed you about this. If you think you should be on Oracc's GA account but can't get access and haven't had me email, then please contact me directly.

Go to Google Analytics and sign in with your Google account details to see the Oracc data, which is already being collected. You should find it quite intuitive to use but I know there's a huge amount of stuff in there.

So in particular, to find your own project's data, choose Standard Reporting from the orange bar at the top. Then in the left-hand menu go to Content, then Site Content, then Content Drilldown and look for your project abbreviation.

There's lots more to discover in GA. The inbuilt help (at the bottom of the left-hand menu) is very good and, as always, do ask me for assistance if you need it. (I've been using GA for Knowledge and Power for five years now, so know my way around quite well.)