python-sphinx - How to create custom admonitions in custom directive sphinx?

Question

I have created a custom directive 'limitation' in Sphinx which mentions "Limitation" of a certain product. I want that the limitation be written within a colored box that is similar to 'note' or 'warning' directives with 'limitation' written as the title instead of 'note' or 'warning'. I want this to be handled by my custom directive 'limitation' itself.

Is there any way to do this?

Answer 1

您可以直接从 Docutils 使用 admonition：

 .. admonition:: Limitation

    Description of the limitations ...

查看http://docutils.sourceforge.net/docs/ref/rst/directives.html了解更多信息。