class documentation

class JavaScriptDomain(Domain):

View In Hierarchy

JavaScript language domain.
Method clear​_doc Remove traces of a document in the domain-specific inventories.
Method find​_obj Undocumented
Method get​_full​_qualified​_name Return full qualified name for given node.
Method get​_objects Return an iterable of "object descriptions".
Method merge​_domaindata Merge in data regarding docnames from a different domaindata inventory (coming from a subprocess in parallel builds).
Method note​_module Undocumented
Method note​_object Undocumented
Method resolve​_any​_xref Resolve the pending_xref node with the given target.
Method resolve​_xref Resolve the pending_xref node with the given typ and target.
Class Variable directives Undocumented
Class Variable initial​_data Undocumented
Class Variable label Undocumented
Class Variable name Undocumented
Class Variable object​_types Undocumented
Class Variable roles Undocumented
Property modules Undocumented
Property objects Undocumented

Inherited from Domain:

Method add​_object​_type Add an object type.
Method check​_consistency Do consistency checks (experimental).
Method directive Return a directive adapter class that always gives the registered directive its full name ('domain:name') as self.name.
Method get​_enumerable​_node​_type Get type of enumerable nodes (experimental).
Method get​_type​_name Return full name for given ObjType.
Method process​_doc Process a document after it is read by the environment.
Method process​_field​_xref Process a pending xref created in a doc field. For example, attach information about the current scope.
Method role Return a role adapter function that always gives the registered role its full name ('domain:name') as the first argument.
Method setup Set up domain object.
Class Variable dangling​_warnings Undocumented
Class Variable data​_version Undocumented
Class Variable enumerable​_nodes Undocumented
Instance Variable data Undocumented
Instance Variable indices Undocumented
Method __init__ Undocumented
Instance Variable ​_directive​_cache Undocumented
Instance Variable ​_role2type Undocumented
Instance Variable ​_role​_cache Undocumented
Instance Variable ​_type2role Undocumented
Instance Variable env Undocumented
Instance Variable objtypes​_for​_role Undocumented
Instance Variable role​_for​_objtype Undocumented
def clear_doc(self, docname):
Remove traces of a document in the domain-specific inventories.
Parameters
docname:strUndocumented
def find_obj(self, env, mod_name, prefix, name, typ, searchorder=0):

Undocumented

Parameters
env:BuildEnvironmentUndocumented
mod​_name:strUndocumented
prefix:strUndocumented
name:strUndocumented
typ:strUndocumented
searchorder:intUndocumented
Returns
Tuple[str, Tuple[str, str, str]]Undocumented
def get_full_qualified_name(self, node):
Return full qualified name for given node.
Parameters
node:ElementUndocumented
Returns
strUndocumented
def get_objects(self):

Return an iterable of "object descriptions".

Object descriptions are tuples with six items:

name
Fully qualified name.
dispname
Name to display when searching/linking.
type
Object type, a key in self.object_types.
docname
The document where it is to be found.
anchor
The anchor name for the object.
priority

How "important" the object is (determines placement in search results). One of:

1
Default priority (placed before full-text matches).
0
Object is important (placed before default-priority objects).
2
Object is unimportant (placed after full-text matches).
-1
Object should not show up in search at all.
Returns
Iterator[Tuple[str, str, str, str, str, int]]Undocumented
def merge_domaindata(self, docnames, otherdata):
Merge in data regarding docnames from a different domaindata inventory (coming from a subprocess in parallel builds).
Parameters
docnames:List[str]Undocumented
otherdata:DictUndocumented
def note_module(self, modname, node_id):

Undocumented

Parameters
modname:strUndocumented
node​_id:strUndocumented
def note_object(self, fullname, objtype, node_id, location=None):

Undocumented

Parameters
fullname:strUndocumented
objtype:strUndocumented
node​_id:strUndocumented
location:AnyUndocumented
def resolve_any_xref(self, env, fromdocname, builder, target, node, contnode):

Resolve the pending_xref node with the given target.

The reference comes from an "any" or similar role, which means that we don't know the type. Otherwise, the arguments are the same as for resolve_xref.

The method must return a list (potentially empty) of tuples ('domain:role', newnode), where 'domain:role' is the name of a role that could have created the same reference, e.g. 'py:func'. newnode is what resolve_xref would return.

New in version 1.3.
Parameters
env:BuildEnvironmentUndocumented
fromdocname:strUndocumented
builder:BuilderUndocumented
target:strUndocumented
node:pending_xrefUndocumented
contnode:ElementUndocumented
Returns
List[Tuple[str, Element]]Undocumented
def resolve_xref(self, env, fromdocname, builder, typ, target, node, contnode):

Resolve the pending_xref node with the given typ and target.

This method should return a new node, to replace the xref node, containing the contnode which is the markup content of the cross-reference.

If no resolution can be found, None can be returned; the xref node will then given to the :event:`missing-reference` event, and if that yields no resolution, replaced by contnode.

The method can also raise sphinx.environment.NoUri to suppress the :event:`missing-reference` event being emitted.

Parameters
env:BuildEnvironmentUndocumented
fromdocname:strUndocumented
builder:BuilderUndocumented
typ:strUndocumented
target:strUndocumented
node:pending_xrefUndocumented
contnode:ElementUndocumented
Returns
Optional[Element]Undocumented
directives =

Undocumented

initial_data: Dict[str, Dict[str, Tuple[str, str]]] =

Undocumented

label: str =

Undocumented

name: str =

Undocumented

object_types =

Undocumented

roles =

Undocumented

@property
modules: Dict[str, Tuple[str, str]] =

Undocumented

@property
objects: Dict[str, Tuple[str, str, str]] =

Undocumented