matplotlib-users Mailing List for matplotlib

Adding a caption to a plot inserted with the `plot` directive from mpl's
sphinxextensions does not work for me, even though the [documentation][1]
says it should be possible.
The relevant ReST snippet:
```
.. plot:: /home/oliver/git/lcp2/code/python/plot_scripts/tangent_circles.py
 :align: center
 :alt: 'Schematic drawing of the two solution methods'
 Schematic drawing showing the two possible solution methods discussed.
```
I'm getting the following traceback:
# Sphinx version: 1.1.3
# Python version: 2.7.3
# Docutils version: 0.9.1 release
# Jinja2 version: 2.6
Traceback (most recent call last):
 File
"/usr/local/lib/python2.7/dist-packages/Sphinx-1.1.3-py2.7.egg/sphinx/cmdline.py",
line 189, in main
 app.build(force_all, filenames)
 File
"/usr/local/lib/python2.7/dist-packages/Sphinx-1.1.3-py2.7.egg/sphinx/application.py",
line 204, in build
 self.builder.build_update()
 File
"/usr/local/lib/python2.7/dist-packages/Sphinx-1.1.3-py2.7.egg/sphinx/builders/__init__.py",
line 196, in build_update
 'out of date' % len(to_build))
 File
"/usr/local/lib/python2.7/dist-packages/Sphinx-1.1.3-py2.7.egg/sphinx/builders/__init__.py",
line 216, in build
 purple, length):
 File
"/usr/local/lib/python2.7/dist-packages/Sphinx-1.1.3-py2.7.egg/sphinx/builders/__init__.py",
line 120, in status_iterator
 for item in iterable:
 File
"/usr/local/lib/python2.7/dist-packages/Sphinx-1.1.3-py2.7.egg/sphinx/environment.py",
line 613, in update_generator
 self.read_doc(docname, app=app)
 File
"/usr/local/lib/python2.7/dist-packages/Sphinx-1.1.3-py2.7.egg/sphinx/environment.py",
line 761, in read_doc
 pub.publish()
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/core.py",
line 221, in publish
 self.settings)
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/readers/__init__.py",
line 69, in read
 self.parse()
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/readers/__init__.py",
line 75, in parse
 self.parser.parse(self.input, document)
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/parsers/rst/__init__.py",
line 162, in parse
 self.statemachine.run(inputlines, document, inliner=self.inliner)
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/parsers/rst/states.py",
line 174, in run
 input_source=document['source'])
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/statemachine.py",
line 239, in run
 context, state, transitions)
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/statemachine.py",
line 460, in check_line
 return method(match, context, next_state)
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/parsers/rst/states.py",
line 2706, in underline
 self.section(title, source, style, lineno - 1, messages)
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/parsers/rst/states.py",
line 331, in section
 self.new_subsection(title, lineno, messages)
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/parsers/rst/states.py",
line 399, in new_subsection
 node=section_node, match_titles=True)
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/parsers/rst/states.py",
line 286, in nested_parse
 node=node, match_titles=match_titles)
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/parsers/rst/states.py",
line 199, in run
 results = StateMachineWS.run(self, input_lines, input_offset)
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/statemachine.py",
line 239, in run
 context, state, transitions)
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/statemachine.py",
line 460, in check_line
 return method(match, context, next_state)
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/parsers/rst/states.py",
line 2706, in underline
 self.section(title, source, style, lineno - 1, messages)
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/parsers/rst/states.py",
line 331, in section
 self.new_subsection(title, lineno, messages)
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/parsers/rst/states.py",
line 399, in new_subsection
 node=section_node, match_titles=True)
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/parsers/rst/states.py",
line 286, in nested_parse
 node=node, match_titles=match_titles)
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/parsers/rst/states.py",
line 199, in run
 results = StateMachineWS.run(self, input_lines, input_offset)
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/statemachine.py",
line 239, in run
 context, state, transitions)
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/statemachine.py",
line 460, in check_line
 return method(match, context, next_state)
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/parsers/rst/states.py",
line 2279, in explicit_markup
 nodelist, blank_finish = self.explicit_construct(match)
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/parsers/rst/states.py",
line 2291, in explicit_construct
 return method(self, expmatch)
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/parsers/rst/states.py",
line 2034, in directive
 directive_class, match, type_name, option_presets)
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/parsers/rst/states.py",
line 2083, in run_directive
 result = directive_instance.run()
 File
"/usr/local/lib/python2.7/dist-packages/docutils-0.9.1-py2.7.egg/docutils/parsers/rst/__init__.py",
line 387, in run
 self.state, self.state_machine)
 File
"/usr/lib/pymodules/python2.7/matplotlib/sphinxext/plot_directive.py", line
210, in plot_directive
 return run(arguments, content, options, state_machine, state, lineno)
 File
"/usr/lib/pymodules/python2.7/matplotlib/sphinxext/plot_directive.py", line
598, in run
 raise RuntimeError("plot:: directive can't have both args and content")
RuntimeError: plot:: directive can't have both args and content
I don't see a reference in the documentation saying it's a feature that was
added in a newer version of mpl.
What am I doing wrong?
[1]:
http://matplotlib.org/devel/documenting_mpl.html#module-matplotlib.sphinxext.plot_directive

I installed using version 1.3.1 windows binary
"matplotlib-1.3.1.win32-py2.7.exe" from mathplotlib download. Installation
went fine, but when using the package, it says "dateutil" and "pyparsing"
are missing, which are supposed to be bundled according to the installation
instruction. Is this a bug or expected behavior from now on? I did not have
this issue for earlier versions of matplotlib.
My base python is 2.7.8.
If anyone is having the issue, either download the binaries from pythonlibs
mentioned above, or
install from the sources, which I did as follows:
(1) Install setuptools if you don't have it. 
 Download source from https://pypi.python.org/pypi/setuptools;
 Unpack and run 'ez_setup.py install'; or 'python ez_setup.py install'
 This will install setuptools.
 
(2) Install any other package by downloading the source, unpacking, and 
 running 'setup.py install'
 e.g., "dateutil" has been installed this way.
 https://pypi.python.org/pypi/python-dateutil, same for pyparsing
--
View this message in context: http://matplotlib.1069221.n5.nabble.com/installation-problem-tp43325p43606.html
Sent from the matplotlib - users mailing list archive at Nabble.com.