| Server IP : 127.0.0.1 / Your IP : 216.73.216.109 Web Server : Apache/2.4.54 (Win64) OpenSSL/1.1.1q PHP/8.1.10 System : Windows NT DESKTOP-E5T4RUN 10.0 build 19045 (Windows 10) AMD64 User : SERVERWEB ( 0) PHP Version : 8.1.10 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : OFF | Perl : OFF | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : C:/cygwin64/lib/python3.9/site-packages/sphinx/builders/html/__pycache__/ |
Upload File : |
a
�abG� � @ s� d Z ddlZddlZddlZddlZddlZddlmZ ddlmZ ddlm Z m
Z
m Z m Z m
Z
mZmZmZmZ ddlmZ ddlmZ ddlmZ dd lmZ dd
lmZm Z dd l m Z dd l m Z dd
l!m"Z"m#Z# ddl!m$Z% ddl&m'Z' ddl(m)Z) ddl*m+Z+m,Z, ddl-m.Z.m/Z/m0Z0 ddl1m2Z2 ddl3m4Z4 ddl5m6Z6 ddl7m8Z8m9Z9 ddl:m;Z; ddl<m=Z=m>Z> ddl?m@Z@ ddlAmBZB ddlCmDZDmEZEmFZFmGZGmHZH dd lImJZJmKZK dd lLmMZM dd lNmOZO dd lPmQZQ dd lRmSZSmTZTmUZU dd!lVmWZWmXZXmYZYmZZZ dd"l[m\Z\ dd#l]m^Z^m_Z_ eJ� �r:dd$l`maZa d%Zbnd&Zbd'ZceE�dee�Zfe�gd(�Zhe
eid)�d*d+�ZjG d,d-� d-ei�ZkG d.d/� d/ei�ZlG d0d1� d1�ZmG d2d3� d3e)�Zne'e,dd4�d5d6�Zoe'e,dd4�d7d8�Zpe'eieie e dd9�d:d;�Zqe'eieie e dd9�d<d=�Zre'eieie e dd9�d>d?�Zse'dd@�dAdB�Zte'e,dd4�dCdD�Zue'e,dd4�dEdF�Zve'e,dd4�dGdH�Zwe'e,dd4�dIdJ�ZxG dKdL� dL�Zyey� Zze'e,dd4�dMdN�Z{ddl|Z}ddl~Z!ddlZ!e'e eie
f d@�dOdP�Z�dS )Qz�
sphinx.builders.html
~~~~~~~~~~~~~~~~~~~~
Several HTML builders.
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�datetime)�path) �IO�Any�Dict�Iterable�Iterator�List�Set�Tuple�Type)�quote)�nodes)�
publish_parts)� OptionParser)� DocTreeInput� StringOutput)�Node)�
relative_path)�__display_version__� package_dir)� version_info)�Sphinx)�Builder)�ENUM�Config)�Domain�Index�
IndexEntry)� ImageAdapter)� IndexEntries)�TocTree)� ConfigError�
ThemeError)�PygmentsBridge)�_�__)�js_index)�HTMLThemeFactory)�isurl�logging�md5�progress_message�status_iterator)�is_html5_writer_available� new_document)�
copy_asset)� format_date)�
InventoryFile)�DOTFILES�Matcher�patmatch)�copyfile� ensuredir�os_path� relative_uri)�Tags)�HTMLTranslator�
HTMLWriter)�HTML5TranslatorTFz objects.invz[
]+)�obj�returnc C sN t | t�rtt| �� ��S t | ttf�r:tdd� | D ��} tt| �� � ��
� S )z�
Return a stable hash for a Python data structure. We can't just use
the md5 of str(obj) since for example dictionary items are enumerated
in unpredictable order due to hash randomization in newer Pythons.
c s s | ]}t |�V qd S �N)�get_stable_hash)�.0�o� rD �A/usr/lib/python3.9/site-packages/sphinx/builders/html/__init__.py� <genexpr>K � z"get_stable_hash.<locals>.<genexpr>) �
isinstance�dictrA �list�items�tuple�sortedr+ �str�encodeZ hexdigest)r> rD rD rE rA B s
rA c @ sZ e Zd ZU dZdZeeef ed< dZeed< dZ e
ed< dd�eee
e d d�d d
�Z dS ) �
Stylesheetz�A metadata of stylesheet.
To keep compatibility with old themes, an instance of stylesheet behaves as
its filename (str).
N�
attributes�filename�priority�� �rS )rR �argsrS rQ r? c O s^ t �| |�}||_||_||_|j�dd� |j�dd� |rZ|d |jd< |d |jd< |S )N�rel�
stylesheet�typeztext/cssr � �title)rN �__new__rR rS rQ �
setdefault)�clsrR rS rV rQ �selfrD rD rE r\ Z s zStylesheet.__new__)
�__name__�
__module__� __qualname__�__doc__rQ r rN �__annotations__rR rS �intr r\ rD rD rD rE rP O s
�rP c @ sT e Zd ZU dZdZeeef ed< dZeed< dZ e
ed< d
ee
ed d�dd �Z dS ) �
JavaScriptz�A metadata of javascript file.
To keep compatibility with old themes, an instance of javascript behaves as
its filename (str).
NrQ rR rS rT )rR rS rQ r? c K s" t �| |�}||_||_||_|S r@ )rN r\ rR rS rQ )r^ rR rS rQ r_ rD rD rE r\ t s
zJavaScript.__new__)rT ) r` ra rb rc rQ r rN rd rR rS re r\ rD rD rD rE rf i s
rf c @ sd e Zd ZdZeed d�dd��Zddg feee e
dd�dd�Z d e d �d
d �Z
edd�d d
�ZdS )� BuildInfoz�buildinfo file manipulator.
HTMLBuilder and its family are storing their own envdata to ``.buildinfo``.
This class is a manipulator for the file.
��fr? c
C s� zx|� � }|d �� dks J �|d �d�s0J �|d �d�sBJ �t� }|d �� d �� |_|d �� d �� |_|W S ty� } z t t
d�| �|�W Y d }~n
d }~0 0 d S ) Nr z # Sphinx build info version 1� zconfig: � ztags: rZ z build info file is broken: %r) � readlines�rstrip�
startswithrg �split�strip� config_hash� tags_hash� Exception�
ValueErrorr& )r^ ri �lines�
build_info�excrD rD rE �load� s zBuildInfo.loadN)�config�tags�config_categoriesr? c C sD d| _ d| _|r.dd� |�|�D �}t|�| _ |r@tt|��| _d S )N� c S s i | ]}|j |j�qS rD )�name�value)rB �crD rD rE �
<dictcomp>� rG z&BuildInfo.__init__.<locals>.<dictcomp>)rq rr �filterrA rM )r_ ry rz r{ �valuesrD rD rE �__init__� s
zBuildInfo.__init__)�otherr? c C s | j |j ko| j|jkS r@ )rq rr )r_ r� rD rD rE �__eq__� s
�zBuildInfo.__eq__c C s |� d| j| jf � d S )Nz�# Sphinx build info version 1
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
config: %s
tags: %s
)�writerq rr �r_ ri rD rD rE �dump� s
�zBuildInfo.dump)r` ra rb rc � classmethodr rx r r: r rN r� �boolr� r� rD rD rD rE rg } s rg c s@ e Zd ZU dZdZdZed�ZdZdZ dZ
dZ e Z
eed< dZdZg d�ZdZdZdZdZdZd ZdZd ZdZd
Z e ed < g Z e e e e!e" e e e e e# f e$f ed < e%d
d
�� fdd� Z&d
d�dd�Z'e(d�dd�Z)e d�dd�Z*e d�dd�Z+e e e,f d�dd�Z-d
d�dd �Z.d
d�d d �Z/d
d�d d �Z0e ed
d!�d"d#�Z1d
d�d$d%�Z2e ed
d!�d&d'�Z3e4e!e5j6 d�d(d)��Z7e4e d�d*d+��Z8e9e d�d,d-�Z:e e d�d.d/�Z;e<e,e e f d0�d1d2�Z=e>e d
d3�d4d5�Z?e e e e,e ef d6�d7d8�Z@e e5jAd
d9�d:d;�ZBe e5jAd
d9�d<d=�ZCd
d�d>d?�ZDeEed@��d
d�dAdB��ZFd
d�dCdD�ZGeEedE��d
d�dFdG��ZHd
d�dHdI�ZId
d�dJdK�ZJd
d�dLdM�ZKd
d�dNdO�ZLd
d�dPdQ�ZMd
d�dRdS�ZNd
d�dTdU�ZOe,d
dV�dWdX�ZPe,d
dV�dYdZ�ZQd
d�d[d\�ZRd
d�d]d^�ZSd
d�d_d`�ZTd
d�dadb�ZUd
d�dcdd�ZVd
d�dedf�ZWe<d
dg�dhdi�ZXeYe d
d3�djdk�ZZe e5jAe d
dl�dmdn�Z[d�e e$ee do�dpdq�Z\e e dr�dsdt�Z]e e,d
du�dvdw�Z^d�e e e dx�dydz�Z_d�e e,e e ed
d|�d}d~�Z`e e e,ed
d�d�d��Zad
d�d�d��ZbeEed���d
d�d�d���Zcd
d�d�d��Zd� ZeS )��StandaloneHTMLBuilderz&
Builds standalone HTML docs.
�htmlz!The HTML pages are in %(outdir)s.Tz.html�indexer_format)z
image/svg+xmlz image/pngz image/gifz
image/jpegzsearchindex.jsFN�imgpath�domain_indices��appr? c s t � �|� g | _g | _d S r@ )�superr� � css_files� script_files)r_ r� �� __class__rD rE r� � s z StandaloneHTMLBuilder.__init__)r? c C s� | � � | _d| _i | _d | _| �� | �� | �� | �� | � dd�}|d urV|| _
| � dd�}|d urr|| _ n| j
| _ | � dd�| _ d S )N�_images� file_suffixr� � link_suffix� use_index)
�create_build_inforv �imagedir�
secnumbers�current_docname�init_templates�init_highlighter�init_css_files�
init_js_files�get_builder_config�
out_suffixr� r� )r_ �html_file_suffix�html_link_suffixrD rD rE �init� s
zStandaloneHTMLBuilder.initc C s t | j| jdg�S )Nr� )rg ry rz �r_ rD rD rE r� � s z'StandaloneHTMLBuilder.create_build_infoc sb � fdd�� j jD �t�td� j jdd�t�tjd� j jd�g }|D ]}t�|�rF| S qFd S )Nc s g | ]}t �|� jjd d��qS )� LC_MESSAGES� sphinx.js)r �joinry �language)rB �dirr� rD rE �
<listcomp>� s � �z>StandaloneHTMLBuilder._get_translations_js.<locals>.<listcomp>�localer� r� zshare/sphinx/locale) ry Z locale_dirsr r� r r� �sys�prefix�isfile)r_ Z
candidates�jsfilerD r� rE �_get_translations_js� s
��
���
z*StandaloneHTMLBuilder._get_translations_jsc C s0 | j jd ur| j jS | jr(| j�dd�S dS d S )N�themerX z default.css)ry �
html_styler� �
get_configr� rD rD rE �_get_style_filename� s
z)StandaloneHTMLBuilder._get_style_filenamec C s | j j| j jfS r@ )ry �
html_theme�html_theme_optionsr� rD rD rE �get_theme_config s z&StandaloneHTMLBuilder.get_theme_configc C sH t | j�}| �� \}}|�|�| _|�� | _| �� | j� | | j� d S r@ )
r( r� r� Zcreater� �copy�
theme_optionsZcreate_template_bridge� templatesr� )r_ Z
theme_factoryZ themenameZ themeoptionsrD rD rE r� s
z$StandaloneHTMLBuilder.init_templatesc C s� | j jd ur| j j}n | jr.| j�ddd�}nd}td|�| _| jrV| j�ddd �}nd }|d ur�td|�| _| jjddd d
� nd | _d S ) Nr� �pygments_styleZnone�sphinxr� Zpygments_dark_style�pygments_dark.cssz (prefers-color-scheme: dark)Zpygments_dark_css)Zmedia�id) ry r� r� r� r$ � highlighter�dark_highlighterr� � add_css_file)r_ �styleZ
dark_stylerD rD rE r� s
�z&StandaloneHTMLBuilder.init_highlighterc C s� g | _ | jddd� | j| �� dd� | jjj D ]\}}| j|fi |�� q0| �dd�D ]&\}}|�dd� | j|fi |�� qXd S )N� pygments.css�� rU r� r� rS � )r� r� r� r� �registryr� r] �r_ rR �attrsrD rD rE r� ( s z$StandaloneHTMLBuilder.init_css_files)rR �kwargsr? c K s0 d|vrt �d|�}| j�t|fi |��� d S �N�://�_static)� posixpathr� r� �appendrP �r_ rR r� rD rD rE r� 4 s z"StandaloneHTMLBuilder.add_css_filec C s� g | _ | jddddd� | jddd� | jddd� | jd dd� | jjjD ]\}}| j|fi |�� qL| �d
d �D ]&\}}|�d d
� | j|fi |�� qt| jjr�| � � r�| �d� d S )Nzdocumentation_options.jsZdocumentation_optionsr| r� )r� �
data_url_rootrS z jquery.jsrU z
underscore.jsz doctools.js�js_filesr� rS r� �translations.js)
r� � add_js_filer� r� r� r� r] ry r� r� r� rD rD rE r� : s � z#StandaloneHTMLBuilder.init_js_filesc K s4 |rd|vrt �d|�}| j�t|fi |��� d S r� )r� r� r� r� rf r� rD rD rE r� L s z!StandaloneHTMLBuilder.add_js_filec C s t r | jjrtS tS d S r@ )� html5_readyry � html4_writerr; r= r� rD rD rE �default_translator_classR s z.StandaloneHTMLBuilder.default_translator_classc C s` | � dd�}|d ur|S t| jjj�}t|�dkr:|d S t|�dkrX|�d� |d S d S d S )NZ
math_rendererr� rZ r rj Zmathjax)r� rJ r� r� �html_inline_math_renderers�len�remove)r_ r} Z renderersrD rD rE �math_renderer_nameY s
z(StandaloneHTMLBuilder.math_renderer_namec c s� zht t�| jd���}t�|�}W d � n1 s40 Y | j|krft�d� | j j
E d H W d S W nD t y� } z t� t
d�|� W Y d }~nd }~0 ty� Y n0 | jr�| j�� }nd}| j j
D ]�}|| j jvr�t�d|� |V q�| �|�}zt�|�}W n t�y d}Y n0 z`tt�| j �|��|�}||k�r�t�d|t�|�t�|�|t�t�| j �|���� |V W q� t�y� Y q�0 q�d S )N�
.buildinfoz)[build target] did not match: build_info z"Failed to read build info file: %rr z![build target] did not in env: %rz>[build target] targetname %r(%s), template(%s), docname %r(%s))�openr r� �outdirrg rx rv �logger�debug�envZ
found_docsrt �warningr& �OSErrorr� Znewest_template_mtime�all_docs�get_outfilename�getmtimers �max�doc2pathr Zutcfromtimestamp) r_ �fpZ buildinforw Ztemplate_mtime�docnameZ
targetnameZ targetmtimeZsrcmtimerD rD rE �get_outdated_docsm sP (
$
�
�
z'StandaloneHTMLBuilder.get_outdated_docsc C s | j j| j j S r@ )ry �html_extra_path�html_static_pathr� rD rD rE �get_asset_paths� s z%StandaloneHTMLBuilder.get_asset_paths)�noder? c C s@ |du rddiS t d�}|�|� t| �}td|tddi|d�S ) z$Utility: Render a lone doctree node.N�fragmentr| z<partial node>�doctreeZoutput_encodingZunicode)Z reader_name�writerZ source_classZsettings_overrides�source)r/ r� r< r r )r_ r� �docr� rD rD rE �render_partial� s
�z$StandaloneHTMLBuilder.render_partial)�docnamesr? c C s� d | _ | jrTddlm} | jjp&| jj}|s0d}|| j|| jj| jj �| _ | �
|� t | �| _ t
| jj| j fdd��� | _t| jj�| j_g | _| jj}|�rt| jj�D ]h}| jj| }|jD ]P}d|j|jf }t|t�r�||vr�q�||�� � \} }
| r�| j� ||| |
f� q�q�| jj } | d u�rDt | �p4t d�| jjd�| _!nd | _!| jj"�pVd } | jj#�pdd }
t$| ��szt%�&| �} t$|
��s�t%�&|
�}
| j�'� | _(g }| j)�r�|� d
t d �d t d
�f� | jD ],\}}}}|j*�r�|� ||j+d |j*f� �q�t| j,�| _-t| j.�| _/| j0| jj1t2�3d | jj4�| jj5| j!| jj6| jj7| jj7| jj8| jj9| jj:| jj;| jj<| jj=| jj>| jj?| j@| jA| j,| jj| j.tBtC| �D� || jg | |
tE�o�| jjF d� | _G| jH�r�| jG�Idd� | jH�J| jK��L� D �� | jG�I| jjM� d S )Nr )� IndexBuilder�enT)�defaults�
componentsZread_config_filesz%s-%sz %b %d, %Y)r� r| �genindexz
General Index�I�index) �embedded�project�release�version� last_updated� copyrightZ
master_doc�root_docZuse_opensearchZ docstitleZ
shorttitleZshow_copyrightZ show_sphinxZ
has_sourceZ show_sourceZsourcelink_suffixr� r� r� r� r� �sphinx_versionZsphinx_version_tupler� �rellinks�builder�parents�logo�faviconZ
html5_doctypec s s | ]\}}d | |fV qdS )Ztheme_NrD )rB �key�valrD rD rE rF s z8StandaloneHTMLBuilder.prepare_writing.<locals>.<genexpr>)N�indexer�search�
sphinx.searchr� ry �html_search_languager� r� �html_search_options�html_search_scorer� load_indexerr< � docwriterr �settingsZget_default_values� docsettingsr� �html_compact_listsZ
compact_listsr� �html_domain_indicesrM Zdomains�indicesr} rH rJ Zgenerater� �html_last_updated_fmtr1 r% r � html_logo� html_faviconr) r �basenameZcollect_relations� relationsr� Z shortname� localnamer� �
_script_filesr� �
_css_filesr r �return_codes_re�subr r r r �html_use_opensearch�
html_title�html_short_title�html_show_copyright�html_show_sphinx�html_copy_source�html_show_sourcelink�html_sourcelink_suffixr� r� r r r� r� r� �
globalcontextr� �updateZ get_optionsr� rK � html_context)r_ r� r� �langZindices_configZ domain_name�domain�indexcls� indexname�content�collapseZlufmtr r
r Z_contentZ _collapserD rD rE �prepare_writing� s� �
�
�
�
�
� �z%StandaloneHTMLBuilder.prepare_writing)r� �body�metatagsr? c
C s` d }}g }| j d dd� }| j�|�}| jj} |r�|d r�zJ| �||d �| �| |d �d d�}|�|d |d dtd�f� W n t y� d}Y n0 |�r|d �rzJ| �||d �| �| |d �d d�}|�|d |d d td
�f� W n t �y d}Y n0 |�r�|d �r�z2|�| �||d �| �| |d �d d�� W n t �yj Y n0 | j�|d �}�q|�r�|�
� |� � | jj �|�}
|
�r�| �|
�d nd } | j�
|d
�t|�d� } | jj�r|| }
| | jjk�r|
| jj7 }
nd }
| jj�|�}t| j��|| �}| �|�d }|||| |||||
|| jj| dk| d� S )z1Collect items for the template context of a page.Nr rj r[ )�linkr[ �N�nextrZ �PZpreviousr r| Fr� ) r �prevr= r[ �metar9 r: r �
sourcename�tocZ display_tocZpage_source_suffix)r/ r! �getr� �titlesZget_relative_urir� r� r% �KeyError�pop�reverse�
longtitlesr� r� ry r, r. �metadatar! Z get_toc_forZtoc_num_entries)r_ r� r9 r: r? r= r r ZrelatedrD �
title_noder[ Z
source_suffixrA r@ Zself_tocrB rD rD rE �get_doc_context st �"
�"
��
�z%StandaloneHTMLBuilder.get_doc_context)r� r� r? c C s� t dd�}| j|_| jj�|i �| _| jj�|i �| _t | �
|�d�| _ t | �
|�d�| _ || _
| j�||� | j�� | jjd }| jj}| �|||�}| j|||d� d S )N�utf-8��encodingr� �
_downloadsr� )� event_arg)r r r r� Ztoc_secnumbersrC r� Ztoc_fignumbersZ
fignumbersr9 �get_target_urir� Zdlpathr� r r� Zassemble_parts�partsZ
clean_metarK � handle_page)r_ r� r� Z destinationr9 r: �ctxrD rD rE � write_doci s
z StandaloneHTMLBuilder.write_docc C sT t | �|�| j�| _| �|� | jj�|�}|r>| �|�d nd}| � |||� d S )Nr[ r| )
r9 rQ r� r� �post_process_imagesr� rH rC r� �
index_page)r_ r� r� rJ r[ rD rD rE �write_doc_serializedz s
z*StandaloneHTMLBuilder.write_doc_serializedc C s| | j �| j� | j �| j� | j �| j� | j �| j� | j �| j� | j �| j� | j �| j� | j �| j � | �
� d S r@ ) � finish_tasks�add_task� gen_indices�gen_pages_from_extensions�gen_additional_pages�copy_image_files�copy_download_files�copy_static_files�copy_extra_files�write_buildinfo�
handle_finishr� rD rD rE �finish� s z StandaloneHTMLBuilder.finishzgenerating indicesc C s | j r| �� | �� d S r@ )r� �write_genindex�write_domain_indicesr� rD rD rE r[ � s z!StandaloneHTMLBuilder.gen_indicesc C s4 | j �d�D ]"}|D ]\}}}| �|||� qq d S )N�html-collect-pages)Zevents�emitrS )r_ Zpagelist�pagename�context�templaterD rD rE r\ � s z/StandaloneHTMLBuilder.gen_pages_from_extensionszwriting additional pagesc C s� | j j�� D ](\}}tj|d dd� | �|i |� q | jrXtjddd� | �di d� | j jr�| jr�tjddd� t� | j
dd �}| jd
i d |d � d S ) N� T�Znonlzsearch r z search.htmlz opensearch r� zopensearch.xmlZ
opensearch)� outfilename) ry �html_additional_pagesrK r� �inforS r r' r r� r� )r_ ri rk �fnrD rD rE r] � s z*StandaloneHTMLBuilder.gen_additional_pagesc C s� t | j��| �}g }|D ] \}}|�tdd� |D ��� q||| jjd�}tjddd� | jjr�| � d|d� | � d |d
� t
||�D ],\\}}}||||d �}| � d | |d
� q�n| � d|d
� d S )Nc s s$ | ] \}\}}}d t |� V qdS )rZ N)r� )rB r% ZsubitemsrD rD rE rF � s �z7StandaloneHTMLBuilder.write_genindex.<locals>.<genexpr>)�genindexentriesZgenindexcountsZ split_indexz genindex Trm r� zgenindex-split.htmlz genindex-allz
genindex.html)r �entries�countrr z genindex-zgenindex-single.html) r r� Z create_indexr� �sumry �html_split_indexr� rp rS �zip) r_ r� Z indexcountsZ_krs Zgenindexcontextr rt rT rD rD rE re � s4 � ���� �z$StandaloneHTMLBuilder.write_genindexc C sF | j D ]:\}}}}|j||d�}tj|d dd� | �||d� qd S )N)Z
indextitler6 Zcollapse_indexrl Trm zdomainindex.html)r� r" r� rp rS )r_ r5 r4 r6 r7 Z indexcontextrD rD rE rf � s �z*StandaloneHTMLBuilder.write_domain_indicesc C s� | j r�t| jj�j}tt�| j| j �� t
| j t d�dt | j �| jj
|d�D ]v}| j | }z&tt�| j|�t�| j| j |�� W qL ty� } z(t�t d�t�| j|�|� W Y d }~qLd }~0 0 qLd S )Nzcopying images... �brown��stringify_funcz cannot copy image file %r: %s)�imagesr r� r� Zget_original_image_urir7 r r� r� r� r- r& r� � verbosityr6 �srcdirrs r� r� )r_ rz �src�dest�errrD rD rE r^ � s �
�
�z&StandaloneHTMLBuilder.copy_image_filesc s� t t d�� fdd� }� jjr�tt�� jd�� t� jjtd�dt � jj�� j
j |d�D ]�}zBt�� jd� jj| d �}tt� |�� t
t�� j|�|� W qV ty� } z(t�td �t�� j|�|� W Y d }~qVd }~0 0 qVd S )
Nrh c s t � j| �S r@ )r r} )ri r� rD rE �
to_relpath� s z=StandaloneHTMLBuilder.copy_download_files.<locals>.to_relpathrO z copying downloadable files... rx ry rZ z$cannot copy downloadable file %r: %s)rN r� Zdlfilesr7 r r� r� r- r& r� r� r| �dirnamer6 r} r� r� r� )r_ r� r~ r r� rD r� rE r_ � s �
�z)StandaloneHTMLBuilder.copy_download_filesc C s� t t�| jdd�d�� }|�| j�� � W d � n1 s<0 Y | jr�t t�| jdd�d�� }|�| j�� � W d � n1 s�0 Y dS )z!create a style file for pygments.r� r� �wNr� )r� r r� r� r� r� Zget_stylesheetr� r� rD rD rE �create_pygments_style_file� s
.z0StandaloneHTMLBuilder.create_pygments_style_filec C s2 | j jdur.| �� }|r.t|t�| jdd�� dS )z(Copy a JavaScript file for translations.Nr� r� )ry r� r� r6 r r� r� �r_ r� rD rD rE �copy_translation_js s z)StandaloneHTMLBuilder.copy_translation_jsc
C sl | j durht| j d�rD| j �� D ] }t|t�| jdt�|��� q n$| j �� }|rht|t�| jdd�� dS )z#Copy a JavaScript file for stemmer.N�get_js_stemmer_rawcodesr� z _stemmer.js) r �hasattrr� r6 r r� r� r Zget_js_stemmer_rawcoder� rD rD rE �copy_stemmer_js s
z%StandaloneHTMLBuilder.copy_stemmer_js)rj r? c C s^ t td d�dd�}| jrZ| j�� d d d� D ],}tt�|d�t�| jd�t|| j |d� q,d S )N�rR �errorr? c S s t �td�| |� d S �Nz1Failed to copy a file in html_static_file: %s: %r�r� r� r& �rR r� rD rD rE �onerror s
�z>StandaloneHTMLBuilder.copy_theme_static_files.<locals>.onerror���Zstaticr� )�excludedrj �rendererr� )
rN rs r� Zget_theme_dirsr0 r r� r� r3 r� )r_ rj r� �entryrD rD rE �copy_theme_static_files s �z-StandaloneHTMLBuilder.copy_theme_static_filesc C s` t td d�dd�}t| jjdg �}| jjD ].}tt�| j |�t�| j
d�||| j |d� q,d S )Nr� c S s t �td�| |� d S r� r� r� rD rD rE r� s
�z=StandaloneHTMLBuilder.copy_html_static_files.<locals>.onerrorz**/.*r� )rj r� r� ) rN rs r4 ry �exclude_patternsr� r0 r r� �confdirr� r� )r_ rj r� r� r� rD rD rE �copy_html_static_files s
�z,StandaloneHTMLBuilder.copy_html_static_filesc C s: | j jr6t| j j�s6tt�| j| j j�t�| jd�� d S �Nr� )ry r r) r0 r r� r� r� r� rD rD rE �copy_html_logo) s �z$StandaloneHTMLBuilder.copy_html_logoc C s: | j jr6t| j j�s6tt�| j| j j�t�| jd�� d S r� )ry r r) r0 r r� r� r� r� rD rD rE �copy_html_favicon. s �z'StandaloneHTMLBuilder.copy_html_faviconc
C s� z�t td���� tt�| jd�� | j�� }| jd urF|� | j�
� � | � � | � � | �
� | �|� | �|� | �� | �� W d � n1 s�0 Y W n4 ty� } z t�td�|� W Y d }~n
d }~0 0 d S )Nzcopying static filesr� zcannot copy static file %r)r, r& r7 r r� r� r/ r� r r0 Zcontext_for_searchtoolr� r� r� r� r� r� r� r� r� r� )r_ rj r� rD rD rE r` 3 s
*z'StandaloneHTMLBuilder.copy_static_filesc
C s� zft td���F t| jj�}| jjD ] }t�| j|�}t || j
|� q$W d � n1 sZ0 Y W n4 t y� } z t �
td�|� W Y d}~n
d}~0 0 dS )zcopy html_extra_path files.zcopying extra filesNzcannot copy extra file %r)r, r& r4 ry r� r� r r� r� r0 r� r� r� r� )r_ r� �
extra_pathr� r� rD rD rE ra G s 2z&StandaloneHTMLBuilder.copy_extra_filesc
C s~ zDt t�| jd�d�� }| j�|� W d � n1 s80 Y W n4 tyx } z t�t d�|� W Y d }~n
d }~0 0 d S )Nr� r� z#Failed to write build info file: %r)
r� r r� r� rv r� r� r� r� r& )r_ r� rw rD rD rE rb R s
.z%StandaloneHTMLBuilder.write_buildinfoc C s | j r| j �� d S r@ )r� �cleanupr� rD rD rE r� Y s z StandaloneHTMLBuilder.cleanup)r� r? c s� t �| |� | jjr�| jr�|�tj�D ]�� t� fdd�dD ��sDq&n t� j tj
�rVq&nd� d v rdq&� d }tj
dddd �}|| j v r�t �
| j| j | �|d
< n||d
< � �|� |�� � q&d S ) zlPick the best candidate for an image and link down-scaled images to
their high res version.
c 3 s | ]}|� v V qd S r@ rD )rB r �r� rD rE rF f rG z<StandaloneHTMLBuilder.post_process_images.<locals>.<genexpr>)Zscale�widthZheightzno-scaled-link�classes�urir| T)ZinternalZrefuriN)r rV ry �html_scaled_image_link�findallr Zimage�anyrH �parent� referencer{ r� r� r� Z replace_selfr� )r_ r� r� r� rD r� rE rV ^ s$
�
z)StandaloneHTMLBuilder.post_process_imagesc C s� t | jj�t |� }z�t�| j| j�}| jrjt|dd�� }| j �
|| j � W d � q�1 s^0 Y n:t|d�� }| j �
|| j � W d � n1 s�0 Y W n( t t
fy� |r�t�td�� Y n0 | j �|� d S )NrL rM �rbzcsearch index couldn't be loaded, but not all documents will be built: the index will be incomplete.)�setr� r� r r� r� �searchindex_filename�indexer_dumps_unicoder� r rx r� r� rt r� r� r& �prune)r_ r� Zkeep�
searchindexfn�ft�fbrD rD rE r { s 0 2z"StandaloneHTMLBuilder.load_indexer)ri r� r[ r? c C sd | j d ur`|r`| jj|d d�}| jj�|i �}d|v rN| j �||dtd�� n| j �||||� d S )N)�baseZnosearchr| )r r� r� rI rC Zfeedr/ )r_ ri r� r[ rR rI rD rD rE rW � s z StandaloneHTMLBuilder.index_page)r� r7 r� r? c K sN d|vrd|d< |� d�dkr(|�d� | �t| j�j|| |fi |���d S )NZ
includehiddenFZmaxdepthr| r� )rC rF r� r! r� Zget_toctree_for)r_ r� r7 r� rD rD rE �_get_local_toctree� s
���z(StandaloneHTMLBuilder._get_local_toctree)ri r? c C s t �| jt|�| j �S r@ )r r� r� r8 r� )r_ ri rD rD rE r� � s z%StandaloneHTMLBuilder.get_outfilename)ri rT r? c C s t td�dd�}d }d }d }| jjdkrrz,| jj�dd�}|rRdd� |�d �D �}W q� tyn g d
�}Y q�0 n(| j�ddd �}|r�d d� |�d �D �}| � dd �}|�
� D ]D\} }
t || �r�|r�|| �r�||�r�t �
td
�||| � q�| }|
}q�|d u r�||d< ||d< d S )N)�patternr? c s t � fdd�dD ��S )Nc 3 s | ]}|� v V qd S r@ rD )rB �char�r� rD rE rF � rG zKStandaloneHTMLBuilder.add_sidebars.<locals>.has_wildcard.<locals>.<genexpr>z*?[)r� r� rD r� rE � has_wildcard� s z8StandaloneHTMLBuilder.add_sidebars.<locals>.has_wildcard� alabasterr� �sidebarsc S s g | ] }|� � �qS rD �rp �rB r} rD rD rE r� � rG z6StandaloneHTMLBuilder.add_sidebars.<locals>.<listcomp>�,)z
about.htmlznavigation.htmlzrelations.htmlzsearchbox.htmlz donate.htmlc S s g | ] }|� � �qS rD r� r� rD rD rE r� � rG r� z8page %s matches two patterns in html_sidebars: %r and %r�
customsidebar)rN r� r� r} ry rC ro rs r� r� rK r5 r� r� r& ) r_ ri rT r� r� Zmatchedr� Ztheme_default_sidebars�
html_sidebarsr� Z patsidebarsrD rD rE � add_sidebars� s:
�z"StandaloneHTMLBuilder.add_sidebars)r� �typr? c C s t |�| j S r@ )r
r� )r_ r� r� rD rD rE rQ � s z$StandaloneHTMLBuilder.get_target_uri� page.html)ri �addctx� templatenamern rP r? c
s� �j �� }� |d< |d< �jj|d< ��� �}|�dd�d }�jjrdt��jj� �j �|d< nd |d< d|ft
t t
t
d ��fd
d �
}||d < t
t d
��fdd� } | |d< � �fdd�|d< �� � |� |�
|� �j�jd d �< �j�jd d �< ��� |||� �j�d� |||�}
|
�r$|
}z tt|d �dd� d�|d< W n t�yX Y n0 z tt|d �dd� d�|d< W n t�y� Y n0 z�j�||�} W n` t�y� t� t d�� � Y d S t �y } z"t t d�� | f �| �W Y d } ~ n
d } ~ 0 0 |�s�� � �}t!t"�#|�� zDt$|d |d d d ��}
|
�%| � W d � n1 �sZ0 Y W n8 t&�y� } z t� t d �||� W Y d }~n
d }~0 0 �j'�r�|�(d ��r�t"��j)d!t*|d ��}t!t"�#|�� t+�j,�-� �|� d S )"Nri Zcurrent_page_namerN �#rZ r ZpageurlF)�otheruri�resource�baseurir? c sB |rd| v r| S |s � � | �} t|| �p*d}|dkr>� js>|}|S )Nr� r� )rQ r9 �allow_sharp_as_current_path)r� r� r� r� r� rD rE �pathto� s
z1StandaloneHTMLBuilder.handle_page.<locals>.pathtor� )r} r? c s> | � j jv rdS | dkr"� jr"dS | dkr:� �dd�r:dS dS )NTr r� r� r� F)r� r� r r� )r} r� rD rE �hasdoc� s z1StandaloneHTMLBuilder.handle_page.<locals>.hasdocr� c s �j � fi | ��S r@ )r� )r� �ri r_ rD rE �<lambda> rG z3StandaloneHTMLBuilder.handle_page.<locals>.<lambda>Ztoctree�html-page-contextr� c S s | j S r@ rU )�jsrD rD rE r� rG )r r� c S s | j S r@ rU )�cssrD rD rE r� rG z�a Unicode error occurred when rendering the page %s. Please make sure all config values that contain non-ASCII content are Unicode strings.z6An error happened in rendering the page %s.
Reason: %rr� �xmlcharrefreplace)rN �errorszerror writing file %s: %srA Z_sources).r/ r� ry �html_output_encodingrQ �rsplit� html_baseurlr� r� r� rN r� r� r0 r# r� r$ r� �update_page_contextr� Zemit_firstresultrM rJ �AttributeErrorr� Zrender� UnicodeErrorr� r� r& rs r# r� r7 r r� r� r� r� �
copysourcerC r� r8 r6 r� r� )r_ ri r� r� rn rP rT Zdefault_baseurir� r� Znewtmpl�outputrw ri r� Z source_namerD r� rE rS � s~
�
�
���
�.(
�z!StandaloneHTMLBuilder.handle_page)ri r� rT rP r? c C s d S r@ rD )r_ ri r� rT rP rD rD rE r� : s z)StandaloneHTMLBuilder.update_page_contextc C s& | j r| j�| j� | j�| j� d S r@ )r rY rZ �dump_search_index�dump_inventoryr� rD rD rE rc > s z#StandaloneHTMLBuilder.handle_finishzdumping object inventoryc C s t �t�| jt�| j| � d S r@ )r2 r� r r� r� �INVENTORY_FILENAMEr� r� rD rD rE r� C s z$StandaloneHTMLBuilder.dump_inventoryc C s� t td�| j�� ��� | j�| jj� t�| j | j
�}| j r�t |d ddd�� }| j�
|| j� W d � q�1 sv0 Y n>t |d d�� }| j�
|| j� W d � n1 s�0 Y t�|d |� W d � n1 s�0 Y d S )Nzdumping search index in %sz.tmpr� rL rM �wb)r, r& r Zlabelr� r� r� r r� r� r� r� r� r� r� �os�replace)r_ r� r� r� rD rD rE r� G s 0.z'StandaloneHTMLBuilder.dump_search_index)T)N)r� NN)fr` ra rb rc r} �formatr& �epilogr� Zallow_parallelr� r� r' r� r rd r� r� Zsupported_image_typesZsupported_remote_imagesZsupported_data_uri_imagesr� Zadd_permalinksr� r r r� Zdownload_supportr� rN r� r r r r r r� r r� r� rg r� r� r� r r� r� r� r� r� r� r� �propertyr Z NodeVisitorr� r� r r� r� r r� r
r8 rK ZdocumentrU rX rd r, r[ r\ r] re rf r^ r_ r� r� r� r� r� r� r� r` ra rb r� rV r r rW r� r� r� rQ rS r� rc r� r� �
__classcell__rD rD r� rE r� � s�
0 .m P
4 �� a�
r� )r� ry r? c C sv g }|j D ]`}t|t�r(|�|i f� q
z|\}}|�||f� W q
tyh t�td�|� Y q
Y q
0 q
||_ dS )z?This converts string styled html_css_files to tuple styled one.z invalid css_file: %r, ignoredN)�html_css_filesrH rN r� rs r� r� r& )r� ry r� r� rR r� rD rD rE �convert_html_css_filesV s
r� c C sv g }|j D ]`}t|t�r(|�|i f� q
z|\}}|�||f� W q
tyh t�td�|� Y q
Y q
0 q
||_ dS )z>This converts string styled html_js_files to tuple styled one.z invalid js_file: %r, ignoredN)�
html_js_filesrH rN r� rs r� r� r& )r� ry r� r� rR r� rD rD rE �convert_html_js_filesg s
r� )r� ri r� rj r� r? c s* |� d�� ttd�� fdd� }||d< dS )zySet up css_tag() template helper.
.. note:: This set up function is added to keep compatibility with webhelper.
r� )r� r? c sf g }t | j�D ]0}| j| }|d ur|�d|t�|d�f � q|�d� | jdd� � dd�|� S )N�%s="%s"Tz href="%s"�r� z <link %s />rl )rM rQ r� r� �escaperR r� )r� r� r r~ �r� rD rE �css_tag� s
z%setup_css_tag_helper.<locals>.css_tagr� N)rC rP rN )r� ri r� rj r� r� rD r� rE �setup_css_tag_helperx s
r� c s* |� d�� ttd�� fdd� }||d< dS )zxSet up js_tag() template helper.
.. note:: This set up function is added to keep compatibility with webhelper.
r� )r� r? c s� g }d}t | t�r�t| j�D ]^}| j| }|d ur |dkr@|}q |dkr`|�d� ddd� � q |�d|t�|d�f � q | jr�|�d� | jdd� � n|�d� | dd� � |r�d d
�|�|f S d | S d S ) Nr| r9 r� zdata-url_root="%s"Tr� r� zsrc="%s"z<script %s>%s</script>rl z<script>%s</script>) rH rf rM rQ r� r� r� rR r� )r� r� r9 r r~ r� rD rE �js_tag� s"
z#setup_js_tag_helper.<locals>.js_tagr� N)rC rf rN )r� ri r� rj r� r� rD r� rE �setup_js_tag_helper� s
r� c C sv |� d�}|� d�}|r6t|�s6|d| dd�|d< n||d< |� d�}|rjt|�sj|d| dd�|d< n||d< d S )
z Set up relative resource paths.r� r
z_static/Tr� Z favicon_urlr Zlogo_urlN)rC r) )r� ri r� rj r� r� r
r rD rD rE �setup_resource_paths� s
r� r� c C sN | j jdkrd S | j j}|d u r.ttd���n || jjvrJttd�| ��d S )Nr� zEMany math_renderers are registered. But no math_renderer is selected.z"Unknown math_renderer %r is given.)r
r� r� r" r& r� r� )r� r} rD rD rE �validate_math_renderer� s r� c C s� |j dd� D ]�}t�t�| j|��}t�|�sNt�td�|� |j � |� qt�
| j �d t�
|�d krt� | j |g�| j krt�td�|� |j � |� qdS )z Check html_extra_paths setting.Nz'html_extra_path entry %r does not existr z0html_extra_path entry %r is placed inside outdir)
r� r �normpathr� r� �existsr� r� r& r� �
splitdriver� �
commonpath)r� ry r� r� rD rD rE �validate_html_extra_path� s
�r� c C s� |j dd� D ]�}t�t�| j|��}t�|�sNt�td�|� |j � |� qt�
| j �d t�
|�d krt� | j |g�| j krt�td�|� |j � |� qdS )z Check html_static_paths setting.Nz(html_static_path entry %r does not existr z1html_static_path entry %r is placed inside outdir)
r� r r� r� r� r� r� r� r& r� r� r� r� )r� ry r� Z static_pathrD rD rE �validate_html_static_path� s
�r� c C sB |j r>t�t�| j|j ��s>t|j �s>t�td�|j � d|_ dS )zCheck html_logo setting.zlogo file %r does not existN) r r r� r� r� r) r� r� r& �r� ry rD rD rE �validate_html_logo� s ��r� c C sB |j r>t�t�| j|j ��s>t|j �s>t�td�|j � d|_ dS )zCheck html_favicon setting.z favicon file %r does not existN) r r r� r� r� r) r� r� r& r� rD rD rE �validate_html_favicon� s ��r� c @ s e Zd Zdd� ZdS )�_stable_repr_objectc C s dS )Nz<object>rD r� rD rD rE �__repr__� s z _stable_repr_object.__repr__N)r` ra rb r� rD rD rD rE r� � s r� c C s> |j }|tu rdS t�td�� |s.d|_dS t�|�|_dS )z0Migrate html_add_permalinks to html_permalinks*.Nzrhtml_add_permalinks has been deprecated since v3.5.0. Please use html_permalinks and html_permalinks_icon instead.F) �html_add_permalinks�UNSETr� r� r& �html_permalinksr� r� �html_permalinks_icon)r� ry r� rD rD rE �migrate_html_add_permalinks s �r� c C sP | � t� | �ddd� | �dg d� | �di d� | �ddd� dtg� | �d d
d� d� | �d d dtg� | �d d dtg� | �d
d dtg� | �dg d� | �dg d� | �dg d� | �dg d� | �dd dtg� | �di d� | �di d� | �dddtg� | �dtd� | �ddd� | �ddd� | �ddd� | �d d d� | �d dd� | �d dd� | �d d!d� | �d"d#d� | �d$d dtg� | �d%d dtg� | �d&dd� | �d'dd� | �d(i d� | �d)d*d� | �d+dd� | �d,d-d� | �d.d dtg� | �d/i d� | �d0d#d � | �d1dd� | �d2d#d� | �d3d4dtd5d4�� | �d6d d7� | �d8d d� | �d9� | �d:� | jd;t d<d=� | jd;t
d<d=� | jd;t d<d=� | jd;t d<d=� | jd;t
d<d=� | jd;td<d=� | jd;td<d=� | �d>t� | �d:t� | �d:t� | �d:t� | �d?� | �d@� dAdddB�S )CNr� r� r� Zhtml_theme_pathr� r( c S s t d�| j| jf S )Nz%s %s documentation)r% r r r� rD rD rE r� % rG zsetup.<locals>.<lambda>r) c S s | j S r@ )r( r� rD rD rE r� ' rG r� r r r� r� r� r� r r� ro r Tr� r� r� � ¶Zhtml_use_indexrv Fr, r- r. z.txtr' r| r� r� r* r+ r1 r� rL r Zhtml_secnumber_suffixz. r r r r� r� Z html_codeblock_linenos_styleZinline�tableZhtml_math_rendererr� r� rg r� z
config-initedr� rU zbuilder-initedzsphinx.ext.mathjaxz sphinx.builders.html.transformsZbuiltin)r Zparallel_read_safeZparallel_write_safe)Z add_builderr� Zadd_config_valuerN rJ r� r Z add_eventZconnectr� r� r� r� r� r� r� r� r� r� r� Zsetup_extension)r� rD rD rE �setup s�
�
�
�r )�rc r� r� r� �rer� r r �typingr r r r r r r
r r � urllib.parser
Zdocutilsr Z
docutils.corer Zdocutils.frontendr Z docutils.ior r Zdocutils.nodesr Zdocutils.utilsr r� r r r r Zsphinx.applicationr Zsphinx.buildersr Z
sphinx.configr r Zsphinx.domainsr r r Z!sphinx.environment.adapters.assetr Z(sphinx.environment.adapters.indexentriesr Z#sphinx.environment.adapters.toctreer! Z
sphinx.errorsr" r# Zsphinx.highlightingr$ Z
sphinx.localer% r& r r' Zsphinx.themingr( Z sphinx.utilr) r* r+ r, r- Zsphinx.util.docutilsr. r/ Zsphinx.util.fileutilr0 Zsphinx.util.i18nr1 Zsphinx.util.inventoryr2 Zsphinx.util.matchingr3 r4 r5 Zsphinx.util.osutilr6 r7 r8 r9 Zsphinx.util.tagsr: Zsphinx.writers.htmlr; r< Zsphinx.writers.html5r= r� r� Z getLoggerr` r� �compiler% rN rA rP rf rg r� r� r� r� r� r� r� r� r� r� r� r� r� r� Z sphinxcontrib.serializinghtml�
sphinxcontribZsphinx.builders.dirhtmlZsphinx.builders.singlehtmlr rD rD rD rE �<module> s�
,
. 2� � #�