Re: [Docutils-develop] Transforms...?

Adam Chodorowski wrote:
> Actually, I meant:
>=20
> 'author':nodes.authors,
> 'authors':nodes.authors
> =20
> Basically, the idea is to remove the difference between plural and
> singular for the use for the most part (only retain it where the
> language fits).

I think it best to leave the distinction::

    :Authors: Kurt Vonnegut, Jr.

This would look like two names.  Using ":Author:" instead makes it
clear.

>> I suppose an "authors" element could revert to "author" if it only
>> contains a single author, so yes, that's feasible.  For Swedish,
>> I'd suggest mapping a compound word like "one-author" to
>> nodes.author; that way it wouldn't be chosen accidentally but the
>> meaning would be explicit.  Like this::
>>=20
>>     'f=F6rfattare-singular':nodes.author,
>>     'f=F6rfattare':nodes.authors
>=20
> Wouldn't it be possible to leave 'f=F6rfattare-singular' out totally?
> I mean, since nodes.authors would be converted into nodes.author if
> there is only one author, 'f=F6rfattare-singular' isn't really of much
> value at all.

True.  Yes, leave it out.

> [FAQ directive]
>=20
>>> I actually have a FAQ document, where these directives would
>>> perhaps be usefull, although I have found that using section
>>> titles for the question and section contents works fine for a FAQ.
>>=20
>> That's a good idea.  Except, you can only have short questions
>> because titles can only be one line long.  Details!
>=20
> Hmmm... I read that part through, and the conclusion seems to be:
>=20
>> However, a simple enumerated or bulleted list will do just fine for
>> syntax. A directive could treat the list specially; e.g. the first
>> paragraph could be treated as a question, the remainder as the
>> answer (multiple answers could be represented by nested lists).
>=20
> But with that aproach you have the same problem: you can only have
> short questions!

No, the question paragraph could be as long as you like.

> Wouldn't it make more sense to use a bulleted list for the questions
> and answers, and alternating between them (ie. the first bullet is a
> question, the second the answer, the third the question, and so on)?

No, that would be too clumsy.

--=20
David Goodger  <go...@us...>  Open-source projects:
  - Python Docutils: http://docutils.sourceforge.net/
    (includes reStructuredText: http://docutils.sf.net/rst.html)
  - The Go Tools Project: http://gotools.sourceforge.net/