#49 Pin down and write guidelines for top level divs

[Elli Mylonas]

These need to be rationalized and documented in the
guidelines.

The types of div so far:

Edition (Text): contains transcription of inscription text.

Source/Text Constituted From: This goes under history

App Crit: Provides information on readings and
conjectures. Much of this can come out of the markup
(test this), so it can be generated. But it has to
handle "out of line" comments.

Perhaps stubs can be created for each line that has
conjectures in a CHET-C type conversion. This can then
be edited by hand, the way CHET-C output is. There also
needs to be a section that is plain text. Plain text
sections can also be interspersed in this, or added to
the line stubs.

Translation: Charlotte wants multiple translations in
multiple languages. What is the level of tagging that
will happen in a translation. Tagging for formatting
may be unavoidable. Tagging names and places will be
possible but not required. Should record name of
translator (resp).

Commentary-textual+historical: It's about the text and
the content and historical context. Prosopographical,
linguistic, .... It may take the form of a cross
reference to another document. Tag for inscription
type(s) belongs here. Date information and commentary
belongs here.

Physical Description (Commentary-physical/Description):
This can contain plain text, or text with tags for the
various physical description categories. It can also
consist of tabular material.
--Object
--Preservation
--Decoration
--(USEP History also, to be moved to div History)
--o Lettering and Field/Campus

History (Commentary-physical-historical/History): This
is the object history, includes find spot (also find
within city), last recorded location. or current
location. The last two items will always have to have a
date.
--Location (provenance in various degrees, last
recorded or current location)
--Source: source includes resp for edition (more than
one source for more than one edition)
--History of recording
--Aquisition information
--Catalogue numbers (may be subset of something else)
Bibliography(Commentary-history of publication):

This may be a place holder holding encoded
biblographical entry or reference/pointer

--list/bibliography of editions
--list/bibliography of discussions of text
--list/bibliography belonging to commentary

Illustrations:

Some categories include:

--pictures
--views
--old drawings (handwritten transcriptions)
--pictures of squeezes

Date: This is now within a text commentary div

Does it need its own div or can it be placed in another
div? Date can contain date tagged and/or with commentary
GB: text commentary or history, more like commentary
than descrip
CR: not history, more description
CC: commentary
Some objects have more than one date (palaeographical
date vs. historical), we could put date in commentary
and make it always part of commentary no matter where
we display it

[Elli Mylonas]

Is this sufficient [http://www.stoa.org/epidoc/gl/latest/supp-structure.html]

[Tom Elliott]

https://docs.google.com/a/nyu.edu/presentation/d/1rxmViHZyKYWl3LjIdqr_OISbATCRejjoDOrpVxddIWI/edit#slide=id.i0

[Elli Mylonas]

add this information to supp-structure.xml.

[Charlotte Tupman]

Updated task list for this ticket:

1. Add some explanatory prose to http://www.stoa.org/epidoc/gl/latest/app-allsupp.html explaining further the groupings involved in an EpiDoc file structure;

2. Add some prose underneath the main example on http://www.stoa.org/epidoc/gl/latest/supp-structure.html explaining briefly each of the divisions:

edition
-textpart
apparatus
translation
commentary
bibliography

[Charlotte Tupman]

Added very brief text to http://www.stoa.org/epidoc/gl/latest/app-allsupp.html listing the sections involved in an EpiDoc file structure; added more detailed prose underneath the main example on http://www.stoa.org/epidoc/gl/latest/supp-structure.html explaining each of the divisions.