Returns a couple (STATUS, VALUE), where status is 1 when OK, 0 when informative, and -1 when error, and value is a string.

The given arguments can be either a string or an array, the input can be None (it will be then taken from the arguments), or be a file-like object, and the noOutput flag will not output the result on stdout or whatever file is given on the command line.

Converts the given text to HTML, returning only the body.

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

dict() -> new empty dictionary. dict(mapping) -> new dictionary initialized from a mapping object's (key, value) pairs. dict(seq) -> new dictionary initialized as if via: d = {} for k, v in seq: d[k] = v dict(**kwargs) -> new dictionary initialized with the name=value pairs in the keyword argument list. For example: dict(one=1, two=2)

int(x, base) -> integer

Convert a string or number to an integer, if possible. A floating point argument will be truncated towards zero (this does not include a string representation of a floating point number!) When converting a string, use the optional base. It is an error to supply a base when converting a non-string. If the argument is outside the integer range a long object will be returned instead.

dict() -> new empty dictionary. dict(mapping) -> new dictionary initialized from a mapping object's (key, value) pairs. dict(seq) -> new dictionary initialized as if via: d = {} for k, v in seq: d[k] = v dict(**kwargs) -> new dictionary initialized with the name=value pairs in the keyword argument list. For example: dict(one=1, two=2)

int(x, base) -> integer

Convert a string or number to an integer, if possible. A floating point argument will be truncated towards zero (this does not include a string representation of a floating point number!) When converting a string, use the optional base. It is an error to supply a base when converting a non-string. If the argument is outside the integer range a long object will be returned instead.

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

int(x, base) -> integer

Convert a string or number to an integer, if possible. A floating point argument will be truncated towards zero (this does not include a string representation of a floating point number!) When converting a string, use the optional base. It is an error to supply a base when converting a non-string. If the argument is outside the integer range a long object will be returned instead.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

Kiwi is an advanced markup text processor, which can be used as an embedded processor in any application. It is fast, extensible and outputs an XML DOM.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Returns true when the current offset has exceeded the current block end offset

Returns a clone of the current context, which can be changed safely without modifying the current context.

Returns the current text fragment, from the current offset to the block end offset.

Declares a section node with the given depth (which can be negative).

Decreases the offset.

Returns true if the current offset is greater than the document length

Ensures that the given element exists in the given node at the given index.

Ensures that the parent node name is one of the following name. This is useful for block parsers which want to ensure that their parent is a specific node

Finds the next inline in the given context, using the given list of inline parsers. This does not modifies the context.

Returns either None or a triple (offset, information, parser), where the offset is relative to the context offset and indicates the start offset where the parser recognised its tag and information is the information returned by the parser.

Returns the text fragment that starts and ends at the given offsets.

Returns the indentation of the current block.

Returns the number of parent sections of the given node.

Returns the current offset.

Gets the section that would be the parent section for the given depth.

Increases the current offset

Tells if the givne offset is in the current block.

Parses attributes expressed in the given text. Attributes have the following form: ATTRIBUTE="VALUE" and are separated by spaces.

Takes a value returned by saveOffsets and restores the offsets as they were.

Returns a value that can be later used with the restoreOffsets method to restore the offsets as they were.

Sets the start and end offset of the current block. The current offset is set to the current block start.

Sets the text of the current document. This should only be called at context initialisation.

Sets the current offset.

The context stores information on the currently processed document. It has the following attributes:

• document: a reference to the current XML document.
• rootNode: the current XML document root node.
• header: the XML node corresponding to the header.
• content: the XML node corresponding to the content.
• references: the XML node corresponding to the references.
• appendices: the XML node corresponding to the appendices.
• currentNode: the XML node to which attributes/nodes are added during parsing.
• blockStartOffset: the offset in the text where the currently parsed block starts.
• blockEndOffset: the offset in the text where the currently parsed block ends.
• parser: a reference to the Kiwi parser instance using the context.

Returns a match object that matches the next block separator, taking into account possible custom block objects.

Creates the XML document that will be populated by Kiwi parsing.

Parses the block identified in the given context, ending at the given end (if end is not None).

Parses the content of the current block, starting at the context offset, modifying the given node and updating the context offset. This returns the a triple (offset, information, parser) where information is the result of the parser `recognises' method.

Used by the _updateElementOffsets to ensure start and end offsets in all children and descendants.

This function ensures that every element has a start and end attribute indicating the bit of original data it comes from.

Returns a string where all characters are converted to spaces. Newlines and tabs are preserved

Returns the number of leading spaces in the given line. A tab will have the value given by the TAB_SIZE global.

Expands the tabs in the given text, cutting the n first characters of each line, where n is given by the cut argument. This tabs expansion algorithm works better than Python line expansion algorithms.

Returns the indentation of a string.

Basically if a string has the first three lines at the same identation level, then it is indentation will be the number of spaces or tabs that lead the first three lines.

Tabs have the value given by the TAB_SIZE variable.

Treats tabs eols and multiples spaces as single space, plus removes leading and trailing spaces.

Parses the given text, and returns an XML document. If offsets is set to True, then all nodes of the document are annotated with their position in the original text as well with a number. The document will also have an offsets attribute that will contain a list of (start, end) offset tuples for each element.

Parses the current block, looking for the inlines it may contain.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

int(x, base) -> integer

Convert a string or number to an integer, if possible. A floating point argument will be truncated towards zero (this does not include a string representation of a floating point number!) When converting a string, use the optional base. It is an error to supply a base when converting a non-string. If the argument is outside the integer range a long object will be returned instead.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

Compiled regular expression objects

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

int(x, base) -> integer

Convert a string or number to an integer, if possible. A floating point argument will be truncated towards zero (this does not include a string representation of a floating point number!) When converting a string, use the optional base. It is an error to supply a base when converting a non-string. If the argument is outside the integer range a long object will be returned instead.

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

int(x, base) -> integer

Convert a string or number to an integer, if possible. A floating point argument will be truncated towards zero (this does not include a string representation of a floating point number!) When converting a string, use the optional base. It is an error to supply a base when converting a non-string. If the argument is outside the integer range a long object will be returned instead.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

int(x, base) -> integer

Convert a string or number to an integer, if possible. A floating point argument will be truncated towards zero (this does not include a string representation of a floating point number!) When converting a string, use the optional base. It is an error to supply a base when converting a non-string. If the argument is outside the integer range a long object will be returned instead.

int(x, base) -> integer

Convert a string or number to an integer, if possible. A floating point argument will be truncated towards zero (this does not include a string representation of a floating point number!) When converting a string, use the optional base. It is an error to supply a base when converting a non-string. If the argument is outside the integer range a long object will be returned instead.

int(x, base) -> integer

Convert a string or number to an integer, if possible. A floating point argument will be truncated towards zero (this does not include a string representation of a floating point number!) When converting a string, use the optional base. It is an error to supply a base when converting a non-string. If the argument is outside the integer range a long object will be returned instead.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Tells wether the given block is recognised or not. This returns this block recognition information, or False (or None) if the block was not recongised.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Parses a comment markup block.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Parses a definition markup element.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Parses a list item. A list item is an element within a list.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Parses a custom markup block.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Parses custom markup and registers the new parsers in the current Kiwi parser

Tells wether the given block is recognised or not. This returns this block recognition information, or False (or None) if the block was not recongised.

Parses the content of a Meta block

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Parses a paragraph block. This parser always recognised the given block, so it should not appear in the block parsers.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Parses the content of a preformatted block, where every line is prefixed by > .

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Parses the content of a preformatted block which is delimited with <<< and >>> characters.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Parses the content of a Reference entry

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Parses a section markup element.

Ensures that the cell at the given position exists and returns its pair value.

Renders the table as a Kiwi XML document node.

Sets the title for this table.

The table class allows to easily create tables and then generate the XML objects from them.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Parses the content of a tables

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Parses a tagged block. Notes are the common example of tagged block.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Parses a title object

Write module doc here

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

A function that is called to check if the text before the current offset is recognized by this parser. This is used by requiresLeadingSpace.

Returns the end of this inline using the given recogniseInfo.

Recognises this inlines in the given context, within the current context block. It returns (None, None) when the inline was not recognised, otherwise it returns the offset of the matching element in the current context, plus information that will be given as argument to the parse method. This means that the returned offset is RELATIVE TO THE CURRENT CONTEXT OFFSET.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

A function that is called to check if the text before the current offset is recognized by this parser. This is used by requiresLeadingSpace.

Returns the end of this inline using the given recogniseInfo.

Recognises this inlines in the given context, within the current context block. It returns (None, None) when the inline was not recognised, otherwise it returns the offset of the matching element in the current context, plus information that will be given as argument to the parse method. This means that the returned offset is RELATIVE TO THE CURRENT CONTEXT OFFSET.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

A function that is called to check if the text before the current offset is recognized by this parser. This is used by requiresLeadingSpace.

Returns the end of this inline using the given recogniseInfo.

Recognises this inlines in the given context, within the current context block. It returns (None, None) when the inline was not recognised, otherwise it returns the offset of the matching element in the current context, plus information that will be given as argument to the parse method. This means that the returned offset is RELATIVE TO THE CURRENT CONTEXT OFFSET.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

A function that is called to check if the text before the current offset is recognized by this parser. This is used by requiresLeadingSpace.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

A function that is called to check if the text before the current offset is recognized by this parser. This is used by requiresLeadingSpace.

Returns the end of this inline using the given recogniseInfo.

Recognises this inlines in the given context, within the current context block. It returns (None, None) when the inline was not recognised, otherwise it returns the offset of the matching element in the current context, plus information that will be given as argument to the parse method. This means that the returned offset is RELATIVE TO THE CURRENT CONTEXT OFFSET.

Creates a new InlineParser.

Name is the name of the parser, regexp is the string expression of the regular expression that will match the element that the InlineParser is looking for, or regexp can also be a precompiled regular expression object.

Result is a lambda expression that will return the content of the Inline generated by the parse method. The lambda takes two arguments : the match object and the string in which the match object has been found.

A function that is called to check if the text before the current offset is recognized by this parser. This is used by requiresLeadingSpace.

Returns the end of this inline using the given recogniseInfo.

Parses the given context within the current block range, returning the new offset (relative to the block start offset, ie. the start of context.currentFragment). Note that the context offsets are the same as those given to the recognise method call which created recogniseInfo.

The given context starts at the same offset as when recognises was called. Modifications are made to the given node.

Recognises this inlines in the given context, within the current context block. It returns (None, None) when the inline was not recognised, otherwise it returns the offset of the matching element in the current context, plus information that will be given as argument to the parse method. This means that the returned offset is RELATIVE TO THE CURRENT CONTEXT OFFSET.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

A function that is called to check if the text before the current offset is recognized by this parser. This is used by requiresLeadingSpace.

Returns the end of this inline using the given recogniseInfo.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Looks for the next markup inline in the current context. This also takes care of markups that are contained into an escaped text tag.

WARNING : this operation mutates the context offsets, so this should always be enclosed in offset store and restore. The context offset is set BEFORE the searched markup, so that the returned recognition info is relative to the context offset.

Returns the result of this parser `recognise' method, or null.

Finds the end of the given markup end in the current block. Returns a couple (start, end) indicating the start and end offsets of the found end block, relative to the context offset. The given offsetIncr parameter tells the number of characters to skip before searching for the end markup. This has no impact on the result.

The context offsets are left unchanged.

Parses the given tag, and returns the offset where the parsed tag ends. If the tag is an "inline block" tag, then its content is also parsed.

A function that is called to check if the text before the current offset is recognized by this parser. This is used by requiresLeadingSpace.

Returns the end of this inline using the given recogniseInfo.

Recognises this inlines in the given context, within the current context block. It returns (None, None) when the inline was not recognised, otherwise it returns the offset of the matching element in the current context, plus information that will be given as argument to the parse method. This means that the returned offset is RELATIVE TO THE CURRENT CONTEXT OFFSET.

Parses Kiwi generic markup elements.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

A function that is called to check if the text before the current offset is recognized by this parser. This is used by requiresLeadingSpace.

Returns the end of this inline using the given recogniseInfo.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

A function that is called to check if the text before the current offset is recognized by this parser. This is used by requiresLeadingSpace.

Returns the end of this inline using the given recogniseInfo.

Recognises this inlines in the given context, within the current context block. It returns (None, None) when the inline was not recognised, otherwise it returns the offset of the matching element in the current context, plus information that will be given as argument to the parse method. This means that the returned offset is RELATIVE TO THE CURRENT CONTEXT OFFSET.

Returns the attribute string of this markup stat element.

Common operation for expanding tabs and normalising text. Use by acronyms, citations and quotes.

Default function for processing elements. This returns the text.

Interprets the given expression for the given element

Processes the given element according to the EXPRESSION_TABLE, using the given selector to select an alternative function.

Fills the EXPRESSIONTABLE which maps element names to processing functions. This function is only useful when you implement your templates in the same way as the `kiwi2html` module, ie. with processing functions like `convertXXXVVV where XXX stands for the element name, and _VVV is the optional variant (selected by$(element:variant)`).

You may prefer to use the registerElementProcessor instead if you want to register a processor for an individual tag.

Registers the given function to process the given element name and the given optional variant.

Note that this will replace any previsously registered processor for the element and variant.

Resolves the set of names in the given element. When "Paragraph"is given, then all child paragraph nodes of the current node will be returned, while "Section", "Paragraph"will return all paragraphs for all sections.

The processor is the core of the template engine. You give it a Python module with "convert*" functions, and it will process it.

Compiled regular expression objects

The template module implements a simple way to convert an XML document to another format (HTML, text, whatever) by expanding very simple XPath-like expressions. Of course, it is a very-small subset of what you could do in XSLT, but it has a Python syntax and is very, very easy to use.

At first, your define convertXXX' functions where XXX is your case-sensitive tagName. All these functions should take an element as parameter and run the process' function with the element and template string as parameter.

Expressions like `$(XXX)' (XXX being the expression) in the template strings will be expanded by procesing the set of nodes indicated by the XXX expression.

• $(*) will process all children
• $(MyNode) will process only nodes with MyNode tagName
• $(MyParent/MyNode) will process only the children of MyParent named MyNode
• $(MyNode:alt) will use the function `convertMyNode_alt' instead of the default 'convertMyNode', if available. This allows to setup 'processing modes' for your document (like table of content, references, etc).
• $(MyNode:alt?) will use the function convertMyNode_alt' if it is defined, or fallback to convertMyNode`.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

We override this for elements with the html attribute.

Utility function that returns the element number (part of the element offset attributes)

Returns the offset attributes of this element if it has any.

Wraps the given text in a DIV extended with offsets attributes if the given element has offset attributes.

Wraps the given text in a SPAN extended with offsets attributes if the given element has offset attributes.

dict() -> new empty dictionary. dict(mapping) -> new dictionary initialized from a mapping object's (key, value) pairs. dict(seq) -> new dictionary initialized as if via: d = {} for k, v in seq: d[k] = v dict(**kwargs) -> new dictionary initialized with the name=value pairs in the keyword argument list. For example: dict(one=1, two=2)

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

dict() -> new empty dictionary. dict(mapping) -> new dictionary initialized from a mapping object's (key, value) pairs. dict(seq) -> new dictionary initialized as if via: d = {} for k, v in seq: d[k] = v dict(**kwargs) -> new dictionary initialized with the name=value pairs in the keyword argument list. For example: dict(one=1, two=2)

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Compiled regular expression objects

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

Compiled regular expression objects

Parses the content of a Meta block

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Returns a match object that matches the next block separator, taking into account possible custom block objects.

Creates the XML document that will be populated by Kiwi parsing.

Sets the text of the current document. This should only be called at context initialisation.

Returns a value that can be later used with the restoreOffsets method to restore the offsets as they were.

Sets the start and end offset of the current block. The current offset is set to the current block start.

Sets the current offset.

Returns the current offset.

Gets the section that would be the parent section for the given depth.

Returns the indentation of the current block.

Returns the number of parent sections of the given node.

Parses attributes expressed in the given text. Attributes have the following form: ATTRIBUTE="VALUE" and are separated by spaces.

Takes a value returned by saveOffsets and restores the offsets as they were.

Increases the current offset

Tells if the givne offset is in the current block.

Compiled regular expression objects

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

Declares a section node with the given depth (which can be negative).

Finds the next inline in the given context, using the given list of inline parsers. This does not modifies the context.

Returns either None or a triple (offset, information, parser), where the offset is relative to the context offset and indicates the start offset where the parser recognised its tag and information is the information returned by the parser.

Returns the text fragment that starts and ends at the given offsets.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Ensures that the parent node name is one of the following name. This is useful for block parsers which want to ensure that their parent is a specific node

Returns the current text fragment, from the current offset to the block end offset.

Returns true when the current offset has exceeded the current block end offset

Returns a clone of the current context, which can be changed safely without modifying the current context.

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

The context stores information on the currently processed document. It has the following attributes:

• document: a reference to the current XML document.
• rootNode: the current XML document root node.
• header: the XML node corresponding to the header.
• content: the XML node corresponding to the content.
• references: the XML node corresponding to the references.
• appendices: the XML node corresponding to the appendices.
• currentNode: the XML node to which attributes/nodes are added during parsing.
• blockStartOffset: the offset in the text where the currently parsed block starts.
• blockEndOffset: the offset in the text where the currently parsed block ends.
• parser: a reference to the Kiwi parser instance using the context.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

int(x, base) -> integer

Convert a string or number to an integer, if possible. A floating point argument will be truncated towards zero (this does not include a string representation of a floating point number!) When converting a string, use the optional base. It is an error to supply a base when converting a non-string. If the argument is outside the integer range a long object will be returned instead.

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

dict() -> new empty dictionary. dict(mapping) -> new dictionary initialized from a mapping object's (key, value) pairs. dict(seq) -> new dictionary initialized as if via: d = {} for k, v in seq: d[k] = v dict(**kwargs) -> new dictionary initialized with the name=value pairs in the keyword argument list. For example: dict(one=1, two=2)

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

int(x, base) -> integer

Convert a string or number to an integer, if possible. A floating point argument will be truncated towards zero (this does not include a string representation of a floating point number!) When converting a string, use the optional base. It is an error to supply a base when converting a non-string. If the argument is outside the integer range a long object will be returned instead.

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

Kiwi is an advanced markup text processor, which can be used as an embedded processor in any application. It is fast, extensible and outputs an XML DOM.

Returns a couple (STATUS, VALUE), where status is 1 when OK, 0 when informative, and -1 when error, and value is a string.

The given arguments can be either a string or an array, the input can be None (it will be then taken from the arguments), or be a file-like object, and the noOutput flag will not output the result on stdout or whatever file is given on the command line.

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

dict() -> new empty dictionary. dict(mapping) -> new dictionary initialized from a mapping object's (key, value) pairs. dict(seq) -> new dictionary initialized as if via: d = {} for k, v in seq: d[k] = v dict(**kwargs) -> new dictionary initialized with the name=value pairs in the keyword argument list. For example: dict(one=1, two=2)

Converts the given text to HTML, returning only the body.

Parses a custom markup block.

A function that is called to check if the text before the current offset is recognized by this parser. This is used by requiresLeadingSpace.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Compiled regular expression objects

int(x, base) -> integer

Convert a string or number to an integer, if possible. A floating point argument will be truncated towards zero (this does not include a string representation of a floating point number!) When converting a string, use the optional base. It is an error to supply a base when converting a non-string. If the argument is outside the integer range a long object will be returned instead.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Compiled regular expression objects

Wraps the given text in a DIV extended with offsets attributes if the given element has offset attributes.

Compiled regular expression objects

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Compiled regular expression objects

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Parses the content of a preformatted block which is delimited with <<< and >>> characters.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Parses a paragraph block. This parser always recognised the given block, so it should not appear in the block parsers.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

A function that is called to check if the text before the current offset is recognized by this parser. This is used by requiresLeadingSpace.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Compiled regular expression objects

Fills the EXPRESSIONTABLE which maps element names to processing functions. This function is only useful when you implement your templates in the same way as the `kiwi2html` module, ie. with processing functions like `convertXXXVVV where XXX stands for the element name, and _VVV is the optional variant (selected by$(element:variant)`).

You may prefer to use the registerElementProcessor instead if you want to register a processor for an individual tag.

Compiled regular expression objects

int(x, base) -> integer

Convert a string or number to an integer, if possible. A floating point argument will be truncated towards zero (this does not include a string representation of a floating point number!) When converting a string, use the optional base. It is an error to supply a base when converting a non-string. If the argument is outside the integer range a long object will be returned instead.

Returns the end of this inline using the given recogniseInfo.

Compiled regular expression objects

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Decreases the offset.

Returns true if the current offset is greater than the document length

Compiled regular expression objects

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Ensures that the given element exists in the given node at the given index.

Returns the offset attributes of this element if it has any.

Parses a definition markup element.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Parses the content of a tables

Compiled regular expression objects

Parses the current block, looking for the inlines it may contain.

The processor is the core of the template engine. You give it a Python module with "convert*" functions, and it will process it.

dict() -> new empty dictionary. dict(mapping) -> new dictionary initialized from a mapping object's (key, value) pairs. dict(seq) -> new dictionary initialized as if via: d = {} for k, v in seq: d[k] = v dict(**kwargs) -> new dictionary initialized with the name=value pairs in the keyword argument list. For example: dict(one=1, two=2)

A function that is called to check if the text before the current offset is recognized by this parser. This is used by requiresLeadingSpace.

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

Returns the indentation of a string.

Basically if a string has the first three lines at the same identation level, then it is indentation will be the number of spaces or tabs that lead the first three lines.

Tabs have the value given by the TAB_SIZE variable.

Compiled regular expression objects

int(x, base) -> integer

Convert a string or number to an integer, if possible. A floating point argument will be truncated towards zero (this does not include a string representation of a floating point number!) When converting a string, use the optional base. It is an error to supply a base when converting a non-string. If the argument is outside the integer range a long object will be returned instead.

Compiled regular expression objects

Tells wether the given block is recognised or not. This returns this block recognition information, or False (or None) if the block was not recongised.

A function that is called to check if the text before the current offset is recognized by this parser. This is used by requiresLeadingSpace.

Parses the given tag, and returns the offset where the parsed tag ends. If the tag is an "inline block" tag, then its content is also parsed.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Parses the content of a preformatted block, where every line is prefixed by > .

Parses a title object

Compiled regular expression objects

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Parses the content of the current block, starting at the context offset, modifying the given node and updating the context offset. This returns the a triple (offset, information, parser) where information is the result of the parser `recognises' method.

Compiled regular expression objects

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

Compiled regular expression objects

Creates a new InlineParser.

Name is the name of the parser, regexp is the string expression of the regular expression that will match the element that the InlineParser is looking for, or regexp can also be a precompiled regular expression object.

Result is a lambda expression that will return the content of the Inline generated by the parse method. The lambda takes two arguments : the match object and the string in which the match object has been found.

Parses a tagged block. Notes are the common example of tagged block.

Tells wether the given block is recognised or not. This returns this block recognition information, or False (or None) if the block was not recongised.

int(x, base) -> integer

Convert a string or number to an integer, if possible. A floating point argument will be truncated towards zero (this does not include a string representation of a floating point number!) When converting a string, use the optional base. It is an error to supply a base when converting a non-string. If the argument is outside the integer range a long object will be returned instead.

Compiled regular expression objects

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Processes the given element according to the EXPRESSION_TABLE, using the given selector to select an alternative function.

The template module implements a simple way to convert an XML document to another format (HTML, text, whatever) by expanding very simple XPath-like expressions. Of course, it is a very-small subset of what you could do in XSLT, but it has a Python syntax and is very, very easy to use.

At first, your define convertXXX' functions where XXX is your case-sensitive tagName. All these functions should take an element as parameter and run the process' function with the element and template string as parameter.

Expressions like `$(XXX)' (XXX being the expression) in the template strings will be expanded by procesing the set of nodes indicated by the XXX expression.

• $(*) will process all children
• $(MyNode) will process only nodes with MyNode tagName
• $(MyParent/MyNode) will process only the children of MyParent named MyNode
• $(MyNode:alt) will use the function `convertMyNode_alt' instead of the default 'convertMyNode', if available. This allows to setup 'processing modes' for your document (like table of content, references, etc).
• $(MyNode:alt?) will use the function convertMyNode_alt' if it is defined, or fallback to convertMyNode`.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Parses custom markup and registers the new parsers in the current Kiwi parser

Sets the title for this table.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Parses the given text, and returns an XML document. If offsets is set to True, then all nodes of the document are annotated with their position in the original text as well with a number. The document will also have an offsets attribute that will contain a list of (start, end) offset tuples for each element.

Compiled regular expression objects

Compiled regular expression objects

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Compiled regular expression objects

int(x, base) -> integer

Convert a string or number to an integer, if possible. A floating point argument will be truncated towards zero (this does not include a string representation of a floating point number!) When converting a string, use the optional base. It is an error to supply a base when converting a non-string. If the argument is outside the integer range a long object will be returned instead.

Recognises this inlines in the given context, within the current context block. It returns (None, None) when the inline was not recognised, otherwise it returns the offset of the matching element in the current context, plus information that will be given as argument to the parse method. This means that the returned offset is RELATIVE TO THE CURRENT CONTEXT OFFSET.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Compiled regular expression objects

Parses the content of a Reference entry

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Recognises this inlines in the given context, within the current context block. It returns (None, None) when the inline was not recognised, otherwise it returns the offset of the matching element in the current context, plus information that will be given as argument to the parse method. This means that the returned offset is RELATIVE TO THE CURRENT CONTEXT OFFSET.

Parses the block identified in the given context, ending at the given end (if end is not None).

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Compiled regular expression objects

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

Parses Kiwi generic markup elements.

Compiled regular expression objects

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Compiled regular expression objects

Compiled regular expression objects

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Returns the end of this inline using the given recogniseInfo.

Interprets the given expression for the given element

Returns the attribute string of this markup stat element.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Ensures that the cell at the given position exists and returns its pair value.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Returns the end of this inline using the given recogniseInfo.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Compiled regular expression objects

The table class allows to easily create tables and then generate the XML objects from them.

Returns the end of this inline using the given recogniseInfo.

Compiled regular expression objects

This function ensures that every element has a start and end attribute indicating the bit of original data it comes from.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Compiled regular expression objects

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Finds the end of the given markup end in the current block. Returns a couple (start, end) indicating the start and end offsets of the found end block, relative to the context offset. The given offsetIncr parameter tells the number of characters to skip before searching for the end markup. This has no impact on the result.

The context offsets are left unchanged.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

dict() -> new empty dictionary. dict(mapping) -> new dictionary initialized from a mapping object's (key, value) pairs. dict(seq) -> new dictionary initialized as if via: d = {} for k, v in seq: d[k] = v dict(**kwargs) -> new dictionary initialized with the name=value pairs in the keyword argument list. For example: dict(one=1, two=2)

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Compiled regular expression objects

int(x, base) -> integer

Convert a string or number to an integer, if possible. A floating point argument will be truncated towards zero (this does not include a string representation of a floating point number!) When converting a string, use the optional base. It is an error to supply a base when converting a non-string. If the argument is outside the integer range a long object will be returned instead.

Compiled regular expression objects

Treats tabs eols and multiples spaces as single space, plus removes leading and trailing spaces.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Returns the number of leading spaces in the given line. A tab will have the value given by the TAB_SIZE global.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Recognises this inlines in the given context, within the current context block. It returns (None, None) when the inline was not recognised, otherwise it returns the offset of the matching element in the current context, plus information that will be given as argument to the parse method. This means that the returned offset is RELATIVE TO THE CURRENT CONTEXT OFFSET.

Compiled regular expression objects

Expands the tabs in the given text, cutting the n first characters of each line, where n is given by the cut argument. This tabs expansion algorithm works better than Python line expansion algorithms.

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Renders the table as a Kiwi XML document node.

Compiled regular expression objects

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

str(object) -> string

Return a nice string representation of the object. If the argument is a string, the return value is the same object.

Compiled regular expression objects

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Looks for the next markup inline in the current context. This also takes care of markups that are contained into an escaped text tag.

WARNING : this operation mutates the context offsets, so this should always be enclosed in offset store and restore. The context offset is set BEFORE the searched markup, so that the returned recognition info is relative to the context offset.

Returns the result of this parser `recognise' method, or null.

Recognises this inlines in the given context, within the current context block. It returns (None, None) when the inline was not recognised, otherwise it returns the offset of the matching element in the current context, plus information that will be given as argument to the parse method. This means that the returned offset is RELATIVE TO THE CURRENT CONTEXT OFFSET.

Compiled regular expression objects

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Compiled regular expression objects

Common operation for expanding tabs and normalising text. Use by acronyms, citations and quotes.

Compiled regular expression objects

unicode(string , encoding[, errors]) -> object

Create a new Unicode object from the given encoded string. encoding defaults to the current default string encoding. errors can be strict, replace or ignore and defaults to strict.

Compiled regular expression objects

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.

Returns the end of this inline using the given recogniseInfo.

tuple() -> an empty tuple tuple(sequence) -> tuple initialized from sequence's items

If the argument is a tuple, the return value is the same object.