oprypin / mkdocs-literate-nav

MkDocs plugin to specify the navigation in Markdown instead of YAML
https://oprypin.github.io/mkdocs-literate-nav
MIT License
73 stars 8 forks source link

Merge_root option #22

Open hendrikp opened 1 year ago

hendrikp commented 1 year ago

Sometimes one has multiple repositories, and wants combined help for them.

The repositories might contain chapters that have to be inserted into the existing chapter hierarchy on root level.

This PR allows for that, up for discussion / change requests.

Sample:

Repo 1 (folder in docs/) SUMMARY.md:

General
    - Chapter1.md*

Repo 2 (folder in docs/) SUMMARY.md:

General
    - Chapter2.md*

Result

(Also works on sub-levels, first occurrence determines order)