Bug 155050

Summary:	Confusion between "bibliography entry" and "citation"
Product:	LibreOffice	Reporter:	Tuomas Hietala <tuomas.hietala>
Component:	Writer	Assignee:	t.aswath <aswathscid>
Status:	ASSIGNED ---
Severity:	minor	CC:	heiko.tietze, mentoring, vsfoote, xiscofauli
Priority:	medium	Keywords:	difficultyInteresting, easyHack, skillDesign, topicUI
Version:	unspecified
Hardware:	All
OS:	All
Whiteboard:
Crash report or crash signature:		Regression By:
Bug Depends on:
Bug Blocks:	101258, 115596

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.