Releases: mkdocs/mkdocs
1.3.0
Feature upgrades
-
ReadTheDocs theme updated from v0.4.1 to v1.0.0 according to upstream (#2585)
The most notable changes:
- New option
logo
: Rather than displaying thesite_name
in the title, one can specify a path to an image to display instead. - New option
anonymize_ip
for Google Analytics. - Dependencies were upgraded: jQuery upgraded to 3.6.0, Modernizr.js dropped, and others.
- New option
-
Built-in themes now also support these languages:
-
Support custom directories to watch when running
mkdocs serve
(#2642)MkDocs by default watches the docs directory and the config file. Now there is a way to add more directories to watch for changes, either via the YAML
watch
key or the command line flag--watch
.Normally MkDocs never reaches into any other directories (so this feature shouldn't be necessary), but some plugins and extensions may do so.
See documentation.
-
New
--no-history
option forgh_deploy
(#2594)Allows to discard the history of commits when deploying, and instead replace it with one root commit
Bug fixes
-
An XSS vulnerability when using the search function in built-in themes was fixed (#2791)
-
Setting the
edit_uri
option no longer erroneously adds a trailing slash torepo_url
(#2733)
Miscellaneous
-
Breaking change: the
pages
config option that was deprecated for a very long time now causes an error when used (#2652)To fix the error, just change from
pages
tonav
. -
Performance optimization: during startup of MkDocs, code and dependencies of other commands will not be imported (#2714)
The most visible effect of this is that dependencies of
mkdocs serve
will not be imported whenmkdocs build
is used. -
Recursively validate
nav
(#2680)Validation of the nested
nav
structure has been reworked to report errors early and reliably. Some edge cases have been declared invalid.
Other small improvements; see commit log.
1.2.4
1.2.3
MkDocs 1.2.3 is a bugfix release for MkDocs 1.2.
Aside: MkDocs has a new chat room on Gitter/Matrix. More details.
Improvements:
-
Built-in themes now also support these languages:
-
Third-party plugins will take precedence over built-in plugins with the same name (#2591)
-
Bugfix: Fix ability to load translations for some languages: core support (#2565) and search plugin support with fallbacks (#2602)
-
Bugfix (regression in 1.2): Prevent directory traversal in the dev server (#2604)
-
Bugfix (regression in 1.2): Prevent webserver warnings from being treated as a build failure in strict mode (#2607)
-
Bugfix: Correctly print colorful messages in the terminal on Windows (#2606)
-
Bugfix: Python version 3.10 was displayed incorrectly in
--version
(#2618)
Other small improvements; see commit log.
1.2.2
MkDocs 1.2.2 is a bugfix release for MkDocs 1.2 -- make sure you've seen the "major" release notes as well.
-
Bugfix (regression in 1.2): Fix serving files/paths with Unicode characters (#2464)
-
Bugfix (regression in 1.2): Revert livereload file watching to use polling observer (#2477)
This had to be done to reasonably support usages that span virtual filesystems such as non-native Docker and network mounts.
This goes back to the polling approach, very similar to that was always used prior, meaning most of the same downsides with latency and CPU usage.
-
Revert from 1.2: Remove the requirement of a
site_url
config and the restriction onuse_directory_urls
(#2490) -
Bugfix (regression in 1.2): Don't require trailing slash in the URL when serving a directory index in
mkdocs serve
server (#2507)Instead of showing a 404 error, detect if it's a directory and redirect to a path with a trailing slash added, like before.
-
Bugfix: Fix
gh_deploy
with config-file in the current directory (#2481) -
Bugfix: Fix reversed breadcrumbs in "readthedocs" theme (#2179)
-
Allow "mkdocs.yaml" as the file name when '--config' is not passed (#2478)
-
Stop treating ";" as a special character in URLs: urlparse -> urlsplit (#2502)
-
Improve build performance for sites with many pages (partly already done in 1.2) (#2407)