[Docutils-users] Syntax for parameters for roles?

[Oleksandr G. <gav...@gm...>]

Most feature rich competitor to RST syntax is AsciiDoc and it has regular
syntax for passing additional parameters to macros::

  http://asciidoc.org/asciidoc.css-embedded.html#_macros

For block level syntax looks like:

  [quote, Sir Arthur Conan Doyle, The Adventures of Sherlock Holmes]
  ____________________________________________________________________
  As he spoke there was the sharp sound of horses' hoofs and
  grating wheels against the curb, followed by a sharp pull at the
  bell. Holmes whistled.
  ...
  ____________________________________________________________________

For inline::

  image::images/logo.png[scaledwidth="75%",alt="Company Logo"]

RST have regular syntax for block level elements:

  .. contents:: My TOC
     :local:
     :depth: 1

But I can't find relevant mentioning about support of parameters by roles:

  http://docutils.sourceforge.net/docs/ref/rst/directives.html
  http://docutils.sourceforge.net/docs/ref/rst/roles.html
  http://docutils.sourceforge.net/docs/ref/doctree.html

I think about exploiting finite number of parameters so it is possible just to
register necessary amount of roles.

================================================================

Also I don't understand if additional parameters to directive will be
accessible from Python RST parser for inline substitution, like:

  This is a |myref|.

  .. |myref| data:: TEXT
     :attr1: val1, val2
     :attr2: no
     :attrn: http://.../...

-- 
http://defun.work/