deeptrain | Full knowledge and control of the train state | Graph Database library

Before trying to reference _DICT_NAME verify it's been put in the general index (and thus became cross-referenceable!!). If using an autodoc directive without :undoc-members: option the dictionary won't be include if it doesn't have a comment. Variables can't have docstrings, so you need to use a comment #: before or """ immediately after, in the py for autodoc to pick it up.

Unless you are explicitly including the dictionary in the .rst with py:data:, using Domains and roles. Or, by including it in the .rst (using autodata or autoattribute, in case your automodule or autoclass doesn't pick it up and you're using directives of the autodoc extension.

Then your _DICT_NAME is also a private variable, so you need to check the conf.py settings to see if it's included like napoleon_include_private_with_doc = True, if you're using Sphinx Napoleon extension.

_DICT_NAME is rendered as if referenced, but no hyperlink.

First check that it shows up documented in the final rendering of you documentation be it HTML or other. If it is included and has a comment it can be then be cross-referenced and the link will be generated.

How to reference a dict with sphinx-autodoc?

Notice you aren't referencing with autodoc. Autodoc is extracting the docstring where you write its directive in your .rst. Your :data: cross-referencing is done by domain and roles. Although you can have referencing inside your docstring that is afterwards extracted by autodoc and finally rendered, altogether, by the Sphinx tool.

EDIT after OP added MCVE:

First problem I see is this, your dictionary _DEFAULT_TRAINGEN_CFG is in module _default_configs.py...

So, the cross-reference you wrote should be right :data:~deeptrain.util._default_configs._DEFAULT_TRAINGEN_CFG\....BUT, did you actually include this module in any .rst file? I don't think so, looking at deeptrain.util.rst the _default_configs.py module is not present in any automodule directive, so there's nothing to reference (that's why the hyperlink isn't generated)...

Three examples of cross-references:

A module level dictionary, dict_document.py