A simple method for providing a quick/dirty reload option (refs #990)

This commit is contained in:
Andrew E Slaughter
2016-07-20 14:44:17 -06:00
parent d790defd85
commit 81664fac4a
6 changed files with 92 additions and 27 deletions

View File

@@ -92,6 +92,26 @@ to support such customization.
[blocks]: ../user-guide/styling-your-docs/#overriding-template-blocks
#### Support for dirty builds. (#990)
For large sites the build time required to create the pages can become problematic,
thus a "dirty" build mode was created. This mode simply compares the modified time
of the generated html and source markdown. If the markdown has changed since the
html then the page is re-constructed. Otherwise, the page remains as is. This mode
may be invoked in both the `mkdocs serve` and `mkdocs build` commands:
```text
mkdocs serve --dirtyreload
```
```text
mkdocs build --dirty
```
It is important to note that this method for building the pages is for development
of content only, since the navigation and other links do not get updated on other
pages.
### Other Changes and Additions to Version 0.16.0
* Bugfix: Support `gh-deploy` command on Windows with Python 3 (#722)