Releases: pozgo/docker-mkdocs
1.5.2
1.4.2
1.2.2
1.1.2
Version 1.1.2 (2020-05-14)
Bugfix: Normalize IP addresses and change unsupported address error to a warning (#2108).
Version 1.1.1 (2020-05-12)
Bugfix: Allow compressed sitemap to be deterministic by supporting the SOURCE_DATE_EPOCH environment variable (#2100).
Bugfix: Use README.md as index.html even if use_directory_urls is false (#2081).
Bugfix: Ignore links which start with a backslash (#1680).
Bugfix: Pass builder to the on_serve event so that it can be passed to server.watch by plugins (#1952).
Bugfix: Use lunr[languages]==0.5.8 to avoid nltk incompatibilities (#2062).
Bugfix: Ensure wheel is Python 3 only (#2021).
Bugfix: Clean up dev_addr validation and disallow 0.0.0.0 (#2022).
Add support for min_search_length parameter for search plugin (#2014).
Bugfix: readthedocs theme code colors (#2027).
1.1.0
ersion 1.1 (2020-02-22)
Major Additions to Version 1.1
Support for Lunr.py as prebuild_index engine
Mkdocs now supports prebuilding indices using Lunr.py, a pure Python implementation of Lunr.js, allowing the user to avoid installing a NodeJS environment if so desired. For more information please read the prebuild_index documentation.
readthedocs theme updated with upstream (#588 and #1374)
The readthedocs theme now more closely matches the upstream Sphinx theme (version 0.4.1). A number of new theme configuration settings were added which mirror the upstream configuration options. See the theme documentation for details.
Update mkdocs theme to Bootswatch 4.1.3 (#1563)
The mkdocs theme now supports all the features of Bootswatch 4.1. Additionaly, 2 filenames were changed in this update. If you are using a theme which inherits from the mkdocs theme, the theme developer may need to update these filenames as follows.
css/bootstrap-custom.min.css => css/bootstrap.min.css
js/bootstrap-3.0.3.min.js => js/bootstrap.min.js
Improved configuration support on the command line (#1401)
The build, serve, and gh-deploy subcommands now support flags to control whether directory URLs should be created: --use-directory-urls / --no-directory-urls. In addition, the gh-deploy subcommand now supports all the configuration options that build and serve do, adding --strict, --theme, --theme-dir, and --site-dir.
Updated lunr-languages support (#1729)
The lunr-languages plugin has been updated to 1.4.0, adding support for Arabic (ar) and Vietnamese (vi) languages. In addition, the Dutch and Japanese language codes have been changed to their standard values: nl and ja, respectively. The old language codes (du and jp) remain as aliases but may be removed in a future version of MkDocs.
Other Changes and Additions to Version 1.1
Bugfix: Ensure nested dot files in themes are ignored and document behavior (#1981).
Update minimum dependancy to Markdown 3.2.1.
Updated minimum dependancy to Jinja 2.10.1 to address security concerns (#1780).
Update to lunr.js 2.3.8 (#1989).
Add support for Python 3.8.
Drop support for Python 3.4.
Drop support for Python 2.7. MkDocs is PY3 only now (#1926).
Bugfix: Select appropriate asyncio event loop on Windows for Python 3.8+ (#1885).
Bugfix: Ensure nested index pages do not get identified as the homepage (#1919).
Bugfix: Properly identify deployment version (#1879).
Bugfix: Properly build ValidationError message for custom_dir (#1849).
Bugfix: Exclude Markdown files and READMEs from theme (#1766).
Bugfix: Account for encoded URLs (#1670).
Bugfix: Ensure theme files do not override docs_dir files (#1671).
Bugfix: Do not normalize URL fragments (#1655).
Bugfix: Skip external URLs in sitemap.xml (#1742).
Bugfix: Ensure theme files do not override docs_dir files on Windows (#1876)
Add canonical tag to readthedocs theme (#1669).
Improved error message for when git is not available.
Add support for nav_style theme option for the mkdocs theme (#1930).
Bugfix: Long/nested dropdowns now behave more consistently for the mkdocs theme (#1234).
Bugfix: Multi-row nav headers in the mkdocs theme no longer obscure the document content (#716).
Add support for navigation_depth theme option for the mkdocs theme (#1970).
level attribute in page.toc items is now 1-indexed to match the level in tags (#1970).
Version 1.0.4 (2018-09-07)
1.0.4
0.17.2
0.17.1
Version 0.17.1 (2017-10-30)
- Bugfix: Support
repo_url
with missing ending slash. (#1321). - Bugfix: Add length support to
mkdocs.toc.TableOfContext
(#1325). - Bugfix: Add some theme specific settings to the search plugin for third party
themes (#1316). - Bugfix: Override
site_url
withdev_addr
on local server (#1317).
0.17.0
Version 0.17.0 (2017-10-19)
Major Additions to Version 0.17.0
Plugin API. (#206)
A new Plugin API has been added to MkDocs which allows users to define their
own custom behaviors. See the included documentation for a full explanation of
the API.
The previously built-in search functionality has been removed and wrapped in a
plugin (named "search") with no changes in behavior. When MkDocs builds, the
search index is now written to search/search_index.json
instead of
mkdocs/search_index.json
. If no plugins setting is defined in the config,
then the search
plugin will be included by default. See the
configuration documentation for information on overriding the
default.
Theme Customization. (#1164)
Support had been added to provide theme specific customizations. Theme authors
can define default options as documented in Theme Configuration. A theme can
now inherit from another theme, define various static templates to be rendered,
and define arbitrary default variables to control behavior in the templates.
The theme configuration is defined in a configuruation file named
mkdocs_theme.yml
which should be placed at the root of your template files. A
warning will be raised if no configuration file is found and an error will be
raised in a future release.
Users can override those defaults under the theme configuration option of
their mkdocs.yml
configuration file, which now accepts nested options. One
such nested option is the custom_dir option, which replaces the now deprecated
theme_dir
option. If users had previously set the theme_dir
option, a
warning will be issued, with an error expected in a future release.
If a configuration previously defined a theme_dir
like this:
theme: mkdocs
theme_dir: custom
Then the configuration should be adjusted as follows:
theme:
name: mkdocs
custom_dir: custom
See the theme configuration option documentation for details.
Previously deprecated Template variables removed. (#1168)
Page Template
The primary entry point for page templates has been changed from base.html
to
main.html
. This allows base.html
to continue to exist while allowing users
to override main.html
and extend base.html
. For version 0.16, base.html
continued to work if no main.html
template existed, but it raised a
deprecation warning. In version 1.0, a build will fail if no main.html
template exists.
Context Variables
Page specific variable names in the template context have been refactored as
defined in Custom Themes. The
old variable names issued a warning in version 0.16, but have been removed in
version 1.0.
Any of the following old page variables should be updated to the new ones in
user created and third-party templates:
Old Variable Name | New Variable Name |
---|---|
current_page | page |
page_title | page.title |
content | page.content |
toc | page.toc |
meta | page.meta |
canonical_url | page.canonical_url |
previous_page | page.previous_page |
next_page | page.next_page |
Additionally, a number of global variables have been altered and/or removed
and user created and third-party templates should be updated as outlined below:
Old Variable Name | New Variable Name or Expression |
---|---|
current_page | page |
include_nav | nav|length>1 |
include_next_prev | (page.next_page or page.previous_page) |
site_name | config.site_name |
site_author | config.site_author |
page_description | config.site_description |
repo_url | config.repo_url |
repo_name | config.repo_name |
site_url | config.site_url |
copyright | config.copyright |
google_analytics | config.google_analytics |
homepage_url | nav.homepage.url |
favicon | {{ base_url }}/img/favicon.ico |
Auto-Populated extra_css and extra_javascript Fully Deprecated. (#986)
In previous versions of MkDocs, if the extra_css
or extra_javascript
config
settings were empty, MkDocs would scan the docs_dir
and auto-populate each
setting with all of the CSS and JavaScript files found. On version 0.16 this
behavior was deprecated and a warning was issued. In 1.0 any unlisted CSS and
JavaScript files will not be included in the HTML templates, however, a warning
will be issued. In other words, they will still be copied to the site-dir
, but
they will not have any effect on the theme if they are not explicitly listed.
All CSS and javaScript files in the docs_dir
should be explicitly listed in
the extra_css
or extra_javascript
config settings going forward.
Other Changes and Additions to Version 0.17.0
- Add "edit Link" support to MkDocs theme (#1129)
- Open files with
utf-8-sig
to account for BOM (#1186) - Symbolic links are now followed consistently (#1134)
- Support for keyboard navigation shortcuts added to included themes (#1095)
- Some refactoring and improvements to config_options (#1296)
- Officially added support for Python 3.6 (#1296)
- 404 Error page added to readthedocs theme (#1296))
- Internal refactor of Markdown processing (#713)
- Removed special error message for mkdocs-bootstrap and mkdocs-bootswatch
themes (#1168) - The legacy pages config is no longer supported (#1168)
- The deprecated
json
command has been removed (#481) - Support for Python 2.6 has been dropped (#165)
- File permissions are no longer copied during build (#1292)
- Support query and fragment strings in
edit_uri
(#1224 & #1273)