:name: does not creating a proper label inside figure or code-block

[Jellby]

Sample document:

Float Test
==========

.. table:: Table caption
   :name: my_table

   === === ===
   1   2   3
   4   5   6
   === === ===

.. figure:: acrolein.*
   :name: my_figure

   Foo

.. code-block::
   :name: my_block

   Foo

References to :ref:`my_table`, :ref:`my_figure`, :ref:`my_block`.

The :name: option works fine in the table. In the code-block it's not accepted, and in the figure it has two problems:

1. It does not generate a sphinx label, so :ref:my_figure`` does not work.

2. The generated HTML assigns the id to the <img> rather than to the <div>:

    <div class="figure" id="id1">
    <img alt="_images/acrolein.png" id="my-figure" src="_images/acrolein.png" />
    <p class="caption">...</p>
    </div>
   

[shimizukawa]

Thanks! I'll take a look.

[shimizukawa]

Now, code-block and literalinclude support :name: option. And them and figure name can be referenced from :ref: role.

The generated HTML assigns the id to the <img> rather than to the <div>

It's a specification of docutils. We'll keep compatibility.

[Jellby]

Thanks. About the '':name:'' in ''figure'', where is it specified in docutils? Maybe I can report it for them to change it...

[shimizukawa]

@Jellby Ah, "implementation" is better than "specification". I can't find any documentation for the behavior.