SAA-SDT / EAS-TagLibraries

Tag Libraries for Encoded Archival Description Version 3 and Encoded Archival Context: Corporate Bodies, Persons, and Families
7 stars 5 forks source link

Addition of "Examples" heading in the attributes description #63

Closed karinbredenberg closed 4 months ago

karinbredenberg commented 4 years ago

Creator of issue

  1. Karin Bredenberg, TS EAS co-chair

The issue relates to

Wanted change/feature

alexduryee commented 4 years ago

It looks like the transformation process already supports this - there's an attribute example in the EAD3 TEI (https://github.com/SAA-SDT/EAS-TagLibraries/blob/master/tei/EAD3-TL-eng.xml#L401). If we can get examples for all of the attributes, we can just slot them in, and it'll render in the PDF/HTML without issue.

alexduryee commented 3 years ago

As discussed at 2020-09-14 meeting:

kerstarno commented 3 years ago

Shared attributes

EAD-only attributes

kerstarno commented 3 years ago

I'll have a look through the TL in terms of which of these might already be covered via elements used for the elements that they go with in a next step.

kerstarno commented 3 years ago

Shared attributes

kerstarno commented 3 years ago

EAD-only attributes

alexduryee commented 3 years ago

Thank you! I've added in examples for all but the following attributes:

I generated a few that were not present in the TL already from an ArchivesSpace export (e.g. id vs. containerid, datechar) and copied up ones from the examples @kerstarno provided.

kerstarno commented 3 years ago

Further examples for the remaining attributes with the exception of @entityref.

For @approximate, @base and @otherdaotype

<archdesc level="collection">
  <did>
    <unittitle>AIDS Legal Referral Panel Records (see more at <ref 
    href="https://calisphere.org/collections/469/">Calisphere</ref>)</unittitle>
    <daoset base="https://calisphere.org/item/">
      <dao daotype="otherdaotype" otherdaotype="surrogate" href="d3888b77-7d95-4fd0-bcdd-ab5551a4f013"/>
      <dao daotype="otherdaotype" otherdaotype="surrogate" href="d5e032bf-57a3-45e9-9f14-1782bc2e95e7"/>
      <dao daotype="otherdaotype" otherdaotype="surrogate" href="fd76d8fb-cafb-44c5-a5b5-e34673498b7a"/>
    </daoset>
    <physdescstructured physdescstructuredtype="carrier" coverage="whole">
      <quantity approximate="true">15</quantity>
      <unittype>boxes</unittype>
    </physdescstructured>
  </did>
</archdesc>

For @nameend, @namest, and @pgwide

<scopecontent>
  <table pgwide="false">
    <tgroup cols="4">
      <colspec colnum="1" colname="correspondent"/>
      <colspec colnum="2" colname="total"/>
      <colspec colnum="3" colname="sent"/>
      <colspec colnum="4" colname="received"/>
      <thead>
        <row>
          <entry colname="correspondent">Correspondent</entry>
          <entry colname="total">Total number of letters</entry>
          <entry namest="sent" nameend="received">Letters sent and received</entry>
        </row>
      </thead>
      <tbody>
        <!-- [...] -->
        <row>
          <entry colname="correspondent">Douglass, Frederick</entry>
          <entry colname="total">93</entry>
          <entry colname="sent">47</entry>
          <entry colname="received">46</entry>
        </row>
        <row>
          <entry colname="correspondent">Phillips, Wendell</entry>
          <entry colname="total">17</entry>
          <entry colname="sent">12</entry>
          <entry colname="received">5</entry>
        </row>
        <!-- [...] -->
       </tbody>
     </tgroup>
   </table>
</scopecontent>

For @althead, @char, @charoff, @morerows, and @pgwide

<bioghist>
  <head althead="Family relations">Bach family relations listing spouses and children of the major family members</head>
  <table pgwide="true">
    <tgroup cols="3">
      <colspec colnum="1" colname="member"/>
      <colspec colnum="2" colname="spouse"/>
      <colspec colnum="3" colname="child" align="char" char="*" charoff="2"/>
      <thead>
        <row>
          <entry colname="member">Major family members</entry>
          <entry colname="spouse">Spouses</entry>
          <entry colname="child">Children</entry>
        </row>
      </thead>
      <tbody>
        <!-- [...] -->
        <row>
          <entry colname="member" morerows="5" valign="top">Johann Sebastian Bach (1685-1750)</entry>
          <entry colname="spouse" morerows="2" valign="top">Maria Barbara Bach (1684-1720)</entry>
          <entry colname="child">* Wilhelm Friedemann Bach (1710–1784)</entry>
        </row>
        <row>
          <entry colname="member"/>
          <entry colname="spouse"/>
          <entry colname="child">* Carl Philipp Emanuel Bach (1714–1788)</entry>
        </row>
        <row>
          <entry colname="member"/>
          <entry colname="spouse"/>
          <entry colname="child">* Johann Gottfried Bernhard Bach (1715–1739)</entry>
        </row>
        <row>
          <entry colname="member"/>
          <entry colname="spouse" morerows="2" valign="top">Anna Magdalena, geb. Wilcke (1701–1760)</entry>
          <entry colname="child">* Gottfried Heinrich Bach (1724–1763)</entry>
        </row>
        <row>
          <entry colname="member"/>
          <entry colname="spouse"/>
          <entry colname="child">* Johann Christoph Friedrich Bach (1732–1795)</entry>
        </row>
        <row>
          <entry colname="member"/>
          <entry colname="spouse"/>
          <entry colname="child">* Johann Christian Bach (1735–1782)</entry>
        </row>
        <!-- [...] -->
      </tbody>
    </tgroup>
  </table>
</bioghist>

For @xpointer

<relatedmaterial>
  <p>See the <ref xpointer="ScMG108.xml#letters">letters from Frederick Douglass, 1870-1886</ref></p>
</relatedmaterial>

For @transliteration

<relations>
  <relation relationtype="cpfrelation">
    <relationentry localtype="original-language" lang="ger">Hannah Arendt (1906-1975)</relationentry>
    <relationentry localtype="translation" lang="jap" transliteration="DIN32708">アーレント, ハナ (1906-1975)</relationentry>
  </relation>
</relations>

For @otherdsctype and @otherlevel

<dsc dsctype="otherdsctype" otherdsctype="structural">
  <c level="subseries">
    <did>
      <unittitle>Clippings</unittitle>
    </did>
    <c level="otherlevel" otherlevel="sub-subseries">
      <did>
        <unittitle>Clippings (chronological)</unittitle>
      </did>
    </c>
    <c level="otherlevel" otherlevel="sub-subseries">
      <did>
        <unittitle>Clippings (persons)</unittitle>
      </did>
    </c>
  </c>
  <c level="subseries">
    <did>
      <unittitle>Notes</unittitle>
    </did>
  </c>
</dsc>
<dsc dsctype="in-depth">
  <!-- [...] -->
  <c level="otherlevel" otherlevel="sub-subseries">
    <did>
      <unitid>1 to 159</unitid>
      <unittitle>Clippings (chronological)</unittitle>
      <unitdatestructured>
        <daterange>
          <fromdate standarddate="1952-06-12">12 June 1952</fromdate>
          <todate standarddate="1966">1966</todate>
        </daterange>
      </unitdatestructured>
      <abstract>This series consists of newspaper clippings gathered by Fred Reed, pertaining to the Champlain Transportation 
      Company, its vessels, and the vessels' crew members. Several of the folders of chronological clippings include subjects, 
      such as the move of the Ticonderoga (1954-1955) and the sale of the Champlain Transportation Company (1966).
      </abstract>
      <physdescstructured physdescstructuredtype="spaceoccupied" coverage="whole">
        <quantity>0.2</quantity>
        <unittype>meters</unittype>
      </physdescstructured>
      <!-- [...] -->
    </did>
  </c>
  <!-- [...] -->
</dsc>
kerstarno commented 4 months ago

Closing this issue as it has been resolved.