Switch to MKDocs

This is a work in progress.

I merged in 6f87b32 from the md3 branch. That branch has all of the
extension docs removed, so they haven't been converted yet. And I
only resolved conflicts and updated mkdocs.yml to the current MkDocs
format.

Addresses Python-Markdown#601.

Author: waylan

INSTALL.md

@@ -5,5 +5,5 @@ As an Admin/Root user on your system do:
 
     pip install markdown
 
-Or for more specific instructions, view the documentation in `docs/install.txt`
-or on the website at <https://pythonhosted.org/Markdown/install.html>.
+Or for more specific instructions, view the documentation in `docs/install.md`
+or on the website at <https://pythonhosted.org/Markdown/install/>.

README.md

@@ -8,23 +8,23 @@
 [![BSD License](http://img.shields.io/badge/license-BSD-yellow.svg)](http://opensource.org/licenses/BSD-3-Clause)
 [![Code of Conduct](https://img.shields.io/badge/code%20of%20conduct-contributor%20covenant-green.svg?style=flat-square)][Code of Conduct]
 
-This is a Python implementation of John Gruber's [Markdown][]. 
+This is a Python implementation of John Gruber's [Markdown][].
 It is almost completely compliant with the reference implementation,
-though there are a few known issues. See [Features][] for information 
-on what exactly is supported and what is not. Additional features are 
+though there are a few known issues. See [Features][] for information
+on what exactly is supported and what is not. Additional features are
 supported by the [Available Extensions][].
 
 [Python-Markdown]: https://pythonhosted.org/Markdown/
 [Markdown]: http://daringfireball.net/projects/markdown/
-[Features]: https://pythonhosted.org/Markdown/index.html#Features
-[Available Extensions]: https://pythonhosted.org/Markdown/extensions/index.html
+[Features]: https://pythonhosted.org/Markdown/index/#Features
+[Available Extensions]: https://pythonhosted.org/Markdown/extensions/
 
 
 Documentation
 -------------
 
 Installation and usage documentation is available in the `docs/` directory
-of the distribution and on the project website at 
+of the distribution and on the project website at
 <https://pythonhosted.org/Markdown/>.
 
 See the change log at <https://pythonhosted.org/Markdown/change_log.html>.
@@ -35,7 +35,7 @@ Support
 You may ask for help and discuss various other issues on the [mailing list][] and report bugs on the [bug tracker][].
 
 [mailing list]: http://lists.sourceforge.net/lists/listinfo/python-markdown-discuss
-[bug tracker]: http://github.com/Python-Markdown/markdown/issues 
+[bug tracker]: http://github.com/Python-Markdown/markdown/issues
 
 Code of Conduct
 ---------------

checkspelling.sh

@@ -1,14 +1,14 @@
 #!/bin/bash
 
 echo "Building docs..."
-python setup.py --quiet build_docs --force
+mkdocs build --clean
 echo "Compiling Dictionary..."
 aspell --lang=en create master ./tmp <.spell-dict
-echo "Checking spelling...\n"
+echo "Checking spelling..."
 
 let "fails=0"
 
-for file in $(find build/docs/ -type f -name "*.html"); do
+for file in $(find site/ -type f -name "*.html"); do
     words=$(aspell list --lang=en --mode=html --add-html-skip=code --extra-dicts=./tmp  <$file)
     if [ "$words" ]; then
         uniquewords=$(tr ' ' '\n' <<< "${words[@]}" | sort -u | tr '\n' ' ')
@@ -22,7 +22,7 @@ for file in $(find build/docs/ -type f -name "*.html"); do
     fi
 done
 rm -f ./tmp
-rm -rf build
+rm -rf site
 
 if [ $fails -gt 0 ]; then
     echo "$fails files with misspelled words."

docs/_template.html

@@ -0,0 +1,58 @@
+title:      Authors
+
+Primary Authors
+===============
+
+*   __[Waylan Limberg](http://achinghead.com/)__
+
+    Waylan is the current maintainer of the code and has written much of the current 
+    code base, included a complete refactor of the core.  He started out by 
+    authoring many of the available extensions and later was asked to join Yuri, 
+    where he began fixing numerous bugs, adding documentation and making general 
+    improvements to the existing code base.
+
+
+*   __[Yuri Takteyev](http://freewisdom.org/)__
+
+    Yuri wrote most of the code found in version 1.x while procrastinating his Ph.D.
+    Various pieces of his code still exist, most notably the basic structure.
+
+*   __[Manfed Stienstra](http://www.dwerg.net/)__
+
+    Manfed wrote the original version of the script and is responsible for 
+    various parts of the existing code base.
+
+*   __Artem Yunusov__
+
+    Artem, who as part of a 2008 GSoC project, refactored inline patterns, 
+    replaced the NanoDOM with ElementTree support and made various other 
+    improvements.
+
+*   __David Wolever__
+
+    David refactored the extension API and made other improvements
+    as he helped to integrate Markdown into Dr.Project.
+
+Other Contributors
+==================
+
+The incomplete list of individuals below have provided patches or otherwise 
+contributed to the project in various ways. We would like to thank everyone 
+who has contributed to the project in any way.
+
+* Eric Abrahamsen
+* Jeff Balogh
+* Sergej Chodarev
+* Chris Clark
+* Tiago Cogumbreiro
+* Kjell Magne Fauske
+* G. Clark Haynes
+* Daniel Krech
+* Steward Midwinter
+* Jack Miller
+* Neale Pickett
+* Paul Stansifer
+* John Szakmeister
+* Malcolm Tredinnick
+* Ben Wilson
+* and many others who helped by reporting bugs