tag:blogger.com,1999:blog-74190019875880632032024-03-14T03:11:36.275-07:00Vitruvian design for scholarship in the humanitiesNeel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.comBlogger75125tag:blogger.com,1999:blog-7419001987588063203.post-69453542595642442292015-03-07T04:17:00.001-08:002015-03-07T04:17:54.005-08:00OHOC2 FTWUnderlying the <a href="http://cite-architecture.github.io/ctsurn/">CTS URN notation</a> is the abstract model of textual structure abbreviated as <a href="http://cite-architecture.github.io/ctsurn/ohco2/">OHCO2</a>.<br />
<br />
The generality of this model is nicely illustrated by recent implementations of the Canonical Text Services (CTS) protocol. The CTS protocol provides retrieval of texts by CTS URN: implementations linked from <a href="http://cite-architecture.github.io/cts/">this page</a> use XML tree structures, relational databases and directed graph stores to store and retrieve texts.<br />
<br />
For an essential scholarly concept (identifying a citable passage of text), that's a powerful level of abstraction permitting scholars and developers to select technologies best suited to the specific kind of work they want to pursue with a citable corpus.Neel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.com9tag:blogger.com,1999:blog-7419001987588063203.post-40779886507384506382014-10-25T19:38:00.000-07:002014-10-25T19:38:41.267-07:00Open license + an iPad miniAt the end of <a href="http://www.openaccessweek.org/page/about">Open Access Week</a>, I'd like to salute the library of Leiden University for living up to the goal of making open access the norm in scholarship. If you work in its very pleasant setting, there are no restrictions on how you make use of out-of-copyright material.<br />
<br />
When I visited Leiden earlier this year, I had an iPad mini with me, so I took a few quick snaps of Codex Vossianus Graecus 1, a set of maps (perhaps sixteenth century) to accompany Ptolemy's <i>Geography</i>. Thanks to the library's policies, I can make images like available as citable scholarly resources. <br />
<br />
<table align="center" cellpadding="0" cellspacing="0" class="tr-caption-container" style="margin-left: auto; margin-right: auto; text-align: center;"><tbody>
<tr><td style="text-align: center;"><a href="http://beta.hpcc.uh.edu/tomcat/episteme/images?request=GetIIPMooViewer&urn=urn:cite:episteme:vgf1img.atlas_1722@0.3123,0.0405,0.017,0.0105" style="margin-left: auto; margin-right: auto;"><img border="0" src="http://beta.hpcc.uh.edu/fcgi-bin/iipsrv.fcgi?OBJ=IIP,1.0&FIF=/project/palimpsest/epistemepyramids/VGF1/atlas_1722.tif&RGN=0.0981,0.048,0.8859,0.7586&WID=2000&CVT=JPEG" height="226" width="400" /></a></td></tr>
<tr><td class="tr-caption" style="text-align: center;">Leiden University, Codex Voss.Gr. 1: world map in Ptolemy's first projection</td></tr>
</tbody></table>
<br />
When the phone or tablet you happen to be carrying gives you photos rivaling or surpassing anything published in print, the technology is not much of a barrier. When the default policy is that you can use your photographs as you see fit, neither is legal licensing. <br />
<br />
<br />
(To see what's legible in a quick and poorly lit snap from an iPad mini, see <a href="http://beta.hpcc.uh.edu/tomcat/episteme/images?request=GetIIPMooViewer&urn=urn:cite:episteme:vgf1img.atlas_1722">this zoomable image of folios 2-3.</a>)<br />
<br />
<br />Neel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.com1tag:blogger.com,1999:blog-7419001987588063203.post-89990757067766836882014-07-04T13:44:00.000-07:002014-07-04T14:03:42.702-07:00Paleography matters in the Declaration of Independence: a CITE responseMy colleague Tom Martin points me to <a href="http://www.nytimes.com/2014/07/03/us/politics/a-period-is-questioned-in-the-declaration-of-independence.html?emc=eta1">this article in the <em>New York Times</em></a>, reporting that Danielle Allen at the Institute for Advanced Study in Princeton has questioned the National Archives’ transcription of a a crucial phrase in the Declaration of Independence. Are Thomas Jefferson’s “self-evident truths” comprised of individual rights, or do they also include a governmental role “to secure these rights”? Your judgment could hang on whether or not you see a period followed by a long dash or simply a long dash in the original document.<br />
<br />
I browsed the National Archives web site, and found that they offer two downloadable images, one a photograph of the original parchment, and another of the 1823 engraving by William Stone, both apparently in the public domain.<br />
<br />
So I took a few minutes of my Fourth of July holiday to set up a <a href="http://beta.hpcc.uh.edu/tomcat/natarch/">CITE Image Service where you can browse and create citable references</a> of the images. Here is the detail of the crucial passage in the photograph of the parchment:<br />
<img alt="Happiness followed by punctuation" src="http://beta.hpcc.uh.edu/tomcat/natarch/images?request=GetBinaryImage&w=9000&urn=urn:cite:mid:natarchimgs.Declaration_Pg1of1_AC@0.472,0.1872,0.082,0.0213" />.<br />
In the Image Collection I created this afternoon, this detail can be cited generically with this URN<br />
<blockquote>
<span style="font-family: Courier New, Courier, monospace;">urn:cite:mid:natarchimgs.Declaration_Pg1of1_AC@0.472,0.1872,0.082,0.0213</span></blockquote>
and the URN can also be <a href="http://beta.hpcc.uh.edu/tomcat/natarch/images?request=GetIIPMooViewer&urn=urn:cite:mid:natarchimgs.Declaration_Pg1of1_AC@0.472,0.1872,0.082,0.0213">resolved to see the detail in context</a>.<br />
<br />
Contrast the Stone engraving:<br />
<br />
<br />
<figure><img alt="1823 engraving" src="http://beta.hpcc.uh.edu/tomcat/natarch/images?request=GetBinaryImage&w=9000&urn=urn:cite:mid:natarchimgs.Declaration_Engrav_Pg1of1_AC@0.465,0.1919,0.076,0.0177" /><figcaption>1823 engraving</figcaption></figure>(citable as <code>urn:cite:mid:natarchimgs.Declaration_Engrav_Pg1of1_AC@0.465,0.1919,0.076,0.0177</code>, and viewable in context <a href="http://beta.hpcc.uh.edu/tomcat/natarch/images?request=GetIIPMooViewer&urn=urn:cite:mid:natarchimgs.Declaration_Engrav_Pg1of1_AC@0.465,0.1919,0.076,0.0177">here</a>)<br />
<br />
With references like this, it would be easy to cite other examples in the document of periods and long dashes, much as participants at last week’s Homer Multitext seminar collated evidence to interpret features of the oldest extant manuscript of the <em>Iliad</em>.<br />
<br />
Conclusions? The parchment of the Declaration is hard to read, but paleography is important, and the CITE architecture that was originally created for the Homer Multitext project can be applied to any sort of paleographic problem.Neel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.com0tag:blogger.com,1999:blog-7419001987588063203.post-2229397759259517512014-05-10T07:45:00.001-07:002014-05-10T07:45:23.892-07:00More reasons to love markdown plus critic markupDeadlines for senior projects mean that in addition to the interesting challenge of <a href="http://vitruviandesign.blogspot.com/2014/04/publishing-digital-scholarship.html">how to submit genuinely replicable digital scholarship</a> to the library's institutional repository, it's time to generate pdfs so that the Graphic Arts Department can bind something for the library shelves. The projects I'm advising are formatted in markdown extended to support citation by scholarly URN (what I'm calling "citedown"). We wanted to create markdown source that could be used with <a href="https://leanpub.com/">leanpub</a>, <a href="http://beautifuldocs.com/">beautiful docs</a>, or <a href="http://johnmacfarlane.net/pandoc/">pandoc</a>, so the automated workflow has to handle some potentially complex issues resolving URNs, downloading local copies of embedded images and rewriting references to them, etc.<br />
<br />
I had been using <a href="http://criticmarkup.com/">critic markup</a> for editorial questions and copy editing, but with one eye on the calendar, I wanted to test the pdf workflow before we had a complete draft with all critic markup resolved.<br />
<br />
To my surprise, when we used pandoc to lay out the text with a LaTex book structure, it recognized the critic markup and formatted it in the resulting pdf! Comments default, appropriately, to a screaming magenta that could have been taken from a 1990s GIS palette. (Anyone who forgets to run their automated process to find and resolve critic markup will have a hard time missing these.)<br />
<br />
Pandoc has always been a major reason to love markdown's simplicity. Now it's one more reason to consider the combination of markdown plus critic markup.<br />
<div>
<br /></div>
Neel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.com2tag:blogger.com,1999:blog-7419001987588063203.post-84470719005240160252014-04-30T15:06:00.000-07:002014-04-30T15:06:01.446-07:00Publishing digital scholarship<div class="p1">
The Holy Cross Manuscripts, Inscriptions and Documents Club (HC MID) has extended its projects’ routine working practice to include a plan for publishing replicable digital scholarship. Generally, projects in HC MID generate three kinds of related material that need to be accounted for in a publication:</div>
<ul class="ul1">
<li class="li3">archival material: TEI-conformant editions of texts, and a variety of data sets in simple delimited text formats</li>
<li class="li3">analytical material: expository prose in markdown, using URNs to refer to all citable resources</li>
<li class="li3">source material for user-interfaces: interactive presentations of analytical and archival material as servlets.</li>
</ul>
<div class="p2">
All projects in the club already use git for version control in public repositories hosted on github, so it is straightforward to identify and retrieve a specific version of any repository, whether it hosts archival data sets, expository writing, or source material for servlets. In assembling a servlet for end users, the club’s projects use gradle as their build system. Typically, a build task verifies the contents of the archive with a series of automated tests, then generates an RDF graph of the entire project using the <span class="s1"><span style="font-family: Courier New, Courier, monospace;">citemgr</span></span> build system. Additional tasks can load the resulting RDF graph into an RDF server, and start up a servlet that knows how to talk to the the RDF server. The entire sequence can be reduced to a single shell script; some projects have even put a boot script of this type on a cron job that rebuilds the project graph and servlet nightly. Every step in the trip from our github repositories to a running application can be fully automated.</div>
<div class="p2">
<br /></div>
<div class="p2">
The Holy Cross Libraries have recently begun hosting an institutional repository for digital scholarship. Because members of HC MID have presented their work at several international conferences and seminars this year, the library offered to include this work in the new institutional repository, but could not realistically plan to support separate running applications for every digital project that might ever be developed at the college. How can we publish to others fully functional replicas of our digital work through institutional repositories of this kind?</div>
<div class="p2">
<br /></div>
<div class="p2">
Our solution involves only one addition to our normal working routine. With the emergence of systems like <a href="http://www.vagrantup.com/"><span class="s2">Vagrant</span></a>, it is simple to define a virtual machine configured with exactly the resources that a particular project requires. We create one further git repository, but it is the smallest of all, since in most cases it consists of little more than a Vagrant file and a shell script to provision the virtual machine. Given that <a href="https://www.virtualbox.org/"><span class="s2">Virtual Box</span></a> is freely available for essentially any host platform, we can reduce the problem of how to replicate our projects to:</div>
<ol class="ol1">
<li class="li3">be sure you have Vagrant and Virtual Box installed</li>
<li class="li3">download our virtual machine repository, and run <span class="s1"><span style="font-family: Courier New, Courier, monospace;">vagrant up</span></span> in its root directory</li>
</ol>
<div class="p2">
Our library can happily host versioned releases of these simple git repositories, and add the metadata, indexing and search services that library staff has expertise in. We change nothing in our regular work flow, and add a virtual machine definition when we are ready to publish a release of a project.</div>
<div class="p2">
<br /></div>
<div class="p2">
As we gain practical experience with this approach to replicable publication, perhaps we will discover shortcomings we do not recognize yet, but as we approach the end of the spring term for 2014, the combination of github version control, automated build systems, virtual machines and institutional repositories seems to cover the complex requirements of publishing digital scholarship as effectively as anything I am familiar with. It cleanly isolates distinct concerns, and relies on generic solutions where they are available.</div>
<div class="p2">
<br /></div>
<div class="p2">
In any case, the design is not hypothetical. Three projects will publish release versions of their work after the spring semester ends at Holy Cross.</div>
<h3>
Links</h3>
<br />
<ul class="ul1">
<li class="li6"><span class="s3">Vagrant: <a href="http://www.vagrantup.com/">http://www.vagrantup.com/</a></span></li>
<li class="li6"><span class="s3">Virtual Box: <a href="https://www.virtualbox.org/">https://www.virtualbox.org/</a></span></li>
<li class="li3">The CITE Architecture on github: <a href="http://cite-architecture.github.io/"><span class="s2">http://cite-architecture.github.io/</span></a> (including the <span class="s1"><span style="font-family: Courier New, Courier, monospace;">citemgr</span></span> build project)</li>
</ul>
Neel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.com1tag:blogger.com,1999:blog-7419001987588063203.post-7040422348699870282014-04-01T05:48:00.000-07:002014-04-01T05:48:49.216-07:00Get funding for your DH project?Try these regular expressions on the embedded youtube video:<br />
<br />
<span style="font-family: Courier New, Courier, monospace;">s/our company/our project/g</span><br />
<span style="font-family: Courier New, Courier, monospace;">s/your company/IT staff/g</span><br />
<span style="font-family: Courier New, Courier, monospace;">s/expert/developer/g</span><br />
<div>
<br /></div>
<div>
<br /></div>
<div>
<br /></div>
<br />
<iframe allowfullscreen="" frameborder="0" height="315" src="//www.youtube.com/embed/BKorP55Aqvg" width="560"></iframe><br />
<br />Neel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.com2tag:blogger.com,1999:blog-7419001987588063203.post-85047192182872168992014-03-30T13:42:00.000-07:002014-03-30T13:42:26.549-07:00Specs + tests for CTS<div class="p1">
In February, Chris Blackwell and I released a release candidate version of the <span class="s1"><a href="http://homermultitext.blogspot.com/2014/02/technically-speaking.html">CTS protocol specification</a>, 5.0.</span> Today, we are releasing a second release candidate, in parallel with a suite of tests packaged with a servlet that can run the tests and format the resulting report in a web page.</div>
<div class="p1">
<br /></div>
<div class="p1">
We are currently working on a third release candidate taking account of all the helpful comments we have received so far on rc.1, and plan to continue coordinating releases of the CTS protocol specification with parallel test suites. We expect that rc.3 will be the last candidate version before a final CTS 5.0.</div>
<div class="p1">
<br /></div>
<br />
<div class="p3">
All our released work on the CITE architecture now belongs to a <span class="s2"><span style="font-family: Courier New, Courier, monospace;">cite-architecture</span></span> group on github. For a guide to our repositories, see <a href="http://cite-architecture.github.io/"><span class="s1">the organization home page on github</span></a>.</div>
Neel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.com0tag:blogger.com,1999:blog-7419001987588063203.post-4177809580298954722014-03-26T11:34:00.002-07:002014-03-26T11:35:00.000-07:00Visualization from CITE URNs + d3 + hive maps<div class="p1">
Many software packages make it relatively easy to create visualizations of complex networks of data, but often produce hairballs that tell us more about the visual layout algorithm than the structure of the network. Martin Krzywinski has proposed an alternative, called <a href="http://www.hiveplot.net/"><span class="s1">hive plots</span></a>: lay out your nodes along a series of axes that you know have meaning in your network, and explore the network visually from there. Mike Bostock, predictably, has done <a href="http://bost.ocks.org/mike/hive/"><span class="s1">gorgeous interactive work</span></a> with Krzywinski’s idea in the d3 javascript library.</div>
<div class="p1">
<br /></div>
<div class="separator" style="clear: both; text-align: center;">
<a href="http://beta.hpcc.uh.edu/tomcat/latinsources/hivemap.html"><img alt=" hive map" border="0" src="http://1.bp.blogspot.com/-JHE-UOPqwKU/UzMdPLm5E9I/AAAAAAAAAPk/NPSSqda0bRs/s1600/hive.png" height="304" width="320" /></a></div>
<div class="p1">
I created my first hive plot this morning using d3. The screen shot above illustrates a project by Megan Whitacre (Holy Cross ’14) annotating a series of illustrated inscriptions for use in teaching introductory Latin. The five axes are (clockwise beginning from the blue axis at the top) 32 broad grammatical concepts, 71 narrower topics about the morphology of substantives, 55 topics about verbal morphology, 9 syntactic topics and, along the purple axis, 103 images. All of Megan’s annotations are expressed with CITE URNs; this makes it straightforward both to gather all references to the same image, or to apply her region of interest to highlight areas of the image. d3 practically begs for interactive displays, so you can highlight nodes or edges to see further information, or can click on image nodes to see the image with linked, highlighted areas for all references to the image.</div>
<div class="p1">
<br /></div>
<div class="separator" style="clear: both; text-align: center;">
<a href="http://2.bp.blogspot.com/-h13Kpym9IaA/UzMdWzA0bEI/AAAAAAAAAPs/mFSh4mK9uhw/s1600/imageoverlay.jpg" imageanchor="1" style="margin-left: 1em; margin-right: 1em;"><img border="0" src="http://2.bp.blogspot.com/-h13Kpym9IaA/UzMdWzA0bEI/AAAAAAAAAPs/mFSh4mK9uhw/s1600/imageoverlay.jpg" height="258" width="320" /></a></div>
<div class="p1">
<br /></div>
<div class="p1">
<br /></div>
<div class="p1">
There is plenty of room for improvement. Selecting a node or edge really out to select all direct connections to it as well, and hovering should use Megan’ rdf:Label values, instead of the raw CITE URN to identify the node, to name two obvious desiderata. But as an initial effort put together between second cup of coffee and lunch break, it’s hard to be disappointed with it. It underscores for me that as our tools improve, it becomes more and more important to have properly structured and properly citable data.</div>
<div class="p1">
<br /></div>
<br />
<div class="p1">
(The screen shot is linked to a live version of the graph.)</div>
Neel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.com0tag:blogger.com,1999:blog-7419001987588063203.post-90433961869445890212014-03-03T05:19:00.000-08:002014-03-03T05:21:20.836-08:00bl.ocks rocks<div class="p1">
<span class="s1"><a href="http://bl.ocks.org/">http://bl.ocks.org/</a></span> occupies an interesting space in the overlap of coding and writing. It lets you simultaneously view the rendering of a source page and its source code, together with commentary in the form of a README. Each bl.ock is defined simply as a github gist that follows the naming convention <span class="s2" style="font-family: Courier New, Courier, monospace;">README.md</span> for commentary (in markdown), and <span class="s2" style="font-family: Courier New, Courier, monospace;">index.html</span> for source file to be both rendered and displayed in source view. This is extraordinarily powerful when <span style="font-family: Courier New, Courier, monospace;">index.html</span> is a single-page web application, of the kind that D3 (<a href="http://d3js.org/"><span class="s1">http://d3js.org/</span></a>) encourages you to build – and Mike Bostock, the main developer of D3, just happens to be the inventor of bl.ocks as well.</div>
<div class="p1">
<br /></div>
<div class="p1">
bl.ocks are a great way to pull away the curtain and illustrate how a particular analysis or visualization works, and studying other people’s bl.ocks can be a fast route to learning a new technique.</div>
<div class="p1">
From work with Christine Bannan on the Phoros project, I’ve put up this bl.ock as we begin to map changing patterns of Athenian tribute over time:</div>
<div class="p4">
<b><a href="http://bl.ocks.org/neelsmith/9323752"><br /></a></b></div>
<div class="p4">
<b><a href="http://bl.ocks.org/neelsmith/9323752"><br /></a></b></div>
<div class="separator" style="clear: both; text-align: center;">
<span style="margin-left: 1em; margin-right: 1em;"><a href="http://bl.ocks.org/neelsmith/9323752"><img alt="Extant records of tribute payment" border="0" src="http://1.bp.blogspot.com/-W8KeclNPP1g/UxSAzyIGUiI/AAAAAAAAAPA/dKHh9Br5sIs/s1600/thumbnail.png" /></a></span></div>
<div class="p4">
<b><br /></b></div>
<div class="p4">
<b><br /></b></div>
<h3>
Links</h3>
<div class="p3">
</div>
<ul>
<li>Phoros project github repositories: http://phoros.github.io/</li>
<li>Phoros project test site: http://beta.hpcc.uh.edu/phoros/</li>
</ul>
Neel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.com0tag:blogger.com,1999:blog-7419001987588063203.post-5990209481947722242014-01-27T04:09:00.000-08:002014-01-27T04:09:21.166-08:00Environments for collaborating<div class="p1">
Cloud-based services have made collaborating on scholarly material so much easier in the last few years that it’s hard to remember how onerous it used to be. (Raise your hand if you have ever hosted your own shared version control system.)</div>
<div class="p1">
<br /></div>
<div class="p1">
<span class="s1"><a href="https://github.com/">github</a></span> is a prime example. In addition to version control, github provides each repository with a wiki, issue tracking and other services that you can use entirely through your web browser. Edit version-controlled files through the browser or in the comfort of your own computer’s OS, and push them back to a shared repository.</div>
<div class="p1">
<br /></div>
<div class="p1">
While github solves nearly every challenge of collaborating on static files or data, it does not directly address the question of how to share computational processes. How do we share with collaborators when the goal is not to show the <i>results</i> of a process, but to share the process itself? This, like so many technical challenges in humanities scholarship, is a problem we have in common with programmers who have to collaborate on writing code, and who have kindly provided us with the solution.</div>
<div class="p1">
<br /></div>
<div class="p1">
Virtual machines are half of the answer. Consumer-level hardware and VM software have reached the point where we can realistically say, “No matter what OS you’re actually using, we’ll just use a VM so we can all work on this project in Ubuntu 12.04.”</div>
<div class="p1">
<br /></div>
<div class="p1">
The other half of the answer is a system like <a href="http://www.vagrantup.com/"><span class="s1">vagrant</span></a>. Vagrant provides a way to specify the configuration of your virtual machine, and can work with many VM systems, including the freely available VirtualBox. The specification is expressed in a simple text file — ideal for sharing from your github repository! So starting from scratch, new collaborators can perfectly replicate the system you run in your project in these steps:</div>
<ol class="ol1">
<li class="li2">Make sure <span class="s2">git</span> is installed on their machines: <a href="http://git-scm.com/"><span class="s1">http://git-scm.com/</span></a></li>
<li class="li2">Install virtual box on their machines: <a href="https://www.virtualbox.org/"><span class="s1">https://www.virtualbox.org/</span></a></li>
<li class="li2">Install vagrant on their machines: <a href="http://www.vagrantup.com/"><span class="s1">http://www.vagrantup.com/</span></a></li>
<li class="li3"><span class="s3">Run this vagrant command: </span><span style="font-family: Courier New, Courier, monospace;">vagrant gem install vagrant-vbguest</span></li>
<li class="li2">Clone your project's git repository including a Vagrantfile specifying the configuration of your virtual machine</li>
</ol>
<div class="p1">
At this point, they can begin any work session within your repository directory by running</div>
<div class="p1">
<br /></div>
<blockquote class="tr_bq">
<span style="font-family: Courier New, Courier, monospace;">vagrant<span class="s4"> up</span></span></blockquote>
<div class="p4">
<span class="s4"><br /></span></div>
<div class="p1">
to start the virtual machine. (The first boot will be slow as the virtual machine is downloaded and built; after that, it’s tolerable.)</div>
<div class="p1">
<br /></div>
<br />
<div class="p2">
What is perhaps most remarkable about this sequence is that it imposes only two prior technical requirements on new collaborators: they must be able to use a web browser to download and install virtualbox and vagrant (and git, if they have not already done so); and they must be able to find a terminal or console where they can run a vagrant command. If that’s too much to demand, maybe it’s time for them to reconsider whether they’re really interested in collaborating on a digital scholarly project.</div>
Neel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.com1tag:blogger.com,1999:blog-7419001987588063203.post-20346336845213949992014-01-20T13:14:00.000-08:002014-01-20T13:14:36.885-08:00Markdown everywhereThink there's a little momentum behind markdown lately?<br />
<br />
<a href="http://mashable.com/2013/06/24/markdown-tools/">This article</a> from Mashable is already half a year old, and lists seventy-eight (78!) tools for "writing and previewing markdown"! And its topic doesn't even extend to some of the very interesting services that use markdown, like <a href="https://leanpub.com/">leanpub</a> and <a href="https://draftin.com/">draft</a>, or any of the numerous markdown-to-slideshow toolkits out there...<br />
<br />
I'm convinced enough that I've just completed an initial version of a tool for working with markdown extended to allow citation using canonical URN values, and converting the source to generic markdown that any of these tools can process. When I've polished the docs a little more, I'll post here with further notes on markdown and its increasing importance for scholarly work.<br />
<br />Neel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.com0tag:blogger.com,1999:blog-7419001987588063203.post-28843970521371103672014-01-07T13:56:00.002-08:002014-01-07T13:56:10.876-08:00Designing scholarly publications: some lessons we can take from programmers Scholarly publication involves more than just making work accessible. When scholars publish, they are contributing their work to the collective endeavor of the entire scholarly community. In order for other scholars to inspect, critique, and build upon published scholarship, it must be appropriately:<br />
<br />
<ul>
<li> identified</li>
<li> verified</li>
<li> structured for reuse</li>
<li> licensed for reuse</li>
</ul>
<br />
Scholars are fortunate that all of these requirements are shared by coders, who have consequently developed well established practices and tools to satisfy each of them. The infrastructure that programmers rely on is especially significant for digital scholarship because it has been designed for automated interaction. For humanists, the shift from creating scholarship designed for manual processing to scholarship designed to be used through the mediation of software and hardware is often an enormous challenge. My experience working with many collaborators on the Homer Muiltlitext project (HMT) has convinced me that we can greatly accelerate the progress of our digital scholarly work by learning from decades of experience in software development. (In follow-up posts, I'll illustrate some working examples that exploit the design of the HMT's digital publications.)<br />
<h2>
Identifying a digital publication</h2>
Any unit of publication must be clearly identified with a specific, fixed version. For a print monograph, this might be an edition number, and possibly also a printing; journals are normally identified by a date (year, quarter, or other cycle) and a volume or other serial count. A library catalog might then resolve that reference to a storage location identified by a call number. Digital publications likewise must be uniquely identified in a system that recognizes different editions or versions, and permits automated resolution of identifiers to a storage location.<br />
<br />
Consider what you would typically do if you were writing a Java program, and wanted to use Saxon (a library for processing XSLT). You can specify the library by its Maven coordinates, giving its "publisher," <span style="font-family: Courier New, Courier, monospace;">net.sf.saxon</span>, the name of the "publication"", <span style="font-family: Courier New, Courier, monospace;">saxon-dom</span>, and an "edition," or version, number (e.g., <span style="font-family: Courier New, Courier, monospace;">8.7</span>). You would then rely on an automated build process to retrieve a local copy from a repository that recognizes the identifier. With repository management systems such as <a href="http://www.sonatype.org/nexus">Nexus</a>, scholars can use exactly the same system of Maven coordinates to make published material automatically retrievable. The Homer Multitext project, for example, plans to use a Nexus repository to publish the project's archive of editorial work three times a year. The publications belong to the group <span style="font-family: Courier New, Courier, monospace;">org.homermultitext</span>, and will include a publication named <span style="font-family: Courier New, Courier, monospace;">hmtarchive</span>; versions will have names like <span style="font-family: Courier New, Courier, monospace;">2014.1 </span>(the first publication of the year 2014).<br />
<h2>
Verifying a publication </h2>
One of the distinguishing features of publication is that it has undergone some form of review. The review process evaluates work which, in principle, ought to be replicable. Review of digital scholarship should include not only manual evaluation, but, where applicable, automated tests assessing the data. All of us already apply an automated test whenever we run a spell checker over a text: when we produce digital work with more complex structure than simply a stream of words, more extensive digital tests are called for, and ought to be included as part of the publication.<br />
<br />
One valuable idea we can take from programming practice is "test-driven development." In test-driven development, the programmer specifies an automated test <i>before</i> beginning to write some section of a program, and works on the program until it passes the test. Of course in conventional scholarly work, we evaluate work in progress as we go along: we don't submit something for review that we have not thoroughly reviewed ourselves. But applying a test-driven approach to the editorial work of the HMT has been an eye-opening experience. Because it compels us to reckon with "minor" irregularities we might otherwise gloss over, it can expose assumptions needing more critical examination. In the HMT, one test we apply after tokenizing our edited texts, for example, is a morphological analysis of all lexical tokens, on the assumption that failures will represent either Byzantine orthographic practices unrecognized by our parsing system, or errors in our edition. We were surprised to discover a third explanation: a number of technical terms appearing in the scholia are not fact in the standard Greek lexicon by Liddell and Scott, and therefore failed to parse. When we retroactively applied our morphological tests to sections that had been edited before we adopted a full test-driven approach, we uncovered further examples that, as isolated cases, editors had not noticed.<br />
<h2>
Structuring for reuse</h2>
Complex computer programs are possible in part because reusable units of code encapsulate solutions to individual problems. For example, I should never again have to spend my time writing a program to translate ancient Greek from one encoding system to another, because I can rely on Hugh Cayless' Epidoc transcoding library. <a href="http://sourceforge.net/projects/epidoc/files/Transcoder/">Hugh's code has a clean interface</a>: define the system you're translating from, the system you're translating to, and then the `getString` method hands you your result.<br />
<br />
One of the major challenges humanists need to address today is how to design APIs to digital scholarship. What are the appropriate components or methods, and how should they be identified? At a minimum, a scholarly publication should address this question in two ways:<br />
<br />
<ol>
<li>Citations of source material should be expressed in technology-independent but machine-actionable notation. In the absence of an alternative that fully accomplishes this, that he Homer Multitext project has developed a URN notation for texts (CTS URNs) and for discrete objects (CITE Object URNs), as well as an extension to CITE Object URNs for resolution-independent citation of regions of interest on an image.</li>
<li>If sections of the publication itself can be cited, they too should be addressable with CTS URNs based on some logical unit (and not by accidental physical features such as page numbers).</li>
</ol>
<br />
<h2>
Licensing for reuse</h2>
The act of publication alienates a work of scholarship from the author in a form that others can use, and contributes it to the scholarly community. In addition to an appropriate technological design, scholarly publications must therefore be available under an appropriate license that must allow at least non-commercial reuse. For programmers, the leading such license is the GNU General Public License (<a href="http://www.gnu.org/licenses/gpl.html">GPL</a>]), and this is ideal for source code included in scholarly publication; for other kinds of digital data, the <a href="http://creativecommons.org/">Creative Commons project</a> has defined Attribution-ShareAlike licenses that achieve the same aim.<br />
<br />
Highly trained attorneys around the world have contributed their time and expertise to developing these licenses, and in many instances tailoring them to the specific requirements of local legal systems, as well as translating them into a large number of languages. The easiest part of designing your publication should be taking advantage of their work and applying one of these licenses to your work.<br />
<br />Neel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.com3tag:blogger.com,1999:blog-7419001987588063203.post-19566589082338734252013-12-30T03:45:00.003-08:002014-01-04T08:50:54.966-08:00The APA privatizes, tooUnlike many of my colleagues and friends in Classics Departments around the US and abroad, I will not be travelling to Chicago this week for the annual meeting of the American Philological Association. The APA continues to accept donations to a recently completed capital campaign with the goal of supporting a digital "Center for Classics Research and Teaching." (See the <a href="http://apaclassics.org/support-apa/gatekeeper-gateway">description here</a>.) The APA claims that its center will "make high quality information about the Classical World available in accessible formats to the largest possible audience by using technology in new and exciting ways," but has never clearly addressed the fact that, as proposed, the center will include material for APA members only.<br />
<br />
<a href="http://vitruviandesign.blogspot.com/2013/12/elsevier-does-not-publish-it-privatizes.html">Like Elsevier and some other distributors</a>, in other words, the APA wants to control who can read scholarly work as part of its "business model." Like Elsevier, the APA leadership is doubtless sincere in its belief that its "business model" is paramount. But like Elsevier, the APA winds up in a Wonderland, where, with Humpty Dumpty, we can make words mean whatever we choose. The idea that closed-access material could be available to "the largest possible audience" is ludicrous. <a href="http://en.wikipedia.org/wiki/Internet_Census_of_2012">In 2012, over a billion IPv4 addresses were in use</a>, and, while difficult to estimate, the number of individual internet users is certainly much higher. It must exceed the APA's membership by at least six orders of magnitude. (That is, the number of internet users is surely at least 100,000 times greater than the number of APA members.)<br />
<br />
More simply, like Elsevier, the APA's plan privatizes scholarly work that should be published. In criticizing Elsevier's business practices, I argued that<br />
<br />
<blockquote class="tr_bq">
Scholarly publication in a digital world means that a work is openly accessible for others to inspect, critique, and build upon, and we should insist that in reviews for tenure and promotion, only scholarly publications meeting this definition qualify as published work.</blockquote>
<br />
We should hold professional organizations to the same standard. <br />
<br />
Unfortunately, just as these essential scholarly values are often ignored in reviews of individuals for tenure and promotion, they are often likewise neglected in evaluation of funding requests from educational institutions, federal programs and private philanthropic organizations. There is no quick or easy way to change these entrenched practices that directly oppose the basic working method of scholarship. But I have the choice <b>not</b> to become a member of (and support with my membership fees) an organization that is building a system of information apartheid.<br />
<br />
If you are at the APA this week, try to get a clear answer to a yes/no question: will the APA's digital publications be openly accessible for others to inspect, critique, and build upon?<br />
<br />
<br />Neel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.com2tag:blogger.com,1999:blog-7419001987588063203.post-14743599972001605142013-12-19T05:44:00.000-08:002014-01-04T08:50:29.761-08:00Elsevier does not publish: it privatizesIf you were shocked that <a href="http://www.blogger.com/"><span id="goog_953129176"></span>Elsevier has apparently issued a takedown notice to the University of Calgary</a>, you should consider auditioning for <a href="https://www.youtube.com/watch?v=nM_A4Skusro">Claude Rains' role in <i>Casablanca</i></a>. Elsevier has never hidden the fact that its business model depends on restricting access to scholarly work. Alicia Wise of Elsevier responds to the post linked above with this question:<br />
<br />
<blockquote class="tr_bq">
the business model is based largely on paid access post-publication, and if freely accessible on a large scale what library will continue to subscribe?</blockquote>
<br />
The question may be sincerely intended, but its logic is straight from <i>Alice in Wonderland</i>: if Elsevier cannot profit by making scholarship publicly available — that is, by <i>publishing</i> it — then it must privatize the information, and sell access only to clients who cede to Elsevier control over who may read the scholarly work.<br />
<br />
The intellectual roots of western scholarship reach back to ancient Greece, and the radical idea that scholarly understanding is not determined by political or social power. (This is exemplified in the famous story of Euclid telling his patron and monarch, Ptolemy, that "there is no royal road to geometry.") In our modern academic institutions, publication exposes scholarly work to public scrutiny, and serves in part to ensure that scholarly claims are not based on power over information.<br />
<br />
Elsevier and others subvert this fundamental scholarly activity when they privatize scholarship, a simple fact that we obfuscate when, with an Orwellian twist of language, we call it "publication." It is true that scholars who freely hand over their work to privatizers make the system possible, but who can blame an untenured faculty member who will be <i>rewarded</i> for contributing to the dysfunction?<br />
<br />
We should instead unambiguously reiterate that scholarly publication in a digital world means that a work is openly accessible for others to inspect, critique, and build upon, and we should insist that in reviews for tenure and promotion, only scholarly publications meeting this definition qualify as published work.<br />
<br />
How quickly would Elsevier's pool of submissions dry up if enough universities adopted and enforced such a requirement for real scholarly publication?<br />
<div>
<br /></div>
Neel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.com0tag:blogger.com,1999:blog-7419001987588063203.post-12374943219728441192013-12-11T05:30:00.002-08:002013-12-11T05:30:33.870-08:00What humanists doI recently stumbled across an interview with the very articulate Astronomer Royal Martin Reese that included this observation:<br />
<br />
<blockquote class="tr_bq">
But the aim of science is to unify disparate ideas, so we don't need to remember them all. I mean we don't need to record the fall of every apple, because Newton told us they all fall the same way.</blockquote>
<br />
(The full transcript of the interview is <a href="http://www.onbeing.org/program/cosmic-origami-and-what-we-dont-know/transcript/6056">here</a>, under the arresting title "Cosmic Origami and What We Don't Know.")<br />
<br />
I think that this remark really captures a quintessential difference between the natural sciences and the humanities. Humanists, too, unify disparate ideas, but we <i>must</i> record each unique phenomenon that we study. If we develop a unified view of oral poetry, for example, we will never conclude that "I'm familiar with the <i>Iliad</i>, so I don't have to remember the <i>Odyssey</i>," or "I've studied Greek poetry so I don't need to know about the Serbo-Croatian oral poetry that Parry and Lord recorded." We don't study apples. Recording and remembering are basic to scholarship in the humanities.<br />
<br />
This has important implications for how we work in a digital world. We record and remember through citation, so before anything else we must develop a sound infrastructure for citation. Neel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.com0tag:blogger.com,1999:blog-7419001987588063203.post-20498855933551584532013-10-25T07:57:00.002-07:002013-10-25T09:45:57.787-07:00markdown + criticmarkupIt's been a year since I last posted about <a href="http://vitruviandesign.blogspot.com/2012/08/markupdown.html">markdown</a>, and in that time, the number of interesting applications and services has continued to grow rapidly. (If you use markdown and haven't looked at <a href="https://leanpub.com/">leanpub</a> yet, you owe it to yourself to take a peek!)<br />
<br />
I've been looking recently at using <a href="http://criticmarkup.com/">criticmarkup</a> together with markdown, and it seems really promising. <a href="http://omz-software.com/editorial/">Editorial</a> on the iPad and both <a href="http://multimarkdown.com/">Multimarkdown Composer</a> and <a href="http://marked2app.com/">Marked2</a> on OS X support displaying criticmarkup within your editor. <br />
<br />
It would be nice to have equally convenient ways to automate accepting or rejecting suggested additions, deletions or changes, but the OS X system services in the criticmarkup site's toolkit did not work correctly when I installed them, so I'm gisting a couple of perl scripts that accept or reject criticmarkup in standard input. <br />
<br />
<ul>
<li>gist to <a href="https://gist.github.com/neelsmith/7152548">accept criticmarkup</a></li>
<li>gist to <a href="https://gist.github.com/neelsmith/7152563">reject criticmarkup</a></li>
</ul>
<div>
<br /></div>
<div>
It shouldn't be a big job to turn those into system services. I've never used OS X's Automator, but maybe that would make a good afternoon project...?</div>
<div>
<br /></div>
Neel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.com0tag:blogger.com,1999:blog-7419001987588063203.post-8523553359103968532013-09-28T06:33:00.004-07:002013-09-28T14:53:01.018-07:00The instrumentalist fallacy and academic publicationIt is easy to confuse a tool with the task it is supposed to accomplish. This does not necessarily cause problems when the tool and task are perfectly matched, but easily leads to misapplication of the tool. A bicycle is a wonderful means of transportation, but should not be used to travel across bodies of water, for example. I call this confusion "the instrumentalist fallacy," and I deal with it daily in my digital scholarly work.<br />
<br />
The academic review process has instutionalized the instrumentalist fallacy in some specially harmful ways. I read <a href="http://www.wired.com/wiredenterprise/2013/06/cades-witty-headline-here/">this account of a group of mathematicians who used a github repository to coauthor a book</a>: any one can clone their source, and offer improvements for the authors to pull into a subsequent version. One of the principal authors has an enlightening post about the process <a href="http://math.andrej.com/2013/06/20/the-hott-book/">here</a>.<br />
<br />
Note the contrast that both the <i>wired</i> interview and the author's blog post point out: the authors chose an open collaborative process <i>because it resulted in better scholarship</i>, but understood that <i>they would receive less professional recognition or credit for it</i>.<br />
<br />
The instrumental fallacy equates the instrument— the traditional publishing process — with its goal, vetting the quality of scholarly work. Is it too radical to suggest that the way to assess the quality of a scholarly publication might be ... to read it?<br />
<br />
See:<br />
<br />
<ul>
<li>the <a href="http://homotopytypetheory.org/book/">home page for the HoTT book</a></li>
<li>the <a href="https://github.com/HoTT/book">github repository for the book</a></li>
</ul>
<br />
<br />Neel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.com4tag:blogger.com,1999:blog-7419001987588063203.post-52797742969803101172013-08-19T08:12:00.000-07:002013-08-19T14:04:59.441-07:00What scholarship looks likeThe Leipzig "Open Philology" workshop reinforced a fact that I (re)learn constantly from my work advising Holy Cross' "Manuscripts, Inscriptions and Documents Club": that the most important changes brought about to scholarship by new technology are not technological, but intellectual and social.<br />
<br />
It's not easy for someone of my generation to imagine how significant research in Classics can be collaborative, and can engage people of a wide range of ages (even people without university-level degrees, something my training conditions me to view as a heresy), but there's no mistaking it when you get to watch it happen. In Leipzig, the best example was "Team Croatia": five participants from Zagreb, led by their gifted teacher and scholar, Neven Jovanović (far right in the photo below).<br />
<br />
<div class="separator" style="clear: both; text-align: center;">
<a href="http://4.bp.blogspot.com/-F2Ec7TMGYV8/UhI1huyUnmI/AAAAAAAAANc/ugX0oki3YpM/s1600/team-croatia.jpg" imageanchor="1" style="margin-left: 1em; margin-right: 1em;"><img border="0" height="214" src="http://4.bp.blogspot.com/-F2Ec7TMGYV8/UhI1huyUnmI/AAAAAAAAANc/ugX0oki3YpM/s320/team-croatia.jpg" width="320" /></a></div>
<br />
<br />
A mediocre cell-phone snap shows what this kind of activity can look like: two computers, but one temporarily ignored as three pairs of eyes focus intently on the same screen. A single pair of hands is not enough to capture the action in real time: if this were a piano composition for four hands, this movement would be marked "presto". <br />
<br />
If we're going to lay a digital foundation for classical studies, this is the kind of team that will make it happen.<br />
<br />
<b>Update</b>: thanks to Neven for helping me correctly spell the names of Team Croatia: Juraj Ozmec, Željka Salopek, Jan Šipoš and Anamarija Žugić. (Pictured above with Neven: Anamarija Žugić and Juraj Ozmec).<br />
<div>
<br /></div>
Neel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.com0tag:blogger.com,1999:blog-7419001987588063203.post-58086270330251515052013-08-19T04:49:00.003-07:002013-08-19T08:12:21.827-07:00Milk and honey in LeipzigI took part this month in the Leipzig "Open Philology Workshop" organized by Greg Crane. While I was only able to participate in some of the changing three-ring circus of events, I got a view onto the promised land. Out of the many highlights of the workshop, here are three that are individually significant, and, taken together, will have enormous consequences for classicists.<br />
<br />
<h3>
1. A billion words of Greek</h3>
I worked with a large team planning to digitize a billion words of Greek. Thanks in no small part to work by Bruce Robertson and Federico Boschetti improving OCR of polytonic Greek, we designed a detailed work flow automating many of the steps in moving from a physical volume in a library, to an openly licensed, citable, digital edition. <br />
<br />
We live in a very different world than just a few years ago. When the costs of digitization were extremely high, both private interests (like publishers) and academic projects (even projects with the sponsorship of professional organizations and funding from national agencies) successfully persuaded individuals and libraries to give up their scholarly freedom (along with, of course, exorbitant licensing fees) for access to proprietary data banks of texts. Without the same barriers of cost, we can now insist instead on digital corpora comprising the kinds of texts we should always have demanded: structured for scholarly citation, and licensed for scholarly reuse. At this point, whether the Billion Words project literally achieves its goal of digitizing 10^9 words of Greek over the next five years is immaterial: when the first digital edition comes out of that pipeline, we can begin to put behind us the historically brief but shameful aberration when we thought it was acceptable to trade away our freedom to read and share classical texts in exchange for more convenient access to ancient Greek for a privileged few.<br />
<h3>
2. Perseus lexical inventory and morphology services</h3>
Bridget Almas and Marie-Claire Beaulieu are extending the Perseus lexical inventory and morphological services to keep each in sync with the other as they are dynamically edited.<br />
<br />
This is exceptionally important, and indeed urgent, precisely because of the Billion Words project. As the contents of its new digital editions can be automatically tested, we will be able to extend the lexicon when unattested material appears, and improve the morphological analyzer when it fails to recognize valid forms. Not only will the Billion Words project improve the lexical inventory and morphological analyzer: repeating automated testing of the Billion Words corpus with the iteratively updated inventory and analyzer will allow the Billion Words project to state with unprecedented clarity what levels of validation each work in its corpus has passed.<br />
<h3>
3. A text citation tool</h3>
I was caught completely by surprise by Hugh Cayless' work on a javascript tool letting users select arbitrary pieces of (or even points in) a TEI document displayed in a web browser. While the CTS URN notation can easily express such arbitrary ranges of text, the challenges in building an interface highlighting spans of text that can cross multiple XML element boundaries and that might start and end in elements that do not constitute well-formed XML are so difficult that I would have said it was impossible to implement practically for real, complex texts.<br />
<br />
Characteristically, Hugh showed a working implementation that was visually appealing, very responsive, and worked flawlessly on exceptionally complex passages from Servius' commentary on the <i>Aeneid</i>. So much for my scepticism. Equally characteristically, while Hugh's initial use case was a very limited application, he recognized the generality of the problem he had solved, and plans to fork the citation tool as a separate project that can express selections as CTS URNs. Chris Blackwell and I look forward to packaging Hugh's TEI Text Citation Tool along with Chris' Image Citation Tool as part of the standard suite of CITE services and utilities that we work with on the Homer Multitext project.<br />
<h3>
A whole greater than the sum of the parts</h3>
Bruce Robertson, Bridget Almas, and Hugh Cayless have long track records as three of the most talented contributors to the digital study of classics I have ever seen, so I suppose it is unsurprising that they would each, yet again, contribute something remarkable. What was different in Leipzig in August, 2013, was the synergy that their work illustrates. The internet can facilitate many kinds of collaboration, but nothing can fully replicate what happens when people sit in the same room, talk over coffee or dinner, and have unscheduled opportunities to follow up easily in further face to face conversations. While each of the three highlights I've chosen here deserves more discussion in future posts, consider their connections to each other: we can see the real beginnings of a vast digital corpus of Greek; the corpus is being automatically tested, and related to a citation-based inventory of Greek vocabulary, and to a morphological analyzer that can relate surface forms in the texts to lexical entities in the inventory; the moment the digital edition appears, a UI that runs in any web browser will let users cite any part of the corpus with technology-independent canonical citations.<br />
<br />
Is there another discipline in the humanities that offers this kind of digital foundation in 2013? Perhaps, but I am not familiar with anything rivaling what I saw happening in Leipzig. <br />
<br />
<br />
<br />
<br />Neel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.com0tag:blogger.com,1999:blog-7419001987588063203.post-74678487773071501962013-05-26T11:31:00.001-07:002013-05-27T04:19:56.224-07:00What's wrong with wikipediaThe reason wikipedia, for all its usefulness, is absolutely wrong for scholarship in the humanities is not the fact that it's crowd-sourced. Contrary to what some people imagine, the problem is not the lack of a recognized editorial authority: to the contrary, the problem with wikipedia is precisely that its explicit editorial policy gets the authority of evidence in the humanities wrong.<br />
<br />
I can't say it more succinctly than wikipedia itself does. I took the following screen grab today from the wikipedia article on "RDF Schema." If it's hard to read, <a href="http://shot.holycross.edu/backwards.jpg">here's a larger version</a>. The text reads, "This article relies on references to primary sources. Please add references to secondary or tertiary sources."<br />
<br />
<div class="separator" style="clear: both; text-align: center;">
<a href="http://3.bp.blogspot.com/-YVYgp6SH6jw/UaNBDvnpYJI/AAAAAAAAAMc/Qrhkl2eTqn8/s1600/backwards.jpg" imageanchor="1" style="margin-left: 1em; margin-right: 1em;"><img border="0" height="85" src="http://3.bp.blogspot.com/-YVYgp6SH6jw/UaNBDvnpYJI/AAAAAAAAAMc/Qrhkl2eTqn8/s400/backwards.jpg" width="400" /></a></div>
<div class="separator" style="clear: both; text-align: center;">
<br /></div>
This is not just slightly misdirected: it is 180 degrees off target. There is no way to misunderstand more completely the logic of an argument using evidence in the humanities.<br />
<br />Neel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.com2tag:blogger.com,1999:blog-7419001987588063203.post-42019327045916196082013-05-05T15:49:00.002-07:002013-05-06T13:51:08.999-07:00Reading the Iliad in Worcester<div class="tr_bq">
Friday was the next-to-last day of classes at Holy Cross. Driving home, I was thinking about how to respond in Monday's final meeting to some of the questions students in my intermediate Greek class have been raising. We have been reading the <i>Iliad</i>, most recently book 22. Perhaps they were conditioned to expect a simpler, Hollywood narrative, but many students were finding the complexity and ambiguity of the <i>Iliad</i> both more powerful and more challenging than they had expected. Several were troubled that when Achilles tells Hector, "Don't talk to me of 'agreements': lions and men don't make treaties; wolves and sheep don't have understandings" (22.261-22.263), he suggests that he and his hated enemy belong to different species. There is no possibility of human relation between the two of us, Achilles says, and the end will be bloodshed. (22.264-22.267). But which of the two heroes does Achilles' simile really dehumanize?</div>
<br />
When I crested the hill on Hammond Street, I was, unexpectedly, stuck in traffic. Main Street was completely blocked off, and a police detail was directing single lines of cars through the resulting jam. I didn't see any smoke, so I assumed it wasn't a fire, but it was obvious from the flashing blue lights and the line of TV "live-coverage vans" with their extended satellite dishes that something out of the ordinary had happened.<br />
<br />
<div class="separator" style="clear: both; text-align: center;">
<a href="http://www.telegram.com/apps/pbcsi.dll/bilde?Site=WT&Date=20130505&Category=NEWS&ArtNo=105059817&Ref=AR&Profile=1116&MaxW=740" imageanchor="1" style="margin-left: 1em; margin-right: 1em;"><img border="0" height="250" src="http://www.telegram.com/apps/pbcsi.dll/bilde?Site=WT&Date=20130505&Category=NEWS&ArtNo=105059817&Ref=AR&Profile=1116&MaxW=740" width="400" /></a></div>
<br />
<br />
I only found out after I finally got home that the blockade was due to protestors outside Graham Putnam and Mahoney Funeral Parlors, the funeral home that has taken in the body of Tamerlan Tsarnaev. (For a brief profile of Peter Stefan, the remarkable director of Graham Putnam and Mahoney, see <a href="http://www.telegram.com/article/20130504/COLUMN01/305059973">this column from the Worcester Telegram and Gazette</a>.)<br />
<br />
The angry crowd was protesting the idea of burying a mass killer.<br />
<br />
So on Monday, we'll think about why the poem's final resolution arrives not in book 22 with the slaying of Hector, or in book 23 with the funeral games honoring Patroclus, but in 24.804:<br />
<br />
<blockquote>
ὣς οἵ γ᾽ ἀμφίεπον τάφον Ἕκτορος ἱπποδάμοιο. </blockquote>
<blockquote>
So they saw to the burial of Hector, tamer of horses.</blockquote>
Neel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.com1tag:blogger.com,1999:blog-7419001987588063203.post-13157253153868884532013-04-17T07:25:00.001-07:002013-04-17T07:25:43.851-07:00GUT"Grand Unification Theory" may be a touch grandiose, but the underlying libraries used in the Homer Muiltitext project now generate RDF statements that fully express all three types of CITE-architecture information: textual archives, archives of data collections, and indices relating citable objects to other citable objects or to raw data. There will be lots of interesting connections to explore in the resulting unified graph of scholarly material. <br />
<br />
In parallel with this, I've now implemented the CTS protocol, the CITE Collections Service protocol, and its extension with the CHS Image protocol in servlets drawing on a SPARQL endpoint, so creating a complete CITE environment can be reduced to:<br />
<br />
- build all RDF (automatically), and import into a triple store<br />
- drop the three servlets for CITE services into a servlet container<br />
- install the iipsrv fastcgi for working with binary image data. This is the most troublesome step on many platforms, but happily iipsrv is now available as a package under debian.<br />
<br />
Not bad. Chris Blackwell is preparing an image for <a href="http://www.raspberrypi.org/">the < $50 raspberry pi</a> with these requirements preinstalled: a complete CITE Box roughly the size of an Altoids container.<br />
<br />
As we review the schemas used in the services this month, we'll begin looking at defining a more permanent RDF vocabulary. I'm not sure at this point if we need to break out a generic CITE vocabulary distinct from a specific HMT vocabulary, or whether one ontology will suffice. We'll be looking at other projects' work: thanks to Joel Kavlesmaki for pointing to the useful list <a href="http://wiki.digitalclassicist.org/RDF_vocabularies_for_classicists">here</a>.<br />
<br />
<br />
<br />
<br />
<br />Neel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.com0tag:blogger.com,1999:blog-7419001987588063203.post-41046617213449592972013-04-14T10:54:00.000-07:002013-04-14T10:54:35.529-07:00CITE Collection InventoryIn parallel with <a href="http://vitruviandesign.blogspot.com/2013/04/updating-cts-textinventory-schema.html">Friday's update to the schema for CTS text inventories</a>, CITE Collection inventories now include an optional <span style="font-family: Courier New, Courier, monospace;">urn</span> attribute on the schema for Collections. Bump your build system's dependency for the cite library up to <span style="font-family: Courier New, Courier, monospace;">0.12.2</span> to include this change.<br />
<br />
As with the CTS TextInventory, we plan to make the Collection inventory's <span style="font-family: Courier New, Courier, monospace;">urn</span> attribute mandatory in 0.13, and will drop the parallel <span style="font-family: Courier New, Courier, monospace;">name</span> attribute in 0.14.<br />
<br />
<br />
<br />Neel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.com1tag:blogger.com,1999:blog-7419001987588063203.post-78872032952852303922013-04-12T07:57:00.000-07:002013-04-12T09:19:01.583-07:00Updating the CTS TextInventory schemaScott Mcphee points out the absurdity of a Canonical Text Service (CTS) definition that uses CTS URNs for all retrieval requests, but doesn't include CTS URNs in the service's TextInventory. The historical explanation for the inconsistency is embarassingly simple: the TextInventory schema predates the invention of CTS URNs, and has not been revisited since! That oversight is rectified with today's release of version 0.12.1 of the CITE schemas package.<br />
<br />
Ultimately, we want to arrive at catalog entries with urn attributes that look like this:<span style="font-family: Courier New, Courier, monospace;"></span><br />
<br />
<br />
<span style="font-family: Courier New, Courier, monospace;"><textgroup urn="urn:cts:greekLit:tlg0012"></span><br />
<span style="font-family: Courier New, Courier, monospace;"> <groupname xml:lang="eng">Homeric poetry</groupname></span><br />
<span style="font-family: Courier New, Courier, monospace;"> <work urn="urn:cts:greekLit:tlg0012.tlg001" xml:lang="grc"></span><br />
<span style="font-family: Courier New, Courier, monospace;"> <title xml:lang="eng">Iliad</title></span><br />
<span style="font-family: Courier New, Courier, monospace;"> <edition urn=":cts:greekLit:tlg0012.tlg001"></span><br />
<span style="font-family: Courier New, Courier, monospace;"> <label xml:lang="eng">Allen (OCT 1931)</label></span><br />
<span style="font-family: Courier New, Courier, monospace;"> </edition></span><br />
<span style="font-family: Courier New, Courier, monospace;"> </work></span><br />
<span style="font-family: Courier New, Courier, monospace;"></textgroup></span><br />
<br />
<br />
With release 0.12.1, the <span style="font-family: Courier New, Courier, monospace;">urn</span> attribute is now optional but strongly recommended, alongside the previous <span style="font-family: Courier New, Courier, monospace;">projid</span> attribute. With release 0.13.0, the <span style="font-family: Courier New, Courier, monospace;">urn</span> attribute will be required, and the <span style="font-family: Courier New, Courier, monospace;">projid</span> attribute deprecated. With release 0.14.0, the <span style="font-family: Courier New, Courier, monospace;">projid</span> attribute will be dropped.<br />
<br />
So grab <span style="font-family: Courier New, Courier, monospace;">cite-0.12.1-schemas.zip</span> from our nexus repository to get started with a modern TextInventory identifiying texts by URN. You can <a href="http://beta.hpcc.uh.edu/nexus/content/repositories/releases/edu/harvard/chs/cite/">manually download a zip bundle from the repository</a>, or update your maven coordinates with <span style="font-family: Courier New, Courier, monospace;">groupId "</span>edu.harvard.chs", <span style="font-family: Courier New, Courier, monospace;">artifactId</span> "cite" and version "0.12.1".<br />
<br />
[Updated: bumped version from 0.12.0 to 0.12.1 after adding trailing slash to dc namespace as requested by Bridget Almas]<br />
<br />
<br />
<br />
<br />Neel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.com2tag:blogger.com,1999:blog-7419001987588063203.post-50404251820124082252013-04-11T10:14:00.002-07:002013-04-11T10:16:10.900-07:00How hard is it to imagine "popular scholarship"?I heard an interesting talk yesterday at Clark University by Robert Anderson, former director of the British Museum, on "The British Museum and Library at the New Millennium:" wonderful anecdotes from the early history of the museum, and a compelling argument for the essential intellectual unity of what museums and libraries do.<br />
<table cellpadding="0" cellspacing="0" class="tr-caption-container" style="float: right; margin-left: 1em; text-align: right;"><tbody>
<tr><td style="text-align: center;"><a href="http://2.bp.blogspot.com/-n1TRIrYJqPk/UWbnb54IO7I/AAAAAAAAALI/gJGGmUmMy-M/s1600/British_Museum_Dome.jpg" imageanchor="1" style="clear: right; margin-bottom: 1em; margin-left: auto; margin-right: auto;"><img border="0" height="212" src="http://2.bp.blogspot.com/-n1TRIrYJqPk/UWbnb54IO7I/AAAAAAAAALI/gJGGmUmMy-M/s320/British_Museum_Dome.jpg" width="320" /></a></td></tr>
<tr><td class="tr-caption" style="text-align: center;">The British Museum Great Court. <br />
Photograph by Eric Pouhier, <br />
licensed under cc-by-sa license.</td></tr>
</tbody></table>
<br />
Two details troubled me. First, while the rare book library at Clark was filled, I saw only one student, and I probably fell well below the median age of the audience. The talk was sponsored by the "Friends of the Goddard Library," but if this audience was representative, the library won't have too many friends in a few more years.<br />
<br />
Second, both Anderson's talk and some of the discussion afterward made some curious assumptions about scholarship. As the director at the time of the separation of the British Library from the Museum, and the opening of the fabulous facility at the new Euston Road location, Anderson offered insightful comments on the tensions of an institution committed both to free public access and to serving the needs of specialist scholars. He brought up a problem familiar to anyone who has worked at the BL recently: it's such a popular place, that all the desks fill up early in the morning with students looking for a comfortable place to work (with free wifi and good coffee!), but who aren't necessarily taking advantage of any of the unique offerings of the British Library. This can impose a real hardship on people working on projects that depend on BL material. Two assumptions emerged in the discussion that struck me as odd: that the results of scholarly research would only be of interest to a small circle of specialists; and that digital material should be openly viewable, but scholarly research was being well served by a policy that allows free reuse of scholarly material only in print publications with a very limited print run.<br />
<br />
<table cellpadding="0" cellspacing="0" class="tr-caption-container" style="float: left; margin-right: 1em; text-align: left;"><tbody>
<tr><td style="text-align: center;"><a href="http://4.bp.blogspot.com/-2Av3dtIL5Mg/UWbpRT4tlEI/AAAAAAAAALU/Ck2setouN0Y/s1600/British_Library_interior.JPG" imageanchor="1" style="clear: left; margin-bottom: 1em; margin-left: auto; margin-right: auto;"><img border="0" height="212" src="http://4.bp.blogspot.com/-2Av3dtIL5Mg/UWbpRT4tlEI/AAAAAAAAALU/Ck2setouN0Y/s320/British_Library_interior.JPG" width="320" /></a></td></tr>
<tr><td class="tr-caption" style="text-align: center;">Interior of the British Library.<br />
Photograph by Maria Giulia Tolotti<br />
licensed under cc-by-sa license.</td></tr>
</tbody></table>
Let's parse that logic a little more closely: scholarly reuse of BL material is OK as long as not too many people care to read it; and that's fine, because scholars' research is only of interest to a handful of other specialists, and expensive print media are an adequate way to meet this need. (The host's introduction of Anderson referred light-heartedly, in what was evidently intended to be humor, to the fact that his most recent multi-volume publication costs hundreds of dollars.)<br />
<br />
If we think the goal of scholarly research is to produce high-priced monographs of interest only to other specialists, is it really a surprise that the general reading public sees in the British Library a wonderful café? If we think of "digital access" as a way of entertaining or at best informing a wide public, without inviting scholars to build upon the digital foundations of the BL's collections, is it any wonder that visitors to the BL are not drawn to the library's unique resources, but instead spend their time with the amazing hodge podge of entertainment and information that populates the internet?<br />
<br />
(Footnote: I was able to include the photographs by Eric Pouhier and Maria Giulia Polotti, without regard for how many people might view them, because both are available from wikimedia commons under the terms of a cc-by-sa license.)<br />
<br />Neel Smithhttp://www.blogger.com/profile/10590621399352493304noreply@blogger.com0