https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=31019

--- Comment #14 from David Nind <[email protected]> ---
Created attachment 175967
  -->
https://bugs.koha-community.org/bugzilla3/attachment.cgi?id=175967&action=edit
Screenshots - Basic editor before and after the patch

Notes from working on this bug:
1. The authority record editor does not have help text.
2. For a MARC21 instance, there are some tags that use a different URL 
   pattern, such as the leader (000), and 9XX tags. There is extra code
   so that the help text link goes to the correct Library of Congress 
   pages where this is the case.
3. I originally thought that you could insert a default custom URL 
   format as a value for MarcFieldDocURL, depending on whether it 
   was a MARC21 or UNIMARC instance. Mainly as I think it is a bad idea
   to hard code URLs, unless it can be avoided. However, this doesn't 
   seem possible (to me, anyway) because of 2.
4. The help link code for the advanced editor is much easier to follow
   than the code for the basic editor (for me anyway!). 
5. I've just done a "basic" fix, so that there are no broken links for 
   UNIMARC. However, someone who knows what they are doing could 
   probably consolidate and streamline the code so both the basic and 
   advanced editor use the same code (and perhaps use the same code to
   add help links for the authority record editor in the future).
   However, doing this is beyond my skills!
6. Some links:
   - UNIMARC documentation in languages other than English - scroll 
     down to the UNIMARC Translation heading:
     https://www.ifla.org/g/unimarc-rg/unimarc-updates/
   - Canadian MARC21 documentation URL pattern: 
     http://www.marc21.ca/MaJ/BIB/B{FIELD}.pdf
7. For UNIMARC, I did think of linking to the consolidated PDF page 
  
(https://www.ifla.org/unimarc-updates/unimarc-bibliographic-format-manual-online-ed/).
 
   However, I think the page linked to is less likely to change in the 
   future, and it is more comprehensive.
8. If IFLA does eventually provide web pages for each tag, then another
   bug is required to update the help links.
9. In case it is useful, I've added some screenshots from before and
   after the change.

[1] The current system preference text for MarcFieldDocURL:

Use ____________ as the URL for MARC field documentation. Possible
substitutions are {MARC} (marc flavour, eg. "MARC21" or "UNIMARC"), {FIELD}
(field number, eg. "000" or "048"), {LANG} (user language, eg. "en" or
"fi-FI"). If left empty, the format documentation on http://loc.gov (MARC21) or
http://archive.ifla.org (UNIMARC) is used. For example
http://fielddoc.example.com/?marc={MARC}&field={FIELD}&language={LANG}

[2] The rewritten system preference text for MarcFieldDocURL:

Use ________ as the URL for MARC field documentation.

If left empty, the default URLs are:
- MARC21: field-level pages at https://www.loc.gov/marc/bibliographic/
- UNIMARC: https://www.ifla.org/g/unimarc-rg/unimarc-updates/

Placeholders available for use in the URL:
- {MARC}: MARC flavor, "MARC21" or "UNIMARC"
- {FIELD}: field number, for example, "000" or "048"
- {LANG}: language, for example, "en" or "fi-FI"

Examples:
- https://www.example.com/marcdocs?marc={MARC}&field={FIELD}&language={LANG}
- https://www.marc21.ca/MaJ/BIB/B{FIELD}.pdf

-- 
You are receiving this mail because:
You are watching all bug changes.
You are the assignee for the bug.
_______________________________________________
Koha-bugs mailing list
[email protected]
https://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-bugs
website : http://www.koha-community.org/
git : http://git.koha-community.org/
bugs : http://bugs.koha-community.org/

Reply via email to