gilberto, thanks for the reply. I should have been clearer. The above text exists in a restructured text file. I'm not sure I see how setting the source code encodings would affect Sphinx's processing of the restructured text.
On Wednesday, April 17, 2013 7:58:07 PM UTC-5, gsavix wrote: > > are you using > # -*- coding: utf-8 -*- > for your python files? see url [1] > > url [1] http://www.python.org/dev/peps/pep-0263/ > > > 2013/4/17 Conway M <[email protected] <javascript:>> > >> I am trying to compile the docs of >> Pandas<https://github.com/pydata/pandas>but I am unable to get Sphinx to >> compile a document with some unicode. Is >> there some flag I need to specify to let Sphinx correctly build documents >> with unicode in them? In this case, I don't want Sphinx to decode the text. >> >> .. _io.unicode: >>> Dealing with Unicode Data >>> ~~~~~~~~~~~~~~~~~~~~~~~~~ >>> The ``encoding`` argument should be used for encoded unicode data, which >>> will >>> result in byte strings being decoded to unicode in the result: >>> .. ipython:: python >>> *data = 'word,length\nTr\xe4umen,7\nGr\xfc\xdfe,5'* >>> df = pd.read_csv(StringIO(data), encoding='latin-1') >>> df >>> df['word'][1] >>> Some formats which encode all characters as multiple bytes, like UTF-16, >>> won't >>> parse correctly at all without specifying the encoding. >> >> >> >> Traceback (most recent call last): >>> File "/usr/local/lib/python2.7/dist-packages/sphinx/cmdline.py", line >>> 247, in main >>> app.build(force_all, filenames) >>> File "/usr/local/lib/python2.7/dist-packages/sphinx/application.py", >>> line 211, in build >>> self.builder.build_update() >>> File >>> "/usr/local/lib/python2.7/dist-packages/sphinx/builders/__init__.py", line >>> 211, in build_update >>> 'out of date' % len(to_build)) >>> File >>> "/usr/local/lib/python2.7/dist-packages/sphinx/builders/__init__.py", lin e >>> 231, in build >>> purple, length): >>> File >>> "/usr/local/lib/python2.7/dist-packages/sphinx/builders/__init__.py", line >>> 131, in status_iterator >>> for item in iterable: >>> File "/usr/local/lib/python2.7/dist-packages/sphinx/environment.py", >>> line 458, in update_generator >>> *self.read_doc(docname, app=app) >>> * File "/usr/local/lib/python2.7/dist-packages/sphinx/environment.py", >>> line 609, in read_doc >>> raise SphinxError(str(err)) >>> *SphinxError: 'utf8' codec can't decode byte 0xe4 in position 36: >>> invalid continuation byte >>> *> >>> /usr/local/lib/python2.7/dist-packages/sphinx/environment.py(609)read_doc() >>> -> raise SphinxError(str(err)) >>> (Pdb) >> >> -- >> You received this message because you are subscribed to the Google Groups >> "sphinx-users" group. >> To unsubscribe from this group and stop receiving emails from it, send an >> email to [email protected] <javascript:>. >> To post to this group, send email to [email protected]<javascript:> >> . >> Visit this group at http://groups.google.com/group/sphinx-users?hl=en. >> For more options, visit https://groups.google.com/groups/opt_out. >> >> >> > > > > -- > gilberto dos santos alves > +55.11.98646-5049 > sao paulo - sp - brasil > > > > > -- You received this message because you are subscribed to the Google Groups "sphinx-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/sphinx-users?hl=en. For more options, visit https://groups.google.com/groups/opt_out.
