Bug 155050 - Confusion between "bibliography entry" and "citation"
Summary: Confusion between "bibliography entry" and "citation"
Status: ASSIGNED
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: Writer (show other bugs)
Version:
(earliest affected)
unspecified
Hardware: All All
: medium minor
Assignee: t.aswath
URL:
Whiteboard:
Keywords: difficultyInteresting, easyHack, skillDesign, topicUI
Depends on:
Blocks: Bibliography UNO-Command-Label
  Show dependency treegraph
 
Reported: 2023-04-27 14:25 UTC by Tuomas Hietala
Modified: 2024-01-25 19:08 UTC (History)
4 users (show)

See Also:
Crash report or crash signature:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Tuomas Hietala 2023-04-27 14:25:13 UTC
Description:
In Writer, there is confusion between what is a bibliography entry and what is a citation. The "Insert Bibliography Entry" dialog is IMO misnamed.

What is being inserted into the text is commonly called "citation" in English: https://en.wikipedia.org/wiki/Citation

A citation refers to a bibliography entry, but is not the entry itself.

For example, this would be a citation:
According to Adams (1979), we shouldn't panic.

The citation above refers to the following bibliography entry:
Adams, Douglas (1979). The Hitchhiker's Guide to the Galaxy.


Steps to Reproduce:
1. Go to Insert -> Table of Contents and Index -> Bibliography Entry...


Actual Results:
The menu item and the dialog title mention "bibliography entry". There's also a label called "Entry" (string voQD7) in the dialog.

Expected Results:
The menu item should be "Citation...". The title of the dialog should be "Insert Citation". The label shoud be "Citation".


Reproducible: Always


User Profile Reset: No

Additional Info:
Not every string containing "bibliography entry" should be changed, because e.g. the dialog "Define Bibliography Entry" is named correctly.
Comment 1 V Stuart Foote 2023-05-03 17:22:25 UTC
No, while they are "Citation" in common use--functionally--they are always drawn from our ODF [1] bibliography structures. The controlling dialog is the 'Table of Contents, Index or Bibliography...' and in reality contains both within the UI.

We have bug 64960 bug 121945 and bug 121958 open to extend ODF by incorporating support for "citation Style Language" (CSL) based indexing schemes. 

Until then, current labeling in UI is consistent with our ODF heritage--and the way that citation/index gets written into ODF. No compelling reason to change.

IMHO -1

=-ref-=

[1] https://docs.oasis-open.org/office/OpenDocument/v1.3/os/part3-schema/OpenDocument-v1.3-os-part3-schema.html#__RefHeading__1415466_253892949
Comment 2 V Stuart Foote 2023-05-03 17:47:41 UTC
(In reply to V Stuart Foote from comment #1)
> ... and the way that citation/index gets written into ODF.

that of course should read "and the way the citation/*reference* gets written into  ODF."

For usage, see pg. 350, chpt. 15 of the 7.5 Writer guide [1]

=-ref-=

[1] https://nextcloud.documentfoundation.org/s/PdbKQCdWZ2y7L3g
Comment 3 Heiko Tietze 2023-05-04 08:52:24 UTC
Citation is to me foremost an alternative word for the Quotation paragraph style. Reference could be an option but why? Never struggled with Bibliography Entry.
Comment 4 Heiko Tietze 2023-05-25 08:32:57 UTC
We discussed the topic in the design meeting.

Zotero uses "Citation" and Bibliography as well as MSO Word. Therefore we should do as suggested.

The term is spread over some files. 

sw/uiconfig/swriter/ui/ createauthorentry.ui, bibliographyentry.ui, tocentriespage.ui

sw/inc/strings.hrc

officecfg/registry/data/org/openoffice/Office/UI/WriterCommands.xcu

and apparently tested/used in some importers

sw/qa/extras/ooxmlimport/ooxmlimport.cxx
sw/qa/extras/odfimport/odfimport.cxx

Not so simple easyhack.