class documentation

class LaTeXBuilder(Builder):

View In Hierarchy

Builds LaTeX output to create PDF.
Class Variable format Undocumented
Class Variable name Undocumented
Class Variable supported​_image​_types Undocumented
Method assemble​_doctree Undocumented
Method copy​_image​_files Undocumented
Method copy​_latex​_additional​_files Undocumented
Method copy​_support​_files copy TeX support files from texinputs.
Method finish Finish the building process.
Method get​_contentsname Undocumented
Method get​_outdated​_docs Return an iterable of output files that are outdated, or a string describing what an update build will build.
Method get​_relative​_uri Return a relative URI between two source filenames.
Method get​_target​_uri Return the target URI for a document name.
Method init Load necessary templates and perform initialization. The default implementation does nothing.
Method init​_babel Undocumented
Method init​_context Undocumented
Method init​_document​_data Undocumented
Method init​_multilingual Undocumented
Method update​_context Update template variables for .tex file just before writing.
Method update​_doc​_context Undocumented
Method write Undocumented
Method write​_message​_catalog Undocumented
Method write​_stylesheet Undocumented
Class Variable epilog Undocumented
Class Variable supported​_remote​_images Undocumented
Instance Variable babel Undocumented
Instance Variable context Undocumented
Instance Variable docnames Undocumented
Instance Variable document​_data Undocumented
Instance Variable themes Undocumented
Instance Variable titles Undocumented
Property usepackages Undocumented
Property usepackages​_after​_hyperref Undocumented

Inherited from Builder:

Method build Main build method.
Method build​_all Build all source files.
Method build​_specific Only rebuild as much as needed for changes in the filenames.
Method build​_update Only rebuild what was changed or added since last build.
Method prepare​_writing A place where you can add logic before write_doc is run
Method write​_doc Where you actually write something to the filesystem.
Class Variable allow​_parallel Undocumented
Class Variable default​_translator​_class Undocumented
Class Variable supported​_data​_uri​_images Undocumented
Instance Variable events Undocumented
Method __init__ Undocumented
Method ​_read​_parallel Undocumented
Method ​_read​_serial Undocumented
Method ​_write​_parallel Undocumented
Method ​_write​_serial Undocumented
Method cleanup Cleanup any resources.
Method compile​_all​_catalogs Undocumented
Method compile​_catalogs Undocumented
Method compile​_specific​_catalogs Undocumented
Method compile​_update​_catalogs Undocumented
Method create​_template​_bridge Return the template bridge configured.
Method create​_translator Return an instance of translator.
Method get​_asset​_paths Return list of paths for assets (ex. templates, CSS, etc.).
Method get​_builder​_config Return a builder specific option.
Method get​_translator​_class Return a class of translator.
Method post​_process​_images Pick the best candidate for all image URIs.
Method read (Re-)read all files new or changed since last update.
Method read​_doc Parse a file and add/update inventory entries for the doctree.
Method set​_environment Store BuildEnvironment object.
Method write​_doc​_serialized Handle parts of write_doc that must be called in the main process if parallel build is active.
Method write​_doctree Write the doctree to a file.
Class Variable use​_message​_catalog Undocumented
Class Variable versioning​_compare Undocumented
Class Variable versioning​_method Undocumented
Instance Variable app Undocumented
Instance Variable confdir Undocumented
Instance Variable config Undocumented
Instance Variable doctreedir Undocumented
Instance Variable env Undocumented
Instance Variable finish​_tasks Undocumented
Instance Variable imagedir Undocumented
Instance Variable images Undocumented
Instance Variable imgpath Undocumented
Instance Variable outdir Undocumented
Instance Variable parallel​_ok Undocumented
Instance Variable srcdir Undocumented
Instance Variable tags Undocumented
Instance Variable templates Undocumented
format: str =

Undocumented

name: str =

Undocumented

supported_image_types: list[str] =
def assemble_doctree(self, indexfile, toctree_only, appendices):

Undocumented

Parameters
indexfile:strUndocumented
toctree​_only:boolUndocumented
appendices:List[str]Undocumented
Returns
nodes.documentUndocumented
def copy_image_files(self):

Undocumented

@progress_message(__('copying additional files'))
def copy_latex_additional_files(self):

Undocumented

@progress_message(__('copying TeX support files'))
def copy_support_files(self):
copy TeX support files from texinputs.
def finish(self):

Finish the building process.

The default implementation does nothing.

def get_contentsname(self, indexfile):

Undocumented

Parameters
indexfile:strUndocumented
Returns
strUndocumented
def get_outdated_docs(self):

Return an iterable of output files that are outdated, or a string describing what an update build will build.

If the builder does not output individual files corresponding to source files, return a string here. If it does, return an iterable of those files that need to be written.

Returns
Union[str, List[str]]Undocumented
def get_relative_uri(self, from_, to, typ=None):

Return a relative URI between two source filenames.

May raise environment.NoUri if there's no way to return a sensible URI.

Parameters
from​_:strUndocumented
to:strUndocumented
typ:strUndocumented
Returns
strUndocumented
def get_target_uri(self, docname, typ=None):

Return the target URI for a document name.

typ can be used to qualify the link characteristic for individual builders.

Parameters
docname:strUndocumented
typ:strUndocumented
Returns
strUndocumented
def init(self):
Load necessary templates and perform initialization. The default implementation does nothing.
def init_babel(self):

Undocumented

def init_context(self):

Undocumented

def init_document_data(self):

Undocumented

def init_multilingual(self):

Undocumented

def update_context(self):
Update template variables for .tex file just before writing.
def update_doc_context(self, title, author, theme):

Undocumented

Parameters
title:strUndocumented
author:strUndocumented
theme:ThemeUndocumented
def write(self, *ignored):

Undocumented

Parameters
*ignored:AnyUndocumented
def write_message_catalog(self):

Undocumented

def write_stylesheet(self):

Undocumented

epilog =

Undocumented

supported_remote_images: bool =
babel =

Undocumented

context =

Undocumented

docnames =

Undocumented

document_data: List[Tuple[str, str, str, str, str, bool]] =

Undocumented

themes =

Undocumented

titles: List[Tuple[str, str]] =

Undocumented

@property
usepackages: List[Tuple[str, str]] =

Undocumented

@property
usepackages_after_hyperref: List[Tuple[str, str]] =

Undocumented