Dear all,
As suggested before, I completed a number of simple corrections in the tei-simple.odd and committed them.
There are a couple of issues that I would like to bring up with the rest of you, though.
:: Short Example:
: The last sentence of the first paragraph is unclear, I don't understand what "the former" and "the latter" actually refers to.
: I would find it useful to have a full example (including the TEI header) in addition to the "Short Example" e.g. at the end of the document.
:: Footnote 1: which XML tutorial should be referred to?
:: The following elements are listed as part of the TEI Simple schema, but there is no further explanation of them in the document. Some elements are used in an example.
char (used in an example)
charDecl
charName (used in an example)
charProp
desc (used in an example)
glyph
glyphName
handNote
localName
mapping (used in an example)
unicodeName
value
:: The following elements and attributes are mentioned at various places in the text, even though they are not part of TEI Simple. I would suggest to either take those elements out all together or make clear that they are included for the sake of completeness, but not part of TEI Simple (which is already done in some cases).
: <sourceDoc>
: <term>
: <gloss>
: <index> (isn't described above as claimed in 13.2.1.; not clear)
: @ulx/@uly etc. isn't explained in 14. Encoding a digital facsimile
: <mentioned> (made clear that it is not part of Simple)
: <said> (made clear that it is not part of Simple)
:: Some examples use elements, which are a) not explained in the document (or explained at a later point), b) not part of TEI Simple
: 3.3.2 Drama contains <emph> which isn't part of Simple
: 3.5.3 Foreign Words or Expressions: <s> is used in the second example but explained several pages later.
: 4.2. Omissions: @reason and @hand are used in the example but aren't further discussed. The same applies to <desc> and <term> in the following examples. Also <name> and <date> are used, which are covered at a later point in TEI Simple.
:: 2 Structure
: the <TEI> specification mentions model.resourceLike class. At this point, classes have not been explained. It think that would be necessary at the beginning of the document.
:: 4.1. The transcription example (Henry V) claims that there is the phrase "Table of green feelds", however, in figure 1 it actually says "Table of greene fields". So, while the example is actually nice, it doesn't refer to the original (figure 1)...
:: 5.1. Names and Referring Strings
The last example contains @key attributes, I'd change this to @ref since @key isn't described and @ref fulfills the same purpose. By the way, I changed <sic> to <orig> in the example.
:: Things that I wouldn't consider 'simple', but I'm sure these have been discussed before (several times)
: <biblFull> in 7 Bibliographic Citation
: @part in 3.3.2. Drama
: @role for <table> in 8 Table, especially the values 'sum' and 'total'. There isn't even an example in the full TEI Guidelines.
: The TEI header section is very extensive and complex. I would suggest to at least put the examples in their context for better orientation by adding the parent element. For example it is unclear where to actually put the <extent> element (15.1.3 The Extent Statement)
:: The simple case to align text and facsimile is explained twice, almost identically, once at the end of 3.4 Page and Line Numbers and another time at the end of 9 Figures and Graphics.
:: I added a suggestion for the missing @type values of <name> at the end of chapter 11 (please have a look at it). Would it make sense to use the same values as the element names in the full TEI Guidelines, e.g. genName etc.?
:: PDF and HTML output
: The line breaks in the examples on the PDF are coming out very weird, is there anything that can be done to remedy that?
: the values (<val>) in the TEI Guidelines are displayed in simple quotation marks, but not in TEI Simple
: the attributes are not displayed with a preceding @ in the PDF
Best,
Martina
-----Ursprüngliche Nachricht-----
Von: Martin Mueller [mailto:martinmueller@northwestern.edu]
Gesendet: Freitag, 12. August 2016 13:50
An: Scholger, Martina (martina.scholger@uni-graz.at); tei-council@lists.tei-c.org
Betreff: Re: AW: [tei-council] Simple : victory declared, going home.
Martina,
Lou deserves a break. If you send your list to me, I will follow up from there.
MM
Martin Mueller
Professor emeritus of English and Classics Northwestern University
On 8/12/16 12:03 AM, "Scholger, Martina (martina.scholger@uni-graz.at)"
Dear Lou,
I read the first 60 pages of the TEI Simple document. What is the best way to give you my remarks?
First of all, the whole document is written very comprehensible and will be a great start into the TEI world!
I'd suggest to correct typos, punctuations, formatting, spellings etc. by myself in the version on GIT and then send you the issues where I have remarks and suggestions but which require some discussion or decision on your part as PDF?
Issues I would fix myself, if you agree: : Typos and punctuation : encoding errors (e.g. values that aren't encoded as <val>) : Spellings (e.g. standardized and standardised - since in the Guidelines everything is written with the "z" spelling, I'd suggest doing the same in TEI Simple) : Capitalization (TEI header, TEI scheme, TEI Simple, Processing Model, TEI Guidelines) : Remove indentation after code examples, lists, etc.
Best, Martina
-----Ursprüngliche Nachricht----- Von: tei-council-bounces@lists.tei-c.org [mailto:tei-council-bounces@lists.tei-c.org] Im Auftrag von Lou Burnard Gesendet: Donnerstag, 28. Juli 2016 19:24 An: tei-council@lists.tei-c.org; Martin Mueller Betreff: [tei-council] Simple : victory declared, going home.
I have now made all the changes I've so far identified as necessary to the TEI Simple Exemplar, and checked in a semi-final version for Council to review. It needs someone, not me, to read it carefully and nit-pickingly, or at least the first sixty pages or so pages of it. And it needs someone to do some testing of the schema. And it needs someone to fix the stylesheets so that the processing model info contained in the ODD is displayed in HTML/PDF outputs.
The ODD source is, as per usual, in the repository at https://urldefense.proofpoint.com/v2/url?u=https-3A__github.com_TEIC_TE I_b lob_d9f349185b6a7263990c3c6fccc93567eb675e8e_P5_Exemplars_tei-5Fsimple. odd &d=CwIFAw&c=yHlS04HhBraes5BQ9ueu5zKhE7rtNXt_d012z2PA6ws&r=rG8zxOdssqSzD Rz4 x1GLlmLOW60xyVXydxwnJZpkxbk&m=EhVssORjMVfEc0-HfeERETaDqNF4nwVxWRSS7_AKm 8c& s=ApEg4VMCz1FL9vX_8c9cLG5oGn3UxYgrL9M5_1W2Qsk&e=
The RELAXNG schema is at https://urldefense.proofpoint.com/v2/url?u=https-3A__github.com_TEIC_TE I_b lob_d9f349185b6a7263990c3c6fccc93567eb675e8e_P5_Exemplars_tei-5Fsimple. rnc &d=CwIFAw&c=yHlS04HhBraes5BQ9ueu5zKhE7rtNXt_d012z2PA6ws&r=rG8zxOdssqSzD Rz4 x1GLlmLOW60xyVXydxwnJZpkxbk&m=EhVssORjMVfEc0-HfeERETaDqNF4nwVxWRSS7_AKm 8c& s=sV7jjGN72Z4No9BCBJa9ZQjAkRCyk9Dm02w5rOqGyJ4&e=
I also have a massive HTML version, and a massive PDF version, which for the moment I have just bunged into my personal webspace at https://urldefense.proofpoint.com/v2/url?u=http-3A__lb42.github.io_tei- 5Fs imple.html&d=CwIFAw&c=yHlS04HhBraes5BQ9ueu5zKhE7rtNXt_d012z2PA6ws&r=rG8 zxO dssqSzDRz4x1GLlmLOW60xyVXydxwnJZpkxbk&m=EhVssORjMVfEc0-HfeERETaDqNF4nwV xWR SS7_AKm8c&s=3tpf0_gmXjpeo9wgd-4GH57bU5NuC3sqPpl-idBX70I&e= and https://urldefense.proofpoint.com/v2/url?u=http-3A__lb42.github.io_tei- 5Fs imple.odd.pdf&d=CwIFAw&c=yHlS04HhBraes5BQ9ueu5zKhE7rtNXt_d012z2PA6ws&r= rG8 zxOdssqSzDRz4x1GLlmLOW60xyVXydxwnJZpkxbk&m=EhVssORjMVfEc0-HfeERETaDqNF4 nwV xWRSS7_AKm8c&s=q3xnsfaL_hvxCEYHO8TAHaUvsaos1Np9dYwrSzpbHFY&e= respectively. (Yes, I know the graphics dont show up in the HTML version)
I look forward to Council's feedback as to whether this is (as I devoutly hope) now (nearly) ready for prime time.
-- tei-council mailing list tei-council@lists.tei-c.org https://urldefense.proofpoint.com/v2/url?u=http-3A__lists.lists.tei-2Dc .or g_mailman_listinfo_tei-2Dcouncil&d=CwIFAw&c=yHlS04HhBraes5BQ9ueu5zKhE7r tNX t_d012z2PA6ws&r=rG8zxOdssqSzDRz4x1GLlmLOW60xyVXydxwnJZpkxbk&m=EhVssORjM VfE c0-HfeERETaDqNF4nwVxWRSS7_AKm8c&s=_HL2i6HbEpEg3JbiTaFZWb1JmDNZxmrd-xFfD -Ny WOY&e=
PLEASE NOTE: postings to this list are publicly archived