Link Search Menu Expand Document

Exploring Resources

A FairCopy project is a container for resources. These resources can be works by a certain author or from a certain time period, or be related in some other way. They may include correspondences, manuscript transcriptions, bibliographies, or chapters of a printed book. They can be represented as textual transcriptions or digital facsimiles.

The Home Page shows a list of the resources in the project and allows you to create new resources or import them. Clicking on a resource in the list opens the resource for editing. Open resources are shown in the sidebar in the Open Resources list. Also displayed here is the Table of Contents for the currently selected resource, if any.

To create a new resource, click on the “New Resource” button. This brings up a dialog which will prompt you for the name of the resource and a unique ID for this resource. The unique ID can be used to reference this resource from other places in the project. It is also used as a filename when the resource is exported as XML.

This dialog also prompts you to specify a resource type. FairCopy supports the following resource types, which are each described in this chapter:

Name Icon TEI Element Description
Text Resource text resource icon text A single text of any kind. For example: a poem or drama, a collection of essays, a novel, or a bibliography.
Facsimile Resource facsimile resource icon facsimile A facsimile is a collection of images of a physical text. The images are sequenced in reading order or the order in which they are archived.
SourceDoc Resource source document resource icon sourceDoc A lineated transcription of a single source document.
Standoff Resource stand off resource icon standOff A container for linked data, contextual information, and stand-off annotations.
TEI Document Resource tei document resource icon tei A group of texts and facsimiles which share a common metadata description or a single text or facsimile which requires detailed metadata.
TEI Header Resource tei header resource icon teiHeader The TEI header is the ‘virtual title page’ of a TEI document. It contains metadata (information about the TEI document).

TEI Documents

Resources can be further grouped together into TEI Documents, which usually focus on a single work or textual object. TEI Documents also contain a header which is useful for recording metadata about the object in question. A header resource is automatically created whenever you create a TEI Document. On the home page, TEI Documents act like folders, and you can click into them to see their contents. When you export a TEI Document, all the resources contained within it are exported as a single XML file.

Importing XML and UTF-8 Encoded Text

FairCopy can import both TEI XML and UTF-8 encoded text, commonly called “plain text.” Plain text files contain unadorned text, such as a .txt file on Windows. You can import a single file, a group of files or a folder of files at a time. FairCopy does not support import of .DOCX or .PDF formats at this time.

To import a TEI XML file, FairCopy looks for a certain structure. It assumes that there will be a top level TEI element and one or more resource elements. See the table above for the different resource element types. See the “Working with Schemas” section for more information about importing XML.

Exporting XML

Any resource in FairCopy may be exported as TEI XML. This is useful for sharing these resources with other systems that use TEI XML for publishing, analysis, and archival purposes. The filename given to each resource is the resource’s ID plus the extension .xml. Note that resources that are part of a TEI Document are exported together a single XML file. In this case, the resource’s id is its @xml:id in the resulting file.

Next Section: Using the Editor