<?xml version="1.0" encoding="ISO-8859-1"?>
<html xmlns:xsp-request="http://apache.org/xsp/request/2.0" xmlns:xsp="http://www.apache.org/1999/XSP/Core"><head http-equiv="Content-type" content="text/html" charset="UTF-8"><link title="TextServer house style" rel="stylesheet" href="tsstyle.css" type="text/css"/><title>An Implementation of the TextServer protocol for Classics@</title></head><body><div class="header">
<p>Cache display copy from <a href="http://chs75.harvard.edu/projects/classics-at-textserver/home">http://chs75.harvard.edu/projects/classics-at-textserver/home</a>, 2004-04-28; not for use in applications.</p>
<p>
TextServer reference implementation: index services

<br/>
<a href="home">home page</a>
! <a href="configure">install/configure</a>
</p>
</div><h1>
Classics@ TextServer.
</h1><h2>Overview</h2><p>
This is an implementation of the TextServer protocol for serving the content of Classics@, starting with Volume 2. The page you are looking at allows basic interaction with those texts via the protocol's queries. More human-friendly access to this material are available at <a href="http://chs.harvard.edu">chs.harvard.edu</a>. (Refer to
<a href="http://shot.holycross.edu/projects/TextServer">
http://shot.holycross.edu/projects/TextServer</a>
for more information about the TextServer protocol.)
</p><p>
All code in this Cocoon application is
released under the GPL:  see
the <a href="README">README</a> file.
</p><h2>Required services</h2><p>The following request methods are required for
all TextServers.
</p><ol>

<li><strong>GetCapabilities</strong>:
returns an XML description of the
functionality annd contents of this server.

<form method="get" action="GetCapabilities">
<input type="submit" value="Get capabilities"/>
</form>
</li>


<li><strong>GetWorks</strong>:  the sample
documents include a textgroup numbered named d-anderson.
<form action="GetWorks">
<input name="textgroup" value="d-anderson" size="15"/>
<input type="submit" value="Get works"/>
</form>
</li>

<li><strong>GetValidReff</strong>:
the sample documents include
a work number 2004 for textgroup "d-anderson".  
To request a specific translation or edition,
or a specific exemplar, consult the GetCapabilities
output for valid values.
<br/>
Optionally, you 
may also specify the TEI div-level to return
valid references (n attributes)  for.


<form action="GetValidReff">
Text group: <input name="textgroup" value="d-anderson" size="15"/> 
Work: <input name="work" value="2004" size="15"/> 
Level: <input name="level" value="1" size="3"/>

<br/>
Edition: <input name="edition" value="01" size="5"/>
Translation: <input name="translation" value="" size="5"/>
<!-- Do we want to support exemplars for GetValidReff?
<br/>
Exemplar: <input name="exemplar" value="" size="3"/>
-->
<input type="submit" value="Get valid references"/>
</form>
</li>

<li><strong>GetPassage</strong>:
the sample documents are cited by chapter/section. Some valid citations for d-anderson, work 2004 are: front-matter.summary, article.1, article.2, or back-matter.bibliography. <strong>Or</strong> you can submit "GetPassage" with no citation to get the entire text-element of the XML file.
<form action="GetPassage">
Author: <input name="textgroup" value="d-anderson" size="15"/>
Text: <input name="work" value="2004" size="15"/>
Ref: <input name="ref" value="front-matter.summary"/>

<br/>
Edition: <input name="edition" value="01" size="3"/>
Translation: <input name="translation" value="" size="3"/>
<br/>
<!--
Exemplar: <input name="exemplar" value="" size="3"/>
-->
<br/>
<input type="submit" value="Get Passage"/>
</form>
</li>

<li><strong>GetTEIHeader</strong>:
the sample documents include
a work number 2004 for textgroup "d-anderson".  
This request will return the meta-data for a given file.<br/>


<form action="GetTEIHeader">
Text group: <input name="textgroup" value="d-anderson" size="15"/> 
Work: <input name="work" value="2004" size="15"/> 
Level: <input name="level" value="1" size="3"/>

<br/>
Edition: <input name="edition" value="01" size="5"/>
Translation: <input name="translation" value="" size="5"/>
<!-- Do we want to support exemplars for GetValidReff?
<br/>
Exemplar: <input name="exemplar" value="" size="3"/>
-->
<input type="submit" value="Get TEI Header"/>
</form>
</li>


</ol><h2>More information</h2><p>
See the
<a href="http://shot.holycross.edu/projects/TextServer">TextServer home page</a>
for documentation of the TextServer protocol,
and links to 
sample applications you can configure to use this server
implementation.
</p><div class="instructions">
<p>
last modified:  April 22, 2004
</p>
</div></body></html>