88 KiB
Changelog
Material for MkDocs
9.5.18 April 16, 2024
- Refactored tooltips implementation to fix positioning issues
- Fixed #7044: Rendering glitch when hovering contributor avatar in Chrome
- Fixed #7043: Highlighted lines in code blocks cutoff on mobile
- Fixed #6910: Incorrect position of tooltip for page status in sidebar
- Fixed #6760: Incorrect position and overly long tooltip in tables
- Fixed #6488: Incorrect position and cutoff tooltip in content tabs
9.5.17 April 2, 2024
- Updated Serbian translations
- Fixed #7003: Confusing keyboard interaction for palette toggle
- Fixed #7001: Blog posts now show time by default (9.5.16 regression)
- Fixed edge case in backport of social plugin font loading logic
9.5.16 March 31, 2024
- Updated Russian translations
- Improved error handling and reporting in social plugin
- Improved error handling and reporting in privacy plugin
- Fixed blog plugin not allowing to use time in format strings
- Fixed #6983: Social plugin crashes because of Google Fonts API change
9.5.15 March 23, 2024
- Reverted fix for transparent iframes (9.5.14)
- Fixed #6929: Interference of social plugin and auto dark mode
- Fixed #6938: Giscus shows dark background in light mode (9.5.14 regression)
9.5.14 March 18, 2024
- Added support for hiding versions from selector when using mike
- Added init system to improve signal handling in Docker image
- Fixed edge cases in exclusion logic of info plugin
- Fixed inability to reset pipeline in search plugin
- Fixed syntax error in Finnish translations
- Fixed #6917: UTF-8 encoding problems in blog plugin on Windows
- Fixed #6889: Transparent iframes get background color
9.5.13 March 6, 2024
- Updated Slovak translations
- Improved info plugin interop with projects plugin
- Improved info plugin inclusion/exclusion logic
- Fixed info plugin not gathering files recursively
- Fixed #6750: Ensure info plugin packs up all necessary files
9.5.12 February 29, 2024
- Fixed #6846: Some meta tags removed on instant navigation (9.4.2 regression)
- Fixed #6823: KaTex not rendering on instant navigation (9.5.5 regression)
- Fixed #6821: Privacy plugin doesn't handle URLs with encoded characters
9.5.11 February 24, 2024
- Updated Finnish translation
9.5.10 February 19, 2024
- Updated Bahasa Malaysia translations
- Fixed #6783: Hide continue reading link for blog posts without separators
- Fixed #6779: Incorrect positioning of integrated table of contents
9.5.9 February 10, 2024
- Fixed navigation pruning with tabs and sections enabled
9.5.8 February 7, 2024
- Added Tamil translations
- Updated Esperanto translations
- Fixed relative images not being resolved for instant navigation
9.5.7 February 3, 2024
- Fixed #6731: Small images in figures are not centered
- Fixed #6719: Instant navigation breaks table of contents (9.5.5 regression)
9.5.6 January 28, 2024
- Fixed #6700: Missing styles for Mermaid.js labels with Markdown
9.5.5 January 24, 2024
- Updated Tagalog translations
- Updated Pillow to 10.2 to mitigate security vulnerabilities
- Improved resilience of instant navigation
- Fixed #6687: Updated Mermaid.js to version 10.7.0 (latest)
- Fixed #6652: Keyboard events in custom elements captured
- Fixed #6582: Instant navigation doesn't correctly handle alternate URLs
- Fixed #6565: Instant navigation doesn't allow for
onclick
handlers - Fixed #6345: Instant navigation sometimes breaks browser back button
- Fixed #6334: Instant navigation doesn't correctly position anchors (Safari)
- Fixed #6275: Instant navigation doesn't correctly resolve after 404
- Fixed #6102: Instant navigation reloads page on same link navigation
9.5.4 January 15, 2024
- Fixed #6645: Local storage with invalid value can break site
- Fixed #6635: Tags icons before default ignored if default is set
9.5.3 December 23, 2023
- Limited version range of MkDocs to < 1.6
- Updated Macedonian translations
- Fixed #6520: Group plugin crashes when using mike
- Fixed #6494: Hide author's email address if disabled in git-authors plugin
9.5.2 December 11, 2023
- Fixed types for
slugify
settings in blog plugin config - Fixed #6469: Horizontal scrollbars on MathJax containers
9.5.1 December 8, 2023
- Updated Greek translations
- Fixed #6464: Privacy plugin cannot be enabled
- Fixed #6461: Sorting blog posts ignores time component in date
9.5.0 December 7, 2023
Merged Insiders features of 'Goat's Horn' funding goal
- Added privacy plugin: automatic downloading of external assets
- Added support for card grids and grid layouts
- Added support for improved tooltips
- Added support for content tabs anchor links (deep linking)
- Added support for automatic dark/light mode
- Added support for document contributors
9.4.14 November 26, 2023
- Added support for linking authors in blog posts
9.4.13 November 26, 2023
- Fixed #6365: Blog plugin pagination links to previous pages broken
- Fixed #5758: Updated Mermaid.js to version 10.6.1 (latest)
9.4.12 November 24, 2023
- Improved blog plugin to generate Unicode-aware slugs by default
- Fixed non-deterministic order of categories in blog plugin
9.4.11 November 23, 2023
- Fixed #6364: Search plugin crashing when enabling theme while serving
- Fixed blog plugin crashing when disabling pagination
9.4.10 November 19, 2023
- Fixed #6356: Version selector can't be disabled via mike's configuration
- Fixed #6281: Navigation not rendering due to Safari bug (9.4.2 regression)
- Fixed #6261: Navigation expansion animates on first load (9.4.2 regression)
9.4.9 November 17, 2023
- Fixed #6344: Long entries cutoff in table of contents
- Fixed #6336: Custom template for glob archive not working with pagination
- Fixed #6328: Blog plugin crashes for locales with dashes, e.g.
pt-BR
- Fixed #6327: Copy-to-clipboard button doesn't trim trailing line feed
- Fixed #6302: Version strings not matched when using mike, only aliases
- Fixed instant navigation progress indicator for gzipped content in Chrome
- Fixed rendering bug on details marker rotation in Firefox
9.4.8 November 5, 2023
- Fixed invalid local address replacement when using instant loading
- Fixed #6275: Crash after navigation caused 404 when using instant loading
9.4.7 October 27, 2023
- Added Azerbaijani translations
9.4.6 October 14, 2023
- Updated Danish and Norwegian (Nynorsk) translations
- Fixed #6169: Blog post metadata layout overflows on small screens
9.4.5 October 10, 2023
- Fixed sidebar auto-positioning (9.4.2 regression)
- Fixed #6166: Improve group plugin compatibility with Python < 3.10
- Fixed #6157: Hiding tags does not work (9.4.3 regression)
9.4.4 October 5, 2023
- Added support for overriding text to be copied for code blocks
- Fixed broken layout in some browsers at breakpoints when using zoom
- Fixed #6132: Incomplete search highlighting for code blocks in titles
9.4.3 October 2, 2023
- Added support for instant navigation progress indicator
- Improved spacing and alignment of tags
- Moved back-to-top button into separate partial
- Fixed #6104: Indentation for some code blocks lost in search
- Fixed #6094: Blog post metadata overlaps with footer on small screens
- Fixed #6069: Blog plugin crashes for categories with non-ASCII names
Updated templates (diff)
base.html
9.4.2 September 25, 2023
- Updated Slovenian translations
- Added animation to sidebar navigation expansion and collapse
- Added support for auto-replacement of document head for instant navigation
- Improved compatibility of new emoji extension with Python < 3.10
- Switched regex dependency to use minimal version
- Refactored alignment and spacing of sidebar navigation
- Fixed expansion button not focusable via keyboard in sidebar navigation
- Fixed viewport offset restoration on first load when using instant navigation
- Fixed accidental highlight of non-clickable elements in blog plugin sidebar
- Fixed #6041: Blog plugin crashes when
nav
is defined and blog not included - Fixed #5972: Blog plugin ignores section index pages in paginated views
- Fixed #5954: Repeated click on anchor ignored when using instant navigation
- Fixed #5742: Keyboard navigation broken when using instant navigation
Updated templates (diff)
partials/nav-item.html
blog-post.html
9.4.1 September 22, 2023
- Improved colors and contrast in dark mode
- Improved admonition borders to match font weight
- Switched content tabs to neutral color
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
andlxml
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
andArray.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 inmkdocs.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
andcards_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
andstyle
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
andarm/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
- Let it snow, see https://twitter.com/squidfunk/status/1597939243090788352
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
orblack
- 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
-
Added Portuguese (Brasilian) translations
-
Updated FontAwesome to v6 – check which icons were renamed here
-
Fixed #3545: Color palette toggle and search overlaying version selector
8.1.10 February 6, 2022
- Fixed cutoff of very wide logos in the sidebar on mobile
8.1.9 January 30, 2022
-
Fixed errors in Latvian translations
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 newcopyright
partial - Removed Disqus integration – use customization
- Switched to
:is()
selectors for simple selector lists - Switched autoprefixer from
last 4 years
tolast 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 throughiframe-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
andreadthedocs
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% (
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
- 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
tomain.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
andmark
- 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 onem
- 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
toAND
- 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 inhsla
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 linktitle
- 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
-
Added support for icons from Markdown through mkdocs-material-extensions
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
to0
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
-
Added support for git-revision-date-localized-plugin
-
Fixed invalid character in Google Fonts URL
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 than16
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 fromDockerfile
2.6.4 February 21, 2018
- Added Catalan translations
- Fixed incorrect margins for buttons in Firefox and Safari
- Replaced package manager
yarn
withnpm 5.6
- Reverted GitHub stars rounding method
- Removed
--dev-addr
flag fromDockerfile
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
forsummary
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
withbabel-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
and1234px
- 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
onmain
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