Re: [Docutils-users] :term:s in plural

[David G. <go...@py...>]

On 18 October 2013 06:59, Erik Bernoth <eri...@gm...> wrote:
> Hi,
>
> is it possible in any reasonable way to mark a restructured Text :term: as
> plural?
>
> E.g. you want to write somewhere in your docs :term:`test` but you don't
> describe one test, you describe many. But if you write :term:`tests` it will
> be a completely new term. You can not write :term:`test`s because that would
> not be parsed. So in the end you have to write :term:`tests<test>` which
> will be deeply annoying after having done this many times and with longer terms.
>
> Also see
> http://stackoverflow.com/questions/19403972/writing-terms-in-plural-without-the-redundancy
>
> Best Wishes,
> Erik

Note that :term: is a Sphinx-specific role, and as I don't have Sphinx
set up right now, I can't test any of this. It may be better to ask on
a Sphinx forum. But just on general reST principles (and guessing that
these will work):

You could write the plural as ":term:`test`\ s". Ugly, but it might work.

Alternatively, set up a substitution:

.. |tests| replace:: :term:`tests <test>`

Then whenever you need the plural, just use the |tests| substitution.

-- 
David Goodger <http://python.net/~goodger>