Switch docs to mkdocs

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

@@ -23,8 +23,8 @@ on what exactly is supported and what is not. Additional features are
 supported by the [Available Extensions][].
 
 [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
@@ -40,4 +40,4 @@ 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/waylan/Python-Markdown/issues 
+[bug tracker]: http://github.com/Python-Markdown/markdown/issues 

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 renamed to doc_theme/_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

docs/basic.css renamed to doc_theme/basic.css

@@ -1,8 +1,4 @@
 title:      Change Log
-prev_title: Test Suite
-prev_url:   test_suite.html
-next_title: Release Notes for v2.6
-next_url:   release-2.6.html
 
 Python-Markdown Change Log
 =========================
@@ -13,35 +9,35 @@ Mar 8, 2015: Released version 2.6.1 (a bug-fix release). The (new)
 `yaml` option has been removed from the Meta-Data Extension as it was buggy
 (see [#390](https://github.com/waylan/Python-Markdown/issues/390)).
 
-Feb 19, 2015: Released version 2.6 ([Notes](release-2.6.html)).
+Feb 19, 2015: Released version 2.6 ([Notes](release-2.6.md)).
 
 Nov 19, 2014: Released version 2.5.2 (a bug-fix release).
 
 Sept 26, 2014: Released version 2.5.1 (a bug-fix release).
 
-Sept 12, 2014: Released version 2.5.0 ([Notes](release-2.5.html)).
+Sept 12, 2014: Released version 2.5.0 ([Notes](release-2.5.md)).
 
-Feb 16, 2014: Released version 2.4.0 ([Notes](release-2.4.html)).
+Feb 16, 2014: Released version 2.4.0 ([Notes](release-2.4.md)).
 
 Mar 22, 2013: Released version 2.3.1 (a bug-fix release).
 
-Mar 14, 2013: Released version 2.3.0 ([Notes](release-2.3.html))
+Mar 14, 2013: Released version 2.3.0 ([Notes](release-2.3.md))
 
-Nov 4, 2012: Released version 2.2.1 ([Notes](release-2.2.1.html)).
+Nov 4, 2012: Released version 2.2.1 (a bug-fix release).
 
-Jul 5, 2012: Released version 2.2.0 ([Notes](release-2.2.0.html)).
+Jul 5, 2012: Released version 2.2.0 ([Notes](release-2.2.md)).
 
-Jan 22, 2012: Released version 2.1.1 ([Notes](release-2.1.1.html)).
+Jan 22, 2012: Released version 2.1.1 (a bug-fix release).
 
-Nov 24, 2011: Released version 2.1.0 ([Notes](release-2.1.0.html)).
+Nov 24, 2011: Released version 2.1.0 ([Notes](release-2.1.md)).
 
-Oct 7, 2009: Released version 2.0.3.
+Oct 7, 2009: Released version 2.0.3. (a bug-fix release).
 
-Sept 28, 2009: Released version 2.0.2 ([Notes](release-2.0.2.html)).
+Sept 28, 2009: Released version 2.0.2 (a bug-fix release).
 
-May 20, 2009: Released version 2.0.1 ([Notes](release-2.0.1.html)).
+May 20, 2009: Released version 2.0.1 (a bug-fix release).
 
-Mar 30, 2009: Released version 2.0 ([Notes](release-2.0.html)).
+Mar 30, 2009: Released version 2.0 ([Notes](release-2.0.md)).
 
 Mar 8, 2009: Release Candidate 2.0-rc-1.
 

docs/default.css renamed to doc_theme/default.css

@@ -1,8 +1,4 @@
 title:      Release Notes for v2.0
-prev_title: Release Notes for v2.0.1
-prev_url:   release-2.0.1.html
-next_title: Authors
-next_url:   authors.html
 
 Python-Markdown 2.0 Release Notes
 =================================
@@ -26,7 +22,7 @@ extensions, then you should not need to make any changes to your code.
 However, you may want to ensure that any third party extensions you are using
 are compatible with the new API.
 
-The new extension API is fully [documented](extensions/api.html) in the docs. 
+The new extension API is fully [documented](../extensions/api.md) in the docs. 
 Below is a summary of the significant changes:
 
 * The old home-grown NanoDOM has been replaced with ElementTree. Therefore all
@@ -67,7 +63,7 @@ accepts either the extension names as strings or instances of extensions. This
 makes it possible to include multiple extensions in a single module.
 
 Numerous extensions are included in the distribution by default. See
-[available_extensions](extensions/index.html) for a complete list.
+[available_extensions](../extensions/index.md) for a complete list.
 
-See the [Change Log](change_log.html) for a full list of changes.
+See the [Change Log](index.md) for a full list of changes.