sphinx-doc/sphinx

Sphinx Quickstart (PyCharm) crashes after giving authors name with Umlaut

Open

#9247 aperta il 18 mag 2021

Vedi su GitHub
 (2 commenti) (0 reazioni) (0 assegnatari)Python (1985 fork)batch import
api:cmdlinehelp wantedtype:bug

Metriche repository

Star
 (5625 star)
Metriche merge PR
 (Merge medio 10g 11h) (11 PR mergiate in 30 g)

Descrizione

After installing sphinx in a new venv (python 3.9) I used Sphinx Quickstart from PyCharm's Tool-menu. I think this simply called: D:\py_projects\sandbox\Enum_doc\venv\Scripts\sphinx-quickstart.exe. After giving an authors name, the quickstart crashes:

Traceback (most recent call last):
  File "C:\Program Files\Python39\lib\runpy.py", line 197, in _run_module_as_main
    return _run_code(code, main_globals, None,
  File "C:\Program Files\Python39\lib\runpy.py", line 87, in _run_code
    exec(code, run_globals)
  File "D:\py_projects\sandbox\Enum_doc\venv\Scripts\sphinx-quickstart.exe\__main__.py", line 7, in <module>
  File "d:\py_projects\sandbox\enum_doc\venv\lib\site-packages\sphinx\cmd\quickstart.py", line 586, in main
    ask_user(d)
  File "d:\py_projects\sandbox\enum_doc\venv\lib\site-packages\sphinx\cmd\quickstart.py", line 249, in ask_user
    d['author'] = do_prompt(__('Author name(s)'))
  File "d:\py_projects\sandbox\enum_doc\venv\lib\site-packages\sphinx\cmd\quickstart.py", line 148, in do_prompt
    x = term_input(prompt).strip()
  File "d:\py_projects\sandbox\enum_doc\venv\lib\site-packages\sphinx\cmd\quickstart.py", line 82, in term_input
    return input('')
  File "C:\Program Files\Python39\lib\codecs.py", line 322, in decode
    (result, consumed) = self._buffer_decode(data, self.errors, final)
UnicodeDecodeError: 'utf-8' codec can't decode byte 0xf6 in position 11: invalid start byte

I guess this is caused by Umlaut "ö" in the authors name. When using "oe" instead of "ö", quickstart finishes as expected.

Guida contributor