Skip to content

Releases: pozgo/docker-mkdocs

1.5.2

05 Sep 15:11
1bc2937
Compare
Choose a tag to compare
Fix#65: Updated 1.5.2 (#66)

1.4.2

15 Feb 13:56
507cbf6
Compare
Choose a tag to compare
bumped to 1.4.2 (#63)

1.2.2

19 Aug 13:17
378ad6f
Compare
Choose a tag to compare
Update Dockerfile to use most current version of MkDocs (1.2.2) (#55)

1.1.2

30 May 13:28
bda83ca
Compare
Choose a tag to compare

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

24 Mar 19:49
1e211f6
Compare
Choose a tag to compare

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

02 Dec 12:32
c46ca2c
Compare
Choose a tag to compare

MkDocs:

  • Bugfix: Ignore absolute links in Markdown (#1621).

Image:

  • Updated to 1.0.4
  • Added live reload support using variable.

0.17.2

12 Feb 20:37
Compare
Choose a tag to compare

--- Docker Image Changelog ---

  • Added GIT_REPO variable - Allows downloading documentation saved in git based repository
  • Updated Build Status badge to show last Master branch build status
  • FIX - Added verification for missing folders.

0.17.1

02 Jan 20:51
Compare
Choose a tag to compare

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 with dev_addr on local server (#1317).

0.17.0

02 Jan 20:43
Compare
Choose a tag to compare

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)

0.16.3

26 Aug 22:36
Compare
Choose a tag to compare

Version 0.16.3 (2017-04-04)

  • Fix error raised by autoscrolling in the readthedocs theme (#1177)
  • Fix a few documentation typos (#1181 & #1185)
  • Fix a regression to livereload server introduced in 0.16.2 (#1174)