Package epydoc :: Package markup :: Class DocstringLinker

Class DocstringLinker

A translator for crossreference links into and out of a ParsedDocstring. DocstringLinker is used by ParsedDocstring to convert these crossreference links into appropriate output formats. For example, DocstringLinker.to_html expects a DocstringLinker that converts crossreference links to HTML.

Instance Methods

[hide private]

string

translate_identifier_xref(self, identifier, label=None)
Translate a crossreference link to a Python identifier to the appropriate output format.

source code

string

translate_indexterm(self, indexterm)
Translate an index term to the appropriate output format.

source code

Method Details

[hide private]

translate_identifier_xref(self, identifier, label=None)

source code

Translate a crossreference link to a Python identifier to the appropriate output format. The output will typically include a reference or pointer to the crossreference target.

Parameters:

identifier (string) - The name of the Python identifier that should be linked to.
label (string or None) - The label that should be used for the identifier, if it's different from the name of the identifier.

Returns: string

The translated crossreference link.

translate_indexterm(self, indexterm)

source code

Translate an index term to the appropriate output format. The output will typically include a crossreference anchor.

Parameters:

indexterm (ParsedDocstring) - The index term to translate.

Returns: string

The translated index term.