Dashboard
PHP:
8.2.30
OS:
Linux
User:
dh_nv8b2m
/
/
usr
/
lib
/
python3
/
dist-packages
/
sphinx
/
builders
/
__pycache__
📤 Upload
📝 New File
📁 New Folder
Close
Editing: 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 (
Save
Cancel