Linking from Citation to Example in Numismatic (and other) Scholarship

I let myself follow a tangent today. It starts with noting that the article by C. Lorber and A. Meadows that I'm preparing for publication "Review of Ptolemaic Numismatics" makes frequent reference to coin types described in J. Svoronos, Ta nomismata tou kratous ton Ptolemaion. Athens, 1904-1908. It is an obvious feature of such a publication that those references lead readers to information about those coins.

To start on the journey towards such linking, I created URIs for all coin types defined in Svoronos' typology at nomisma.org. See http://nomisma.org/id/svoronos-1904-1000. There's very little description there, and what is there is cribbed from C. Lorber's translation at http://www.coin.com/images/dr/svoronos_text.html.

Now, if you go to this paragraph in Lorber and Meadows, which makes reference to Svoronos, you'll see that the link to "Sv. 1424" is live. Look towards the end of the paragraph. And note that it's possible to refer to single <p> elements in the article. That's because each one has an @id with a unique value. That's cool and important.

Follow the link to http://nomisma.org/id/svoronos-1904-1424 and you'll see further links to the ANS collection and to coinproject.com. The former is a rock-solid stable URI but the coin hasn't been photographed (hint, hint). The latter is to an interesting project that is digitizing a type corpora for many series of coins. As the editor of ISAW Papers I don't have to worry if it's super-stable. I rely on nomisma.org to provide reasonable links and to keep them current.

The end result is a hint of a richly linked and illustrated future. Again, cool. I'd like to cross-the-bridge (as it were) and deliver images of Sv. 1424 while readers are still within the "environment" of Lorber and Meadows. But the first step is implementing such links, then we can work on the user experience.

In other news.... there is now a github for ISAW Papers at http://github.com/sfsheath/isaw-papers.

"Archival" and "Presentation" versions of (x)html-based scholarship

Briefly...

• http://dl.dropbox.com/u/17002562/isaw-papers-preprint.xhtml is a link to the current "archival" version of "Review of Ptolemaic Numismatics, 1996-2007".
• http://dl.dropbox.com/u/17002562/isaw-papers-preprint-presentation.html is to a presentation-oriented version.

The presentation version changes the extension to ".html", adds some formatting to fix the page width and to justify the body paragraphs. It also adds an appendix of links to named entities at the end. That last suggests an interesting future.

The goal here is to maintain a focus on an archival version with very little formatting in it, while also exploring what the "nicer" presentation version can look like. Eventually this content will appear in a CMS-like environment. That should be attractive and functional so I'm figuring out what that means. In time, I'll add features along the lines of "pop-up" windows for geographic entities and the like. Not sure exactly what that entails but we'll find out as we go along.

And I'll move this to github in the near-ish future.

Test Bed for (X)HTML Conventions for Scholarly Publication

The main reason I joined the Institute for the Study of the Ancient World at NYU was to be part of initiating a program of digital publication of peer-reviewed scholarship. We haven't announced anything formally and this blog post isn't that announcement. It is the beginning of a nuts-and-bolts conversation about the markup of digital scholarship that is intended to encourage long-term viability, flexible re-use, and easy display (among many other things).

To get right down to business, http://dl.dropbox.com/u/17002562/isaw-papers-preprint.xhtml is the very temporary URL for a preprint version of "Review of Ptolemaic Numismatics, 1996 to 2007" by Catherine Lorber and Andrew Meadows. I'm very grateful to Andy and Cathy for their willingness to be part of this experiment. Their work is largely done. Now it's up to me to make progress on the markup and I'm hoping to do that in a very public way.

But where to begin the conversation? I think the best approach is to admit I'm in the middle of things and just start laying out issues and thoughts. Keep in mind that everything is subject to change...

• The format for ISAW digital publications is XHTML with RDFa. XHTML (for now 1.1 but moving to XHTML5) is a widely supported standard with excellent tooling that is directly viewable in many contexts. That makes it appropriate for long-term archival storage of born-digital scholarship.
• Internal reference structures are important.For now this means each <p> element has an @id. div's of class 'section' also have @id attributes. This is in anticipation of using the semantic elements of HTML5.
• Named entities will be tagged with links to stable resources describing those entities. For geography, Pleiades. For many other entities, Wikipedia. See below for RDFa patterns.
• Existing ontologies/vocabularies will be used whenever possible. Geographic entities are typed as "dcterms:Location". That sort of thing.
• Basic constructs for marking up bibliography and footnote-like structures are lacking for HTML-based markup languages. There are lots of semi-complete "best practices" but narrowing these down to a consistent and flexible convention will be an importnat process.

Looking ahead:

• Multiple formats will be supported. We will distribute this text as "raw" valid xhtml. It will be hosted in a more interactive environment that does slick things like make maps, etc. Epub, pdf... all those are coming. Again, the ease with which a base XHTML representation can be converted to these other formats is one reason to use XHTML.
• We'll use CC licenses Right now the document is CC-BY-NC-ND. We'll drop the ND eventually, perhaps the NC as well. The preprint is ND as a signal that a better version is coming from us.

A word on RDFa (a standardized way of embedding information in XHTML pages)...

The basic pattern that I'm using to markup named entities is illustrated by the sentence:
In a study of tax receipts from early Ptolemaic <a class="citation"
href="http://pleiades.stoa.org/places/991398"
typeof="dcterms:Location" rel="iana:describedby"
property="rdfs:label">Thebes</a>...

That produces the RDF/Turtle

[ a dcterms:Location ;
         rdfs:label "Thebes"@en ;
         iana:describedby <http://pleiades.stoa.org/places/991398>].

You can see the turtle for the whole document at http://bit.ly/hJjgcx.

An "English" equivalent of the turtle snippet is 'There is a site in the text with label "Thebes" and a description at http://pleiades.stoa.org/places/991398.'

I like the use of the 'describedby' @rel value here. It's defined in the IANA's register of rel values (http://www.iana.org/assignments/link-relations/link-relations.xml). I take the semantics to be "I'm not saying I'm linking to Thebes itself, only to a description of it." That seems nice and "semantic webby".

There's more to come but I'm getting this out there just to get the ball rolling...