-Ph3 dZddlmZddlZddlmZddlmZddlm Z m Z erddl m Z ddlm Z dd lmZd dd d d d!dZejd"dZd#d ZdS)$z,Docutils utility functions for parsing text.) annotationsN) TYPE_CHECKING)Element) StringList string2lines)Iterator)Node)RSTStatezTF)sourceoffsetallow_section_headingskeep_title_contextstater textstr | StringListr strr intr boolrreturn list[Node]c8|j}t|||jj}t }||_|r|||||n@t |5|||||dddn #1swxYwY|jS)aParse *text* into nodes. :param state: The state machine state. Must be a subclass of ``RSTState``. :param text: Text, in string form. ``StringList`` is also accepted. :param source: The text's source, used when creating a new ``StringList``. :param offset: The offset of the content. :param allow_section_headings: Are titles (sections) allowed in *text*? Note that this option bypasses Docutils' usual checks on doctree structure, and misuse of this option can lead to an incoherent doctree. In Docutils, section nodes should only be children of ``Structural`` nodes, which includes ``document``, ``section``, and ``sidebar`` nodes. :param keep_title_context: If this is False (the default), then *content* is parsed as if it were an independent document, meaning that title decorations (e.g. underlines) do not need to match the surrounding document. This is useful when the parsed content comes from a completely different context, such as docstrings. If this is True, then title underlines must match those in the surrounding document, otherwise the behaviour is undefined. .. versionadded:: 7.4 )r tab_width) match_titlesN)document_text_to_string_listsettingsrr nested_parse_fresh_title_style_contextchildren) rrr r r rrcontentnodes S/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/sphinx/util/parsing.pynested_parse_to_nodesr#sJ~H" Vx'8'BG 99DDM 7FD?UVVVV ' . .     4J                    =s$B  BBIterator[None]c#K|j}|j}|j}g|_d|_ dV||_||_dS#||_||_wxYw)Nr)memo title_styles section_level)rr&surrounding_title_stylessurrounding_section_levels r"rrHsv :D<@r9s22"""""" """"""::::::::5((((((######444444%#'$333333l  7 7 7 7 ......r.