Release 1.47.0 (#1308)

* Update streamlit.json

* Remove 1.20 and 1.21

* Add 1.47.0 release notes

* What's new

* Embedded apps

* Update config-toml.md

* Cheat sheet

* Theming overview examples

* Config format

* New theming config options

* Bump release date to 7/16

* TOML formatting

Author: sfc-gh-dmatthews

content/develop/api-reference/configuration/config-toml.md

@@ -32,6 +32,7 @@ The following two configuration options can only be applied to the whole app:
 
 - `theme.base` sets the default colors for your app's theme to match one of Streamlit's two default themes (`"light"` or `"dark"`). If any theme configuation option is used and `theme.base` is not set, then Streamlit will use `"light"`.
 - `theme.showSidebarBorder` sets the visibility of the border between the sidebar and the main body of your app.
+- `theme.chartCategoricalColors` and `theme.chartSequentialColors` set the series colors for Plotly, Altair, and Vega-Lite charts.
 
 The following configuration options can be set separately for the sidebar by using the `[theme.sidebar]` table instead of the `[theme]` table in `config.toml`:
 
@@ -40,11 +41,13 @@ The following configuration options can be set separately for the sidebar by usi
 - `theme.secondaryBackgroundColor`
 - `theme.textColor`
 - `theme.linkColor`
+- `theme.linkUnderline`
 - `theme.codeBackgroundColor`
 - `theme.baseRadius`
 - `theme.buttonRadius`
 - `theme.borderColor`
 - `theme.dataframeBorderColor`
+- `theme.dataframeHeaderBackgroundColor`
 - `theme.showWidgetBorder`
 
 For brevity, on the rest of this page, theming configuration options will not include the `theme.` or `theme.sidebar.` prefix.
@@ -81,17 +84,15 @@ primaryColor="darkGoldrod"
 
 <Cloud name="doc-theming-color-primarycolor" height="350px" />
 
-### `backgroundColor`, `secondaryBackgroundColor`, and `codeBackgroundColor`
+### `backgroundColor`, `secondaryBackgroundColor`, `codeBackgroundColor`, and `dataframeHeaderBackgroundColor`
 
-`backgroundColor` defines the background color of your app.
-
-`secondaryBackgroundColor` is used for contrast in the following places:
-
-- The background of input or selection regions for widgets
-- Headers within elements like `st.dataframe` and `st.help`
-- Code blocks and inline code (if `codeBackgroundColor` is not set)
-
-`codeBackgroundColor` sets the background for code blocks and line code. If `codeBackgroundColor` is not set, Streamlit uses `secondaryBackgroundColor` instead.
+- `backgroundColor` defines the background color of your app.
+- `secondaryBackgroundColor` is used for contrast in the following places:
+  - The background of input or selection regions for widgets
+  - Headers within elements like `st.help` and `st.dataframe` (if `dataframeHeaderBackgroundColor` isn't set)
+  - Code blocks and inline code (if `codeBackgroundColor` isn't set)
+- `codeBackgroundColor` sets the background for code blocks and line code. If `codeBackgroundColor` is not set, Streamlit uses `secondaryBackgroundColor` instead.
+- `dataframeHeaderBackgroundColor` sets the background for dataframe headers (including the cells used for row selection and addition, if present).
 
 <Note>
 
@@ -120,11 +121,11 @@ secondaryBackgroundColor="lavender"
 
 <Cloud name="doc-theming-color-backgroundcolor" height="450px" />
 
-### `textColor` and `linkColor`
+### `textColor`, `linkColor`, and `linkUnderline`
 
 You can configure the color of body text and links.
 
-`textColor` sets the default text color for all text in the app except language-highlighting in code blocks, inline code, and links. `linkColor` sets the default font color for all Markdown links in the app.
+`textColor` sets the default text color for all text in the app except language-highlighting in code blocks, inline code, and links. `linkColor` sets the default font color for all Markdown links in the app. If `linkUnderline` is set to true (default), the link underline color matches `linkColor`.
 
 The following elements are impacted by `textColor`:
 

content/develop/concepts/configuration/theming-colors-and-borders.md

@@ -24,11 +24,20 @@ headingFont = "sans-serif"
 codeFont = "monospace"
 ```
 
+You can set the base font weight and size in the `[theme]` table in `config.toml`. These can't be configured separately in the sidebar.
+
+- `theme.baseFontSize` sets the root font size for your app.
+- `theme.baseFontWeight` sets the root font weight for your app.
+
 The following configuration options can be set separately for the sidebar by using the `[theme.sidebar]` table instead of the `[theme]` table in `config.toml`:
 
 - `theme.font` sets the default font for all text in the app (except inline code and code blocks). This is `"sans-serif"` (Source Sans) by default.
 - `theme.headingFont` sets the default font for all headings in the app. If this is not set, Streamlit uses `theme.font` instead.
+- `theme.headingFontSizes` sets the font sizes for `<h1>`-`<h6>` headings.
+- `theme.headingFontWeights` sets the font sizes for `<h1>`-`<h6>` headings.
 - `theme.codeFont` sets the default font for all inline code and code blocks. This is `"monospace"` (Source Code) by default.
+- `theme.codeFontSize` sets the size of code text in code blocks, `st.json`, and `st.help` (but not inline code).
+- `theme.codeFontWeight` sets the weight of code text in code blocks, `st.json`, and `st.help` (but not inline code).
 
 When fonts are not declared in `[theme.sidebar]`, Streamlit will inherit each option from `[theme]` before defaulting to less specific options. For example, if `theme.sidebar.headingFont` is not set, Streamlit uses (in order of precedence) `theme.headingFont`, `theme.sidebar.font`, or `theme.font` instead.
 
@@ -109,14 +118,14 @@ project_directory/
 
 ### Example 2: Define an alternative font with static font files
 
-In this configuration example, an alternative font is declared with multiple static font files. For each font, four static files are needed to define the following weight-style pairs:
+In this configuration example, an alternative font is declared with multiple static font files. For each font, four static files define the following weight-style pairs:
 
 - normal normal
 - normal bold
 - italic normal
 - italic bold
 
-If one of the files is missing and you try to use its associated weight and style in your app, the user's browser will use the closest font that is available. The following example uses [Tuffy](https://fonts.google.com/specimen/Tuffy) font. The font has four static font files that cover the four weight-style pairs.
+If your app uses a font without a matching weight-style definition, the user's browser will use the closest font that is available. The default weight for `<h2>`-`<h6>` headings is semibold (600). For completeness, include additional font files to cover the semibold weight and all the font weights in your app. The following example uses [Tuffy](https://fonts.google.com/specimen/Tuffy) font. The font has four static font files that cover the four weight-style pairs.
 
 A line-by-line explanation of this example is available in a [tutorial](/develop/tutorials/configuration-and-theming/static-fonts).
 

content/develop/concepts/configuration/theming-fonts.md

@@ -7,19 +7,22 @@ slug: /develop/concepts/configuration/theming
 
 In this guide, we provide an overview of theming and visual customization of Streamlit apps. Streamlit themes are defined using configuration options, which are most commonly defined in a `.streamlit/config.toml` file. For more information about setting configuration options, see [Working with configuration options](/develop/concepts/configuration/options). For a complete list of configuration options and definitions, see the API reference for [config.toml](/develop/api-reference/configuration/config.toml#theme).
 
-The following options can be set once for your whole app:
+The following options can be set in the `[theme]` table of `config.toml` and can't be set separately in the `[theme.sidebar]` table:
 
 - **Base color scheme**: Set your custom theme to inherit from Streamlit's light or dark theme.
-- **Font size**: Set the base font size for your app.
+- **Base font**: Set the base font weight and size. (This can be configured separately for heading and code font.)
+- **Chart color**: Set series colors for Plotly, Altair, and Vega-Lite charts.
+- **Sidebar border**: Set the visibility of the sidebar border.
 
 The following options can be configured separately for the main body of your app and the sidebar:
 
-- **Font**: Set the font family for body text, headers, and code.
+- **Font family**: Set the font family for body text, headings, and code.
+- **Font style**: Set the weight and size of heading and code font, and set visibility of link underlines.
 - **Text color**: Set the color of body text and links.
 - **Primary color**: Set the color of interactive elements and highlights.
-- **Background color**: Set the color of app, widget, and code block backgrounds.
+- **Background color**: Set the color of app, widget, code block, and dataframe header backgrounds.
 - **Border radius**: Set the roundness of elements and widgets.
-- **Border color**: Set the color and visibility of element, widget, and sidebar borders.
+- **Border color**: Set the color and visibility of element, widget, sidebar, and dataframe borders.
 
 ## Example themes
 

content/develop/concepts/configuration/theming.md

@@ -5,7 +5,7 @@ slug: /develop/quick-reference/cheat-sheet
 
 # Streamlit API cheat sheet
 
-This is a summary of the docs for the latest version of Streamlit, [v1.46.0](https://pypi.org/project/streamlit/1.46.0/).
+This is a summary of the docs for the latest version of Streamlit, [v1.47.0](https://pypi.org/project/streamlit/1.47.0/).
 
 <Masonry>