diff --git a/changelog/index.html b/changelog/index.html index b9076ed1d2d..170458f4ed8 100644 --- a/changelog/index.html +++ b/changelog/index.html @@ -1,4 +1,4 @@ - Changelog - Material for MkDocs
Skip to content

Changelog

Material for MkDocs

9.3.2 September 19, 2023

  • Updated Slovenian translations
  • Updated Python dependencies in requirements to use minimum versions
  • Fixed #6017: Code highlighting inconsistent in Community and Insiders edition
  • Fixed #6001: Contributor avatars display incorrectly in Firefox
  • Fixed #6000: Blog post drafts are included in navigation

9.3.1 September 11, 2023

  • Fixed crash of group plugin when used together with hooks

9.3.0 September 11, 2023

  • Improved configuration sharing between Community and Insiders edition
  • Added experimental built-in group plugin for enabling plugins conditionally
  • Added new settings in tags plugin for enabling/disabling
  • Dropped support for Python 3.7 (EOL)

9.2.8 September 4, 2023

  • Updated Italian and Russian translations
  • Fixed #5952: Combining blog and tags plugin leads to wrong links
  • Fixed #5951: Blog plugin ignores post title in metadata
  • Fixed #5949: Blog plugin ignores post linked in nav

9.2.7 September 2, 2023

  • Switched dependencies to compatible release clauses
  • Removed readtime and lxml dependencies for blog plugin
  • Reduced size of Docker image to improve CI build performance
  • Fixed #5945: Incorrect footer navigation for sibling pages of blog
  • Fixed #5939: Page jumps when changing color palette (Firefox 117)
  • Fixed #5901: Announcement bar reappears when using instant loading
  • Fixed #5824: Allow to customize styles of sequence diagrams

9.2.6 August 31, 2023

  • Added Basque translations
  • Added template for simple redirects
  • Improved blog plugin interop by moving view generation to on_files
  • Fixed #5924: Social plugin still checks dependencies when disabled
  • Fixed #5916: Blog plugin crashes on Python 3.8 (9.2.0 regression)

9.2.5 August 27, 2023

  • Fixed error in dirty serve mode when using blog plugin
  • Fixed page title not being consistent in blog plugin pagination
  • Fixed #5899: Blog plugin pagination breaks when disabling directory URLs

9.2.4 August 26, 2023

  • Added version to bug report name in info plugin
  • Updated Afrikaans translations

9.2.3 August 22, 2023

  • Fixed blog plugin rendering wrongly with markdown.extensions.toc
  • Fixed blog plugin entrypoint generation

9.2.2 August 22, 2023

  • Fixed #5880: Blog plugin failing when building a standalone blog
  • Fixed #5881: Blog plugin not compatible with Python < 3.10

9.2.1 August 21, 2023

  • Fixed #5879: Blog plugin failing when building a standalone blog
  • Fixed error in blog plugin when using draft tagging on future date
  • Fixed error in blog plugin when toc extension is not enabled

9.2.0 August 21, 2023

Additions and improvements

  • Added blogging support via built-in blog plugin
  • Added support for Chinese language segmentaiton in search plugin
  • Added support for adding custom dates to blog posts
  • Added support for paginating archive and category pages
  • Added support for annotations (outside of code blocks)
  • Added support for navigation icons
  • Added support for navigation pruning
  • Added support for navigation status
  • Added support for customizing site icons
  • Added support for customizing (code) annotation icons
  • Added focus outline to admonitions and details
  • Added prompt for bug report name to info plugin
  • Added Luxembourgish translations
  • Improved rendering of (code) annotation markers
  • Improved print styles for (code) annotations
  • Improved customizability of navigation tabs
  • Improved interop of plugins with external tools like mike
  • Improved interop of blog plugin with awesome pages plugin
  • Improved header partial by moving buttons into separate partials
  • Improved clarity of site_url warning in social plugin
  • Improved blog plugin to automatically setup directory structure
  • Switched info plugin to importlib to mitigate deprecations
  • Automatically download ResizeObserver polyfill when necessary
  • Automatically add iframe-worker polyfill when necessary in offline plugin
  • Automatically focus and bring up keyboard on touch devices
  • Updated Serbo-Croatian translations
  • Updated MkDocs to 1.5.2

Removals

  • Removed Universal Analytics integration
  • Removed ancient polyfills to reduce size of bundled JavaScript by 20%
  • Removed necessity for Array.flat and Array.flatMap polyfill
  • Removed announcement bar button when JavaScript is not available

Fixes

  • Fixed rendering of tags when announcement bar is present
  • Fixed tags plugin rendering pages excluded by other plugins
  • Fixed #5132: Blog plugin requires nav entry in mkdocs.yml
  • Fixed #5599: Insufficient contrast for default link color
  • Fixed #5715: Blog plugin missing integrated table of contents in pagination
  • Fixed #5806: Version selector not hoverable on some Android devices
  • Fixed #5826: Blog post drafts with tags show up in tags index

9.1.21 July 27, 2023

  • Fixed MkDocs 1.4 compat issue in social plugin (9.1.20 regression)

9.1.20 July 27, 2023

  • Updated Sanskrit translations
  • Fixed deprecation warnings for social plugin

9.1.19 July 18, 2023

  • Added support for MkDocs 1.5+
  • Fixed #5699: Improve error reporting in social plugin

9.1.18 July 3, 2023

  • Updated Danish translations
  • Added support for installing user requirements in Docker image
  • Fixed #5655: Search separator with lookbehind breaks highlighting

9.1.17 June 23, 2023

  • Fixed #5633: Code annotations with nested lists incorrectly mounted
  • Fixed #5628: Regression in new social plugin configuration scheme

9.1.16 June 15, 2023

  • Updated Indonesian translations
  • Ensure scroll bar follows color scheme of operating system

9.1.15 May 29, 2023

  • Fixed #5566: Indicate color scheme to operating system
  • Fixed #5565: Update Dockerfile to latest version of base image
  • Fixed #5554: Add additional version tags (9, 9.1) to Docker image
  • Fixed #5536: Strip tags of ARIA labels in table of contents

9.1.14 May 20, 2023

  • Updated Armenian and Greek translations

9.1.13 May 16, 2023

  • Fixed #5517: Social plugin crashes for some fonts (e.g. Open Sans)

9.1.12 May 12, 2023

  • Updated Bengali (Bangla) translations
  • Fixed #5503: Docker image publish errors on uppercase characters
  • Fixed #5407: Auto-pause media when in hidden content tabs

9.1.11 May 8, 2023

  • Fixed #5487: Social plugin crashes without options (9.1.10 regression)

9.1.10 May 8, 2023

  • Added cards_layout_options setting for social cards
  • Deprecated cards_color and cards_font setting for social cards

9.1.9 May 2, 2023

  • Added Telugu, Kannada and Sanskrit translations
  • Fixed #5428: Fixed margins for light/dark mode images in figures
  • Fixed #5420: Social plugin crashing for some specific Google Fonts
  • Fixed #5160: Instant loading makes code annotations jump (9.1.1 regression)
  • Fixed #4920: Social plugin not loading logo from custom icon set
  • Fixed social plugin crashing when only code font is specified

9.1.8 April 24, 2023

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

9.1.7 April 22, 2023

  • 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 April 7, 2023

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

9.1.5 March 31, 2023

  • 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 March 24, 2023

  • 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 March 14, 2023

  • 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 March 9, 2023

  • 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 March 5, 2023

  • 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 March 2, 2023

  • 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 February 26, 2023

  • Updated Chinese (Traditional) translations
  • Updated Hebrew translations

9.0.14 February 23, 2023

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

9.0.13 February 18, 2023

  • 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 February 9, 2023

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

9.0.11 February 3, 2023

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

9.0.10 February 2, 2023

  • 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 January 30, 2023

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

9.0.8 January 29, 2023

  • 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 January 28, 2023

  • 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 January 19, 2023

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

9.0.5 January 14, 2023

  • Fixed #4842: Improved accessibility of search result list

9.0.4 January 12, 2023

  • 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 January 8, 2023

  • 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 January 4, 2023

  • 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 January 3, 2023

  • 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 January 2, 2023

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 November 30, 2022

8.5.10 November 11, 2022

  • 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 November 8, 2022

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

8.5.8 November 3, 2022

  • 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 October 22, 2022

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

8.5.6 October 2, 2022

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

8.5.5 October 1, 2022

  • 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 September 30, 2022

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

8.5.3 September 20, 2022

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

8.5.2 September 18, 2022

  • 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 September 15, 2022

  • Fixed #4366: Removed dependencies with native extensions

8.5.0 September 13, 2022

  • 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 September 12, 2022

  • Moved comments integration to separate partial (comments.html)

8.4.3 September 7, 2022

  • 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 August 27, 2022

  • 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 August 21, 2022

  • Updated Croatian and Hebrew translations

8.4.0 August 13, 2022

  • 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 July 4, 2022

  • 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 June 24, 2022

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

8.3.7 June 22, 2022

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

8.3.6 June 16, 2022

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

8.3.5 June 14, 2022

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

8.3.4 June 11, 2022

  • Fixed #4004: Tags with multiple words not searchable

8.3.3 June 7, 2022

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

8.3.2 June 5, 2022

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

8.3.1 June 4, 2022

  • 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 June 2, 2022

  • 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 May 28, 2022

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

8.2.15 May 14, 2022

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

8.2.14 May 8, 2022

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

8.2.13 May 2, 2022

  • 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 April 30, 2022

  • 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 April 25, 2022

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

8.2.10 April 24, 2022

  • 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 April 8, 2022

  • 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 March 27, 2022

  • 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 March 24, 2022

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

8.2.6 March 23, 2022

  • 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 March 6, 2022

  • 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 March 2, 2022

  • 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 February 27, 2022

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

8.2.2 February 26, 2022

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

8.2.1 February 17, 2022

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

8.2.0 February 17, 2022

  • 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 February 10, 2022

8.1.10 February 6, 2022

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

8.1.9 January 30, 2022

8.1.8 January 23, 2022

  • 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 January 16, 2022

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

8.1.6 January 11, 2022

  • 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 January 9, 2022

  • 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 January 2, 2022

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

8.1.3 December 19, 2021

  • 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 December 15, 2021

  • 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 December 13, 2021

  • 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 December 10, 2021

  • 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 December 6, 2021

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

8.0.4 December 4, 2021

  • 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 December 2, 2021

  • 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 November 30, 2021

  • Fixed #3275: Code annotations always disappear on click

8.0.1 November 28, 2021

  • 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 November 28, 2021

  • 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 October 30, 2021

  • Added support for adding titles to code blocks

7.3.5 October 27, 2021

  • 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 October 17, 2021

  • 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

7.3.3 October 11, 2021

  • 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 October 6, 2021

  • 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 October 2, 2021

  • 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 September 23, 2021

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

7.2.8 September 20, 2021

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

7.2.7 September 19, 2021

  • 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 September 1, 2021

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

7.2.5 August 25, 2021

  • 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 August 11, 2021

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

7.2.3 August 9, 2021

  • 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 July 31, 2021

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

7.2.1 July 25, 2021

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

7.2.0 July 21, 2021

  • 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 July 18, 2021

  • Updated Spanish and Galician translations

7.1.10 July 10, 2021

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

7.1.9 June 25, 2021

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

7.1.8 June 12, 2021

  • 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 June 6, 2021

  • Improved screen reader support

7.1.6 May 30, 2021

  • 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 May 19, 2021

  • Fixed #2655: Details breaking page margins on print

7.1.4 May 6, 2021

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

7.1.3 April 24, 2021

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

7.1.2 April 18, 2021

  • 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 April 10, 2021

  • 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 March 29, 2021

  • 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 March 28, 2021

  • 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 March 14, 2021

  • 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 March 7, 2021

  • 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 March 4, 2021

  • 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 February 26, 2021

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

7.0.2 February 25, 2021

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

7.0.1 February 24, 2021

  • 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 February 22, 2021

  • 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 February 4, 2021

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

6.2.7 January 31, 2021

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

6.2.6 January 26, 2021

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

6.2.5 January 17, 2021

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

6.2.4 January 9, 2021

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

6.2.3 December 27, 2020

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

6.2.2 December 22, 2020

  • Removed Markdown version range limit (6.2.0 regression)

6.2.1 December 22, 2020

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

6.2.0 December 22, 2020

  • 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 December 6, 2020

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

6.1.6 November 22, 2020

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

6.1.5 November 15, 2020

  • Fixed search reset button not showing/hiding correctly

6.1.4 November 7, 2020

  • Fixed sidebar jitter when scrolling footer into view

6.1.3 November 5, 2020

  • 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 October 31, 2020

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

6.1.1 October 31, 2020

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

6.1.0 October 17, 2020

  • 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 October 4, 2020

  • 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 September 26, 2020

  • 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% (176kb124kb)
  • Removed mkdocs and readthedocs themes from Docker image

6.0.0 September 25, 2020

  • 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% (84kb67kb)
  • 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 September 23, 2020

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

5.5.13 September 19, 2020

  • Improved abbreviations on touch devices

5.5.12 August 31, 2020

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

5.5.11 August 28, 2020

  • Fixed Disqus integration, as the minifier killed the config

5.5.10 August 28, 2020

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

5.5.9 August 26, 2020

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

5.5.8 August 23, 2020

  • 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 August 16, 2020

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

5.5.6 August 12, 2020

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

5.5.5 August 11, 2020

  • Fixed missing vendor and worker distribution files

5.5.4 August 11, 2020

  • Added support for sortable data tables

5.5.3 August 4, 2020

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

5.5.2 August 3, 2020

  • 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 August 1, 2020

  • 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 July 24, 2020

  • 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 June 29, 2020

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

5.3.3 June 24, 2020

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

5.3.2 June 21, 2020

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

5.3.1 June 20, 2020

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

5.3.0 June 15, 2020

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

5.2.3 June 6, 2020

  • 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 May 26, 2020

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

5.2.1 May 22, 2020

  • 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 May 18, 2020

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

5.1.7 May 16, 2020

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

5.1.6 May 9, 2020

  • 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 May 3, 2020

  • 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 April 30, 2020

  • 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

5.1.3 April 26, 2020

  • Fixed overflowing content area after switch to flexbox

5.1.2 April 26, 2020

  • 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 April 17, 2020

  • 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 April 12, 2020

5.0.2 April 10, 2020

  • 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 April 7, 2020

  • Fixed syntax error in Spanish translation

5.0.0 April 7, 2020

  • 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 February 14, 2020

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

4.6.2 February 8, 2020

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

4.6.1 February 8, 2020

  • 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 December 11, 2019

4.5.1 December 2, 2019

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

4.5.0 November 16, 2019

  • 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 October 3, 2019

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

4.4.2 August 27, 2019

  • 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 August 22, 2019

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

4.4.0 June 15, 2019

  • 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 May 23, 2019

  • Fixed spelling error in Danish translations

4.3.0 May 17, 2019

  • 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 April 28, 2019

  • 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 April 16, 2019

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

4.1.1 March 28, 2019

  • Fixed minor CSS errors detected during validation

4.1.0 March 22, 2019

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

4.0.2 March 1, 2019

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

4.0.1 February 13, 2019

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

4.0.0 February 13, 2019

  • 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 January 29, 2019

  • 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 December 28, 2018

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

3.1.0 November 17, 2018

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

3.0.6 October 26, 2018

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

3.0.5 October 23, 2018

  • 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 September 3, 2018

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

3.0.3 August 7, 2018

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

3.0.2 August 6, 2018

  • Fixed #839: Lunr.js stemmer imports incorrect

3.0.1 August 5, 2018

  • Fixed #838: Search result links incorrect

3.0.0 August 5, 2018

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

2.9.4 July 29, 2018

  • Fixed build error after MkDocs upgrade

2.9.3 July 29, 2018

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

2.9.2 June 29, 2018

  • Added Hindi and Czech translations

2.9.1 June 18, 2018

  • 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 June 13, 2018

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

2.8.0 June 10, 2018

  • 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 April 26, 2018

  • Added Finnish translations

2.7.2 April 9, 2018

  • Fixed rendering issue for details on Edge

2.7.1 March 21, 2018

  • 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 March 6, 2018

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

2.6.6 February 22, 2018

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

2.6.5 February 22, 2018

  • Reverted --dev-addr flag removal from Dockerfile

2.6.4 February 21, 2018

  • 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 February 18, 2018

  • Added Vietnamese translations

2.6.2 February 12, 2018

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

2.6.1 February 11, 2018

  • 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 February 2, 2018

  • 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 January 31, 2018

  • Added Hungarian translations

2.5.4 January 29, 2018

  • Fixed #683: gh-deploy fails inside Docker

2.5.3 January 25, 2018

  • Added Ukrainian translations

2.5.2 January 22, 2018

  • 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 January 20, 2018

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

2.5.0 January 13, 2018

  • Added support for right-to-left languages

2.4.0 January 11, 2018

  • 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 January 9, 2018

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

2.2.6 December 27, 2017

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

2.2.5 December 18, 2017

  • Fixed #639: Broken default favicon

2.2.4 December 18, 2017

  • Fixed #638: Build breaks with Jinja < 2.9

2.2.3 December 13, 2017

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

2.2.2 December 8, 2017

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

2.2.1 December 2, 2017

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

2.2.0 November 22, 2017

  • 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 November 21, 2017

  • 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 November 19, 2017

  • 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 November 5, 2017

  • Fixed details not opening with footnote reference

2.0.3 November 5, 2017

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

2.0.2 November 1, 2017

  • 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 October 31, 2017

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

2.0.0 October 31, 2017

  • 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 October 26, 2017

  • Added Italian, Norwegian, French and Chinese translations

1.12.1 October 22, 2017

  • 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 October 20, 2017

  • 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 October 19, 2017

  • Added localization to clipboard
  • Refactored localization logic

1.10.4 October 18, 2017

  • 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 October 11, 2017

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

1.10.2 October 6, 2017

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

1.10.1 September 14, 2017

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

1.10.0 September 1, 2017

  • 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 August 29, 2017

  • 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 August 7, 2017

  • Fixed #421: Missing pagination for GitHub API

1.8.0 August 2, 2017

  • 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 July 25, 2017

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

1.7.4 June 21, 2017

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

1.7.3 June 7, 2017

  • Fixed error when setting language to Japanese for site search

1.7.2 June 6, 2017

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

1.7.1 June 1, 2017

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

1.7.0 June 1, 2017

  • 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 May 24, 2017

  • Fixed #337: JavaScript error for GitHub organization URLs

1.6.3 May 16, 2017

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

1.6.2 May 15, 2017

  • 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 April 23, 2017

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

1.6.0 April 22, 2017

  • 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 April 20, 2017

  • Fixed #282: Browser search (Meta+F) is hijacked

1.5.4 April 8, 2017

  • 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 April 7, 2017

  • 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 April 5, 2017

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

1.5.1 March 30, 2017

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

1.5.0 March 24, 2017

  • 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 March 16, 2017

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

1.4.0 March 16, 2017

  • 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 March 11, 2017

  • 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 March 3, 2017

  • 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 February 26, 2017

  • Fixed incorrectly displayed nested lists when using tabs

1.1.0 February 26, 2017

  • 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 February 18, 2017

  • 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 February 16, 2017

  • 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 January 22, 2017

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

1.0.2 January 15, 2017

  • Fixed #108: Horizontal scrollbar in content area

1.0.1 January 14, 2017

  • 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 January 13, 2017

  • 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 June 26, 2016

  • 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 May 16, 2016

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

0.2.2 March 20, 2016

  • 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 March 12, 2016

  • Fixed #10: Invisible header after closing search bar with ESC 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 February 24, 2016

  • 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 February 21, 2016

  • 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 February 16, 2016

  • 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 February 11, 2016

  • 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 February 9, 2016

  • Initial release
Skip to content

Changelog

Material for MkDocs

9.4.0 September 21, 2023

  • Added Belarusian translations
  • Added version info to entrypoint of package
  • Added emoji extension as a replacement for materialx
  • Improved slate color scheme (dark mode) - now even darker
  • Restructured project to improve development experience
  • Updated MkDocs to 1.5.3
  • Fixed #3890: Development mode crash on Linux

9.3.2 September 19, 2023

  • Updated Slovenian translations
  • Updated Python dependencies in requirements to use minimum versions
  • Fixed #6017: Code highlighting inconsistent in Community and Insiders edition
  • Fixed #6001: Contributor avatars display incorrectly in Firefox
  • Fixed #6000: Blog post drafts are included in navigation

9.3.1 September 11, 2023

  • Fixed crash of group plugin when used together with hooks

9.3.0 September 11, 2023

  • Improved configuration sharing between Community and Insiders edition
  • Added experimental built-in group plugin for enabling plugins conditionally
  • Added new settings in tags plugin for enabling/disabling
  • Dropped support for Python 3.7 (EOL)

9.2.8 September 4, 2023

  • Updated Italian and Russian translations
  • Fixed #5952: Combining blog and tags plugin leads to wrong links
  • Fixed #5951: Blog plugin ignores post title in metadata
  • Fixed #5949: Blog plugin ignores post linked in nav

9.2.7 September 2, 2023

  • Switched dependencies to compatible release clauses
  • Removed readtime and lxml dependencies for blog plugin
  • Reduced size of Docker image to improve CI build performance
  • Fixed #5945: Incorrect footer navigation for sibling pages of blog
  • Fixed #5939: Page jumps when changing color palette (Firefox 117)
  • Fixed #5901: Announcement bar reappears when using instant loading
  • Fixed #5824: Allow to customize styles of sequence diagrams

9.2.6 August 31, 2023

  • Added Basque translations
  • Added template for simple redirects
  • Improved blog plugin interop by moving view generation to on_files
  • Fixed #5924: Social plugin still checks dependencies when disabled
  • Fixed #5916: Blog plugin crashes on Python 3.8 (9.2.0 regression)

9.2.5 August 27, 2023

  • Fixed error in dirty serve mode when using blog plugin
  • Fixed page title not being consistent in blog plugin pagination
  • Fixed #5899: Blog plugin pagination breaks when disabling directory URLs

9.2.4 August 26, 2023

  • Added version to bug report name in info plugin
  • Updated Afrikaans translations

9.2.3 August 22, 2023

  • Fixed blog plugin rendering wrongly with markdown.extensions.toc
  • Fixed blog plugin entrypoint generation

9.2.2 August 22, 2023

  • Fixed #5880: Blog plugin failing when building a standalone blog
  • Fixed #5881: Blog plugin not compatible with Python < 3.10

9.2.1 August 21, 2023

  • Fixed #5879: Blog plugin failing when building a standalone blog
  • Fixed error in blog plugin when using draft tagging on future date
  • Fixed error in blog plugin when toc extension is not enabled

9.2.0 August 21, 2023

Additions and improvements

  • Added blogging support via built-in blog plugin
  • Added support for Chinese language segmentaiton in search plugin
  • Added support for adding custom dates to blog posts
  • Added support for paginating archive and category pages
  • Added support for annotations (outside of code blocks)
  • Added support for navigation icons
  • Added support for navigation pruning
  • Added support for navigation status
  • Added support for customizing site icons
  • Added support for customizing (code) annotation icons
  • Added focus outline to admonitions and details
  • Added prompt for bug report name to info plugin
  • Added Luxembourgish translations
  • Improved rendering of (code) annotation markers
  • Improved print styles for (code) annotations
  • Improved customizability of navigation tabs
  • Improved interop of plugins with external tools like mike
  • Improved interop of blog plugin with awesome pages plugin
  • Improved header partial by moving buttons into separate partials
  • Improved clarity of site_url warning in social plugin
  • Improved blog plugin to automatically setup directory structure
  • Switched info plugin to importlib to mitigate deprecations
  • Automatically download ResizeObserver polyfill when necessary
  • Automatically add iframe-worker polyfill when necessary in offline plugin
  • Automatically focus and bring up keyboard on touch devices
  • Updated Serbo-Croatian translations
  • Updated MkDocs to 1.5.2

Removals

  • Removed Universal Analytics integration
  • Removed ancient polyfills to reduce size of bundled JavaScript by 20%
  • Removed necessity for Array.flat and Array.flatMap polyfill
  • Removed announcement bar button when JavaScript is not available

Fixes

  • Fixed rendering of tags when announcement bar is present
  • Fixed tags plugin rendering pages excluded by other plugins
  • Fixed #5132: Blog plugin requires nav entry in mkdocs.yml
  • Fixed #5599: Insufficient contrast for default link color
  • Fixed #5715: Blog plugin missing integrated table of contents in pagination
  • Fixed #5806: Version selector not hoverable on some Android devices
  • Fixed #5826: Blog post drafts with tags show up in tags index

9.1.21 July 27, 2023

  • Fixed MkDocs 1.4 compat issue in social plugin (9.1.20 regression)

9.1.20 July 27, 2023

  • Updated Sanskrit translations
  • Fixed deprecation warnings for social plugin

9.1.19 July 18, 2023

  • Added support for MkDocs 1.5+
  • Fixed #5699: Improve error reporting in social plugin

9.1.18 July 3, 2023

  • Updated Danish translations
  • Added support for installing user requirements in Docker image
  • Fixed #5655: Search separator with lookbehind breaks highlighting

9.1.17 June 23, 2023

  • Fixed #5633: Code annotations with nested lists incorrectly mounted
  • Fixed #5628: Regression in new social plugin configuration scheme

9.1.16 June 15, 2023

  • Updated Indonesian translations
  • Ensure scroll bar follows color scheme of operating system

9.1.15 May 29, 2023

  • Fixed #5566: Indicate color scheme to operating system
  • Fixed #5565: Update Dockerfile to latest version of base image
  • Fixed #5554: Add additional version tags (9, 9.1) to Docker image
  • Fixed #5536: Strip tags of ARIA labels in table of contents

9.1.14 May 20, 2023

  • Updated Armenian and Greek translations

9.1.13 May 16, 2023

  • Fixed #5517: Social plugin crashes for some fonts (e.g. Open Sans)

9.1.12 May 12, 2023

  • Updated Bengali (Bangla) translations
  • Fixed #5503: Docker image publish errors on uppercase characters
  • Fixed #5407: Auto-pause media when in hidden content tabs

9.1.11 May 8, 2023

  • Fixed #5487: Social plugin crashes without options (9.1.10 regression)

9.1.10 May 8, 2023

  • Added cards_layout_options setting for social cards
  • Deprecated cards_color and cards_font setting for social cards

9.1.9 May 2, 2023

  • Added Telugu, Kannada and Sanskrit translations
  • Fixed #5428: Fixed margins for light/dark mode images in figures
  • Fixed #5420: Social plugin crashing for some specific Google Fonts
  • Fixed #5160: Instant loading makes code annotations jump (9.1.1 regression)
  • Fixed #4920: Social plugin not loading logo from custom icon set
  • Fixed social plugin crashing when only code font is specified

9.1.8 April 24, 2023

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

9.1.7 April 22, 2023

  • 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 April 7, 2023

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

9.1.5 March 31, 2023

  • 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 March 24, 2023

  • 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 March 14, 2023

  • 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 March 9, 2023

  • 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 March 5, 2023

  • 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 March 2, 2023

  • 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 February 26, 2023

  • Updated Chinese (Traditional) translations
  • Updated Hebrew translations

9.0.14 February 23, 2023

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

9.0.13 February 18, 2023

  • 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 February 9, 2023

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

9.0.11 February 3, 2023

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

9.0.10 February 2, 2023

  • 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 January 30, 2023

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

9.0.8 January 29, 2023

  • 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 January 28, 2023

  • 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 January 19, 2023

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

9.0.5 January 14, 2023

  • Fixed #4842: Improved accessibility of search result list

9.0.4 January 12, 2023

  • 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 January 8, 2023

  • 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 January 4, 2023

  • 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 January 3, 2023

  • 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 January 2, 2023

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 November 30, 2022

8.5.10 November 11, 2022

  • 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 November 8, 2022

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

8.5.8 November 3, 2022

  • 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 October 22, 2022

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

8.5.6 October 2, 2022

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

8.5.5 October 1, 2022

  • 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 September 30, 2022

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

8.5.3 September 20, 2022

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

8.5.2 September 18, 2022

  • 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 September 15, 2022

  • Fixed #4366: Removed dependencies with native extensions

8.5.0 September 13, 2022

  • 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 September 12, 2022

  • Moved comments integration to separate partial (comments.html)

8.4.3 September 7, 2022

  • 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 August 27, 2022

  • 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 August 21, 2022

  • Updated Croatian and Hebrew translations

8.4.0 August 13, 2022

  • 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 July 4, 2022

  • 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 June 24, 2022

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

8.3.7 June 22, 2022

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

8.3.6 June 16, 2022

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

8.3.5 June 14, 2022

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

8.3.4 June 11, 2022

  • Fixed #4004: Tags with multiple words not searchable

8.3.3 June 7, 2022

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

8.3.2 June 5, 2022

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

8.3.1 June 4, 2022

  • 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 June 2, 2022

  • 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 May 28, 2022

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

8.2.15 May 14, 2022

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

8.2.14 May 8, 2022

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

8.2.13 May 2, 2022

  • 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 April 30, 2022

  • 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 April 25, 2022

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

8.2.10 April 24, 2022

  • 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 April 8, 2022

  • 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 March 27, 2022

  • 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 March 24, 2022

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

8.2.6 March 23, 2022

  • 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 March 6, 2022

  • 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 March 2, 2022

  • 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 February 27, 2022

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

8.2.2 February 26, 2022

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

8.2.1 February 17, 2022

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

8.2.0 February 17, 2022

  • 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 February 10, 2022

8.1.10 February 6, 2022

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

8.1.9 January 30, 2022

8.1.8 January 23, 2022

  • 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 January 16, 2022

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

8.1.6 January 11, 2022

  • 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 January 9, 2022

  • 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 January 2, 2022

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

8.1.3 December 19, 2021

  • 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 December 15, 2021

  • 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 December 13, 2021

  • 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 December 10, 2021

  • 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 December 6, 2021

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

8.0.4 December 4, 2021

  • 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 December 2, 2021

  • 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 November 30, 2021

  • Fixed #3275: Code annotations always disappear on click

8.0.1 November 28, 2021

  • 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 November 28, 2021

  • 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 October 30, 2021

  • Added support for adding titles to code blocks

7.3.5 October 27, 2021

  • 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 October 17, 2021

  • 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

7.3.3 October 11, 2021

  • 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 October 6, 2021

  • 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 October 2, 2021

  • 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 September 23, 2021

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

7.2.8 September 20, 2021

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

7.2.7 September 19, 2021

  • 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 September 1, 2021

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

7.2.5 August 25, 2021

  • 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 August 11, 2021

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

7.2.3 August 9, 2021

  • 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 July 31, 2021

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

7.2.1 July 25, 2021

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

7.2.0 July 21, 2021

  • 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 July 18, 2021

  • Updated Spanish and Galician translations

7.1.10 July 10, 2021

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

7.1.9 June 25, 2021

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

7.1.8 June 12, 2021

  • 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 June 6, 2021

  • Improved screen reader support

7.1.6 May 30, 2021

  • 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 May 19, 2021

  • Fixed #2655: Details breaking page margins on print

7.1.4 May 6, 2021

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

7.1.3 April 24, 2021

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

7.1.2 April 18, 2021

  • 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 April 10, 2021

  • 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 March 29, 2021

  • 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 March 28, 2021

  • 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 March 14, 2021

  • 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 March 7, 2021

  • 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 March 4, 2021

  • 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 February 26, 2021

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

7.0.2 February 25, 2021

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

7.0.1 February 24, 2021

  • 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 February 22, 2021

  • 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 February 4, 2021

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

6.2.7 January 31, 2021

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

6.2.6 January 26, 2021

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

6.2.5 January 17, 2021

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

6.2.4 January 9, 2021

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

6.2.3 December 27, 2020

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

6.2.2 December 22, 2020

  • Removed Markdown version range limit (6.2.0 regression)

6.2.1 December 22, 2020

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

6.2.0 December 22, 2020

  • 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 December 6, 2020

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

6.1.6 November 22, 2020

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

6.1.5 November 15, 2020

  • Fixed search reset button not showing/hiding correctly

6.1.4 November 7, 2020

  • Fixed sidebar jitter when scrolling footer into view

6.1.3 November 5, 2020

  • 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 October 31, 2020

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

6.1.1 October 31, 2020

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

6.1.0 October 17, 2020

  • 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 October 4, 2020

  • 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 September 26, 2020

  • 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% (176kb124kb)
  • Removed mkdocs and readthedocs themes from Docker image

6.0.0 September 25, 2020

  • 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% (84kb67kb)
  • 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 September 23, 2020

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

5.5.13 September 19, 2020

  • Improved abbreviations on touch devices

5.5.12 August 31, 2020

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

5.5.11 August 28, 2020

  • Fixed Disqus integration, as the minifier killed the config

5.5.10 August 28, 2020

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

5.5.9 August 26, 2020

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

5.5.8 August 23, 2020

  • 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 August 16, 2020

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

5.5.6 August 12, 2020

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

5.5.5 August 11, 2020

  • Fixed missing vendor and worker distribution files

5.5.4 August 11, 2020

  • Added support for sortable data tables

5.5.3 August 4, 2020

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

5.5.2 August 3, 2020

  • 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 August 1, 2020

  • 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 July 24, 2020

  • 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 June 29, 2020

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

5.3.3 June 24, 2020

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

5.3.2 June 21, 2020

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

5.3.1 June 20, 2020

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

5.3.0 June 15, 2020

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

5.2.3 June 6, 2020

  • 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 May 26, 2020

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

5.2.1 May 22, 2020

  • 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 May 18, 2020

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

5.1.7 May 16, 2020

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

5.1.6 May 9, 2020

  • 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 May 3, 2020

  • 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 April 30, 2020

  • 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

5.1.3 April 26, 2020

  • Fixed overflowing content area after switch to flexbox

5.1.2 April 26, 2020

  • 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 April 17, 2020

  • 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 April 12, 2020

5.0.2 April 10, 2020

  • 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 April 7, 2020

  • Fixed syntax error in Spanish translation

5.0.0 April 7, 2020

  • 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 February 14, 2020

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

4.6.2 February 8, 2020

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

4.6.1 February 8, 2020

  • 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 December 11, 2019

4.5.1 December 2, 2019

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

4.5.0 November 16, 2019

  • 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 October 3, 2019

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

4.4.2 August 27, 2019

  • 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 August 22, 2019

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

4.4.0 June 15, 2019

  • 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 May 23, 2019

  • Fixed spelling error in Danish translations

4.3.0 May 17, 2019

  • 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 April 28, 2019

  • 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 April 16, 2019

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

4.1.1 March 28, 2019

  • Fixed minor CSS errors detected during validation

4.1.0 March 22, 2019

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

4.0.2 March 1, 2019

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

4.0.1 February 13, 2019

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

4.0.0 February 13, 2019

  • 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 January 29, 2019

  • 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 December 28, 2018

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

3.1.0 November 17, 2018

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

3.0.6 October 26, 2018

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

3.0.5 October 23, 2018

  • 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 September 3, 2018

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

3.0.3 August 7, 2018

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

3.0.2 August 6, 2018

  • Fixed #839: Lunr.js stemmer imports incorrect

3.0.1 August 5, 2018

  • Fixed #838: Search result links incorrect

3.0.0 August 5, 2018

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

2.9.4 July 29, 2018

  • Fixed build error after MkDocs upgrade

2.9.3 July 29, 2018

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

2.9.2 June 29, 2018

  • Added Hindi and Czech translations

2.9.1 June 18, 2018

  • 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 June 13, 2018

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

2.8.0 June 10, 2018

  • 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 April 26, 2018

  • Added Finnish translations

2.7.2 April 9, 2018

  • Fixed rendering issue for details on Edge

2.7.1 March 21, 2018

  • 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 March 6, 2018

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

2.6.6 February 22, 2018

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

2.6.5 February 22, 2018

  • Reverted --dev-addr flag removal from Dockerfile

2.6.4 February 21, 2018

  • 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 February 18, 2018

  • Added Vietnamese translations

2.6.2 February 12, 2018

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

2.6.1 February 11, 2018

  • 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 February 2, 2018

  • 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 January 31, 2018

  • Added Hungarian translations

2.5.4 January 29, 2018

  • Fixed #683: gh-deploy fails inside Docker

2.5.3 January 25, 2018

  • Added Ukrainian translations

2.5.2 January 22, 2018

  • 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 January 20, 2018

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

2.5.0 January 13, 2018

  • Added support for right-to-left languages

2.4.0 January 11, 2018

  • 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 January 9, 2018

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

2.2.6 December 27, 2017

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

2.2.5 December 18, 2017

  • Fixed #639: Broken default favicon

2.2.4 December 18, 2017

  • Fixed #638: Build breaks with Jinja < 2.9

2.2.3 December 13, 2017

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

2.2.2 December 8, 2017

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

2.2.1 December 2, 2017

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

2.2.0 November 22, 2017

  • 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 November 21, 2017

  • 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 November 19, 2017

  • 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 November 5, 2017

  • Fixed details not opening with footnote reference

2.0.3 November 5, 2017

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

2.0.2 November 1, 2017

  • 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 October 31, 2017

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

2.0.0 October 31, 2017

  • 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 October 26, 2017

  • Added Italian, Norwegian, French and Chinese translations

1.12.1 October 22, 2017

  • 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 October 20, 2017

  • 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 October 19, 2017

  • Added localization to clipboard
  • Refactored localization logic

1.10.4 October 18, 2017

  • 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 October 11, 2017

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

1.10.2 October 6, 2017

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

1.10.1 September 14, 2017

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

1.10.0 September 1, 2017

  • 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 August 29, 2017

  • 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 August 7, 2017

  • Fixed #421: Missing pagination for GitHub API

1.8.0 August 2, 2017

  • 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 July 25, 2017

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

1.7.4 June 21, 2017

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

1.7.3 June 7, 2017

  • Fixed error when setting language to Japanese for site search

1.7.2 June 6, 2017

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

1.7.1 June 1, 2017

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

1.7.0 June 1, 2017

  • 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 May 24, 2017

  • Fixed #337: JavaScript error for GitHub organization URLs

1.6.3 May 16, 2017

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

1.6.2 May 15, 2017

  • 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 April 23, 2017

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

1.6.0 April 22, 2017

  • 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 April 20, 2017

  • Fixed #282: Browser search (Meta+F) is hijacked

1.5.4 April 8, 2017

  • 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 April 7, 2017

  • 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 April 5, 2017

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

1.5.1 March 30, 2017

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

1.5.0 March 24, 2017

  • 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 March 16, 2017

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

1.4.0 March 16, 2017

  • 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 March 11, 2017

  • 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 March 3, 2017

  • 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 February 26, 2017

  • Fixed incorrectly displayed nested lists when using tabs

1.1.0 February 26, 2017

  • 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 February 18, 2017

  • 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 February 16, 2017

  • 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 January 22, 2017

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

1.0.2 January 15, 2017

  • Fixed #108: Horizontal scrollbar in content area

1.0.1 January 14, 2017

  • 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 January 13, 2017

  • 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 June 26, 2016

  • 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 May 16, 2016

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

0.2.2 March 20, 2016

  • 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 March 12, 2016

  • Fixed #10: Invisible header after closing search bar with ESC 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 February 24, 2016

  • 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 February 21, 2016

  • 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 February 16, 2016

  • 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 February 11, 2016

  • 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 February 9, 2016

  • Initial release
Skip to content

Translations

It's unbelievable – with the help of international community contributions, Material for MkDocs has been translated into 60+ languages. As you can imagine, it's impossible for us maintainers to keep all languages up-to-date, and new features sometimes require new translations.

If you would like to help us to make Material for MkDocs even more globally accessible and have noticed a missing translation in your language, or would like to add a new language, you can help us by following the steps of the guide below.

Before creating an issue

Translations change frequently, which is why we want to make sure that you don't invest your time in duplicating work. Before adding translations, please check the following things:

Check language availability

With more than 60 languages, the chances are good that your language is already supported by Material for MkDocs. You can check if your language is available, or needs improvements or additional translations by inspecting the list of supported languages:

  • Your language is already supported – in this case, you can check if there are translations missing, and click the link underneath your language to add them, which takes 5 minutes.

  • Your language is missing – in that case, you can help us add support for your language to Material for MkDocs! Read on, to learn how to do this.

Search our issue tracker

Another user might have already created an issue supplying the missing translations for your language that still needs to be integrated by us maintainers. To avoid investing your time in duplicated work, please search the issue tracker beforehand.


At this point, when you have made sure that Material for MkDocs doesn't already support your language, you can add new translations for it by following the issue template.

Issue template

We have created an issue template that makes contributing translations as simple as possible. It is the result of our experience with 60+ language contributions and updates over the last couple of years, and consists of the following parts:

Title

When you update an already existing language, you can just leave the title as it is. Adding support for a new language, replace the ... in the pre-filled title with the name of your language.

Example
Clear Add translations for German
Unclear Add translations ...
Useless Help

Translations

If a translation contains an ⬅ icon on the right side, it is missing. You can translate this line and remove the ⬅ icon. If you don't know how to translate specific lines, simply leave them for other contributors to complete. To ensure the accuracy of your translation, consider double-checking the context of the words by looking at our English translations.

Country flag optional

For a better overview, our list of supported languages includes country flags next to the language names. You can help us select a flag for your language by adding the shortcode for the country flag to this field. Go to our emoji search and enter flag to find all available shortcodes.

What if my flag is not available?

Twemoji provides flag emojis for 260 countries – subdivisions of countries, such as states, provinces, or regions, are not supported. If you're adding translations for a subdivision, please choose the most appropriate available flag.

Why this might be helpful: adding a country flag next to the country name can be helpful for you and for others to find the language in the list of supported languages faster and easier. If your country's flag is not supported by Twemoji, you can help us choose an alternative.

Checklist

Thanks for following the guide and helping us to add new translations to Material for MkDocs – you are almost done. The checklist ensures that you have read this guide and have worked to your best knowledge to provide us with everything we need to integrate your contribution.

We'll take it from here.


Attribution

If you submit a translation using the template above, you will be credited as a co-author in the commit, so you don't need to open a pull request. You have done a significant contribution to the project, making Material for MkDocs accessible to more people around the world. Thank you!

Skip to content

Translations

It's unbelievable – with the help of international community contributions, Material for MkDocs has been translated into 60+ languages. As you can imagine, it's impossible for us maintainers to keep all languages up-to-date, and new features sometimes require new translations.

If you would like to help us to make Material for MkDocs even more globally accessible and have noticed a missing translation in your language, or would like to add a new language, you can help us by following the steps of the guide below.

Before creating an issue

Translations change frequently, which is why we want to make sure that you don't invest your time in duplicating work. Before adding translations, please check the following things:

Check language availability

With more than 60 languages, the chances are good that your language is already supported by Material for MkDocs. You can check if your language is available, or needs improvements or additional translations by inspecting the list of supported languages:

  • Your language is already supported – in this case, you can check if there are translations missing, and click the link underneath your language to add them, which takes 5 minutes.

  • Your language is missing – in that case, you can help us add support for your language to Material for MkDocs! Read on, to learn how to do this.

Search our issue tracker

Another user might have already created an issue supplying the missing translations for your language that still needs to be integrated by us maintainers. To avoid investing your time in duplicated work, please search the issue tracker beforehand.


At this point, when you have made sure that Material for MkDocs doesn't already support your language, you can add new translations for it by following the issue template.

Issue template

We have created an issue template that makes contributing translations as simple as possible. It is the result of our experience with 60+ language contributions and updates over the last couple of years, and consists of the following parts:

Title

When you update an already existing language, you can just leave the title as it is. Adding support for a new language, replace the ... in the pre-filled title with the name of your language.

Example
Clear Add translations for German
Unclear Add translations ...
Useless Help

Translations

If a translation contains an ⬅ icon on the right side, it is missing. You can translate this line and remove the ⬅ icon. If you don't know how to translate specific lines, simply leave them for other contributors to complete. To ensure the accuracy of your translation, consider double-checking the context of the words by looking at our English translations.

Country flag optional

For a better overview, our list of supported languages includes country flags next to the language names. You can help us select a flag for your language by adding the shortcode for the country flag to this field. Go to our emoji search and enter flag to find all available shortcodes.

What if my flag is not available?

Twemoji provides flag emojis for 260 countries – subdivisions of countries, such as states, provinces, or regions, are not supported. If you're adding translations for a subdivision, please choose the most appropriate available flag.

Why this might be helpful: adding a country flag next to the country name can be helpful for you and for others to find the language in the list of supported languages faster and easier. If your country's flag is not supported by Twemoji, you can help us choose an alternative.

Checklist

Thanks for following the guide and helping us to add new translations to Material for MkDocs – you are almost done. The checklist ensures that you have read this guide and have worked to your best knowledge to provide us with everything we need to integrate your contribution.

We'll take it from here.


Attribution

If you submit a translation using the template above, you will be credited as a co-author in the commit, so you don't need to open a pull request. You have done a significant contribution to the project, making Material for MkDocs accessible to more people around the world. Thank you!

Skip to content

Icons, Emojis

One of the best features of Material for MkDocs is the possibility to use more than 10,000 icons and thousands of emojis in your project documentation with practically zero additional effort. Moreover, custom icons can be added and used in mkdocs.yml, documents and templates.

    Tip: Enter some keywords to find icons and emojis and click on the shortcode to copy it to your clipboard.

    Configuration

    This configuration enables the use of icons and emojis by using simple shortcodes which can be discovered through the icon search. Add the following lines to mkdocs.yml:

    markdown_extensions:
       - attr_list
       - pymdownx.emoji:
    -      emoji_index: !!python/name:materialx.emoji.twemoji
    -      emoji_generator: !!python/name:materialx.emoji.to_svg
    +      emoji_index: !!python/name:material.extensions.emoji.twemoji
    +      emoji_generator: !!python/name:material.extensions.emoji.to_svg
     

    The following icon sets are bundled with Material for MkDocs:

    See additional configuration options:

    Usage

    Using emojis

    Emojis can be integrated in Markdown by putting the shortcode of the emoji between two colons. If you're using Twemoji (recommended), you can look up the shortcodes at Emojipedia:

    Emoji
    :smile:
     

    😄

    Using icons

    When Emoji is enabled, icons can be used similar to emojis, by referencing a valid path to any icon bundled with the theme, which are located in the .icons directory, and replacing / with -:

    Icon
    :fontawesome-regular-face-laugh-wink:
     

    with colors

    When Attribute Lists is enabled, custom CSS classes can be added to icons by suffixing the icon with a special syntax. While HTML allows to use inline styles, it's always recommended to add an additional style sheet and move declarations into dedicated CSS classes: