# Changelog ## Material for MkDocs ### 9.2.0 July 6, 2023 { id="9.2.0" } - Added blogging support via built-in blog plugin - Added Chinese language support to built-in search plugin - 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 - Improved rendering of (code) annotation markers - Improved print styles for (code) annotations - Improved customizability of navigation tabs - Improved plugin inter-op with external tools like mike - 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 - Automatically download ResizeObserver polyfill when necessary - Updated MkDocs to 1.5.0 - Fixed rendering of tags when announcement bar is present ### 9.1.19 July 18, 2023 { id="9.1.19" } - Added support for MkDocs 1.5+ - Fixed #5699: Improve error reporting in social plugin ### 9.1.18 July 3, 2023 { id="9.1.18" } - 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 { id="9.1.17" } - Fixed #5633: Code annotations with nested lists incorrectly mounted - Fixed #5628: Regression in new social plugin configuration scheme ### 9.1.16 June 15, 2023 { id="9.1.16" } - Updated Indonesian translations - Ensure scroll bar follows color scheme of operating system ### 9.1.15 May 29, 2023 { id="9.1.15" } - 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 { id="9.1.14" } - Updated Armenian and Greek translations ### 9.1.13 May 16, 2023 { id="9.1.13" } - Fixed #5517: Social plugin crashes for some fonts (e.g. Open Sans) ### 9.1.12 May 12, 2023 { id="9.1.12" } - 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 { id="9.1.11" } - Fixed #5487: Social plugin crashes without options (9.1.10 regression) ### 9.1.10 May 8, 2023 { id="9.1.10" } - Added `cards_layout_options` setting for social cards - Deprecated `cards_color` and `cards_font` setting for social cards ### 9.1.9 May 2, 2023 { id="9.1.9" } - 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 { id="9.1.8" } - Fixed #5417: Theme breaks when `palette` is not defined (9.1.7 regression) ### 9.1.7 April 22, 2023 { id="9.1.7" } - Updated Persian (Farsi) and Turkish translations - Fixed #5401: Added missing flag to disable built-in tags plugin - Fixed #5206: Ensure defaults are set for primary and accent colors - Fixed unnecessary inclusion of palette CSS when unused ### 9.1.6 April 7, 2023 { id="9.1.6" } - Updated Persian (Farsi) translations - Fixed #5300: Boxes in Mermaid sequence diagrams not color-abiding ### 9.1.5 March 31, 2023 { id="9.1.5" } - Updated Lithuanian and Japanese translations - Updated Mermaid.js to version 9.4.3 - Fixed #5290: Footer previous/next labels cut-off for short page titles ### 9.1.4 March 24, 2023 { id="9.1.4" } - Fixed #5239: Instant loading breaks anchors in details (9.1.1 regression) - Fixed #5211: Anchor following not working for Chinese (9.1.2 regression) ### 9.1.3 March 14, 2023 { id="9.1.3" } - Added Kurdish (Soranî) translations - Updated Norwegian (Bokmål), Portuguese and Romanian translations - Improved compatibility with `mkdocs-jupyter` plugin - Fixed #5198: Built-in search plugin not filtering `script` and `style` tags - Fixed #5176: Back-to-top + instant loading not working (9.1.1 regression) ### 9.1.2 March 9, 2023 { id="9.1.2" } - Updated Icelandic, Korean and Swedish translations - Fixed #5168: Mermaid text boxes overflow (9.0.13 regression) - Fixed #5155: Table of contents not highlighting percent-encoded URLs ### 9.1.1 March 5, 2023 { id="9.1.1" } - Updated Czech and Thai translations - Improved instant loading (scroll restoration, slow connections) - Fixed #5023: Instant loading not allowing to go back to initial page - Fixed #3797: Instant loading does not work with section anchors in Safari ### 9.1.0 March 2, 2023 { id="9.1.0" } - Docker image now available for `amd64`, `arm64` and `arm/v7` - Updated Chinese (Taiwanese) translations - Generalized tag identifier implementation - Fixed flickering of header shadow on load - Fixed occasional flickering of announcement bar ### 9.0.15 February 26, 2023 { id="9.0.15" } - Updated Chinese (Traditional) translations - Updated Hebrew translations ### 9.0.14 February 23, 2023 { id="9.0.14" } - Fixed #5072: Rendering bug on navigation expand button in Firefox ### 9.0.13 February 18, 2023 { id="9.0.13" } - Updated Uzbek translations - Switched back to pre-9.0.0 headline detection in `content` partial - Fixed #5062: Version warning not readable when using slate scheme - Fixed #5061: Improved discernibility of table row hover color - Fixed #5034: Sequence actors in Mermaid diagrams not color-abiding - Fixed #4919: Allow to hide version warning in multiple versions ### 9.0.12 February 9, 2023 { id="9.0.12" } - Updated Catalan translations - Fixed #4975: Mermaid entity relationship rendering diagrams bug - Fixed #4924: Header title not reset when using instant loading ### 9.0.11 February 3, 2023 { id="9.0.11" } - Added Mastodon verification for social links (`rel=me`) - Updated Italian translations ### 9.0.10 February 2, 2023 { id="9.0.10" } - Updated Arabic translations - Updated Korean translations - Updated Hungarian translations - Updated Russian translations - Fixed #4977: Improved accessibility for content tabs - Fixed #4960: Sometimes anchor following doesn't bring last item into view ### 9.0.9 January 30, 2023 { id="9.0.9" } - Updated Bulgarian translations - Updated Chinese (Simplified) translations - Updated Dutch translations - Updated Hindi translations - Updated Japanese translations - Updated Polish translations ### 9.0.8 January 29, 2023 { id="9.0.8" } - Updated Croatian translations - Updated French translations - Updated Hungarian translations - Updated Portuguese (Brasilian) translations - Updated Spanish translations - Updated Ukrainian translations - Updated Urdu translations - Updated Vietnamese translations ### 9.0.7 January 28, 2023 { id="9.0.7" } - Improved accessibility of sidebar navigation - Moved all translations into community edition - Updated Polish and Portuguese (Brasilian) translations - Fixed info plugin terminating on subsequent reload when serving - Fixed #4910: Sidebar navigation labels have invalid ARIA roles - Fixed #4884: Search query terms can't be separated by colons ### 9.0.6 January 19, 2023 { id="9.0.6" } - Fixed #4883: Automatically disable info plugin when serving - Fixed #4885: Search plugin crashes in some exotic cases (9.0.3 regression) ### 9.0.5 January 14, 2023 { id="9.0.5" } - Fixed #4842: Improved accessibility of search result list ### 9.0.4 January 12, 2023 { id="9.0.4" } - Fixed #4823: Improved contrast ratio in footer (9.0.2 regression) - Fixed #4832: Set navigation items back to black (9.0.3 regression) - Fixed #4843: Emojis broken due to maxcdn.com shutting down - Upgraded Python Markdown Extensions to 9.9.1 ### 9.0.3 January 8, 2023 { id="9.0.3" } - Improved discernibility of section index pages in navigation - Improved collapsing of adjacent whitespace in search plugin - Updated Indonesian translations - Fixed view source of this page button when edit URL points to blob - Fixed #4829: Search overlay does not close for active anchor result - Fixed #4824: Search plugin crashes for `h[1-6]` contained in other elements - Fixed #4804: Nested navigation items not expandable with keyboard - Fixed #4689: anchor tracking not working for anchors in tables - Upgraded to Mermaid 9.3.0 ### 9.0.2 January 4, 2023 { id="9.0.2" } - Fixed #4823: Improved contrast ratio in footer to meet WCAG guidelines - Fixed #4819: Social plugin crashes when card generation is disabled - Fixed #4817: Search plugin crashes on numeric page titles in `nav` ### 9.0.1 January 3, 2023 { id="9.0.1" } - Removed `pipdeptree` dependency for built-in info plugin - Fixed appearance of linked tags when hovered (9.0.0 regression) - Fixed #4810: Abbreviations run out of screen on touch devices - Fixed #4813: View source and edit button links are the same ### 9.0.0 January 2, 2023 { id="9.0.0" } __Additions and improvements__ - Added support for rich search previews - Added support for tokenizer lookahead - Added support for better search highlighting - Added support for excluding content from search - Added support for configurable search pipeline - Added support for offline search via offline plugin - Added support for multiple instances of built-in tags plugin - Added support for removing copy-to-clipboard button - Added support for removing footer navigation - Added support for button to view the source of a page - Improved readability of query string for search sharing - Improved stability of search plugin when using `--dirtyreload` - Improved search result group button, now sticky and stable - Updated Norwegian translations - Updated MkDocs to 1.4.2 __Removals__ - Removed deprecated alternative admonition qualifiers - Removed `:is()` selectors (in output) for easier overriding - Removed `.title` suffix on translations - Removed legacy method for providing page title in feedback URL - Removed support for indexing only titles in search - Removed support for custom search transforms - Removed support for custom search workers - Removed temporary snow feature (easter egg) __Fixes__ - Fixed Norwegian and Korean language code - Fixed detection of composition events in search interface - Fixed search plugin not using title set via front matter - Fixed search highlighting of tags - Fixed search sharing URL using post transformed string - Fixed theme-color meta tag getting out-of-sync with palette toggle - Fixed prev/next page keyboard navigation when footer is not present - Fixed overflowing navigation tabs not being scrollable - Fixed inclusion of code block line numbers from search --- ### 8.5.11 November 30, 2022 { id="8.5.11" } - Let it snow, see https://twitter.com/squidfunk/status/1597939243090788352 ### 8.5.10 November 11, 2022 { id="8.5.10" } - Adjusted CSS to better allow for custom primary and accent colors - Fixed #4620: Primary color is not applied (8.5.9 regression) ### 8.5.9 November 8, 2022 { id="8.5.9" } - Fixed #4600: Illegible link colors for black and white primary colors - Fixed #4594: Need to set schema to change link color ### 8.5.8 November 3, 2022 { id="8.5.8" } - Added support for always showing settings in cookie consent - Fixed #4571: Buttons invisible if primary color is `white` or `black` - Fixed #4517: Illegible note in sequence diagram when using `slate` scheme ### 8.5.7 October 22, 2022 { id="8.5.7" } - Deprecated additional admonition qualifiers to reduce size of CSS - Fixed #4511: Search boost does not apply to sections ### 8.5.6 October 2, 2022 { id="8.5.6" } - Modernized appearance of admonitions (with fallback, see docs) - Improved appearance of inline code blocks in admonition titles ### 8.5.5 October 1, 2022 { id="8.5.5" } - Updated MkDocs to 1.4 - Fixed compatibility issues with MkDocs 1.4 - Fixed #4430: build error when enabling consent without repository URL ### 8.5.4 September 30, 2022 { id="8.5.4" } - Fixed expand icons shift on sidebar overflow (using `scrollbar-gutter`) - Fixed #4429: Text in sequence diagrams overflows in Firefox ### 8.5.3 September 20, 2022 { id="8.5.3" } - Fixed build error when enabling cookie consent without analytics - Fixed #4381: Code blocks render ligatures for some fonts ### 8.5.2 September 18, 2022 { id="8.5.2" } - Updated Mermaid.js to version 9.1.7 - Fixed overly large headlines in search results (8.5.0 regression) - Fixed #4358: Navigation sections appear as clickable (8.5.0 regression) - Fixed #4356: GitHub repository statistics fetched before cookie consent ### 8.5.1 September 15, 2022 { id="8.5.1" } - Fixed #4366: Removed dependencies with native extensions ### 8.5.0 September 13, 2022 { id="8.5.0" } - Added support for social cards - Added support for code annotation anchor links (deep linking) - Added support for code annotation comment stripping (syntax modifier) - Added support for sidebars scrolling automatically to active item - Added support for anchor following table of contents (= auto scroll) - Added support for tag icons ### 8.4.4 September 12, 2022 { id="8.4.4" } - Moved comments integration to separate partial (`comments.html`) ### 8.4.3 September 7, 2022 { id="8.4.3" } - Added Simple Icons to bundled icons (+2,300 icons) - Added support for changing edit icon - Moved page actions to separate partial (`actions.html`) - Fixed #4291: Version switching doesn't stay on page when anchors are used - Fixed #4327: Links in data tables do not receive link styling ### 8.4.2 August 27, 2022 { id="8.4.2" } - Updated Slovenian translations - Fixed #4277: Feedback widget hidden after navigation with instant loading - Fixed numeric tags in front matter breaking search functionality ### 8.4.1 August 21, 2022 { id="8.4.1" } - Updated Croatian and Hebrew translations ### 8.4.0 August 13, 2022 { id="8.4.0" } - Added support for cookie consent - Added support for feedback widget (Was this page helpful?) - Added support for dismissible announcement bar - Added Armenian, Lithuanian, Tagalog, and Urdu translations ### 8.3.9 July 4, 2022 { id="8.3.9" } - Updated Taiwanese translations for search - Allow ids for content tabs with special characters (for mkdocstrings) - Fixed #4083: home not clickable when using versioning (8.3.5 regression) ### 8.3.8 June 24, 2022 { id="8.3.8" } - Fixed #4053: Limit width of videos to content area - Fixed empty tags in front matter breaking search ### 8.3.7 June 22, 2022 { id="8.3.7" } - Fixed search being stuck initializing when using tags (8.3.4 regression) ### 8.3.6 June 16, 2022 { id="8.3.6" } - Fixed #4028: Links not clickable when using versioning (8.3.5 regression) ### 8.3.5 June 14, 2022 { id="8.3.5" } - Fixed #4012: Stay on page not working for alias of active version ### 8.3.4 June 11, 2022 { id="8.3.4" } - Fixed #4004: Tags with multiple words not searchable ### 8.3.3 June 7, 2022 { id="8.3.3" } - Fixed #4000: Mermaid diagrams too dark in dark mode (8.3.0 regression) ### 8.3.2 June 5, 2022 { id="8.3.2" } - Fixed #3987: Custom admonition icons don't work when defining color palette ### 8.3.1 June 4, 2022 { id="8.3.1" } - Bump required Jinja version to 3.0.2 - Removed unnecessary conditions in templates - Fixed scroll offset when content tabs are brought into view - Fixed #3977: Content tabs snapping oddly in Firefox - Fixed #3983: Missing condition in footer partial (8.3.0 regression) ### 8.3.0 June 2, 2022 { id="8.3.0" } - Added support for custom admonition icons - Added support for linking of content tabs - Added support for boosting pages in search - Added support for hiding footer navigation - Added previous/next indicators to content tabs - Improved typeset link colors in light and dark modes ### 8.2.16 May 28, 2022 { id="8.2.16" } - Fixed #3957: Only animate code annotations when visible (save CPU cycles) ### 8.2.15 May 14, 2022 { id="8.2.15" } - Added Uzbek translations - Fixed spacing for code block results in content tabs ### 8.2.14 May 8, 2022 { id="8.2.14" } - Fixed missing top right rounded border on admonition - Fixed #3886: `4xx` status codes not handled when using instant loading ### 8.2.13 May 2, 2022 { id="8.2.13" } - Fixed #3865: Tags index links to tagged pages 404 on Windows - Fixed #3866: Bump required Python version from 3.6+ to 3.7+ ### 8.2.12 April 30, 2022 { id="8.2.12" } - Added support for GitHub-style hash fragments for dark/light images - Improved rendering of nested code blocks in content tabs and annotations - Fixed #3862: Upgraded to latest Pygments and Python Markdown Extensions ### 8.2.11 April 25, 2022 { id="8.2.11" } - Temporarily pinned Pygments to `<2.12` - Temporarily pinned Python Markdown Extensions to `<9.4` - Improved rendering of code annotation markers ### 8.2.10 April 24, 2022 { id="8.2.10" } - Added Macedonian translations - Updated Mermaid.js to version 9.0.1 - Switched sidebar title in mobile navigation to bold font - Fixed color of arrows in class and state diagrams for dark mode - Fixed #3836: Inline admonitions overlayed by code block titles ### 8.2.9 April 8, 2022 { id="8.2.9" } - Mitigate flicker on color palette switch by disabling all transitions - Fixed search suggestions not triggered when following deep link - Fixed incorrectly computed header height when using instant loading - Fixed #3782: Admonition titles have extra pixels on wide screens in Firefox - Fixed #3802: Always render table of contents container (except when hidden) ### 8.2.8 March 27, 2022 { id="8.2.8" } - Bumped MkDocs version to 1.3.0 to mitigate breaking changes in Jinja - Reverted Jinja version range limitation (added in 8.2.7) - Improved styling of annotations and fixed borders of code blocks in tabs - Added background color to code blocks in focused/hovered links - Added check in tags plugin whether tags overview page exists - Fixed #3744: Content tab indicator on wrong position when using back button ### 8.2.7 March 24, 2022 { id="8.2.7" } - Temporarily limit Jinja version range to < 3.1 due to breaking changes ### 8.2.6 March 23, 2022 { id="8.2.6" } - Fixed #3695: Deprecation warning for unescaped backslashes in templates - Fixed #3696: Annotations not mounted in some Terraform code blocks - Fixed #3698: Annotations not mounted in long code blocks (8.2.5 regression) ### 8.2.5 March 6, 2022 { id="8.2.5" } - Fixed #3596: Mermaid not working when headline with name 'Mermaid' present - Fixed #3643: Reduce time to render pages with thousands of code blocks - Fixed #3665: Missing styles for Mermaid.js flowcharts cluster labels ### 8.2.4 March 2, 2022 { id="8.2.4" } - Fixed malformed Google Fonts URL when a font setting was omitted - Fixed #3648: Fixed specificity issue with admonitions in lists - Fixed #3653: Invalid outdated version banner URL when using instant loading ### 8.2.3 February 27, 2022 { id="8.2.3" } - Fixed #3578: Active element in table of contents off-by-one on large screens ### 8.2.2 February 26, 2022 { id="8.2.2" } - Added automatic removal of query parameter when search is closed - Fixed #3599: Anchors always overridden when using navigation tracking ### 8.2.1 February 17, 2022 { id="8.2.1" } - Fixed module `material.plugins` not being found (8.2.0 regression) ### 8.2.0 February 17, 2022 { id="8.2.0" } - Added native support for Mermaid.js diagrams - Added native support for tags (with search integration) - Added support for staying on page when switching versions ### 8.1.11 February 10, 2022 { id="8.1.11" } - Added Portuguese (Brasilian) translations - Updated FontAwesome to v6 – [check which icons were renamed here] - Fixed #3545: Color palette toggle and search overlaying version selector [check which icons were renamed here]: https://fontawesome.com/docs/web/setup/upgrade/whats-changed#icons-renamed-in-version-6 ### 8.1.10 February 6, 2022 { id="8.1.10" } - Fixed cutoff of very wide logos in the sidebar on mobile ### 8.1.9 January 30, 2022 { id="8.1.9" } - [Added support for `mkdocs.yml` validation and auto-complete][validation] - Fixed errors in Latvian translations [validation]: ../creating-your-site.md#minimal-configuration ### 8.1.8 January 23, 2022 { id="8.1.8" } - Added Latvian translations - Updated Giscus example integration with dynamic theme change support - Fixed #3479: Back-to-top button not hidden when using sticky navigation tabs - Fixed #3491: Logo in header and drawer doesn't honor aspect ratio ### 8.1.7 January 16, 2022 { id="8.1.7" } - Improved back-to-top button behavior - now not shown on anchor jump ### 8.1.6 January 11, 2022 { id="8.1.6" } - Fixed spacing of blockquotes (8.1.5 regression) - Fixed edge cases for rounded corners on code blocks (8.1.5 regression) - Fixed issues with code annotation line heights ### 8.1.5 January 9, 2022 { id="8.1.5" } - Improved browser support: Chrome 49+, Safari 10+, Firefox 53+, Edge 79+ - Improved rendering of inline code blocks in headlines - Added Bahasa Malaysian translations - Fixed #3354: MathJax formulas show vertical scrollbar ### 8.1.4 January 2, 2022 { id="8.1.4" } - Added indicator to navigation expander icon - Improved support for reduced motion preference - Fixed jitter of active content tab indicator ### 8.1.3 December 19, 2021 { id="8.1.3" } - Added animation to active content tab indicator - Fixed #3360: Highlighted lines add blank lines in copied text - Fixed usage of subsequent index files when using section index pages ### 8.1.2 December 15, 2021 { id="8.1.2" } - Switched CSS sources to logical properties - Added transformation of logical properties to `ltr`/`rtl` equivalents - Fixed spacing for admonitions inside lists (8.1.1 regression) ### 8.1.1 December 13, 2021 { id="8.1.1" } - Added support for `#only-light` and `#only-dark` image hash fragments - Fixed copy-to-clipboard adding blank lines when using line anchors - Fixed code annotation directionality for right-to-left languages - Fixed header title positioning for right-to-left languages - Fixed admonition borders for right-to-left languages (8.0.0 regression) - Fixed footer navigation link positioning (8.0.0 regression) - Fixed footer navigation title breaking out of container when too long - Fixed shrinking arrow in navigation title when too long - Fixed #3343: Filtered stopwords appear as missing search terms - Fixed #3346: Site unusable due to usage of `:not()` (Firefox 78 ESR) ### 8.1.0 December 10, 2021 { id="8.1.0" } - Added basic support for code block line anchors - Switched code annotation markers to `+` signs to improve usability - Switched main site title to bold font - Improved admonition icon positioning to align when `font-size` is increased - Improved and simplified footnotes CSS - Improved and simplified code annotation positioning - Fixed syntax error in Russian translations ### 8.0.5 December 6, 2021 { id="8.0.5" } - Fixed #3302: Footer refactoring induced ellipsis in some browsers - Fixed #3313: Details always rendered closed on load (8.0.4 regression) ### 8.0.4 December 4, 2021 { id="8.0.4" } - Improved support for deeply nested code annotations - Improved code annotation and copy-to-clipboard interop - Improved styling for code annotations inside admonitions - Fixed #3274: Invalid anchor positioning when using instant loading - Fixed #3294: Lists after code blocks without code annotations disappearing - Fixed several positioning issues for code annotations - Fixed JavaScript source map roots ### 8.0.3 December 2, 2021 { id="8.0.3" } - Removed deprecated `google_analytics` setting (was forgotten in 8.0.0) - Fixed syntax error in Swedish and Polish translations - Fixed #3283: Invalid back-to-top button position with sticky navigation tabs - Fixed #3285: Default details marker showing due to Safari bug ### 8.0.2 November 30, 2021 { id="8.0.2" } - Fixed #3275: Code annotations always disappear on click ### 8.0.1 November 28, 2021 { id="8.0.1" } - Improved rendering of code annotation markers - Fixed #3265: Wrong margin on nested admonitions - Fixed wrong `box-sizing` for code annotations in details ### 8.0.0 November 28, 2021 { id="8.0.0" } - Added support for code annotations - Added support for anchor tracking - Added support for version warning - Added `copyright` partial for easier override - Removed deprecated content tabs legacy implementation - Removed deprecated `seealso` admonition type - Removed deprecated `site_keywords` setting (unsupported by MkDocs) - Removed deprecated prebuilt search index support - Removed deprecated web app manifest – use customization - Removed `extracopyright` variable – use new `copyright` partial - Removed Disqus integation – use customization - Switched to `:is()` selectors for simple selector lists - Switched autoprefixer from `last 4 years` to `last 2 years` - Improved CSS overall to match modern standards - Improved CSS variable semantics for fonts - Improved extensibility by restructuring partials - Improved handling of `details` when printing - Improved keyboard navigation for footnotes - Fixed #3214: Search highlighting breaks site when empty --- ### 7.3.6 October 30, 2021 { id="7.3.6" } - Added support for adding titles to code blocks ### 7.3.5 October 27, 2021 { id="7.3.5" } - Added support for setting table of contents title via `mkdocs.yml` - Fixed back-to-top button position for right-to-left languages ### 7.3.4 October 17, 2021 { id="7.3.4" } - Bumped MkDocs version to 1.2.3 to mitigate [CVE-2021-40978] - Fixed spacing issues when using integrate table of contents with tabs - Fixed some spacings issues for right-to-left languages - Fixed race condition in search initialization [CVE-2021-40978]: https://nvd.nist.gov/vuln/detail/CVE-2021-40978 ### 7.3.3 October 11, 2021 { id="7.3.3" } - Rewrite of entire documentation - Adjusted height of new content tabs to match single line code blocks - Fixed new content tabs missing right padding in some browsers on overflow - Fixed new content tabs bleeding out of flex container on overflow - Fixed new content tabs overflow scrolling bugs on some browsers - Fixed new content tabs stealing keyboard access when active - Fixed some spacings issues for right-to-left languages ### 7.3.2 October 6, 2021 { id="7.3.2" } - Deprecated prebuilding of search index - Improved graceful handling of broken search for `file://` - Added minimum Jinja version to list of requirements - Fixed #3071: Section index pages render empty directories - Fixed margin issues when using navigation tabs (7.3.1 regression) - Fixed search placeholder sometimes being shown too early ### 7.3.1 October 2, 2021 { id="7.3.1" } - Added new experimental content tabs implementation - Fixed #3069: GitHub stats broken for users/orgs (7.1.0 regression) - Fixed #3070: Sections not linking to index page - Fixed title not linking to index page when using tabs - Fixed Disqus integration when using instant loading - Fixed some spacing issues for right-to-left languages - Fixed syntax error in Serbian translations ### 7.3.0 September 23, 2021 { id="7.3.0" } - Added support for sticky navigation tabs - Added support for section index pages - Added support for removing generator notice ### 7.2.8 September 20, 2021 { id="7.2.8" } - Fixed #3039: Search modal overlays menu on mobile (7.2.7 regression) ### 7.2.7 September 19, 2021 { id="7.2.7" } - Updated Serbian and Serbo-Croatian translations - Improved appearance of outline on details - Fixed #2934: Scrollbar when header is hidden on some mobile browsers - Fixed #3032: Anchor in details doesn't open on load (7.0.0 regression) - Fixed back-to-top button being focusable when invisible - Fixed broken admonition icons (removed in upstream) ### 7.2.6 September 1, 2021 { id="7.2.6" } - Fixed rendering of `blockquote` elements (7.0.0 regression) - Fixed #2973: Custom search worker setting ignored ### 7.2.5 August 25, 2021 { id="7.2.5" } - Updated Portuguese translations - Fixed execution of RxJS teardown logic (7.2.3 regression) - Fixed #2970: Search results show escaped characters (7.2.2 regression) ### 7.2.4 August 11, 2021 { id="7.2.4" } - Fixed #2926: Version selector not working (7.2.3 regression) - Fixed #2929: Missing CSS class for banner (consistency with Insiders) ### 7.2.3 August 9, 2021 { id="7.2.3" } - Slight facelift of data tables, now closer to Material Design - Fixed instant loading not respecting clicks on search results - Fixed #2881: Invalid anchor offsets when using instant loading ### 7.2.2 July 31, 2021 { id="7.2.2" } - Updated Korean translations - Fixed #2879: Search highlighting does not properly escape HTML ### 7.2.1 July 25, 2021 { id="7.2.1" } - Fixed #2862: Back-to-top button overlays active search bar ### 7.2.0 July 21, 2021 { id="7.2.0" } - Added support for search suggestions to save keystrokes - Added support for search highlighting - Added support for search sharing (i.e. deep linking) ### 7.1.11 July 18, 2021 { id="7.1.11" } - Updated Spanish and Galician translations ### 7.1.10 July 10, 2021 { id="7.1.10" } - Refactored appearance of back-to-top button - Fixed graceful handling of search when browsing locally ### 7.1.9 June 25, 2021 { id="7.1.9" } - Improved search language support for Thai and Hindi - Fixed #2761: License comments lined up at end of file ### 7.1.8 June 12, 2021 { id="7.1.8" } - Refactored analytics integration (because of MkDocs 1.2) - Added support for Google Analytics 4 (`gtag.js`) - Fixed missing escape for `aria-label` in footer links ### 7.1.7 June 6, 2021 { id="7.1.7" } - Improved screen reader support ### 7.1.6 May 30, 2021 { id="7.1.6" } - Deprecated `seealso` admonition qualifier - Added Mongolian and updated Chinese translations - Fixed #2429: Version selector not touch-friendly on Android devices - Fixed #2703: Printed 'Initializing search' albeit ready on mobile ### 7.1.5 May 19, 2021 { id="7.1.5" } - Fixed #2655: Details breaking page margins on print ### 7.1.4 May 6, 2021 { id="7.1.4" } - Added support for git-revision-date-localized plugin creation date - Improved footnote styles on `:target` and `:focus` ### 7.1.3 April 24, 2021 { id="7.1.3" } - Fixed #2586: Empty table of contents shown (7.1.2 regression) ### 7.1.2 April 18, 2021 { id="7.1.2" } - Fixed #2554: List markers sometimes overlap floated elements - Fixed #2563: Adding a class to a `h1` breaks the table of contents - Fixed #2566: Back-to-top button clickable when invisible ### 7.1.1 April 10, 2021 { id="7.1.1" } - Fixed #2501: Nested definition lists compound bottom margin - Fixed #2508: Switch `extracopyright` block to template variable - Fixed #2533: Search (and other parts) not working in Safari <14 - Fixed #2538: Visual quirk when opening language selector ### 7.1.0 March 29, 2021 { id="7.1.0" } - Added support for back-to-top button - Added support for color palette toggle - Added latest release to repository info (GitHub) - Slight facelift of repository info (lighter fonts, spacing and icons) ### 7.0.7 March 28, 2021 { id="7.0.7" } - Updated Hungarian translations - Fixed #2466: Docker image not based on latest Python and Alpine - Fixed #2488: Inconsistent header shadow behavior - Fixed #2492: Inline code blocks in admonition titles missing background ### 7.0.6 March 14, 2021 { id="7.0.6" } - Added trailing slash to version selector URL - Added support for out-of-order anchors in table of contents - Added `extra.homepage` option to link logo to arbitrary URL - Improved security of Docker image (always update apk) - Fixed horizontal spacing for nested inline admonitions - Fixed text color of nested code blocks inside links - Fixed version selector to always use version title - Fixed logo link when using versioning with instant loading ### 7.0.5 March 7, 2021 { id="7.0.5" } - Added `extracopyright` block to allow for custom copyright info - Fixed evaluation of third-party scripts when using instant loading - Fixed edge cases when using instant loading without directory URLs - Fixed handling of version selector when using instant loading - Fixed regression with header title not being updated correctly - Fixed expanded sections not opening on first click (7.0.4 regression) ### 7.0.4 March 4, 2021 { id="7.0.4" } - Added Icelandic translations - Fixed #2386: Section close requires two clicks (navigation expansion) - Fixed console error when search is disabled (7.0.0 regression) - Fixed localsearch integration (7.0.0 regression) ### 7.0.3 February 26, 2021 { id="7.0.3" } - Fixed JavaScript errors in older browsers (target ES2020 -> ES2015) ### 7.0.2 February 25, 2021 { id="7.0.2" } - Fixed #2343: Invalid source map URLs for JS and CSS files - Fixed #2347: Version selector missing when using versioning ### 7.0.1 February 24, 2021 { id="7.0.1" } - Fixed #2334: Google Analytics triggers page view twice (7.0.0 regression) - Fixed #2336: Details bleed into inline admonitions - Fixed #2337: Images don't align correctly (7.0.0 regression) ### 7.0.0 February 22, 2021 { id="7.0.0" } - Added support for deploying multiple versions - Added support for integrating a language selector - Added support for rendering admonitions as inline blocks - Rewrite of the underlying reactive architecture - Removed Webpack in favor of reactive build strategy (-480 dependencies) - Fixed keyboard navigation for code blocks after content tabs switch ### 6.2.8 February 4, 2021 { id="6.2.8" } - Updated Japanese and Polish translations - Fixed #2261: Print dialog auto-closing when using instant loading ### 6.2.7 January 31, 2021 { id="6.2.7" } - Fixed #2251: Updated Docker image to latest Alpine Linux ### 6.2.6 January 26, 2021 { id="6.2.6" } - Added Bulgarian translations - Fixed #2233: Search not shown when using header autohiding ### 6.2.5 January 17, 2021 { id="6.2.5" } - Fixed syntax error in Swedish translations - Optimized navigation partials to improve build speed for huge docs ### 6.2.4 January 9, 2021 { id="6.2.4" } - Fixed #2156: Missing syntax highlighting for binary numbers - Fixed #2186: Disqus showing on 404 page ### 6.2.3 December 27, 2020 { id="6.2.3" } - Added back hidden overflow on root container - Fixed #2142: MathJax formulas sometimes have vertical scrollbars ### 6.2.2 December 22, 2020 { id="6.2.2" } - Removed Markdown version range limit (6.2.0 regression) ### 6.2.1 December 22, 2020 { id="6.2.1" } - Fixed all import and asset paths in templates (6.2.0 regression) - Downgraded webpack-asset-manifest-plugin - broke all asset paths ### 6.2.0 December 22, 2020 { id="6.2.0" } - Added support for navigation sections - Added support for navigation expansion - Added support for integrating table of contents into navigation - Added support for autohiding header on scroll - Added support for hiding navigation and table of contents per page - Added support for arbitrary items in navigation tabs - Refactored navigation tabs to simplify grouping behavior - Fixed anchor offset for permalinks in Safari (partial revert) - Fixed #2098: Active tab sometimes not highlighted correctly - Improved appearance for horizontal rulers - Improved Spanish and Swedish translations ### 6.1.7 December 6, 2020 { id="6.1.7" } - Fixed #2081: Fixed stats for private GitHub repositories - Fixed alignment for admonition icon alignment for right-to-left languages ### 6.1.6 November 22, 2020 { id="6.1.6" } - Fixed #2048: Math formulas show scrollbars (Windows) ### 6.1.5 November 15, 2020 { id="6.1.5" } - Fixed search reset button not showing/hiding correctly ### 6.1.4 November 7, 2020 { id="6.1.4" } - Fixed sidebar jitter when scrolling footer into view ### 6.1.3 November 5, 2020 { id="6.1.3" } - Added support for keywords `meta` tag - Fixed #2027: Line numbers don't scale with smaller font size - Fixed link colors for black and white on `slate` color scheme - Removed focus outline on scrolling code blocks for pointer devices ### 6.1.2 October 31, 2020 { id="6.1.2" } - Fixed sizing of icons in admonitions, task lists, etc. (6.1.1 regression) ### 6.1.1 October 31, 2020 { id="6.1.1" } - Fixed #2019: Page title not correctly updated when using instant loading ### 6.1.0 October 17, 2020 { id="6.1.0" } - Fixed #1973: Added support for printing in dark mode - Fixed #1974: Added support for printing content tabs - Fixed #1995: Improved customizability of details extension ### 6.0.2 October 4, 2020 { id="6.0.2" } - Added Georgian translations - Added escaping for link `title` attributes where necessary - Fixed #1956: Pages with whitespace in names have invalid links in search - Removed unnecessary (duplicated) link `title` attributes ### 6.0.1 September 26, 2020 { id="6.0.1" } - Fixed stemmer support for `file://` protocol through `iframe-worker` - Fixed details marker showing for search result in Firefox - Fixed tabbing behavior when search query is not empty - Switched TypeScript compilation target to ES2015 - Reduced size of JavaScript by 30% (`176kb` → `124kb`) - Removed `mkdocs` and `readthedocs` themes from Docker image ### 6.0.0 September 25, 2020 { id="6.0.0" } - Improved search result look and feel - Improved search result stability while typing - Improved search result grouping (pages + headings) - Improved search result relevance and scoring - Added display of missing query terms to search results - Reduced size of vendor bundle by 25% (`84kb` → `67kb`) - Reduced size of the Docker image to improve CI build performance - Removed hero partial in favor of custom implementation - Removed deprecated front matter features --- ### 5.5.14 September 23, 2020 { id="5.5.14" } - Improved spacing around image captions - Fixed #1939: Long tables cause header overlap in print view ### 5.5.13 September 19, 2020 { id="5.5.13" } - Improved abbreviations on touch devices ### 5.5.12 August 31, 2020 { id="5.5.12" } - Fixed #1638: occasional `404` for images when using instant loading ### 5.5.11 August 28, 2020 { id="5.5.11" } - Fixed Disqus integration, as the minifier killed the config ### 5.5.10 August 28, 2020 { id="5.5.10" } - Improved rendering by moving Disqus integration after page load - Fixed #1887: Moved navigation icons to CSS to reduce size of HTML ### 5.5.9 August 26, 2020 { id="5.5.9" } - Added Esperanto translations - Fixed #1884: External links not included in navigation tabs ### 5.5.8 August 23, 2020 { id="5.5.8" } - Removed focus outline on `details` and content tabs for pointer devices - Improved accessibility of content tabs (now navigable via arrow keys) - Fixed #1877: `404` on search index when search is disabled - Fixed some memleaks in observable subscriptions - Fixed color definitions for `theme-color` meta tag ### 5.5.7 August 16, 2020 { id="5.5.7" } - Improved contrast ratio to 4.5:1 for syntax highlighting - Improved contrast ratio to 4.5:1 for table of contents ### 5.5.6 August 12, 2020 { id="5.5.6" } - Switched base template for `404.html` to `main.html` - Fixed #1864: GitHub organisation stats not loading ### 5.5.5 August 11, 2020 { id="5.5.5" } - Fixed missing vendor and worker distribution files ### 5.5.4 August 11, 2020 { id="5.5.4" } - Added support for sortable data tables ### 5.5.3 August 4, 2020 { id="5.5.3" } - Fixed search for languages other than English (5.5.1 regression) ### 5.5.2 August 3, 2020 { id="5.5.2" } - Improved highlight colors and spacing for `ins`, `del` and `mark` - Changed some keyboard symbols for better equivalents - Removed focus `outline` for details and code blocks on touch devices - Fixed margins for admonitions (5.5.1 regression) - Fixed too small content tab labels (5.5.1 regression) - Fixed icon repeating for custom admonition icons ### 5.5.1 August 1, 2020 { id="5.5.1" } - Improved typesetting by basing `font-size` and spacings on `em` - Improved print view by slightly scaling down `font-size` - Changed custom site title (metadata) to be suffixed with site name - Fixed top- and bottom spacing of paragraphs inside table cells ### 5.5.0 July 24, 2020 { id="5.5.0" } - Rewrite of entire documentation - Rewrite of syntax highlighting to be customizable with CSS variables - Improved syntax highlighting to work with light and dark theme - Improved `slate` color scheme to be more customizable and easier on the eyes - Added licenses of icon sets to distribution files - Fixed stale document titles in Google Analytics when using instant loading - Fixed width of previous and next footer links for tablet and above - Fixed issues with top scroll margin for footnotes - Fixed top margin for tabbed content when using a JavaScript highlighter - Deprecated metadata-based redirects, source links and heroes ### 5.4.0 June 29, 2020 { id="5.4.0" } - Added support to wrap searches in quotes to switch from `OR` to `AND` - Fixed highlighting of numbers in search results ### 5.3.3 June 24, 2020 { id="5.3.3" } - Added Bengali translations - Fixed #1773: Search for numbers does not return any result (regression) ### 5.3.2 June 21, 2020 { id="5.3.2" } - Improved search typeahead experience with non-Latin characters - Fixed #1753: Japanese search doesn't work anymore ### 5.3.1 June 20, 2020 { id="5.3.1" } - Fixed #1761: Duplication of search worker when subscribing to observable ### 5.3.0 June 15, 2020 { id="5.3.0" } - Added support for color schemes based on user preference - Fixed #1755: Tokenizer separator setting ignored ### 5.2.3 June 6, 2020 { id="5.2.3" } - Improved search typeahead behavior for some languages (`de`, `fr`, ...) - Improved styles for scrollbars on Firefox - Fixed #1741: Removed `preconnect` hint for Google Analytics ### 5.2.2 May 26, 2020 { id="5.2.2" } - Fixed #1728: Legacy Edge doesn't support `deg` values in `hsla` colors ### 5.2.1 May 22, 2020 { id="5.2.1" } - Fixed color of links in table headers, e.g. footnotes - Fixed color scheme not being applied without primary or accent color - Fixed hover delay for links inside code blocks ### 5.2.0 May 18, 2020 { id="5.2.0" } - Added color schemes implementation + dark mode - Fixed #1583: Missing option for separate link colors ### 5.1.7 May 16, 2020 { id="5.1.7" } - Added keyboard focus support for overflowing code blocks - Fixed #1696: Infinite loop in some cases when using instant loading ### 5.1.6 May 9, 2020 { id="5.1.6" } - Added Burmese translations - Added general anchor offset solution using `scroll-margin-top` - Fixed #1653: Instant loading shouldn't intercept links to `*.html` files ### 5.1.5 May 3, 2020 { id="5.1.5" } - Added `name` attribute for social links to set link `title` - Fixed #1623: Allow arbitrary links in social links - Fixed #1664: Height of `iframe` is not adjustable - Fixed #1667: Sidebars are scrolled to bottom on load (bug in Chrome 81+) ### 5.1.4 April 30, 2020 { id="5.1.4" } - Switched to [@mdi/svg] Material Design icon package - Fixed #1655: Navigation may disappear after switching viewports - Fixed #1659: Unnecessary scrollbar for search results on Windows - Fixed occasional distortions for images with explicit dimensions - Fixed errors in German translations [@mdi/svg]: https://github.com/Templarian/MaterialDesign-SVG ### 5.1.3 April 26, 2020 { id="5.1.3" } - Fixed overflowing content area after switch to flexbox ### 5.1.2 April 26, 2020 { id="5.1.2" } - Added status information to search observable - Added status information to search modal - Removed announcement bar from print media - Removed media query packing logic due to race conditions - Fixed #1520: Gracefully disable search on `file://` if Worker fails - Fixed re-submission of query after search is initialized - Fixed jitter of sidebars on all browsers by switching to `sticky` ### 5.1.1 April 17, 2020 { id="5.1.1" } - Added new FontAwesome icons - Fixed #1609: Instant loading doesn't honor `target=_blank` - Fixed GitHub stars count rounding errors - Fixed GitLab stars count retrieval ### 5.1.0 April 12, 2020 { id="5.1.0" } - Added support for icons from Markdown through [mkdocs-material-extensions] [mkdocs-material-extensions]: https://github.com/facelessuser/mkdocs-material-extensions ### 5.0.2 April 10, 2020 { id="5.0.2" } - Added CSS source maps to distribution files - Fixed errors in Chinese (Traditional) translations - Fixed creation of stale directory on installation from git - Improved overflow scrolling behavior on iOS (reduced bundle size by `4kb`) ### 5.0.1 April 7, 2020 { id="5.0.1" } - Fixed syntax error in Spanish translation ### 5.0.0 April 7, 2020 { id="5.0.0" } - Reactive architecture – try `app.dialog$.next("Hi!")` in the console - Instant loading – make Material behave like a Single Page Application - Improved CSS customization with CSS variables – set your brand's colors - Improved CSS resilience, e.g. proper sidebar locking for customized headers - Improved icon integration and configuration – now including over 5k icons - Added possibility to use any icon for logo, repository and social links - Search UI does not freeze anymore (moved to web worker) - Search index built only once when using instant loading - Improved extensible keyboard handling - Support for prebuilt search indexes - Support for displaying stars and forks for GitLab repositories - Support for scroll snapping of sidebars and search results - Reduced HTML and CSS footprint due to deprecation of Internet Explorer support - Slight facelifting of some UI elements (admonitions, tables, ...) ### 4.6.3 February 14, 2020 { id="4.6.3" } - Removed optional third-party plugins from `requirements.txt` - Updated Docker image to contain all supported third-party plugins ### 4.6.2 February 8, 2020 { id="4.6.2" } - Added Romanian translations - Fixed #1451: Inconsistent spacing for fenced code blocks ### 4.6.1 February 8, 2020 { id="4.6.1" } - Fixed #1324: Metadata author only rendering first character - Fixed #1393: Set `tabindex` to `0` for skip to content link - Fixed code blocks after Markdown 3.2 release - Fixed errors in Japanese translations - Improved Google Lighthouse score ### 4.6.0 December 11, 2019 { id="4.6.0" } - Added support for [git-revision-date-localized-plugin] - Fixed invalid character in Google Fonts URL [git-revision-date-localized-plugin]: https://github.com/timvink/mkdocs-git-revision-date-localized-plugin ### 4.5.1 December 2, 2019 { id="4.5.1" } - Added Thai translations - Fixed missing assets in GitHub release `.zip` and `.tar.gz` ### 4.5.0 November 16, 2019 { id="4.5.0" } - Fixed #1330: Upgraded EmojiOne to Tweomji due to licensing issues - Fixed #1339: Temporarily pinned PyMdown and Markdown due to - Fixed errors in Greek translations - Improved GitHub statistics retrieval ### 4.4.3 October 3, 2019 { id="4.4.3" } - Added Estonian translations - Fixed removal of copyright banners in minified JavaScript - Removed unnecessary title attributes from links in table of contents ### 4.4.2 August 27, 2019 { id="4.4.2" } - Added Afrikaans translations - Fixed broken page title when `h1` contained HTML tags - Improved accessibility for IE users - Removed unnecessary `title` attributes from links in navigation ### 4.4.1 August 22, 2019 { id="4.4.1" } - Added support for `black` as a primary color - Fixed broken footer bar when `h1` contained HTML tags ### 4.4.0 June 15, 2019 { id="4.4.0" } - Added Slovenian translations - Reverted template minification in favor of `mkdocs-minify-plugin` - Fixed #1114: Tabs don't reappear when default `font-size` is smaller than `16` ### 4.3.1 May 23, 2019 { id="4.3.1" } - Fixed spelling error in Danish translations ### 4.3.0 May 17, 2019 { id="4.3.0" } - Added support for changing header through metadata title property - Added `font-display: swap` to Google Font loading logic - Removed whitespace from templates, saving `4kb` (`.7kb` gzipped) per request - Fixed alignment of repository icons on tablet and desktop ### 4.2.0 April 28, 2019 { id="4.2.0" } - Added Norwegian (Nynorsk) translations - Fixed loss of focus in non-form input elements due to search hotkeys - Fixed #1067: Search hotkeys not working for mobile/tablet screensize - Fixed #1068: Search not correctly aligned for tablet screensize ### 4.1.2 April 16, 2019 { id="4.1.2" } - Fixed #1072: HTML tags appearing in navigation link titles ### 4.1.1 March 28, 2019 { id="4.1.1" } - Fixed minor CSS errors detected during validation ### 4.1.0 March 22, 2019 { id="4.1.0" } - Fixed #1023: Search for Asian languages broken after Lunr.js update - Fixed #1026: contenteditable elements loose focus on hotkeys ### 4.0.2 March 1, 2019 { id="4.0.2" } - Fixed #1012: HTML character entities appear in search result titles ### 4.0.1 February 13, 2019 { id="4.0.1" } - Fixed #762, #816: Glitch in sidebar when collapsing items - Fixed #869: Automatically expand details before printing ### 4.0.0 February 13, 2019 { id="4.0.0" } - Added background on hover for table rows - Removed Google Tag Manager and reverted to Google Analytics - Removed blocks in partials - Jinja doesn't support them - Fixed #911: Chrome breaks layout if system language is Chinese (**BREAKING**) - Fixed #976: Removed FastClick --- ### 3.3.0 January 29, 2019 { id="3.3.0" } - Moved Google Analytics integration into `head` using Google Tag Manager - Fixed #972: Unicode slugifier breaks table of contents blur on scroll - Fixed #974: Additional links in table of contents break blur on scroll ### 3.2.0 December 28, 2018 { id="3.2.0" } - Added support for redirects using metadata refresh - Fixed #921: Load Google Analytics snippet asynchronously ### 3.1.0 November 17, 2018 { id="3.1.0" } - Added support for Progressive Web App Manifest - Fixed #915: Search bug in Safari (upgraded Lunr.js) ### 3.0.6 October 26, 2018 { id="3.0.6" } - Added Taiwanese translations - Fixed #906: JavaScript code blocks evaluated in search results ### 3.0.5 October 23, 2018 { id="3.0.5" } - Added Croatian and Indonesian translations - Fixed #899: Skip-to-content link invalid from 2nd level on - Fixed #902: Missing URL filter in footer for FontAwesome link ### 3.0.4 September 3, 2018 { id="3.0.4" } - Updated Dutch translations - Fixed #856: Removed preconnect meta tag if Google Fonts are disabled ### 3.0.3 August 7, 2018 { id="3.0.3" } - Fixed #841: Additional path levels for extra CSS and JS ### 3.0.2 August 6, 2018 { id="3.0.2" } - Fixed #839: Lunr.js stemmer imports incorrect ### 3.0.1 August 5, 2018 { id="3.0.1" } - Fixed #838: Search result links incorrect ### 3.0.0 August 5, 2018 { id="3.0.0" } - Upgraded MkDocs to 1.0 (**BREAKING**) - Upgraded Python in official Docker image to 3.6 - Added Serbian and Serbo-Croatian translations --- ### 2.9.4 July 29, 2018 { id="2.9.4" } - Fixed build error after MkDocs upgrade ### 2.9.3 July 29, 2018 { id="2.9.3" } - Added link to home for logo in drawer - Fixed dependency problems between MkDocs and Tornado ### 2.9.2 June 29, 2018 { id="2.9.2" } - Added Hindi and Czech translations ### 2.9.1 June 18, 2018 { id="2.9.1" } - Added support for different spellings for theme color - Fixed #799: Added support for webfont minification in production - Fixed #800: Added `.highlighttable` as an alias for `.codehilitetable` ### 2.9.0 June 13, 2018 { id="2.9.0" } - Added support for theme color on Android - Fixed #796: Rendering of nested tabbed code blocks ### 2.8.0 June 10, 2018 { id="2.8.0" } - Added support for grouping code blocks with tabs - Added Material and FontAwesome icon fonts to distribution files (GDPR) - Added note on compliance with GDPR - Added Slovak translations - Fixed #790: Prefixed `id` attributes with `__` to avoid name clashes ### 2.7.3 April 26, 2018 { id="2.7.3" } - Added Finnish translations ### 2.7.2 April 9, 2018 { id="2.7.2" } - Fixed rendering issue for `details` on Edge ### 2.7.1 March 21, 2018 { id="2.7.1" } - Added Galician translations - Fixed #730: Scroll chasing error on home page if Disqus is enabled - Fixed #736: Reset drawer and search upon back button invocation ### 2.7.0 March 6, 2018 { id="2.7.0" } - Added ability to set absolute URL for logo - Added Hebrew translations ### 2.6.6 February 22, 2018 { id="2.6.6" } - Added preconnect for Google Fonts for faster loading - Fixed #710: With tabs sidebar disappears if JavaScript is not available ### 2.6.5 February 22, 2018 { id="2.6.5" } - Reverted `--dev-addr` flag removal from `Dockerfile` ### 2.6.4 February 21, 2018 { id="2.6.4" } - Added Catalan translations - Fixed incorrect margins for buttons in Firefox and Safari - Replaced package manager `yarn` with `npm 5.6` - Reverted GitHub stars rounding method - Removed `--dev-addr` flag from `Dockerfile` for Windows compatibility ### 2.6.3 February 18, 2018 { id="2.6.3" } - Added Vietnamese translations ### 2.6.2 February 12, 2018 { id="2.6.2" } - Added Arabic translations - Fixed incorrect rounding of amount of GitHub stars - Fixed double-layered borders for tables ### 2.6.1 February 11, 2018 { id="2.6.1" } - Added ability to override Disqus integration using metadata - Fixed #690: Duplicate slashes in source file URLs - Fixed #696: Active page highlight not working with default palette - Adjusted German translations ### 2.6.0 February 2, 2018 { id="2.6.0" } - Moved default search configuration to default translation (English) - Added support to automatically set text direction from translation - Added support to disable search stop word filter in translation - Added support to disable search trimmer in translation - Added Persian translations - Fixed support for Polish search - Fixed disappearing GitHub, GitLab and Bitbucket repository icons ### 2.5.5 January 31, 2018 { id="2.5.5" } - Added Hungarian translations ### 2.5.4 January 29, 2018 { id="2.5.4" } - Fixed #683: `gh-deploy` fails inside Docker ### 2.5.3 January 25, 2018 { id="2.5.3" } - Added Ukrainian translations ### 2.5.2 January 22, 2018 { id="2.5.2" } - Added default search language mappings for all localizations - Fixed #673: Error loading non-existent search language - Fixed #675: Uncaught reference error when search plugin disabled ### 2.5.1 January 20, 2018 { id="2.5.1" } - Fixed permalink for main headline - Improved missing translation handling with English as a fallback - Improved accessibility with skip-to-content link ### 2.5.0 January 13, 2018 { id="2.5.0" } - Added support for right-to-left languages ### 2.4.0 January 11, 2018 { id="2.4.0" } - Added focus state for clipboard buttons - Fixed #400: Search bar steals tab focus - Fixed search not closing on ++enter++ when result is selected - Fixed search not closing when losing focus due to ++tab++ - Fixed collapsed navigation links getting focus - Fixed `outline` being cut off on ++tab++ focus of navigation links - Fixed bug with first search result navigation being ignored - Removed search result navigation via ++tab++ (use ++up++ and ++down++) - Removed `outline` resets for links - Improved general tabbing behavior on desktop ### 2.3.0 January 9, 2018 { id="2.3.0" } - Added `example` (synonym: `snippet`) style for admonitions - Added synonym `abstract` for `summary` style for admonitions ### 2.2.6 December 27, 2017 { id="2.2.6" } - Added Turkish translations - Fixed unclickable area below header in case JavaScript is not available ### 2.2.5 December 18, 2017 { id="2.2.5" } - Fixed #639: Broken default favicon ### 2.2.4 December 18, 2017 { id="2.2.4" } - Fixed #638: Build breaks with Jinja < 2.9 ### 2.2.3 December 13, 2017 { id="2.2.3" } - Fixed #630: Admonition sets padding on any last child - Adjusted Chinese (Traditional) translations ### 2.2.2 December 8, 2017 { id="2.2.2" } - Added Dutch translations - Adjusted targeted link and footnote offsets - Simplified admonition styles and fixed padding bug ### 2.2.1 December 2, 2017 { id="2.2.1" } - Fixed #616: Minor styling error with title-only admonitions - Removed border for table of contents and improved spacing ### 2.2.0 November 22, 2017 { id="2.2.0" } - Added support for hero teaser - Added Portuguese translations - Fixed #586: Footnote backref target offset regression - Fixed #605: Search stemmers not correctly loaded ### 2.1.1 November 21, 2017 { id="2.1.1" } - Replaced deprecated `babel-preset-es2015` with `babel-preset-env` - Refactored Gulp build pipeline with Webpack - Removed right border on sidebars - Fixed broken color transition on header ### 2.1.0 November 19, 2017 { id="2.1.0" } - Added support for `white` as a primary color - Added support for sliding site name and title - Fixed redundant clipboard button when using line numbers on code blocks - Improved header appearance by making it taller - Improved tabs appearance - Improved CSS customizability by leveraging inheritance - Removed scroll shadows via `background-attachment` ### 2.0.4 November 5, 2017 { id="2.0.4" } - Fixed `details` not opening with footnote reference ### 2.0.3 November 5, 2017 { id="2.0.3" } - Added Japanese translations - Fixed #540: Jumping to anchor inside `details` doesn't open it - Fixed active link colors in footer ### 2.0.2 November 1, 2017 { id="2.0.2" } - Added Russian translations - Fixed #542: Horizontal scrollbar between `1220px` and `1234px` - Fixed #553: Metadata values only rendering first character - Fixed #558: Flash of unstyled content - Fixed favicon regression caused by deprecation upstream ### 2.0.1 October 31, 2017 { id="2.0.1" } - Fixed error when initializing search - Fixed styles for link to edit the current page - Fixed styles on nested admonition in details ### 2.0.0 October 31, 2017 { id="2.0.0" } - Upgraded MkDocs to 0.17.1 (__BREAKING__) - Added support for easier configuration of search tokenizer - Added support to disable search - Added Korean translations --- ### 1.12.2 October 26, 2017 { id="1.12.2" } - Added Italian, Norwegian, French and Chinese translations ### 1.12.1 October 22, 2017 { id="1.12.1" } - Added Polish, Swedish and Spanish translations - Improved downward compatibility with custom partials - Temporarily pinned MkDocs version within Docker image to 0.16.3 - Fixed #519: Missing theme configuration file ### 1.12.0 October 20, 2017 { id="1.12.0" } - Added support for setting language(s) via `mkdocs.yml` - Added support for default localization - Added German and Danish translations - Fixed #374: Search bar misalignment on big screens ### 1.11.0 October 19, 2017 { id="1.11.0" } - Added localization to clipboard - Refactored localization logic ### 1.10.4 October 18, 2017 { id="1.10.4" } - Improved print styles of code blocks - Improved search UX (don't close on enter if no selection) - Fixed #495: Vertical scrollbar on short pages ### 1.10.3 October 11, 2017 { id="1.10.3" } - Fixed #484: Vertical scrollbar on some MathJax formulas - Fixed #483: Footnote backref target offset regression ### 1.10.2 October 6, 2017 { id="1.10.2" } - Fixed #468: Sidebar shows scrollbar if content is shorter (in Safari) ### 1.10.1 September 14, 2017 { id="1.10.1" } - Fixed #455: Bold code blocks rendered with normal font weight ### 1.10.0 September 1, 2017 { id="1.10.0" } - Added support to make logo default icon configurable - Fixed uninitialized overflow scrolling on main pane for iOS - Fixed error in mobile navigation in case JavaScript is not available - Fixed incorrect color transition for nested panes in mobile navigation - Improved checkbox styles for Tasklist from PyMdown Extension package ### 1.9.0 August 29, 2017 { id="1.9.0" } - Added `info` (synonym: `todo`) style for admonitions - Added `question` (synonym: `help`, `faq`) style for admonitions - Added support for Details from PyMdown Extensions package - Improved admonition styles to match details - Improved styles for social links in footer - Replaced ligatures with Unicode code points to avoid broken layout - Upgraded PyMdown Extensions package dependency to >= 3.4 ### 1.8.1 August 7, 2017 { id="1.8.1" } - Fixed #421: Missing pagination for GitHub API ### 1.8.0 August 2, 2017 { id="1.8.0" } - Added support for lazy-loading of search results for better performance - Added support for customization of search tokenizer/separator - Fixed #424: Search doesn't handle capital letters anymore - Fixed #419: Search doesn't work on whole words ### 1.7.5 July 25, 2017 { id="1.7.5" } - Fixed #398: Forms broken due to search shortcuts - Improved search overall user experience - Improved search matching and highlighting - Improved search accessibility ### 1.7.4 June 21, 2017 { id="1.7.4" } - Fixed functional link colors in table of contents for active palette - Fixed #368: Compatibility issues with IE11 ### 1.7.3 June 7, 2017 { id="1.7.3" } - Fixed error when setting language to Japanese for site search ### 1.7.2 June 6, 2017 { id="1.7.2" } - Fixed offset of search box when `repo_url` is not set - Fixed non-disappearing tooltip ### 1.7.1 June 1, 2017 { id="1.7.1" } - Fixed wrong `z-index` order of header, overlay and drawer - Fixed wrong offset of targeted footnote back references ### 1.7.0 June 1, 2017 { id="1.7.0" } - Added "copy to clipboard" buttons to code blocks - Added support for multilingual site search - Fixed search term highlighting for non-latin languages ### 1.6.4 May 24, 2017 { id="1.6.4" } - Fixed #337: JavaScript error for GitHub organization URLs ### 1.6.3 May 16, 2017 { id="1.6.3" } - Fixed #329: Broken source stats for private or unknown GitHub repos ### 1.6.2 May 15, 2017 { id="1.6.2" } - Fixed #316: Fatal error for git clone on Windows - Fixed #320: Chrome 58 creates double underline for `abbr` tags - Fixed #323: Ligatures rendered inside code blocks - Fixed miscalculated sidebar height due to missing margin collapse - Changed deprecated MathJax CDN to Cloudflare ### 1.6.1 April 23, 2017 { id="1.6.1" } - Fixed following of active/focused element if search input is focused - Fixed layer order of search component elements ### 1.6.0 April 22, 2017 { id="1.6.0" } - Added build test for Docker image on Travis - Added search overlay for better user experience (focus) - Added language from localizations to `html` tag - Fixed #270: source links broken for absolute URLs - Fixed missing top spacing for first targeted element in content - Fixed too small footnote divider when using larger font sizes ### 1.5.5 April 20, 2017 { id="1.5.5" } - Fixed #282: Browser search (Meta+F) is hijacked ### 1.5.4 April 8, 2017 { id="1.5.4" } - Fixed broken highlighting for two or more search terms - Fixed missing search results when only a `h1` is present - Fixed unresponsive overlay on Android ### 1.5.3 April 7, 2017 { id="1.5.3" } - Fixed deprecated calls for template variables - Fixed wrong palette color for focused search result - Fixed JavaScript errors on 404 page - Fixed missing top spacing on 404 page - Fixed missing right spacing on overflow of source container ### 1.5.2 April 5, 2017 { id="1.5.2" } - Added requirements as explicit dependencies in `setup.py` - Fixed non-synchronized transitions in search form ### 1.5.1 March 30, 2017 { id="1.5.1" } - Fixed rendering and offset of targeted footnotes - Fixed #238: Link on logo is not set to `site_url` ### 1.5.0 March 24, 2017 { id="1.5.0" } - Added support for localization of search placeholder - Added keyboard events for quick access of search - Added keyboard events for search control - Added opacity on hover for search buttons - Added git hook to skip CI build on non-src changes - Fixed non-resetting search placeholder when input is cleared - Fixed error for unescaped parentheses in search term - Fixed #229: Button to clear search missing - Fixed #231: Escape key doesn't exit search - Removed old-style figures from font feature settings ### 1.4.1 March 16, 2017 { id="1.4.1" } - Fixed invalid destructuring attempt on NodeList (in Safari, Edge, IE) ### 1.4.0 March 16, 2017 { id="1.4.0" } - Added support for grouping searched sections by documents - Added support for highlighting of search terms - Added support for localization of search results - Fixed #216: table of contents icon doesn't show if `h1` is not present - Reworked style and layout of search results for better usability ### 1.3.0 March 11, 2017 { id="1.3.0" } - Added support for page-specific title and description using metadata - Added support for linking source files to documentation - Fixed jitter and offset of sidebar when zooming browser - Fixed incorrectly initialized tablet sidebar height - Fixed regression for #1: GitHub stars break if `repo_url` ends with a `/` - Fixed undesired white line below copyright footer due to base font scaling - Fixed issue with whitespace in path for scripts - Fixed #205: support non-fixed (static) header - Refactored footnote references for better visibility - Reduced repaints to a minimum for non-tabs configuration - Reduced contrast of edit button (slightly) ### 1.2.0 March 3, 2017 { id="1.2.0" } - Added `quote` (synonym: `cite`) style for admonitions - Added help message to build pipeline - Fixed wrong navigation link colors when applying palette - Fixed #197: Link missing in tabs navigation on deeply nested items - Removed unnecessary dev dependencies ### 1.1.1 February 26, 2017 { id="1.1.1" } - Fixed incorrectly displayed nested lists when using tabs ### 1.1.0 February 26, 2017 { id="1.1.0" } - Added tabs navigation feature (optional) - Added Disqus integration (optional) - Added a high resolution Favicon with the new logo - Added static type checking using Facebook's Flow - Fixed #173: Dictionary elements have no bottom spacing - Fixed #175: Tables cannot be set to 100% width - Fixed race conditions in build related to asset revisioning - Fixed accidentally re-introduced Permalink on top-level headline - Fixed alignment of logo in drawer on IE11 - Refactored styles related to tables - Refactored and automated Docker build and PyPI release - Refactored build scripts ### 1.0.5 February 18, 2017 { id="1.0.5" } - Fixed #153: Sidebar flows out of constrained area in Chrome 56 - Fixed #159: Footer jitter due to JavaScript if content is short ### 1.0.4 February 16, 2017 { id="1.0.4" } - Fixed #142: Documentation build errors if `h1` is defined as raw HTML - Fixed #164: PyPI release does not build and install - Fixed offsets of targeted headlines - Increased sidebar font size by `0.12rem` ### 1.0.3 January 22, 2017 { id="1.0.3" } - Fixed #117: Table of contents items don't blur on fast scrolling - Refactored sidebar positioning logic - Further reduction of repaints ### 1.0.2 January 15, 2017 { id="1.0.2" } - Fixed #108: Horizontal scrollbar in content area ### 1.0.1 January 14, 2017 { id="1.0.1" } - Fixed massive repaints happening when scrolling - Fixed footer back reference positions in case of overflow - Fixed header logo from showing when the menu icon is rendered - Changed scrollbar behavior to only show when content overflows ### 1.0.0 January 13, 2017 { id="1.0.0" } - Introduced Webpack for more sophisticated JavaScript bundling - Introduced ESLint and Stylelint for code style checks - Introduced more accurate Material Design colors and shadows - Introduced modular scales for harmonic font sizing - Introduced git-hooks for better development workflow - Rewrite of CSS using the BEM methodology and SassDoc guidelines - Rewrite of JavaScript using ES6 and Babel as a transpiler - Rewrite of Admonition, Permalinks and CodeHilite integration - Rewrite of the complete typographical system - Rewrite of Gulp asset pipeline in ES6 and separation of tasks - Removed Bower as a dependency in favor of NPM - Removed custom icon build in favor of the Material Design icon set - Removed `_blank` targets on links due to vulnerability: http://bit.ly/1Mk2Rtw - Removed unversioned assets from build directory - Restructured templates into base templates and partials - Added build and watch scripts in `package.json` - Added support for Metadata and Footnotes Markdown extensions - Added support for PyMdown Extensions package - Added support for collapsible sections in navigation - Added support for separate table of contents - Added support for better accessibility through REM-based layout - Added icons for GitHub, GitLab and BitBucket integrations - Added more detailed documentation on specimen, extensions etc. - Added a `404.html` error page for deployment on GitHub Pages - Fixed live reload chain in watch mode when saving a template - Fixed variable references to work with MkDocs 0.16 --- ### 0.2.4 June 26, 2016 { id="0.2.4" } - Fixed improperly set default favicon - Fixed #33: Protocol relative URL for webfonts doesn't work with `file://` - Fixed #34: IE11 on Windows 7 doesn't honor `max-width` on `main` tag - Fixed #35: Add styling for blockquotes ### 0.2.3 May 16, 2016 { id="0.2.3" } - Fixed #25: Highlight inline fenced blocks - Fixed #26: Better highlighting for keystrokes - Fixed #30: Suboptimal syntax highlighting for PHP ### 0.2.2 March 20, 2016 { id="0.2.2" } - Fixed #15: Document Pygments dependency for CodeHilite - Fixed #16: Favicon could not be set through `mkdocs.yml` - Fixed #17: Put version into own container for styling - Fixed #20: Fix rounded borders for tables ### 0.2.1 March 12, 2016 { id="0.2.1" } - 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 { id="0.2.0" } - Fixed #6: Include multiple color palettes via `mkdocs.yml` - Fixed #7: Better colors for links inside admonition notes and warnings - Fixed #9: Text for prev/next footer navigation should be customizable - Refactored templates (replaced `if`/`else` with modifiers where possible) ### 0.1.3 February 21, 2016 { id="0.1.3" } - Fixed #3: Ordered lists within an unordered list have `::before` content - Fixed #4: Click on Logo/Title without Github-Repository: `"None"` - Fixed #5: Page without headlines renders empty list in table of contents - Moved Modernizr to top to ensure basic usability in IE8 ### 0.1.2 February 16, 2016 { id="0.1.2" } - Fixed styles for deep navigational hierarchies - Fixed webfont delivery problem when hosted in subdirectories - Fixed print styles in mobile/tablet configuration - Added option to configure fonts in `mkdocs.yml` with fallbacks - Changed styles for admonition notes and warnings - Set download link to latest version if available - Set up tracking of outgoing links and actions for Google Analytics ### 0.1.1 February 11, 2016 { id="0.1.1" } - Fixed #1: GitHub stars don't work if the repo_url ends with a `/` - Updated NPM and Bower dependencies to most recent versions - Changed footer/copyright link to Material theme to GitHub pages - Made MkDocs building/serving in build process optional - Set up continuous integration with Travis ### 0.1.0 February 9, 2016 { id="0.1.0" } - Initial release