9

我有一个简单的狮身人面像扩展如下：

from docutils import nodes
from docutils.parsers.rst import directives
from sphinx.util.compat import Directive

class testnode(nodes.Element):
    def __init__(self, *args, **kwargs):
        super(testnode, self).__init__(*args, **kwargs)
        self['foo'] = '?'

def visit_testnode_latex(self, node):
    self.body.append('Test: %s' % node['foo'])

def depart_testnode_latex(self, node):
    pass

def visit_testnode_html(self, node):
    self.body.append('<p>Test: %s</p>' % node['foo'])

def depart_testnode_html(self, node):
    pass

class TestDirective(Directive):
    has_content = False
    required_arguments = 0
    optional_arguments = 0
    final_argument_whitespace = False
    option_spec = {
        'foo': directives.unchanged,
    }

    def run(self):
        node = testnode()
        node['foo'] = self.options.get('foo')
        return [node]

def setup(app):
    app.add_directive("testdirective", TestDirective)
    app.add_node(testnode,
                 html=(visit_testnode_html,
                       depart_testnode_html),
                 latex=(visit_testnode_latex,
                        depart_testnode_latex))

给定一个包含

.. testdirective::
   :foo: bar

HTML 输出包含 »Test: bar« 但 LaTeX 输出包含 »Test: ?« （默认值）。node['foo']我在分配后检查了它是否具有正确的值TestDirective.run()，但在 LaTeX 编写器运行之前，它似乎不会一直存在。

我究竟做错了什么？

4

1 回答 1

4

在逐步浏览了 Sphinx 的 LaTeX writer 之后，我在这里发现了问题。这是您在初始化程序中为'foo'关键字设置默认值的方式。testnode

LaTeX 编写器有一个要点，它对整个文档树进行深度复制，以便将其内联到另一棵树中。节点上的 deepcopyElement初始化同一个类的新节点，并通过构造函数传递原始节点的所有属性和内容。因此，当您testnode被复制时，您的构造函数会覆盖传递给构造函数的原始 'foo' 属性。而是这样写，它应该可以工作：

class testnode(nodes.Element):
    def __init__(self, *args, **kwargs):
        super(testnode, self).__init__(*args, **kwargs)
        if 'foo' not in self:
            self['foo'] = '?'

这将防止您的默认值覆盖已传递给构造函数的属性的任何显式值。还有其他几种可能的变体。

于 2012-12-21T16:28:29.553 回答