ASUP-340

Author: Sychevskyi Henadii

3rdparty/mkdocs/mkdocs/nav.py

@@ -334,7 +334,7 @@ def _follow(config_line, url_context, config, header=None, title=None):
             header.children.append(page)
 
         yield page
-        raise StopIteration
+        return
 
     elif not isinstance(config_line, dict):
         msg = ("Line in 'page' config is of type {0}, dict or string "
@@ -347,15 +347,15 @@ def _follow(config_line, url_context, config, header=None, title=None):
             "config contains an invalid entry: {0}".format(config_line))
     elif len(config_line) == 0:
         log.warning("Ignoring empty line in the pages config.")
-        raise StopIteration
+        return
 
     next_cat_or_title, subpages_or_path = next(iter(config_line.items()))
 
     if isinstance(subpages_or_path, utils.string_types):
         path = subpages_or_path
         for sub in _follow(path, url_context, config, header=header, title=next_cat_or_title):
             yield sub
-        raise StopIteration
+        return
 
     elif not isinstance(subpages_or_path, list):
         msg = ("Line in 'page' config is of type {0}, list or string "

Pipfile

@@ -4,9 +4,9 @@ verify_ssl = true
 name = "pypi"
 
 [packages]
-markdown = ">=3.3,<4"
-pymdown-extensions = ">=9,<11"
-mkdocs = "==1.6.1"
+markdown = {editable = true, path = "3rdparty/markdown"}
+pymdown-extensions = {editable = true, path = "3rdparty/pymdown-extensions"}
+mkdocs = {editable = true, path = "3rdparty/mkdocs"}
 GitPython = "==3.0.6"
 mkdocs_versioned = {editable = true, path = "3rdparty/mkdocs-versioned"}
 markdown-tabs = {editable = true, path = "plugins/markdown-tabs"}

mkdocs.yml

@@ -7,23 +7,20 @@ copyright: Copyright © Virtuozzo, Inc.
 #theme_center_lead: false
 
 
-theme:
-  name: null
-  custom_dir: 'theme/readthedocs'
+theme_dir: './theme/readthedocs'
 repo_url: 'https://github.com/virtuozzo/cloudscripting-docs/edit/master/docs/'
 
 markdown_extensions:
   - admonition
+  - toc
   - tables
   - markdown-tabs
   - markdown.extensions.admonition
   - markdown.extensions.footnotes
   - markdown.extensions.meta
-  - toc:
-      permalink: true
+  - markdown.extensions.toc(permalink=true)
   - pymdownx.arithmatex
-  - pymdownx.betterem:
-      smart_enable: all
+  - pymdownx.betterem(smart_enable=all)
   - pymdownx.caret
   - pymdownx.critic
   - pymdownx.emoji:
@@ -32,11 +29,10 @@ markdown_extensions:
   - pymdownx.magiclink
   - pymdownx.mark
   - pymdownx.smartsymbols
-  - pymdownx.tasklist:
-      custom_checkbox: true
+  - pymdownx.tasklist(custom_checkbox=true)
   - pymdownx.tilde
 
-nav:
+pages:
 
 - GETTING STARTED:
    - Overview: index.md

plugins/markdown-tabs/markdown-tabs.py

@@ -12,10 +12,6 @@
 
 
 class TabsPreprocessor(Preprocessor):
-    def __init__(self, md):
-        # Markdown 3.x expects the Markdown instance here
-        super(TabsPreprocessor, self).__init__(md)
-
     def run(self, lines):
         new_lines = []
         skip_empty_line = False
@@ -44,11 +40,10 @@ def run(self, lines):
 
 
 class TabsExtension(Extension):
-    # Compatible with Markdown 2.x (md, md_globals) and 3.x (md) signatures
-    def extendMarkdown(self, md, md_globals=None):
+    def extendMarkdown(self, md, md_globals):
         md.registerExtension(self)
-        # Use the modern registry API; this works across Markdown 3.x
-        md.preprocessors.register(TabsPreprocessor(md), 'tabs', 25)
+        md.preprocessors["tabs"] = TabsPreprocessor()
+        pass
 
 
 def makeExtension(*args, **kwargs):