Rework parsing logic inside nbdev_sidebar & Auto-add index file onto section

[p4perf4ce]

Why?

#1300 found an issue on nbdev_sidebar being unable to handle multi-level project structure properly (in a way that you think it should do).

Summary

This PR should now handle multi-level structure project correctly.
Additionally, nbdev_sidebar now auto-detect the index file and added them to section.

TL;DR:

• For sidebar, multi-level project structure is now rendered as it is structured.
• For sidebar, user no longer have to add href:/path/to/index manually if there is an index file in the directory.

Proposed change

• Instead of writing yaml directly. files were parsed into a directory structure as a dict then converted into a quarto format by _recursive_parser and dumped to yaml using yaml.dump.
• IndentDumper class were added to correct weird PyYAML indentation style that is not consistent with previous version of sidebar.yaml.
• Instead of adding href manually, any proper index\.* will be added to the section as href: /path/to/index automatically. This behavior is controlled by _recursive_parser(..., set_index: bool = True).

[review-notebook-app]

Check out this pull request on 

See visual diffs & provide feedback on Jupyter Notebooks.

---

Powered by ReviewNB

[p4perf4ce]

Sorry for the very late reply @nesaboz, I've put your suggest change into the PR. But I doubt that this PR will be merged since this repo looks abandoned 😅.

[jph00]

Many thanks - sorry this took so long to merge!