mkdocs-material/docs/changelog/index.md

# Changelog

## Material for MkDocs

### 9.1.8 <small>April 24, 2023</small> { id="9.1.8" }

- Fixed #5417: Theme breaks when `palette` is not defined (9.1.7 regression)

### 9.1.7 <small>April 22, 2023</small> { id="9.1.7" }

- Updated Persian (Farsi) and Turkish translations
- Fixed #5401: Added missing flag to disable built-in tags plugin
- Fixed #5206: Ensure defaults are set for primary and accent colors
- Fixed unnecessary inclusion of palette CSS when unused

### 9.1.6 <small>April 7, 2023</small> { id="9.1.6" }

- Updated Persian (Farsi) translations
- Fixed #5300: Boxes in Mermaid sequence diagrams not color-abiding

### 9.1.5 <small>March 31, 2023</small> { id="9.1.5" }

- Updated Lithuanian and Japanese translations
- Updated Mermaid.js to version 9.4.3
- Fixed #5290: Footer previous/next labels cut-off for short page titles

### 9.1.4 <small>March 24, 2023</small> { id="9.1.4" }

- Fixed #5239: Instant loading breaks anchors in details (9.1.1 regression)
- Fixed #5211: Anchor following not working for Chinese (9.1.2 regression)

### 9.1.3 <small>March 14, 2023</small> { id="9.1.3" }

- Added Kurdish (Soranî) translations
- Updated Norwegian (Bokmål), Portuguese and Romanian translations
- Improved compatibility with `mkdocs-jupyter` plugin
- Fixed #5198: Built-in search plugin not filtering `script` and `style` tags
- Fixed #5176: Back-to-top + instant loading not working (9.1.1 regression)

### 9.1.2 <small>March 9, 2023</small> { id="9.1.2" }

- Updated Icelandic, Korean and Swedish translations
- Fixed #5168: Mermaid text boxes overflow (9.0.13 regression)
- Fixed #5155: Table of contents not highlighting percent-encoded URLs

### 9.1.1 <small>March 5, 2023</small> { id="9.1.1" }

- Updated Czech and Thai translations
- Improved instant loading (scroll restoration, slow connections)
- Fixed #5023: Instant loading not allowing to go back to initial page
- Fixed #3797: Instant loading does not work with section anchors in Safari

### 9.1.0 <small>March 2, 2023</small> { id="9.1.0" }

- Docker image now available for `amd64`, `arm64` and `arm/v7`
- Updated Chinese (Taiwanese) translations
- Generalized tag identifier implementation
- Fixed flickering of header shadow on load
- Fixed occasional flickering of announcement bar

### 9.0.15 <small>February 26, 2023</small> { id="9.0.15" }

- Updated Chinese (Traditional) translations
- Updated Hebrew translations

### 9.0.14 <small>February 23, 2023</small> { id="9.0.14" }

- Fixed #5072: Rendering bug on navigation expand button in Firefox

### 9.0.13 <small>February 18, 2023</small> { id="9.0.13" }

- Updated Uzbek translations
- Switched back to pre-9.0.0 headline detection in `content` partial
- Fixed #5062: Version warning not readable when using slate scheme
- Fixed #5061: Improved discernibility of table row hover color
- Fixed #5034: Sequence actors in Mermaid diagrams not color-abiding
- Fixed #4919: Allow to hide version warning in multiple versions

### 9.0.12 <small>February 9, 2023</small> { id="9.0.12" }

- Updated Catalan translations
- Fixed #4975: Mermaid entity relationship rendering diagrams bug
- Fixed #4924: Header title not reset when using instant loading

### 9.0.11 <small>February 3, 2023</small> { id="9.0.11" }

- Added Mastodon verification for social links (`rel=me`)
- Updated Italian translations

### 9.0.10 <small>February 2, 2023</small> { id="9.0.10" }

- Updated Arabic translations
- Updated Korean translations
- Updated Hungarian translations
- Updated Russian translations
- Fixed #4977: Improved accessibility for content tabs
- Fixed #4960: Sometimes anchor following doesn't bring last item into view

### 9.0.9 <small>January 30, 2023</small> { id="9.0.9" }

- Updated Bulgarian translations
- Updated Chinese (Simplified) translations
- Updated Dutch translations
- Updated Hindi translations
- Updated Japanese translations
- Updated Polish translations

### 9.0.8 <small>January 29, 2023</small> { id="9.0.8" }

- Updated Croatian translations
- Updated French translations
- Updated Hungarian translations
- Updated Portuguese (Brasilian) translations
- Updated Spanish translations
- Updated Ukrainian translations
- Updated Urdu translations
- Updated Vietnamese translations

### 9.0.7 <small>January 28, 2023</small> { id="9.0.7" }

- Improved accessibility of sidebar navigation
- Moved all translations into community edition
- Updated Polish and Portuguese (Brasilian) translations
- Fixed info plugin terminating on subsequent reload when serving
- Fixed #4910: Sidebar navigation labels have invalid ARIA roles
- Fixed #4884: Search query terms can't be separated by colons

### 9.0.6 <small>January 19, 2023</small> { id="9.0.6" }

- Fixed #4883: Automatically disable info plugin when serving
- Fixed #4885: Search plugin crashes in some exotic cases (9.0.3 regression)

### 9.0.5 <small>January 14, 2023</small> { id="9.0.5" }

- Fixed #4842: Improved accessibility of search result list

### 9.0.4 <small>January 12, 2023</small> { id="9.0.4" }

- Fixed #4823: Improved contrast ratio in footer (9.0.2 regression)
- Fixed #4832: Set navigation items back to black (9.0.3 regression)
- Fixed #4843: Emojis broken due to maxcdn.com shutting down
- Upgraded Python Markdown Extensions to 9.9.1

### 9.0.3 <small>January 8, 2023</small> { id="9.0.3" }

- Improved discernibility of section index pages in navigation
- Improved collapsing of adjacent whitespace in search plugin
- Updated Indonesian translations
- Fixed view source of this page button when edit URL points to blob
- Fixed #4829: Search overlay does not close for active anchor result
- Fixed #4824: Search plugin crashes for `h[1-6]` contained in other elements
- Fixed #4804: Nested navigation items not expandable with keyboard
- Fixed #4689: anchor tracking not working for anchors in tables
- Upgraded to Mermaid 9.3.0

### 9.0.2 <small>January 4, 2023</small> { id="9.0.2" }

- Fixed #4823: Improved contrast ratio in footer to meet WCAG guidelines
- Fixed #4819: Social plugin crashes when card generation is disabled
- Fixed #4817: Search plugin crashes on numeric page titles in `nav`

### 9.0.1 <small>January 3, 2023</small> { id="9.0.1" }

- Removed `pipdeptree` dependency for built-in info plugin
- Fixed appearance of linked tags when hovered (9.0.0 regression)
- Fixed #4810: Abbreviations run out of screen on touch devices
- Fixed #4813: View source and edit button links are the same

### 9.0.0 <small>January 2, 2023</small> { id="9.0.0" }

__Additions and improvements__

- Added support for rich search previews
- Added support for tokenizer lookahead
- Added support for better search highlighting
- Added support for excluding content from search
- Added support for configurable search pipeline
- Added support for offline search via offline plugin
- Added support for multiple instances of built-in tags plugin
- Added support for removing copy-to-clipboard button
- Added support for removing footer navigation
- Added support for button to view the source of a page
- Improved readability of query string for search sharing
- Improved stability of search plugin when using `--dirtyreload`
- Improved search result group button, now sticky and stable
- Updated Norwegian translations
- Updated MkDocs to 1.4.2

__Removals__

- Removed deprecated alternative admonition qualifiers
- Removed `:is()` selectors (in output) for easier overriding
- Removed `.title` suffix on translations
- Removed legacy method for providing page title in feedback URL
- Removed support for indexing only titles in search
- Removed support for custom search transforms
- Removed support for custom search workers
- Removed temporary snow feature (easter egg)

__Fixes__

- Fixed Norwegian and Korean language code
- Fixed detection of composition events in search interface
- Fixed search plugin not using title set via front matter
- Fixed search highlighting of tags
- Fixed search sharing URL using post transformed string
- Fixed theme-color meta tag getting out-of-sync with palette toggle
- Fixed prev/next page keyboard navigation when footer is not present
- Fixed overflowing navigation tabs not being scrollable
- Fixed inclusion of code block line numbers from search

---

### 8.5.11 <small>November 30, 2022</small> { id="8.5.11" }

- Let it snow, see https://twitter.com/squidfunk/status/1597939243090788352

### 8.5.10 <small>November 11, 2022</small> { id="8.5.10" }

- Adjusted CSS to better allow for custom primary and accent colors
- Fixed #4620: Primary color is not applied (8.5.9 regression)

### 8.5.9 <small>November 8, 2022</small> { id="8.5.9" }

- Fixed #4600: Illegible link colors for black and white primary colors
- Fixed #4594: Need to set schema to change link color

### 8.5.8 <small>November 3, 2022</small> { id="8.5.8" }

- Added support for always showing settings in cookie consent
- Fixed #4571: Buttons invisible if primary color is `white` or `black`
- Fixed #4517: Illegible note in sequence diagram when using `slate` scheme

### 8.5.7 <small>October 22, 2022</small> { id="8.5.7" }

- Deprecated additional admonition qualifiers to reduce size of CSS
- Fixed #4511: Search boost does not apply to sections

### 8.5.6 <small>October 2, 2022</small> { id="8.5.6" }

- Modernized appearance of admonitions (with fallback, see docs)
- Improved appearance of inline code blocks in admonition titles

### 8.5.5 <small>October 1, 2022</small> { id="8.5.5" }

- Updated MkDocs to 1.4
- Fixed compatibility issues with MkDocs 1.4
- Fixed #4430: build error when enabling consent without repository URL

### 8.5.4 <small>September 30, 2022</small> { id="8.5.4" }

- Fixed expand icons shift on sidebar overflow (using `scrollbar-gutter`)
- Fixed #4429: Text in sequence diagrams overflows in Firefox

### 8.5.3 <small>September 20, 2022</small> { id="8.5.3" }

- Fixed build error when enabling cookie consent without analytics
- Fixed #4381: Code blocks render ligatures for some fonts

### 8.5.2 <small>September 18, 2022</small> { id="8.5.2" }

- Updated Mermaid.js to version 9.1.7
- Fixed overly large headlines in search results (8.5.0 regression)
- Fixed #4358: Navigation sections appear as clickable (8.5.0 regression)
- Fixed #4356: GitHub repository statistics fetched before cookie consent

### 8.5.1 <small>September 15, 2022</small> { id="8.5.1" }

- Fixed #4366: Removed dependencies with native extensions

### 8.5.0 <small>September 13, 2022</small> { id="8.5.0" }

- Added support for social cards
- Added support for code annotation anchor links (deep linking)
- Added support for code annotation comment stripping (syntax modifier)
- Added support for sidebars scrolling automatically to active item
- Added support for anchor following table of contents (= auto scroll)
- Added support for tag icons

### 8.4.4 <small>September 12, 2022</small> { id="8.4.4" }

- Moved comments integration to separate partial (`comments.html`)

### 8.4.3 <small>September 7, 2022</small> { id="8.4.3" }

- Added Simple Icons to bundled icons (+2,300 icons)
- Added support for changing edit icon
- Moved page actions to separate partial (`actions.html`)
- Fixed #4291: Version switching doesn't stay on page when anchors are used
- Fixed #4327: Links in data tables do not receive link styling

### 8.4.2 <small>August 27, 2022</small> { id="8.4.2" }

- Updated Slovenian translations
- Fixed #4277: Feedback widget hidden after navigation with instant loading
- Fixed numeric tags in front matter breaking search functionality

### 8.4.1 <small>August 21, 2022</small> { id="8.4.1" }

- Updated Croatian and Hebrew translations

### 8.4.0 <small>August 13, 2022</small> { id="8.4.0" }

- Added support for cookie consent
- Added support for feedback widget (Was this page helpful?)
- Added support for dismissible announcement bar
- Added Armenian, Lithuanian, Tagalog, and Urdu translations

### 8.3.9 <small>July 4, 2022</small> { id="8.3.9" }

- Updated Taiwanese translations for search
- Allow ids for content tabs with special characters (for mkdocstrings)
- Fixed #4083: home not clickable when using versioning (8.3.5 regression)

### 8.3.8 <small>June 24, 2022</small> { id="8.3.8" }

- Fixed #4053: Limit width of videos to content area
- Fixed empty tags in front matter breaking search

### 8.3.7 <small>June 22, 2022</small> { id="8.3.7" }

- Fixed search being stuck initializing when using tags (8.3.4 regression)

### 8.3.6 <small>June 16, 2022</small> { id="8.3.6" }

- Fixed #4028: Links not clickable when using versioning (8.3.5 regression)

### 8.3.5 <small>June 14, 2022</small> { id="8.3.5" }

- Fixed #4012: Stay on page not working for alias of active version

### 8.3.4 <small>June 11, 2022</small> { id="8.3.4" }

- Fixed #4004: Tags with multiple words not searchable

### 8.3.3 <small>June 7, 2022</small> { id="8.3.3" }

- Fixed #4000: Mermaid diagrams too dark in dark mode (8.3.0 regression)

### 8.3.2 <small>June 5, 2022</small> { id="8.3.2" }

- Fixed #3987: Custom admonition icons don't work when defining color palette

### 8.3.1 <small>June 4, 2022</small> { id="8.3.1" }

- Bump required Jinja version to 3.0.2
- Removed unnecessary conditions in templates
- Fixed scroll offset when content tabs are brought into view
- Fixed #3977: Content tabs snapping oddly in Firefox
- Fixed #3983: Missing condition in footer partial (8.3.0 regression)

### 8.3.0 <small>June 2, 2022</small> { id="8.3.0" }

- Added support for custom admonition icons
- Added support for linking of content tabs
- Added support for boosting pages in search
- Added support for hiding footer navigation
- Added previous/next indicators to content tabs
- Improved typeset link colors in light and dark modes

### 8.2.16 <small>May 28, 2022</small> { id="8.2.16" }

- Fixed #3957: Only animate code annotations when visible (save CPU cycles)

### 8.2.15 <small>May 14, 2022</small> { id="8.2.15" }

- Added Uzbek translations
- Fixed spacing for code block results in content tabs

### 8.2.14 <small>May 8, 2022</small> { id="8.2.14" }

- Fixed missing top right rounded border on admonition
- Fixed #3886: `4xx` status codes not handled when using instant loading

### 8.2.13 <small>May 2, 2022</small> { id="8.2.13" }

- Fixed #3865: Tags index links to tagged pages 404 on Windows
- Fixed #3866: Bump required Python version from 3.6+ to 3.7+

### 8.2.12 <small>April 30, 2022</small> { id="8.2.12" }

- Added support for GitHub-style hash fragments for dark/light images
- Improved rendering of nested code blocks in content tabs and annotations
- Fixed #3862: Upgraded to latest Pygments and Python Markdown Extensions

### 8.2.11 <small>April 25, 2022</small> { id="8.2.11" }

- Temporarily pinned Pygments to `<2.12`
- Temporarily pinned Python Markdown Extensions to `<9.4`
- Improved rendering of code annotation markers

### 8.2.10 <small>April 24, 2022</small> { id="8.2.10" }

- Added Macedonian translations
- Updated Mermaid.js to version 9.0.1
- Switched sidebar title in mobile navigation to bold font
- Fixed color of arrows in class and state diagrams for dark mode
- Fixed #3836: Inline admonitions overlayed by code block titles

### 8.2.9 <small>April 8, 2022</small> { id="8.2.9" }

- Mitigate flicker on color palette switch by disabling all transitions
- Fixed search suggestions not triggered when following deep link
- Fixed incorrectly computed header height when using instant loading
- Fixed #3782: Admonition titles have extra pixels on wide screens in Firefox
- Fixed #3802: Always render table of contents container (except when hidden)

### 8.2.8 <small>March 27, 2022</small> { id="8.2.8" }

- Bumped MkDocs version to 1.3.0 to mitigate breaking changes in Jinja
- Reverted Jinja version range limitation (added in 8.2.7)
- Improved styling of annotations and fixed borders of code blocks in tabs
- Added background color to code blocks in focused/hovered links
- Added check in tags plugin whether tags overview page exists
- Fixed #3744: Content tab indicator on wrong position when using back button

### 8.2.7 <small>March 24, 2022</small> { id="8.2.7" }

- Temporarily limit Jinja version range to < 3.1 due to breaking changes

### 8.2.6 <small>March 23, 2022</small> { id="8.2.6" }

- Fixed #3695: Deprecation warning for unescaped backslashes in templates
- Fixed #3696: Annotations not mounted in some Terraform code blocks
- Fixed #3698: Annotations not mounted in long code blocks (8.2.5 regression)

### 8.2.5 <small>March 6, 2022</small> { id="8.2.5" }

- Fixed #3596: Mermaid not working when headline with name 'Mermaid' present
- Fixed #3643: Reduce time to render pages with thousands of code blocks
- Fixed #3665: Missing styles for Mermaid.js flowcharts cluster labels

### 8.2.4 <small>March 2, 2022</small> { id="8.2.4" }

- Fixed malformed Google Fonts URL when a font setting was omitted
- Fixed #3648: Fixed specificity issue with admonitions in lists
- Fixed #3653: Invalid outdated version banner URL when using instant loading

### 8.2.3 <small>February 27, 2022</small> { id="8.2.3" }

- Fixed #3578: Active element in table of contents off-by-one on large screens

### 8.2.2 <small>February 26, 2022</small> { id="8.2.2" }

- Added automatic removal of query parameter when search is closed
- Fixed #3599: Anchors always overridden when using navigation tracking

### 8.2.1 <small>February 17, 2022</small> { id="8.2.1" }

- Fixed module `material.plugins` not being found (8.2.0 regression)

### 8.2.0 <small>February 17, 2022</small> { id="8.2.0" }

- Added native support for Mermaid.js diagrams
- Added native support for tags (with search integration)
- Added support for staying on page when switching versions

### 8.1.11 <small>February 10, 2022</small> { id="8.1.11" }

- Added Portuguese (Brasilian) translations
- Updated FontAwesome to v6 – [check which icons were renamed here]
- Fixed #3545: Color palette toggle and search overlaying version selector

  [check which icons were renamed here]: https://fontawesome.com/docs/web/setup/upgrade/whats-changed#icons-renamed-in-version-6

### 8.1.10 <small>February 6, 2022</small> { id="8.1.10" }

- Fixed cutoff of very wide logos in the sidebar on mobile

### 8.1.9 <small>January 30, 2022</small> { id="8.1.9" }

- [Added support for `mkdocs.yml` validation and auto-complete][validation]
- Fixed errors in Latvian translations

  [validation]: ../creating-your-site.md#minimal-configuration

### 8.1.8 <small>January 23, 2022</small> { id="8.1.8" }

- Added Latvian translations
- Updated Giscus example integration with dynamic theme change support
- Fixed #3479: Back-to-top button not hidden when using sticky navigation tabs
- Fixed #3491: Logo in header and drawer doesn't honor aspect ratio

### 8.1.7 <small>January 16, 2022</small> { id="8.1.7" }

- Improved back-to-top button behavior - now not shown on anchor jump

### 8.1.6 <small>January 11, 2022</small> { id="8.1.6" }

- Fixed spacing of blockquotes (8.1.5 regression)
- Fixed edge cases for rounded corners on code blocks (8.1.5 regression)
- Fixed issues with code annotation line heights

### 8.1.5 <small>January 9, 2022</small> { id="8.1.5" }

- Improved browser support: Chrome 49+, Safari 10+, Firefox 53+, Edge 79+
- Improved rendering of inline code blocks in headlines
- Added Bahasa Malaysian translations
- Fixed #3354: MathJax formulas show vertical scrollbar

### 8.1.4 <small>January 2, 2022</small> { id="8.1.4" }

- Added indicator to navigation expander icon
- Improved support for reduced motion preference
- Fixed jitter of active content tab indicator

### 8.1.3 <small>December 19, 2021</small> { id="8.1.3" }

- Added animation to active content tab indicator
- Fixed #3360: Highlighted lines add blank lines in copied text
- Fixed usage of subsequent index files when using section index pages

### 8.1.2 <small>December 15, 2021</small> { id="8.1.2" }

- Switched CSS sources to logical properties
- Added transformation of logical properties to `ltr`/`rtl` equivalents
- Fixed spacing for admonitions inside lists (8.1.1 regression)

### 8.1.1 <small>December 13, 2021</small> { id="8.1.1" }

- Added support for `#only-light` and `#only-dark` image hash fragments
- Fixed copy-to-clipboard adding blank lines when using line anchors
- Fixed code annotation directionality for right-to-left languages
- Fixed header title positioning for right-to-left languages
- Fixed admonition borders for right-to-left languages (8.0.0 regression)
- Fixed footer navigation link positioning (8.0.0 regression)
- Fixed footer navigation title breaking out of container when too long
- Fixed shrinking arrow in navigation title when too long
- Fixed #3343: Filtered stopwords appear as missing search terms
- Fixed #3346: Site unusable due to usage of `:not()` (Firefox 78 ESR)

### 8.1.0 <small>December 10, 2021</small> { id="8.1.0" }

- Added basic support for code block line anchors
- Switched code annotation markers to `+` signs to improve usability
- Switched main site title to bold font
- Improved admonition icon positioning to align when `font-size` is increased
- Improved and simplified footnotes CSS
- Improved and simplified code annotation positioning
- Fixed syntax error in Russian translations

### 8.0.5 <small>December 6, 2021</small> { id="8.0.5" }

- Fixed #3302: Footer refactoring induced ellipsis in some browsers
- Fixed #3313: Details always rendered closed on load (8.0.4 regression)

### 8.0.4 <small>December 4, 2021</small> { id="8.0.4" }

- Improved support for deeply nested code annotations
- Improved code annotation and copy-to-clipboard interop
- Improved styling for code annotations inside admonitions
- Fixed #3274: Invalid anchor positioning when using instant loading
- Fixed #3294: Lists after code blocks without code annotations disappearing
- Fixed several positioning issues for code annotations
- Fixed JavaScript source map roots

### 8.0.3 <small>December 2, 2021</small> { id="8.0.3" }

- Removed deprecated `google_analytics` setting (was forgotten in 8.0.0)
- Fixed syntax error in Swedish and Polish translations
- Fixed #3283: Invalid back-to-top button position with sticky navigation tabs
- Fixed #3285: Default details marker showing due to Safari bug

### 8.0.2 <small>November 30, 2021</small> { id="8.0.2" }

- Fixed #3275: Code annotations always disappear on click

### 8.0.1 <small>November 28, 2021</small> { id="8.0.1" }

- Improved rendering of code annotation markers
- Fixed #3265: Wrong margin on nested admonitions
- Fixed wrong `box-sizing` for code annotations in details

### 8.0.0 <small>November 28, 2021</small> { id="8.0.0" }

- Added support for code annotations
- Added support for anchor tracking
- Added support for version warning
- Added `copyright` partial for easier override
- Removed deprecated content tabs legacy implementation
- Removed deprecated `seealso` admonition type
- Removed deprecated `site_keywords` setting (unsupported by MkDocs)
- Removed deprecated prebuilt search index support
- Removed deprecated web app manifest – use customization
- Removed `extracopyright` variable – use new `copyright` partial
- Removed Disqus integation – use customization
- Switched to `:is()` selectors for simple selector lists
- Switched autoprefixer from `last 4 years` to `last 2 years`
- Improved CSS overall to match modern standards
- Improved CSS variable semantics for fonts
- Improved extensibility by restructuring partials
- Improved handling of `details` when printing
- Improved keyboard navigation for footnotes
- Fixed #3214: Search highlighting breaks site when empty

---

### 7.3.6 <small>October 30, 2021</small> { id="7.3.6" }

- Added support for adding titles to code blocks

### 7.3.5 <small>October 27, 2021</small> { id="7.3.5" }

- Added support for setting table of contents title via `mkdocs.yml`
- Fixed back-to-top button position for right-to-left languages

### 7.3.4 <small>October 17, 2021</small> { id="7.3.4" }

- Bumped MkDocs version to 1.2.3 to mitigate [CVE-2021-40978]
- Fixed spacing issues when using integrate table of contents with tabs
- Fixed some spacings issues for right-to-left languages
- Fixed race condition in search initialization

  [CVE-2021-40978]: https://nvd.nist.gov/vuln/detail/CVE-2021-40978

### 7.3.3 <small>October 11, 2021</small> { id="7.3.3" }

- Rewrite of entire documentation
- Adjusted height of new content tabs to match single line code blocks
- Fixed new content tabs missing right padding in some browsers on overflow
- Fixed new content tabs bleeding out of flex container on overflow
- Fixed new content tabs overflow scrolling bugs on some browsers
- Fixed new content tabs stealing keyboard access when active
- Fixed some spacings issues for right-to-left languages

### 7.3.2 <small>October 6, 2021</small> { id="7.3.2" }

- Deprecated prebuilding of search index
- Improved graceful handling of broken search for `file://`
- Added minimum Jinja version to list of requirements
- Fixed #3071: Section index pages render empty directories
- Fixed margin issues when using navigation tabs (7.3.1 regression)
- Fixed search placeholder sometimes being shown too early

### 7.3.1 <small>October 2, 2021</small> { id="7.3.1" }

- Added new experimental content tabs implementation
- Fixed #3069: GitHub stats broken for users/orgs (7.1.0 regression)
- Fixed #3070: Sections not linking to index page
- Fixed title not linking to index page when using tabs
- Fixed Disqus integration when using instant loading
- Fixed some spacing issues for right-to-left languages
- Fixed syntax error in Serbian translations

### 7.3.0 <small>September 23, 2021</small> { id="7.3.0" }

- Added support for sticky navigation tabs
- Added support for section index pages
- Added support for removing generator notice

### 7.2.8 <small>September 20, 2021</small> { id="7.2.8" }

- Fixed #3039: Search modal overlays menu on mobile (7.2.7 regression)

### 7.2.7 <small>September 19, 2021</small> { id="7.2.7" }

- Updated Serbian and Serbo-Croatian translations
- Improved appearance of outline on details
- Fixed #2934: Scrollbar when header is hidden on some mobile browsers
- Fixed #3032: Anchor in details doesn't open on load (7.0.0 regression)
- Fixed back-to-top button being focusable when invisible
- Fixed broken admonition icons (removed in upstream)

### 7.2.6 <small>September 1, 2021</small> { id="7.2.6" }

- Fixed rendering of `blockquote` elements (7.0.0 regression)
- Fixed #2973: Custom search worker setting ignored

### 7.2.5 <small>August 25, 2021</small> { id="7.2.5" }

- Updated Portuguese translations
- Fixed execution of RxJS teardown logic (7.2.3 regression)
- Fixed #2970: Search results show escaped characters (7.2.2 regression)

### 7.2.4 <small>August 11, 2021</small> { id="7.2.4" }

- Fixed #2926: Version selector not working (7.2.3 regression)
- Fixed #2929: Missing CSS class for banner (consistency with Insiders)

### 7.2.3 <small>August 9, 2021</small> { id="7.2.3" }

- Slight facelift of data tables, now closer to Material Design
- Fixed instant loading not respecting clicks on search results
- Fixed #2881: Invalid anchor offsets when using instant loading

### 7.2.2 <small>July 31, 2021</small> { id="7.2.2" }

- Updated Korean translations
- Fixed #2879: Search highlighting does not properly escape HTML

### 7.2.1 <small>July 25, 2021</small> { id="7.2.1" }

- Fixed #2862: Back-to-top button overlays active search bar

### 7.2.0 <small>July 21, 2021</small> { id="7.2.0" }

- Added support for search suggestions to save keystrokes
- Added support for search highlighting
- Added support for search sharing (i.e. deep linking)

### 7.1.11 <small>July 18, 2021</small> { id="7.1.11" }

- Updated Spanish and Galician translations

### 7.1.10 <small>July 10, 2021</small> { id="7.1.10" }

- Refactored appearance of back-to-top button
- Fixed graceful handling of search when browsing locally

### 7.1.9 <small>June 25, 2021</small> { id="7.1.9" }

- Improved search language support for Thai and Hindi
- Fixed #2761: License comments lined up at end of file

### 7.1.8 <small>June 12, 2021</small> { id="7.1.8" }

- Refactored analytics integration (because of MkDocs 1.2)
- Added support for Google Analytics 4 (`gtag.js`)
- Fixed missing escape for `aria-label` in footer links

### 7.1.7 <small>June 6, 2021</small> { id="7.1.7" }

- Improved screen reader support

### 7.1.6 <small>May 30, 2021</small> { id="7.1.6" }

- Deprecated `seealso` admonition qualifier
- Added Mongolian and updated Chinese translations
- Fixed #2429: Version selector not touch-friendly on Android devices
- Fixed #2703: Printed 'Initializing search' albeit ready on mobile

### 7.1.5 <small>May 19, 2021</small> { id="7.1.5" }

- Fixed #2655: Details breaking page margins on print

### 7.1.4 <small>May 6, 2021</small> { id="7.1.4" }

- Added support for git-revision-date-localized plugin creation date
- Improved footnote styles on `:target` and `:focus`

### 7.1.3 <small>April 24, 2021</small> { id="7.1.3" }

- Fixed #2586: Empty table of contents shown (7.1.2 regression)

### 7.1.2 <small>April 18, 2021</small> { id="7.1.2" }

- Fixed #2554: List markers sometimes overlap floated elements
- Fixed #2563: Adding a class to a `h1` breaks the table of contents
- Fixed #2566: Back-to-top button clickable when invisible

### 7.1.1 <small>April 10, 2021</small> { id="7.1.1" }

- Fixed #2501: Nested definition lists compound bottom margin
- Fixed #2508: Switch `extracopyright` block to template variable
- Fixed #2533: Search (and other parts) not working in Safari <14
- Fixed #2538: Visual quirk when opening language selector

### 7.1.0 <small>March 29, 2021</small> { id="7.1.0" }

- Added support for back-to-top button
- Added support for color palette toggle
- Added latest release to repository info (GitHub)
- Slight facelift of repository info (lighter fonts, spacing and icons)

### 7.0.7 <small>March 28, 2021</small> { id="7.0.7" }

- Updated Hungarian translations
- Fixed #2466: Docker image not based on latest Python and Alpine
- Fixed #2488: Inconsistent header shadow behavior
- Fixed #2492: Inline code blocks in admonition titles missing background

### 7.0.6 <small>March 14, 2021</small> { id="7.0.6" }

- Added trailing slash to version selector URL
- Added support for out-of-order anchors in table of contents
- Added `extra.homepage` option to link logo to arbitrary URL
- Improved security of Docker image (always update apk)
- Fixed horizontal spacing for nested inline admonitions
- Fixed text color of nested code blocks inside links
- Fixed version selector to always use version title
- Fixed logo link when using versioning with instant loading

### 7.0.5 <small>March 7, 2021</small> { id="7.0.5" }

- Added `extracopyright` block to allow for custom copyright info
- Fixed evaluation of third-party scripts when using instant loading
- Fixed edge cases when using instant loading without directory URLs
- Fixed handling of version selector when using instant loading
- Fixed regression with header title not being updated correctly
- Fixed expanded sections not opening on first click (7.0.4 regression)

### 7.0.4 <small>March 4, 2021</small> { id="7.0.4" }

- Added Icelandic translations
- Fixed #2386: Section close requires two clicks (navigation expansion)
- Fixed console error when search is disabled (7.0.0 regression)
- Fixed localsearch integration (7.0.0 regression)

### 7.0.3 <small>February 26, 2021</small> { id="7.0.3" }

- Fixed JavaScript errors in older browsers (target ES2020 -> ES2015)

### 7.0.2 <small>February 25, 2021</small> { id="7.0.2" }

- Fixed #2343: Invalid source map URLs for JS and CSS files
- Fixed #2347: Version selector missing when using versioning

### 7.0.1 <small>February 24, 2021</small> { id="7.0.1" }

- Fixed #2334: Google Analytics triggers page view twice (7.0.0 regression)
- Fixed #2336: Details bleed into inline admonitions
- Fixed #2337: Images don't align correctly (7.0.0 regression)

### 7.0.0 <small>February 22, 2021</small> { id="7.0.0" }

- Added support for deploying multiple versions
- Added support for integrating a language selector
- Added support for rendering admonitions as inline blocks
- Rewrite of the underlying reactive architecture
- Removed Webpack in favor of reactive build strategy (-480 dependencies)
- Fixed keyboard navigation for code blocks after content tabs switch

### 6.2.8 <small>February 4, 2021</small> { id="6.2.8" }

- Updated Japanese and Polish translations
- Fixed #2261: Print dialog auto-closing when using instant loading

### 6.2.7 <small>January 31, 2021</small> { id="6.2.7" }

- Fixed #2251: Updated Docker image to latest Alpine Linux

### 6.2.6 <small>January 26, 2021</small> { id="6.2.6" }

- Added Bulgarian translations
- Fixed #2233: Search not shown when using header autohiding

### 6.2.5 <small>January 17, 2021</small> { id="6.2.5" }

- Fixed syntax error in Swedish translations
- Optimized navigation partials to improve build speed for huge docs

### 6.2.4 <small>January 9, 2021</small> { id="6.2.4" }

- Fixed #2156: Missing syntax highlighting for binary numbers
- Fixed #2186: Disqus showing on 404 page

### 6.2.3 <small>December 27, 2020</small> { id="6.2.3" }

- Added back hidden overflow on root container
- Fixed #2142: MathJax formulas sometimes have vertical scrollbars

### 6.2.2 <small>December 22, 2020</small> { id="6.2.2" }

- Removed Markdown version range limit (6.2.0 regression)

### 6.2.1 <small>December 22, 2020</small> { id="6.2.1" }

- Fixed all import and asset paths in templates (6.2.0 regression)
- Downgraded webpack-asset-manifest-plugin - broke all asset paths

### 6.2.0 <small>December 22, 2020</small> { id="6.2.0" }

- Added support for navigation sections
- Added support for navigation expansion
- Added support for integrating table of contents into navigation
- Added support for autohiding header on scroll
- Added support for hiding navigation and table of contents per page
- Added support for arbitrary items in navigation tabs
- Refactored navigation tabs to simplify grouping behavior
- Fixed anchor offset for permalinks in Safari (partial revert)
- Fixed #2098: Active tab sometimes not highlighted correctly
- Improved appearance for horizontal rulers
- Improved Spanish and Swedish translations

### 6.1.7 <small>December 6, 2020</small> { id="6.1.7" }

- Fixed #2081: Fixed stats for private GitHub repositories
- Fixed alignment for admonition icon alignment for right-to-left languages

### 6.1.6 <small>November 22, 2020</small> { id="6.1.6" }

- Fixed #2048: Math formulas show scrollbars (Windows)

### 6.1.5 <small>November 15, 2020</small> { id="6.1.5" }

- Fixed search reset button not showing/hiding correctly

### 6.1.4 <small>November 7, 2020</small> { id="6.1.4" }

- Fixed sidebar jitter when scrolling footer into view

### 6.1.3 <small>November 5, 2020</small> { id="6.1.3" }

- Added support for keywords `meta` tag
- Fixed #2027: Line numbers don't scale with smaller font size
- Fixed link colors for black and white on `slate` color scheme
- Removed focus outline on scrolling code blocks for pointer devices

### 6.1.2 <small>October 31, 2020</small> { id="6.1.2" }

- Fixed sizing of icons in admonitions, task lists, etc. (6.1.1 regression)

### 6.1.1 <small>October 31, 2020</small> { id="6.1.1" }

- Fixed #2019: Page title not correctly updated when using instant loading

### 6.1.0 <small>October 17, 2020</small> { id="6.1.0" }

- Fixed #1973: Added support for printing in dark mode
- Fixed #1974: Added support for printing content tabs
- Fixed #1995: Improved customizability of details extension

### 6.0.2 <small>October 4, 2020</small> { id="6.0.2" }

- Added Georgian translations
- Added escaping for link `title` attributes where necessary
- Fixed #1956: Pages with whitespace in names have invalid links in search
- Removed unnecessary (duplicated) link `title` attributes

### 6.0.1 <small>September 26, 2020</small> { id="6.0.1" }

- Fixed stemmer support for `file://` protocol through `iframe-worker`
- Fixed details marker showing for search result in Firefox
- Fixed tabbing behavior when search query is not empty
- Switched TypeScript compilation target to ES2015
- Reduced size of JavaScript by 30% (`176kb` → `124kb`)
- Removed `mkdocs` and `readthedocs` themes from Docker image

### 6.0.0 <small>September 25, 2020</small> { id="6.0.0" }

- Improved search result look and feel
- Improved search result stability while typing
- Improved search result grouping (pages + headings)
- Improved search result relevance and scoring
- Added display of missing query terms to search results
- Reduced size of vendor bundle by 25% (`84kb` → `67kb`)
- Reduced size of the Docker image to improve CI build performance
- Removed hero partial in favor of custom implementation
- Removed deprecated front matter features

---

### 5.5.14 <small>September 23, 2020</small> { id="5.5.14" }

- Improved spacing around image captions
- Fixed #1939: Long tables cause header overlap in print view

### 5.5.13 <small>September 19, 2020</small> { id="5.5.13" }

- Improved abbreviations on touch devices

### 5.5.12 <small>August 31, 2020</small> { id="5.5.12" }

- Fixed #1638: occasional `404` for images when using instant loading

### 5.5.11 <small>August 28, 2020</small> { id="5.5.11" }

- Fixed Disqus integration, as the minifier killed the config

### 5.5.10 <small>August 28, 2020</small> { id="5.5.10" }

- Improved rendering by moving Disqus integration after page load
- Fixed #1887: Moved navigation icons to CSS to reduce size of HTML

### 5.5.9 <small>August 26, 2020</small> { id="5.5.9" }

- Added Esperanto translations
- Fixed #1884: External links not included in navigation tabs

### 5.5.8 <small>August 23, 2020</small> { id="5.5.8" }

- Removed focus outline on `details` and content tabs for pointer devices
- Improved accessibility of content tabs (now navigable via arrow keys)
- Fixed #1877: `404` on search index when search is disabled
- Fixed some memleaks in observable subscriptions
- Fixed color definitions for `theme-color` meta tag

### 5.5.7 <small>August 16, 2020</small> { id="5.5.7" }

- Improved contrast ratio to 4.5:1 for syntax highlighting
- Improved contrast ratio to 4.5:1 for table of contents

### 5.5.6 <small>August 12, 2020</small> { id="5.5.6" }

- Switched base template for `404.html` to `main.html`
- Fixed #1864: GitHub organisation stats not loading

### 5.5.5 <small>August 11, 2020</small> { id="5.5.5" }

- Fixed missing vendor and worker distribution files

### 5.5.4 <small>August 11, 2020</small> { id="5.5.4" }

- Added support for sortable data tables

### 5.5.3 <small>August 4, 2020</small> { id="5.5.3" }

- Fixed search for languages other than English (5.5.1 regression)

### 5.5.2 <small>August 3, 2020</small> { id="5.5.2" }

- Improved highlight colors and spacing for `ins`, `del` and `mark`
- Changed some keyboard symbols for better equivalents
- Removed focus `outline` for details and code blocks on touch devices
- Fixed margins for admonitions (5.5.1 regression)
- Fixed too small content tab labels (5.5.1 regression)
- Fixed icon repeating for custom admonition icons

### 5.5.1 <small>August 1, 2020</small> { id="5.5.1" }

- Improved typesetting by basing `font-size` and spacings on `em`
- Improved print view by slightly scaling down `font-size`
- Changed custom site title (metadata) to be suffixed with site name
- Fixed top- and bottom spacing of paragraphs inside table cells

### 5.5.0 <small>July 24, 2020</small> { id="5.5.0" }

- Rewrite of entire documentation
- Rewrite of syntax highlighting to be customizable with CSS variables
- Improved syntax highlighting to work with light and dark theme
- Improved `slate` color scheme to be more customizable and easier on the eyes
- Added licenses of icon sets to distribution files
- Fixed stale document titles in Google Analytics when using instant loading
- Fixed width of previous and next footer links for tablet and above
- Fixed issues with top scroll margin for footnotes
- Fixed top margin for tabbed content when using a JavaScript highlighter
- Deprecated metadata-based redirects, source links and heroes

### 5.4.0 <small>June 29, 2020</small> { id="5.4.0" }

- Added support to wrap searches in quotes to switch from `OR` to `AND`
- Fixed highlighting of numbers in search results

### 5.3.3 <small>June 24, 2020</small> { id="5.3.3" }

- Added Bengali translations
- Fixed #1773: Search for numbers does not return any result (regression)

### 5.3.2 <small>June 21, 2020</small> { id="5.3.2" }

- Improved search typeahead experience with non-Latin characters
- Fixed #1753: Japanese search doesn't work anymore

### 5.3.1 <small>June 20, 2020</small> { id="5.3.1" }

- Fixed #1761: Duplication of search worker when subscribing to observable

### 5.3.0 <small>June 15, 2020</small> { id="5.3.0" }

- Added support for color schemes based on user preference
- Fixed #1755: Tokenizer separator setting ignored

### 5.2.3 <small>June 6, 2020</small> { id="5.2.3" }

- Improved search typeahead behavior for some languages (`de`, `fr`, ...)
- Improved styles for scrollbars on Firefox
- Fixed #1741: Removed `preconnect` hint for Google Analytics

### 5.2.2 <small>May 26, 2020</small> { id="5.2.2" }

- Fixed #1728: Legacy Edge doesn't support `deg` values in `hsla` colors

### 5.2.1 <small>May 22, 2020</small> { id="5.2.1" }

- Fixed color of links in table headers, e.g. footnotes
- Fixed color scheme not being applied without primary or accent color
- Fixed hover delay for links inside code blocks

### 5.2.0 <small>May 18, 2020</small> { id="5.2.0" }

- Added color schemes implementation + dark mode
- Fixed #1583: Missing option for separate link colors

### 5.1.7 <small>May 16, 2020</small> { id="5.1.7" }

- Added keyboard focus support for overflowing code blocks
- Fixed #1696: Infinite loop in some cases when using instant loading

### 5.1.6 <small>May 9, 2020</small> { id="5.1.6" }

- Added Burmese translations
- Added general anchor offset solution using `scroll-margin-top`
- Fixed #1653: Instant loading shouldn't intercept links to `*.html` files

### 5.1.5 <small>May 3, 2020</small> { id="5.1.5" }

- Added `name` attribute for social links to set link `title`
- Fixed #1623: Allow arbitrary links in social links
- Fixed #1664: Height of `iframe` is not adjustable
- Fixed #1667: Sidebars are scrolled to bottom on load (bug in Chrome 81+)

### 5.1.4 <small>April 30, 2020</small> { id="5.1.4" }

- Switched to [@mdi/svg] Material Design icon package
- Fixed #1655: Navigation may disappear after switching viewports
- Fixed #1659: Unnecessary scrollbar for search results on Windows
- Fixed occasional distortions for images with explicit dimensions
- Fixed errors in German translations

  [@mdi/svg]: https://github.com/Templarian/MaterialDesign-SVG

### 5.1.3 <small>April 26, 2020</small> { id="5.1.3" }

- Fixed overflowing content area after switch to flexbox

### 5.1.2 <small>April 26, 2020</small> { id="5.1.2" }

- Added status information to search observable
- Added status information to search modal
- Removed announcement bar from print media
- Removed media query packing logic due to race conditions
- Fixed #1520: Gracefully disable search on `file://` if Worker fails
- Fixed re-submission of query after search is initialized
- Fixed jitter of sidebars on all browsers by switching to `sticky`

### 5.1.1 <small>April 17, 2020</small> { id="5.1.1" }

- Added new FontAwesome icons
- Fixed #1609: Instant loading doesn't honor `target=_blank`
- Fixed GitHub stars count rounding errors
- Fixed GitLab stars count retrieval

### 5.1.0 <small>April 12, 2020</small> { id="5.1.0" }

- Added support for icons from Markdown through [mkdocs-material-extensions]

  [mkdocs-material-extensions]: https://github.com/facelessuser/mkdocs-material-extensions

### 5.0.2 <small>April 10, 2020</small> { id="5.0.2" }

- Added CSS source maps to distribution files
- Fixed errors in Chinese (Traditional) translations
- Fixed creation of stale directory on installation from git
- Improved overflow scrolling behavior on iOS (reduced bundle size by `4kb`)

### 5.0.1 <small>April 7, 2020</small> { id="5.0.1" }

- Fixed syntax error in Spanish translation

### 5.0.0 <small>April 7, 2020</small> { id="5.0.0" }

- Reactive architecture – try `app.dialog$.next("Hi!")` in the console
- Instant loading – make Material behave like a Single Page Application
- Improved CSS customization with CSS variables – set your brand's colors
- Improved CSS resilience, e.g. proper sidebar locking for customized headers
- Improved icon integration and configuration – now including over 5k icons
- Added possibility to use any icon for logo, repository and social links
- Search UI does not freeze anymore (moved to web worker)
- Search index built only once when using instant loading
- Improved extensible keyboard handling
- Support for prebuilt search indexes
- Support for displaying stars and forks for GitLab repositories
- Support for scroll snapping of sidebars and search results
- Reduced HTML and CSS footprint due to deprecation of Internet Explorer support
- Slight facelifting of some UI elements (admonitions, tables, ...)

### 4.6.3 <small>February 14, 2020</small> { id="4.6.3" }

- Removed optional third-party plugins from `requirements.txt`
- Updated Docker image to contain all supported third-party plugins

### 4.6.2 <small>February 8, 2020</small> { id="4.6.2" }

- Added Romanian translations
- Fixed #1451: Inconsistent spacing for fenced code blocks

### 4.6.1 <small>February 8, 2020</small> { id="4.6.1" }

- Fixed #1324: Metadata author only rendering first character
- Fixed #1393: Set `tabindex` to `0` for skip to content link
- Fixed code blocks after Markdown 3.2 release
- Fixed errors in Japanese translations
- Improved Google Lighthouse score

### 4.6.0 <small>December 11, 2019</small> { id="4.6.0" }

- Added support for [git-revision-date-localized-plugin]
- Fixed invalid character in Google Fonts URL

  [git-revision-date-localized-plugin]: https://github.com/timvink/mkdocs-git-revision-date-localized-plugin

### 4.5.1 <small>December 2, 2019</small> { id="4.5.1" }

- Added Thai translations
- Fixed missing assets in GitHub release `.zip` and `.tar.gz`

### 4.5.0 <small>November 16, 2019</small> { id="4.5.0" }

- Fixed #1330: Upgraded EmojiOne to Tweomji due to licensing issues
- Fixed #1339: Temporarily pinned PyMdown and Markdown due to
- Fixed errors in Greek translations
- Improved GitHub statistics retrieval

### 4.4.3 <small>October 3, 2019</small> { id="4.4.3" }

- Added Estonian translations
- Fixed removal of copyright banners in minified JavaScript
- Removed unnecessary title attributes from links in table of contents

### 4.4.2 <small>August 27, 2019</small> { id="4.4.2" }

- Added Afrikaans translations
- Fixed broken page title when `h1` contained HTML tags
- Improved accessibility for IE users
- Removed unnecessary `title` attributes from links in navigation

### 4.4.1 <small>August 22, 2019</small> { id="4.4.1" }

- Added support for `black` as a primary color
- Fixed broken footer bar when `h1` contained HTML tags

### 4.4.0 <small>June 15, 2019</small> { id="4.4.0" }

- Added Slovenian translations
- Reverted template minification in favor of `mkdocs-minify-plugin`
- Fixed #1114: Tabs don't reappear when default `font-size` is smaller than `16`

### 4.3.1 <small>May 23, 2019</small> { id="4.3.1" }

- Fixed spelling error in Danish translations

### 4.3.0 <small>May 17, 2019</small> { id="4.3.0" }

- Added support for changing header through metadata title property
- Added `font-display: swap` to Google Font loading logic
- Removed whitespace from templates, saving `4kb` (`.7kb` gzipped) per request
- Fixed alignment of repository icons on tablet and desktop

### 4.2.0 <small>April 28, 2019</small> { id="4.2.0" }

- Added Norwegian (Nynorsk) translations
- Fixed loss of focus in non-form input elements due to search hotkeys
- Fixed #1067: Search hotkeys not working for mobile/tablet screensize
- Fixed #1068: Search not correctly aligned for tablet screensize

### 4.1.2 <small>April 16, 2019</small> { id="4.1.2" }

- Fixed #1072: HTML tags appearing in navigation link titles

### 4.1.1 <small>March 28, 2019</small> { id="4.1.1" }

- Fixed minor CSS errors detected during validation

### 4.1.0 <small>March 22, 2019</small> { id="4.1.0" }

- Fixed #1023: Search for Asian languages broken after Lunr.js update
- Fixed #1026: contenteditable elements loose focus on hotkeys

### 4.0.2 <small>March 1, 2019</small> { id="4.0.2" }

- Fixed #1012: HTML character entities appear in search result titles

### 4.0.1 <small>February 13, 2019</small> { id="4.0.1" }

- Fixed #762, #816: Glitch in sidebar when collapsing items
- Fixed #869: Automatically expand details before printing

### 4.0.0 <small>February 13, 2019</small> { id="4.0.0" }

- Added background on hover for table rows
- Removed Google Tag Manager and reverted to Google Analytics
- Removed blocks in partials - Jinja doesn't support them
- Fixed #911: Chrome breaks layout if system language is Chinese (**BREAKING**)
- Fixed #976: Removed FastClick

---

### 3.3.0 <small>January 29, 2019</small> { id="3.3.0" }

- Moved Google Analytics integration into `head` using Google Tag Manager
- Fixed #972: Unicode slugifier breaks table of contents blur on scroll
- Fixed #974: Additional links in table of contents break blur on scroll

### 3.2.0 <small>December 28, 2018</small> { id="3.2.0" }

- Added support for redirects using metadata refresh
- Fixed #921: Load Google Analytics snippet asynchronously

### 3.1.0 <small>November 17, 2018</small> { id="3.1.0" }

- Added support for Progressive Web App Manifest
- Fixed #915: Search bug in Safari (upgraded Lunr.js)

### 3.0.6 <small>October 26, 2018</small> { id="3.0.6" }

- Added Taiwanese translations
- Fixed #906: JavaScript code blocks evaluated in search results

### 3.0.5 <small>October 23, 2018</small> { id="3.0.5" }

- Added Croatian and Indonesian translations
- Fixed #899: Skip-to-content link invalid from 2nd level on
- Fixed #902: Missing URL filter in footer for FontAwesome link

### 3.0.4 <small>September 3, 2018</small> { id="3.0.4" }

- Updated Dutch translations
- Fixed #856: Removed preconnect meta tag if Google Fonts are disabled

### 3.0.3 <small>August 7, 2018</small> { id="3.0.3" }

- Fixed #841: Additional path levels for extra CSS and JS

### 3.0.2 <small>August 6, 2018</small> { id="3.0.2" }

- Fixed #839: Lunr.js stemmer imports incorrect

### 3.0.1 <small>August 5, 2018</small> { id="3.0.1" }

- Fixed #838: Search result links incorrect

### 3.0.0 <small>August 5, 2018</small> { id="3.0.0" }

- Upgraded MkDocs to 1.0 (**BREAKING**)
- Upgraded Python in official Docker image to 3.6
- Added Serbian and Serbo-Croatian translations

---

### 2.9.4 <small>July 29, 2018</small> { id="2.9.4" }

- Fixed build error after MkDocs upgrade

### 2.9.3 <small>July 29, 2018</small> { id="2.9.3" }

- Added link to home for logo in drawer
- Fixed dependency problems between MkDocs and Tornado

### 2.9.2 <small>June 29, 2018</small> { id="2.9.2" }

- Added Hindi and Czech translations

### 2.9.1 <small>June 18, 2018</small> { id="2.9.1" }

- Added support for different spellings for theme color
- Fixed #799: Added support for webfont minification in production
- Fixed #800: Added `.highlighttable` as an alias for `.codehilitetable`

### 2.9.0 <small>June 13, 2018</small> { id="2.9.0" }

- Added support for theme color on Android
- Fixed #796: Rendering of nested tabbed code blocks

### 2.8.0 <small>June 10, 2018</small> { id="2.8.0" }

- Added support for grouping code blocks with tabs
- Added Material and FontAwesome icon fonts to distribution files (GDPR)
- Added note on compliance with GDPR
- Added Slovak translations
- Fixed #790: Prefixed `id` attributes with `__` to avoid name clashes

### 2.7.3 <small>April 26, 2018</small> { id="2.7.3" }

- Added Finnish translations

### 2.7.2 <small>April 9, 2018</small> { id="2.7.2" }

- Fixed rendering issue for `details` on Edge

### 2.7.1 <small>March 21, 2018</small> { id="2.7.1" }

- Added Galician translations
- Fixed #730: Scroll chasing error on home page if Disqus is enabled
- Fixed #736: Reset drawer and search upon back button invocation

### 2.7.0 <small>March 6, 2018</small> { id="2.7.0" }

- Added ability to set absolute URL for logo
- Added Hebrew translations

### 2.6.6 <small>February 22, 2018</small> { id="2.6.6" }

- Added preconnect for Google Fonts for faster loading
- Fixed #710: With tabs sidebar disappears if JavaScript is not available

### 2.6.5 <small>February 22, 2018</small> { id="2.6.5" }

- Reverted `--dev-addr` flag removal from `Dockerfile`

### 2.6.4 <small>February 21, 2018</small> { id="2.6.4" }

- Added Catalan translations
- Fixed incorrect margins for buttons in Firefox and Safari
- Replaced package manager `yarn` with `npm 5.6`
- Reverted GitHub stars rounding method
- Removed `--dev-addr` flag from `Dockerfile` for Windows compatibility

### 2.6.3 <small>February 18, 2018</small> { id="2.6.3" }

- Added Vietnamese translations

### 2.6.2 <small>February 12, 2018</small> { id="2.6.2" }

- Added Arabic translations
- Fixed incorrect rounding of amount of GitHub stars
- Fixed double-layered borders for tables

### 2.6.1 <small>February 11, 2018</small> { id="2.6.1" }

- Added ability to override Disqus integration using metadata
- Fixed #690: Duplicate slashes in source file URLs
- Fixed #696: Active page highlight not working with default palette
- Adjusted German translations

### 2.6.0 <small>February 2, 2018</small> { id="2.6.0" }

- Moved default search configuration to default translation (English)
- Added support to automatically set text direction from translation
- Added support to disable search stop word filter in translation
- Added support to disable search trimmer in translation
- Added Persian translations
- Fixed support for Polish search
- Fixed disappearing GitHub, GitLab and Bitbucket repository icons

### 2.5.5 <small>January 31, 2018</small> { id="2.5.5" }

- Added Hungarian translations

### 2.5.4 <small>January 29, 2018</small> { id="2.5.4" }

- Fixed #683: `gh-deploy` fails inside Docker

### 2.5.3 <small>January 25, 2018</small> { id="2.5.3" }

- Added Ukrainian translations

### 2.5.2 <small>January 22, 2018</small> { id="2.5.2" }

- Added default search language mappings for all localizations
- Fixed #673: Error loading non-existent search language
- Fixed #675: Uncaught reference error when search plugin disabled

### 2.5.1 <small>January 20, 2018</small> { id="2.5.1" }

- Fixed permalink for main headline
- Improved missing translation handling with English as a fallback
- Improved accessibility with skip-to-content link

### 2.5.0 <small>January 13, 2018</small> { id="2.5.0" }

- Added support for right-to-left languages

### 2.4.0 <small>January 11, 2018</small> { id="2.4.0" }

- Added focus state for clipboard buttons
- Fixed #400: Search bar steals tab focus
- Fixed search not closing on ++enter++ when result is selected
- Fixed search not closing when losing focus due to ++tab++
- Fixed collapsed navigation links getting focus
- Fixed `outline` being cut off on ++tab++ focus of navigation links
- Fixed bug with first search result navigation being ignored
- Removed search result navigation via ++tab++ (use ++up++ and ++down++)
- Removed `outline` resets for links
- Improved general tabbing behavior on desktop

### 2.3.0 <small>January 9, 2018</small> { id="2.3.0" }

- Added `example` (synonym: `snippet`) style for admonitions
- Added synonym `abstract` for `summary` style for admonitions

### 2.2.6 <small>December 27, 2017</small> { id="2.2.6" }

- Added Turkish translations
- Fixed unclickable area below header in case JavaScript is not available

### 2.2.5 <small>December 18, 2017</small> { id="2.2.5" }

- Fixed #639: Broken default favicon

### 2.2.4 <small>December 18, 2017</small> { id="2.2.4" }

- Fixed #638: Build breaks with Jinja < 2.9

### 2.2.3 <small>December 13, 2017</small> { id="2.2.3" }

- Fixed #630: Admonition sets padding on any last child
- Adjusted Chinese (Traditional) translations

### 2.2.2 <small>December 8, 2017</small> { id="2.2.2" }

- Added Dutch translations
- Adjusted targeted link and footnote offsets
- Simplified admonition styles and fixed padding bug

### 2.2.1 <small>December 2, 2017</small> { id="2.2.1" }

- Fixed #616: Minor styling error with title-only admonitions
- Removed border for table of contents and improved spacing

### 2.2.0 <small>November 22, 2017</small> { id="2.2.0" }

- Added support for hero teaser
- Added Portuguese translations
- Fixed #586: Footnote backref target offset regression
- Fixed #605: Search stemmers not correctly loaded

### 2.1.1 <small>November 21, 2017</small> { id="2.1.1" }

- Replaced deprecated `babel-preset-es2015` with `babel-preset-env`
- Refactored Gulp build pipeline with Webpack
- Removed right border on sidebars
- Fixed broken color transition on header

### 2.1.0 <small>November 19, 2017</small> { id="2.1.0" }

- Added support for `white` as a primary color
- Added support for sliding site name and title
- Fixed redundant clipboard button when using line numbers on code blocks
- Improved header appearance by making it taller
- Improved tabs appearance
- Improved CSS customizability by leveraging inheritance
- Removed scroll shadows via `background-attachment`

### 2.0.4 <small>November 5, 2017</small> { id="2.0.4" }

- Fixed `details` not opening with footnote reference

### 2.0.3 <small>November 5, 2017</small> { id="2.0.3" }

- Added Japanese translations
- Fixed #540: Jumping to anchor inside `details` doesn't open it
- Fixed active link colors in footer

### 2.0.2 <small>November 1, 2017</small> { id="2.0.2" }

- Added Russian translations
- Fixed #542: Horizontal scrollbar between `1220px` and `1234px`
- Fixed #553: Metadata values only rendering first character
- Fixed #558: Flash of unstyled content
- Fixed favicon regression caused by deprecation upstream

### 2.0.1 <small>October 31, 2017</small> { id="2.0.1" }

- Fixed error when initializing search
- Fixed styles for link to edit the current page
- Fixed styles on nested admonition in details

### 2.0.0 <small>October 31, 2017</small> { id="2.0.0" }

- Upgraded MkDocs to 0.17.1 (__BREAKING__)
- Added support for easier configuration of search tokenizer
- Added support to disable search
- Added Korean translations

---

### 1.12.2 <small>October 26, 2017</small> { id="1.12.2" }

- Added Italian, Norwegian, French and Chinese translations

### 1.12.1 <small>October 22, 2017</small> { id="1.12.1" }

- Added Polish, Swedish and Spanish translations
- Improved downward compatibility with custom partials
- Temporarily pinned MkDocs version within Docker image to 0.16.3
- Fixed #519: Missing theme configuration file

### 1.12.0 <small>October 20, 2017</small> { id="1.12.0" }

- Added support for setting language(s) via `mkdocs.yml`
- Added support for default localization
- Added German and Danish translations
- Fixed #374: Search bar misalignment on big screens

### 1.11.0 <small>October 19, 2017</small> { id="1.11.0" }

- Added localization to clipboard
- Refactored localization logic

### 1.10.4 <small>October 18, 2017</small> { id="1.10.4" }

- Improved print styles of code blocks
- Improved search UX (don't close on enter if no selection)
- Fixed #495: Vertical scrollbar on short pages

### 1.10.3 <small>October 11, 2017</small> { id="1.10.3" }

- Fixed #484: Vertical scrollbar on some MathJax formulas
- Fixed #483: Footnote backref target offset regression

### 1.10.2 <small>October 6, 2017</small> { id="1.10.2" }

- Fixed #468: Sidebar shows scrollbar if content is shorter (in Safari)

### 1.10.1 <small>September 14, 2017</small> { id="1.10.1" }

- Fixed #455: Bold code blocks rendered with normal font weight

### 1.10.0 <small>September 1, 2017</small> { id="1.10.0" }

- Added support to make logo default icon configurable
- Fixed uninitialized overflow scrolling on main pane for iOS
- Fixed error in mobile navigation in case JavaScript is not available
- Fixed incorrect color transition for nested panes in mobile navigation
- Improved checkbox styles for Tasklist from PyMdown Extension package

### 1.9.0 <small>August 29, 2017</small> { id="1.9.0" }

- Added `info` (synonym: `todo`) style for admonitions
- Added `question` (synonym: `help`, `faq`) style for admonitions
- Added support for Details from PyMdown Extensions package
- Improved admonition styles to match details
- Improved styles for social links in footer
- Replaced ligatures with Unicode code points to avoid broken layout
- Upgraded PyMdown Extensions package dependency to >= 3.4

### 1.8.1 <small>August 7, 2017</small> { id="1.8.1" }

- Fixed #421: Missing pagination for GitHub API

### 1.8.0 <small>August 2, 2017</small> { id="1.8.0" }

- Added support for lazy-loading of search results for better performance
- Added support for customization of search tokenizer/separator
- Fixed #424: Search doesn't handle capital letters anymore
- Fixed #419: Search doesn't work on whole words

### 1.7.5 <small>July 25, 2017</small> { id="1.7.5" }

- Fixed #398: Forms broken due to search shortcuts
- Improved search overall user experience
- Improved search matching and highlighting
- Improved search accessibility

### 1.7.4 <small>June 21, 2017</small> { id="1.7.4" }

- Fixed functional link colors in table of contents for active palette
- Fixed #368: Compatibility issues with IE11

### 1.7.3 <small>June 7, 2017</small> { id="1.7.3" }

- Fixed error when setting language to Japanese for site search

### 1.7.2 <small>June 6, 2017</small> { id="1.7.2" }

- Fixed offset of search box when `repo_url` is not set
- Fixed non-disappearing tooltip

### 1.7.1 <small>June 1, 2017</small> { id="1.7.1" }

- Fixed wrong `z-index` order of header, overlay and drawer
- Fixed wrong offset of targeted footnote back references

### 1.7.0 <small>June 1, 2017</small> { id="1.7.0" }

- Added "copy to clipboard" buttons to code blocks
- Added support for multilingual site search
- Fixed search term highlighting for non-latin languages

### 1.6.4 <small>May 24, 2017</small> { id="1.6.4" }

- Fixed #337: JavaScript error for GitHub organization URLs

### 1.6.3 <small>May 16, 2017</small> { id="1.6.3" }

- Fixed #329: Broken source stats for private or unknown GitHub repos

### 1.6.2 <small>May 15, 2017</small> { id="1.6.2" }

- Fixed #316: Fatal error for git clone on Windows
- Fixed #320: Chrome 58 creates double underline for `abbr` tags
- Fixed #323: Ligatures rendered inside code blocks
- Fixed miscalculated sidebar height due to missing margin collapse
- Changed deprecated MathJax CDN to Cloudflare

### 1.6.1 <small>April 23, 2017</small> { id="1.6.1" }

- Fixed following of active/focused element if search input is focused
- Fixed layer order of search component elements

### 1.6.0 <small>April 22, 2017</small> { id="1.6.0" }

- Added build test for Docker image on Travis
- Added search overlay for better user experience (focus)
- Added language from localizations to `html` tag
- Fixed #270: source links broken for absolute URLs
- Fixed missing top spacing for first targeted element in content
- Fixed too small footnote divider when using larger font sizes

### 1.5.5 <small>April 20, 2017</small> { id="1.5.5" }

- Fixed #282: Browser search (<kbd>Meta</kbd>+<kbd>F</kbd>) is hijacked

### 1.5.4 <small>April 8, 2017</small> { id="1.5.4" }

- Fixed broken highlighting for two or more search terms
- Fixed missing search results when only a `h1` is present
- Fixed unresponsive overlay on Android

### 1.5.3 <small>April 7, 2017</small> { id="1.5.3" }

- Fixed deprecated calls for template variables
- Fixed wrong palette color for focused search result
- Fixed JavaScript errors on 404 page
- Fixed missing top spacing on 404 page
- Fixed missing right spacing on overflow of source container

### 1.5.2 <small>April 5, 2017</small> { id="1.5.2" }

- Added requirements as explicit dependencies in `setup.py`
- Fixed non-synchronized transitions in search form

### 1.5.1 <small>March 30, 2017</small> { id="1.5.1" }

- Fixed rendering and offset of targeted footnotes
- Fixed #238: Link on logo is not set to `site_url`

### 1.5.0 <small>March 24, 2017</small> { id="1.5.0" }

- Added support for localization of search placeholder
- Added keyboard events for quick access of search
- Added keyboard events for search control
- Added opacity on hover for search buttons
- Added git hook to skip CI build on non-src changes
- Fixed non-resetting search placeholder when input is cleared
- Fixed error for unescaped parentheses in search term
- Fixed #229: Button to clear search missing
- Fixed #231: Escape key doesn't exit search
- Removed old-style figures from font feature settings

### 1.4.1 <small>March 16, 2017</small> { id="1.4.1" }

- Fixed invalid destructuring attempt on NodeList (in Safari, Edge, IE)

### 1.4.0 <small>March 16, 2017</small> { id="1.4.0" }

- Added support for grouping searched sections by documents
- Added support for highlighting of search terms
- Added support for localization of search results
- Fixed #216: table of contents icon doesn't show if `h1` is not present
- Reworked style and layout of search results for better usability

### 1.3.0 <small>March 11, 2017</small> { id="1.3.0" }

- Added support for page-specific title and description using metadata
- Added support for linking source files to documentation
- Fixed jitter and offset of sidebar when zooming browser
- Fixed incorrectly initialized tablet sidebar height
- Fixed regression for #1: GitHub stars break if `repo_url` ends with a `/`
- Fixed undesired white line below copyright footer due to base font scaling
- Fixed issue with whitespace in path for scripts
- Fixed #205: support non-fixed (static) header
- Refactored footnote references for better visibility
- Reduced repaints to a minimum for non-tabs configuration
- Reduced contrast of edit button (slightly)

### 1.2.0 <small>March 3, 2017</small> { id="1.2.0" }

- Added `quote` (synonym: `cite`) style for admonitions
- Added help message to build pipeline
- Fixed wrong navigation link colors when applying palette
- Fixed #197: Link missing in tabs navigation on deeply nested items
- Removed unnecessary dev dependencies

### 1.1.1 <small>February 26, 2017</small> { id="1.1.1" }

- Fixed incorrectly displayed nested lists when using tabs

### 1.1.0 <small>February 26, 2017</small> { id="1.1.0" }

- Added tabs navigation feature (optional)
- Added Disqus integration (optional)
- Added a high resolution Favicon with the new logo
- Added static type checking using Facebook's Flow
- Fixed #173: Dictionary elements have no bottom spacing
- Fixed #175: Tables cannot be set to 100% width
- Fixed race conditions in build related to asset revisioning
- Fixed accidentally re-introduced Permalink on top-level headline
- Fixed alignment of logo in drawer on IE11
- Refactored styles related to tables
- Refactored and automated Docker build and PyPI release
- Refactored build scripts

### 1.0.5 <small>February 18, 2017</small> { id="1.0.5" }

- Fixed #153: Sidebar flows out of constrained area in Chrome 56
- Fixed #159: Footer jitter due to JavaScript if content is short

### 1.0.4 <small>February 16, 2017</small> { id="1.0.4" }

- Fixed #142: Documentation build errors if `h1` is defined as raw HTML
- Fixed #164: PyPI release does not build and install
- Fixed offsets of targeted headlines
- Increased sidebar font size by `0.12rem`

### 1.0.3 <small>January 22, 2017</small> { id="1.0.3" }

- Fixed #117: Table of contents items don't blur on fast scrolling
- Refactored sidebar positioning logic
- Further reduction of repaints

### 1.0.2 <small>January 15, 2017</small> { id="1.0.2" }

- Fixed #108: Horizontal scrollbar in content area

### 1.0.1 <small>January 14, 2017</small> { id="1.0.1" }

- Fixed massive repaints happening when scrolling
- Fixed footer back reference positions in case of overflow
- Fixed header logo from showing when the menu icon is rendered
- Changed scrollbar behavior to only show when content overflows

### 1.0.0 <small>January 13, 2017</small> { id="1.0.0" }

- Introduced Webpack for more sophisticated JavaScript bundling
- Introduced ESLint and Stylelint for code style checks
- Introduced more accurate Material Design colors and shadows
- Introduced modular scales for harmonic font sizing
- Introduced git-hooks for better development workflow
- Rewrite of CSS using the BEM methodology and SassDoc guidelines
- Rewrite of JavaScript using ES6 and Babel as a transpiler
- Rewrite of Admonition, Permalinks and CodeHilite integration
- Rewrite of the complete typographical system
- Rewrite of Gulp asset pipeline in ES6 and separation of tasks
- Removed Bower as a dependency in favor of NPM
- Removed custom icon build in favor of the Material Design icon set
- Removed `_blank` targets on links due to vulnerability: http://bit.ly/1Mk2Rtw
- Removed unversioned assets from build directory
- Restructured templates into base templates and partials
- Added build and watch scripts in `package.json`
- Added support for Metadata and Footnotes Markdown extensions
- Added support for PyMdown Extensions package
- Added support for collapsible sections in navigation
- Added support for separate table of contents
- Added support for better accessibility through REM-based layout
- Added icons for GitHub, GitLab and BitBucket integrations
- Added more detailed documentation on specimen, extensions etc.
- Added a `404.html` error page for deployment on GitHub Pages
- Fixed live reload chain in watch mode when saving a template
- Fixed variable references to work with MkDocs 0.16

---

### 0.2.4 <small>June 26, 2016</small> { id="0.2.4" }

- Fixed improperly set default favicon
- Fixed #33: Protocol relative URL for webfonts doesn't work with `file://`
- Fixed #34: IE11 on Windows 7 doesn't honor `max-width` on `main` tag
- Fixed #35: Add styling for blockquotes

### 0.2.3 <small>May 16, 2016</small> { id="0.2.3" }

- Fixed #25: Highlight inline fenced blocks
- Fixed #26: Better highlighting for keystrokes
- Fixed #30: Suboptimal syntax highlighting for PHP

### 0.2.2 <small>March 20, 2016</small> { id="0.2.2" }

- Fixed #15: Document Pygments dependency for CodeHilite
- Fixed #16: Favicon could not be set through `mkdocs.yml`
- Fixed #17: Put version into own container for styling
- Fixed #20: Fix rounded borders for tables

### 0.2.1 <small>March 12, 2016</small> { id="0.2.1" }

- Fixed #10: Invisible header after closing search bar with <kbd>ESC</kbd> key
- Fixed #13: Table cells don't wrap
- Fixed empty list in table of contents when no headline is defined
- Corrected wrong path for static asset monitoring in Gulpfile.js
- Set up tracking of site search for Google Analytics

### 0.2.0 <small>February 24, 2016</small> { id="0.2.0" }

- Fixed #6: Include multiple color palettes via `mkdocs.yml`
- Fixed #7: Better colors for links inside admonition notes and warnings
- Fixed #9: Text for prev/next footer navigation should be customizable
- Refactored templates (replaced `if`/`else` with modifiers where possible)

### 0.1.3 <small>February 21, 2016</small> { id="0.1.3" }

- Fixed #3: Ordered lists within an unordered list have `::before` content
- Fixed #4: Click on Logo/Title without Github-Repository: `"None"`
- Fixed #5: Page without headlines renders empty list in table of contents
- Moved Modernizr to top to ensure basic usability in IE8

### 0.1.2 <small>February 16, 2016</small> { id="0.1.2" }

- Fixed styles for deep navigational hierarchies
- Fixed webfont delivery problem when hosted in subdirectories
- Fixed print styles in mobile/tablet configuration
- Added option to configure fonts in `mkdocs.yml` with fallbacks
- Changed styles for admonition notes and warnings
- Set download link to latest version if available
- Set up tracking of outgoing links and actions for Google Analytics

### 0.1.1 <small>February 11, 2016</small> { id="0.1.1" }

- Fixed #1: GitHub stars don't work if the repo_url ends with a `/`
- Updated NPM and Bower dependencies to most recent versions
- Changed footer/copyright link to Material theme to GitHub pages
- Made MkDocs building/serving in build process optional
- Set up continuous integration with Travis

### 0.1.0 <small>February 9, 2016</small> { id="0.1.0" }

- Initial release