Re: [Docutils-develop] internationalization

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

[Engelbert]
>>> Should languages.labels become a function which tries, exact case
>>> all lower and if both fails returns the passed text ?

[David]
>> No.  This is another case of "errors should never pass silently".
>> If the label is missing from the language module, it's a bug.

[Engelbert]
> but maybe a function label() which does not only give a traceback
> but a real error with description.

No!  The "real error" here is that some data is missing from the
mapping, or that the wrong key is being accessed.  A traceback is
*absolutely* appropriate.  If a traceback occurs, it means there's a
bug in the *code* that needs to be fixed.  Docutils Reporter
warnings/errors indicate problems in the *input*.  They're completely
different (and incompatible) things.

>> .. [*] I notice you've just added a German de.py as well.  Great,
>>    thanks!  Unfortunately, even the en.py file it was based on
>>    isn't up to date. :-(  I'll fix it, probably tomorrow.  I think
>>    even this is an example of a "silently passing" exception.  I'll
>>    add some warnings.

This is done now.

> I had to because i could not use labels in writer without, guess "-l
> de" tries to switch the rst part to, so therefore it is needed,
> otherwise one gets the traceback (hate it).

If you hate tracebacks so much, please help get rid of them.  Please
help fix the cause (at least submit a bug report), instead of fixing
the symptom.  What you describe above is a symptom-fix only.  In this
case, fixing the cause is much easier!

> could you make sense of the documentation part ?

OK.  See http://docutils.sf.net/spec/howto/i18n.html .

-- 
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/