IntenseWebs/sphinx
3
0
Fork 0
mirror of https://github.com/sphinx-doc/sphinx.git synced 2025-02-25 18:55:22 -06:00
Code Issues Packages Projects Releases Wiki Activity

#2725: latex builder: allow to use user-defined template file (experimental)

Browse Source
This commit is contained in:
Takeshi KOMIYA 2016-08-17 22:52:42 +09:00
parent b03b7e543f
commit d45c5f8e82
3 changed files with 16 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
CHANGES
View File

@ -96,6 +96,7 @@ Features added
prefixes from the index text of C++ objects. prefixes from the index text of C++ objects.
* C++, added concept directive. Thanks to mickk-on-cpp. * C++, added concept directive. Thanks to mickk-on-cpp.
* C++, added support for template introduction syntax. Thanks to mickk-on-cpp. * C++, added support for template introduction syntax. Thanks to mickk-on-cpp.
* #2725: latex builder: allow to use user-defined template file (experimental)
Bugs fixed Bugs fixed
---------- ----------

9
doc/latex.rst
View File

@ -149,3 +149,12 @@ Let us illustrate here what can be modified by the second method.
from a ``\usepackage`` executed from inside the :file:`sphinx.sty` style from a ``\usepackage`` executed from inside the :file:`sphinx.sty` style
file. Sphinx aims at loading as few packages as are really needed for its file. Sphinx aims at loading as few packages as are really needed for its
default design. default design.
.. hint::
As an experimental feature, Sphinx can use user-defined template file for
LaTeX source if you have a file named ``_templates/latex.tex_t`` on your
project. Now all template variables are unstable and undocumented. They
will be changed in future version.
.. versionadded:: 1.5

5
sphinx/writers/latex.py
View File

@ -497,6 +497,11 @@ class LaTeXTranslator(nodes.NodeVisitor):
'body': u''.join(self.body), 'body': u''.join(self.body),
'indices': self.generate_indices() 'indices': self.generate_indices()
}) })
template_path = path.join(self.builder.srcdir, '_templates', 'latex.tex_t')
if path.exists(template_path):
return LaTeXRenderer().render(template_path, self.elements)
else:
return LaTeXRenderer().render(DEFAULT_TEMPLATE, self.elements) return LaTeXRenderer().render(DEFAULT_TEMPLATE, self.elements)
def hypertarget(self, id, withdoc=True, anchor=True): def hypertarget(self, id, withdoc=True, anchor=True):