Bug 25233

Created attachment 103420 [details] [review]
Bug 25233: Make OPAC XSLT stylesheets consistent with the ones for the staff client

This patch makes the OPAC XSLT stylesheets consistent with the ones for the staff client
TO TEST:
1. Have a record with leader06 = 'a' and leader07 = 'c' 'd' or 'm'.
2. Check the OPAC results and details page. See that the materila type label says "Text"
3. Check the staff client results and details page. See that the materila type label says "Book"
4. Apply patch.
5. See that both staff client and OPAC results/details all now say "Book"

It was changed to Text on purpose a while ago IIRC, because the description is not book on the MARC standard, it can be anything textual, not only print.

Not only books is what I mean. I remember because we had librraies complaining about the book icon in some combinations.

Cait,

So to be consistent with between OPAC/staff should be change the wording in the staff client XSLT to 'Text'?

> leader06 = 'a' and leader07 = 'c' 'd' or 'm'

a - Language material

Used for non-manuscript language material. Manuscript language material uses code t.Includes microforms and electronic resources that are basically textual in nature, whether they are reproductions from print or originally produced.

c - Collection
d - Subunit
m - Monograph/Item


The interesting part is, that a is also used for microforms and electronic resources, so the book and "book" description is not helpful in these cases.

I think we should change staff to match.

Yes, sorry, just typed up the other comment - I had worked that out a while ago when we got the complaints and I was trying to see if our records were correct.

Created attachment 103424 [details] [review]
Make the staff client XSLT stylesheets consistent with the ones for the OPAC

This patch makes the staff client XSLT stylesheets consistent with the ones for the OPAC, it also makes consitent the use of 'Text' when the leader6 = 't'
TO TEST:
1. Have a record with leader06 = 'a' and leader07 = 'c' 'd' or 'm'.
2. Check the staff client results and details page. See that the material type label says "Book"
3. Check the OPAC client results and details page. See that the materila type label says "Text"
4. Apply patch.
5. See that both staff client and OPAC results/details all now say "Text"
6. Set the leader6 = 't' and make sure that is says 'Text' on both the staff client and OPAC

(In reply to Katrin Fischer from comment #6)
> Yes, sorry, just typed up the other comment - I had worked that out a while
> ago when we got the complaints and I was trying to see if our records were
> correct.

Yep, I totally agree with you.

Hi Katrin,
When I look up the Marc Standard for the appropriate term for this material type, I am finding more examples are directing toward the word Book, not Text.

http://www.loc.gov/marc/bibliographic/bdleader.html
https://www.oclc.org/bibformats/en/fixedfield/type.html

Can you tell me where the marc standard that Koha is following can be found, and then I have a place to direct a library to?  

Overall, I would love to see these consistent in Staff and OPAC. 

Thanks!
Kell

(In reply to Kelly McElligott from comment #9)

> http://www.loc.gov/marc/bibliographic/bdleader.html

I don't see any mention of "Book" on this page. The language is very generic.

> https://www.oclc.org/bibformats/en/fixedfield/type.html

Isn't the use of "BKS - Books" on this page a decision made by OCLC, not part of the MARC standard?
 
> Can you tell me where the marc standard that Koha is following can be found,
> and then I have a place to direct a library to?  

I think using the term "Text" is a good human-readable compromise. On the other hand, if a library is complaining about it why not use a custom XSL file? (Bug 25216 notwithstanding).

Created attachment 103469 [details] [review]
Bug 25233: Staff XSLT material type label "Book" should be "Text"

This patch makes the staff client XSLT stylesheets consistent with the
ones for the OPAC, it also makes consitent the use of 'Text' when the leader6 = 't'

TO TEST:
1. Have a record with leader06 = 'a' and leader07 = 'c' 'd' or 'm'.
2. Check the staff client results and details page. See that the
   material type label says "Book"
3. Check the OPAC client results and details page. See that the
   materila type label says "Text"
4. Apply patch.
5. See that both staff client and OPAC results/details all now say
   "Text"
6. Set the leader6 = 't' and make sure that is says 'Text' on both the
   staff client and OPAC

Signed-off-by: Owen Leonard <oleonard@myacpl.org>

Hi Kelly,

> When I look up the Marc Standard for the appropriate term for this material
> type, I am finding more examples are directing toward the word Book, not
> Text.
> 
> http://www.loc.gov/marc/bibliographic/bdleader.html
> https://www.oclc.org/bibformats/en/fixedfield/type.html

Can you be more specific about the examples?

> Can you tell me where the marc standard that Koha is following can be found,
> and then I have a place to direct a library to?  

I always assumed there is only one standard, with the documents published on the LOC page: http://www.loc.gov/marc/ I know that Germany and other countries are also participating in the development of the standard by participation in the committees (http://www.loc.gov/marc/mac/MAC_members.html).

(In reply to Kelly McElligott from comment #9)
> Hi Katrin,
> When I look up the Marc Standard for the appropriate term for this material
> type, I am finding more examples are directing toward the word Book, not
> Text.
> 
> http://www.loc.gov/marc/bibliographic/bdleader.html
> https://www.oclc.org/bibformats/en/fixedfield/type.html
> 

Hi Kelly,

I think that you're misinterpreting what you're seeing in those links. 

Library of Congress (http://www.loc.gov/marc/bibliographic/bdleader.html):
" - Language material
Used for non-manuscript language material. Manuscript language material uses code t.

Includes microforms and electronic resources that are basically textual in nature, whether they are reproductions from print or originally produced."

Definitely "Text" rather than "Book.

OCLC (https://www.oclc.org/bibformats/en/fixedfield/type.html):

You can see "Language material" being used for "BKS - Books" and "CNR - Continuing Resources" at the top there. These are OCLC concepts and not MARC standards.

If you go down further, you'll also see this text:
"	
a	
Language material. Non-manuscript language or textual material including all published print language material, original microform publications of language material, microform reproductions of published language material, and published textual electronic resources. In Books format, examples include books, pamphlets, technical reports, etc. In Continuing Resources format, examples include annuals, journals, newspapers, periodicals, proceedings, etc. Use code e or f for cartographic atlases. Use code t for manuscript or unpublished language material. Use code a for online textual material, including digitized textual manuscripts."

So note that "Books" is a format that OCLC applies to more than just Books.

And "Language material" applies to many non-Books with that Continuing Resources format like journals, newspapers, etc. 

Ultimately, there's just really no possible way that "Book" is an accurate label for "Language material".

For what it's worth, I'm the one who opened the report to change "Book" to "Text" for the OPAC back in 2013: https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=10562. I think Owen wrote his patch in 2018 and it got pushed in 2019. 

Oh... but something that we're not considering is the Leader/07 and that's something that is obviated by https://www.oclc.org/bibformats/en/fixedfield/type.html. 

In the OCLC example, they're choosing "Books" with a Leader/07 of a,c,d,m and "Continuing Resources" with a Leader/07 of b, i, s.

If we look at the patch, the XSLT does actually generate a label based on both Leader/06 and Leader/07, Koha is saying "Book/Text" for Leader/07 of c,d,m... "Continuing resource" for Leader/07 of i, s... "Article" for Leader/07 of "a" or "b". 

I don't think we considered the Leader/07 with the Leader/06 when I originally raised the issue in Bugzilla back in 2013...

It's tricky because OCLC's and Koha's use of the Leader/07 with the Leader/06 is still a bit problematic. For instance, a Leader/06 of "a" and Leader/07 of "a" would be classed by OCLC as a Book and by Koha as an Article, but it could actually be a "Book Chapter".

The MARC standard itself is pretty problematic, especially when it comes to fixed field data (ie trying to put too much information into too small a space).

I mean that's why we have fields like 
https://www.loc.gov/marc/bibliographic/bd336.html
https://www.loc.gov/marc/bibliographic/bd337.html
https://www.loc.gov/marc/bibliographic/bd338.html

It seems to me the goals of the cataloguer are at odds with the goals of the user-facing library.

I still think "Text" is probably the best compromise for a label, but I can understand opposition to that. 

For what it's worth, so long as it's consistent across the staff client and OPAC, I don't care too much. Since it's in the XSLT, it is fairly easy to customize.

Created attachment 103716 [details] [review]
Bug 25233: Staff XSLT material type label "Book" should be "Text"

This patch makes the staff client XSLT stylesheets consistent with the
ones for the OPAC, it also makes consitent the use of 'Text' when the leader6 = 't'

TO TEST:
1. Have a record with leader06 = 'a' and leader07 = 'c' 'd' or 'm'.
2. Check the staff client results and details page. See that the
   material type label says "Book"
3. Check the OPAC client results and details page. See that the
   materila type label says "Text"
4. Apply patch.
5. See that both staff client and OPAC results/details all now say
   "Text"
6. Set the leader6 = 't' and make sure that is says 'Text' on both the
   staff client and OPAC

Signed-off-by: Owen Leonard <oleonard@myacpl.org>

Signed-off-by: Katrin Fischer <katrin.fischer.83@web.de>

Nice work everyone!

Pushed to master for 20.05

Backported to 19.11.x for 19.11.06

backported to 19.05.x for 19.05.11