-Ph} dZddlmZddlmZmZddlmZmZddl m Z er ddl m Z ddl mZGdd eZGd d eZd S) zDomain indices.) annotations)ABCabstractmethod) TYPE_CHECKING NamedTuple) SphinxError)Iterable)DomaincZeZdZUdZded<ded<ded<ded<ded<ded <ded <d S) IndexEntryzAn index entry. .. note:: The *qualifier* and *description* are not rendered for some output formats, such as LaTeX. strnameintsubtypedocnameanchorextra qualifierdescrN)__name__ __module__ __qualname____doc____annotations__U/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/sphinx/domains/_index.pyr r sgIIILLLLLLKKKJJJNNNJJJJJrr cZeZdZUdZded<ded<dZded<dd Ze dddZdS)IndexaAn Index is the description for a domain-specific index. To add an index to a domain, subclass Index, overriding the three name attributes: * `name` is an identifier used for generating file names. It is also used for a hyperlink target for the index. Therefore, users can refer the index page using ``ref`` role and a string which is combined domain name and ``name`` attribute (ex. ``:ref:`py-modindex```). * `localname` is the section title for the index. * `shortname` is a short name for the index, for use in the relation bar in HTML output. Can be empty to disable entries in the relation bar. and providing a :meth:`generate` method. Then, add the index class to your domain's `indices` list. Extensions can add indices to existing domains using :meth:`~sphinx.application.Sphinx.add_index_to_domain`. .. versionchanged:: 3.0 Index pages can be referred by domain name and index name via :rst:role:`ref` role. r r localnameNz str | None shortnamedomainr returnNonecn|jr|jd|jjd}t |||_dS)NzIndex subclass z has no valid name or localname)rr __class__rrr")selfr"msgs r__init__zIndex.__init__PsAy #DN2\DN$;\\\Cc"" " rdocnamesIterable[str] | None/tuple[list[tuple[str, list[IndexEntry]]], bool]ct)aGet entries for the index. If ``docnames`` is given, restrict to entries referring to these docnames. The return value is a tuple of ``(content, collapse)``: ``collapse`` A boolean that determines if sub-entries should start collapsed (for output formats that support collapsing sub-entries). ``content``: A sequence of ``(letter, entries)`` tuples, where ``letter`` is the "heading" for the given ``entries``, usually the starting letter, and ``entries`` is a sequence of single entries. Each entry is an :py:class:`IndexEntry`. )NotImplementedError)r'r*s rgeneratezIndex.generateVs *"!r)r"r r#r$)N)r*r+r#r,) rrrrrr!r)rr/rrrrr6s*IIINNN I     /3""""^"""rrN)r __future__rabcrrtypingrr sphinx.errorsrcollections.abcr sphinx.domainsr r rrrrr6s""""""########,,,,,,,,%%%%%%&((((((%%%%%%########L5"5"5"5"5"C5"5"5"5"5"r