2012/1/7 Ondřej Čertík <ondrej.cer...@gmail.com>:
> 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.
True, and it may be the right solution for you. Though it would be
great if instead of needing manual post-processing with extra tools,
this was possible out of the box in sphinx.
It's trivial to export an ipython notebook to rst, so if these things
were possible within sphinx, the combination of sphinx and ipython
would make it very, very easy to create complex documents like your
book or a thesis but with sections that have code and plots produced
from notebooks. All you'd need is in your makefile to have a rule
%.rst : %.ipynb
ipython nbexport --sphinx $<
[ note, right now 'ipython nbexport' doesn't really exist, but the
basics are just this: https://gist.github.com/1569580 and we'll have
it soon in a more clean implementation]
Your sphinx project could then consist of a mixture of hand-written
.rst files and ipynb ones for the compute-heavy stuff.
Obviously one could carry around your script as an extra tool, but the
more this works out of the box, the easier gaining widespread adoption
it will be.
Still, do let us know how it goes and please do post any additional
tools you develop for this; we're likely to reuse them :)
Cheers,
f
--
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.
