Merge pull request #11634 from TomAugspurger/styler-fu

CLN: Followup to HTML Formatting

Author: jreback

ci/requirements_all.txt

@@ -20,3 +20,4 @@ lxml
 sqlalchemy
 bottleneck
 pymysql
+Jinja2

doc/make.py

@@ -104,11 +104,14 @@ def clean():
 
 def html():
     check_build()
+    os.system('jupyter nbconvert --to=html --template=basic '
+              '--output=source/html-styling.html source/html-styling.ipynb')
     if os.system('sphinx-build -P -b html -d build/doctrees '
                  'source build/html'):
         raise SystemExit("Building HTML failed.")
     try:
         # remove stale file
+        os.system('rm source/html-styling.html')
         os.system('cd build; rm -f html/pandas.zip;')
     except:
         pass

doc/source/html-styling.html

@@ -299,6 +299,19 @@ td.field-body blockquote {
     padding-left: 30px;
 }
 
+.rendered_html table {
+    margin-left: auto;
+    margin-right: auto;
+    border-right: 1px solid #cbcbcb;
+    border-bottom: 1px solid #cbcbcb;
+}
+
+.rendered_html td, th {
+    border-left: 1px solid #cbcbcb;
+    border-top: 1px solid #cbcbcb;
+    margin: 0;
+    padding: 0.5em .75em;
+}
 
 /**
  * See also

doc/source/html-styling.ipynb

@@ -25,11 +25,25 @@ New features
 Conditional HTML Formatting
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-We've added *experimental* support for conditional HTML formatting,
+We've added *experimental* support for conditional HTML formatting:
 the visual styling of a DataFrame based on the data.
 The styling is accomplished with HTML and CSS.
 Acesses the styler class with :attr:`pandas.DataFrame.style`, attribute,
 an instance of :class:`~pandas.core.style.Styler` with your data attached.
+
+Here's a quick example:
+
+  .. ipython:: python
+
+    np.random.seed(123)
+    df = DataFrame(np.random.randn(10, 5), columns=list('abcde'))
+    html = df.style.background_gradient(cmap='viridis', low=.5)
+
+We can render the HTML to get the following table.
+
+.. raw:: html
+   :file: whatsnew_0171_html_table.html
+
 See the :ref:`example notebook <style>` for more.
 
 .. _whatsnew_0171.enhancements: