#96: The LaTeX builder now supports figures wrapped by text, when using the `figwidth` option and right/left alignment.

CHANGES

@@ -120,6 +120,9 @@ New features added
   - The new ``html_link_suffix`` config value can be used to select
     the suffix of generated links between HTML files.
 
+  - #96: The LaTeX builder now supports figures wrapped by text, when
+    using the ``figwidth`` option and right/left alignment.
+
 * New translations:
   
   - Italian by Sandro Dentella.

sphinx/directives/__init__.py

@@ -9,6 +9,19 @@
     :license: BSD, see LICENSE for details.
 """
 
+from docutils.parsers.rst import directives
+from docutils.parsers.rst.directives import images
+
+# import and register directives
 from sphinx.directives.desc import *
 from sphinx.directives.code import *
 from sphinx.directives.other import *
+
+
+# allow units for the figure's "figwidth"
+try:
+    images.Figure.option_spec['figwidth'] = \
+        directives.length_or_percentage_or_unitless
+except AttributeError:
+    images.figure.options['figwidth'] = \
+        directives.length_or_percentage_or_unitless

sphinx/texinputs/sphinx.sty

@@ -17,11 +17,15 @@
 \RequirePackage{makeidx}
 \RequirePackage{framed}
 \RequirePackage{color}
+% For highlighted code.
 \RequirePackage{fancyvrb}
+% For table captions.
 \RequirePackage{threeparttable}
 % Handle footnotes in tables.
 \RequirePackage{footnote}
 \makesavenoteenv{tabulary}
+% For floating figures in the text.
+\RequirePackage{wrapfig}
 
 % Redefine these colors to your liking in the preamble.
 \definecolor{TitleColor}{rgb}{0.126,0.263,0.361}

sphinx/writers/latex.py

@@ -850,6 +850,12 @@ class LaTeXTranslator(nodes.NodeVisitor):
         pass
 
     def visit_figure(self, node):
+        if node.has_key('width') and node.get('align', '') in ('left', 'right'):
+            self.body.append('\\begin{wrapfigure}{%s}{%s}\n\\centering' %
+                             (node['align'] == 'right' and 'r' or 'l',
+                              node['width']))
+            self.context.append('\\end{wrapfigure}\n')
+        else:
             if (not node.attributes.has_key('align') or
                 node.attributes['align'] == 'center'):
                 # centering does not add vertical space like center.