Repurposing TEI DTD's

Post by **/hh** » Sat Sep 25, 2010 12:14 pm

Primary problem: Repurpose tei2.dtd for entity tei.verse in document structure dating from 1999, if possible.

<!DOCTYPE tei.2 system 'tei2.dtd' [
<!ENTITY % TEI.verse 'INCLUDE'>]>
<tei.2>
<teiheader>

Problem description: Prologue does not declare the character set, so a character set is assigned to the code points (ISO-IEC 8859-1). Prologue does declare DTD, but Author does not acknowledge the DTD and does not enable application UI e.g. for validation. Presumably one has to set up and save an external DTD to disk using TEI Pizza Chef, install that external DTD into Author, and associate the installed DTD with the document in order to enable validation and editing. If this strategy is correct, then how does one install and associate the DTD? The help information and the information in the manual is a tad high level.

Secondary problem: How would one install the MEI Music Encoding Initiave schema, and work successfully with it in Author? Anyone tried?

Platform: Mac OS X 10.4.11, Author 12

Best wishes,
Henrik Holmegaard

Post by **sorin_ristache** » Mon Sep 27, 2010 11:55 am

Hello,

You don't have to create a custom TEI DTD using the Pizza Chef. You just have to enable the TEI.verse entity of the standard TEI DTD and use the correct element and attribute names in your XML document. If the TEI.verse entity is enabled the verse specific elements and attributes are recognized in the XML document, for example the caesura element:

Code: Select all

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

<!DOCTYPE TEI.2 PUBLIC "-//TEI P4//DTD Main Document Type//EN" "http://www.tei-c.org/Guidelines/DTD/tei2.dtd" [

<!ENTITY % TEI.verse 'INCLUDE'>

<!ENTITY % TEI.prose 'INCLUDE'>

<!ENTITY % TEI.linking 'INCLUDE'>

<!ENTITY % TEI.XML 'INCLUDE'>

]>

<TEI.2>

  <teiHeader>

    <fileDesc>

      <titleStmt>

        <title/>

      </titleStmt>

      <publicationStmt>

        <p>Publication statement goes here.</p>

      </publicationStmt>

      <sourceDesc>

        <p>Source description goes here.</p>

      </sourceDesc>

    </fileDesc>

  </teiHeader>

  <text>

    <body>

      <head>Head text</head>

      <lg type="free">

        <l>example <caesura/> text</l>

      </lg>

    </body>

  </text>

</TEI.2>

The Author editing mode will match your XML document with the TEI P4 built-in document type because the match rules of that document type can be applied to the XML document. However the validation action uses the schema declared in the XML document type which means the TEI verse elements are accepted.

You can test that by removing and re-inserting the TEI.verse entity declaration and validating the XML document again after each step. Unfortunately the DTD declaration cannot be modified from Author mode so you have to switch to Text mode for that.

Regards,
Sorin

Post by **sorin_ristache** » Mon Sep 27, 2010 12:23 pm

/hh wrote:Secondary problem: How would one install the MEI Music Encoding Initiave schema, and work successfully with it in Author? Anyone tried?

An example of a minimal MEI document is the following:

Code: Select all

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

<?oxygen RNGSchema= "http://music-encoding.org/mei/schemata/2010-05/rng/mei-all.rng" type="xml"?>

<mei xmlns='http://www.music-encoding.org/ns/mei' >

  <meihead>

    <filedesc>

      <titlestmt>

        <title></title>

      </titlestmt>

      <pubstmt></pubstmt>

    </filedesc>

  </meihead>

  <music>

    

  </music>

</mei>

Validating this document will load the schema from the music-encoding.org server. For faster access you can save the MEI schema files (mei-all.rng, datatypes.rng, defaultClassDecls.rng, coConstraints.rng, etc.) on your local computer and use an XML catalog for validating the MEI documents against the local schema files without editing the schema declaration from the XML documents (<?oxygen RNGSchema= "http://music-encoding.org/mei/schemata/ ... ei-all.rng" type="xml"?>).

If you want to create a MEI document type in Oxygen based on the saved local schema files you have to go to menu Options -> Preferences -> Document Type Association, press the New button and follow the instructions for the example document type from the Oxygen Author User Manual (also included in the Oxygen Editor User Manual).

Regards,
Sorin

Post by **/hh** » Tue Sep 28, 2010 11:15 pm

Sorin wrote:

>You don't have to create a custom TEI DTD using the Pizza Chef.

OK, so the subsets offered by the Pizza Chef are supported by the standard TEI DTD.

>You just have to enable the TEI.verse entity of the standard TEI DTD and use the correct element and attribute names in your XML document. If the TEI.verse entity is enabled the verse specific elements and attributes are recognized in the XML document

If the tags in an existing document have no defined syntax, and if as a symptom the software UI does not separate the tags from the text for processing purposes, the manual says (PDF edition page 39) "Go to menu Document > Schema > Associate Schema..." However, this dialogue is not available anywhere in the Document menu.

So far so good.

>Unfortunately the DTD declaration cannot be modified from Author mode so you have to switch to Text mode for that.

After 45min I haven't found a way to do that. How is it done?

Thanks in advance,
/hh

Post by **sorin_ristache** » Wed Sep 29, 2010 10:50 am

/hh wrote:If the tags in an existing document have no defined syntax, and if as a symptom the software UI does not separate the tags from the text for processing purposes, the manual says (PDF edition page 39) "Go to menu Document > Schema > Associate Schema..." However, this dialogue is not available anywhere in the Document menu.

If there is no schema declared explicitly in the XML document Oxygen will try to match one of the rules of the document types from the Preferences (menu Options -> Preferences -> Document Type Association) with the XML document. Only if no rule can be matched indeed we can say the syntax is not defined and you should run the Associate Schema action which is available on menu Document -> Schema.

For example if you create an XML document with the above TEI P4 example that I posted it will be matched automatically with the TEI P4 document type which means the TEI P4 DTD will be used for validation and content completion in that document.

What does the action Validate Document say? Does it say that there is no schema associated with the document? Or does it say that the document does not follow the schema (which means a schema is associated with the document)?

/hh wrote:>Unfortunately the DTD declaration cannot be modified from Author mode so you have to switch to Text mode for that.

After 45min I haven't found a way to do that. How is it done?

In the left bottom corner of the editor panel there are 3 buttons: Text, Grid, Author. These buttons switch between the three editing modes of an XML document.

Regards,
Sorin

Repurposing TEI DTD's

Repurposing TEI DTD's

Re: Repurposing TEI DTD's

Re: Repurposing TEI DTD's

Re: Repurposing TEI DTD's

Re: Repurposing TEI DTD's