Bug 141869 - Rephrase "Insert Reference To" items
Summary: Rephrase "Insert Reference To" items
Status: RESOLVED FIXED
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: Writer (show other bugs)
Version:
(earliest affected)
unspecified
Hardware: All All
: medium enhancement
Assignee: Not Assigned
URL: https://help.libreoffice.org/latest/e...
Whiteboard: target:7.3.0 target:7.6.0
Keywords: difficultyBeginner, easyHack, skillDesign, topicDesign
Depends on:
Blocks: Cross-reference-dialog
  Show dependency treegraph
 
Reported: 2021-04-24 09:03 UTC by Eyal Rozenberg
Modified: 2023-02-16 23:43 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 Eyal Rozenberg 2021-04-24 09:03:54 UTC
The "Insert Reference To" listbox in the cross-reference insertion dialog is difficult to name properly, and so are its list items.

I would like to suggest some renaming there.


"Insert reference to" -> "Refer using:"

"Page style"  -> "Page Number"
"Page"        -> "Page Number (target style)"
"Reference"   -> "Reference target text"
"Above/Below" -> ""Above"/"Below""  (i.e. add quotation marks)
"Number"      -> "Heading Number" for headings
                 "Paragraph Number" for numbered paragraphs
"Number (no context)" 
              -> "Heading Number (no context)" for headings
                 "Paragraph Number (no context)" for numbered paragraphs
"Number (full context)" 
              -> "Heading Number (full context)" for headings
                 "Paragraph Number (full context)" for numbered paragraphs

Granted, some of these might be too long.
Comment 1 Heiko Tietze 2021-05-03 12:36:47 UTC
(In reply to Eyal Rozenberg from comment #0)
> "Insert reference to" -> "Refer using:"
Not an advantage in my non-native ears.
 
> "Reference"   -> "Reference target text"
Why not "Reference source text" (of course without "source")

> "Above/Below" -> ""Above"/"Below""  (i.e. add quotation marks)
The reference is not using quotation, don't see need for it.

+1 for the other proposals. See help (-> URL) for more.
Comment 2 Eyal Rozenberg 2021-05-03 20:24:48 UTC
(In reply to Heiko Tietze from comment #1)
> (In reply to Eyal Rozenberg from comment #0)
> > "Insert reference to" -> "Refer using:"
> Not an advantage in my non-native ears.

"Insert reference to" is ambiguous. It can mean:

1. Choose what element of the document the reference you're inserting will target.
2. Choose what aspect of the target will be used as the text of the reference.

My suggestion can only mean (2.)


> > "Reference"   -> "Reference target text"
> Why not "Reference source text" (of course without "source")

Because references don't have a source, they only have a target. There is no source text to reference.

> > "Above/Below" -> ""Above"/"Below""  (i.e. add quotation marks)
> The reference is not using quotation, don't see need for it.

Again, it disambiguates. The current text may mean:

1. The reference will be above or below something unspecified.
2. The reference text will be either "above" or "below".

> See help (-> URL) for more.

I didn't quite understand this last bit of your comment.
Comment 3 Heiko Tietze 2021-05-04 07:04:44 UTC
(In reply to Eyal Rozenberg from comment #2)
> ...references... only have a target. 
Meaning no need for this word. Just "Reference Text".

> > > "Above/Below" -> ""Above"/"Below""  (i.e. add quotation marks)
> Again, it disambiguates.
Can follow this argument.

> > See help (-> URL) for more.
Meant for others who want to read the documentation.
Comment 4 Heiko Tietze 2021-05-07 07:21:06 UTC
The topic was on the design team's agenda but hasn't received further input.

The patch is welcome and easyhackable. Code pointer is sw/inc/strings.hrc FMT_REF_TEXT..FMT_REF_NUMBER_FULL_CONTEXT
Comment 5 Commit Notification 2021-06-16 04:53:48 UTC
Eyal Rozenberg committed a patch related to this issue.
It has been pushed to "master":

https://git.libreoffice.org/core/commit/81472692c4ee0b12c6d2184823faefa7a53431e6

Partially resolves tdf#141869: Rephrase of strings in the Cross-Reference dialog.

It will be available in 7.3.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 Commit Notification 2021-11-21 04:14:21 UTC
Ming Hua committed a patch related to this issue.
It has been pushed to "master":

https://git.libreoffice.org/help/commit/9bff7df37fa8a6303ef5fe4f10085ef635be3a95

Related to tdf#141869: Update help for inserting cross-reference
Comment 7 Jean-Baptiste Faure 2021-12-19 23:17:47 UTC
Hi,

In LibreOffice 7.3 and current master, "Insert reference to" is still present in extended tooltip used for types Text, Figure, Bookmarks and Footnotes.
If I am not wrong the code is at line 356 of /core/sw/uiconfig/swriter/ui/fldrefpage.ui

Can you confirm that that string should be modified the same way the line 311?

Best regards. JBF
Comment 8 Eyal Rozenberg 2021-12-22 22:21:50 UTC
(In reply to Jean-Baptiste Faure from comment #7)
> In LibreOffice 7.3 and current master, "Insert reference to" is still
> present in extended tooltip used for types Text, Figure, Bookmarks and
> Footnotes.

I'm  not quite sure what you mean. Where/when do you see this tooltip?
Comment 9 Jean-Baptiste Faure 2021-12-23 11:28:06 UTC
(In reply to Eyal Rozenberg from comment #8)
> (In reply to Jean-Baptiste Faure from comment #7)
> > In LibreOffice 7.3 and current master, "Insert reference to" is still
> > present in extended tooltip used for types Text, Figure, Bookmarks and
> > Footnotes.
> 
> I'm  not quite sure what you mean. Where/when do you see this tooltip?

Well, in the current master or 7.3 branch :

First you must activate extended tooltips in Tools > Options > LibreOffice > General. Then in an existing text document with numbered chapters and numbered formula or numbered figures :
1/ menu Insert > Field > More Fields...
2/ Choose Cross-Reference
3/ Select Text under Type : the list of numbered formula appears in Selection panel
4/ Mose the mouse pointer over one of the values in Selection list : the extended tooltip appears and it says "Insert reference to" instead of "Refer using" when you are pointing to a chapter header in the Selection list, Headings being selected in Type list.

I do not know why there is 2 extended tooltips in the same Type list.

Best regards. JBF
Comment 10 Eyal Rozenberg 2022-01-08 20:55:35 UTC
(In reply to Jean-Baptiste Faure from comment #9)
> 3/ Select Text under Type : the list of numbered formula appears in
> Selection panel

Do you mean select the "Figure" item under "Type"?

> 4/ Mose the mouse pointer over one of the values in Selection list : the
> extended tooltip appears and it says "Insert reference to" instead of "Refer
> using" when you are pointing to a chapter header in the Selection list,
> Headings being selected in Type list.

I don't get any tooltip when my mouse is on the selection list. Perhaps if you could clarify the previous step?
Comment 11 Jean-Baptiste Faure 2022-01-09 16:38:23 UTC
(In reply to Eyal Rozenberg from comment #10)
> [...]
> I don't get any tooltip when my mouse is on the selection list. Perhaps if
> you could clarify the previous step?

Did you activate **Extended** Tooltips in menu Tools > Options > LibreOffice > General?

Best regards. JBF
Comment 12 Eyal Rozenberg 2022-01-09 22:52:44 UTC
(In reply to Jean-Baptiste Faure from comment #11)

Ok, sorry for the hassle, I've replicated this. Now I just need to figure out where that string is and add another patch :-(
Comment 13 Commit Notification 2023-02-16 23:40:33 UTC
Seth Chaiklin committed a patch related to this issue.
It has been pushed to "master":

https://git.libreoffice.org/core/commit/14a065a812c8c2176b56b2baaf08ba25a2f9fa60

tdf#141869  update extended tip to reflect UI label change

It will be available in 7.6.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 14 sdc.blanco 2023-02-16 23:43:33 UTC
(In reply to Jean-Baptiste Faure from comment #7)
> If I am not wrong the code is at line 356 of
You were not wrong.  Your analysis was correct. 

The patch in comment 13 addresses this issue, and adds a tooltip to the "Refer using" window.  Closing as FIXED.