mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2026-10-25 22:50:22 -05:00
Deprecate support for source encodings other than UTF-8 (#13666)
This commit is contained in:
1 parent
076774224a
commit
551b842898
6 files changed
+39
-7
No files matched your search
@@ -646,10 +646,11 @@ configurations:
|
||||
Source encoding
|
||||
---------------
|
||||
|
||||
Since the easiest way to include special characters like em dashes or copyright
|
||||
signs in reStructuredText is to directly write them as Unicode characters, one has to
|
||||
specify an encoding. Sphinx assumes source files to be encoded in UTF-8 by
|
||||
default; you can change this with the :confval:`source_encoding` config value.
|
||||
Sphinx supports source files that are encoded in UTF-8.
|
||||
This means that the full range of Unicode__ characters may be used
|
||||
directly in reStructuredText.
|
||||
|
||||
__ https://www.unicode.org/
|
||||
|
||||
|
||||
Gotchas
|
||||
|
||||
@@ -971,7 +971,7 @@ __ https://pygments.org/docs/lexers
|
||||
:type: text
|
||||
|
||||
Explicitly specify the encoding of the file.
|
||||
This overwrites the default encoding (:confval:`source_encoding`).
|
||||
This overwrites the default encoding (UTF-8).
|
||||
For example:
|
||||
|
||||
.. code-block:: rst
|
||||
|
||||
Reference in new issue
Block a user