Added support for multiple first-level sidebar headings

[kieran-mackle]

I tidied the sidebar.html code a bit and made it so that you can have multiple first-level sidebar headings.

[vsoch]

We've had multiple requests for this:

• Add multi-layerd drop downs in navigation menu #38
• Question: Multiple first-level entries in sidebar? #12
• Multiple levels of children in _toc.yml? #3

And I've pushed back because it doesn't technically match the docsy theme. But since you've done the work, let's review it! If it's a better design I'm okay with the change. I'll ping the requests on the issues above:

@gregdegruy, @elenalenaelena, @leecalcote, you've all expressed interest in having multiple levels for the menu. Would you care the review the PR here?

[vsoch]

And I’ll make some time to review tomorrow. Stay tuned! :)

[kieran-mackle]

I understand! I just did it for my own site so thought I would share. I am quite new to html but it looked as though there were some missing closing tags in the for loops. Adding them resulted in the behaviour I expected after adding items to toc.yml.
Thanks for reviewing!

[vsoch]

@kieran-mackle so just to verify what I'm seeing (the changes) - the sidebar stays open when you click a link? I don't see another level of nesting (e.g., for the current site if I add another level of children it doesn't show up:

      children:
        - title: Quizzes
          url: "docs/extras/example-quiz"
          children:
          - title: Tags Page
            url: "tags"

Let me know how to reproduce what you changed so I can see (and let me know if it's just that the sidebar stays open, which is very good!)

[vsoch]

Oh I think I see - multiple bolded levels?

This looks great to me - let's give the others a few days to look and review and I definitely think this would be great to have!

[kieran-mackle]

Yes that's correct, the multiple first-level bold headings. Glad you like it!

[vsoch]

I'm going to say let's go ahead with integrating this change - it's indeed very useful and nice looking. The final TODOs for the PR are to:

• bump the version up to 0.0.23 in the root VERSION file
• Add a note to the CHANGELOG to indicate the changes here

And then we can merge and release!

[vsoch]

Thank you again @kieran-mackle ! I tweeted your work as a thank you, feel free to share! https://twitter.com/vsoch/status/1416506158471282688

[kieran-mackle]

No worries! Glad you like it!