Releases: jimporter/mike
Releases · jimporter/mike
v2.1.3
v2.1.2
v2.1.1
v2.1.0
New features
- When calling
set-default
, you can now pass--allow-undefined
to set the default to a version that doesn't exist yet - Add global-level
-q
/--quiet
option to suppress warning messages - Add support for handling
!relative
inmkdocs.yml
Bug fixes
- When loading an MkDocs config, mike now runs the
startup
andshutdown
events
v2.0.0
New features
- Add support for applying arbitrary properties to documentation versions
- Add support for hiding specific versions from the selector when using the default themes
- Deploy aliases using symbolic links by default; this can be configured via
--alias-type
on the command line oralias_type
in themike
MkDocs plugin - Avoid creating empty commits by default; if you want empty commits, pass
--allow-empty
- Look for both
mkdocs.yml
andmkdocs.yaml
configuration files - Support
GIT_COMMITTER_(NAME|EMAIL|DATE)
when generating commits - Allow specifying
alias_type
,redirect_template
, anddeploy_prefix
in themike
MkDocs plugin - Add a
--debug
flag to help diagnose bugs with mike - Port number is now optional for
--dev-addr
inmike serve
, defaulting to 8000
Breaking changes
--prefix
is now--deploy-prefix
--no-redirect
is now--alias-type=copy
--ignore
is now--ignore-remote-status
-f
/--force
is no longer supported on subcommands that can push (this option was too error-prone, and users who really need to force-push can use Git directly)--rebase
is no longer supported (instead of using this, it's better to use Git to resolve any conflicts)
Bug fixes
- Aliases that are "similar" to preexisting versions (e.g.
1.0
and1.0.0
) can now be set properly - Versions that don't start with a digit (or
v
and then a digit) are now treated separately from other versions: they're considered development versions, and thus newer than "ordinary" versions - Fix retrieval of Git user name/email when using non-UTF8 encodings
- Fix version selector for
mkdocs
andreadthedocs
themes whenuse_directory_urls
is false - When redirecting to another page, include the
?query
- Ensure that aliases cannot be circularly defined
- Support file names with double-quotes or newlines
v1.1.2
v1.1.1
v1.1.0
v1.0.1
v1.0.0
New features
- Remove
mike install-extras
and replace it with an MkDocs plugin; if you previously usedinstall-extras
, be sure to remove the added JS/CSS from your docs directory - When deploying aliases, deploy redirect pages to the real version by default; pass
--no-redirect
to deploy copies - Improve the default redirect template to support redirection when the user has disabled JavaScript
- Allow deploying docs to a subdirectory within the target branch via
--prefix
- Add support for custom templates with
mike set-default
- Read from
remote_branch
andremote_name
if set inmkdocs.yml
- Allow updating an existing alias with
mike alias -u
Breaking changes
- Require Python 3.6+
- Remove support for installing extras for
material
theme sincematerial
now has [built-in support][material-mike] for mike
Bug fixes
- Canonical URLs in generated documentation now point to the correct location
mike alias
now checks for existing aliases to prevent erroneously setting an alias for two different versions- Replace
packaging
dependency withverspec
for future stability - Validate version and alias names to ensure they're non-empty and don't contain a directory separator