Change all internal references

[lauranewman]

This will temporarily bork translations - but we will live with that.

[lauranewman]

I note there are some minor issues with this translation (which are of general relevance):

• Translation of glossary references (:term:...). Because glossary references have been translated they are not matching.
• Similarly regarding page references.

The solution to both these problems is to utilize the 'title' option available in all restructured text referencing syntax:

:role:`title <target>`

Thus one should do:

For glossary:

:term:`{my-translated-term} {original-reference}`

For pages

:doc:`{my-translated-page-name} {original-page-name}`

Aside: I also note part of the issue here is not using cross-ref syntax for internal links - see #75.

[lauranewman]

Some of our internal page references (e.g. to Introduction on front page) use html links.

Instead they should use the :doc: cross-reference option.