mkdocs_gen_files_auto_nav_summary_from_docs_directory.py

1import pathlib
2import mkdocs_gen_files
3
4nav = mkdocs_gen_files.Nav()
5
6for path in sorted(pathlib.Path("docs").rglob("*.md")):
7    file_path = path.relative_to("docs")
8    doc_path = path.relative_to("docs")
9    full_doc_path = pathlib.Path("docs", doc_path)
10
11    # Skip the index file of the navigation itself
12    if doc_path.name == "SUMMARY.md":
13        continue
14
15    # Add the file to the navigation object
16    nav[tuple(file_path.with_suffix("").parts)] = file_path.as_posix()
17
18# Write the generated navigation to SUMMARY.md
19with mkdocs_gen_files.open("SUMMARY.md", "w") as nav_file:
20    nav_file.writelines(nav.build_literate_nav())