Subject: renewed proposal: new attributes text:style-override and text:list-id
Dear TC members, I want to renew my proposal - see http://www.oasis-open.org/archives/office/200702/msg00130.html - about the introduction of the following new attributes: - text:list-id for numbered paragraphs - <text:numbered-paragraph> - text:style-override for list items - <text:list-item> Beside these new attributes this proposal also includes some clarifications regarding lists in ODF. The content of the proposal isn't changed. I've only added some references to chapters, in which the new attributes and clarifications should be inserted. I also included the clarification I've given in my reply to Thomas Zander's request - see posting http://www.oasis-open.org/archives/office/200702/msg00139.html The proposal is the result of the discussion during the TC calls and on this mailing list of two initial proposals. One is about text:list-id - see http://www.oasis-open.org/archives/office/200611/msg00052.html. The other one is about text:style-override - see http://www.oasis-open.org/archives/office/200611/msg00053.html. Posting http://lists.oasis-open.org/archives/office/200701/msg00010.html tries to find a compromis, but some additional clarifications about lists in ODF are discussed - see mailing list thread started with posting http://lists.oasis-open.org/archives/office/200702/msg00046.html Proposal: (1) Introduce new mandatory attribute text:list-id for <text:numbered-paragraph>. The purpose of this attribute is to group certain instances of <text:numbered-paragraph> together to one list. Thus, all numbered paragraphs with the same list-id form a list and each list-id defines one counter domain. For the start values of the counter domain defined by a list-id it's proposed to use the start values of the list style of the first numbered paragraph of the list. For text documents in previous ODF versions, which doesn't contain the list-id attribute, the following handling is proposed: - A series of numbered paragraphs using the same list style can easily be implied to be part of the same list. - A numbered paragraph that does not have a list-id gets the list-id of the last numbered-paragraph on that same level using the same style. If the previous has a different style, then a new list is started. Insert this new attribute, its explanation and the handling of text documents in previous ODF versions in chapter 4.3.4 "Numbered Paragraphs", referencing ODF 1.1 specification document. (2) If a numbered paragraph doesn't specify a list style, it's proposed to use the list style, which is applied to the numbered paragraph on the superior list level of the same list. If no such numbered paragraph exists, a default list style is applied. Insert this clarification also into chapter 4.3.4 "Numbered Paragraphs". (3) Introduce new optional attribute text:style-override for <text:list-item>. The purpose of this attribute is that each list item can override the defined list style of its list block by a certain list style. The complete list level definitions of the overriding list style is used to override the definitions of the overriden list style. If the overriding list style only contains the definition for one list level, only the list level definition of this list level is overriden. Thus, the list style, which is applied to the list item is a somehow a list style, which is formed by taking the list style of the list block overriden by the list level definitions of the list style given in the text:style-override attribute. Insert this new attribute and its explanation into chapter 4.3.2 "List Item", referencing to ODF 1.1 specification document. (4) Each top-most list block denotes a certain list and defines the counter domain for its including list items and sub lists. The list style, which will be applied to this list, can define start values for each list level. A specified list style on a certain sub list overrides a possible given start value for its list level, if it contains the list definition for this list level. Each sub list restarts the counter for its list level. Each sub list can have its own list style and it's proposed that the complete list level definitions of this list style are applied to its list items. E.g., a sub list on list level 3 defines an own list style containing list level definitions for list level 2 and 3. Thus, these list level definitions are used, if needed, to build the list label of its list items and to layout its list items. Insert this clarifications into chapter 4.3.1 "List Block", referencing to ODF 1.1 specification document. (5) The ODF specification 1.1 - see chapter 4.3.1 about list blocks - states that only the counter domain of the direct preceding list can be continued using attribute text:continue-numbering. It's proposed that with the use of attribute text:continue-numbered="true" the counter domain of one of the preceding lists is continued. Such a preceding list has to fulfill the condition, that is applies the same list style. If more than one of such a preceding list exists, the one is chosen, which is found first in stepping backward in the document. If no such preceding list exists no counter domain is continued. (6) List styles contain definitions for certain list levels. The list level definitions don't have to be complete. E.g., a certain list style can contain the list level definitions for list level 2 and 3. Thus, it can happen, that such a list style is applied to a certain list item and a missing list level definition is needed to build the contents of the list label. E.g., a list style only containing list level definition for list level 2 is applied on a list item on list level 2. But, it's specified, that the list label should contain the number of superior list level 1. Thus, list level definition for list level 1 is needed to determine the number format. It's proposed use the list level definition for list level 1, which is applied the parent/superior list item on list level 1. If no parent/superior list item on list level 1 exists, use a default list style. This is the same default list style, which is mentioned in chapter 4.3.1 of ODF specification 1.1 about list blocks. The same should be applied to numbered paragraphs of a certain list. This clarification should be inserted into chapter 4.3.2 "List Item", referencing to ODF 1.1 specification document. A link to this clarification should be added to chapter 4.3.4 "Numbered Paragraphs" Please support this proposal and vote on it. Regards, Oliver.