Use reference labels instead of paths

[lucyleeow]

References and relevant issues

towards #296

Description

Uses references labels instead of paths. A few notes:

• I have left all the paths inside docs/plugins/virtual_environment_docs as they just reference files within that folder so I think we're safe
• I did not know how to deal with gallery/ links. Does sphinx-tag automatically generate the gallery index/readme page..?
• Standardised use of - between words in reference labels
• Removed napari from some reference labels, as there is no 'plugin' equivalent thus its obvs it is about napari
• Images! - We still have a lot of relative paths to image/animation files. These would ideally be absolute paths, meaning they would be fine as long as the images stay in the same folder, but I could not be bothered. Maybe will leave this to be fixed when needed....

[lucyleeow]

Sorry it's not going to be fun to review. I also sort of regret taking this on 😬

[psobolewskiPhD]

Yea 😅
I think the first goal should be making sure every page has a tag/anchor that can be used for cross referencing.
Then second pass is to replace any path based links?

[lucyleeow]

Do you think thats going to be much easier to review than this PR?

[psobolewskiPhD]

I have no idea 😆
Don't worry about it, you're doing the hard work!

[psobolewskiPhD]

I went through everything and it's great!
Just a couple small nits...

...plus merge conflicts 😬

[lucyleeow]

...plus merge conflicts 😬

Oooff I just realised, let me have a look. I am worried the merge conflicts are too complex after my extending napari PR re-organise. I'm tempted to abandon this PR, WDYT?

[lucyleeow]

Okay the conflicts were not as bad as I imagined. I was worried because I had moved files around in other PRs that have now been merged.

@psobolewskiPhD thanks for the review, changes made! (if possible would be great to get this in to avoid more merge conflicts!)

[psobolewskiPhD]

Thanks for your efforts @lucyleeow
I've marked ready for merge and will merge tomorrow--if I don't, please ping me!

[lucyleeow]

@psobolewskiPhD ping, can this go in? Thank you 🙏

[psobolewskiPhD]

Done--sorry & thanks.