Bug 122787 - Editing: Missing Entry „Table of Figures“ in Table of Contents (TOC) - document per Comment 28
Summary: Editing: Missing Entry „Table of Figures“ in Table of Contents (TOC) - docume...
Status: VERIFIED FIXED
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: Documentation (show other bugs)
Version:
(earliest affected)
Inherited From OOo
Hardware: All All
: high normal
Assignee: Not Assigned
URL: https://help.libreoffice.org/6.3/en-U...
Whiteboard: target:6.3.0
Keywords:
Depends on:
Blocks: TableofContents-Indexes
  Show dependency treegraph
 
Reported: 2019-01-17 15:23 UTC by noreply+666192134234234
Modified: 2019-07-19 14:57 UTC (History)
4 users (show)

See Also:
Crash report or crash signature:


Attachments
Example .odt file showing the behaviour (25.42 KB, application/vnd.oasis.opendocument.text)
2019-01-17 15:25 UTC, noreply+666192134234234
Details
Exampe file showing the behaviour relating to bibliographies (10.90 KB, application/vnd.oasis.opendocument.text)
2019-01-17 17:01 UTC, noreply+666192134234234
Details
Expected result? (26.41 KB, application/vnd.oasis.opendocument.text)
2019-01-18 20:01 UTC, Dieter
Details

Note You need to log in before you can comment on or make changes to this bug.
Description noreply+666192134234234 2019-01-17 15:23:15 UTC
Description:
Automatically generated TOC's do not show lines with references to Tables of Figures

Steps to Reproduce:
1. Define a heading of level 1 in an .odt document.
2. Insert an image in the odt file. Provide the image with a caption and a name (in the image properties).
3. Create a Table of Figures at the end of the document.
4. Create a Table of Contents at the beginning of the document.

Actual Results:
Heading 1 is shown in the TOC, but not the line "Table of Figures" and its corresponding page number.

Expected Results:
Heading 1 and the line "Table of Figures" and its corresponding page number should be shown in the TOC.


Reproducible: Always


User Profile Reset: Yes



Additional Info:
Comment 1 noreply+666192134234234 2019-01-17 15:25:54 UTC
Created attachment 148402 [details]
Example .odt file showing the behaviour
Comment 2 noreply+666192134234234 2019-01-17 15:47:15 UTC
PS: I am using Linux Debian 9.6 ("Stretch"), the current stable Debian release.
Comment 3 noreply+666192134234234 2019-01-17 17:00:29 UTC
The behaviour occurs with bibliographies, too. 

Steps to reproduce:

1. Create a heading of level 1.

2. Create a bibliography entry. Create it via the Insert menu > Table of Contents > Bibliography Entry > „From document content“ > „New“ > … > „Insert“.

3. Create a bibliography on the last page of the document.

4. Create a TOC on the second page of the document.

The 2nd attached .odt file shows the behaviour relating to bibliographies.
Comment 4 noreply+666192134234234 2019-01-17 17:01:57 UTC
Created attachment 148405 [details]
Exampe file showing the behaviour relating to bibliographies
Comment 5 Timur 2019-01-17 17:03:47 UTC
This request needs to be evaluated. 
It's not just "Table of Figures" missing in default ToC but also other indexes and styles. We should consider them all:
Alphabetical Index, Illustration Index, Index of Tables, User-Defined, Table of Objects, Bibliography

Help explains that default are Outline and Index marks. One can use Additional Styles and Assign Styles.. to add Figure Index Heading or Bibliography Heading (for example on level 1).
Comment 6 Heiko Tietze 2019-01-18 07:56:06 UTC
(In reply to Timur from comment #5)
> This request needs to be evaluated.

First of all it's a bug since ToF is offered under "Type" with the headline being generated but not filled. We stumbled over this issue while talking about bug 122477.
Comment 7 Timur 2019-01-18 08:32:29 UTC
Heiko, please explain what is the solution here, to include ToF and B in "Index marks"?
Comment 8 Heiko Tietze 2019-01-18 08:39:53 UTC
The solution is to fix existing functions. In the ToC dialog it is possible to select ToF but no figure names are inserted after the heading. It's just a bug.
Comment 9 Timur 2019-01-18 11:30:14 UTC
(In reply to Heiko Tietze from comment #8)
> In the ToC dialog it is possible to select ToF 
I understand this was a request. So you say that is "WorksForMe"?
To keep Additional Styles and Assign Styles.. to add Figure Index Heading or Bibliography Heading.
> but no figure names are inserted after the heading. It's just a bug.
That wasn't requested but is also possible: Additional Styles and Assign Styles.. and add Figure or Figure Index 1. 

Either I'm not clear about this either we really need to clarify and update the title.
Comment 10 noreply+666192134234234 2019-01-18 12:01:06 UTC
(In reply to Heiko Tietze from comment #8)
> In the ToC dialog it is possible to select ToF but no figure names are inserted
> after the heading. 

Do you refer to entries within in a Table of Figures? If yes, and you want the names of the figures/illustrations to be shown within a Table of Figures, then you  need to

1. right-click an image in the .odt document, in the context menu open the "Properties" dialog, enter a name for the figure/illustration in the "Name" field on the "Options" tab,

2. right-click the image again, then go to "Insert caption" in the context menu, enter a caption in the "Insert Caption" window

This only works for newly inserted images into the document.

Note I: If you first apply step 2, and then step 1, the name of the figure/illustration will not be shown in the Table of Figures.

Note II: The "Insert caption" entry in the context menu which appears if you right-click an inserted image does only appear in the context menu if the image properties have never been edited before.
Comment 11 noreply+666192134234234 2019-01-18 12:10:52 UTC
(In reply to Timur from comment #5)
> ... It's not just "Table of Figures" missing in default ToC but also other
> indexes and styles. We should consider them all:
> Alphabetical Index, Illustration Index, Index of Tables, User-Defined, Table
> of Objects, Bibliography
> 
> Help explains that default are Outline and Index marks. One can use
> Additional Styles and Assign Styles.. to add Figure Index Heading or
> Bibliography Heading (for example on level 1).

So you say that one can f. e. add the line "Table of Figures" to a TOC by using Additional Styles according to the Help documentation? 

Can you tell me the exact URL where I can find this information about Additional Styles to insert the names of Alphabetical Indexes, Illustration Indexes, Index of Tables, User-Defined indexes, Table of Objects, Bibliographies in TOC's?

According to me the names of all these indexes should automatically appear within TOC's without the need to manually apply Additional Styles and so on. It would be illogical if these indexes would not automatically appear in TOC's.
Comment 12 Timur 2019-01-18 16:02:35 UTC
Jens, I included URL for help. 
If help is not sufficient, that's Documentation bug than. 
If ToF and others can be included in ToC, that's not "normal" bug as confirmed.
Maybe enhancement to have them included by default. 
I'm not sure I'd support it personally. Because you may put them in different levels. And using Additional Styles gives you hint on that. 
When you reported bug, we don't know whether you're familiar with Additional Styles and whether you tried it and what's your experience. Please explain. 
Until we clarify all, this bug should be Needinfo.
Comment 13 noreply+666192134234234 2019-01-18 17:55:43 UTC
(In reply to Timur from comment #12)
> Jens, I included URL for help.

Thanks, Timur.
 
> If help is not sufficient, that's Documentation bug than. 

I tried around for a while (about 10 minutes or so) with these Additional style configurations in my TOC, but I don't get it working: My TOC does not show a line like "Figure Index .... <page number>". If one really gets this functionality working, then it is too complicated, I am sorry to tell.

> If ToF and others can be included in ToC, that's not "normal" bug as
> confirmed.
> Maybe enhancement to have them included by default. 

New users to LibreOffice Writer, who normally are not experienced, probably would think "LibreOffice does not work, let me use another text processing programme instead".

Regards,

Jens
Comment 14 Dieter 2019-01-18 20:01:01 UTC
Created attachment 148430 [details]
Expected result?

Jens, is this the desired result?
Comment 15 noreply+666192134234234 2019-01-18 20:10:46 UTC
(In reply to Dieter Praas from comment #14)
> Created attachment 148430 [details]
> Expected result?
> 
> Jens, is this the desired result?

Yes, fabulous. How did you do that?

Regards,

Jens
Comment 16 Dieter 2019-01-18 20:27:15 UTC
(In reply to Jens Radloff from comment #15)
> Yes, fabulous. How did you do that?

1. Cursor in TOC => Edit index
2. nable Create from additional styles
3. Assign styles
4. Assign the style of the Table of Figure Heading to the first level of TOC
Comment 17 noreply+666192134234234 2019-01-18 20:43:15 UTC
(In reply to Dieter Praas from comment #16)
> (In reply to Jens Radloff from comment #15)
> > Yes, fabulous. How did you do that?
> 
> 1. Cursor in TOC => Edit index
> 2. nable Create from additional styles

Done. Which I did in my test before, by the way.

> 3. Assign styles

Done. I tried "Figure Index 1" and "Figure Index Heading".

> 4. Assign the style of the Table of Figure Heading to the first level of TOC

There is no style called "Figure Index 1" or "Figure Index Heading" in the Styles list (by right-clicking the TOC, then "Styles").

It does not work. Note that I am using Linux Debian 9.6 ("Stretch").
Comment 18 Dieter 2019-01-18 20:58:58 UTC
(In reply to Jens Radloff from comment #17)

> There is no style called "Figure Index 1" or "Figure Index Heading" in the
> Styles list (by right-clicking the TOC, then "Styles").
> 
> It does not work. Note that I am using Linux Debian 9.6 ("Stretch").

Put cursor in Figure Index Heading
In german UI: "Abbildungsindex als Überschriften"
in English UI: "Figure Index Heading"

I can find both styles in edit index.
Comment 19 noreply+666192134234234 2019-01-19 12:41:51 UTC
(In reply to Dieter Praas from comment #18)

> Put cursor in Figure Index Heading
> In german UI: "Abbildungsindex als Überschriften"
> in English UI: "Figure Index Heading"

I did that already yesterday. It still does not work. 

Note that if I activate the "Additional styles" option on the "Type" tab and then select an style in the "Assign styles" window, and then click OK, and then update the TOC index, and then open the settings of the TOC index again, the "Additional styles" option on the "Type" tab is unchecked.
Comment 20 Dieter 2019-01-19 17:51:25 UTC Comment hidden (obsolete)
Comment 21 noreply+666192134234234 2019-01-21 08:02:20 UTC Comment hidden (obsolete)
Comment 22 Timur 2019-01-21 10:57:26 UTC
(In reply to Jens Radloff from comment #19)
> Note that if I activate the "Additional styles" option on the "Type" tab and
> then select an style in the "Assign styles" window, and then click OK, and
> then update the TOC index, and then open the settings of the TOC index
> again, the "Additional styles" option on the "Type" tab is unchecked.
It would be strange that it doesn't work for you (which would be a bug).
Or you maybe don't *assign style* to heading level like 1 or 2 before you click OK as by *select* you really did nothing.

Jens, please have in mind that Bugzilla is not support for basic usage, that you can find on http://ask.libreoffice.org/. When all is clear, than here comes bug report.

I set back to Needinfo to know exactly what could be issue/bug and solution here, until we have answers to Comment 9.
Comment 23 noreply+666192134234234 2019-01-21 12:47:00 UTC
(In reply to Timur from comment #22)
> It would be strange that it doesn't work for you (which would be a bug).
> Or you maybe don't *assign style* to heading level like 1 or 2 before you
> click OK as by *select* you really did nothing.

I checked the Help system again: I forgot to assign the appropriate style in Tools > Chapter Numbering to the appropriate level. Now the line "Table of Figures" is shown in the TOC.

Thanks, Timur.

By the way, the "Additional" style checkbox in the TOC configuration window still gets unchecked, if I re-open the TOC configuration window. Please do not get irritated, but at the moment I will not report this behaviour as a bug, because it appears illogical to me that it is necessary to assign an addditional style to a TOC, just to get something displayed in the TOC which should be displayed there by default (f.e. a Table of Figures) 

> Jens, please have in mind that Bugzilla is not support for basic 
> usage, that
> you can find on http://ask.libreoffice.org/. When all is clear, 
> than here comes bug report.

I know that ;-)

But all this styles stuff is too complicated wih regards to defining entries in TOC's, at least for average users. With regards to usability, this kind of configuration should be as easy as possible. And once again: It appears illogical to me that it is necessary to assign an addditional style to a TOC, just to get something displayed in the TOC which should be displayed there by default (f.e. a Table of Figures) 

> I set back to Needinfo to know exactly what could be issue/bug and solution
> here, until we have answers to Comment 9.

I set it back to "New", if you don't mind.

Regards,

Jens
Comment 24 noreply+666192134234234 2019-01-21 13:06:35 UTC Comment hidden (obsolete)
Comment 25 Dieter 2019-01-21 14:06:55 UTC
(In reply to Jens Radloff from comment #23)
> I checked the Help system again: I forgot to assign the appropriate style in
> Tools > Chapter Numbering to the appropriate level. Now the line "Table of
> Figures" is shown in the TOC.

=> RESOLVED NOTABUG
Comment 26 Dieter 2019-01-21 14:08:32 UTC
(In reply to Jens Radloff from comment #24)
> Update: I am not able to define the line "Table of Figure" at the correct
> level in the TOC in the odt. document which I am currently productively
> working at (not the example file attached to this report bug). If I define
> the line "Table of Figures" for level 1 in the TOC, then all other level 1
> headings in the odt.file dissapear from the TOC.

=> As Timur already suggested, please use http://ask.libreoffice.org/ for help.
Comment 27 noreply+666192134234234 2019-01-21 15:37:56 UTC Comment hidden (no-value)
Comment 28 Timur 2019-01-21 15:49:04 UTC
Let's use this bug to improve documentation a little bit. 

Now we have:
"Additional Styles
Includes the paragraph styles that you specify in the Assign Styles dialog as index entries. To select the paragraph styles that you want to include in the index, click the Assign Styles (...) button to the right of this box. "

Why not have it more clear:
"Additional Styles
Includes the paragraph styles that you specify in the Assign Styles dialog as index entries (Bibliography, Figure Index Heading, etc.). 
To select the paragraph styles that you want to include in the index, click the Assign Styles (...) button to the right of this box. "


Now we have:
"Assign styles
Opens the Assign Styles dialog, where you can select the paragraph styles to include in the index."

Since that's not literally correct, we'd better have:
"Assign styles
Opens the Assign Styles dialog, where you can select the paragraph styles.
Assigning is done by choosing level 1-10 on which style will be included in the index."


Now we have:
"Index marks
Includes the index entries that you inserted by choosing Insert - Table of Contents and Index - Index Entry in the index."

But TOC entry with page number itself is not in ToC, as I'd understand from here. Should be clarified.
Comment 29 noreply+666192134234234 2019-01-21 15:56:21 UTC Comment hidden (no-value)
Comment 30 Commit Notification 2019-02-19 16:21:19 UTC
Olivier Hallot committed a patch related to this issue.
It has been pushed to "master":

https://git.libreoffice.org/help/+/665bdc726335d0a9c8a3342c614a299b8680928e%5E%21

tdf#122787 Tip text on index of indexes
Comment 31 Dieter 2019-07-19 14:57:25 UTC
Verified with

Version: 6.4.0.0.alpha0+ (x64)
Build ID: 2f2f4767089512c34514896bc37823f9310e9dd4
CPU threads: 4; OS: Windows 10.0; UI render: GL; VCL: win; 
TinderBox: Win-x86_64@42, Branch:master, Time: 2019-07-10_02:13:57
Locale: de-DE (de_DE); UI-Language: en-US
Calc: threaded

https://help.libreoffice.org/6.4/en-US/text/swriter/01/04120211.html?&DbPAR=WRITER&System=WIN

Thanks for fixing it, Olivier.