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

Allow alternative float options for figure. See #1. no-pep8

Browse Source
This commit is contained in:
Ernesto Revilla 2014-02-20 18:03:34 +01:00
parent 74c7a52eca
commit d82590927f
3 changed files with 12 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
doc/config.rst
View File

@ -1099,6 +1099,12 @@ These options influence LaTeX output.
"Rejne". You can also set this to ``''`` to disable fncychap. "Rejne". You can also set this to ``''`` to disable fncychap.
``'preamble'`` ``'preamble'``
Additional preamble content, default empty. Additional preamble content, default empty.
``'figure_align'``
Latex figure float alignment, default 'htbp' (here, top, bottom, page).
Whenever an image doesn't fit into the current page, it wil be
'floated' into the next page but may be preceeded by any other text.
If you don't like this behavior, use 'H' which will disable floating
and position figures strictly in the order they appear in the source.
``'footer'`` ``'footer'``
Additional footer content (before the indices), default empty. Additional footer content (before the indices), default empty.

3
sphinx/quickstart.py
View File

@ -236,6 +236,9 @@ latex_elements = {
# Additional stuff for the LaTeX preamble. # Additional stuff for the LaTeX preamble.
#'preamble': '', #'preamble': '',
# Latex figure (float) alignment
#'figure_align': 'htbp',
} }
# Grouping the document tree into LaTeX files. List of tuples # Grouping the document tree into LaTeX files. List of tuples

4
sphinx/writers/latex.py
View File

@ -164,6 +164,7 @@ class LaTeXTranslator(nodes.NodeVisitor):
'footer': '', 'footer': '',
'printindex': '\\printindex', 'printindex': '\\printindex',
'transition': '\n\n\\bigskip\\hrule{}\\bigskip\n\n', 'transition': '\n\n\\bigskip\\hrule{}\\bigskip\n\n',
'figure_align': 'htbp',
} }
# sphinx specific document classes # sphinx specific document classes
@ -1005,7 +1006,8 @@ class LaTeXTranslator(nodes.NodeVisitor):
# TODO non vertical space for other alignments. # TODO non vertical space for other alignments.
align = '\\begin{flush%s}' % node.attributes['align'] align = '\\begin{flush%s}' % node.attributes['align']
align_end = '\\end{flush%s}' % node.attributes['align'] align_end = '\\end{flush%s}' % node.attributes['align']
self.body.append('\\begin{figure}[htbp]%s\n' % align) self.body.append('\\begin{figure}[%s]%s\n' % (
self.elements['figure_align'], align))
if any(isinstance(child, nodes.caption) for child in node): if any(isinstance(child, nodes.caption) for child in node):
self.body.append('\\capstart\n') self.body.append('\\capstart\n')
self.context.append(ids + align_end + '\\end{figure}\n') self.context.append(ids + align_end + '\\end{figure}\n')