documentation icon indicating copy to clipboard operation
documentation copied to clipboard

permit items to be have no visible form in bibliography

Open bwiernik opened this issue 5 years ago • 11 comments

Currently, it's assumed that all cited items will have a visible form in both citation and bibliography contexts (if the style has a bibliography). Some styles call for some items to only appear in citations, but not the bibliography (e.g., Vancouver and APA want personal communications to appear with a specific formatting in text but be omitted from the bibliography). This could be handled by adding a choose element to show/hide some items conditionally (cf. here).

citeprocj-js incidentally handles this gracefully, but the spec should make this an explicit expectation to ensure consistent behavior

bwiernik avatar May 05 '20 18:05 bwiernik

Citeproc-js actually has an option to exclude certain item types from the bibliography. If we adopt that solution, we will be able to handle these requirements without choose elements.

Anyway, I think this is a good suggestion, and also in line with the plans to implement multiple (filtered) bibliographies.

denismaier avatar May 27 '20 20:05 denismaier

For APA rules at least, it’s more nuanced than certain item types. So choose will still be the easiest approach

bwiernik avatar May 27 '20 22:05 bwiernik

I think this is part of the multi-section bib issue. Basically, you need a section filtered on type that does not print.

bdarcus avatar May 27 '20 22:05 bdarcus

For APA rules at least, it’s more nuanced than certain item types. So choose will still be the easiest approach

Can you explain a bit?

bdarcus avatar May 27 '20 22:05 bdarcus

A personal communication or interview that is retrievable (has a publisher, URL, or DOI) is included in the bibliography. A personal communication or interview that is not retrievable is only shown in text.

bwiernik avatar May 28 '20 01:05 bwiernik

I think wrapping that case up in the multi-section bibliographies is way overkill and puts burden on the user that should be automated.

Rules similar to APA are common. For example, many physical science journals require that unpublished data only appear in text, not in the bibliography. These styles currently include all items because the spec doesn’t allow for an item to have no printed form in the bibliography.

bwiernik avatar May 28 '20 01:05 bwiernik

The user should not be required to know these simple automatable rules and manually implement them, especially when they can be implemented with just a minor change in instructions to processors.

The multi section bib framework is for manually-constructed sections that require user input, like primary and secondary sources.

bwiernik avatar May 28 '20 01:05 bwiernik

Got it.

I have the hunch these may be at least complementary, and we should design it to be so.

So what's the specific proposal; that all element content of choose should be optional?

bdarcus avatar May 28 '20 01:05 bdarcus

Multi-bib has different use cases, some of them automated.

bdarcus avatar May 28 '20 01:05 bdarcus

No, just that “items must have a printed form in citations, but may or may not have a printed form in bibliographies”.

bwiernik avatar May 28 '20 02:05 bwiernik

That's language for the spec?

I had checked, and the schema already does allow an empty if element, which seems like it could be used to catch items to not print. So I'm unclear on what's stopping this from working now.

In any case, seems straightforward.

PR time?

bdarcus avatar May 28 '20 10:05 bdarcus