View source for Serving "application/tei+xml" from Cocoon

= How to serve TEI XML from Cocoon with the content-type "application/tei+xml" =

Most websites which publish TEI XML documents describe them with the content type "application/xml" or "text/xml". These are two labels for XML files in general, and don't identify the files as specifically ''TEI'' XML. By using the content type "application/tei+xml", a webserver can make the specific claim that the XML file is TEI rather than any other kind of XML. This has the advantage that browsers can be configured to handle TEI files distinctly from the way they handle other XML files (for instance, by opening them in an XML editor).

= Simple configuration =

To specify the content type, simply configure a TEI [http://cocoon.apache.org/2.1/userdocs/xml-serializer.html XML serializer] in your sitemap.xmap file, and then invoke the serializer in your TEI pipelines.

To declare the serializer:

<pre><nowiki>
<serializer mime-type="application/tei+xml" name="tei" src="org.apache.cocoon.serialization.XMLSerializer"/>
</nowiki></pre>

Invoking the serializer:

<pre><nowiki>
<serialize type="tei"/> 
</nowiki></pre>

= Preferred configuration =

Most browsers will adequately display generic XML but will not be configured to handle the specific content type "application/tei+xml". For this reason, it's usually better to serve the TEI as "application/tei+xml" only if the browser specifically asks for it, and otherwise to serve it as the generic "application/xml". 

In Cocoon, you can use a [http://cocoon.apache.org/2.1/userdocs/regular-expression-header-selector.html RegexpHeaderSelector] to determine if a browser is prepared to handle the specific content type. The following Cocoon sitemap file shows:

* A plain XML serializer
* A TEI XML serializer
* A selector for determining if a browser will accept "application/tei+xml"
* A pipeline fragment ("resource") which uses the selector to determine if a browser will accept "application/tei+xml", and uses the appropriate XML serializer
* A pipeline which invokes the above resource instead of just invoking a serializer directly

<pre><nowiki>
<?xml version="1.0" encoding="UTF-8"?>
<sitemap xmlns="http://apache.org/cocoon/sitemap/1.0">
	<components>
		<!-- declare two serializers: one for tei-xml, and one for generic xml -->
		<serializers>
			<serializer mime-type="application/xml" name="xml" src="org.apache.cocoon.serialization.XMLSerializer"/>
			<serializer mime-type="application/tei+xml" name="tei" src="org.apache.cocoon.serialization.XMLSerializer"/>
		</serializers>
		<!-- declare a selector for determining if a browser will accept tei-xml -->
		<selectors>
			<selector name="accept-content-type" src="org.apache.cocoon.selection.RegexpHeaderSelector">
				<pattern xmlns="" name="tei">application/tei\+xml</pattern>
				<header-name xmlns="">accept</header-name>
			</selector>
		</selectors>
	</components>

	<resources>
		<!-- declare a pipeline fragment for serializing TEI with the most appropriate content type; -->
		<!-- tei-xml if the browser will accept it, or plain generic xml otherwise -->
		<resource name="serialize-tei">
			<select type="accept-content-type">
				<when test="tei">
					<serialize type="tei"/>
				</when>
				<otherwise>
					<serialize type="xml"/>
				</otherwise>
			</select>
		</resource>
	</resources>

	<pipelines>
		<pipeline>
			<match pattern="transcript/*.xml">
				<generate src="tei/{1}.xml"/>
				<!-- serialize the TEI using the appropriate serializer -->
				<call resource="serialize-tei"/>
			</match>
		</pipeline>
	</pipelines>

</sitemap> 
</nowiki></pre>

== Configuring your browser to request "application/tei+xml" ==

Using this configuration, you will need to configure your browser to declare that it's prepared to accept "application/tei+xml". 

To configure Firefox, enter "about:config" into the address bar, find the key called "network.http.accept.default" and change it to include "application/tei+xml" in the list of acceptable content types, e.g.:

<pre>text/html;q=0.7,application/xhtml+xml;q=0.8,application/tei+xml;q=0.7,application/xml;q=0.6,*/*;q=0.4,application/json;q=0.5</pre>