Custom builder tutorial or overview?

[mattrobin]

Hello! I'd like to write a custom builder for a new output format. However, I'm having difficulty finding information on how to go about creating such a builder. Does anyone know of an available tutorial of creating a custom builder, or at least an overview explaining the components of the builder and how they work? I can resort to trying to understand existing real-world builders to figure this out, but having a simplified tutorial or explanation to start with would certainly ease the process.

From what I can tell from what I found so far, it seems the builder uses visitor pattern to walk through the nodes and write the output format. But there seems to be a translator class involved in this process, and what role it plays isn't immediately clear. And which parts of this output process are using the docutils vs Sphinx APIs is also not immediately clear. So mostly, I'm having a hard time trying to figure out how the entire structure works such that I can understand how to go about thinking of the creation of the builder.

If there's any simplified tutorial or clear overview of the builder structure and components, please let me know. Thank you for your time!