UnicodeDecodeError: 'ascii' codec can't decode byte 0xc3

[fsimkovic]

Issue migrated from readthedocs/readthedocs.org/issues/3923

---

When building the documentation with ReadTheDocs and numpydoc I receive the following error message:

Traceback (most recent call last):
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/sphinx/cmdline.py", line 306, in main
    app.build(opts.force_all, filenames)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/sphinx/application.py", line 339, in build
    self.builder.build_update()
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/sphinx/builders/__init__.py", line 328, in build_update
    'out of date' % len(to_build))
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/sphinx/builders/__init__.py", line 341, in build
    updated_docnames = set(self.env.update(self.config, self.srcdir, self.doctreedir))
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/sphinx/environment/__init__.py", line 584, in update
    self._read_serial(docnames, self.app)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/sphinx/environment/__init__.py", line 603, in _read_serial
    self.read_doc(docname, app)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/sphinx/environment/__init__.py", line 724, in read_doc
    pub.publish()
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/docutils/core.py", line 217, in publish
    self.settings)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/sphinx/io.py", line 74, in read
    self.parse()
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/docutils/readers/__init__.py", line 78, in parse
    self.parser.parse(self.input, document)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/docutils/parsers/rst/__init__.py", line 185, in parse
    self.statemachine.run(inputlines, document, inliner=self.inliner)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 170, in run
    input_source=document['source'])
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/docutils/statemachine.py", line 239, in run
    context, state, transitions)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/docutils/statemachine.py", line 460, in check_line
    return method(match, context, next_state)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2745, in underline
    self.section(title, source, style, lineno - 1, messages)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 326, in section
    self.new_subsection(title, lineno, messages)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 394, in new_subsection
    node=section_node, match_titles=True)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 281, in nested_parse
    node=node, match_titles=match_titles)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 195, in run
    results = StateMachineWS.run(self, input_lines, input_offset)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/docutils/statemachine.py", line 239, in run
    context, state, transitions)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/docutils/statemachine.py", line 460, in check_line
    return method(match, context, next_state)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2318, in explicit_markup
    nodelist, blank_finish = self.explicit_construct(match)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2330, in explicit_construct
    return method(self, expmatch)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2073, in directive
    directive_class, match, type_name, option_presets)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/docutils/parsers/rst/states.py", line 2122, in run_directive
    result = directive_instance.run()
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/sphinx/ext/autodoc.py", line 1827, in run
    documenter.generate(more_content=self.content)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/sphinx/ext/autodoc.py", line 1127, in generate
    self.document_members(all_members)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/sphinx/ext/autodoc.py", line 1048, in document_members
    check_module=members_check_module and not isattr)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/sphinx/ext/autodoc.py", line 1124, in generate
    self.add_content(more_content)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/sphinx/ext/autodoc.py", line 1518, in add_content
    ModuleLevelDocumenter.add_content(self, more_content)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/sphinx/ext/autodoc.py", line 845, in add_content
    for i, line in enumerate(self.process_doc(docstrings)):
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/sphinx/ext/autodoc.py", line 805, in process_doc
    self.options, docstringlines)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/sphinx/application.py", line 489, in emit
    return self.events.emit(event, self, *args)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/sphinx/events.py", line 79, in emit
    results.append(callback(*args))
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/numpydoc/numpydoc.py", line 132, in mangle_docstrings
    doc = unicode(doc)
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/numpydoc/docscrape_sphinx.py", line 372, in __str__
    ns = dict((k, '\n'.join(v)) for k, v in ns.items())
  File "/home/docs/checkouts/readthedocs.org/user_builds/conkit/envs/latest/local/lib/python2.7/site-packages/numpydoc/docscrape_sphinx.py", line 372, in <genexpr>
    ns = dict((k, '\n'.join(v)) for k, v in ns.items())
UnicodeDecodeError: 'ascii' codec can't decode byte 0xc3 in position 74: ordinal not in range(128)

[jnothman]

WIP PR in #165