Home Search Exhibits Intro FAQs

About the Project

» Site Mission

» Personnel

» FAQs


Technical Info

» View the DTD

» Sample Markup

» Tutorial Template

» Tag Descriptions (by DTD)

» Tag Descriptions (by name)

Tutorial Template

This template contains all the possible tags for ABsOnline markup, and it also includes commentary that should help new contributors understand the metadata.

<?xml version="1.0" encoding="UTF-8"?>

<!--Artists' Books Online metadata tutorial template. Prepared by Eric Rettberg, June 2007. This document will work best in a program that colors syntax for XML, for example, oXygen/.-->

<!--This DOCTYPE declaration points the file to a specific DTD, or Document Type Definition. If you put this tutorial document in the same folder as a copy of the ABOnline DTD, Oxygen will be able to produce attribute lists, etc. Before the file gets posted, the call should be changed to: <!DOCTYPE work SYSTEM "../../xsl/ab_current.dtd"> to accurately reflect the location of the DTD on the server.-->

<!DOCTYPE work SYSTEM "./ab_current.dtd">

<!--The <work> tag is the root tag for ABOnline works. In the "id" attribute, enter a four-letter identifier for the book, for example "nora" for _Nova Reperta_. Ideally, you should check the list of work ids that have been taken, but if there's a duplication problem we'll correct it in Charlottesville.-->

<work id="">

<!--The <title> tag is a wrapper for title information.-->

<title>

<!--The book's full title should go into the <titleproper> tag. For the book _Home_, for example, the code would read <titleProper>Home</titleProper> -->

<titleProper></titleProper>

<!--The <note> tag is a space to enter any relevant, and perhaps subjective, information. Since this <note> tag is inside the <title> tag, it refers to a note about the title. The "enAuthor" attribute refers to the entering Author, that is, whoever is filling out the XML file. The format is first initial followed by last name, that is, enAuthor="E. Rettberg".-->

<note enAuthor=""></note>

</title>

<!--Agents are people or collectives associated with the production and dissemination of a work. Within <agents>, there can be multiple <agent> tags.-->

<agents>

<!--Each person gets their own <agent> tag. The "type" attribute must be marked as "initiating," "other," or "unknown."-->

<agent type="">

<!--We try to break down information as much as possible, so a full proper name will have at least two <name> tags - one for the first name (type="first"), and one for the last name (type="last"). There are also attribute options for middle names and other names.-->

<name type=""></name>

<!--Use as many <role> tags as is appropriate - almost all initiating agents will be either an "artist" or an "author," but an "artist" can also be a "photographer," and they may also have taken the role of "binder," for example.-->

<role type=""/>

<!--All dates in ABOnline metadata must go into a <dates> wrapper. Since this <dates> tag is inside <agent>, it refers only to dates associate with this particular agent.-->

<dates>

<!--Enter as many <date> tags as are relevant; the <date> types that refer to people are birthdate and deathdate. In "span," enter "single" for a single date or "span" for a range of dates. In "norm," you enter the actual date, in the format YYYY-MM-DD. If you know only a year or month, enter zeroes for the irrelevant parts - for example, to designate the year 1981, you would enter 1981-00-00.-->

<date type="" range="" norm=""/>

</dates>

<!--A note tag for any general or subjective information about the agent. Remember to enter yourself as an enAuthor.--> <note enAuthor=""></note>

</agent>

</agents>

<!--The <thumbnail> tag is a vestige of an earlier vision for the way the site would work, and can be ignored for now.-->

<thumbnail>

<image></image>

<caption></caption>

<critGloss enAuthor=""></critGloss>

</thumbnail>

<!--In the <note> for <pubHist> (publication history), enter a very basic overview of publication information - for example, "100 copies produced by Preacher's Biscuit Books in 2005."-->

<pubHist>

<note enAuthor=""></note>

</pubHist>

<!--The <projectStatement> serves as the primary introduction to the work on the web site. Typically, the artist contributes this statement, but if the artist's input is not available, an expert or critic contributes it. Usually, this is a meaty paragraph that allows an entry into understanding the work's significance. There's no need to go overboard here - the metadata allows a lot of room for critical observation and analysis in the <edition> section.-->

<projectStatement enAuthor=""></projectStatement>

<!--The <aestheticProfile> tag contains a number of tags that allow for a description of the overall aesthetics of a work. Each of the tags can be repeated as many times as you would like. Each of these tags also has "unknown" and "other" options.-->

<aestheticProfile>

<!--In <movement>, use the "type" attribute to describe whatever movement the work is a part of. A list of options is available. If you do not think the work is part of a movement, enter "uknown" in the type attribute. If you believe there is a movement but that it is not represented in the list, put "other" in the "type" attribute and describe the movement with your own language between the opening and closing tags; for example, <movement type="other">cubism</movement>-->

<movement type=""></movement>

<!--The <subject> tag is used to designate a work's subject, in the Library of Congress subject heading sense. Follow the convention described for "movement" for "unknown" or "other" attributes.-->

<subject type=""></subject>

<!--<theme> is more subjective than <subject> and is therefore an enAuthored field. Usually, this is a list of topics that you see at play in a work; for example, <theme enAuthor="E. Rettberg">materiality, self-consciousness, the human condition</theme>-->

<theme enAuthor=""></theme>

<!--<contentForm> is a place to note the particular types of content that appear in a work, for example prose or photographs.-->

<contentForm type="" enAuthor=""></contentForm>

<!--In <publicationTrad>, note the Publication Tradition you see a work fitting into.-->

<publicationTrad type="" enAuthor=""></publicationTrad>

<!--<inspiration>s are difficult to discern and may be most useful coming from the initiating author or artist. But if a work features an obvious and prominent inspiration, you should note it and mark yourself as the enAuthor.-->

<inspiration enAuthor=""></inspiration>

<!--<relWorks> offers a space to note works related to this one in any way. -->

<relWorks enAuthor=""></relWorks>

<!--<otherInflus> offers a space to note other Influences on this work that are not covered in <inspiration> and <relWorks>.-->

<otherInflus enAuthor=""></otherInflus>

<!--If a work was produced in the context of a community - a press or workshop, for example, use this tag. In the "type" attribute, select the most relevant type of community or mark other. Between the opening and closing tags, note more specific information; for example, <community type="press" enAuthor="E. Rettberg">Preacher's Biscuit Books</community>-->

<community type="" enAuthor=""></community>

<!--Again, a note field that allows entry of any other information about this work's aesthetic profile.-->

<note enAuthor=""></note>

</aestheticProfile>

<!--A related documents field that allows you to mark related documents about the <work> level of this work. -->

<relDocs>

<!--Mark the type of manuscript from the list available in the "type" attribute.-->

<manuscripts type="">

<!--Mark the location of the book, either artists' archive or a specific location in an archive.-->

<locationInfo type=""></locationInfo>

<!--In this note field, offer specifics on where and how a user can obtain access to the documents in question.-->

<note enAuthor=""></note>

</manuscripts>

</relDocs>

<!--<exHist> means Exhibition History. In it, offer a statement of places and exhibitions where this work has been exhibited.-->

<exHist></exHist>

<!--In <receptHist>, note relevant instances of critical reception of this work.-->

<receptHist></receptHist>

<!--The <genComment> tag at the <work> level offers a place to make any observations or provide any information that has not been covered by other tags at the <work> level.-->

<genComment></genComment>

<!--The <editions> tag is a wrapper for all the work's editions.-->

<editions>

<!--Each different edition gets its own <edition> tag. In "id," enter the work's work id plus the edition number in two digits, for example, nora01. In "type," enter "first" or "other."-->

<edition id="" type="">

<!--In the "type" attribute of the "volume" tag, enter "single" or "other."-->

<volume type="">

<!--Here, you can repeat <title> and <agents>, but this is only necessary if they are different from <work>'s <title> and <agents>.-->

<!--EdPubHist, Edition Publication History, is a wrapper tag that offers a space to describe the publication history of this edition.-->

<edPubHist>

<!--In <edInfo>: for ordertype, enter "first" for a first edition or "other." In "edtype," enter "editioned" for books that are produced in multiple copies or "unique" for a book that is produced as a single, unique object. In "numtype," enter "numbered" if the edition is numbered or "unnumbered" if it is not. In "sigtype," entered "signed" if each copy of the edition is signed or "unsigned" if each copy is not.-->

<edInfo ordertype="" edtype="" numtype="" sigtype="">

<!--Here, dates that apply to the book's publication, etc., following the single/span and YYYY-MM-DD conventions.-->

<dates>

<date type="" range="" norm=""></date>

</dates>

<!--The book's publisher.-->

<publisher></publisher>

<!--The place of the book's publication.-->

<place></place>

<!--The number of copies of this book that were produced.-->

<edSize></edSize>

<!--If a book occurs in different versions, but within the same edition, note them here. For example, a book might have 25 specially produced editions on special paper and 200 standard copies. Note each of these versions within <version> tags.-->

<versions>

<version></version>

</versions>

<!--A place to make general notations on the edition's publication history.-->

<note enAuthor=""></note>

</edInfo>

</edPubHist>

<!--In this space, enter a transcription of the work's colophon. If no colophon is present, put "none" between the tags.-->

<colophon></colophon>

<!--The <physDesc> tag wraps around several other tags that allow for physical description of this book object.-->

<physDesc>

<!--In <genDesc>, give a brief, objective summary of the overall appearance of the book. For example, "Book is large format, in black and white with glossy paper."-->

<genDesc></genDesc>

<!--<measurements> wraps around all the different <measurement>s for the book.--> <measurements>

<!--You'll have at least two <measurements>, at minimum a horizontal and a vertical. In most clases, you'll measure the book closed and state will be "closed." In "unit," select whichever unit you prefer. Put the actual number of the measurement between the opening and closing tags.. -->

<measurement type="" state="" unit=""></measurement>

</measurements>

<!--<format> describes the overarching format of the book, for example, whether it is a codex, a pamphlet, an accordion, or a set of cards.-->

<format type=""></format>

<!--for <pagination>, type designates whether the book's pages are numbered or unnumbered. Between the opening and closing tags, count the total number of pages, even if they are not numbered. For example: <pagination type="unnumbered">36 unnumbered pages</pagination>-->

<pagination type=""></pagination>

<!--<cover> should be a relatively objective description of the book's cover; for example, "A tan board cover that announces the title and author in cartoonish black handwriting."-->

<cover></cover>

<!--Choose from the list of binding types, or choose other. You may also offer any specific notations about the binding between the opening and closing tags.-->

<binding type=""></binding>

<!--<devices> describes any physical objects included with a book to facilitate reading - for example, a magnifying glass included with a book, or the wooden stand that holds _Nova Reperta_.-->

<devices></devices>

<!--Use as many <substrate> tags as necessary, and offer as much information as you know about the paper or other medium on which the book is printed. "type" is bookBlock, endSheets, or other, and "support" is paper or other. Add any more detail between the opening and closing tags; for example, <substrate type="bookBlock" support="paper">Virginia Mills Cardstock</substrate>-->

<substrate type="" support=""></substrate>

<!--<media> offers a list of types and is used to describe the medium used to print the book, for example, ink.-->

<media type=""></media>

<!--<otherMaterials> offers a space to describe any materials included with the book not covered by <substrate> and <media>.-->

<otherMaterials></otherMaterials>

<!--For <color>, a simple type=yes or no, with room for additional detail between the opening and closing tags.-->

<color type=""></color>

<!--<enclosures> might include cards inserted into a book, a small pamphlet inserted into a book, etc. Usually, these would be made from paper, which should distinguish them from <devices>. List each enclosure in its own <item> tag.-->

<enclosures>

<item></item>

</enclosures>

</physDesc>

<!--<productionInfo contains tags that describe the overarching production of a book.-->

<productionInfo>

<!--For <productionMeans>, select from the list to describe the method by which the book was produced.-->

<productionMeans type=""></productionMeans>

<!--<productionNar> means Production Narrative, and it is usually a somewhat lengthy paragraph that offers details of the process of producing this book. Usually, this would be supplied by the author or omitted, but an observant expert critic might be able to retrospectively reconstruct some of the details of this narrative.-->

<productionNar enAuthor=""></productionNar>

</productionInfo>

<!--There can be multiple sets of <criticalAnal>, Critical Analysis, with each one having a different enAuthor. Critical Analysis wraps around several tags that allow for micro-observations about a book.-->

<criticalAnal enAuthor="">

<!--First, a set of tags about a book's design features.-->

<desFeatures>

<!--<typographic> allows a space for comment on the work's typography and approach: mixed fonts, ransom-note, inter-linear texts, anything at all distinctive, remarkable, or worthy of comment with respect to the typography.-->

<typographic></typographic>

<!--<imagery> is for comments on visual images and their approach: silhouettes, as well as the image program or use of images, etc.-->

<imagery></imagery>

<!--<graphical> is for comments on graphic design and approach: conventional layout, radical experimentation, layering effects, transparencies, etc.-->

<graphical></graphical>

<!--<openings> is for comments on any significant use of openings.-->

<openings></openings>

<!--<turnings> is for comments on any significant use of turnings.-->

<turnings></turnings>

<!--<development> is for comments on the way development occurs over the course of the book.-->

<development></development>

<!--<sequence> is for comments on any significant use of sequences or not.-->

<sequence></sequence>

<!--<textual> is for comments on any significant textual features.-->

<textual></textual>

<!--<structure> offers a space for comments on any significant structural features.-->

<structure></structure>

<!--<conceptual is for comments on any significant conceptual features-->

<conceptual></conceptual>

<!--<intratextual> is for comments on the relation among various elements in the edition.-->

<intratextual></intratextual>

<!--<sculptFeatures> is for comments on any significant sculptural or three-dimensional features.-->

<sculptFeatures></sculptFeatures>

<!--<tempFeatures> is for omments on any any significant temporal features.-->

<tempFeatures></tempFeatures>

<!--<otherFeatures> is for comments on any other book-specific features: folds, cuts, use of margins.-->

<otherFeatures></otherFeatures>

</desFeatures>

<!--<critDiscuss> offers a space for critical discussion of themes, issues, political and philosophical, artistic and literary, subject matter and treatment : any critical issue at all that isn't strictly limited to structural analysis. -->

<critDiscuss></critDiscuss>

<!--<detailedAnal> enables close discussion of specific parts of a book. Each detailed analysis should get its own <study> tag.-->

<detailedAnal>

<study>

<!--In <comment>, the discussion itself.-->

<comment></comment>

<!--In <image>, a URL that points to a thumbnail-sized image of the part of the book being discussed.-->

<image></image>

</study>

</detailedAnal>

<!--Again, a tag for general commentary on topics not yet covered in terms of critical analysis.-->

<genComment></genComment>

</criticalAnal>

<!--<relDocs> for the <edition> section. Documents related to the production of this edition. Follow same conventions as <work>-level related documents.-->

<relDocs>

<manuscripts type="">

<locationInfo type=""></locationInfo>

<note enAuthor=""></note>

</manuscripts>

</relDocs>

<!--<exHist>, exhibition history, allows you to describe your knowledge of this edition's exhibition history.-->

<exHist></exHist>

<!--<receptHist>, reception history, a space for discussing and pointing to instances of critical reception of this edition.-->

<receptHist></receptHist>

<!--An optional space for general comment on the <edition> section.-->

<genComment></genComment>

<!--Within <objects>, we describe single instances of this edition of this work, each with its own <object> tag.-->

<objects>

<!--The id convention for object is workid + two-digit edition number + two-digit object number (object number is arbitrary); for example, nora0101.-->

<object id="">

<!--<copyNum>, of course, for the copy number of this object. If no copy number, enter n/a.-->

<copyNum></copyNum>

<!--transcribe any <inscription> in the book here.-->

<inscription></inscription>

<!--<provenance> wraps information about the history of ownership of this object.-->

<provenance>

<!--<provenance> <dates> describe the dates of acquisition of this book.-->

<dates>

<date type="" range="" norm=""></date>

</dates>

<!--Make note of when and how the book's ownership changed.-->

<note enAuthor=""></note>

</provenance>

<!--<repository> wraps tags that describe the geographic location of this object.-->

<repository>

<!--The institutional place where this book is held.-->

<institution></institution>

<!--If a book is held in a specific collection within the institution, note that here. Otherwise, n/a.-->

<collection></collection>

<!--In <locationInfo>, try to describe how a user might find this book at the institution. For ISBNs, select type="other" and insert between the tags ISBN: 00000000000 etc.-->

<locationInfo type=""></locationInfo>

<!--<rights> describes who owns the rights over the use and display of this object, and any regulations that may exist for the object.-->

<rights></rights>

</repository>

<!--<particulars> describes anything specific or particular to this object that came about as part of its production: typos, mis-collation, upside down pages, images, signatures, smudging etc.-->

<particulars></particulars>

<!--In condition, for "type" describe the general condition of the book. Between the tags, describe any wear or damage to this particular object that has occurred since it was produced. -->

<condition type=""></condition>

<!--<relDocs> for the object level. For example, a receipt of purchase, etc.-->

<relDocs>

<manuscripts type="">

<locationInfo type=""></locationInfo>

<note enAuthor=""></note>

</manuscripts>

</relDocs>

<!--In <conservationTreat>, describe any preservation or conservation work done on this object.-->

<conservationTreat></conservationTreat>

<!--Special requirements for exhibition of this object.-->

<exRequire></exRequire>

<!--exhibition history for the object.-->

<exHist></exHist>

<!--A space for general comment on this object.-->

<genComment></genComment>

</object>

</objects>

</volume>

</edition>

</editions>

</work>