Improve documentation sidebar

[sbesson]

Sidebar changes similar to those in ome/bioformats#236:

• fix breadcrumbs/Sphinx navigation duplication
• add customized global TOC with links to downloads, licensing and feature list pages

[will-moore]

Side-bar / Prev/Next links:

• The overall problem I have with the current navigation is that there's no 'site map'. There's not way for me to browse the entire content of the BF documentation to make sure I haven't missed something I'm interested in. One thing that the Prev / Next buttons give you is some way to navigate EVERY page (although very slowly - 1 at a time).
• Either the front page needs a complete TOC tree or the top level pages need one each (like the User Information page).
• I don't think that the Prev / Next buttons do any harm, and if you've come from the OMERO docs and found them useful there, then you definately miss them. Curtis says they seem "rather useless" and "seems very strange to me to have 'next' and 'previous' links without also having a link to a master hierarchical TOC". But I don't think this means we have to abolish them completely.

Breadcrumbs:

• I prefer the Sphinx breadcrumb over the plone one. This is partly due to the fact that I am used to it and it's nicely visible (an I can trust it). It's also annoying to test, since all the breadcrumb links take me to the 'live' site, not the staging.
• The Plone breadcrumbs don't give me the links to go up one level. E.g. from https://www.openmicroscopy.org/site/support/bio-formats-staging/users/installing-bf-imagej.html I can't go back up to https://www.openmicroscopy.org/site/support/bio-formats-staging/users/user-info.html
• Another "bug" with it is that the documentation home page https://www.openmicroscopy.org/site/support doesn't give me links to the OMERO or BF docs home pages. So, to get to https://www.openmicroscopy.org/site/support/bio-formats/ I have to first go down the hierarchy, (E.g. BF user docs) then up the hierarchy using the breadcrumbs.

[hflynn]

The Docs home page does link to OMERO and BF Docs home pages but it's the bottom 'other info' links on each section. I could move this to be the first link if you think that would be clearer.

[will-moore]

@hflynn Yes - that would help a lot. I completely didn't them it as it is now.
Ideally I'd like the home-page links at a 'higher level' than the sub-links (not just first in the list), but I'll leave you to decide what works best. Cheers.

[hflynn]

Docs home web page fixed.

Suggest we remove the commit 'Remove duplicate navigation bar' and just go with the other one, looking to turn off the plone breadcrumb at some point instead.

@sbesson Can you put the sphinx top navigation bar/breadcrumb back into BF as well, please?

[sbesson]

@will-moore , @hflynn : replaced the plone breadcrumbs by the Sphinx navigation bar

[will-moore]

Looks great! Sphinx breadcrumbs work nicely, the Documentation homepage is nicely organised now. Good to merge (in my opinion).

[pwalczysko]

This page
https://www.openmicroscopy.org/site/support
looks empty on the right and is of different style than the pages under it (fonts, colours, layout).
Is it still under construction ?

This pdf. - the text in title binds to the right - never saw such thing - could we make the text bind to the left or centre it ?
https://www.openmicroscopy.org/site/support/omero4/OMERO-4.4.5.pdf

(not sure if it belongs to this PR here, but where then ?) Some screenshots here
http://www.openmicroscopy.org/site/products/omero/screenshots/ I do not know at all, mainly:
This screenshot is outdated ?http://www.openmicroscopy.org/site/products/omero/screenshots/images/30-image-region-manager-mac.png/image
This screenshot is outdated ? as well
http://www.openmicroscopy.org/site/products/omero/screenshots/images/30-importer-chooser-ubuntu-mac-win.png/image
Is it the 4.5 version ? (but it is not present on Gretzky either - maybe it IS outdated)

[hflynn]

@pwalczysko The top page looks different because it's a plone page not in the sphinx docs - it is just to replace the default indexing page.

As for the rest, not for this PR but there is a ticket here:
https://trac.openmicroscopy.org.uk/ome/ticket/9312

for reviewing screenshots so I suggest you paste this comment over there.

[joshmoore]

• Crumbs: good
• Italics: good
• Sidebar: good

Merging.