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: Ujjawal Kumar
URL:
Whiteboard: target:25.8.0
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: 2025-03-15 15:35 UTC (History)
5 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.
Comment 5 Commit Notification 2025-03-03 13:11:11 UTC
bruh committed a patch related to this issue.
It has been pushed to "master":

https://git.libreoffice.org/core/commit/7668d76e7a7d10a94c6122d7ff7932ab4cb1710a

tdf#155050 Replaces the Bibliography entries with Citation

It will be available in 25.8.0.

The patch should be included in the daily builds available at
https://dev-builds.libreoffice.org/daily/ in the next 24-48 hours. More
information about daily builds can be found at:
https://wiki.documentfoundation.org/Testing_Daily_Builds

Affected users are encouraged to test the fix and report feedback.
Comment 6 Stanislav Horacek 2025-03-11 19:07:55 UTC
If "bibliography" is still used for the list of sources, then the change of "Insert Table of Contents, Index or Bibliography" to "Insert Table of Contents, Index or Citation" (done at the beginning of the commit above) is not correct - should it be reverted?
Comment 7 Tuomas Hietala 2025-03-11 20:22:22 UTC
(In reply to Stanislav Horacek from comment #6)
> If "bibliography" is still used for the list of sources, then the change of
> "Insert Table of Contents, Index or Bibliography" to "Insert Table of
> Contents, Index or Citation" (done at the beginning of the commit above) is
> not correct - should it be reverted?

It seems the term "bibliography" is still being used to refer to the list of sources, (as it should be IMO). I agree it looks like this string should be reverted.

Also "Table of Contents, Index or Citation..." (string 2FukD) should be reverted, if I'm not mistaken.
Comment 8 Stanislav Horacek 2025-03-12 18:27:00 UTC
Thanks for confirming this! I've submitted a patch with the revert: https://gerrit.libreoffice.org/c/core/+/182841
Comment 9 Commit Notification 2025-03-15 15:35:55 UTC
Stanislav Horacek committed a patch related to this issue.
It has been pushed to "master":

https://git.libreoffice.org/core/commit/d1e90f2e26fb56c0fc1b290c8910aad9d9d8bcdb

related tdf#155050: list of sources is still called "bibliography"

It will be available in 25.8.0.

The patch should be included in the daily builds available at
https://dev-builds.libreoffice.org/daily/ in the next 24-48 hours. More
information about daily builds can be found at:
https://wiki.documentfoundation.org/Testing_Daily_Builds

Affected users are encouraged to test the fix and report feedback.