Bug 128858 - PARAGRAPH STYLE: Index headings should have outline-level 1 by default
Summary: PARAGRAPH STYLE: Index headings should have outline-level 1 by default
Status: NEW
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: Writer (show other bugs)
Version:
(earliest affected)
unspecified
Hardware: All All
: medium enhancement
Assignee: Not Assigned
URL:
Whiteboard:
Keywords:
: 128918 (view as bug list)
Depends on:
Blocks: Writer-Styles-Paragraph 114090
  Show dependency treegraph
 
Reported: 2019-11-17 14:39 UTC by Dieter
Modified: 2020-01-09 09:36 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 Dieter 2019-11-17 14:39:25 UTC
Actually index headings have outline level "Body Text" by default. This should be changed to level 1. This would have some advantages:

1. Index headings are displayed in outline of the sidebar => the structure of a (large)document bedomes more clear.
2. If you export to PDF with option "Tagged PDF" structure of PDF would also disply index headings (see bug 128837)
Comment 1 Heiko Tietze 2019-11-18 09:34:02 UTC
"Index Heading" as I understand is used only once or twice in a large document, at the table of contents and alphabetical index. Nothing to say against the outline level just mentioning the low impact.
Comment 2 Heiko Tietze 2019-11-21 07:57:42 UTC
No further comments, so let's do it.
Comment 3 Timur 2019-11-24 13:30:45 UTC
*** Bug 128918 has been marked as a duplicate of this bug. ***
Comment 4 sdc.blanco 2019-12-22 14:26:53 UTC
(In reply to Dieter Praas from comment #0)
> Actually index headings have outline level "Body Text" by default. This
> should be changed to level 1. This would have some advantages:

I was looking at how to solve this in the source code -- which raised the following questions.

1.  Perhaps "Index Heading" (as a Parent) should remain at "Text Body" (comparable to Heading).  Alternatively, maybe Index Heading should be changed to Level 1 (on the assumption that users would interpret this label as Level 1)?

2. Independent of the answer to the first question, presumably all the children to "Index Heading" (e.g, "Bibliography Heading", "Figure Index Heading") should also be level 1?

Given that they are all 16pt. bold, as a user, I would assume that they appear at the same level, and could either choose "Index Heading" and/or one more of the children -- expecting them to show up at the same level in a Table of Contents.

3.  And just to anticipate or avoid a problem.  Is it possible (yes), likely (don't know) that "heading" styles would be used in the text after Index Heading.  In that case, "Heading 1" would be at the same level as "Index Heading" which would probably not be intended (from a user perspective). 

A user, with proper knowledge, could easily fix this -- but the original problem that lead to this opening this ticket arose because of this "lack of knowledge".

I do not see any obvious way around this situation.
Comment 5 Heiko Tietze 2019-12-23 08:07:54 UTC
(In reply to sdc.blanco from comment #4)
> 2. Independent of the answer to the first question, presumably all the
> children to "Index Heading" (e.g, "Bibliography Heading", "Figure Index
> Heading") should also be level 1?

That was my first idea. The only show stopper I see is when users number the indices, which leads to something like 

1. Table of Content
...
1. Heading1
1.1 Heading1a
1.2 Heading1a
2. Heading2
...
2. Index Heading
3. Figure Heading

ToC uses Contents Heading for the ToC title by default. It looks much better with roman numbering.

> 3.  And just to anticipate or avoid a problem.  Is it possible (yes), likely
> (don't know) that "heading" styles would be used in the text after Index
> Heading.  In that case, "Heading 1" would be at the same level as "Index
> Heading" which would probably not be intended (from a user perspective). 
> ...
> I do not see any obvious way around this situation.

Without numbers on the index headings it's not a problem. Hackish workaround could be to use levels 6-10 for indices. But I believe it's not necessary.
Comment 6 sdc.blanco 2019-12-23 09:13:12 UTC
(In reply to Heiko Tietze from comment #5)
> 
> Without numbers on the index headings it's not a problem. Hackish workaround
> could be to use levels 6-10 for indices. But I believe it's not necessary.

What would happen with these styles in ToC (and no numbers)? 
(use example in brackets)

Bibliography Heading (Level 1)   [Literature]
Heading1 (Level 1)               [Books]
Heading1 (Level 1)               [Articles]
Heading1 (Level 1)               [Reports}

I would assume that ToC would appear at the same level like this: 

Literature
Books
Art...(etc.)

while the user expectation would be:

Literature
  Books
  Articles
  Reports

(Same kind of issue is likely to appear if Appendix becomes a style)

(I am not looking for trouble or extra work here.  As noted before, it would be easy enough modify according to what one wants.  So it is more a question of a self-conscious choice of the "factory default".)
Comment 7 Dieter 2019-12-27 12:53:16 UTC
I don't want to go in detail wth all the aspects mentioned before. My initial idea was to make indexes visible in navigator (and in TOC) by default. This would be an advantage for unexperienced users I think. I won't expect, that users add a numbering to indexes. AFAIK this is very unusual. So it's clear, that different users have different preferences and work different. We can't cover every situation with a solution, but it is necessary to make a decision.
Comment 8 Heiko Tietze 2020-01-07 08:53:21 UTC
(In reply to Dieter Praas from comment #7)
> My initial idea was to make indexes visible in navigator (and in TOC) by

Right, so just Level 1 for "Heading" to apply on all children. That includes Title and Subtitle, which could override back to Text Body.
Comment 9 sdc.blanco 2020-01-07 14:04:47 UTC
(In reply to Dieter Praas from comment #7)
> We can't cover every situation with a solution, but it is
> necessary to make a decision.

Agreed.  For my part, I raise questions only to support an "informed decision", not to promote a particular solution.

(In reply to Heiko Tietze from comment #8)
> > My initial idea was to make indexes visible in navigator (and in TOC) by
> 
> Right, so just Level 1 for "Heading" to apply on all children. That includes
> Title and Subtitle, which could override back to Text Body.

Will "override" be a user responsibility?  This solution will place Title and Subtitle into TOC, which is probably not expected. Is the idea to require inexperienced users to do the override?
Comment 10 Heiko Tietze 2020-01-08 15:51:07 UTC
(In reply to sdc.blanco from comment #9)
> Will "override" be a user responsibility?

No, Text Body needs to be set explicitly with the patch for these two while all other headings will take the parent value.