Sphinx fails because of some weird encodingΒΆ

2015-04-07

I have been generating many times the documentation of this module and I can tell I went through many errors due to encoding, French accents may be sometimes painful to deal with. However, I now check every time that every file I produce has either no encoding, either is encoded with utf-8 and no BOM. After I checked that, I’m sure the error come from something else.

The issue I had with Sphinx is not necessarily a crash but also a label which was not takein into account. This label was written on the first line of the line. I replaced that label by a comment (.. comment.). The comment showed on the generated HTML page but it disappear after I removed the BOM from the original RST file.