adding links to first references of the vocabulary items

[sanbrock]

No description provided.

[sanbrock]

If base class reference is the same as the first reference, do not duplicate the information and have the same link listed twice

[phyy-nx]

Discussion from Code Camp:

• Remove dependency on pynxtools, by adding the new function as new code either alongside or inside dev_tools/docs/nxdl.py
• Instead of a verbose link to the dependecy (e.g. <NXxbase/entry>, use ... and a pop up tool tip that says "This field extends NXxbase/entry" with a link to NXxbase/entry.
• The above may require a new Sphinx subpage dependency. That's ok. Example: https://sphinx-hoverxref.readthedocs.io/en/latest/

[sanbrock]

Code Camp suggestions are implemented, the new format is
definition: (required) NX_CHAR …🔗
with tootip of override: NXxbase/entry/definition
Also the external dependency pynxtools is removed and the code is integrated.

[PeterC-DLS]

Is it possible to refactor nexus.py to separate out the xml tree parsing and form another PR to add the nexus_file utility with its h5py dependency?

[sanbrock]

Override linking has been modified, and collapsible documentation/enumeration has been added according to the CC discussion.

[PeterC-DLS]

Could you rebase this change off the newly refactored method in nxdl_utils.py? This will remove the dependencies on h5py and click

[sanbrock]

yes, sure

[PeterC-DLS]

When I build the python package, it has a version of 0.0.0. Perhaps set it to something other than the default.

[domna]

When I build the python package, it has a version of 0.0.0. Perhaps set it to something other than the default.

@PeterC-DLS You should now get a correct version when building the package

[PeterC-DLS]

This file has the same issues as mentioned in in-depth review performed in https://github.com/nexusformat/definitions/pull/1303/files#diff-42efc233d0fece860f874809d0c5b425905ff3341504af645d3f205b628cb5a4

[phyy-nx]

Superseded by #1303