Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Exception occurred when constructing documentation #9006

Closed
weixing02 opened this issue Mar 12, 2018 · 1 comment · Fixed by #9093
Closed

Exception occurred when constructing documentation #9006

weixing02 opened this issue Mar 12, 2018 · 1 comment · Fixed by #9093

Comments

@weixing02
Copy link
Collaborator

When i follow the steps provided by the documentation to construct documentation:
http://www.paddlepaddle.org/docs/develop/documentation/zh/dev/write_docs_cn.html#id5

cd TO_YOUR_PADDLE_CLONE_PATH
mkdir -p build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Debug -DWITH_GPU=OFF -DWITH_MKL=OFF -DWITH_DOC=ON
make gen_proto_py
make paddle_docs paddle_docs_cn

When I perform the last step:make paddle_docs paddle_docs_cn

Exception occurred as follow:

Exception occurred:
  File "/usr/local/lib/python2.7/dist-packages/recommonmark/states.py", line 134, in run_role
    content=content)
TypeError: 'NoneType' object is not callable
The full traceback has been saved in /tmp/sphinx-err-SkZanJ.log, if you want to report the issue to the developers.
Please also report this if it was a user error, so that a better error message can be provided next time.
A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!
doc/v2/CMakeFiles/paddle_docs_cn.dir/build.make:57: recipe for target 'doc/v2/CMakeFiles/paddle_docs_cn' failed
make[3]: *** [doc/v2/CMakeFiles/paddle_docs_cn] Error 2
CMakeFiles/Makefile2:19760: recipe for target 'doc/v2/CMakeFiles/paddle_docs_cn.dir/all' failed
make[2]: *** [doc/v2/CMakeFiles/paddle_docs_cn.dir/all] Error 2
CMakeFiles/Makefile2:19772: recipe for target 'doc/v2/CMakeFiles/paddle_docs_cn.dir/rule' failed
make[1]: *** [doc/v2/CMakeFiles/paddle_docs_cn.dir/rule] Error 2
Makefile:3837: recipe for target 'paddle_docs_cn' failed
make: *** [paddle_docs_cn] Error 2

Then @luotao1 figured out that the version of sphinx may cause this problem since my version of sphinx is 1.7.1 and i reinstalled sphinx by the version of 1.5.6, problem solved, thanks to @luotao1

@luotao1
Copy link
Contributor

luotao1 commented Mar 12, 2018

The reason is that our paddle:latest-dev image has wrong sphinx version.

pip install -U docopt PyYAML sphinx && \

@ranqiu92 If set the right version of sphinx, https://github.com/PaddlePaddle/PaddlePaddle.org/issues/442 may be fixed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants