Is there a way to support custom directives?

It’d be very nice to be able to translate custom directives, like a .. video:: one I’ve created for my doc.

[ocayrol]

You can have a look at https://www.sphinx-doc.org/en/master/development/tutorials/todo.html to see a little example. The link you posted above ( https://github.com/ankita240796/docs/blob/f57ebfbb3dc82b256334efbf6a697ef612b36890/video.py ) is another example.

Inside a Sphinx extension, you define a new directive that will create a new type of node inside the document tree. Thus, you also define a new node class in the extension. Of course, you now have to explain how you would transform this new type of node into HTML, Latex or, here, Markdown. So, you write several “functions” that can transform this type of node into an output format. These functions will be dynamically weaved into a node visitor as visit / depart methods (so you need a visit function and a depart function and you have to be compliant with the node visitor internal behaviour). When you register the new type of node in the Sphinx application with the add_node method, you also give the visit / depart functions for each format you want to support.

In the “todo” tutorial, this is what is done for the todo node. In the “video” example, this is also what is done for the video_node.

[Tilix4]

That seems nice but I don’t really get all the possibilities? Will you provide some code examples?