狮身人面像不能运行'make html' [英] Sphinx can't run 'make html'

查看:235
本文介绍了狮身人面像不能运行'make html'的处理方法,对大家解决问题具有一定的参考价值,需要的朋友们下面随着小编来一起学习吧!

问题描述

我试图通过sphinx工具为我的软件创建文档,因此我运行了 sphinx-quickstart ,并且它消失了一切都好。 然后我必须运行 make html (在刚创建的doc文件夹内)和我收到错误。我不知道如何解决这个错误:

 运行Sphinx v1.2.2 
加载pickle环境...尚未创建
building [html]:针对已过期的1个源文件的目标
更新环境:已添加1个,已更改0个,已删除
个阅读来源... [100%]索引
**(sphinx-build:2390):警告**:无法使用辅助功能总线注册:没有收到回复。可能的原因包括:远程应用程序未发送回复,消息总线安全策略阻止回复,回复超时过期或网络连接中断。
/usr/lib/python2.7/dist-packages/gobject/constants.py:24:Warning:g_boxed_type_register_static:assertion'g_type_from_name(name)== 0'failed
import gobject._gobject
/usr/lib/python2.7/dist-packages/gtk-2.0/gtk/__init__.py:40:警告:类型'PyGtkGenericCellRenderer'的指定类大小小于父类型的'GtkCellRenderer'类大小
from gtk import _gtk
/usr/lib/python2.7/dist-packages/gtk-2.0/gtk/__init__.py:40:Warning:g_type_get_qdata:assertion'node!= NULL'failed
from gtk import _gtk
make:*** [html] Ucciso

我已经浏览网页,然后提示 help('modules')

  /usr/lib/python2.7/dist-packages/gobject/constants.py:24:Warning:g_boxed_type_register_static:assertion'g_type_from_name(name)== 0'failed 
import gobject。 _gobject

您可以帮我吗?
有些研究表明这里有两个问题,它们可能相互关联也可能不相关,但都与Ubuntu有关,我认为你必须如果您尚未启用Ubuntu的辅助功能,则辅助功能总线可能无法使用。

如果您不打算执行此操作,请简单解决方法是运行

export NO_AT_BRIDGE = 1



在运行Sphinx之前在shell提示符下运行。或者,您可以 / etc / env下添加此设置.d 并重新启动以使其成为永久性的。

幸运的是,这将解决整个问题,但在可能的情况下,不是: 一个已知问题与PyGTK在最近版本的Ubuntu上可以产生GTK警告,你看到(并经常出现分段错误)。这个显然与 PyGTK从静态绑定到动态绑定到GTK库有关;如果您创建了一种情况,即软件试图同时使用两种类型的绑定,则可能会触发此问题。

错误报告中,似乎没有好的解决方案还有。


I'm trying to create the documentation for my software by sphinx tool, so i've run sphinx-quickstart, and it's gone all ok.

Then i have to run make html (inside doc folder just created) and i get an error. I don't know how to fix this error:

Running Sphinx v1.2.2
loading pickled environment... not yet created
building [html]: targets for 1 source files that are out of date
updating environment: 1 added, 0 changed, 0 removed
reading sources... [100%] index                                                 
** (sphinx-build:2390): WARNING **: Couldn't register with accessibility bus: Did not receive a reply. Possible causes include: the remote application did not send a reply, the message bus security policy blocked the reply, the reply timeout expired, or the network connection was broken.
/usr/lib/python2.7/dist-packages/gobject/constants.py:24: Warning: g_boxed_type_register_static: assertion 'g_type_from_name (name) == 0' failed
  import gobject._gobject
/usr/lib/python2.7/dist-packages/gtk-2.0/gtk/__init__.py:40: Warning: specified class size for type 'PyGtkGenericCellRenderer' is smaller than the parent type's 'GtkCellRenderer' class size
  from gtk import _gtk
/usr/lib/python2.7/dist-packages/gtk-2.0/gtk/__init__.py:40: Warning: g_type_get_qdata: assertion 'node != NULL' failed
  from gtk import _gtk
make: *** [html] Ucciso

I've surfed the web and i prompted help('modules'):

/usr/lib/python2.7/dist-packages/gobject/constants.py:24: Warning: g_boxed_type_register_static: assertion 'g_type_from_name (name) == 0' failed
  import gobject._gobject

Can you help me please?

解决方案

A bit of research suggests there are two problems here, which may or may not be related to each other but are both related to Ubuntu, which I think you must be running.

  1. The "accessibility bus" may not be available if you haven't enabled Ubuntu's accessibility features. If you don't plan to do this, the simple workaround is to run

    export NO_AT_BRIDGE=1

    at the shell prompt before running Sphinx. Alternatively you can add this setting under /etc/env.d and restart to make it permanent.

    With luck this will solve the entire problem, but in the likely case it doesn't:

  2. There is a known issue with PyGTK on recent versions of Ubuntu that can produce the GTK warnings you're seeing (and frequently a segmentation fault as well). This apparently has to do with PyGTK transitioning from static to dynamic binding against the GTK library; if you create a situation where software attempts to use both types of binding simultaneously, it can trigger this problem.

    Apart from some ideas to try in the bug report it seems there is no good solution yet.

这篇关于狮身人面像不能运行'make html'的文章就介绍到这了,希望我们推荐的答案对大家有所帮助,也希望大家多多支持IT屋!

查看全文
登录 关闭
扫码关注1秒登录
发送“验证码”获取 | 15天全站免登陆