Home | Trees | Index | Help |
|
---|
|
|
|||
__init__(self,
docindex,
**kwargs)
Construct a new HTML writer, using the given documentation index. |
|||
string
|
_find_top_page(self,
pagename)
Find the top page for the API documentation. |
||
1. Interface Methods | |||
---|---|---|---|
None
|
write(self,
directory=None)
Write the documentation to the given directory. |
||
_write(self, write_func, directory, filename, *args) | |||
None
|
_mkdir(self,
directory)
If the given directory does not exist, then attempt to create it. |
||
2.1. Module Pages | |||
write_module(self,
out,
doc)
Write an HTML page containing the API documentation for the given module to out .
|
|||
2.??. Source Code Pages | |||
write_sourcecode(self, out, doc) | |||
2.2. Class Pages | |||
write_class(self,
out,
doc)
Write an HTML page containing the API documentation for the given class to out .
|
|||
2.3. Trees page | |||
write_trees(self,
out)
Write an HTML page containing the module and class hierarchies to the given streams. |
|||
2.4. Indices page | |||
write_indices(self,
out)
Write an HTML page containing the term and identifier indices to the given streams. |
|||
write_identifier_index_header(self, out) | |||
write_identifier_index(self, out, index) | |||
write_term_index(self, out, index) | |||
2.5. Help Page | |||
write_help(self,
out)
Write an HTML help file to the given stream. |
|||
2.6. Frames-based Table of Contents | |||
write_frames_index(self,
out)
Write the frames index file for the frames-based table of contents to the given streams. |
|||
write_toc(self, out) | |||
write_toc_section(self, out, name, docs, fullname=True) | |||
write_project_toc(self, out) | |||
write_module_toc(self,
out,
doc)
Write an HTML page containing the table of contents page for the given module to the given streams. |
|||
2.7. Project homepage (index.html) | |||
write_homepage(self,
directory)
Write an index.html file in the given directory.
|
|||
write_redirect_index(self, out, top, name) | |||
2.8. Stylesheet (epydoc.css) | |||
None
|
write_css(self,
directory,
cssname)
Write the CSS stylesheet in the given directory. |
||
2.9. Javascript (epydoc.js) | |||
write_javascript(self, directory) | |||
2.10. Graphs | |||
render_graph(self, graph, css='graph-without-title') | |||
render_callgraph(self, callgraph) | |||
callgraph_link(self, callgraph) | |||
3.1. Page Header | |||
write_header(self,
out,
title)
Generate HTML code for the standard page header, and write it to out .
|
|||
3.2. Page Footer | |||
write_footer(self,
out,
short=False)
Generate HTML code for the standard page footer, and write it to out .
|
|||
3.3. Navigation Bar | |||
write_navbar(self,
out,
context)
Generate HTML code for the navigation bar, and write it to out .
|
|||
3.4. Breadcrumbs | |||
write_breadcrumbs(self,
out,
context,
context_url)
Generate HTML for the breadcrumbs line, and write it to out .
|
|||
breadcrumbs(self, doc) | |||
_crumb(self, doc) | |||
3.5. Summary Tables | |||
write_summary_table(self,
out,
heading,
doc,
value_type)
Generate HTML code for a summary table, and write it to out .
|
|||
write_summary_group(self, out, doc, name, var_docs, grouped_inh_vars) | |||
write_inheritance_list(self, out, doc, listed_inh_vars) | |||
write_var_list(self, out, vardocs) | |||
write_summary_line(self,
out,
var_doc,
container)
Generate HTML code for a single line of a summary table, and write it to out .
|
|||
write_function_summary_line(self,
out,
var_doc,
tr_class,
summary)
Generate HTML code for a single line of a summary table, describing a variable whose value is a function, and write it to out .
|
|||
write_variable_summary_line(self, out, var_doc, tr_class, summary) | |||
3.6. Details Lists | |||
write_details_list(self, out, heading, doc, value_type) | |||
write_details_entry(self, out, var_doc) | |||
labelled_list_item(self, lhs, rhs) | |||
property_accessor_to_html(self, val_doc) | |||
arg_name_to_html(self,
func_doc,
arg_name)
A helper function used to format an argument name, for use in the argument description list under a routine's details entry. |
|||
write_function_details_entry(self, out, var_doc, descr, callgraph, rtype, rdescr, arg_descrs, div_class) | |||
write_property_details_entry(self, out, var_doc, descr, accessors, div_class) | |||
write_variable_details_entry(self, out, var_doc, descr, div_class) | |||
variable_tooltip(self, var_doc) | |||
pprint_value(self, val_doc, multiline=True, summary_linelen=0) | |||
pprint_pyval(self, pyval, multiline=True, summary_linelen=0) | |||
_linewrap_html(self,
s,
linelen,
maxlines)
Add line-wrapping to the HTML string s .
|
|||
Base Tree | |||
string
|
base_tree(self, doc, width=None, postfix='', context=None) | ||
int
|
find_tree_width(self,
doc,
context)
Helper function for base_tree. |
||
contextual_label(self,
doc,
context)
Return the label for doc to be shown in
context .
|
|||
Function Signatures | |||
function_signature(self, api_doc, css_class='sig', link_name=False) | |||
func_arg(self, name, default, css_class) | |||
_arg_name(self, arg) | |||
Import Lists | |||
write_imports(self, out, doc) | |||
_import(self, var_doc, context) | |||
Module Trees | |||
write_module_tree(self, out) | |||
write_module_list(self, out, doc) | |||
write_module_tree_item(self, out, doc, package=None) | |||
Class trees | |||
write_class_tree(self,
out)
Write HTML code for a nested list showing the base/subclass relationships between all documented classes. |
|||
write_class_tree_item(self, out, doc, class_set) | |||
Standard Fields | |||
write_standard_fields(self,
out,
doc)
Write HTML code containing descriptions of any standard markup fields that are defined by the given APIDoc object (such as @author and @todo fields).
|
|||
write_standard_field(self, out, doc, field, descrs, arg='') | |||
Term index generation | |||
_get_index_terms(self,
parsed_docstring,
link,
terms,
links)
A helper function for _extract_term_index. |
|||
_term_index_to_anchor(self,
term)
Given the name of an inline index item, construct a URI anchor. |
|||
list of (string, ParsedDocstring, list of
ValueDoc)
|
_extract_term_index(self)
Extract the set of terms that should be indexed from all documented docstrings. |
||
Helper functions | |||
write_table_header(self, out, css_class, heading=None, private_link=True) | |||
write_group_header(self, out, group, tr_class='') | |||
url(self,
obj)
Return the URL for the given object, which can be a VariableDoc , a ValueDoc , or a
DottedName .
|
|||
pysrc_link(self, api_doc) | |||
pysrc_url(self, api_doc) | |||
href(self,
target,
label=None,
css_class=None,
context=None)
Return the HTML code for an HREF link to the given target (which can be a VariableDoc , a ValueDoc , or a
DottedName .
|
|||
summary(self, api_doc, indent=0) | |||
descr(self, api_doc, indent=0) | |||
type_descr(self, api_doc, indent=0) | |||
rtype(self, api_doc, indent=0) | |||
return_descr(self, api_doc, indent=0) | |||
docstring_to_html(self, parsed_docstring, where=None, indent=0) | |||
description(self, parsed_docstring, where=None, indent=0) | |||
doc_kind(self, doc) | |||
_doc_or_ancestor_is_private(self, api_doc) |
|
|||
2.9. Javascript (epydoc.js) | |||
---|---|---|---|
TOGGLE_PRIVATE_JS | A javascript that is used to show or hide the API documentation for private objects. | ||
GET_COOKIE_JS | A javascript that is used to read the value of a cookie. | ||
SET_FRAME_JS | A javascript that is used to set the contents of two frames at once. | ||
HIDE_PRIVATE_JS | A javascript that is used to hide private variables, unless either: (a) the cookie says not to; or (b) we appear to be linking to a private variable. | ||
TOGGLE_CALLGRAPH_JS | |||
3.6. Details Lists | |||
SPECIAL_METHODS | |||
_variable_linelen | Max line length for variable values | ||
_variable_maxlines | Max lines for variable values | ||
_variable_tooltip_linelen | Max length for variable tooltips | ||
Helper functions | |||
TABLE_FOOTER | |||
PRIVATE_LINK |
|
|||
_show_private | Should private docs be included? | ||
_prj_name | The project's name (for the project link in the navbar) | ||
_prj_url | URL for the project link in the navbar | ||
_prj_link | HTML code for the project link in the navbar | ||
_top_page | The 'main' page | ||
_css | CSS stylesheet to use | ||
_helpfile | Filename of file to extract help contents from | ||
_frames_index | Should a frames index be created? | ||
_show_imports | Should imports be listed? | ||
_propfunc_linelen | [XXX] Not used! | ||
_variable_summary_linelen | Max length for variable value summaries | ||
_inheritance | How should inheritance be displayed? 'listed', 'included', or 'grouped' | ||
_incl_sourcecode | Should pages be generated for source code of modules? | ||
_mark_docstrings | Wrap <span class='docstring'>...</span> around docstrings? | ||
_graph_types | Graphs that we should include in our output. | ||
module_list | The list of ModuleDocs for the documented modules. | ||
module_set | The set of ModuleDocs for the documented modules. | ||
class_list | The list of ClassDocs for the documented classes. | ||
class_set | The set of ClassDocs for the documented classes. | ||
routine_list | The list of RoutineDocs for the documented routines. | ||
indexed_docs | The list of APIDocs for variables and values that should be included in the index. |
|
|
index.html .
|
|
|
|
out .
|
|
out .
|
|
|
|
|
|
self._helpfile contains a help file, then use it; otherwise,
use the default helpfile from epydoc.docwriter.html_help.
|
|
|
|
|
|
index.html file in the given directory. The
contents of this file are copied or linked from an existing page, so this
method must be called after all pages have been written. The page used
is determined by _frames_index and _top_page:
|
|
cssname contains a stylesheet file or name (from epydoc.docwriter.html_css), then use that stylesheet;
otherwise, use the default stylesheet.
|
|
|
|
|
out . title is a string containing the page
title. It should be appropriately escaped/encoded.
|
out .
|
out . The navigation bar typically looks like:
[ Home Trees Index Help Project ]
|
out . The breadcrumbs line is an invisible table with a list
of pointers to the current object's ancestors on the left; and the
show/hide private selector and the frames/noframes selector on the
right.
|
|
|
out . A summary table is a table that includes a one-row
description for each variable (of a given type) in a module or class.
|
|
|
|
out . See write_summary_table for more information.
|
out .
|
|
|
|
|
|
|
|
|
|
|
|
|
s . Line length is
determined by linelen ; and the maximum number of lines to
display is determined by maxlines . This function treats
HTML entities (e.g., & ) as single characters; and
ignores HTML tags (e.g., <p> ).
|
|
|
doc to be shown in
context .
|
|
|
|
|
|
|
|
|
|
|
@author and
@todo fields).
|
|
A helper function for _extract_term_index. For each index term t with key k inparsed_docstring , modify
terms and links as follows:
|
|
(key, term, [links]) . This list is used by write_indices() to construct the term index.
|
|
|
VariableDoc , a ValueDoc , or a
DottedName .
|
|
|
VariableDoc , a ValueDoc , or a
DottedName . If a NamespaceDoc
context is specified, the target label is contextualized to
it.
|
|
|
|
|
|
|
|
|
|
|
TOGGLE_PRIVATE_JSA javascript that is used to show or hide the API documentation for private objects. In order for this to work correctly, all documentation for private objects should be enclosed in<div
class="private">...</div> elements.
|
GET_COOKIE_JSA javascript that is used to read the value of a cookie. This is used to remember whether private variables should be shown or hidden.
|
SET_FRAME_JSA javascript that is used to set the contents of two frames at once. This is used by the project table-of-contents frame to set both the module table-of-contents frame and the main frame when the user clicks on a module.
|
HIDE_PRIVATE_JSA javascript that is used to hide private variables, unless either: (a) the cookie says not to; or (b) we appear to be linking to a private variable.
|
TOGGLE_CALLGRAPH_JS
|
SPECIAL_METHODS
|
_variable_linelenMax line length for variable values
|
_variable_maxlinesMax lines for variable values
|
_variable_tooltip_linelenMax length for variable tooltips
|
TABLE_FOOTER
|
PRIVATE_LINK
|
|
_show_privateShould private docs be included? |
_prj_nameThe project's name (for the project link in the navbar) |
_prj_urlURL for the project link in the navbar |
_prj_linkHTML code for the project link in the navbar |
_top_pageThe 'main' page |
_cssCSS stylesheet to use |
_helpfileFilename of file to extract help contents from |
_frames_indexShould a frames index be created? |
_show_importsShould imports be listed? |
_propfunc_linelen[XXX] Not used! |
_variable_summary_linelenMax length for variable value summaries |
_inheritanceHow should inheritance be displayed? 'listed', 'included', or 'grouped' |
_incl_sourcecodeShould pages be generated for source code of modules? |
_mark_docstringsWrap <span class='docstring'>...</span> around docstrings? |
_graph_typesGraphs that we should include in our output. |
module_listThe list of ModuleDocs for the documented modules. |
module_setThe set of ModuleDocs for the documented modules. |
class_listThe list of ClassDocs for the documented classes. |
class_setThe set of ClassDocs for the documented classes. |
routine_listThe list of RoutineDocs for the documented routines. |
indexed_docsThe list of APIDocs for variables and values that should be included in the index. |
Home | Trees | Index | Help |
|
---|
Generated by Epydoc 3.0alpha2 on Tue Apr 11 17:34:56 2006 | http://epydoc.sf.net |