Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

first draft for a TEI with RDFa exemplar #2431

Draft
wants to merge 5 commits into
base: dev
Choose a base branch
from
Draft

first draft for a TEI with RDFa exemplar #2431

wants to merge 5 commits into from

Conversation

HelenaSabel
Copy link
Member

@HelenaSabel HelenaSabel commented May 8, 2023

See discussion in #1860

@HelenaSabel HelenaSabel self-assigned this May 8, 2023
@HelenaSabel HelenaSabel marked this pull request as draft May 8, 2023 16:35
@HelenaSabel HelenaSabel removed the request for review from martinascholger May 8, 2023 16:38
@sabineseifert
Copy link
Contributor

Council discussion at VF2F 16 March 2024:
also consult with Ontologies SIG

@martinascholger
Copy link
Member

martinascholger commented Oct 18, 2024

@HelenaSabel and I have revised and updated the exemplar document P5/Exemplars/tei_rdfa.odd. To facilitate the review process, we have added the schema generated from this exemplar (P5/Exemplars/tei_rdfa.rng) so that it can be easily associated to any other files for testing. We also added a TEI example (P5/Exemplars/tei_rdfa.tei).

Next steps:

  • add documentation and examples to the newly created odd
  • add odd to the customization page (https://tei-c.org/guidelines/customization/)
  • update make file for generating .rng automatically
  • decide where in the Guidelines the exemplar should be mentioned.

@chiarcos, could you please have a look at it and make comments?

<moduleRef key="iso-fs"/>
<moduleRef key="nets"/>
<moduleRef key="certainty"/>
<moduleRef key="tagdocs" except="elementSpec moduleRef schemaSpec" />
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

My instinct is that this should be

<moduleRef key="tagdocs" include="att code eg egXML gi ident tag val"/>

<attDef mode="add" ident="about">
<gloss xml:lang="en" versionDate="2020-07-01">rdfa-about</gloss>
<desc xml:lang="en" versionDate="2020-07-01">a SafeCURIEorCURIEorIRI, used for stating
what the data is about (a 'subject' in RDF terminology)</desc>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should “'subject'” be <term>subject</term>?

<desc xml:lang="en" versionDate="2020-07-01">a SafeCURIEorCURIEorIRI, used for stating
what the data is about (a 'subject' in RDF terminology)</desc>
<datatype>
<dataRef key="teidata.enumerated"/>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Huh?
We expect an enumerated list of possible values?

</classes>
</classSpec>

<elementSpec ident="citeData" mode="change">
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Deleting @property from <citeData> isn't a viable solution going forward. The attribute on citeData is (almost) precisely the same thing, except that it doesn't play a role in defining a proper triple (it specifies how to use the document to construct triples). Do these attributes have to be absolutely global? Can we simply override the definition in this case, as we do in various places with @type, for example. I feel like some thinking about the scope of RDFa in TEI might be worthwhile.

<dataRef key="teidata.enumerated"/>
</datatype>
</attDef>
<attDef mode="add" ident="href">
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@href and @src below are the HTML attributes on <a> and <img>, for example. We shouldn't add them. The RDFa spec is explaining how these built in HTML attributes interact with RDF—namely they can act in the same way as @resource. The corresponding TEI attributes are @target and @url, though there are many, many more attributes in TEI that could potentially interact with RDFa. See https://tei-c.org/release/doc/tei-p5-doc/en/html/ref-teidata.pointer.html for a rather dizzying list.

<dataRef key="teidata.enumerated"/>
</datatype>
</attDef>
<attDef mode="add" ident="src">
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

See comment on @href above. We shouldn't add this.

<dataRef key="teidata.nullOrName"/>
</datatype>
</attDef>
<attDef mode="add" ident="prefix">
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@prefix probably isn't needed in a TEI context since we can use @xmlns to declare prefixes. Non-XHTML HTML can't, hence the need for the attribute.

<profileDesc>
<particDesc>
<listPerson>
<person xml:id="disco_004e" about="disco:004e" typeof="foaf:Person">
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I could make an argument that the @about attribute is redundant here....maybe something to think about.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants