DOC: Generating docs doesn't work if path has whitespaces

[datapythonista]

Related to #20862

If there are spaces in the path where pandas is installed (e.g. /home/my user/my code/pandas), when building the documentation (i.e. ./doc/make.py html) seems to generate a long list of usage errors like those:

UsageError: %bookmark: too many arguments
UsageError: %bookmark -d: Can't delete bookmark 'ipy_savedir'

[michaela12]

Hi, I'd like to take this issue if it's still open!

[datapythonista]

Sure, thanks for the help @michaela12

[mbain108]

Is this issue still open? If not, I would like to take a look at it.

[michaela12]

@mbain108 Hi, It's still open! So feel free to take a look at it!

[datapythonista]

yes, let us know if you need help @mbain108

[Jaisu-1]

Hi, can I take a look at this?

[WillAyd]

Go for it!

[MaxVanDeursen]

@jopenmolles and I have investigated this issue and are able to reproduce this error. We have noticed that the parameters are passed correctly during execution (i.e. the spaces are escaped when executing the command).

Running sphinx-build directly from the command line gives the same error as using make.py, which strongly suggests that the issue is due to sphinx-build rather than because of an error in pandas.

The question now is whether to create a workaround for this, or to leave it until sphinx-build fixes this issue.

[datapythonista]

Can you copy the whole call the sphinx-build that is failing? I didn't have the impression that sphinx-build was the problem when opened the issue.

[MaxVanDeursen]

@datapythonista I am running the following command,:

sphinx-build -b html -j 4 -d /home/max/contain\ space/pandas/doc/build/doctrees /home/max/contains\ space/pandas/doc/source /home/max/contains\ space/pandas/doc/build/html

Note that the contains space folder contains a space.