extends the GenericWrapper class.
The Span element represents portions of text that are attributed using a certain text style. The content of this element is the text that uses the text style. The name of the text style is the value of the Span.style_name attribute. These attribute must refer to a text style. Span elements can be nested.
Whitespace encoding is applied to the text parameter. (see Whitespace Encoding/Decoding)
Count of charcters of the plain text representation.
Name of the associated style.
Get the plain text representation of this element. Whitespace decoding is applied (see Whitespace Encoding/Decoding).
Append text to this element. Whitespace encoding is applied. (see Whitespace Encoding/Decoding)
extends the Span class.
Paragraphs are the basic unit of text. Whitespace encoding is applied to the text parameter. (see Whitespace Encoding/Decoding)
The cond_style_name attribute references a conditional-style, that is, a style that contains conditions and maps to other styles. If a conditional style is applied to a paragraph, the style_name attribute contains the name of the style that was the result of the conditional style evaluation, while the conditional style name itself is the value of the cond_style_name attribute.
A paragraph may have an ID. This ID can be used to reference the paragraph from other elements.
extends the Span class.
Headings define the chapter structure for a document. A chapter or subchapter begins with a heading and extends to the next heading at the same or higher level. Whitespace encoding is applied to the text parameter. (see Whitespace Encoding/Decoding)
The outline_level attribute determines the level of the heading, starting with 1.
The numbering of headers can be restarted by setting the restart_numbering attribute to True.
The attribute start_value may be used to restart the numbering of headers of the current header’s level, by setting a new value for the numbering.
It is sometimes desired to have a specific heading which should not be numbered. To facilitate this, set this attribute True and the given header will not be numbered.
If a heading has a numbering applied, the text of the formatted number can be included. This text can be used by applications that do not support numbering of headings, but it will be ignored by applications that support numbering.
| Parameters: | paragraph – Paragraph or Heading object |
|---|
In some instances, it is desirable to specify a list not as a structural element comprising of several list items, but to determine on a per-paragraph level whether the paragraph is numbered, and at which level. To facilitate this, the NumberedParagraph class allows the numbering of an individual paragraph, as if it was part of a list at a specified level.
Numbered paragraphs may use the same continuous numbering properties that list items use, and thus form an equivalent, alternative way of specifying lists.
The NumberedParagraph class contains exact one Paragraph object or one Heading object.
Returns the associated paragraph or heading object, or if no paragraph or heading object exists, a new paragraph object will be created.
A numbered paragraph can be assigned a list level. A numbered paragraph is equivalent to a list nested to the given level, containing one list item with one paragraph. If no level is given, the numbered paragraph is interpreted as being on level 1.
The attribute start_value may be used to restart the numbering of the current paragraphs’s level, by setting a new value for the numbering.
If a numbering is applied, the text of the formatted number can be included. This text can be used by applications that do not support numbering of paragraphs, but it will be ignored by applications that support numbering.
extends the Span class.
Represents hyperlinks in text documents. The parameter href is the URL of the target location of this link. The text parameter is the link text. The Hyperlink class can contain the same objects as the Paragraph class.
A hyperlink can have a name, but it is not essential. The name attribute specifies the name of the hyperlink if one exists. This name can serve as a target for some other hyperlinks.
Specifies the URL for the target location of the link.
Specifies the target frame of the link. This attribute can have one of the following values:
| Target Name | Location |
|---|---|
| _self | The referenced document replaces the content of the current frame. |
| _blank | The referenced document is displayed in a new frame. |
| _parent | The referenced document is displayed in the parent frame of the current frame. |
| _top | The referenced document is displayed in the uppermost frame, that is the frame that contains the current frame as a child or descendent but is not contained within another frame. |
| A frame name | The referenced document is displayed in the named frame. If the named frame does not exist, a new frame with that name is created. |
The OpenDocument format supports list structures, similar to those found in HTML4. A list is a paragraph-level element, which contains an optional list header, followed by a sequence of list items. The list header and each list item contains a sequence of paragraph or list elements. Lists can be nested.
Lists may be numbered. The numbering may be restarted with a specific numbering at each list item. Lists may also continue numbering from other lists, allowing the user to merge several lists into a single, discontinuous list. Note that whether the list numbering is displayed depends on a suitable list style being used.
Every list has a list level, which is determined by the nesting of the List elements. If a list is not contained within another list, the list level is 1. If the list in contained within another list, the list level is the list level of the list in which is it contained incremented by one. If a list is contained in a table cell or text box, the list level returns to 1, even though the table or textbox itself may be nested within another list.
Specifies the name of the list style that is applied to the list.
If this attribute is not included and therefore no list style is specified, one of the following actions is taken:
By default, the first list item in a list starts with the number specified in the list style. The continue numbering attribute can be used to continue the numbering from the preceding list.
This attribute can have a value of True or False.
If the value of the attribute is True and the numbering style of the preceding list is the same as the current list, the number of the first list item in the current list is the number of the last item in the preceding list incremented by one.
Set/Get the ListHeader object.
List items contain the textual content of a list. A ListItem element can contain Paragraph, Heading, List or SoftPageBreak. A list item cannot contain tables.
The first line in a list item is preceded by a bullet or number, depending on the list style assigned to the list. If a list item starts another list immediately and does not contain any text, no bullet or number is displayed.
The numbering of the current list can be restarted at a certain number. The start_value attribute is used to specify the number with which to restart the list. This attribute can only be applied to items in a list with a numbering list style. It restarts the numbering of the list at the current item.
If a numbering is applied, the text of the formatted number can be included. This text can be used by applications that do not support numbering of lists, but it will be ignored by applications that support numbering.
A list header is a special kind of list item. It contains one or more paragraphs that are displayed before a list. The paragraphs are formatted like list items but they do not have a preceding number or bullet. The list header is represented by the list header element.
A text section is a named region of paragraph-level text content. Sections start and end on paragraph boundaries and can contain any number of paragraphs.
Sections have two uses in the OpenDocument format: They can be used to assign certain formatting properties to a region of text. They can also be used to group text that is automatically acquired from some external data source.
In addition to Sections can contain regular text content or the text can be contained in another file and linked to the section. Sections can also be write-protected or hidden.
Sections can have settings for text columns, background color or pattern, and notes configuration.
Sections support two ways of linking to external content. If a section is linked to another document, the link can be through one of the following:
Linking information for external content is contained in the section element’s first child. A section that links to external content contains the full representation of the data source, so that processors need to understand the linking information only if they wish to update the contents of the section.
Encoding
Multiple spaces are replaced by the Spaces class, '\t' is replaced by the Tabulator class and '\n' is replaced by the LineBreak class.
Decoding
The Spaces class is replaces by space characters, the Tabulator class is replaced by the '\t' character and the LineBreak class is replaced by the '\n' character.