"make html" fails with
*"Could not import extension sphinx.ext.linkcode (exception: No module
named linkcode)"*
How can I get the docs to compile?

A quick google search did not help. IRC had friendly people, but did not
answer my question either. Maybe help here?

Steps:
git clone https://github.com/scikit-learn/scikit-learn.git # *
cd doc
make html # **
cd ..
python setup.py build
sudo python setup.py install
cd doc
make html

Running Sphinx v1.1.3
>
> Extension error:
> Could not import extension sphinx.ext.linkcode (exception: No module named
> linkcode)
> make: *** [html] Error 1
>

System: Ubuntu 14.04, python 2.7.3, numpy 1.8.0, scipy 0.11.0, GNU Make
3.81. Scikit itself does seem to be installed
$ pip show scikit-learn
Version: 0.16.dev

I'd also suggest someone who know what's up adding an "important files and
folders" to the docs/readme.md, something along the lines of

Homepage
> doc/index.rst

The sphinx theme
> doc/themes/scikit-learn

Where the js/css files live, etc.

Would help orient newcomers to the docs, since the long list of
files/folders may be overwhelming

Thanks,
--Nancy

*(a little silly to clone all 112 mb for just the docs, altho I am guessing
these docs depend on the examples folder in the root folder)

** this fails with something, I forget, it might have spit out an error log
but
nrw@PC:~$ dir -R | grep log | grep scikit
did not show anything so the log file is gone forever I guess

I should mention that I think the scikit-learn homepage & docs are
*really* well
designed compared to a lot of OSS projects. So I am compiling this repo in
the hopes of eventually implementing something similar for another project.
If that's not reasonable, let me know?

tl;dr *I'm here to steal your website. *(isn't that the point of BSD
licensing?)

Thanks,
--Nancy

~~~
narwhaledu.com (co-founder) educational robots
<http://gfycat.com/LightAlertArthropods> :)
www.orangenarwhals.com (blog)
arvados.org (open source bio software)
------------------------------------------------------------------------------
Dive into the World of Parallel Programming. The Go Parallel Website,
sponsored by Intel and developed in partnership with Slashdot Media, is your
hub for all things parallel software development, from weekly thought
leadership blogs to news, videos, case studies, tutorials and more. Take a
look and join the conversation now. http://goparallel.sourceforge.net/
_______________________________________________
Scikit-learn-general mailing list
Scikit-learn-general@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/scikit-learn-general

Reply via email to