From: David G. <go...@us...> - 2002-07-06 05:05:24
|
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/ |