|
Server : Apache System : Linux iad1-shared-b8-43 6.6.49-grsec-jammy+ #10 SMP Thu Sep 12 23:23:08 UTC 2024 x86_64 User : dh_edsupp ( 6597262) PHP Version : 8.2.26 Disable Function : NONE Directory : /lib/python3/dist-packages/sphinx/builders/__pycache__/ |
Upload File : |
o
�$�a� � @ s� d Z ddlmZ ddlmZmZmZmZmZ ddl m
Z
ddl m Z ddl
mZ ddlmZ ddlmZ dd lmZ dd
lmZmZ dd lmZ dd lmZ e� e �Z G d
d� de�Z dedee ef fdd�Z!dS )z�
sphinx.builders.singlehtml
~~~~~~~~~~~~~~~~~~~~~~~~~~
Single HTML builders.
:copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� )�path)�Any�Dict�List�Tuple�Union)�nodes)�Node)�Sphinx)�StandaloneHTMLBuilder)�TocTree)�__)�logging�progress_message)� darkgreen)�inline_all_toctreesc
@ sL e Zd ZdZdZed�ZdZdee e
e f fdd�Z d,d e d
e de fd d �Z d,d
e de d
e de fdd�Z
deddfdd�Zd-d e dedede fdd�Zdejfdd�Zdee ee eedf f f fd d �Zdee ee ee eedf f f f fd d �Zd e d e d!e defd"d#�Zd$eddfd%d&�Z d.d'd(�Z e ed)��d.d*d+��Z dS )/�SingleFileHTMLBuilderzb
A StandaloneHTMLBuilder subclass that puts the whole document tree on one
HTML page.
�
singlehtmlz The HTML page is in %(outdir)s.F�returnc C s dS )Nz
all documents� ��selfr r �</usr/lib/python3/dist-packages/sphinx/builders/singlehtml.py�get_outdated_docs& s z'SingleFileHTMLBuilder.get_outdated_docsN�docname�typc C s, || j jv r| jj| j d | S || j S )Nz
#document-)�env�all_docs�config�root_doc�
out_suffix)r r r r r r �get_target_uri) s ��
z$SingleFileHTMLBuilder.get_target_uri�from_�toc C s | � ||�S �N)r! )r r" r# r r r r �get_relative_uri2 s z&SingleFileHTMLBuilder.get_relative_uri�treec C sv | j j| j }|�tj�D ]+}d|vrq
|d }|�d�}|dk r"q
|�d|d �}|dkr8|||d � |d< q
d S )N�refuri�#r � )r r r �traverser � reference�find)r r& �fname�refnoder' � hashindexr r r � fix_refuris6 s
��z!SingleFileHTMLBuilder.fix_refurisT�collapse�kwargsc K sL d|vrd|d< t | j�j|| |fi |��}|d ur | �|� | �|�d S )N�
includehiddenF�fragment)r r �get_toctree_forr0 �render_partial)r r r1 r2 �toctreer r r �_get_local_toctreeD s
z(SingleFileHTMLBuilder._get_local_toctreec C sP | j j}| j�|�}t| t� ||t|g�}||d< | j�||| � | �|� |S )Nr ) r r r � get_doctreer �setr �resolve_referencesr0 )r �masterr& r r r �assemble_doctreeL s
z&SingleFileHTMLBuilder.assemble_doctree.c C sL i }| j j�� D ]\}}|�� D ]\}}d||f }|||< qq| jj|iS �Nz%s/%s)r �toc_secnumbers�itemsr r )r �new_secnumbersr �secnums�id�secnum�aliasr r r �assemble_toc_secnumbersU s
� z-SingleFileHTMLBuilder.assemble_toc_secnumbersc C sn i }| j j�� D ](\}}|�� D ] \}}d||f }|�|i � |�� D ]
\}}||| |< q$qq| jj|iS r> )r �toc_fignumbersr@ �
setdefaultr r ) r �new_fignumbersr �
fignumlist�figtype�fignumsrE rC �fignumr r r �assemble_toc_fignumbersg s
�� z-SingleFileHTMLBuilder.assemble_toc_fignumbers�body�metatagsc
C sd t | j��| jj| d�}|r | �|� | �|�d }d}nd}d}g d d d | jjd ||g d||d� S )NFr4 T� ) �parents�prev�next� docstitle�title�metarO rP �rellinks�
sourcename�toc� display_toc)r r r5 r r r0 r6 �
html_title)r r rO rP r7 rZ r[ r r r �get_doc_context| s(
�z%SingleFileHTMLBuilder.get_doc_context�ignoredc G s� | j j}ttd���
| �|� W d � n1 sw Y ttd��� | �� }| �� | j _| �� | j _ W d � n1 s@w Y ttd��� | �
| j j |� | �
| j j |� W d � d S 1 sgw Y d S )Nzpreparing documentszassembling single document�writing)r r r r
�prepare_writingr= rF r? rN rG �write_doc_serializedr r � write_doc)r r^ �docnames�doctreer r r �write� s � �"�zSingleFileHTMLBuilder.writec C s< | � � | �� | �� | �� | �� | �� | �� d S r$ )�write_additional_files�copy_image_files�copy_download_files�copy_static_files�copy_extra_files�write_buildinfo�dump_inventoryr r r r �finish� s z SingleFileHTMLBuilder.finishzwriting additional filesc C sv | j j�� D ]\}}tjd| dd� | �|i |� q| j jr9tjddd� t�| j dd�}| jdi d|d� d S d S ) N� T)�nonlz opensearch�_staticzopensearch.xml�
opensearch)� outfilename)
r �html_additional_pagesr@ �logger�info� handle_page�html_use_opensearchr �join�outdir)r �pagename�template�fnr r r rf � s �z,SingleFileHTMLBuilder.write_additional_filesr$ )T)r N) �__name__�
__module__� __qualname__�__doc__�namer
�epilog�
copysourcer �strr r r! r% r r0 �boolr r8 r �documentr= r r �intrF rN r] re rm r rf r r r r r s$ & .
r �appr c C s2 | � d� | �t� | �ddd� d� dddd�S ) Nzsphinx.builders.html�singlehtml_sidebarsc S s | j S r$ )�
html_sidebarsr r r r �<lambda>� s zsetup.<locals>.<lambda>�html�builtinT)�version�parallel_read_safe�parallel_write_safe)�setup_extension� add_builderr �add_config_value)r� r r r �setup� s
�r� N)"r� �osr �typingr r r r r �docutilsr �docutils.nodesr �sphinx.applicationr
�sphinx.builders.htmlr �#sphinx.environment.adapters.toctreer �
sphinx.localer
� sphinx.utilr r �sphinx.util.consoler �sphinx.util.nodesr � getLoggerr} rt r r� r� r r r r �<module> s
"