From d1b0f8926d0e7284ae228f23d26f17fe4724ff9d Mon Sep 17 00:00:00 2001
From: "JHM Darbyshire (iMac)" <attack68@users.noreply.github.com>
Date: Mon, 23 Aug 2021 15:19:04 +0200
Subject: [PATCH 1/4] add styler encoding option

---
 doc/source/user_guide/options.rst |  1 +
 pandas/core/config_init.py        |  8 ++++++++
 pandas/io/formats/style.py        | 13 ++++++++-----
 3 files changed, 17 insertions(+), 5 deletions(-)

diff --git a/doc/source/user_guide/options.rst b/doc/source/user_guide/options.rst
index 62a347acdaa34..8564777b09533 100644
--- a/doc/source/user_guide/options.rst
+++ b/doc/source/user_guide/options.rst
@@ -489,6 +489,7 @@ styler.sparse.columns                   True         "Sparsify" MultiIndex displ
                                                      in Styler output.
 styler.render.max_elements              262144       Maximum number of datapoints that Styler will render
                                                      trimming either rows, columns or both to fit.
+styler.render.encoding                  utf-8        Default encoding for output HTML or LaTeX files.
 ======================================= ============ ==================================
 
 
diff --git a/pandas/core/config_init.py b/pandas/core/config_init.py
index 27b898782fbef..50c9772df3559 100644
--- a/pandas/core/config_init.py
+++ b/pandas/core/config_init.py
@@ -20,6 +20,7 @@
     is_int,
     is_nonnegative_int,
     is_one_of_factory,
+    is_str,
     is_text,
 )
 
@@ -762,6 +763,11 @@ def register_converter_cb(key):
     trimming will occur over columns, rows or both if needed.
 """
 
+styler_encoding = """
+: str
+    The encoding used for output HTML and LaTeX files.
+"""
+
 with cf.config_prefix("styler"):
     cf.register_option("sparse.index", True, styler_sparse_index_doc, validator=bool)
 
@@ -775,3 +781,5 @@ def register_converter_cb(key):
         styler_max_elements,
         validator=is_nonnegative_int,
     )
+
+    cf.register_option("render.encoding", "utf-8", styler_encoding, validator=is_str)
diff --git a/pandas/io/formats/style.py b/pandas/io/formats/style.py
index 81bd14629cfd3..d9c923f92561e 100644
--- a/pandas/io/formats/style.py
+++ b/pandas/io/formats/style.py
@@ -505,8 +505,9 @@ def to_latex(
             rendered.
 
             .. versionadded:: 1.4.0
-        encoding : str, default "utf-8"
-            Character encoding setting.
+        encoding : str, optional
+            Character encoding setting. Defaults
+            to ``pandas.options.styler.render.encoding`` value.
         convert_css : bool, default False
             Convert simple cell-styles from CSS to LaTeX format. Any CSS not found in
             conversion table is dropped. A style can be forced by adding option
@@ -828,6 +829,7 @@ def to_latex(
             convert_css=convert_css,
         )
 
+        encoding = encoding or get_option("styler.render.encoding")
         return save_to_buffer(latex, buf=buf, encoding=encoding)
 
     def to_html(
@@ -877,8 +879,8 @@ def to_html(
 
             .. versionadded:: 1.4.0
         encoding : str, optional
-            Character encoding setting for file output, and HTML meta tags,
-            defaults to "utf-8" if None.
+            Character encoding setting for file output, and HTML meta tags.
+            Defaults to ``pandas.options.styler.render.encoding`` value.
         doctype_html : bool, default False
             Whether to output a fully structured HTML file including all
             HTML elements, or just the core ``<style>`` and ``<table>`` elements.
@@ -913,12 +915,13 @@ def to_html(
         if sparse_columns is None:
             sparse_columns = get_option("styler.sparse.columns")
 
+        encoding = encoding or get_option("styler.render.encoding")
         # Build HTML string..
         html = obj._render_html(
             sparse_index=sparse_index,
             sparse_columns=sparse_columns,
             exclude_styles=exclude_styles,
-            encoding=encoding if encoding else "utf-8",
+            encoding=encoding,
             doctype_html=doctype_html,
             **kwargs,
         )

From 1582af950826dec2989b904bc79d452d7760ebca Mon Sep 17 00:00:00 2001
From: "JHM Darbyshire (iMac)" <attack68@users.noreply.github.com>
Date: Sun, 29 Aug 2021 08:56:08 +0200
Subject: [PATCH 2/4] whats new

---
 doc/source/whatsnew/v1.4.0.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/doc/source/whatsnew/v1.4.0.rst b/doc/source/whatsnew/v1.4.0.rst
index 450ecc85c725b..36440805729d9 100644
--- a/doc/source/whatsnew/v1.4.0.rst
+++ b/doc/source/whatsnew/v1.4.0.rst
@@ -75,6 +75,7 @@ Styler
   - :meth:`.Styler.to_latex` introduces keyword argument ``environment``, which also allows a specific "longtable" entry through a separate jinja2 template (:issue:`41866`).
   - :meth:`.Styler.to_html` introduces keyword arguments ``sparse_index`` and ``sparse_columns`` (:issue:`41946`)
   - Keyword argument ``level`` is added to :meth:`.Styler.hide_index` and :meth:`.Styler.hide_columns` for optionally controlling hidden levels in a MultiIndex (:issue:`25475`)
+  - Global options have been extended to configure default ``Styler`` properties including encoding options (:issue:`41395`)
 
 There are also bug fixes and deprecations listed below.
 

From b51020de08fece7dd4b9eb039288fd45fc37498c Mon Sep 17 00:00:00 2001
From: "JHM Darbyshire (iMac)" <attack68@users.noreply.github.com>
Date: Sun, 29 Aug 2021 09:10:07 +0200
Subject: [PATCH 3/4] refactor encoding

---
 pandas/io/formats/style.py                 | 4 +++-
 pandas/tests/io/formats/style/test_html.py | 8 ++++++++
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/pandas/io/formats/style.py b/pandas/io/formats/style.py
index 871817c1599a9..61811147e30e5 100644
--- a/pandas/io/formats/style.py
+++ b/pandas/io/formats/style.py
@@ -830,7 +830,9 @@ def to_latex(
         )
 
         encoding = encoding or get_option("styler.render.encoding")
-        return save_to_buffer(latex, buf=buf, encoding=encoding)
+        return save_to_buffer(
+            latex, buf=buf, encoding=None if buf is None else encoding
+        )
 
     def to_html(
         self,
diff --git a/pandas/tests/io/formats/style/test_html.py b/pandas/tests/io/formats/style/test_html.py
index 777afe0ff0da4..493e839d63d2b 100644
--- a/pandas/tests/io/formats/style/test_html.py
+++ b/pandas/tests/io/formats/style/test_html.py
@@ -191,6 +191,14 @@ def test_doctype(styler):
     assert "<head>" not in result
 
 
+def test_doctype_encoding(styler):
+    with option_context("styler.render.encoding", "ASCII"):
+        result = styler.to_html(doctype_html=True)
+        assert '<meta charset="ASCII">' in result
+        result = styler.to_html(doctype_html=True, encoding="ANSI")
+        assert '<meta charset="ANSI">' in result
+
+
 def test_block_names(tpl_style, tpl_table):
     # catch accidental removal of a block
     expected_style = {

From b9a8fe3a6afc00e9e66e5fb5739a92a08742c18d Mon Sep 17 00:00:00 2001
From: "JHM Darbyshire (iMac)" <attack68@users.noreply.github.com>
Date: Wed, 1 Sep 2021 08:45:34 +0200
Subject: [PATCH 4/4] add utf-8

---
 pandas/io/formats/style.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pandas/io/formats/style.py b/pandas/io/formats/style.py
index 8e69fa28dca04..4fc13fd54df02 100644
--- a/pandas/io/formats/style.py
+++ b/pandas/io/formats/style.py
@@ -528,7 +528,7 @@ def to_latex(
             .. versionadded:: 1.4.0
         encoding : str, optional
             Character encoding setting. Defaults
-            to ``pandas.options.styler.render.encoding`` value.
+            to ``pandas.options.styler.render.encoding`` value of "utf-8".
         convert_css : bool, default False
             Convert simple cell-styles from CSS to LaTeX format. Any CSS not found in
             conversion table is dropped. A style can be forced by adding option
@@ -903,7 +903,7 @@ def to_html(
             .. versionadded:: 1.4.0
         encoding : str, optional
             Character encoding setting for file output, and HTML meta tags.
-            Defaults to ``pandas.options.styler.render.encoding`` value.
+            Defaults to ``pandas.options.styler.render.encoding`` value of "utf-8".
         doctype_html : bool, default False
             Whether to output a fully structured HTML file including all
             HTML elements, or just the core ``<style>`` and ``<table>`` elements.