Deprecate support for source encodings other than UTF-8 (#13666)

This commit is contained in:
Adam Turner authored and GitHub committed 2025-06-16 20:32:31 +01:00
1 parent 076774224a
commit 551b842898
6 files changed
+39 -7

No files matched your search

+5 -4
View File
@@ -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
+1 -1
View File
@@ -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