Menu
▾
▴
docutils-develop
|
From: Adam C. <ad...@ch...> - 2002-07-06 03:56:17
|
On Fri, 05 Jul 2002 22:49:15 -0400 David Goodger <go...@us...> wrote: > > Would it be possible to replace this with a single construct, ie. > > always using an list of authors (if there is only one author, it > > would be a list containing only one entry) and determine from > > context if it is many or a single? This way, it would work for > > Swedish and for English, since for English you can have the > > mappings: > > > > 'author':nodes.author, > > 'author':nodes.authors > > I assume you mean:: > > 'author':nodes.author, > 'authors':nodes.authors > ^ Actually, I meant: 'author':nodes.authors, 'authors':nodes.authors 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 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:: > > 'författare-singular':nodes.author, > 'författare':nodes.authors Wouldn't it be possible to leave 'författare-singular' out totally? I mean, since nodes.authors would be converted into nodes.author if there is only one author, 'författare-singular' isn't really of much value at all. > The ``docutils.transforms.frontmatter.DocInfo`` transform will need > some work, probably in the ``extract_authors`` method. Care to give > it a try? Not urgent. I might take a look, but there are other pressing matters that feel a bit more important right now. :) [FAQ directive] > > 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. > > That's a good idea. Except, you can only have short questions because > titles can only be one line long. Details! Hmmm... I read that part through, and the conclusion seems to be: > 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). But with that aproach you have the same problem: you can only have short questions! 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)? --- Adam Chodorowski <ad...@ch...> FORTRAN? The syntactically incorrect statement "DO 10 I = 1.10" will parse and generate code creating a variable, DO10I, as follows: "DO10I = 1.10" If that doesn't terrify you, it should. |
|
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/
|
|
From: Adam C. <ad...@ch...> - 2002-07-07 01:44:51
|
On Sat, 06 Jul 2002 01:06:34 -0400 David Goodger
<go...@us...> wrote:
> Adam Chodorowski wrote:
> > Actually, I meant:
> >
> > 'author':nodes.authors,
> > 'authors':nodes.authors
> >
> > 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.
Ah, yes, I see what you mean. However, you still have a problem with that name
if you have multiple authors, so there needs to be some solution for it
anyway. For example, one could only allow ";" as separator, although you might
argue that it looks ugly. But otherwise, "Kurt Vonnegut, Jr." would not be
able to participate in collaborations. :-)
[FAQ directive]
> >> 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).
> >
> > 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.
Yes, but you would not be able to have several paragraphs or other construct
(like a table), which *might* be useful to explain the question more (although
I agree that this is normally not the case for a FAQ).
> > 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.
Why do you think that?
---
Adam Chodorowski <ad...@ch...>
Chapter 1
The story so far:
In the beginning the Universe was created. This has made a lot of
people very angry and been widely regarded as a bad move.
|
|
From: David G. <go...@us...> - 2002-07-09 02:51:46
|
[David]
>> I think it best to leave the distinction::
>>
>> :Authors: Kurt Vonnegut, Jr.
>>
>> This would look like two names. Using ":Author:" instead makes it
>> clear.
[Adam]
> Ah, yes, I see what you mean. However, you still have a problem with
> that name if you have multiple authors, so there needs to be some
> solution for it anyway. For example, one could only allow ";" as
> separator, although you might argue that it looks ugly. But
> otherwise, "Kurt Vonnegut, Jr." would not be able to participate in
> collaborations. :-)
As currently implemented, the "Authors" field can use either ";" or
"," as separators, with ";" checked for first. So the following would
be parsed properly:
:Authors: Kurt Vonnegut, Jr.; Kilgore Trout, Esq.
I'll clarify this point in the docs.
--
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/
|
|
From: Adam C. <ad...@ch...> - 2002-07-09 06:12:53
|
[Argh... I keep sending mails to the wrong adress :)]
On Mon, 08 Jul 2002 22:53:02 -0400 David Goodger
<go...@us...> wrote:
[...]
> > Ah, yes, I see what you mean. However, you still have a problem with
> > that name if you have multiple authors, so there needs to be some
> > solution for it anyway. For example, one could only allow ";" as
> > separator, although you might argue that it looks ugly. But
> > otherwise, "Kurt Vonnegut, Jr." would not be able to participate in
> > collaborations. :-)
>
> As currently implemented, the "Authors" field can use either ";" or
> "," as separators, with ";" checked for first. So the following would
> be parsed properly:
>
> :Authors: Kurt Vonnegut, Jr.; Kilgore Trout, Esq.
Ah, in that case it works very well. Hmmm... With Swedish there will still be
the same problem though, since there would not be different singular/plural
forms. The above "syntax" for names isn't used in Swedish names, but that
doesn't mean someone writing his/her name like that doesn't write Swedish
documents, so it needs to be handled there also...
Perhaps only ";" would be allowed as separator for Swedish documents? Hrm...
I don't like that very much... :-/
---
Adam Chodorowski <ad...@ch...>
There are those who claim that magic is like the tide; that it swells
and fades over the surface of the earth, collecting in concentrated
pools here and there, almost disappearing from other spots, leaving
them parched for wonder. There are also those who believe that if you
stick your fingers up your nose and blow, it will increase your
intelligence.
-- The Teachings of Ebenezum, Volume VII
|
|
From: David G. <go...@us...> - 2002-07-11 02:01:41
|
[David]
>> As currently implemented, the "Authors" field can use either ";" or
>> "," as separators, with ";" checked for first. So the following would
>> be parsed properly:
>>
>> :Authors: Kurt Vonnegut, Jr.; Kilgore Trout, Esq.
[Adam]
> Ah, in that case it works very well. Hmmm... With Swedish there will
> still be the same problem though, since there would not be different
> singular/plural forms. The above "syntax" for names isn't used in
> Swedish names, but that doesn't mean someone writing his/her name
> like that doesn't write Swedish documents, so it needs to be handled
> there also...
Don't you ever write names in the "Chodorowski, Adam" form in Swedish?
Because of the lack of a distinction between singular/plural "author"
in Swedish, you'll use only "Authors". We can require a semicolon at
the end of any single author's name which contains a comma::
:Authors: Chodorowski, Adam;
I've updated the docs, and the transform for the "Authors"
bibliographic field now checks to see if it contains only one
"author". If so, it uses just that one "author" element
("<author>Chodorowski, Adam</author>" instead of
"<authors><author>Chodorowski, Adam</author></authors>").
--
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/
|
|
From: Adam C. <ad...@ch...> - 2002-07-11 02:19:12
|
On Wed, 10 Jul 2002 22:02:59 -0400 David Goodger
<go...@us...> wrote:
> Don't you ever write names in the "Chodorowski, Adam" form in Swedish?
It is quite uncommon (although institutions like it sometimes), but it does
happen that this form is used.
> Because of the lack of a distinction between singular/plural "author"
> in Swedish, you'll use only "Authors". We can require a semicolon at
> the end of any single author's name which contains a comma::
>
> :Authors: Chodorowski, Adam;
That seems very reasonable. Gets my vote. :)
> I've updated the docs, and the transform for the "Authors"
> bibliographic field now checks to see if it contains only one
> "author". If so, it uses just that one "author" element
> ("<author>Chodorowski, Adam</author>" instead of
> "<authors><author>Chodorowski, Adam</author></authors>").
Great! Thanks!
---
Adam Chodorowski <ad...@ch...>
BTW, I made the statistics up. I read somewhere that 60% of statistics are
made up on the spot :-)
-- Phill Wooller
|
×
Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.
Thanks for helping keep SourceForge clean.
X