improve sorting of pages in natural way

Author: bro-wi

docs/_scripts/generate_reference_pages.py

@@ -3,14 +3,15 @@
 from pathlib import Path
 
 import mkdocs_gen_files
+from natsort import natsorted
 
 nav = mkdocs_gen_files.Nav()
 mod_symbol = '<code class="doc-symbol doc-symbol-nav doc-symbol-module"></code>'
 
 root = Path(__file__).parents[2]
 src = root / "blueprints"
 
-for path in sorted(src.rglob("*.py")):
+for path in natsorted(src.rglob("*.py")):
     module_path = path.relative_to(src).with_suffix("")
     doc_path = path.relative_to(src).with_suffix(".md")
     full_doc_path = Path("API reference", doc_path)

docs/requirements_docs.txt

@@ -5,4 +5,6 @@ mkdocs-open-in-new-tab ~= 1.0.3
 mkdocs-nav-weight ~= 0.2.0
 mkdocs-git-revision-date-localized-plugin ~= 1.2.6
 mkdocstrings[python] ~= 0.27.0
-mkdocs-gen-files ~= 0.5.0
+mkdocs-gen-files ~= 0.5.0
+mkdocs-awesome-nav ~= v3.0.0
+natsorted ~= 8.4.0

mkdocs.yml

@@ -91,6 +91,7 @@ plugins:
             unwrap_annotated: true
             docstring_section_style: list
             show_if_no_docstring: false
+  - awesome-nav
 
 markdown_extensions: 
   - pymdownx.highlight: