Na}{

File Content: extlinks.cpython-310.pyc

�����$�a�
����������������������@���s����d�Z�ddlZddlmZmZmZmZ�ddlmZm	Z	�ddl
mZmZ�ddl
mZ�ddlZddlmZ�ddlmZ�dd	lmZ�dd
lmZ�deded
edefdd�Zdeddfdd�Zdedeeef�fdd�ZdS�)a���
    sphinx.ext.extlinks
    ~~~~~~~~~~~~~~~~~~~

Extension to save typing and prevent hard-coding of base URLs in the reST
    files.

This adds a new config value called ``extlinks`` that is created like this::

extlinks = {'exmpl': ('https://example.invalid/%s.html', caption), ...}

Now you can use e.g. :exmpl:`foo` in your documents.  This will create a
    link to ``https://example.invalid/foo.html``.  The link caption depends on
    the *caption* value given:

- If it is ``None``, the caption will be the full URL.
    - If it is a string, it must contain ``%s`` exactly once.  In this case the
      caption will be *caption* with the role content substituted for ``%s``.

You can also give an explicit caption, e.g. :exmpl:`Foo <foo>`.

Both, the url string and the caption string must escape ``%`` as ``%%``.

:copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
    :license: BSD, see LICENSE for details.
�����N)�Any�Dict�List�Tuple)�nodes�utils)�Node�system_message)�Inliner)�Sphinx)�RemovedInSphinx60Warning)�split_explicit_title)�RoleFunction�name�base_url�caption�returnc��������������������s����z��d��W�n�t�tfy���t�dt�����dd�d���Y�nw��d�urDz�d��W�n�t�tfyC���t�dt����dd�d��Y�nw�i�g�fdtdtd	td
tdtdt	d
t
t�dtt
t�t
t
�f�f���fdd�
}|S�)N�dummyztextlinks: Sphinx-6.0 will require base URL to contain exactly one '%s' and all other '%' need to be escaped as '%%'.�%z%%z%sz|extlinks: Sphinx-6.0 will require a caption string to contain exactly one '%s' and all other '%' need to be escaped as '%%'.�typ�rawtext�text�lineno�inliner�options�contentr���c��������������������sV���t��|�}t|�\}}}	��|	�}
|s�d�u�r|
}n�|	�}tj||d|
d�}|gg�fS�)NF)�internal�refuri)r����unescaper
���r����	reference)r���r���r���r���r���r���r����has_explicit_title�title�part�full_url�pnode�r���r������5/usr/lib/python3/dist-packages/sphinx/ext/extlinks.py�role@���s���

zmake_link_role.<locals>.role)�	TypeError�
ValueError�warnings�warnr����replace�str�intr
���r���r���r���r���r	���)r���r���r���r(���r&���r%���r'����make_link_role*���s8������������
r0����appc�����������������C���s2���|�j�j���D�]\}\}}|��|t|||���qd�S�)N)�config�extlinks�items�add_roler0���)r1���r���r���r���r&���r&���r'����setup_link_rolesP���s����r6���c�����������������C���s&���|���di�d��|��dt��tjdd�S�)Nr3����envzbuilder-initedT)�version�parallel_read_safe)�add_config_value�connectr6����sphinx�__display_version__)r1���r&���r&���r'����setupU���s���r>���)�__doc__r+����typingr���r���r���r����docutilsr���r����docutils.nodesr���r	����docutils.parsers.rst.statesr
���r<����sphinx.applicationr����sphinx.deprecationr����sphinx.util.nodesr
����sphinx.util.typingr���r.���r0���r6���r>���r&���r&���r&���r'����<module>���s����&

Name	Size	Permission
__init__.cpython-310.pyc	359 bytes	0644
apidoc.cpython-310.pyc	14328 bytes	0644
autosectionlabel.cpython-310.pyc	2223 bytes	0644
coverage.cpython-310.pyc	8869 bytes	0644
doctest.cpython-310.pyc	16739 bytes	0644
duration.cpython-310.pyc	3856 bytes	0644
extlinks.cpython-310.pyc	3370 bytes	0644
githubpages.cpython-310.pyc	1361 bytes	0644
graphviz.cpython-310.pyc	12436 bytes	0644
ifconfig.cpython-310.pyc	3146 bytes	0644
imgconverter.cpython-310.pyc	2792 bytes	0644
imgmath.cpython-310.pyc	11095 bytes	0644
inheritance_diagram.cpython-310.pyc	14355 bytes	0644
intersphinx.cpython-310.pyc	16690 bytes	0644
linkcode.cpython-310.pyc	2163 bytes	0644
mathjax.cpython-310.pyc	4317 bytes	0644
todo.cpython-310.pyc	8325 bytes	0644
viewcode.cpython-310.pyc	9766 bytes	0644