I282 table numbers

[kerimoyle]

Addresses #282

Manually added table numbers throughout the text to the links because numref can't do it for us.

Rendered version here: https://cellml-specification-dev.readthedocs.io/en/i282_table_numbers/index.html

[MichaelClerx]

Any way we could use this kind of construct to avoid the hard links?

.. table:: Table caption
   :name: table_x

:numref:`Table %s: Unit thingies<table_x>`

Found this online: https://github.com/sphinx-doc/sphinx/issues/1763

[kerimoyle]

Thanks, I'll give it a go (didn't even realise that "table" was a thing, oops!)

[MichaelClerx]

Me neither :D https://docutils.sourceforge.io/docs/ref/rst/directives.html#table

[MichaelClerx]

Looks good, but doesn't work for me in the PDF somehow. I'm not seeing the table heading anymore

[kerimoyle]

it's not working at all ... yet ...

[agarny]

Ok, ping us when it's ready to review.

[MichaelClerx]

I've been playing around too and can't get it to work

[MichaelClerx]

Heyyyy that seems to work!

[kerimoyle]

Yep, getting there ... now I need to clean it up a little ...

[agarny]

Not quite working for me:

Also, I would expect references to a table to read something like "Table x.y", not "Table x.y: some description" as is currently the case, e.g.:

[kerimoyle]

I think it's nice to have the title of the table there ... since hoverxref doesn't seem to play nicely with it, it saves people from having to click on the link to find out which table it's talking about. And it's (here's that magic word) consistent with our other internal links to sections and their titles ... ?

[agarny]

It's a personal preference of mine, but if the majority is in favour of keeping things as they are, then I am "fine".

[hsorby]

numref can do this see #285.

[kerimoyle]

yep, just fixing it up now @hsorby

[hsorby]

Already done in #285