Re: [Docutils-users] Unicode issue in rst2html5 utility

[Guenter M. <mi...@us...>]

On 2017-09-15, Michal Dabski wrote:

Dear Michal,

thank you for the report.

> I'm not subscribed to the mailing list, just wanted to raise an issue I
> found while making messages using Django's makemessage command with
> docutils installed.

> I'm getting the following message:

> $ python manage.py makemessages
> CommandError: errors happened while running xgettext on rst2html5.py
> xgettext: ./bin/rst2html5.py:2: Unknown encoding "utf8". Proceeding with
> ASCII instead.
> xgettext: Non-ASCII comment at or before ./bin/rst2html5.py:3.
> Please specify the source encoding through --from-code or through a comment
> as specified in http://www.python.org/peps/pep-0263.html.

> It looks like "utf8" is not a valid encoding, surely it should be "utf-8"?

According to the Python documentation, both "utf-8" and "utf8" are valid
aliases for the "utf_8" codec and the file is processed without problem by
Python.

OTOH, all other source files use the utf-8 alias in the source encoding
comment, so we will change this for inner consistency.

Thanks,

Günter