Add support for section_path in nav_repos

CHANGELOG.md

@@ -1,3 +1,9 @@
+## 0.8.4
+
+### Prs in Release
+
+- [Support for `section_path` in `nav_repos`](https://github.com/jdoiro3/mkdocs-multirepo-plugin/pull/169)
+
 ## 0.8.3
 
 ### Prs in Release

README.md

@@ -155,6 +155,8 @@ plugins:
         - name: fast-api
           import_url: https://github.com/tiangolo/fastapi
           imports: [docs/en/docs/index.md]
+          # Puts the repo in the modules/fast-api directory
+          section_path: modules
 
 nav:
   - Backstage:

mkdocs_multirepo_plugin/plugin.py

@@ -52,7 +52,7 @@ class NavRepoConfig:
     name: str
     import_url: str
     imports: List[str] = field(default_factory=list)
-
+    section_path: Optional[str] = None
 
 @dataclass
 class MultirepoConfig:
@@ -247,7 +247,10 @@ def handle_nav_repos_import(
         docs_repo_objs: List[DocsRepo] = []
         for nr in nav_repos:
             import_stmt = parse_repo_url(nr.import_url)
-            name: str = slugify(nr.name)
+            section_slug: str = slugify(nr.name)
+            path = nr.section_path
+            name = f"{path}/{section_slug}" if path is not None else section_slug
+
             # mkdocs config values edit_uri and repo_url aren't set
             if need_to_derive_edit_uris:
                 derived_edit_uri = self.derive_config_edit_uri(

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mkdocs-multirepo-plugin"
-version = "0.8.3"
+version = "0.8.4"
 description = "Build documentation in multiple repos into one site."
 authors = [
     { name="Joseph Doiron", email="josephdoiron1234@yahoo.com" }