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

Improve biblStruct examples #1773

Closed
jamescummings opened this issue May 24, 2018 · 5 comments
Closed

Improve biblStruct examples #1773

jamescummings opened this issue May 24, 2018 · 5 comments

Comments

@jamescummings
Copy link
Member

c.f. https://listserv.brown.edu/archives/cgi-bin/wa?A2=TEI-L;7d360e0c.1805

which suggests improving our biblStruct examples.

Putting a ticket it to remind us to do so with the suggestions provided, but lower urgency than some other issues.

@martinascholger
Copy link
Member

Good examples using specific attributes. How about choosing two or three and add a note which type of publication is described (manuscript, article in a volume/journal, etc.)?

@vbigot-juloux
Copy link

@jamescummings: Chuck only looked to biblStruct element page and not the examples listed. Then, maybe an additional question should be: is the “Show all” link is enough visible? Maybe a note needs to be added before the example like “For further examples, click on ‘Show all’ link” or something like that.

There are indeed already a lot of good examples using core elements e.g. analytic series, monogr (c.f. http://www.tei-c.org/release/doc/tei-p5-doc/en/html/examples-biblStruct.html). As @martinascholger wrote, it needs only examples with specific attributes--currently there are 2 examples of attributes within biblStruct: <biblStruct type="patent"> and <biblStruct type="book">--but no note added yet. Thus, I suggest completing the current examples with additional attributes.
However, we can also add one example with one @type on the biblStruct element page.

@peterstadler peterstadler added this to the Guidelines 3.7.0 milestone Sep 16, 2019
@peterstadler peterstadler removed this from the Guidelines 4.1.0 milestone Aug 15, 2020
@trishaoconnor trishaoconnor self-assigned this Jan 23, 2023
@trishaoconnor
Copy link
Contributor

trishaoconnor commented Feb 17, 2023

@sydb and I were reviewing the examples for inclusion on the <biblStruct> element page. We like the example under [3.12.2.1 Analytic, Monographic, and Series Levels]. We think it would be a good example to include on the <biblStruct> element page if it were re-encoded using <relatedItem>.

We would like to consult a German speaker (@martinascholger?) to advise on how best to re-encode the below example using <relatedItem>.

<biblStruct>
 <analytic>
  <author>
   <persName>
    <surname>Thaller</surname>
    <forename>Manfred</forename>
   </persName>
  </author>
  <title level="a">A Draft Proposal for a Standard for the
     Coding of Machine Readable Sources</title>
 </analytic>
 <monogr>
  <title level="j">Historical Social Research</title>
  <imprint>
   <date when="1986-10">October 1986</date>
  </imprint>
  <biblScope unit="volume">40</biblScope>
  <biblScope unit="page" from="3" to="46">3-46</biblScope>
 </monogr>
 <monogr>
  <title level="m">Modelling Historical Data:
     Towards a Standard for Encoding and
     Exchanging Machine-Readable Texts</title>
  <editor>
   <persName>
    <forename>Daniel</forename>
    <forename full="init">I.</forename>
    <surname>Greenstein</surname>
   </persName>
  </editor>
  <imprint xml:lang="de">
   <pubPlace>St. Katharinen</pubPlace>
   <publisher>Max-Planck-Institut für Geschichte
       In Kommission bei
       Scripta Mercaturae Verlag</publisher>
   <date when="1991"/>
  </imprint>
 </monogr>
 <series xml:lang="de">
  <title level="s">Halbgraue Reihe
     zur Historischen Fachinformatik</title>
  <respStmt>
   <resp>Herausgegeben von</resp>
   <name type="person">Manfred Thaller</name>
   <name type="org">Max-Planck-Institut für Geschichte</name>
  </respStmt>
  <title level="s">Serie A: Historische Quellenkunden</title>
  <biblScope unit="volume">11</biblScope>
 </series>
</biblStruct>


@trishaoconnor
Copy link
Contributor

Please dismiss the previous comment. After further discussion @sydb and I realised that re-encoding a <biblStruct> element example using <relatedItem> is unnecessary.

As requested, we would like to propose a new example of the <biblStruct> element with the @type attribute for inclusion on the <biblStruct> element page.

<exemplum versionDate="2023-02-20" xml:lang="en">
    <egXML xmlns="http://www.tei-c.org/ns/Examples">
      <biblStruct type="newspaper">
        <analytic>
          <author>
            <forename>David</forename>
            <surname>Barstow</surname>
          </author>
          <author>
            <forename>Susanne</forename>
            <surname>Craig</surname>
          </author>
          <author>
            <forename>Russ</forename>
            <surname>Buettner</surname>
          </author>
          <title type="main">Trump Took Part in Suspect Schemes to Evade Tax Bills</title>
        <title type="sub">Behind the Myth of a Self-Made Billionaire, a Vast Inheritance From His Father.</title>
        </analytic>
        <monogr>
          <title level="j">The New York Times</title>
          <imprint>
            <pubPlace>New York</pubPlace>
            <publisher>A. G. Sulzberger</publisher>
            <date when="2018-10-03">Wednesday, October 3, 2018</date>
          </imprint>
          <biblScope unit="volume">CLXVIII</biblScope>
          <biblScope unit="issue">58,104</biblScope>
          <biblScope unit="page">1</biblScope>
        </monogr>
      </biblStruct>
    </egXML>
  </exemplum>

@lb42
Copy link
Member

lb42 commented Feb 21, 2023

Not just unnecessary. Stark raving bonkers!

sydb added a commit that referenced this issue Mar 21, 2023
…1773 (#2405)

* Added new example of the <biblStruct> element with a type attribute for issue 1773

* Re-generated spec lists.

* Re-generated spec lists.

* Deleted concluding punctuation in subtitle

---------

Co-authored-by: trishaoconnor <trishaoconnor@users.noreply.github.com>
Co-authored-by: Helena Bermúdez Sabel <helena.b.sabel@gmail.com>
Co-authored-by: HelenaSabel <HelenaSabel@users.noreply.github.com>
Co-authored-by: Syd Bauman <sydb@users.noreply.github.com>
@martinascholger martinascholger added this to the Guidelines 4.6.0 milestone Apr 3, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

8 participants