Hi,
Is there an option or config variable that can be set/added to sphinx to
avoid showing fully qualified name of a member?
Consider below sample page:
---------------------------------------------------------------------------------------------------
*python.sphinx.documentation.example.test.module_members.fully_qualified_name*
<<<docstring of the module>>>
class
*python.sphinx.documentation.example.test.module_members.fully_qualified_name.TestClass*
():
Bases: object
<<<docstring of class>>
def
*python.sphinx.documentation.example.test.module_members.fully_qualified_name.testfunction*(name1=True,
name2=False, name3=None,......):
<<<docstring of function>>>
........
---------------------------------------------------------------------------------------------------
Given the user has navigated to "python.sphinx.documentation.example" page
for documentation, prefixing the modname to member name
or displaying the fully qualified name looks a bit overkill in certain
cases.
Consider the "*testfunction*" function above, on the first look it is
harder to identify where the arguments for the function start.
I went through the source code and identified that updating below did the
trick for me:
- For displaying shorter names:
Change in sphinx.domains.python.PyObject.add_target_and_index:339
signode['names'].append(fullname) => signode['names'].append(name_cls[0])
signode['ids'].append(fullname) => signode['ids'].append(name_cls[0])
- For using shorter names in references:
Change in sphinx.writers.html.HTMLWriter:355
format = u'<a class="headerlink" href="#%s" title="%s">%s</a>'
=>
refname = node['ids'][0]
=>
refname = refname,rsplit('.', 1)[1] if '.' in refname else refname
.body.append(format % (node['ids'][0], title, self.permalink_text)) => .body
.append(format % (node['ids'][0], title, self.permalink_text))
I could use the below changes in my local installation but i don't want to
patch sphinx on every release. [Note:
Since self.env.domaindata['py']['objects'] mapping would use fullname for
key, multiple members with same name across packages wouldn't mess up the
doc]
Instead it would be much appreciated if sphinx supported this change.
Thanks in advance!
--
You received this message because you are subscribed to the Google Groups
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.
