Re: [sphinx-dev] Re: equations references across files

2012-01-08 Thread Fernando Perez
2012/1/8 Ondřej Čertík ondrej.cer...@gmail.com: I now routinely use SymPy in the book, just an example from a few days ago: http://theoretical-physics.net/dev/src/math/groups.html#example-i Scroll a few pages for the longer script + output. I would love to make this interactive using the

Re: [sphinx-dev] Re: equations references across files

2012-01-07 Thread Fernando Perez
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

Re: [sphinx-dev] Re: equations references across files

2012-01-06 Thread Fernando Perez
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: -

Re: [sphinx-dev] Splitting HTML output at subsection boundaries

2011-12-05 Thread Fernando Perez
On Thu, Dec 1, 2011 at 9:04 AM, Friedrich Romstedt friedrichromst...@gmail.com wrote: 2011/12/1 Fernando Perez fperez@gmail.com: On Thu, Dec 1, 2011 at 2:56 AM, Friedrich Romstedt friedrichromst...@gmail.com wrote: 1)  Spanning paragraphs over equations.  Paragraphs are in Docutils

Re: [sphinx-dev] Splitting HTML output at subsection boundaries

2011-12-01 Thread Fernando Perez
On Thu, Dec 1, 2011 at 2:56 AM, Friedrich Romstedt friedrichromst...@gmail.com wrote: 1)  Spanning paragraphs over equations.  Paragraphs are in Docutils a nonstructured entity.  In depends on the point of view if this is a design mistake or not.  For the Sphinx purpose, it might be not, for

Re: [sphinx-dev] Editing of Sphinx documents through web....

2011-09-21 Thread Fernando Perez
On Tue, Sep 20, 2011 at 10:59 PM, ashwin rashwi...@gmail.com wrote: I have a requirement, in which users would like to edit the Sphinx documentation, through a web based interface. I understand that currently, there is no such application available. Any pointers in this regard to an existing

[sphinx-dev] Re: Lots of strange spurious whitespace before images in html builds

2011-02-22 Thread Fernando Perez
Hi all, On Wed, Feb 16, 2011 at 9:51 PM, Fernando Perez fperez@gmail.com wrote: Hi all, I hadn't updated my sphinx in quite a while, but after a recent rebuild of my website, I noticed that now, certain pages with images in them have a massive amount of spurious vertical whitespace

Re: [sphinx-dev] Re: MathJax

2010-08-24 Thread Fernando Perez
On Tue, Aug 24, 2010 at 2:58 PM, Kevin Dunn kgd...@gmail.com wrote: You can compare how the same HTML page is shown with MathJax or with Sphinx's built-in pngmath extension: * mathjax: http://connectmv.com/mathjax-extension/with-mathjax.html * pngmath:

Re: [sphinx-dev] Included non-rst files not copied to _source directory

2010-03-29 Thread Fernando Perez
On Mon, Mar 29, 2010 at 2:42 PM, TP wing...@gmail.com wrote: However, as described in my Include directive doesn't correctly support 'absolute' paths message, includes seem to be useless when used from multiple subdirs in the same project. Unless I'm missing something, there doesn't seem to

Re: [sphinx-dev] Non-trivial conditional include with ifconfig?

2010-02-26 Thread Fernando Perez
Hi, On Sun, Feb 21, 2010 at 9:46 AM, Georg Brandl ge...@python.org wrote: @Günter: section titles can be matched in nested parsing if you set the match_titles argument to true.  I am very happy that this works, other- wise autodoc would have lots of problems with titles in docstrings. Where

Re: [sphinx-dev] Non-trivial conditional include with ifconfig?

2010-02-09 Thread Fernando Perez
Hi Kevin, On Fri, Feb 5, 2010 at 11:58 AM, Kevin Dunn kgd...@gmail.com wrote: That could be it.  I use the 1.00 version from hg because of a bug in prior versions with and symbols that appear in source code with LaTeX output. Did you actually build these and got the expected output? I

Re: [sphinx-dev] Non-trivial conditional include with ifconfig?

2010-02-09 Thread Fernando Perez
On Tue, Feb 9, 2010 at 10:52 PM, Fernando Perez fperez@gmail.com wrote: Did you actually build these and got the expected output?  I updated sphinx to hg trunk, and even though now your approach doesn't give me any errors, it simply won't produce any output for that section. Scratch

Re: [sphinx-dev] Non-trivial conditional include with ifconfig?

2010-02-05 Thread Fernando Perez
On Thu, Feb 4, 2010 at 7:18 PM, Kevin Dunn kgd...@gmail.com wrote: I use the same idea for my class notes - the students get one version and the projector notes get a different version. This is what I ended up doing it (there may be a better way!): Thanks a lot, this will do for now, though

Re: [sphinx-dev] Re: Non-trivial conditional include with ifconfig?

2010-02-05 Thread Fernando Perez
Hi Guenter, On Fri, Feb 5, 2010 at 3:08 AM, Guenter Milde mi...@users.berlios.de wrote: An easy workaround is to use a rubric instead (if no ToC is required). Docutils circumvents this problem with the `strip-elements-with-class` configuration item like::  .. class:: solution  Solution  

Re: [sphinx-dev] Non-trivial conditional include with ifconfig?

2010-02-05 Thread Fernando Perez
On Fri, Feb 5, 2010 at 11:26 AM, Kevin Dunn kgd...@gmail.com wrote: Below is how I how did it.  But on re-reading your question, I realize this is probably not exactly what you want - you can create a nested subsection, but you can't go back to a higher level section. Your approach would be

[sphinx-dev] Specifying the config *file* directly?

2010-02-04 Thread Fernando Perez
Hi, I'm wondering why sphinx allows me to specify the path of the directory to conf.py, but not the *actual file*, that seems to be hardcoded to be named conf.py. It would be great to allow the specification of the file by name, so that one could have conf-simple.py conf-foo.py conf-bar.py

[sphinx-dev] Non-trivial conditional include with ifconfig?

2010-02-04 Thread Fernando Perez
Hi all, I need to include some material (exercise solutions) for a doc build only in certain cases, but all my attempts so far are failing. This: .. ifconfig:: include_solutions==True Something trivial Works, and I see 'something trivial' in the pdf (I set ifconfig as per

Re: [sphinx-dev] Creating documents other than technical documentation -- is there no interest in this regard?

2010-01-13 Thread Fernando Perez
On Tue, Jan 12, 2010 at 1:32 PM, Max Battcher m...@worldmaker.net wrote: Lately I've been using reST (and Sphinx when needed) for everything from blog posts to fiction writing to python documentation. Same here, in case anyone finds it useful: - converts rst to html that blogger will swallow,

Re: [sphinx-dev] Re: documenting instance attributes

2010-01-04 Thread Fernando Perez
On Mon, Jan 4, 2010 at 3:45 PM, Edward Z. Yang ezy...@mit.edu wrote: What version of Sphinx are you using? hg from just right now (I updated from trunk before posting to make sure I had the latest) Cheers, f -- You received this message because you are subscribed to the Google Groups

[sphinx-dev] Re: GSL shell announce

2009-11-08 Thread Fernando Perez
On Sun, Nov 8, 2009 at 9:21 AM, Georg Brandl ge...@python.org wrote: -BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Fernando Perez schrieb: On Mon, Oct 5, 2009 at 10:58 AM, Francesco francesco@gmail.com wrote: Of course the documentation is written with Sphinx. I think Sphinx and reST

[sphinx-dev] Re: GSL shell announce

2009-10-06 Thread Fernando Perez
On Mon, Oct 5, 2009 at 10:58 AM, Francesco francesco@gmail.com wrote: Of course the documentation is written with Sphinx. I think Sphinx and reST are really great piece of software and now for me it is a pleasure to write the documentation. Just one problem, I cannot find an HTML theme

[sphinx-dev] Re: Section headings in docstrings

2009-10-05 Thread Fernando Perez
Howdy, On Mon, Oct 5, 2009 at 1:47 PM, Oben obenso...@googlemail.com wrote: @Fernando: Do you know if integrating the numpy doc extension into Sphinx is in discussion or already in progress? I don't think it's happened yet, though I only joined this list very recently. But I'm pretty sure

[sphinx-dev] Re: Section headings in docstrings

2009-10-04 Thread Fernando Perez
On Sun, Oct 4, 2009 at 10:04 AM, Mike Hansen mhan...@gmail.com wrote: Sage (http://www.sagemath.org/doc/) does use Sphinx's default markup (although not idiomatically in many cases due to autoconversion from a previous markup.)  However, a patch was just accepted to allow $...$ to delimit

[sphinx-dev] Re: Section headings in docstrings

2009-10-03 Thread Fernando Perez
Hi, On Sat, Oct 3, 2009 at 2:13 PM, Oben obenso...@googlemail.com wrote: But seriously, if reST and Sphinx are supposed to be the standard for Python documentation, isn't backwards to force shifting API documentation out of the docstrings? AFAIK the official Python documentation is written

[sphinx-dev] Why does sphinx contact python.org on an html build?

2009-10-02 Thread Fernando Perez
Howdy, I noticed that every time I run make clean make html on a sphinx-based site, I have a short stall and network activity, so I ran wireshark in the background, and it captured this conversation between my machine and 82.94.164.162: GET /objects.inv HTTP/1.1 Accept-Encoding: identity

[sphinx-dev] Re: Why does sphinx contact python.org on an html build?

2009-10-02 Thread Fernando Perez
On Fri, Oct 2, 2009 at 4:36 AM, jo...@lophus.org wrote: That's the sphinx plugin intersphinx which automatically links references to standard-python (or other, if you configure it to do so) names (e.g. `list`, `str`, `int`, `map`, `filter` but also `configparser`, `os`, `sys` and so on).

[sphinx-dev] Re: Excluding some docstrings

2009-09-17 Thread Fernando Perez
2009/9/17 jhayes fac...@gmail.com: Are there any directives that will exclude a docstring from being a part of the built documentation?  For instance, I am using the automodule directive, but would like some docstrings to not be in the final documentation.  Is there a way to do this without

[sphinx-dev] Re: Auto-documentation issues and limitations

2009-09-14 Thread Fernando Perez
On Mon, Sep 14, 2009 at 1:35 PM, Tim Michelsen timmichel...@gmx-topmail.de wrote: 1. - Is there any way to create auto-documentation of a project without generating the rst files and setting the auto-doc strings (automodule, autoclass...) for each module and class manually? Although this

Re: [Nipy-devel] Sphinx custom extension mess, and patches

2009-02-20 Thread Fernando Perez
On Mon, Feb 16, 2009 at 3:21 PM, Gael Varoquaux gael.varoqu...@normalesup.org wrote: I am not blaming anyone, just pointing out a non ideal situation. It has already improved a lot with the matplotlib guys and the scipy guys merging some changes in extensions and publishing the extensions in