Juris-M / zotero

Juris-M is a variant of the free and friendly Zotero research platform, with support for legal and multilingual materials.
https://juris-m.github.io
Other
77 stars 12 forks source link

Add `version` to legal_commentary in the UI #100

Closed georgd closed 3 years ago

georgd commented 3 years ago

Austrian styles require version numbers of online commentaries to be included in the citation, formatted like the edition number. However, putting the version in the edition field is in conflict with the following requirement: The leg cit style demands the publication date not to be printed if a version number exists, whereas an edition number doesn‘t influence on printing the date (Compare tests at https://github.com/georgd/jm-style-tests/blob/jm-legcit/jm-leg-cit-rechtsquellenverzeichnis-literaturverzeichnis/chapCommentaryOnline_test050.txt with version with https://github.com/georgd/jm-style-tests/blob/jm-legcit/jm-leg-cit-rechtsquellenverzeichnis-literaturverzeichnis/chapCommentaryOnline_test049.txt with an edition number.)

Therefore, could you please add the version field to the legal_commentary type in the Juris-M UI?

fbennett commented 3 years ago

Can do. Just to check before we commit that, there is the option to put the version in the extended locator. It is preferred to put the value in a fixed field? (Pretty sure that the answer is yes, but to be very sure.)

On Wednesday, November 4, 2020, Georg Mayr-Duffner notifications@github.com wrote:

Austrian styles require version numbers of online commentaries to be included in the citation, formatted like the edition number. However, putting the version in the edition field is in conflict with the following requirement: The leg cit style demands the publication date not to be printed if a version number exists, whereas an edition number doesn‘t influence on printing the date (Compare tests at https://github.com/georgd/jm-style-tests/blob/jm-legcit/jm-leg-cit- rechtsquellenverzeichnis-literaturverzeichnis/ chapCommentaryOnline_test050.txt with version with https://github.com/georgd/jm-style-tests/blob/jm-legcit/jm-leg-cit- rechtsquellenverzeichnis-literaturverzeichnis/ chapCommentaryOnline_test049.txt with an edition number.)

Therefore, could you please add the version field to the legal_commentary type in the Juris-M UI?

— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/Juris-M/zotero/issues/100, or unsubscribe https://github.com/notifications/unsubscribe-auth/AAASMSTEBDF2WJCQUHCXRSDSOEUZJANCNFSM4TJ4BC4Q .

georgd commented 3 years ago

Oh, the extended locator... I always tend to forget about that. But I don’t think, this option is too user friendly here: we have four types of data that play a similar role: edition, version number, update date, and loose-leaf issue. Putting one of them in the locator and all the others in fields doesn’t seem transparent to me. So, I think it’s best to put the version no. in a fixed field. This information can easily be pulled from the online source (if a translator existed for the database...).

georgd commented 3 years ago

I tried it and I think, it really should be a fixed field.

Also, do you see a possibility in adding a field for container-title-short to Chapter and Legal Commentary? This field is commonly needed in German language styles (not only Austrian ones) where, among others, festschrifts are usually cited with a short book-title instead of the actual book title (cf. https://github.com/georgd/jm-style-tests/blob/master/jm-leg-cit-rechtsquellenverzeichnis-literaturverzeichnis/chapFS_test011.txt).

fbennett commented 3 years ago

Dear Georg,

Understood about adding a version field.

On festschrift short titles, would it be an alternative to add "honoree" as a creator?

Frank

On Mon, Nov 16, 2020, 22:19 Georg Mayr-Duffner notifications@github.com wrote:

I tried it and I think, it really should be a fixed field.

Also, do you see a possibility in adding a field for container-title-short to Chapter and Legal Commentary? This field is commonly needed in German language styles (not only Austrian ones) where, among others, festschrifts are usually cited with a short book-title instead of the actual book title (cf. https://github.com/georgd/jm-style-tests/blob/master/jm-leg-cit-rechtsquellenverzeichnis-literaturverzeichnis/chapFS_test011.txt ).

— You are receiving this because you commented. Reply to this email directly, view it on GitHub https://github.com/Juris-M/zotero/issues/100#issuecomment-727998377, or unsubscribe https://github.com/notifications/unsubscribe-auth/AAASMSWVWR5746GQOTMUAXLSQERF5ANCNFSM4TJ4BC4Q .

georgd commented 3 years ago

Dear Frank, "honoree" as a creator is an option (which I find elegant, indeed) but only together with an additional field because there are two kinds of publication, "Festschrift" and "Gedenkschrift" (memorial publication), that are cited this way (for the latter, see https://github.com/georgd/jm-style-tests/blob/master/jm-leg-cit-rechtsquellenverzeichnis-literaturverzeichnis/chapGedS_test010.txt). The former is cited as FS Kelsen, the latter as GedS Martens. The type could be put in the genre field, which again would be needed in the UI.

georgd commented 3 years ago

Looking at style guides from Germany, I think, earlier or later a field for container-title-short will be necessary in Chapter, as they generally seem to use the short book-title in citations (and the full book-title in the bibliography).

Anyway, please add a field Short Book Title to Legal Commentaries.

fbennett commented 3 years ago

Understood. I'll take a closer look and get back if I have questions. Re "honoree," it looks like a candidate is already in there, as "recipient." Will that serve?

georgd commented 3 years ago

Yes, I think, the recipient can be used here, I don’t see any conflict (i.e. I don‘t see a use case for a recipient in chapters).

fbennett commented 3 years ago

Great -- I think I may have had festschrift in mind when I added that. I'll look into the other issues. (If you think it might be confusing to users, the label for "Recipient" could later be changed to "Honoree" or other.)

fbennett commented 3 years ago

Just realized I neglected to add a versionNumber field to legalCommentary. I also didn't merge your latest module and style PRs in today's release. I'll include both that in the next update.

georgd commented 3 years ago

Great, thank you! Do you have a plan when you will do the next update?

Also, may I ask you, what’s the least uncomfortable way for you when I want to contribute UI translations?

fbennett commented 3 years ago

Next update will probably go out later today. I've checked in the change, but a bunch of tests will need to be adjusted to lock it in.

I'm not immediately sure what the best channel is for locale changes generally. Locales are updated by (1) layering Zotero changes onto existing Jurism source, then (2) generating and then applying a patch that changes "Zotero" to "Jurism" as appropriate across all locales. I'm not sure offhand what the priority is at step (1) in the event of conflict --- whether Jurism source is left untouched, or overridden by Zotero strings. For any Jurism-only strings, though (which will be set in English across all locales, as a placeholder), changes to the Jurism source will not be overridden. For those strings, a PR to chrome/locale/xx-XX/zotero under https://github.com/juris-m/zotero will definitely do the trick.

georgd commented 3 years ago

Thanks! So, I’ll stick with modifying those files.

fbennett commented 3 years ago

Running tests now, release forthcoming.