Skip to content

Commit

Permalink
version 4.8.0
Browse files Browse the repository at this point in the history
  • Loading branch information
HelenaSabel committed Jul 8, 2024
2 parents e5dd73e + ab54956 commit 1f9891a
Show file tree
Hide file tree
Showing 911 changed files with 5,688 additions and 8,179 deletions.
4 changes: 2 additions & 2 deletions .github/workflows/generate-spec-lists.yml
Original file line number Diff line number Diff line change
Expand Up @@ -11,13 +11,13 @@ jobs:
contents: write
steps:
- name: Checkout TEI Repository
uses: actions/checkout@v3
uses: actions/checkout@v4

- name: Generate JSON Spec list
uses: ./.github/actions/generate-spec-lists

- name: Auto-commit Spec list
uses: stefanzweifel/git-auto-commit-action@v4
uses: stefanzweifel/git-auto-commit-action@v5
with:
commit_user_name: ${{ github.actor }}
commit_message: Re-generated spec lists.
Expand Down
4 changes: 2 additions & 2 deletions .github/workflows/test.yml
Original file line number Diff line number Diff line change
Expand Up @@ -17,10 +17,10 @@ jobs:

steps:
- name: Checkout Guidelines repo
uses: actions/checkout@v3
uses: actions/checkout@v4

- name: Checkout Stylesheets repo
uses: actions/checkout@v3
uses: actions/checkout@v4
with:
repository: TEIC/Stylesheets
ref: dev
Expand Down
160 changes: 90 additions & 70 deletions Documents/pureODD/howtoChain-fr.xml

Large diffs are not rendered by default.

49 changes: 25 additions & 24 deletions Documents/pureODD/howtoChain.xml
Original file line number Diff line number Diff line change
Expand Up @@ -9,13 +9,14 @@
<author>Lou Burnard</author>
</titleStmt>
<publicationStmt>
<p>Discussion draft</p>
<p>As published on lb42.github.io</p>
</publicationStmt>
<sourceDesc>
<p>authored from scratch</p>
</sourceDesc>
</fileDesc>
<revisionDesc>
<change when="2023-12-20">Minor changes for publication on lb42.github.io</change>
<change when="2018-01-04">Expanded and announced on TEI-L</change>
<change when="2016-10-22">Uploaded for Council review</change>
<change when="2016-10-21">Drafted first part on train from Paris to La Souterraine; then lost
Expand Down Expand Up @@ -58,37 +59,36 @@
in the current source tree. And one with the value
<val>http://example.com/superODDs/anotherSubset.xml</val> will go looking for it at the
URL indicated. </p>
<p>It's important to understand that the resource indicated by the <att>source</att>s
<p>It's important to understand that the resource indicated by the <att>source</att>
attribute must contain complete and explicit specification elements: <gi>elementSpec</gi>
rather than <gi>elementRef</gi>, <gi>classSpec</gi> rather than <gi>classRef</gi> and so
on. It may of course contain other TEI elements, but these will be ignored entirely in the
construction of a schema. A file called <ident>p5subset.xml</ident>, provided as part of
every TEI release, is an example of such a resource: it contains specifications for every
single TEI element, class, macro, and datatype, but nothing else much. If the
<att>source</att> parameter is not supplied, the most recently available version of this
single TEI element, class, macro, and datatype, but nothing else much. If a value for the
<att>source</att> attribute is not specified, the most recently available version of this
file is what will be used during the processing of an ODD.</p>
</div>
<div>
<head>Processing an ODD</head>
<p>Let's look more closely at the way the TEI defines a very light weight schema called
<ident>TEI Bare</ident>. Its schema specification element begins like this: <egXML
xmlns="http://www.tei-c.org/ns/Examples">
<schemaSpec ident="tei_bare" xml:lang="en">
<moduleRef key="core" include="p list item label head author title"/>
<moduleRef key="tei"/>
<moduleRef key="header"
include="teiHeader fileDesc titleStmt publicationStmt sourceDesc"/>
<moduleRef key="textstructure" include="TEI text body div front back"/>
<classSpec ident="att.global" mode="change" module="tei" type="atts">
<attList>
<attDef ident="xml:space" mode="delete"/>
<attDef ident="rend" mode="delete"/>
<attDef ident="xml:base" mode="delete"/>
</attList>
</classSpec>
<classSpec ident="att.fragmentable" mode="delete" module="tei" type="atts"/>
</schemaSpec>
</egXML>
<schemaSpec ident="tei_bare" xml:lang="en">
<moduleRef key="core" include="p list item label head author title"/>
<moduleRef key="tei"/>
<moduleRef key="header"
include="teiHeader fileDesc titleStmt publicationStmt sourceDesc"/>
<moduleRef key="textstructure" include="TEI text body div front back"/>
<classSpec ident="att.global" mode="change" module="tei" type="atts">
<attList>
<attDef ident="xml:space" mode="delete"/>
<attDef ident="rend" mode="delete"/>
<attDef ident="xml:base" mode="delete"/>
</attList>
</classSpec>
<classSpec ident="att.fragmentable" mode="delete" module="tei" type="atts"/>
</schemaSpec> </egXML>
</p>
<p>No <att>source</att> is specified, so declarations for the elements requested here will
be taken from the current <ident>p5subset.xml</ident>. </p>
Expand All @@ -98,16 +98,16 @@
specifications for two classes (<gi>classSpec</gi>), rather than references
(<gi>classRef</gi>). The reference to the module <ident>tei</ident> brings with it
specifications for most TEI classes, including these two. An ODD processor will therefore
have to resolve duplicate class specifications for the classes <ident>att.global</ident>
and <ident>att.fragmentable</ident>. The required resolution is indicated by the value of
have to deal with duplicate class specifications for the classes <ident>att.global</ident>
and <ident>att.fragmentable</ident>. The resolution method required is indicated by the value of
the <att>mode</att> attribute: if this is <val>delete</val> then both declarations are to
be ignored, and the class is therefore suppressed; if it is <val>change</val> then the two
declarations are to be merged, with any part of it present in the second specification
over-riding that in the first. In this case, the effect will be to suppress the three
attributes mentioned. </p>
<p>If you'd like to check that this ODD does what you expect, and you have oXygen installed
with a recent version of the TEI Frameworks, just download the file
<ident>tei_bare.odd</ident>, and tell oXygen to apply the predefined transformation
<ident>tei_bare.odd</ident> (you can get it from <ref target="https://github.com/TEIC/TEI/blob/dev/P5/Exemplars/tei_bare.odd">the TEI github repo</ref>), and tell oXygen to apply the predefined transformation
<ident>TEI ODD to HTML</ident> to it. This will produce a mini-manual for the TEI Bare
customization in HTML format, near the beginning of which you should see a list of the
elements the schema contains.
Expand Down Expand Up @@ -251,7 +251,8 @@
the value for the <att>source</att> attribute on the <gi>schemaSpec</gi> defining our
ODD. We could do the same thing (though I don't recommend it) even at the level of
individual elements, by specifying a different version as source for an
<gi>elementSpec</gi>.</p><p>And just to make life a little simpler, there is an
<gi>elementSpec</gi>.</p>
<p>And just to make life a little simpler, there is an
officially recognized short cut built into the current ODD processing stylesheets:
instead of the lengthy URL above, we could simply say <code>tei:3.0.0</code>. For
example, supposing that for some strange reason we don't want to add the current
Expand Down
4 changes: 2 additions & 2 deletions Documents/pureODD/howtoGenerate-fr.xml
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@
<teiHeader>
<fileDesc>
<titleStmt>
<title xml:lang="fr">Comment faire un ODD magiquement</title>
<author>Lou Burnard</author>
<title xml:lang="fr">Comment faire un ODD automagiquement</title>
<author>Lou Burnard et Emmanuel Château-Dutier</author>
</titleStmt>
<publicationStmt>
<p>Traduction d’un brouillon de tutoriel non publié intitulé <title>How to Make an ODD
Expand Down
27 changes: 14 additions & 13 deletions P5/Exemplars/tei_all.odd
Original file line number Diff line number Diff line change
Expand Up @@ -70,19 +70,20 @@
<moduleRef n="06" key="verse"/>
<moduleRef n="07" key="drama"/>
<moduleRef n="08" key="spoken"/>
<moduleRef n="17" key="analysis"/>
<moduleRef n="09" key="dictionaries"/>
<moduleRef n="10" key="msdescription"/>
<moduleRef n="11" key="transcr"/>
<moduleRef n="12" key="textcrit"/>
<moduleRef n="13" key="namesdates"/>
<moduleRef n="14" key="figures"/>
<moduleRef n="15" key="corpus"/>
<moduleRef n="16" key="linking"/>
<moduleRef n="18" key="iso-fs"/>
<moduleRef n="19" key="nets"/>
<moduleRef n="21" key="certainty"/>
<moduleRef n="22" key="tagdocs"/>
<moduleRef n="09" key="cmc"/>
<moduleRef n="18" key="analysis"/>
<moduleRef n="10" key="dictionaries"/>
<moduleRef n="11" key="msdescription"/>
<moduleRef n="12" key="transcr"/>
<moduleRef n="13" key="textcrit"/>
<moduleRef n="14" key="namesdates"/>
<moduleRef n="15" key="figures"/>
<moduleRef n="16" key="corpus"/>
<moduleRef n="17" key="linking"/>
<moduleRef n="19" key="iso-fs"/>
<moduleRef n="20" key="nets"/>
<moduleRef n="22" key="certainty"/>
<moduleRef n="23" key="tagdocs"/>
</schemaSpec>
</body>
</text>
Expand Down
27 changes: 14 additions & 13 deletions P5/Exemplars/tei_allPlus.odd
Original file line number Diff line number Diff line change
Expand Up @@ -70,19 +70,20 @@
<moduleRef n="06" key="verse"/>
<moduleRef n="07" key="drama"/>
<moduleRef n="08" key="spoken"/>
<moduleRef n="09" key="dictionaries"/>
<moduleRef n="10" key="msdescription"/>
<moduleRef n="11" key="transcr"/>
<moduleRef n="12" key="textcrit"/>
<moduleRef n="13" key="namesdates"/>
<moduleRef n="14" key="figures"/>
<moduleRef n="15" key="corpus"/>
<moduleRef n="16" key="linking"/>
<moduleRef n="17" key="analysis"/>
<moduleRef n="18" key="iso-fs"/>
<moduleRef n="19" key="nets"/>
<moduleRef n="21" key="certainty"/>
<moduleRef n="22" key="tagdocs"/>
<moduleRef n="09" key="cmc"/>
<moduleRef n="10" key="dictionaries"/>
<moduleRef n="11" key="msdescription"/>
<moduleRef n="12" key="transcr"/>
<moduleRef n="13" key="textcrit"/>
<moduleRef n="14" key="namesdates"/>
<moduleRef n="15" key="figures"/>
<moduleRef n="16" key="corpus"/>
<moduleRef n="17" key="linking"/>
<moduleRef n="18" key="analysis"/>
<moduleRef n="19" key="iso-fs"/>
<moduleRef n="20" key="nets"/>
<moduleRef n="22" key="certainty"/>
<moduleRef n="23" key="tagdocs"/>
<xi:include href="tei_svg.odd"
xpointer="xmlns(t=http://www.tei-c.org/ns/1.0)xpointer(//t:moduleRef[@url])">
<xi:fallback> ERROR: cannot locate ODD changes for SVG </xi:fallback>
Expand Down
27 changes: 16 additions & 11 deletions P5/Exemplars/tei_basic.odd
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,8 @@
<fileDesc>
<titleStmt>
<title>TEI Basic</title>
<author>Hugh Cayless</author>
<author xml:id="HC">Hugh Cayless</author>
<editor xml:id="SB">Syd Bauman</editor>
</titleStmt>
<publicationStmt>
<publisher>TEI Consortium</publisher>
Expand All @@ -23,6 +24,9 @@
<p>Derived from TEI All.</p>
</sourceDesc>
</fileDesc>
<revisionDesc>
<change who="#SB">Added CMC and re-numbered accordingly.</change>
</revisionDesc>
</teiHeader>
<text>
<body>
Expand All @@ -42,16 +46,17 @@
<moduleRef n="06" key="verse"/>
<moduleRef n="07" key="drama"/>
<moduleRef n="08" key="spoken"/>
<moduleRef n="17" key="analysis"/>
<moduleRef n="10" key="msdescription"/>
<moduleRef n="11" key="transcr"/>
<moduleRef n="12" key="textcrit"/>
<moduleRef n="13" key="namesdates"/>
<moduleRef n="14" key="figures"/>
<moduleRef n="15" key="corpus"/>
<moduleRef n="16" key="linking"/>
<moduleRef n="21" key="certainty"/>
<moduleRef n="09" key="cmc"/>
<moduleRef n="18" key="analysis"/>
<moduleRef n="11" key="msdescription"/>
<moduleRef n="12" key="transcr"/>
<moduleRef n="13" key="textcrit"/>
<moduleRef n="14" key="namesdates"/>
<moduleRef n="15" key="figures"/>
<moduleRef n="16" key="corpus"/>
<moduleRef n="17" key="linking"/>
<moduleRef n="22" key="certainty"/>
</schemaSpec>
</body>
</text>
</TEI>
</TEI>
8 changes: 5 additions & 3 deletions P5/Exemplars/tei_enrich.odd
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<TEI xmlns="http://www.tei-c.org/ns/1.0"
xmlns:sch="http://purl.oclc.org/dsdl/schematron"

xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:s="http://www.ascc.net/xml/schematron"
xml:lang="en"
Expand Down Expand Up @@ -3454,8 +3453,11 @@ which should be supported by a more detailed description using the
<elementSpec ident="date" mode="change" module="core">
<constraintSpec scheme="schematron" ident="dates">
<constraint>
<sch:assert test="@when or (@notAfter and @notBefore) or (@from and @to)">
You must provide either @when or @to/@from, or @notAfter/@notBefore.</sch:assert>
<sch:rule context="tei:date">
<sch:assert test="@when or (@notAfter and @notBefore) or (@from and @to)">
You must provide either @when or @to/@from, or @notAfter/@notBefore.
</sch:assert>
</sch:rule>
</constraint>
</constraintSpec>
</elementSpec>
Expand Down
Loading

0 comments on commit 1f9891a

Please sign in to comment.