[sphinx-dev] Problem with mathmpl Sphinx extension

2010-07-14 Thread David
I'm using Python 2.6, Sphinx 1.0 and matplotlib 1.0.0 and have an
issue I can't figure out using the mathmpl.py sphinx extension.

The following math text seems to work fine in matplotlib (when used as
plot title for example):
r'$M = \left[ \frac{2}{\gamma - 1} \left( \frac{T_t}{T_s} - 1 \right)
\right] ^{0.5}$'

However, when used in a sphinx source file I get the following
warning:

#C:\Python26\lib\site-packages\matplotlib\sphinxext\mathmpl.py:56:
Warning:
Could not render math expression $M = \left[ \frac{2}{\gamma - 1}
\left( \frac{T_t}{
T_s} - 1 \right) \right] ^{0.5}$
Warning)

The actual exception message raised is:

Exception occurred:
  File "C:\Python26\lib\site-packages\matplotlib\mathtext.py", line
1997, in raise_error
raise ParseFatalException(msg + "\n" + s)
ParseFatalException: Expected end of math '$'
$M = \left[ \frac{2}{\gamma - 1} \left( \frac{T_t}{T_s} \\- 1 \right)
\right] ^{
0.5}$ (at char 0), (line:1, col:1)
The full traceback has been saved in c:\users\dparke~1.tda\appdata
\local\temp\sp
hinx-err-jz__zp.log, if you want to report the issue to the
developers.
Please also report this if it was a user error, so that a better error
message c
an be provided next time.
Either send bugs to the mailing list at ,
or report them in the tracker at . Thanks!

Note, the problem arose when I added the nested groups: \left[ ...
\left( ... \right) ... \right]. The problem does not occur if I remove
either the outer square bracket or the inner parentheses. I'm not very
knowledgeable of Tex math syntax but the equation seems to parse
properly in all the online Tex equation editors and in matplotlib
plots. Any advice on how to proceed would be greatly appreciated.

Thanks,
Dave

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To post to this group, send email to sphinx-...@googlegroups.com.
To unsubscribe from this group, send email to 
sphinx-dev+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/sphinx-dev?hl=en.



[sphinx-dev] Re: Doxygen link extension

2010-07-14 Thread Matt Williams
On Jul 9, 7:07 pm, Kevin Horn  wrote:
> You might also be interested in looking at some of the other extensions that
> do external linking from sphinx.  I recently put a "traclinks" extension [1]
> in the sphinx-contrib repo.  I've also created an extension which creates
> links to pydoctor documentation, which I'll be publishing to the
> sphinx-contrib repo soon, but haven't yet.  You can find it in the
> lore2sphinx repo [2] for the moment, though it's called "apilinks" there.
> In any case, I hope when you have your extension polished up, you'll
> consider publishing it to the sphinx-contrib repo (or somewhere else) for
> others to benefit from.

Cool. I've had a look at some of those and they're all doing things in
a fairly similar way. They're good reference, thanks.

I've also now added my extension (renamed to doxylink to avoid
confusion with Breathe) to sphinx-contrib. It's available at [1].

> And I totally agree that a list of docutils node types would be
> crazy-useful.  I've also been looking for something like that for a while.

Yeah, does anyone else have an idea on where to start with this?

Regards,
Matt

[1] http://bitbucket.org/birkenfeld/sphinx-contrib/src/tip/doxylink/

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To post to this group, send email to sphinx-...@googlegroups.com.
To unsubscribe from this group, send email to 
sphinx-dev+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/sphinx-dev?hl=en.



[sphinx-dev] chapter to section level in Latex-output, or changing chapter name

2010-07-14 Thread peo
Hi Sphinx-users and developers,
i greatly appreciate the Sphinx auto-documentation system, so thanks a
lot for it! Now to my question:

* For Sphinx 0.6.7 i could not get the sphinx-build generated latex
code to be run through latex directly - rather as in the Makefile it
seems to be intended to be run through pdflatex. Or maybe the Latex2e
program version is very old (from  2001/06/01) at the system i m
working on. In order to use latex, i changed some smaller things in
the *tex and *sty files: utf8 changed to latin1, MakeFramed commented
out, and XeTeXrevision start and end of if-statement commented. Now it
works fine.

However, i would like to change level "-1 level" of how the document
is divided into parts, such that

The former chapters, become sections,
the former sections become subsections,
the former subsections become subsubsections, etc.

(without scanning through the *tex files to replace \subsections with
\subsubsections, etc.)

Would that be possible ?

* If keeping chapters, would it be possible to change the chapter
names: To say only  , instead of "Chapter
 \\
 
"  as is default.

Thanks,
Peter




-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To post to this group, send email to sphinx-...@googlegroups.com.
To unsubscribe from this group, send email to 
sphinx-dev+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/sphinx-dev?hl=en.