Feat: support name

[agoose77]

No description provided.

[agoose77]

I'm fairly new to Sphinx, but I think this is reasonable.

[mgaitan]

name is to define the "id" element of the block, right? I guess it should be handle via forcing the figure wrapper, like with caption. Then the id= will be the one of the figure container, keeping the inner mermaid id for the js lib.

Could you check how is the html looking and maybe add a test?

[agoose77]

I just got back to this. I don't think mermaid-js needs a special ID, so this shouldn't confuse things?

[psychemedia]

Does the :name: element proposed by this PR act in a similar way to the name element that is used in eg MyST Figure elements, and which supports things like {numref} generated references against the :name: identifier?

If so, this would be really useful to have accepted.

[mgaitan]

@agoose77 could you update the PR? or could somebody else?

[christiangrett]

That would be a nice feature! Are there still open tasks for this PR or can the PR be merged?

[mgaitan]

@christiangrett could you rebase this in a new one so it can be merged?