Subject: Re: [niso-sts] Where to put <long-desc> From: "Bruce Rosenblum bruce@xxxxxxxxx" <niso-sts-list-service@xxxxxxxxxxxxxxxxxxxxxx> Date: Fri, 2 Feb 2018 21:10:24 -0000 |
Denise, You have a choice: a) Put the text in the long-desc element itself, which supports older systems <long-desc>My description</long-desc> b) Put a URI in the long-desc element, and place the text at the location of the URI <long-desc> https://mywebsite.com/standard1234/long-desc/figure1_desc.html </long-desc> and then place the text "My description" at the URI inside long-desc c) Put both in long-desc <long-desc xlink:href=" https://mywebsite.com/standard1234/long-desc/figure1_desc.html ">My description https://mywebsite.com/standard1234/long-desc/figure1_desc.html </long-desc> where the URI appears in both xlink:href and in the element content. This is the most compatible practice across all systems. It's option c that's described in the best practice note at http://www.niso-sts.org/TagLibrary/niso-sts-TL-1-0-html/element/long-desc.htm l Bruce At 04:02 PM 2/2/2018, Denise French dfrenchlibrary@xxxxxxxxx wrote: I *KNOW* <long-desc> is to describe visual structures inside documents. What I don't know is *where to put the text* if it is not supposed to be inside the <long-desc> element.B The example at:B http://www.niso-sts.org/TagLibrary/niso-sts-TL-1-0-html/element/long-desc.htm l shows it inside the <long-desc>, but the text on that same page says: ...B B some newer systems expect this element to contain a URI that points to such a description. Best Practice is to incorporate a textual description, including or ending with an untagged URI, and repeat the URI in theB @xlink:hrefB attribute so that a link can be made. And I want to know, where should that URI point, and where should the text be that the URI points to?B Does that make any sense?B On Fri, Feb 2, 2018 at 3:53 PM, Bruce Rosenblum bruce@xxxxxxxxx < niso-sts-list-service@xxxxxxxxxxxxxxxxxxxxxx> wrote: Hi Denise, long-desc is not used to describe the entire document. long-desc is specifically meant for figures, so it should be inside the <fig> element, and there should be one to describe each figure in the document. Please see the example at the bottom of http://www.niso-sts.org/TagLibrary/niso-sts-TL-1-0-html/element/long-desc.htm l long-desc can also be used to describe other objects such as tables or media objects, but it is more frequently used for figures. Bruce At 03:45 PM 2/2/2018, Denise French dfrenchlibrary@xxxxxxxxx wrote: Thank you, but this does not help. WHERE should that long description to which the document points BE? Is it part of the XML? That is, if the long description is a paragraph, where in the XML is that paragraph? And if it is not in the XML, where should it be? Are we expected to put it on a public server in a place that we hope will never change and point to it? This seems odd, and probably unworkable.C Perhaps I am misunderstanding something, but it looks to me like the "Best Practice" is to put the actual text of the long description outside the <long-desc> tag, but I don't see any guidance on where to put it. On Fri, Feb 2, 2018 at 3:37 PM, Robert Wheeler wheelerr@xxxxxxxx < niso-sts-list-service@xxxxxxxxxxxxxxxxxxxxxx> wrote: Hi Denise, C This is one of the tags (and descriptions) C"ininheritedC" from JATS. Apologies if I am misunderstanding your question, but under the Remarks, there is some further description: C"Long Description Contents:C This elementnt was originally designed toC containC a description, but some newer systems expect this element to contain a URI that points to such a description.C" C So, the element can contain this long description, but could also contain a URI that points to that long description. C Please let me know if I am misunderstanding your question. C Thanks, Robert C C From: Denise French dfrenchlibrary@xxxxxxxxx [ mailto:niso-sts-list-service@xxxxxxxxxxxxxxxxxxxxxx] Sent: Friday, February 2, 2018 2:55 PM To: niso-sts-list@xxxxxxxxxxxxxxxxxxxxxx Subject: [niso-sts] Where to put <long-desc> C Please be patient with me, I have another question:C C I read in the element description of <long-desc> that: "Best Practice is to incorporate a textual description, including or ending with an untagged URI, and repeat the URI in theC @xlink:hrefC attribute so that a link can be made." C What I don't see is what it should link TO. And if, as I guess, it should link to a textual description, where should that description be? It seems logical that it should be part of the XML of the document, because if it is not it won't be transmitted with the document. But ... where. And tagged how? And if NOT part of the document, then where should it be and how will people know to point to it?C C Thank you. C ------------------------------------------------------------------- This email message and any attachments are confidential. If you are not the intended recipient, please immediately reply to the sender or call 617-932-1932 and delete the message from your email system. Thank you. ------------------------------------------------------------------- Bruce D. Rosenblum Inera Inc. 19 Flett Road, Belmont, MA 02478 phone: 617-932-1932 (office) email: bruce@xxxxxxxxx web: www.inera.com | www.edifix.com twitter:B @eXtyles | @edifix ------------------------------------------------------------------- This email message and any attachments are confidential. If you are not the intended recipient, please immediately reply to the sender or call 617-932-1932 and delete the message from your email system. Thank you. ------------------------------------------------------------------- Bruce D. Rosenblum Inera Inc. 19 Flett Road, Belmont, MA 02478 phone: 617-932-1932 (office) email: bruce@xxxxxxxxx web: www.inera.com | www.edifix.com twitter: @eXtyles | @edifix You are subscribed as archive-lists.mulberrytech.com-niso-sts-list@xxxxxxxxxxx to NISO STS Discussion by Mulberry Technologies, Inc.EasyUnsubscribe (by email)
Current Thread |
---|
|
<- Previous | Index | Next -> |
---|---|---|
Re: [niso-sts] Where to put <long-d, Denise French dfrenc | Thread | Re: [niso-sts] Where to put <long-d, Tommie Usdin btusdin |
Re: [niso-sts] Where to put <long-d, Denise French dfrenc | Date | Re: [niso-sts] Where to put <long-d, Tommie Usdin btusdin |
Month |