[AstroPy] docs building issue

[Russell Hewett]

Hi Miguel,

It is commented out.  With sphinx 1.1.3 it works fine, but with graphviz
installed, this code (from astropy/astropy/sphinx/conf.py) indicates that a
newer sphinx is needed (which I have installed).

def get_graphviz_version():
    try:
        output = subprocess.check_output(
            ['dot', '-V'], stdin=subprocess.PIPE,
            stderr=subprocess.STDOUT,
            shell=True)
    except subprocess.CalledProcessError:
        return '0'
    tokens = output.split()
    for token in tokens:
        if re.match(b'[0-9.]*', token):
            return token.decode('ascii')
    return '0'

graphviz_found = LooseVersion(get_graphviz_version())
graphviz_broken = LooseVersion('0.30')

if graphviz_found >= graphviz_broken:
    needs_sphinx = '1.2b2'
else:
    needs_sphinx = '1.1'




On Wed, Nov 20, 2013 at 6:04 PM, Miguel de Val-Borro <miguel.deval at gmail.com
> wrote:

> Hi Russell,
>
> Can you check the setting of the "needs_sphinx" variable in the
> astropy/docs/conf.py configuration file? If the file has not been
> modified locally this line should be commented out. I have just tried to
> build the HTML documentation from the current master branch and it
> worked fine with Sphinx 1.1.3 on a Linux system.
>
> Miguel
>
> On Wed, Nov 20, 2013 at 04:11:19PM -0500, Russell Hewett wrote:
> > Hi All,
> >
> > I can't seem to get the docs to build, ever since I installed graphviz.
>  It
> > worked beforehand, with the older version of sphinx that comes with
> > anaconda.  Any ideas?
> >
> > C:\Users\rhewett\research\software-projects\astropy\docs>make html
> > Running Sphinx v1.2b2
> >
> > Sphinx version error:
> > This project needs at least Sphinx v1.2b2 and therefore cannot be built
> > with this version.
> >
> > (Also doesn't work with 1.2b3)
> >
> > C:\Users\rhewett\research\software-projects\astropy\docs>ipython
> > Python 2.7.5 |Anaconda 1.7.0 (64-bit)| (default, Jul  1 2013, 12:37:52)
> > [MSC v.1500 64 bit (AMD64)]
> > Type "copyright", "credits" or "license" for more information.
> >
> > IPython 1.1.0 -- An enhanced Interactive Python.
> > ?         -> Introduction and overview of IPython's features.
> > %quickref -> Quick reference.
> > help      -> Python's own help system.
> > object?   -> Details about 'object', use 'object??' for extra details.
> >
> > In [1]: import sphinx
> >
> > In [2]: sphinx.__version__
> > Out[2]: '1.2b2'
> >
> >
> > -Russ
> >
> > --
> > Russell J. Hewett
> > Postdoctoral Associate
> > Imaging and Computing Group
> > Department of Mathematics
> > Massachusetts Institute of Technology
> > www.russellhewett.com
>
> > _______________________________________________
> > AstroPy mailing list
> > AstroPy at scipy.org
> > http://mail.scipy.org/mailman/listinfo/astropy
>
> _______________________________________________
> AstroPy mailing list
> AstroPy at scipy.org
> http://mail.scipy.org/mailman/listinfo/astropy
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/astropy/attachments/20131120/552cb87d/attachment.html>