omero-documentation icon indicating copy to clipboard operation
omero-documentation copied to clipboard

Missing cross-references for OMERO properties

Open sbesson opened this issue 1 year ago • 0 comments

Noticed while working on #2433, the cross-references for the OMERO properties are currently broken. Looking at the historical releases, this regression seems to have introduced during the migration to readthedocs. For instance, compare the omero.ldap.base markup in https://docs.openmicroscopy.org/omero/5.6.4/sysadmins/server-ldap.html vs https://omero.readthedocs.io/en/v5.6.5/sysadmins/server-ldap.html.

The relevant logic is in https://github.com/ome/omero-documentation/blob/72fa9fe4baa1815141e3c23421d8ba5de149bbaf/omero/conf.py#L407-L411

There are a few factors that might have caused this regression but the two obvious ones coming to mind are:

1- change in newer Sphinx major version (5.6.4 was built with Sphinx 3 vs Sphinx 5 for 5.6.5) 2- self-hosted vs readthedocs infrastructure.

sbesson avatar Jun 26 '24 14:06 sbesson