Converted extension docs to mkdocs.

waylan · waylan · commit 3d1c70c597c5 · 2017-12-06T15:18:20.000-05:00
diff --git a/.gitignore b/.gitignore
@@ -6,6 +6,7 @@ test-output.html
 build/*
 dist/*
 tmp/*
+site/*
 MANIFEST
 .venv
 *~
diff --git a/docs/extensions/abbreviations.md b/docs/extensions/abbreviations.md
@@ -1,8 +1,4 @@
-title:      Abbreviations Extension
-prev_title: Extra Extension
-prev_url:   extra.html
-next_title: Attribute Lists Extension
-next_url:   attr_list.html
+title: Abbreviations Extension
 
 Abbreviations
 =============
@@ -39,7 +35,7 @@ will be rendered as:
 Usage
 -----
 
-See [Extensions](index.html) for general extension usage, specify `markdown.extensions.abbr`
+See [Extensions](index.md) for general extension usage, specify `markdown.extensions.abbr`
 as the name of the extension.
 
 This extension does not accept any special configuration options.
diff --git a/docs/extensions/admonition.md b/docs/extensions/admonition.md
@@ -1,8 +1,4 @@
-title:      Admonition Extension
-prev_title: Smart Strong Extension
-prev_url:   smart_strong.html
-next_title: CodeHilite Extension
-next_url:   code_hilite.html
+title: Admonition Extension
 
 Admonition
 ==========
diff --git a/docs/extensions/api.md b/docs/extensions/api.md
@@ -1,8 +1,4 @@
 title:      Extensions API
-prev_title: WikiLinks Extension
-prev_url:   wikilinks.html
-next_title: Test Suite
-next_url:   ../test_suite.html
 
 Writing Extensions for Python-Markdown
 ======================================
diff --git a/docs/extensions/attr_list.md b/docs/extensions/attr_list.md
@@ -1,8 +1,4 @@
-title:      Attribute Lists Extension
-prev_title: Abbreviations Extension
-prev_url:   abbreviations.html
-next_title: Definition Lists Extension
-next_url:   definition_lists.html
+title: Attribute Lists Extension
 
 Attribute Lists
 ===============
@@ -82,7 +78,7 @@ The above results in the following output:
 Usage
 -----
 
-See [Extensions](index.html) for general extension usage, specify `markdown.extensions.attr_list`
-as the name of the extension.
+See [Extensions](index.md) for general extension usage, specify
+`markdown.extensions.attr_list` as the name of the extension.
 
 This extension does not accept any special configuration options.
diff --git a/docs/extensions/code_hilite.md b/docs/extensions/code_hilite.md
@@ -1,8 +1,4 @@
-title:      CodeHilite Extension
-prev_title: Admonition Extension
-prev_url:   admonition.html
-next_title: HeaderId Extension
-next_url:   header_id.html
+title: CodeHilite Extension
 
 CodeHilite
 ==========
@@ -162,10 +158,10 @@ Lets see the source for that:
 Usage
 -----
 
-See [Extensions](index.html) for general extension usage, specify
+See [Extensions](index.md) for general extension usage, specify
 `markdown.extensions.codehilite` as the name of the extension.
 
-See the [Library Reference](../reference.html#extensions) for information about
+See the [Library Reference](../reference.md#extensions) for information about
 configuring extensions.
 
 The following options are provided to configure the output:
diff --git a/docs/extensions/definition_lists.md b/docs/extensions/definition_lists.md
@@ -1,8 +1,4 @@
-title:      Definition Lists Extension
-prev_title: Attribute Lists Extension
-prev_url:   attr_list.html
-next_title: Fenced Code Blocks Extension
-next_url:   fenced_code_blocks.html
+title: Definition Lists Extension
 
 Definition Lists
 ================
@@ -47,7 +43,7 @@ will be rendered as:
 Usage
 -----
 
-See [Extensions](index.html) for general extension usage, specify `markdown.extensions.def_list`
-as the name of the extension.
+See [Extensions](index.md) for general extension usage, specify
+`markdown.extensions.def_list` as the name of the extension.
 
 This extension does not accept any special configuration options.
diff --git a/docs/extensions/extra.md b/docs/extensions/extra.md
@@ -1,8 +1,4 @@
-title:      Extra Extension
-prev_title: Extensions
-prev_url:   index.html
-next_title: Abbreviations Extension
-next_url:   abbreviations.html
+title: Extra Extension
 
 Python-Markdown Extra
 =====================
@@ -15,13 +11,13 @@ A compilation of various Python-Markdown extensions that (mostly) imitates
 
 The supported extensions include:
 
-* [Abbreviations](abbreviations.html)
-* [Attribute Lists](attr_list.html)
-* [Definition Lists](definition_lists.html)
-* [Fenced Code Blocks](fenced_code_blocks.html)
-* [Footnotes](footnotes.html)
-* [Tables](tables.html)
-* [Smart Strong](smart_strong.html)
+* [Abbreviations](abbreviations.md)
+* [Attribute Lists](attr_list.md)
+* [Definition Lists](definition_lists.md)
+* [Fenced Code Blocks](fenced_code_blocks.md)
+* [Footnotes](footnotes.md)
+* [Tables](tables.md)
+* [Smart Strong](smart_strong.md)
 
 See each individual extension for syntax documentation. Extra and all its 
 supported extensions are included in the standard Markdown library.
@@ -34,13 +30,13 @@ From the Python interpreter:
     >>> import markdown
     >>> html = markdown.markdown(text, ['markdown.extensions.extra'])
 
-There may be [additional extensions](index.html) that are distributed with
+There may be [additional extensions](index.md) that are distributed with
 Python-Markdown that are not included here in Extra. The features 
 of those extensions are not part of PHP Markdown Extra, and 
 therefore, not part of Python-Markdown Extra. If you really would 
 like Extra to include additional extensions, we suggest creating 
 your own clone of Extra under a different name 
-(see the [Extension API](api.html)).  
+(see the [Extension API](api.md)).  
 
 Markdown Inside HTML Blocks
 ---------------------------
diff --git a/docs/extensions/fenced_code_blocks.md b/docs/extensions/fenced_code_blocks.md
@@ -1,8 +1,4 @@
-title:      Fenced Code Blocks Extension
-prev_title: Definition Lists Extension
-prev_url:   definition_lists.html
-next_title: Footnotes Extension
-next_url:   footnotes.html
+title: Fenced Code Blocks Extension
 
 Fenced Code Blocks
 ==================
@@ -106,7 +102,7 @@ The lines can be specified with PHP Extra's syntax:
 Usage
 -----
 
-See [Extensions](index.html) for general extension usage, specify `markdown.extensions.fenced_code`
-as the name of the extension.
+See [Extensions](index.md) for general extension usage, specify
+`markdown.extensions.fenced_code` as the name of the extension.
 
 This extension does not accept any special configuration options.
diff --git a/docs/extensions/footnotes.md b/docs/extensions/footnotes.md
@@ -1,8 +1,4 @@
-title:      Footnotes Extension
-prev_title: Fenced Code Blocks Extension
-prev_url:   fenced_code_blocks.html
-next_title: Tables Extension
-next_url:   tables.html
+title: Footnotes Extension
 
 Footnotes
 =========
@@ -64,10 +60,10 @@ is indented consistently and any errors are more easily discernible by the autho
 Usage
 -----
 
-See [Extensions](index.html) for general extension usage, specify `markdown.extensions.footnotes`
-as the name of the extension.
+See [Extensions](index.md) for general extension usage, specify
+`markdown.extensions.footnotes` as the name of the extension.
 
-See the [Library Reference](../reference.html#extensions) for information about
+See the [Library Reference](../reference.md#extensions) for information about
 configuring extensions.
 
 The following options are provided to configure the output:
diff --git a/docs/extensions/header_id.md b/docs/extensions/header_id.md
@@ -1,8 +1,4 @@
-title:      HeaderId Extension
-prev_title: CodeHilite Extension
-prev_url:   code_hilite.html
-next_title: Meta-Data Extension
-next_url:   meta_data.html
+title: HeaderId Extension
 
 HeaderId
 ========
@@ -20,7 +16,7 @@ This extension is included in the standard Markdown library.
     Extension should be used instead, which offers most the features of this
     extension and more.
     
-[toc]: toc.html
+[toc]: toc.md
 
 Syntax
 ------
@@ -42,10 +38,10 @@ Results in:
 Usage
 -----
 
-See [Extensions](index.html) for general extension usage, specify `markdown.extensions.headerid`
-as the name of the extension.
+See [Extensions](index.md) for general extension usage, specify
+`markdown.extensions.headerid` as the name of the extension.
 
-See the [Library Reference](../reference.html#extensions) for information about
+See the [Library Reference](../reference.md#extensions) for information about
 configuring extensions.
 
 The following options are provided to configure the output:
@@ -74,7 +70,7 @@ The following options are provided to configure the output:
 
     The `forceid` setting turns on or off the automatically generated ids for 
     headers that do not have one explicitly defined (using the
-    [Attribute List](attr_list.html) extension).
+    [Attribute List](attr_list.md) extension).
 
         >>> text = '''
         ... # Some Header
@@ -103,7 +99,7 @@ The following options are provided to configure the output:
 Using with Meta-Data
 --------------------
 
-The HeaderId extension also supports the [Meta-Data](meta_data.html) extension.
+The HeaderId extension also supports the [Meta-Data](meta_data.md) extension.
 Please see the documentation for that extension for specifics. The supported 
 meta-data keywords are:
 
diff --git a/docs/extensions/index.md b/docs/extensions/index.md
@@ -1,9 +1,4 @@
-title:      Extensions
-prev_title: Command Line
-prev_url:   ../cli.html
-next_title: Extra Extension
-next_url:   extra.html
-
+title: Extensions
 
 Available Extensions
 ====================
diff --git a/docs/extensions/meta_data.md b/docs/extensions/meta_data.md
@@ -1,8 +1,4 @@
-title:      Meta-Data Extension
-prev_title: HeaderId Extension
-prev_url:   header_id.html
-next_title: New Line to Break Extension
-next_url:   nl2br.html
+title: Meta-Data Extension
 
 Meta-Data
 =========
@@ -59,8 +55,8 @@ by Markdown.
 Usage
 -----
 
-See [Extensions](index.html) for general extension usage, specify `markdown.extensions.meta`
-as the name of the extension.
+See [Extensions](index.md) for general extension usage, specify
+`markdown.extensions.meta` as the name of the extension.
 
 Accessing the Meta-Data
 -----------------------
@@ -101,10 +97,10 @@ Compatible Extensions
 The following extensions are currently known to work with the Meta-Data 
 extension. The keywords they are known to support are also listed.
 
-* [HeaderId](header_id.html)
+* [HeaderId](header_id.md)
     * `header_level`
     * `header_forceid`
-* [WikiLinks](wikilinks.html)
+* [WikiLinks](wikilinks.md)
     * `wiki_base_url`
     * `wiki_end_url`
     * `wiki_html_class`
diff --git a/docs/extensions/nl2br.md b/docs/extensions/nl2br.md
@@ -1,8 +1,4 @@
-title:      New Line to Break Extension
-prev_title: Meta-Data Extension
-prev_url:   meta_data.html
-next_title: Sane Lists Extension
-next_url:   sane_lists.html
+title: New Line to Break Extension
 
 New-Line-to-Break Extension
 ===========================
@@ -31,7 +27,7 @@ Example
 Usage
 -----
 
-See [Extensions](index.html) for general extension usage, specify `markdown.extensions.nl2br`
-as the name of the extension.
+See [Extensions](index.md) for general extension usage, specify
+`markdown.extensions.nl2br` as the name of the extension.
 
 This extension does not accept any special configuration options.
diff --git a/docs/extensions/sane_lists.md b/docs/extensions/sane_lists.md
@@ -1,8 +1,4 @@
-title:      Sane Lists Extension
-prev_title: New Line to Break Extension
-prev_url:   nl2br.html
-next_title: SmartyPants Extension
-next_url:   smarty.html
+title: Sane Lists Extension
 
 Sane Lists
 ==========
@@ -67,7 +63,7 @@ In all other ways, Sane Lists should behave as normal Markdown lists.
 Usage
 -----
 
-See [Extensions](index.html) for general extension usage, specify `markdown.extensions.sane_lists`
-as the name of the extension.
+See [Extensions](index.md) for general extension usage, specify
+`markdown.extensions.sane_lists` as the name of the extension.
 
 This extension does not accept any special configuration options.
diff --git a/docs/extensions/smart_strong.md b/docs/extensions/smart_strong.md
@@ -1,8 +1,4 @@
-title:      Smart Strong Extension
-prev_title: Tables Extension
-prev_url:   tables.html
-next_title: Admonition Extension
-next_url:   admonition.html
+title: Smart Strong Extension
 
 Smart_Strong
 ============
@@ -35,7 +31,7 @@ Example
 Usage
 -----
 
-See [Extensions](index.html) for general extension usage, specify `markdown.extensions.smart_strong`
-as the name of the extension.
+See [Extensions](index.md) for general extension usage, specify
+`markdown.extensions.smart_strong` as the name of the extension.
 
 This extension does not accept any special configuration options.
diff --git a/docs/extensions/smarty.md b/docs/extensions/smarty.md
@@ -1,8 +1,4 @@
 title: SmartyPants Extension
-prev_title: Sane Lists Extension
-prev_url:   sane_lists.html
-next_title: Table of Contents Extension
-next_url:   toc.html
 
 SmartyPants
 ===========
@@ -55,10 +51,10 @@ the German language:
 Usage
 -----
 
-See [Extensions](index.html) for general extension usage, specify 
+See [Extensions](index.md) for general extension usage, specify 
 `markdown.extensions.smarty` as the name of the extension.
 
-See the [Library Reference](../reference.html#extensions) for information about
+See the [Library Reference](../reference.md#extensions) for information about
 configuring extensions.
 
 The following options are provided to configure the output:
diff --git a/docs/extensions/tables.md b/docs/extensions/tables.md
@@ -1,8 +1,4 @@
-title:      Tables Extension
-prev_title: Footnotes Extension
-prev_url:   footnotes.html
-next_title: Smart Strong Extension
-next_url:   smart_strong.html
+title: Tables Extension
 
 Tables
 ======
@@ -52,7 +48,7 @@ will be rendered as:
 Usage
 -----
 
-See [Extensions](index.html) for general extension usage, specify `markdown.extensions.tables`
-as the name of the extension.
+See [Extensions](index.md) for general extension usage, specify
+`markdown.extensions.tables` as the name of the extension.
 
 This extension does not accept any special configuration options.
diff --git a/docs/extensions/toc.md b/docs/extensions/toc.md
diff --git a/docs/extensions/wikilinks.md b/docs/extensions/wikilinks.md
diff --git a/docs/siteindex.md b/docs/siteindex.md
diff --git a/mkdocs.yml b/mkdocs.yml

-Original file line number
+Diff line change
 build/*
 dist/*
 tmp/*
 +site/*
 MANIFEST
 .venv
 *~