mirror of
https://github.com/squidfunk/mkdocs-material.git
synced 2024-06-14 11:52:32 +03:00
Documentation
This commit is contained in:
squidfunk
parent
7e56e38810
commit
c2897de547
@ -3,7 +3,7 @@
|
||||
Material for MkDocs is an actively maintained project that we constantly strive
|
||||
to improve. With a project of this size and complexity, bugs may occur. If you
|
||||
think you have discovered a bug, you can help us by submitting an issue in our
|
||||
public [issue tracker].
|
||||
public [issue tracker], following this guide.
|
||||
|
||||
[issue tracker]: https://github.com/squidfunk/mkdocs-material/issues
|
||||
|
||||
@ -311,5 +311,5 @@ __We'll take it from here.__
|
||||
|
||||
Please understand, that we reserve us the right to close incomplete issues which
|
||||
do not contain minimal reproductions, or do not adhere to the quality standards
|
||||
and requirements mentioned in this document. We will try our best to help you
|
||||
improve your bug report in the comments.
|
||||
and requirements mentioned in this document. Issues can be reopened, when the
|
||||
missing information has been provided.
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@ -2,29 +2,29 @@
|
||||
|
||||
## Material for MkDocs Insiders
|
||||
|
||||
### 4.27.0 <small>_ December 20, 2022</small> { id="4.27.0" }
|
||||
### 4.27.0 <small>December 20, 2022</small> { id="4.27.0" }
|
||||
|
||||
- Added built-in typeset plugin to preserve formatting in sidebars
|
||||
- Added URL and table of contents support for blog categories
|
||||
|
||||
### 4.26.6 <small>_ November 28, 2022</small> { id="4.26.6" }
|
||||
### 4.26.6 <small>November 28, 2022</small> { id="4.26.6" }
|
||||
|
||||
- Fixed #4683: Tags plugin crashes when a tag is empty
|
||||
|
||||
### 4.26.5 <small>_ November 27, 2022</small> { id="4.26.5" }
|
||||
### 4.26.5 <small>November 27, 2022</small> { id="4.26.5" }
|
||||
|
||||
- Fixed #4632: Post excerpt title link doesn't point to top of the page
|
||||
|
||||
### 4.26.4 <small>_ November 27, 2022</small> { id="4.26.4" }
|
||||
### 4.26.4 <small>November 27, 2022</small> { id="4.26.4" }
|
||||
|
||||
- Fixed redundant file extension when using privacy plugin
|
||||
|
||||
### 4.26.3 <small>_ November 15, 2022</small> { id="4.26.3" }
|
||||
### 4.26.3 <small>November 15, 2022</small> { id="4.26.3" }
|
||||
|
||||
- Fixed #4637: Attachments w/o titles in related links error in blog plugin
|
||||
- Fixed #4631: Remote favicons not downloaded and inlined by privacy plugin
|
||||
|
||||
### 4.26.2 <small>_ November 3, 2022</small> { id="4.26.2" }
|
||||
### 4.26.2 <small>November 3, 2022</small> { id="4.26.2" }
|
||||
|
||||
- Updated MkDocs to 1.4.2
|
||||
- Added support for tag compare functions when sorting on index pages
|
||||
@ -36,59 +36,59 @@
|
||||
- Fixed #4542: Blog plugin doesn't allow for multiple instances
|
||||
- Fixed #4532: Blog plugin doesn't allow for mixed use of date and datetime
|
||||
|
||||
### 4.26.1 <small>_ October 22, 2022</small> { id="4.26.1" }
|
||||
### 4.26.1 <small>October 22, 2022</small> { id="4.26.1" }
|
||||
|
||||
- Improved reporting of configuration errors in tags plugin
|
||||
- Fixed #4515: Privacy plugin fails when site URL is not defined
|
||||
- Fixed #4514: Privacy plugin doesn't fetch Google fonts (4.26.0 regression)
|
||||
|
||||
### 4.26.0 <small>_ October 18, 2022</small> { id="4.26.0" }
|
||||
### 4.26.0 <small>October 18, 2022</small> { id="4.26.0" }
|
||||
|
||||
- Refactored privacy plugin to prepare for new features
|
||||
- Added support for `rel=noopener` links in privacy plugin
|
||||
- Resolve encoding issues with blog and privacy plugin
|
||||
|
||||
### 4.25.5 <small>_ October 16, 2022</small> { id="4.25.5" }
|
||||
### 4.25.5 <small>October 16, 2022</small> { id="4.25.5" }
|
||||
|
||||
- Updated MkDocs to 1.4.1
|
||||
- Added namespace prefix to built-in plugins
|
||||
- Updated `content` and `header` partial
|
||||
|
||||
### 4.25.4 <small>_ October 9, 2022</small> { id="4.25.4" }
|
||||
### 4.25.4 <small>October 9, 2022</small> { id="4.25.4" }
|
||||
|
||||
- Fixed other path issues for standalone blogs (4.24.2 regression)
|
||||
|
||||
### 4.25.3 <small>_ October 9, 2022</small> { id="4.25.3" }
|
||||
### 4.25.3 <small>October 9, 2022</small> { id="4.25.3" }
|
||||
|
||||
- Fixed #4457: Posts not collected for standalone blog (4.24.2 regression)
|
||||
|
||||
### 4.25.2 <small>_ October 4, 2022</small> { id="4.25.2" }
|
||||
### 4.25.2 <small>October 4, 2022</small> { id="4.25.2" }
|
||||
|
||||
- Fixed #4452: Blog and tags plugin crash when specifying slugify function
|
||||
|
||||
### 4.25.1 <small>_ October 3, 2022</small> { id="4.25.1" }
|
||||
### 4.25.1 <small>October 3, 2022</small> { id="4.25.1" }
|
||||
|
||||
- Updated `mkdocs-rss-plugin` in `Dockerfile` to fix MkDocs compat errors
|
||||
|
||||
### 4.25.0 <small>_ October 2, 2022</small> { id="4.25.0" }
|
||||
### 4.25.0 <small>October 2, 2022</small> { id="4.25.0" }
|
||||
|
||||
- Added support for navigation subtitles
|
||||
- Added support for defining an allow list for built-in tags plugin
|
||||
- Added support for custom slugify functions for built-in tags plugin
|
||||
- Improved stability of search plugin when using `--dirtyreload`
|
||||
|
||||
### 4.24.2 <small>_ October 1, 2022</small> { id="4.24.2" }
|
||||
### 4.24.2 <small>October 1, 2022</small> { id="4.24.2" }
|
||||
|
||||
- Updated MkDocs to 1.4
|
||||
- Fixed compatibility issues with MkDocs 1.4
|
||||
- Fixed incorrectly generated paths in privacy plugin
|
||||
- Fixed blog index page not showing navigation when using meta plugin
|
||||
|
||||
### 4.24.1 <small>_ September 30, 2022</small> { id="4.24.1" }
|
||||
### 4.24.1 <small>September 30, 2022</small> { id="4.24.1" }
|
||||
|
||||
- Fixed #4430: build error when enabling consent without repository URL
|
||||
|
||||
### 4.24.0 <small>_ September 27, 2022</small> { id="4.24.0" }
|
||||
### 4.24.0 <small>September 27, 2022</small> { id="4.24.0" }
|
||||
|
||||
- Added support for custom content on index pages (blog)
|
||||
- Added support for keeping content on paginated index pages (blog)
|
||||
@ -98,265 +98,265 @@
|
||||
- Fixed #4396: Front matter of index pages not inherited by pagination (blog)
|
||||
- Improved performance by building post excerpts once (blog)
|
||||
|
||||
### 4.23.6 <small>_ September 22, 2022</small> { id="4.23.6" }
|
||||
### 4.23.6 <small>September 22, 2022</small> { id="4.23.6" }
|
||||
|
||||
- Fixed #4389: Blog posts in first week of year in wrong archive
|
||||
- Fixed (= switched) footer previous and next links for blog posts
|
||||
|
||||
### 4.23.5 <small>_ September 18, 2022</small> { id="4.23.5" }
|
||||
### 4.23.5 <small>September 18, 2022</small> { id="4.23.5" }
|
||||
|
||||
- Fixed #4367: Improved blog plugin date handling for MultiMarkdown syntax
|
||||
- Fixed #4374: Fixed invalid URLs of related links to other blog posts
|
||||
|
||||
### 4.23.4 <small>_ September 14, 2022</small> { id="4.23.4" }
|
||||
### 4.23.4 <small>September 14, 2022</small> { id="4.23.4" }
|
||||
|
||||
- Fixed #4365: Recursion error in blog plugin due to `deepcopy`
|
||||
- Fixed path errors for blog plugin on Windows
|
||||
- Fixed publishing workflow in forked repositories
|
||||
|
||||
### 4.23.3 <small>_ September 13, 2022</small> { id="4.23.3" }
|
||||
### 4.23.3 <small>September 13, 2022</small> { id="4.23.3" }
|
||||
|
||||
- Fixed previous and next page links for drafts of blog posts
|
||||
|
||||
### 4.23.2 <small>_ September 13, 2022</small> { id="4.23.2" }
|
||||
### 4.23.2 <small>September 13, 2022</small> { id="4.23.2" }
|
||||
|
||||
- Fixed #4348: Blog plugin crashes on custom `nav` title
|
||||
- Fixed blog plugin crashing when category contained only drafts
|
||||
- Fixed rendering of content from blog index file
|
||||
|
||||
### 4.23.1 <small>_ September 12, 2022</small> { id="4.23.1" }
|
||||
### 4.23.1 <small>September 12, 2022</small> { id="4.23.1" }
|
||||
|
||||
- Fixed #4345: Blog plugin errors with default settings
|
||||
|
||||
### 4.23.0 <small>_ September 12, 2022</small> { id="4.23.0" }
|
||||
### 4.23.0 <small>September 12, 2022</small> { id="4.23.0" }
|
||||
|
||||
- Added blogging support via built-in blog plugin
|
||||
|
||||
### 4.22.1 <small>_ September 7, 2022</small> { id="4.22.1" }
|
||||
### 4.22.1 <small>September 7, 2022</small> { id="4.22.1" }
|
||||
|
||||
- Fixed #4217: Tooltips in data tables render in wrong position
|
||||
|
||||
### 4.22.0 <small>_ August 21, 2022</small> { id="4.22.0" }
|
||||
### 4.22.0 <small>August 21, 2022</small> { id="4.22.0" }
|
||||
|
||||
- Added support for navigation status
|
||||
|
||||
### 4.21.1 <small>_ August 13, 2022</small> { id="4.21.1" }
|
||||
### 4.21.1 <small>August 13, 2022</small> { id="4.21.1" }
|
||||
|
||||
- Fixed #4176: Broken image when avatar is served by Gravatar
|
||||
- Fixed #4212: Deferred search initialization for file:// locations
|
||||
|
||||
### 4.21.0 <small>_ July 17, 2022</small> { id="4.21.0" }
|
||||
### 4.21.0 <small>July 17, 2022</small> { id="4.21.0" }
|
||||
|
||||
- Added meta plugin: set front matter for all pages in a folder
|
||||
- Fixed #4114: Tags plugin fails if only `tags_extra_files` is set
|
||||
|
||||
### 4.20.1 <small>_ July 11, 2022</small> { id="4.20.1" }
|
||||
### 4.20.1 <small>July 11, 2022</small> { id="4.20.1" }
|
||||
|
||||
- Fixed #4105: Tags plugin fails if `tags_file` is not set (4.20.0 regression)
|
||||
|
||||
### 4.20.0 <small>_ July 7, 2022</small> { id="4.20.0" }
|
||||
### 4.20.0 <small>July 7, 2022</small> { id="4.20.0" }
|
||||
|
||||
- Added support for additional tags indexes
|
||||
- Fixed #4100: Tag icons not shown in tags index
|
||||
|
||||
### 4.19.2 <small>_ July 4, 2022</small> { id="4.19.2" }
|
||||
### 4.19.2 <small>July 4, 2022</small> { id="4.19.2" }
|
||||
|
||||
- Fixed #4051: Privacy plugin fails if symlinking isn't allowed on Windows
|
||||
|
||||
### 4.19.1 <small>_ June 25, 2022</small> { id="4.19.1" }
|
||||
### 4.19.1 <small>June 25, 2022</small> { id="4.19.1" }
|
||||
|
||||
- Added `mkdocs-git-committers-plugin` to Dockerfile
|
||||
- Added `mkdocs-git-revision-date-localized-plugin` to Dockerfile
|
||||
|
||||
### 4.19.0 <small>_ June 24, 2022</small> { id="4.19.0" }
|
||||
### 4.19.0 <small>June 24, 2022</small> { id="4.19.0" }
|
||||
|
||||
- Added support for document contributors
|
||||
- Updated French translations for cookie consent
|
||||
|
||||
### 4.18.2 <small>_ June 16, 2022</small> { id="4.18.2" }
|
||||
### 4.18.2 <small>June 16, 2022</small> { id="4.18.2" }
|
||||
|
||||
- Fixed #4026: Fixed tooltips not mounted for nested navigation links
|
||||
|
||||
### 4.18.1 <small>_ June 14, 2022</small> { id="4.18.1" }
|
||||
### 4.18.1 <small>June 14, 2022</small> { id="4.18.1" }
|
||||
|
||||
- Fixed #3990: Chinese search highlighting not working on non-boundaries
|
||||
|
||||
### 4.18.0 <small>_ June 11, 2022</small> { id="4.18.0" }
|
||||
### 4.18.0 <small>June 11, 2022</small> { id="4.18.0" }
|
||||
|
||||
- Added support for automatic dark/light mode
|
||||
- Fixed #4009: Privacy plugin uses invalid paths for file cache on Windows
|
||||
|
||||
### 4.17.2 <small>_ June 5, 2022</small> { id="4.17.2" }
|
||||
### 4.17.2 <small>June 5, 2022</small> { id="4.17.2" }
|
||||
|
||||
- Added support for custom jieba dictionaries (Chinese search)
|
||||
|
||||
### 4.17.1 <small>_ June 5, 2022</small> { id="4.17.1" }
|
||||
### 4.17.1 <small>June 5, 2022</small> { id="4.17.1" }
|
||||
|
||||
- Added support for cookie consent reject button
|
||||
- Added support for cookie consent custom button ordering
|
||||
- Fixed #3988: Content tab not focused after alternating anchor links
|
||||
|
||||
### 4.17.0 <small>_ June 4, 2022</small> { id="4.17.0" }
|
||||
### 4.17.0 <small>June 4, 2022</small> { id="4.17.0" }
|
||||
|
||||
- Added support for content tabs anchor links (deep linking)
|
||||
- Fixed #3975: Detect composition events in search interface (Chinese)
|
||||
- Fixed #3980: Search plugin doesn't use title set via front matter
|
||||
|
||||
### 4.16.2 <small>_ May 29, 2022</small> { id="4.16.2" }
|
||||
### 4.16.2 <small>May 29, 2022</small> { id="4.16.2" }
|
||||
|
||||
- Fixed #3961: Nested sections triggered build error for navigation tabs
|
||||
|
||||
### 4.16.1 <small>_ May 28, 2022</small> { id="4.16.1" }
|
||||
### 4.16.1 <small>May 28, 2022</small> { id="4.16.1" }
|
||||
|
||||
- Switched feedback widget rating titles to tooltips
|
||||
- Improved contrast of link colors for light/dark color schemes
|
||||
- Fixed #3950: Sticky navigation tabs rendering broken (4.15.2 regression)
|
||||
- Fixed #3958: Links invisible when using `white` primary color
|
||||
|
||||
### 4.16.0 <small>_ May 25, 2022</small> { id="4.16.0" }
|
||||
### 4.16.0 <small>May 25, 2022</small> { id="4.16.0" }
|
||||
|
||||
- Added support for navigation pruning
|
||||
- Fixed search results for non-segmented characters (4.15.2 regression)
|
||||
|
||||
### 4.15.2 <small>_ May 22, 2022</small> { id="4.15.2" }
|
||||
### 4.15.2 <small>May 22, 2022</small> { id="4.15.2" }
|
||||
|
||||
- Removed workaround for `abbr` on touch devices (superseded by tooltips)
|
||||
- Fixed #3915: Improved Chinese search query segmentation
|
||||
- Fixed #3938: Fixed tooltips position for navigation titles with ellipsis
|
||||
|
||||
### 4.15.1 <small>_ May 14, 2022</small> { id="4.15.1" }
|
||||
### 4.15.1 <small>May 14, 2022</small> { id="4.15.1" }
|
||||
|
||||
- Improved performance of element focus obervables
|
||||
- Fixed #3531: Added prev/next buttons to content tabs
|
||||
- Fixed tooltip positioning when host element is hidden
|
||||
|
||||
### 4.15.0 <small>_ May 8, 2022</small> { id="4.15.0" }
|
||||
### 4.15.0 <small>May 8, 2022</small> { id="4.15.0" }
|
||||
|
||||
- Added support for improved tooltips
|
||||
- Fixed #3785: Show tooltip on hover for overflowing navigation link
|
||||
|
||||
### 4.14.0 <small>_ May 5, 2022</small> { id="4.14.0" }
|
||||
### 4.14.0 <small>May 5, 2022</small> { id="4.14.0" }
|
||||
|
||||
- Added Chinese language support to built-in search plugin
|
||||
- Fixed all-numeric page titles raising error in social plugin
|
||||
|
||||
### 4.13.2 <small>_ April 30, 2022</small> { id="4.13.2" }
|
||||
### 4.13.2 <small>April 30, 2022</small> { id="4.13.2" }
|
||||
|
||||
- Improved caching of downloaded resources in privacy plugin
|
||||
- Fixed #3851: External images not downloaded by privacy plugin
|
||||
|
||||
### 4.13.1 <small>_ April 25, 2022</small> { id="4.13.1" }
|
||||
### 4.13.1 <small>April 25, 2022</small> { id="4.13.1" }
|
||||
|
||||
- Fixed #3839: Tags plugin breaks without icons (4.13.0 regression)
|
||||
|
||||
### 4.13.0 <small>_ April 24, 2022</small> { id="4.13.0" }
|
||||
### 4.13.0 <small>April 24, 2022</small> { id="4.13.0" }
|
||||
|
||||
- Added support for tag icons
|
||||
|
||||
### 4.12.0 <small>_ March 27, 2022</small> { id="4.12.0" }
|
||||
### 4.12.0 <small>March 27, 2022</small> { id="4.12.0" }
|
||||
|
||||
- Added support for card grids and grid layouts
|
||||
- Fixed #3685: Annotations sometimes broken when using instant loading
|
||||
- Fixed #3742: Automatically add Mermaid.js when building for offline usage
|
||||
|
||||
### 4.11.0 <small>_ March 6, 2022</small> { id="4.11.0" }
|
||||
### 4.11.0 <small>March 6, 2022</small> { id="4.11.0" }
|
||||
|
||||
- Added support for excluding external assets from privacy plugin
|
||||
|
||||
### 4.10.1 <small>_ March 2, 2022</small> { id="4.10.1" }
|
||||
### 4.10.1 <small>March 2, 2022</small> { id="4.10.1" }
|
||||
|
||||
- Added missing build dependencies to Dockerfile
|
||||
- Fixed encoding issues in privacy plugin, now forcing UTF-8 encoding
|
||||
- Fixed #3624: Scroll to active navigation item unreliable in Firefox
|
||||
- Fixed #3642: Privacy plugin errors when font setting was omitted
|
||||
|
||||
### 4.10.0 <small>_ February 27, 2022</small> { id="4.10.0" }
|
||||
### 4.10.0 <small>February 27, 2022</small> { id="4.10.0" }
|
||||
|
||||
- Added support for offline plugin (supersedes offline search support)
|
||||
- Improved built-in privacy plugin to download nested JavaScript assets
|
||||
- Refactored configuration of built-in privacy plugin
|
||||
|
||||
### 4.9.1 <small>_ February 21, 2022</small> { id="4.9.1" }
|
||||
### 4.9.1 <small>February 21, 2022</small> { id="4.9.1" }
|
||||
|
||||
- Fixed #3610: missing `lxml` dependency for privacy plugin
|
||||
- Fixed error when charset is missing in `content-type` header
|
||||
|
||||
### 4.9.0 <small>_ February 20, 2022</small> { id="4.9.0" }
|
||||
### 4.9.0 <small>February 20, 2022</small> { id="4.9.0" }
|
||||
|
||||
- Added privacy plugin: automatic downloading of external assets
|
||||
|
||||
### 4.8.3 <small>_ February 13, 2022</small> { id="4.8.3" }
|
||||
### 4.8.3 <small>February 13, 2022</small> { id="4.8.3" }
|
||||
|
||||
- Fixed #3560: Mermaid diagrams don't render for `file://` locations
|
||||
|
||||
### 4.8.2 <small>_ February 10, 2022</small> { id="4.8.2" }
|
||||
### 4.8.2 <small>February 10, 2022</small> { id="4.8.2" }
|
||||
|
||||
- Fixed #3559: Mermaid diagrams don't render inside closed `details`
|
||||
|
||||
### 4.8.1 <small>_ February 6, 2022</small> { id="4.8.1" }
|
||||
### 4.8.1 <small>February 6, 2022</small> { id="4.8.1" }
|
||||
|
||||
- Fixed jump back to top on mobile when using anchor following
|
||||
|
||||
### 4.8.0 <small>_ February 6, 2022</small> { id="4.8.0" }
|
||||
### 4.8.0 <small>February 6, 2022</small> { id="4.8.0" }
|
||||
|
||||
- Added support for anchor following table of contents (= auto scroll)
|
||||
|
||||
### 4.7.2 <small>_ February 2, 2022</small> { id="4.7.2" }
|
||||
### 4.7.2 <small>February 2, 2022</small> { id="4.7.2" }
|
||||
|
||||
- Fixed #3526: Transparent sidebar title due to Safari bug
|
||||
- Fixed #3528: Firefox sometimes clips text in flow chart diagrams
|
||||
|
||||
### 4.7.1 <small>_ January 30, 2022</small> { id="4.7.1" }
|
||||
### 4.7.1 <small>January 30, 2022</small> { id="4.7.1" }
|
||||
|
||||
- Fixed #3506: Tags index not respecting title set via front matter
|
||||
|
||||
### 4.7.0 <small>_ January 25, 2022</small> { id="4.7.0" }
|
||||
### 4.7.0 <small>January 25, 2022</small> { id="4.7.0" }
|
||||
|
||||
- Added native support for offline search
|
||||
|
||||
### 4.6.1 <small>_ January 16, 2022</small> { id="4.6.1" }
|
||||
### 4.6.1 <small>January 16, 2022</small> { id="4.6.1" }
|
||||
|
||||
- Fixed #3459: Section index pages picking up wrong title
|
||||
|
||||
### 4.6.0 <small>_ January 11, 2022</small> { id="4.6.0" }
|
||||
### 4.6.0 <small>January 11, 2022</small> { id="4.6.0" }
|
||||
|
||||
- Added support for annotations (outside of code blocks)
|
||||
|
||||
### 4.5.2 <small>_ January 8, 2022</small> { id="4.5.2" }
|
||||
### 4.5.2 <small>January 8, 2022</small> { id="4.5.2" }
|
||||
|
||||
- Fixed #3440: Content tab indicator not moving when using linking
|
||||
- Fixed #3445: Content tab switch flickers/jitters when using linking
|
||||
|
||||
### 4.5.1 <small>_ January 2, 2022</small> { id="4.5.1" }
|
||||
### 4.5.1 <small>January 2, 2022</small> { id="4.5.1" }
|
||||
|
||||
- Added support for setting initial state of cookie consent
|
||||
- Fixed #3396: Disappearing link in navigation due to Safari bug
|
||||
|
||||
### 4.5.0 <small>_ December 16, 2021</small> { id="4.5.0" }
|
||||
### 4.5.0 <small>December 16, 2021</small> { id="4.5.0" }
|
||||
|
||||
- Added support for navigation icons
|
||||
|
||||
### 4.4.0 <small>_ December 10, 2021</small> { id="4.4.0" }
|
||||
### 4.4.0 <small>December 10, 2021</small> { id="4.4.0" }
|
||||
|
||||
- Added support for code annotation anchor links (deep linking)
|
||||
- Added new code annotation syntax modifier to strip comment
|
||||
- Updated German translations for cookie consent
|
||||
|
||||
### 4.3.0 <small>_ December 5, 2021</small> { id="4.3.0" }
|
||||
### 4.3.0 <small>December 5, 2021</small> { id="4.3.0" }
|
||||
|
||||
- Added support for custom fonts in social cards
|
||||
- Fixed #3300: Announcement bar reappearing when using instant loading
|
||||
|
||||
### 4.2.0 <small>_ December 2, 2021</small> { id="4.2.0" }
|
||||
### 4.2.0 <small>December 2, 2021</small> { id="4.2.0" }
|
||||
|
||||
- Added support for dismissable announcement bar
|
||||
- Added support for named placeholders in feedback widget
|
||||
|
||||
### 4.1.0 <small>_ November 30, 2021</small> { id="4.1.0" }
|
||||
### 4.1.0 <small>November 30, 2021</small> { id="4.1.0" }
|
||||
|
||||
- Added support for passing page title to feedback forms
|
||||
|
||||
### 4.0.0 <small>_ November 28, 2021</small> { id="4.0.0" }
|
||||
### 4.0.0 <small>November 28, 2021</small> { id="4.0.0" }
|
||||
|
||||
- Removed deprecated content tabs legacy implementation
|
||||
- Removed deprecated `seealso` admonition type
|
||||
@ -374,7 +374,7 @@
|
||||
- Improved keyboard navigation for footnotes
|
||||
- Fixed #3214: Search highlighting breaks site when empty
|
||||
|
||||
### 3.2.3 <small>_ November 20, 2021</small> { id="3.2.3" }
|
||||
### 3.2.3 <small>November 20, 2021</small> { id="3.2.3" }
|
||||
|
||||
- Updated Swedish and French translations
|
||||
- Removed support for `.mermaid-experimental` class (now `.mermaid`)
|
||||
@ -382,56 +382,56 @@
|
||||
- Fixed #3216: Cookie consent not dismissed when invoked via anchor
|
||||
- Fixed #3232: Mermaid.js sometimes runs twice (race condition)
|
||||
|
||||
### 3.2.2 <small>_ November 6, 2021</small> { id="3.2.2" }
|
||||
### 3.2.2 <small>November 6, 2021</small> { id="3.2.2" }
|
||||
|
||||
- Fixed always last feedback rating being sent
|
||||
- Fixed #3145: Code annotations eat whole comment lines
|
||||
- Fixed #3170: Feedback widget doesn't send data to GA4
|
||||
|
||||
### 3.2.1 <small>_ November 4, 2021</small> { id="3.2.1" }
|
||||
### 3.2.1 <small>November 4, 2021</small> { id="3.2.1" }
|
||||
|
||||
- Added support for custom Mermaid.js version via additional JavaScript
|
||||
- Fixed some configuration edge cases for tags plugin (3.1.5 regression)
|
||||
- Fixed feedback widget title not being centered in Firefox
|
||||
- Fixed #3179: Safari doesn't send request for feedback widget
|
||||
|
||||
### 3.2.0 <small>_ October 31, 2021</small> { id="3.2.0" }
|
||||
### 3.2.0 <small>October 31, 2021</small> { id="3.2.0" }
|
||||
|
||||
- Added support for feedback widget (Was this page helpful?)
|
||||
|
||||
### 3.1.5 <small>_ October 28, 2021</small> { id="3.1.5" }
|
||||
### 3.1.5 <small>October 28, 2021</small> { id="3.1.5" }
|
||||
|
||||
- Fixed #3144: Rogue link when using tags with auto-populated navigation
|
||||
- Fixed #3147: Code block line numbers appear in search results
|
||||
- Fixed #3158: Social cards do not strip HTML tags from title
|
||||
|
||||
### 3.1.4 <small>_ October 17, 2021</small> { id="3.1.4" }
|
||||
### 3.1.4 <small>October 17, 2021</small> { id="3.1.4" }
|
||||
|
||||
- Fixed #2974: Text cropped with other fonts than `Roboto` in social plugin
|
||||
- Fixed #3099: Encoding problems with non-latin character in social plugin
|
||||
- Fixed #3112: Japanese segmenter not executed as part of new tokenizer
|
||||
- Fixed tags (front matter) appearing in search with disabled tags plugin
|
||||
|
||||
### 3.1.3 <small>_ October 12, 2021</small> { id="3.1.3" }
|
||||
### 3.1.3 <small>October 12, 2021</small> { id="3.1.3" }
|
||||
|
||||
- Added warnings to search plugin for unsupported options and syntax
|
||||
- Fixed #3503: Search sometimes returns entire page
|
||||
- Fixed #3089: Single-line code annotations disappear when printing
|
||||
|
||||
### 3.1.2 <small>_ October 6, 2021</small> { id="3.1.2" }
|
||||
### 3.1.2 <small>October 6, 2021</small> { id="3.1.2" }
|
||||
|
||||
- Fixed incorrect path separators for social cards on Windows
|
||||
|
||||
### 3.1.1 <small>_ September 26, 2021</small> { id="3.1.1" }
|
||||
### 3.1.1 <small>September 26, 2021</small> { id="3.1.1" }
|
||||
|
||||
- Fixed ordering bug in search exclusion logic
|
||||
|
||||
### 3.1.0 <small>_ September 26, 2021</small> { id="3.1.0" }
|
||||
### 3.1.0 <small>September 26, 2021</small> { id="3.1.0" }
|
||||
|
||||
- Added support for excluding pages, sections, and elements from search
|
||||
- Fixed #2803: Code block annotations not visible when printing
|
||||
|
||||
### 3.0.1 <small>_ September 19, 2021</small> { id="3.0.1" }
|
||||
### 3.0.1 <small>September 19, 2021</small> { id="3.0.1" }
|
||||
|
||||
- Added support for using literal `h1-6` tags for search plugin
|
||||
- Fixed search plugin breaking on void elements without slashes
|
||||
@ -439,7 +439,7 @@
|
||||
- Fixed search plugin handling of multiple `h1` headlines
|
||||
- Fixed search plugin handling of missing `h1` headlines
|
||||
|
||||
### 3.0.0 <small>_ September 13, 2021</small> { id="3.0.0" }
|
||||
### 3.0.0 <small>September 13, 2021</small> { id="3.0.0" }
|
||||
|
||||
- Rewrite of MkDocs' search plugin
|
||||
- Added support for rich search previews
|
||||
@ -447,41 +447,41 @@
|
||||
- Improved search indexing performance (twice as fast)
|
||||
- Improved search highlighting
|
||||
|
||||
### 2.13.3 <small>_ September 1, 2021</small> { id="2.13.3" }
|
||||
### 2.13.3 <small>September 1, 2021</small> { id="2.13.3" }
|
||||
|
||||
- Added support for disabling social card generation
|
||||
|
||||
### 2.13.2 <small>_ August 25, 2021</small> { id="2.13.2" }
|
||||
### 2.13.2 <small>August 25, 2021</small> { id="2.13.2" }
|
||||
|
||||
- Fixed #2965: Social plugin error when primary color is not defined
|
||||
|
||||
### 2.13.1 <small>_ August 21, 2021</small> { id="2.13.1" }
|
||||
### 2.13.1 <small>August 21, 2021</small> { id="2.13.1" }
|
||||
|
||||
- Fixed #2948: Social cards are not cached
|
||||
- Fixed #2953: Mermaid.js diagrams can't be centered anymore
|
||||
|
||||
### 2.13.0 <small>_ August 7, 2021</small> { id="2.13.0" }
|
||||
### 2.13.0 <small>August 7, 2021</small> { id="2.13.0" }
|
||||
|
||||
- Added support for custom colors in social cards
|
||||
|
||||
### 2.12.2 <small>_ August 4, 2021</small> { id="2.12.2" }
|
||||
### 2.12.2 <small>August 4, 2021</small> { id="2.12.2" }
|
||||
|
||||
- Fixed #2891: Division by zero error in social plugin
|
||||
|
||||
### 2.12.1 <small>_ July 26, 2021</small> { id="2.12.1" }
|
||||
### 2.12.1 <small>July 26, 2021</small> { id="2.12.1" }
|
||||
|
||||
- Fixed error in social plugin when `site_description` was not set
|
||||
- Fixed error in social plugin for non-ASCII characters
|
||||
|
||||
### 2.12.0 <small>_ July 25, 2021</small> { id="2.12.0" }
|
||||
### 2.12.0 <small>July 25, 2021</small> { id="2.12.0" }
|
||||
|
||||
- Added support for social cards
|
||||
|
||||
### 2.11.1 <small>_ July 20, 2021</small> { id="2.11.1" }
|
||||
### 2.11.1 <small>July 20, 2021</small> { id="2.11.1" }
|
||||
|
||||
- Fixed order of tags index, now sorted alphabetically
|
||||
|
||||
### 2.11.0 <small>_ July 18, 2021</small> { id="2.11.0" }
|
||||
### 2.11.0 <small>July 18, 2021</small> { id="2.11.0" }
|
||||
|
||||
- Improved Mermaid.js intergration, now stable
|
||||
- Added support for sequence diagrams
|
||||
@ -489,193 +489,193 @@
|
||||
- Added support for cookie consent configuration
|
||||
- Added feature flag to always enable annotations
|
||||
|
||||
### 2.10.0 <small>_ July 10, 2021</small> { id="2.10.0" }
|
||||
### 2.10.0 <small>July 10, 2021</small> { id="2.10.0" }
|
||||
|
||||
- Added support for cookie consent
|
||||
- Fixed #2807: Back-to-top button not hidden when using sticky tabs
|
||||
|
||||
### 2.9.2 <small>_ May 30, 2021</small> { id="2.9.2" }
|
||||
### 2.9.2 <small>May 30, 2021</small> { id="2.9.2" }
|
||||
|
||||
- Moved tags to partial for easier customization
|
||||
- Added support for hiding tags on any page
|
||||
|
||||
### 2.9.1 <small>_ May 24, 2021</small> { id="2.9.1" }
|
||||
### 2.9.1 <small>May 24, 2021</small> { id="2.9.1" }
|
||||
|
||||
- Added missing guard for linking of content tabs
|
||||
|
||||
### 2.9.0 <small>_ May 23, 2021</small> { id="2.9.0" }
|
||||
### 2.9.0 <small>May 23, 2021</small> { id="2.9.0" }
|
||||
|
||||
- Added support for linking of content tabs
|
||||
|
||||
### 2.8.0 <small>_ May 12, 2021</small> { id="2.8.0" }
|
||||
### 2.8.0 <small>May 12, 2021</small> { id="2.8.0" }
|
||||
|
||||
- Added support for boosting pages in search
|
||||
|
||||
### 2.7.2 <small>_ May 8, 2021</small> { id="2.7.2" }
|
||||
### 2.7.2 <small>May 8, 2021</small> { id="2.7.2" }
|
||||
|
||||
- Fixed #2638: Warnings shown when using `tags` plugin without directory URLs
|
||||
|
||||
### 2.7.1 <small>_ May 3, 2021</small> { id="2.7.1" }
|
||||
### 2.7.1 <small>May 3, 2021</small> { id="2.7.1" }
|
||||
|
||||
- Fixed `git-revision-date-localized` plugin integration (2.7.0 regression)
|
||||
|
||||
### 2.7.0 <small>_ May 1, 2021</small> { id="2.7.0" }
|
||||
### 2.7.0 <small>May 1, 2021</small> { id="2.7.0" }
|
||||
|
||||
- Added support for tags (with search integration)
|
||||
|
||||
### 2.6.0 <small>_ April 11, 2021</small> { id="2.6.0" }
|
||||
### 2.6.0 <small>April 11, 2021</small> { id="2.6.0" }
|
||||
|
||||
- Stay on page when switching versions
|
||||
|
||||
### 2.5.0 <small>_ March 28, 2021</small> { id="2.5.0" }
|
||||
### 2.5.0 <small>March 28, 2021</small> { id="2.5.0" }
|
||||
|
||||
- Added support for version warning
|
||||
|
||||
### 2.4.0 <small>_ March 20, 2021</small> { id="2.4.0" }
|
||||
### 2.4.0 <small>March 20, 2021</small> { id="2.4.0" }
|
||||
|
||||
- Added support for custom admonition icons
|
||||
- Fixed #2444: Code block annotations with extra comments have wrong index
|
||||
|
||||
### 2.3.1 <small>_ March 14, 2021</small> { id="2.3.1" }
|
||||
### 2.3.1 <small>March 14, 2021</small> { id="2.3.1" }
|
||||
|
||||
- Fixed anchor offset for permalinks when using sticky navigation tabs
|
||||
|
||||
### 2.3.0 <small>_ March 13, 2021</small> { id="2.3.0" }
|
||||
### 2.3.0 <small>March 13, 2021</small> { id="2.3.0" }
|
||||
|
||||
- Added support for back-to-top button
|
||||
|
||||
### 2.2.1 <small>_ March 4, 2021</small> { id="2.2.1" }
|
||||
### 2.2.1 <small>March 4, 2021</small> { id="2.2.1" }
|
||||
|
||||
- Fixed #2382: Repository stats failing when no release tag is present
|
||||
|
||||
### 2.2.0 <small>_ February 28, 2021</small> { id="2.2.0" }
|
||||
### 2.2.0 <small>February 28, 2021</small> { id="2.2.0" }
|
||||
|
||||
- Added support for code block annotations
|
||||
|
||||
### 2.1.0 <small>_ February 26, 2021</small> { id="2.1.0" }
|
||||
### 2.1.0 <small>February 26, 2021</small> { id="2.1.0" }
|
||||
|
||||
- Added support for anchor tracking
|
||||
|
||||
### 2.0.0 <small>_ February 24, 2021</small> { id="2.0.0" }
|
||||
### 2.0.0 <small>February 24, 2021</small> { id="2.0.0" }
|
||||
|
||||
- Migrated Insiders to the new architecture
|
||||
- Swapped color palette toggle configuration
|
||||
|
||||
### 1.17.0 <small>_ January 31, 2021</small> { id="1.17.0" }
|
||||
### 1.17.0 <small>January 31, 2021</small> { id="1.17.0" }
|
||||
|
||||
- Added support for section index pages
|
||||
|
||||
### 1.16.1 <small>_ January 26, 2021</small> { id="1.16.1" }
|
||||
### 1.16.1 <small>January 26, 2021</small> { id="1.16.1" }
|
||||
|
||||
- Fixed #2249: Instant loading + sticky tabs result in invalid links
|
||||
- Fixed #2248: Search highlighting URL parameter always added
|
||||
- Fixed #2235: Version selector doesn't select current version for aliases
|
||||
|
||||
### 1.16.0 <small>_ January 7, 2021</small> { id="1.16.0" }
|
||||
### 1.16.0 <small>January 7, 2021</small> { id="1.16.0" }
|
||||
|
||||
- Added latest release to repository info (GitHub)
|
||||
- Slight facelift of repository info (lighter fonts, spacing and icons)
|
||||
|
||||
### 1.15.0 <small>_ January 2, 2021</small> { id="1.15.0" }
|
||||
### 1.15.0 <small>January 2, 2021</small> { id="1.15.0" }
|
||||
|
||||
- Added support for native Mermaid.js integration
|
||||
|
||||
### 1.14.0 <small>_ December 30, 2020</small> { id="1.14.0" }
|
||||
### 1.14.0 <small>December 30, 2020</small> { id="1.14.0" }
|
||||
|
||||
- Added support for sharing searches
|
||||
|
||||
### 1.13.2 <small>_ December 22, 2020</small> { id="1.13.2" }
|
||||
### 1.13.2 <small>December 22, 2020</small> { id="1.13.2" }
|
||||
|
||||
- Fixed version selector + sticky tabs navigation rendering issues
|
||||
- Fixed version selector wrapping
|
||||
|
||||
### 1.13.1 <small>_ December 20, 2020</small> { id="1.13.1" }
|
||||
### 1.13.1 <small>December 20, 2020</small> { id="1.13.1" }
|
||||
|
||||
- Removed horizontal scrollbars on language and version selector
|
||||
- Fixed type conversion in JavaScript config
|
||||
|
||||
### 1.13.0 <small>_ December 13, 2020</small> { id="1.13.0" }
|
||||
### 1.13.0 <small>December 13, 2020</small> { id="1.13.0" }
|
||||
|
||||
- Refactored navigation tabs to simplify grouping behavior
|
||||
- Added support for sticky navigation tabs
|
||||
- Added support for arbitrary links in navigation tabs
|
||||
- Fixed #2098: Subsequent active subsection not highlighted correctly
|
||||
|
||||
### 1.12.1 <small>_ December 8, 2020</small> { id="1.12.1" }
|
||||
### 1.12.1 <small>December 8, 2020</small> { id="1.12.1" }
|
||||
|
||||
- Fixed empty language selector being shown
|
||||
|
||||
### 1.12.0 <small>_ December 6, 2020</small> { id="1.12.0" }
|
||||
### 1.12.0 <small>December 6, 2020</small> { id="1.12.0" }
|
||||
|
||||
- Added support for adding a language selector
|
||||
|
||||
### 1.11.2 <small>_ November 29, 2020</small> { id="1.11.2" }
|
||||
### 1.11.2 <small>November 29, 2020</small> { id="1.11.2" }
|
||||
|
||||
- Fixed #2068: Search highlight interprets code blocks as JavaScript
|
||||
|
||||
### 1.11.1 <small>_ November 29, 2020</small> { id="1.11.1" }
|
||||
### 1.11.1 <small>November 29, 2020</small> { id="1.11.1" }
|
||||
|
||||
- Refactored styling to be more stable and easier to adjust
|
||||
- Fixed some styling regressions from latest features
|
||||
|
||||
### 1.11.0 <small>_ November 22, 2020</small> { id="1.11.0" }
|
||||
### 1.11.0 <small>November 22, 2020</small> { id="1.11.0" }
|
||||
|
||||
- Added support for rendering admonitions as inline blocks
|
||||
|
||||
### 1.10.0 <small>_ November 15, 2020</small> { id="1.10.0" }
|
||||
### 1.10.0 <small>November 15, 2020</small> { id="1.10.0" }
|
||||
|
||||
- Added support for integrating table of contents into navigation
|
||||
|
||||
### 1.9.0 <small>_ November 7, 2020</small> { id="1.9.0" }
|
||||
### 1.9.0 <small>November 7, 2020</small> { id="1.9.0" }
|
||||
|
||||
- Added support for hiding navigation and table of contents on any page
|
||||
- Removed autohiding table of contents when empty
|
||||
|
||||
### 1.8.0 <small>_ November 1, 2020</small> { id="1.8.0" }
|
||||
### 1.8.0 <small>November 1, 2020</small> { id="1.8.0" }
|
||||
|
||||
- Added support for navigation sections
|
||||
- Fixed appearance of inactive search suggestions
|
||||
|
||||
### 1.7.0 <small>_ October 25, 2020</small> { id="1.7.0" }
|
||||
### 1.7.0 <small>October 25, 2020</small> { id="1.7.0" }
|
||||
|
||||
- Added support for deploying multiple versions
|
||||
- Fixed alignment of sidebar when content area is too small
|
||||
|
||||
### 1.6.0 <small>_ October 11, 2020</small> { id="1.6.0" }
|
||||
### 1.6.0 <small>October 11, 2020</small> { id="1.6.0" }
|
||||
|
||||
- Added support for search suggestions to save keystrokes
|
||||
- Added support for removing __Made with Material for MkDocs__ from footer
|
||||
- Fixed #1915: search should go to first result by pressing ++enter++
|
||||
|
||||
### 1.5.1 <small>_ September 21, 2020</small> { id="1.5.1" }
|
||||
### 1.5.1 <small>September 21, 2020</small> { id="1.5.1" }
|
||||
|
||||
- Fixed content area stretching to whole width for long code blocks
|
||||
|
||||
### 1.5.0 <small>_ September 19, 2020</small> { id="1.5.0" }
|
||||
### 1.5.0 <small>September 19, 2020</small> { id="1.5.0" }
|
||||
|
||||
- Added support for autohiding table of contents when empty
|
||||
|
||||
### 1.4.1 <small>_ September 6, 2020</small> { id="1.4.1" }
|
||||
### 1.4.1 <small>September 6, 2020</small> { id="1.4.1" }
|
||||
|
||||
- Improved typeahead and search result relevance and scoring
|
||||
|
||||
### 1.4.0 <small>_ August 30, 2020</small> { id="1.4.0" }
|
||||
### 1.4.0 <small>August 30, 2020</small> { id="1.4.0" }
|
||||
|
||||
- Added support for autohiding header on scroll
|
||||
|
||||
### 1.3.0 <small>_ August 26, 2020</small> { id="1.3.0" }
|
||||
### 1.3.0 <small>August 26, 2020</small> { id="1.3.0" }
|
||||
|
||||
- Added support for user-selectable color palettes
|
||||
|
||||
### 1.2.0 <small>_ August 11, 2020</small> { id="1.2.0" }
|
||||
### 1.2.0 <small>August 11, 2020</small> { id="1.2.0" }
|
||||
|
||||
- Added feature to expand navigation by default
|
||||
|
||||
### 1.1.0 <small>_ August 3, 2020</small> { id="1.1.0" }
|
||||
### 1.1.0 <small>August 3, 2020</small> { id="1.1.0" }
|
||||
|
||||
- Added highlighting of search results
|
||||
|
||||
### 1.0.0 <small>_ July 14, 2020</small> { id="1.0.0" }
|
||||
### 1.0.0 <small>July 14, 2020</small> { id="1.0.0" }
|
||||
|
||||
- Added grouping of search results
|
||||
- Added missing query terms to search result
|
||||
|
||||
@ -12,6 +12,75 @@ Show the currently installed version with:
|
||||
pip show mkdocs-material
|
||||
```
|
||||
|
||||
## Upgrading from 8.x to 9.x
|
||||
|
||||
This major release includes a brand new search implementation that is faster
|
||||
and allows for rich previews, advanced tokenization and better highlighting.
|
||||
It was available as part of Insiders for over a year, and now that the funding
|
||||
goal was hit, makes its way into the community edition.
|
||||
|
||||
### Changes to `mkdocs.yml`
|
||||
|
||||
#### `content.code.copy`
|
||||
|
||||
The copy-to-clipboard buttons are now opt-in and can be enabled or disabled
|
||||
per block. If you wish to enable them for all code blocks, add the following
|
||||
lines to `mkdocs.yml`:
|
||||
|
||||
``` yaml
|
||||
theme:
|
||||
features:
|
||||
- content.code.copy
|
||||
```
|
||||
|
||||
#### `content.action.*`
|
||||
|
||||
A "view source" button can be shown next to the "edit this page" button, both
|
||||
of which must now be explicitly enabled. Add the following lines to
|
||||
`mkdocs.yml`:
|
||||
|
||||
``` yaml
|
||||
theme:
|
||||
features:
|
||||
- content.action.edit
|
||||
- content.action.view
|
||||
```
|
||||
|
||||
#### `navigation.footer`
|
||||
|
||||
The _previous_ and _next_ buttons in the footer are now opt-in. If you wish to
|
||||
keep them for your documentation, add the following lines to `mkdocs.yml`:
|
||||
|
||||
``` yaml
|
||||
theme:
|
||||
features:
|
||||
- navigation.footer
|
||||
```
|
||||
|
||||
#### `theme.language`
|
||||
|
||||
The Korean and Norwegian language codes were renamed, as they were non-standard:
|
||||
|
||||
- `kr` to `ko`
|
||||
- `no` to `nb`
|
||||
|
||||
#### `feedback.ratings`
|
||||
|
||||
The old, nameless placeholders were removed (after being deprecated for several
|
||||
months). Make sure to switch to the new named placeholders `{title}` and `{url}`:
|
||||
|
||||
```
|
||||
https://github.com/.../issues/new/?title=[Feedback]+{title}+-+{url}
|
||||
```
|
||||
|
||||
### Changes to `*.html` files
|
||||
|
||||
The templates have undergone a series of changes. If you have customized
|
||||
Material for MkDocs with theme extension, be sure to incorporate the latest
|
||||
changes into your templates. A good starting point is to [inspect the diff].
|
||||
|
||||
[inspect the diff]: https://github.com/squidfunk/mkdocs-material/pull/4628/files#diff-3ca112736b9164701b599f34780107abf14bb79fe110c478cac410be90899828
|
||||
|
||||
## Upgrading from 7.x to 8.x
|
||||
|
||||
### What's new?
|
||||
|
||||
Loading…
Reference in New Issue
Block a user