Bug in Sphinx plotdirective on Windows

I have built the sphinx sampledoc tutorial without problems on Ubuntu and OSX, but I’m having problems on Windows. I have filed a bug regarding the problems I am having with the plot directive. For some reason the hyperlinks to the PDF and get messed up on windows, but are fine on OSX and Ubuntu. I have to run a virtual machine just to compile my documentation. Needless to say, not optimal. I attached a screenshot with the messed up links, and I have posted the build errors I get that I think are related to the problems with the plot directive. I have the same problem in my own documentation that I am building on my own plotting module based on MPL.

D:\My_Documents\sampledoc_tut2\extensions.rst:: (ERROR/3) Anonymous hyperlink mismatch: 5 references but 0 targets.

See “backrefs” attribute for IDs.

process_begin: CreateProcess(NULL, echo, …) failed.

make (e=2): The system cannot find the file specified.

make: *** [html] Error 2

plotDirective.jpg

···

Ian Bell
Graduate Research Assistant
Herrick Labs
Purdue University

email: ibell@…901…
cell: (607)227-7626

Curious, there are forward slashes in those links. Which version of
mpl are you building documentation for?

Ben Root

···

On Sunday, January 30, 2011, Ian Bell <ibell@...901...> wrote:

I have built the sphinx sampledoc tutorial without problems on Ubuntu and OSX, but I'm having problems on Windows. I have filed a bug regarding the problems I am having with the plot directive. For some reason the hyperlinks to the PDF and get messed up on windows, but are fine on OSX and Ubuntu. I have to run a virtual machine just to compile my documentation. Needless to say, not optimal. I attached a screenshot with the messed up links, and I have posted the build errors I get that I think are related to the problems with the plot directive. I have the same problem in my own documentation that I am building on my own plotting module based on MPL.

D:\My_Documents\sampledoc_tut2\extensions.rst:: (ERROR/3) Anonymous hyperlink mismatch: 5 references but 0 targets.See "backrefs" attribute for IDs.

process_begin: CreateProcess(NULL, echo, ...) failed.
make (e=2): The system cannot find the file specified.make: *** [html] Error 2

----
Ian Bell
Graduate Research Assistant
Herrick Labs
Purdue University
email: ibell@...901...
cell: (607)227-7626

Ben,

I’m building with the freshest subversion build of MPL with Sphinx 1.0.7 and Windows XP. I’d be happy to give you any other information that you need, just let me know.

Ian

···

Ian Bell
Graduate Research Assistant
Herrick Labs
Purdue University
email: ibell@…901…
cell: (607)227-7626

On Sun, Jan 30, 2011 at 11:34 PM, Benjamin Root <ben.root@…553…> wrote:

On Sunday, January 30, 2011, Ian Bell <ibell@…901…> wrote:

I have built the sphinx sampledoc tutorial without problems on Ubuntu and OSX, but I’m having problems on Windows. I have filed a bug regarding the problems I am having with the plot directive. For some reason the hyperlinks to the PDF and get messed up on windows, but are fine on OSX and Ubuntu. I have to run a virtual machine just to compile my documentation. Needless to say, not optimal. I attached a screenshot with the messed up links, and I have posted the build errors I get that I think are related to the problems with the plot directive. I have the same problem in my own documentation that I am building on my own plotting module based on MPL.

D:\My_Documents\sampledoc_tut2\extensions.rst:: (ERROR/3) Anonymous hyperlink mismatch: 5 references but 0 targets.See “backrefs” attribute for IDs.

process_begin: CreateProcess(NULL, echo, …) failed.

make (e=2): The system cannot find the file specified.make: *** [html] Error 2


Ian Bell

Graduate Research Assistant

Herrick Labs

Purdue University

email: ibell@…901…

cell: (607)227-7626

Curious, there are forward slashes in those links. Which version of

mpl are you building documentation for?

Ben Root

If you aren't sure, just paste the results of 'svn info' (or whatever
equivalent in your windows svn client).

Ben Root

···

On Sunday, January 30, 2011, Ian Bell <ibell@...901...> wrote:

Ben,
I'm building with the freshest subversion build of MPL with Sphinx 1.0.7 and Windows XP. I'd be happy to give you any other information that you need, just let me know.

Ian----
Ian Bell
Graduate Research Assistant
Herrick Labs
Purdue University
email: ibell@...901...
cell: (607)227-7626

From which branch? The development branch or the maintenance branch?

Ben,

Its the main trunk, svn info is below:

Path: .

URL: https://matplotlib.svn.sourceforge.net/svnroot/matplotlib/trunk/matplotlib

Repository Root: https://matplotlib.svn.sourceforge.net/svnroot/matplotlib

Repository UUID: f61c4167-ca0d-0410-bb4a-bb21726e55ed

Revision: 8935

Node Kind: directory

Schedule: normal

Last Changed Author: pivanov314

Last Changed Rev: 8935

Last Changed Date: 2011-01-24 04:41:49 -0500 (Mon, 24 Jan 2011)

Ian

···

Ian Bell
Graduate Research Assistant
Herrick Labs
Purdue University
email: ibell@…901…
cell: (607)227-7626

On Mon, Jan 31, 2011 at 1:36 AM, Benjamin Root <ben.root@…553…> wrote:

On Sunday, January 30, 2011, Ian Bell <ibell@…901…> wrote:

Ben,

I’m building with the freshest subversion build of MPL with Sphinx 1.0.7 and Windows XP. I’d be happy to give you any other information that you need, just let me know.

Ian----

Ian Bell

Graduate Research Assistant

Herrick Labs

Purdue University

email: ibell@…901…

cell: (607)227-7626

From which branch? The development branch or the maintenance branch?

If you aren’t sure, just paste the results of ‘svn info’ (or whatever

equivalent in your windows svn client).

Ben Root

Ben,

I had a thought about what you noticed with the paths, so I got in there and modified plot_directive.py to replace all the ‘/’ with os.sep, but it didn’t seem to do anything. All the links were still broken even though it seems like they all point to the right places. A problem of absolute versus relative paths? The paths to the inline plots all seem to take absolute paths and the RST links are relative.

Ian

···

Ian Bell
Graduate Research Assistant
Herrick Labs
Purdue University
email: ibell@…901…
cell: (607)227-7626

On Mon, Jan 31, 2011 at 1:43 AM, Ian Bell <ibell@…901…> wrote:

Ben,

Its the main trunk, svn info is below:

Path: .

URL: https://matplotlib.svn.sourceforge.net/svnroot/matplotlib/trunk/matplotlib

Repository Root: https://matplotlib.svn.sourceforge.net/svnroot/matplotlib

Repository UUID: f61c4167-ca0d-0410-bb4a-bb21726e55ed

Revision: 8935

Node Kind: directory

Schedule: normal

Last Changed Author: pivanov314

Last Changed Rev: 8935

Last Changed Date: 2011-01-24 04:41:49 -0500 (Mon, 24 Jan 2011)

Ian


Ian Bell
Graduate Research Assistant
Herrick Labs
Purdue University
email: ibell@…901…
cell: (607)227-7626

On Mon, Jan 31, 2011 at 1:36 AM, Benjamin Root <ben.root@…553…> wrote:

On Sunday, January 30, 2011, Ian Bell <ibell@…901…> wrote:

Ben,

I’m building with the freshest subversion build of MPL with Sphinx 1.0.7 and Windows XP. I’d be happy to give you any other information that you need, just let me know.

Ian----

Ian Bell

Graduate Research Assistant

Herrick Labs

Purdue University

email: ibell@…924…01…

cell: (607)227-7626

From which branch? The development branch or the maintenance branch?

If you aren’t sure, just paste the results of ‘svn info’ (or whatever

equivalent in your windows svn client).

Ben Root