Hey Fernando,
On Fri, Jan 6, 2012 at 3:22 PM, Fernando Perez <fperez....@gmail.com> wrote:
> Hey Ondrej,
>
> 2012/1/6 Ondřej Čertík <ondrej.cer...@gmail.com>:
>> I didn't manage to work on this yet. If somebody who knows sphinx
>> internals can provide a hint how to best fix this, that'd be awesome.
>
> are the other parts of writing a thesis/book with sphinx working OK
> for you? I'm thinking:
>
> - labeled references for other elements besides equations, such as saying
>
> as we discuss in sec. \ref{integral}, then...
>
> in TeX, this will provide proper section number references, and can be
> used for pages, etc. I haven't actually tried this with sphinx, so
> maybe it already works with standard ref_ type labels.
That seems to work well across pages. See for example here:
http://theoretical-physics.net/dev/src/quantum/hf.html#nonlocal-exchange-potential-in-spherical-symmetry
In html, it reproduces the section title,
and in Tex it produces this code:
"
We used the result of the integral in
{\hyperref[src/math/spherical-harmonics:five-spherical-harmonics]{\emph{Example
VI}}} and also:
"
So this is not optimal for a thesis.
>
> - clean use of bibtex, including style file control.
Not implemented.
>
> - figure placement hints for floating figures.
This should hopefully be possible by modifying the Tex code generation.
>
> - more robust use of your $$ extension. Have you updated it? I don't
> remember the details, but I recall it was a bit fragile to use...
I didn't. It works great for me. I wrote already at least 300 pages of
math heavy book here:
http://theoretical-physics.net/
you can get there html version as well as a pdf. And it works 100% for me,
so I am not worried about that for writing a thesis.
>
>
> There may be more I can't think of now.
In general, the sphinx latex style is not optimal, but I have managed
to hack it pretty well.
So I think that is doable. I think the only problem is with:
* equations and section references
* literature (bibtex), especially accross files
However, it just occured to me, that almost all of the problems could
be fixed by simply merging all the .rst files into one by my own
script, and only then giving it to Sphinx. Then the only problem to
fix is:
* bibtex
* modify the latex template so that the thesis conforms to the school
format requirements.
I think that's what I'll do.
Ondrej
--
You received this message because you are subscribed to the Google Groups
"sphinx-dev" group.
To post to this group, send email to sphinx-dev@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.
