Hey,

<https://code.djangoproject.com/ticket/28290>
Ticket #28290 <https://code.djangoproject.com/ticket/28290> has been lying
in the easy pickings for too long now. I don't believe a patch has been
submitted.

It was suggested in n the issue
<https://github.com/sphinx-doc/sphinx/issues/3856> raised by the reporter,
Tony Narlock, on the Sphinx project, to use the AutoSectionLabel extension
to automatically label sections, and hence solve the issue.

A label with the same name as the section is generated automatically. If
the section name is repeated anywhere else in the whole document, one of
the possiblities is chosen as the default. (Ref:
https://www.sphinx-doc.org/en/master/usage/extensions/autosectionlabel.html)
There exists an setting autosectionlabel_prefix_document that appends the
name of the document the section is in.

I'm personally more inclined to appending the document name. However, I'd
like to get the opinion of the community before proceeding. Whatever option
be chosen, it would have to be documented in the documentation itself.

Thanks,
Abhijeet

-- 
You received this message because you are subscribed to the Google Groups 
"Django developers  (Contributions to Django itself)" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to django-developers+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-developers/CAP1-YrrKBWZzMPs8Snek_rBN%2B1N0o5gFy2%2BKhQ_H%2BV6Qk24X%3DQ%40mail.gmail.com.

Reply via email to