[Docutils-users] Omit substitution text in section link?

[Luis G. <lui...@gm...>]

Hello,

I'm using substitutions to insert images in section headings, but it's less
than ideal when I have to link to those sections

Take, for example, the following ReST:

|icon1| My Section
================

This will result in a section link of "icon1-my-section". To refer to this
section elsewhere in the document, I have to write `icon1 My Section`_.

I would like a way to allow that same section to be referred by `My
Section`_, and the resulting link to be "my-section", as if the
substitution text wasn't there. Is it possible to omit the text content of
a substitution in a section heading? If not, could this be considered for a
future feature?

Thanks!

Luis Gomez

p.s. I'm not subscribed to the mailing list.