OASIS Open Document Format for Office Applications (OpenDocument) TC

 View Only
  • 1.  Proposal for style:list-style-name

    Posted 06-13-2017 20:56
    Hi all, I have started with a proposal in file ProposalDraft.odt. I have added my suggestions in Blue on the first page. The yellow frames contain some questions and remarks. The second and further pages contain problems in regard to numbering, which I think have to be solved. I have attached two test documents and have made screen shots from some application I have got on my PC. Although I consider some renderings in WebODF and ONLYOFFICE as bugs or missing feature, the differences between Word 2010, TextMaker and LibreOffice are immense. Perhaps someone has got additional applications on Linux or Mac and can make screen shots from them? I hope you give me some ideas and proposals, so that I can finally make a proposal that will be widely accepted. Kind regards Regina Attachment: EmptyStyleNoHeading.odt Description: application/vnd.oasis.opendocument.text Attachment: ListWithEmptyListStyleName.odt Description: application/vnd.oasis.opendocument.text Attachment: ProposalDraft.odt Description: application/vnd.oasis.opendocument.text


  • 2.  Re: [office] Proposal for style:list-style-name

    Posted 06-14-2017 16:10
    On 13.06.2017 22:56, Regina Henschel wrote: > Hi all, > > I have started with a proposal in file ProposalDraft.odt. I have added > my suggestions in Blue on the first page. The yellow frames contain some > questions and remarks. you want to add: > The list style specified by this attribute is applied to headings that are not contained in a list. i now realized the way we approached this, by focusing on how the number should be formatted, via outline style or numbering style, is asking the wrong question, or at least ignoring one very important aspect. namely: how do you determine the number of a heading in the first place, i.e. its "index" in the "sequence"? to determine the number of a list item you have to know which list it's in, hence using the numbering style without a list-item / list element doesn't make sense. the effect you want to have is that you want a heading to be numbered not as a heading but as an item of a separate list, so you need to "connect" the heading elements by actually putting them into a list element. if they're not in a list, how do you know if all of them should be numbered consecutively, or if there are several different numberings, with restarts in the middle? all of that is encoded as attributes on text:list / text:list-item elements such as xml:id, text:continue-numbering... for example, you may want to have un-numbered top-level headings "Prologue" and "Epilogue" in addition to numbered chapters and differently numbered appendixes. > Producers should keep the value of the text:outline-level attribute in sync with the list level, because in several elements (e.g. 7.3.8 <text:chapter>, 8.3.2 <text:table-of-content-source>) not the list level but the outline level is evaluated. i am not sure if we should say "should" here. i hope ODF specifies unambiguously which level is used in any given element? if i understand right, we are not concerned about Consumers "getting it wrong", but about usability issues; maybe a non-normative note is sufficient? > The text:outline-level attribute is mandatory for a <text:h> element, see schema line 840 and line 852. That is not explicitly mentioned in 19.844.4 <text:h>. There is the sentence “Headings without a level attribute are assumed to be at level 1.” instead. But there cannot be any heading without a level attribute. Or do I misunderstand the schema? yes, that sentence seems superfluous since the attribute is mandatory. although, maybe it wasn't mandatory in an older version? no, in 1.0 it's mandatory too. > Section 19.498.2 contains the sentence > “outline style - The outline style as a list style can be referenced by the style:list-style-name attribute.” > Should this text be copied here? For example, > “The style:list-style-name attribute may reference the <text:outline-style> element.” yes, why not. > The second and further pages contain problems in regard to numbering, > which I think have to be solved. I have attached two test documents and > have made screen shots from some application I have got on my PC. > Although I consider some renderings in WebODF and ONLYOFFICE as bugs or > missing feature, the differences between Word 2010, TextMaker and > LibreOffice are immense. Perhaps someone has got additional applications > on Linux or Mac and can make screen shots from them? i think the biggest problem with these test documents is that they contain a single text:list element and no text:style-name attribute and multiple items each containing a paragraph with a style that wants a different list style. i expect there should be only one list style per list, so which one to choose? > Problem A > Take a simple paragraph inside a list. Consider the case, that no style is specified on the list elements themselves and the paragraph style has a style:list-style-name attribute with empty value. Applying section “5.3.2 Default List Style” I get the conclusion: > First bullet item there does not apply, because no list in the parent lists has specified a list style, otherwise the style:list-style-name would not be used, see second sentence in 19.496. > Second bullet item does not apply, because the style:list-style-name attribute exists but has an empty value. Therefore no list-style is specified, that can be used. > So third bullet item is used, which means, that an implementation-dependent default is used. > But is that the intention for allowing an empty value for the style:list-style-name attribute? i agree with your analysis and think the handling of this situation is fine. > Problem B > Take a heading inside a list. Consider the case, that no style is specified on the list elements themselves and the headings paragraph style has a style:list-style-name attribute with empty value. Section 16.34<text:outline-style> has the sentence, > “An outline style is a list style that is applied to all headings within a text document where the heading's paragraph style does not define a list style to use itself.” > Does the wording “does not define a list style to use itself” includes the case that the style:list-style-name attribute exists, but has an empty value? If not, then problem A applies. Here too, it is not clear, what the intention was, to allow an empty value for the style:list-style-name attribute. oh, that's a difficult one! given the answer to A, and the reasonable assumption that an implementation-defined default does not qualify as "defining a list style to use itself", i get the idea that the outline style is used in this case. on the other hand, the heading is in a list, which gets its own sequence of numbers, hence the numbering of the heading is taken from the list. i think i'd prefer if we are consistent about taking both the number and the format (and the level) from the same source, i.e. either both from the list/list style, or both from the heading/outline style. > Problem C > If a list does not specify a list style at all and the paragraphs inside the list, do not have a style:list-style-name attribute in their paragraph styles, then from section 5.3.2 an implementation-dependent default list style is used. On the other hand from section 16.34 we get, that if the headings paragraph style does not define a list style, then the outline style is used. So what style is used for a heading inside a list, in case the style:list-style-name attribute does not exist in the paragraph style of the heading? Is it the default list style or the outline style? this is basically the same as B. > Problem D > How do indents definied in the paragraph style interact with indents definied in the list style? i'm afraid that by now i'm too hungry to investigate this question :) -- Michael Stahl Software Engineer Platform Engineering - Desktop Team Red Hat Better technology. Faster innovation. Powered by community collaboration. See how it works at redhat.com Red Hat GmbH, http://www.de.redhat.com/ , Sitz: Grasbrunn, Handelsregister: Amtsgericht München, HRB 153243, Geschäftsführer: Charles Cachera, Michael Cunningham, Michael O'Neill, Eric Shander


  • 3.  Re: [office] Proposal for style:list-style-name

    Posted 06-14-2017 20:51
    Hi Michael, hi members, Michael Stahl schrieb: On 13.06.2017 22:56, Regina Henschel wrote: Hi all, I have started with a proposal in file ProposalDraft.odt. I have added my suggestions in Blue on the first page. The yellow frames contain some questions and remarks. you want to add: Text missing? The list style specified by this attribute is applied to headings that are not contained in a list. i now realized the way we approached this, by focusing on how the number should be formatted, via outline style or numbering style, is asking the wrong question, or at least ignoring one very important aspect. namely: how do you determine the number of a heading in the first place, i.e. its "index" in the "sequence"? Indeed, that aspect has not been addressed so far. to determine the number of a list item you have to know which list it's in, hence using the numbering style without a list-item / list element doesn't make sense. In case the heading is not inside a list, I expect, that it is similar to using the <text:outline-style> element. the effect you want to have is that you want a heading to be numbered not as a heading but as an item of a separate list, so you need to "connect" the heading elements by actually putting them into a list element. if they're not in a list, how do you know if all of them should be numbered consecutively, or if there are several different numberings, with restarts in the middle? Getting the numbering sequence works in case of <text:outline-style> without creating artificial lists. Here it would be the same, only that you need to track the name of the list style in addition, so that you do not have only one sequence "outline-style" but several sequences. all of that is encoded as attributes on text:list / text:list-item elements such as xml:id, text:continue-numbering... In case of "outline-style" it is encoded in text:restart-numbering and the text:start-value attributes of the <text:h> element. No list involved. That should work for other list-styles too. for example, you may want to have un-numbered top-level headings "Prologue" and "Epilogue" in addition to numbered chapters and differently numbered appendixes. You can have one sequence built of the outline-style and another sequence built on a list-style or you can have two sequences built on two different list-styles. To get an un-numbered top-level heading in LibreOffice, I create a paragraph style with "Outline level 1" and numbering "none", which generates a <text:h> element without any list, and a style:list-style-name="" attribute in the paragraph style which is applied to the <text:h> element. Producers should keep the value of the text:outline-level attribute in sync with the list level, because in several elements (e.g. 7.3.8 <text:chapter>, 8.3.2 <text:table-of-content-source>) not the list level but the outline level is evaluated. i am not sure if we should say "should" here. i hope ODF specifies unambiguously which level is used in any given element? A heading inside a list has a level given by its text:outline-level attribute and a level given by its list-position inside a nesting of lists. I have not found a specification, what level to use. Therefore I have added the preference of the list level. Using the list level is the current way in LibreOffice. But LibreOffice generates lot of problems for the users, because it does not keep outline-level and list-level in sync. See LibreOffice bugtracker https://bugs.documentfoundation.org/show_bug.cgi?id=86905 or id=62032 (with duplicates) or id=42920 and some (e.g. id=78519), which are falsely closed as "worksforme", because outline-style was seen as only valid way to get an outline numbering. if i understand right, we are not concerned about Consumers "getting it wrong", but about usability issues; maybe a non-normative note is sufficient? I have not yet tested the case "list level and outline level are different" in the different applications I have got. [..] The second and further pages contain problems in regard to numbering, which I think have to be solved. I have attached two test documents and have made screen shots from some application I have got on my PC. Although I consider some renderings in WebODF and ONLYOFFICE as bugs or missing feature, the differences between Word 2010, TextMaker and LibreOffice are immense. Perhaps someone has got additional applications on Linux or Mac and can make screen shots from them? i think the biggest problem with these test documents is that they contain a single text:list element and no text:style-name attribute and multiple items each containing a paragraph with a style that wants a different list style. i expect there should be only one list style per list, so which one to choose? If you have a text:style-name attribute in the <text:list> element, then you get an ordinary list. But my problems are about the second case in 19.874.22 <text:list> and similar in 5.3.2 Default List Style "If this attribute is not included and therefore no list style is specified, one of the following actions is taken: ? [..] ? If there is no list style specified for the surrounding list, but the list's list items contain paragraphs that have paragraph styles attached specifying a list style, that list style is used." It does not say, that these styles must be the same. If that is intended, then we should add this to the specification. Or do you know another place in the spec, where it is handled? I stop here, because it is already late in the evening for me. Kind regards Regina


  • 4.  Re: [office] Proposal for style:list-style-name

    Posted 06-30-2017 21:28
    On 14.06.2017 18:09, Michael Stahl wrote: > On 13.06.2017 22:56, Regina Henschel wrote: >> Problem D >> How do indents definied in the paragraph style interact with indents definied in the list style? > > i'm afraid that by now i'm too hungry to investigate this question :) > i've found that this question is answered by Oliver-Rainer quite explicitly in this OOo "spec", section 1.4 "Impact on the paragraphs indents": http://specs.openoffice.org/writer/numbering/NewListLevelAttrs.odt -- Michael Stahl Software Engineer Platform Engineering - Desktop Team Red Hat Better technology. Faster innovation. Powered by community collaboration. See how it works at redhat.com Red Hat GmbH, http://www.de.redhat.com/ , Sitz: Grasbrunn, Handelsregister: Amtsgericht München, HRB 153243, Geschäftsführer: Charles Cachera, Michael Cunningham, Michael O'Neill, Eric Shander


  • 5.  Re: [office] Proposal for style:list-style-name

    Posted 07-01-2017 18:02
    Hi Michael, Michael Stahl schrieb: On 14.06.2017 18:09, Michael Stahl wrote: On 13.06.2017 22:56, Regina Henschel wrote: Problem D How do indents definied in the paragraph style interact with indents definied in the list style? i'm afraid that by now i'm too hungry to investigate this question :) i've found that this question is answered by Oliver-Rainer quite explicitly in this OOo "spec", section 1.4 "Impact on the paragraphs indents": http://specs.openoffice.org/writer/numbering/NewListLevelAttrs.odt Thank you for the link to the detailed description. I have found already that it is specified in 17.20<style:list-level-label-alignment> The description by Oliver-Rainer contains, that "specified by the paragraph style" includes the entire hierarchy of parent paragraph styles. In ODF1.2 we have the general inheritance description in 16.2<style:style> instead. So I think, that the specification is clear about the indents. The problems I see in LibreOffice are only LibreOffice bugs and do not come from a weak specification. Kind regards Regina