File: //usr/lib/python3/dist-packages/sphinx/builders/__pycache__/texinfo.cpython-310.pyc
o
�$�a�$ � @ s� d Z ddlZddlmZ ddlmZmZmZmZmZm Z ddl
m Z ddl m
Z
ddlmZ ddlmZ dd lmZmZ dd
lmZ dd lmZ dd lmZ dd
lm Z ddl m Z ddl m Z m!Z! ddl"m#Z#m$Z$m%Z% ddl&m'Z' ddl(m)Z) ddl*m+Z+ ddl,m-Z- ddl.m/Z/m0Z0m1Z1 ddl2m3Z3m4Z4 e#�5e6�Z7ej�8edd�Z9G dd� de�Z:ded eee;e;e;e;e;e;e;f fd d �Z<d ed ee;ef fd d!�Z=dS )"z�
sphinx.builders.texinfo
~~~~~~~~~~~~~~~~~~~~~~~
Texinfo builder.
:copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�path)�Any�Dict�Iterable�List�Tuple�Union)�nodes)� OptionParser)�
FileOutput)�Node)�addnodes� package_dir)�Sphinx)�Builder)�Config)� ImageAdapter)�NoUri)�_�__)�logging�progress_message�status_iterator)� darkgreen)� new_document)�copy_asset_file)�inline_all_toctrees)�SEP� ensuredir�make_filename_from_project)�TexinfoTranslator�
TexinfoWriter� templates�texinfoc @ s� e Zd ZdZdZdZed�Zejdkreed�7 Zg d�Z e
Z d&d d
�Z de
eee f fd d �Zd'd
ededefdd�Zd'dedededefdd�Zd&dd�Zdeddfdd�Zdeded ee dejfd d �Zd&d d �Zd!eddfd"d#�Zd&d$d%�Z dS )(�TexinfoBuilderz=
Builds Texinfo output to create Info documentation.
r# z$The Texinfo files are in %(outdir)s.�posixzl
Run 'make' in that directory to run these through makeinfo
(use 'make info' here to do that automatically).)z image/pngz
image/jpegz image/gif�returnNc C s g | _ g | _d S �N)�docnames�
document_data��self� r, �9/usr/lib/python3/dist-packages/sphinx/builders/texinfo.py�init7 s
zTexinfoBuilder.initc C s dS )Nz
all documentsr, r* r, r, r- �get_outdated_docs; s z TexinfoBuilder.get_outdated_docs�docname�typc C s || j vr
t||��d| S )N�%)r( r )r+ r0 r1 r, r, r- �get_target_uri> s
z TexinfoBuilder.get_target_uri�from_�toc C s | � ||�S r' )r3 )r+ r4 r5 r1 r, r, r- �get_relative_uriD s z TexinfoBuilder.get_relative_uric C s� dd� | j jD �}|st�td�� d S g | _|D ]2}|d }|| jjvr.t�td�|� q| j� |� |�
t d �rA|d d� }| j� ||d f� qd S ) Nc S s g | ]}t |��qS r, )�list)�.0�xr, r, r- �
<listcomp>I s z5TexinfoBuilder.init_document_data.<locals>.<listcomp>zGno "texinfo_documents" config value found; no documents will be writtenr z?"texinfo_documents" config value references unknown document %s�index���� ) �config�texinfo_documents�logger�warningr �titles�env�all_docsr) �append�endswithr )r+ �preliminary_document_data�entryr0 r, r, r- �init_document_dataH s"
� �z!TexinfoBuilder.init_document_data�ignoredc G s� | � � | jD ]�}|d d� \}}}}|d7 }d } }} t|�dkr,|dd� \}}} d}
t|�dkr8|d }
tt�| j|�dd�} ttd �| �� | j j
pQg } | j ||
| d
�}
W d � n1 sdw Y ttd ���U | � |
� t
| �}t| jj|fd d
��� }||_||_|d d� d |_| j j|_|p�d|_| p�d|_|p�d|_||_||
_|�|
| � | �|d d� � W d � n1 s�w Y qd S )N� z.texi� � � Fzutf-8)�destination_path�encodingz
processing %s)�
appendices�writingT)�defaults�
components�read_config_filesr< z.info) rI r) �lenr r �join�outdirr r r> �texinfo_appendices�assemble_doctree�post_process_imagesr! r
rC �settings�get_default_values�author�title�texinfo_filename�texinfo_elements�texinfo_dir_entry�texinfo_dir_category�texinfo_dir_descriptionr0 �write�copy_image_files)r+ rJ rH r0 �
targetnamer_ r^ �direntry� description�category� toctree_only� destinationrQ �doctree� docwriterr\ r, r, r- re [ sT
� �
��
���zTexinfoBuilder.write� indexfilerk rQ c C s� t |g| �| _tjt|�d dd� | j�|�}||d< |rBtd�}t� � }|t�
dd�7 }||7 }|� t j
�D ]}||7 }q9|}t| | j||t|g�}||d< |D ]} | j�| �}
| |
d< |�|
� qSt�d� t�td�� | j�||| � |� t j�D ]E} | d } | d
} t�| | �g}
| jD ]*\}}| �|�r�|
�t�td �td ��� |
�t�||�� |
�t�d d �� nq� | �|
� q|S )
N� T��nonlr0 z<texinfo output>z<Set title in conf.py>rL zresolving references...�
refdocname� refsectnamez (in �))�setr( r@ �infor rC � get_doctreer r �sectionr_ �traverser
�toctreer rE r �resolve_references� pending_xref�emphasisrB �
startswith�Textr � replace_self)r+ ro rk rQ �tree�new_tree�new_sect�node� largetreer0 �appendix� pendingnode�sectname�newnodes�subdirr_ r, r, r- rZ � sN �
�
� z TexinfoBuilder.assemble_doctreec C s | � � d S r' )�copy_support_filesr* r, r, r- �finish� s zTexinfoBuilder.finishrg c C s� | j rat| jj�j}t| j td�dt| j �| jj|d�D ]F}| j | }z t �
| j |d �}t |� t
t �
| j|�t �
||�� W q ty` } zt�td�t �
| j|�|� W Y d }~q d }~ww d S d S )Nzcopying images... �brown)�stringify_funcz-figuresz cannot copy image file %r: %s)�imagesr �apprC �get_original_image_urir r rV � verbosityr rW rX r r �srcdir� Exceptionr@ rA )r+ rg r� �src�dest�imagedir�errr, r, r- rf � s*
�
�
����z TexinfoBuilder.copy_image_filesc
C s� z-t td��� tjddd� ttj�td�| j � W d � W d S 1 s&w Y W d S t
yH } zt� td�|� W Y d }~d S d }~ww )Nz copying Texinfo support filesz Makefile Trq �Makefilez error writing file Makefile: %s) r r r@ rw r �osr rW � template_dirrX �OSErrorrA )r+ r� r, r, r- r� � s &� ��z!TexinfoBuilder.copy_support_files)r& Nr' ) �__name__�
__module__� __qualname__�__doc__�name�formatr �epilogr� �supported_image_typesr �default_translator_classr. r �strr r/ r3 r6 rI r re �boolr �documentrZ r� rf r� r, r, r, r- r$ ' s&
%
*r$ r> r& c C s$ t | j�}| j|| j| j|ddfgS )z, Better default texinfo_documents settings. z One line description of project�
Miscellaneous)r �project�root_docr^ )r> �filenamer, r, r- �default_texinfo_documents� s
�r� r� c C sn | � t� | �dtd � | �dg d � | �di d � | �ddd tg� | �ddd � | �dd d � d
ddd �S ) Nr? rY ra �texinfo_domain_indicesT�texinfo_show_urls�footnote�texinfo_no_detailmenuF�builtin)�version�parallel_read_safe�parallel_write_safe)� add_builderr$ �add_config_valuer� r7 )r� r, r, r- �setup� s
�r� )>r� r� r �typingr r r r r r �docutilsr �docutils.frontendr
� docutils.ior �docutils.nodesr �sphinxr
r �sphinx.applicationr �sphinx.buildersr �
sphinx.configr �!sphinx.environment.adapters.assetr �
sphinx.errorsr �
sphinx.localer r � sphinx.utilr r r �sphinx.util.consoler �sphinx.util.docutilsr �sphinx.util.fileutilr �sphinx.util.nodesr �sphinx.util.osutilr r r �sphinx.writers.texinfor r! � getLoggerr� r@ rW r� r$ r� r� r� r, r, r, r- �<module> s8
(