wxWidgets / Phoenix

wxPython's Project Phoenix. A new implementation of wxPython, better, stronger, faster than he was before.
http://wxpython.org/
2.33k stars 515 forks source link

ImportError when trying to build the html docs using Sphinx #693

Closed Demolishun closed 6 years ago

Demolishun commented 6 years ago

Operating system: Windows 7 wxPython version: 4.0.0rc1 Stock or custom build: stock Python version: 2.7.14 Stock or custom build: stock

Description of the problem: After downloading the source from Github and running make in the docs/sphinx directory with the command: "make html" I get the following error: Running Sphinx v1.6.6

Configuration error: There is a programable error in your configuration file:

Traceback (most recent call last): File "c:\python27\lib\site-packages\sphinx\config.py", line 157, in init execfile(filename, config) File "c:\python27\lib\site-packages\sphinx\util\pycompat.py", line 150, in execfile exec_(code, globals) File "c:\python27\lib\site-packages\six.py", line 709, in exec exec("""exec code in globs, locs""") File "", line 1, in File "conf.py", line 60, in from buildtools.config import Config ImportError: No module named buildtools.config

I did do a pip install buildtools --upgrade and I still get the same error. Is there another place I can download the docs for pheonix?

# Put code sample here
mesalu commented 6 years ago

All docs are available online: https://wxpython.org/Phoenix/docs/html/

If I remember correctly there are tarballs here: https://wxpython.org/Phoenix/snapshot-builds/ containing the documentation as well.

RobinD42 commented 6 years ago

The prerelease snapshot builds include the documentation. You can get them here: https://wxpython.org/Phoenix/snapshot-builds/

For the record, there is a lot of content for the docs that is generated during the build, and as you've seen there is also some supporting code that is needed during the build of the docs. So just downloading and running sphinx is not enough. Nearly everything in the project relating to project development is driven by the build.py script. To do a build from a git checkout, including the docs, you'll need to do something like this:

    python build.py dox etg sip build wxlib sphinx

If you're working from a source tarball instead of the git checkout, then only the last three command args are needed.

Demolishun commented 6 years ago

I downloaded a tarball as suggested. I am running "python build.py build wxlib sphinx". I installed visual c++ 2008 as it matches the version of python I have 32 bit and all that. It now errors out at with this message: "msvc: Impossible to find a valid architecture for building (in setup_msvc)". The tarball is: wxPython-4.0.0rc1.dev3549+ea4969d.tar.gz

All I want is an offline version of the docs for a machine that does not have internet all the time.

Are you using msvc 2008 for the Phoenix code?

Thanks

Demolishun commented 6 years ago

Okay, I solved the issue another way, I hope. I saw on the documentation site I could wxdocs to get the documentation. I tried that and it gave me an error not being able to find wxget. Then I ran wxget and it popped up and asked if I wanted to download a tarball with wx documentation in it. So I said yes! It seems to have retrieved an HTML version of the docs.

RobinD42 commented 6 years ago

The docs can also be downloaded manually if desired. The release versions are in https://extras.wxpython.org/wxPython4/extras/ and as mentioned before the preview snapshot version of the docs are in https://wxpython.org/Phoenix/snapshot-builds/