Как мне установить заголовок для моего сгенерированного блока кода в sphinx

#python #plugins #python-sphinx #caption #docutils

#python #Плагины #python-sphinx #заголовок #docutils

Вопрос:

В настоящее время я использую следующий код для генерации блока кода и отображения в нем некоторой информации. Я хотел бы установить заголовок, подобный следующей директиве rst.

 .. code-block:: python
   :caption: my_file.py
 

В настоящее время я использую следующий код, но он

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


class ExecuteCode(Directive):

    def run(self):
        output = []
        input_code = nodes.literal_block(shown_code, shown_code)

        # This creates a normal text directly above the code block
        output.append(nodes.caption(text=self.options['header_code']))

        # This doesn't do anything at all
        input_code['caption'] = nodes.caption('asdf', 'asdf')
        
        return output
 

Как я могу установить заголовок для literal_block?