#386 XML code insertion explained in TEI Lite Guidelines

GREEN
closed-wont-fix
Lou Burnard
5
2012-03-26
2012-03-15
Pablo Rodriguez
No

Reading the TEI Lite Guidelines, I found that XML code insertion is explained in the TEI Lite Guidelines (page 34 from the PDF file) with a CDATA marked section.

I wonder whether it shouln't be easier to use <egXML> (which isn't explained there).

Just in case it helps,

Pablo

Discussion

  • Lou Burnard
    Lou Burnard
    2012-03-15

    • milestone: --> GREEN
    • assigned_to: nobody --> louburnard
     
  • Lou Burnard
    Lou Burnard
    2012-03-15

    Using egXML would be a better solution perhaps in general, but this element is not included in TEI Lite. Adding it (even if we wanted to change TEI Lite at this late stage in its history) would also involve quite a lot of explanation about how name spaces work, which might perhaps be a bit heavy weight for a simple introduction. But Im leaving this ticket open to see if anyone disagrees with me.

     
  • I agree with Lou, leave sleeping dogs alone. <egXML> is too arcane for TEI Lite, and the CDATA method is not wrong. Alternatively, remove the whole discussion of inserting XML from Lite - its not needed.

     
  • Kevin Hawkins
    Kevin Hawkins
    2012-03-24

    I disagree on removing the discussion of inserting XML (at the end of section 16.1). The rest of section 16.1 discusses technical documents, including <gi> and <att>, so it seems quite likely that a user will want to know how to include a whole section of XML in their document as an example. I would suggest adding a <note> that the full TEI uses <egXML> for this purpose, but its use is complicated and therefore the element is not included in Lite.

     
  • Lou Burnard
    Lou Burnard
    2012-03-26

    • status: open --> closed-wont-fix
     
  • Lou Burnard
    Lou Burnard
    2012-03-26

    I agree that it might be useful to add a note about the existence of egXML to the document if we were planning to revise it. But there are so many other changes we'd make in this document if were revising it I don't think it's sensible to create a new version with just this one minor tweak. What it says currently is not wrong, so I agree with Sebastian that canine somnolence is the best course.