Добавить ссылку из директивы

Question

Я пытаюсь написать настраиваемую директиву, которая испускает ссылку на другой раздел, но я не могу найти документацию о доступных типах узлов или как прагматически испускать ссылку.

test.rst

.. _test: 

Test 
==== 

.. test:: 

The test directive should generate a reference in the form of :ref:`test`. 

test.py

from docutils import nodes 
from docutils.parsers.rst import Directive 

def setup(app): 
    app.add_directive('test', TestDirective) 
    return {'version': '0.1'} 

class TestDirective(Directive): 
    def run(self): 
     # this would normally come from an argument on the directive 
     name = 'test' 

     node = nodes.block_quote() 
     node += nodes.Text('The ref is: ') 

     # this should emit :ref:`name` where name is variable 
     # node += ??? 

     return [node] 

Answer 1

Вы можете попробовать это.

node += nodes.reference(refid=name)