Instead of an <a id="#...."> anchor use <tag id="#....">

Created originally on Bitbucket by Russ (Russ W)

HTML5 lets us place id's into the section tag (and others) which will make it behave as an anchor and facilitate internal page linking.

(by the way, once I understand the codebase I'm intending on [attempting to] providing some patches :) )

I imagine there are a few tags that could implement this, such as:

• figure
• aside which table of contents seems to be mapped to

However: HTML5 id's can only contain one id. If we come across something like this (which is from the functional test):

#!rst

.. _Another Target:

Targets
-------

<section id="targets another-target"> would be incorrect (which is what happens if I change self.expand_id_to_anchor = False. I think the most desirable outcome would be:

#!html
<a id="another-target"></a>
<section id="targets">