Adding syntax for role parameters [SF:feature-requests:68]

[chrisjsewell]

author: ener
created: 2020-01-31 23:28:53.013000
assigned: None
SF_url: https://sourceforge.net/p/docutils/feature-requests/68

Hello Docutils team,

Sometimes I would like to pass options to role functions for adding domain-specific metadata. For example,

For citation page numbers:

As discussed in :cite:[p.99]`knuth1968`, the implementation ...

In a cookbook:

If you like, add some :liquid-ingredient:[20ml, spicyness=7]`Tabasco sauce`. 

As discussed in this Docutils mailing-list thread, AsciiDoc uses a syntax like this:

Click image:icons/play.png[Play, title="Play"] to get the party started.

I like the idea of passing positional and named options in brackets.

Is there a possibility of Docutils supporting this feature?