Wiki: docs: How to create side navigation?

[bennycode]

In the Wiki.js documentation I have seen that it's possible to create a very nice looking side navigation (like "All Pages" -> "Wiki.js" -> "Admin Guide"). How can this be achieved? I already created directories and subdirectories in my GitHub repository (which syncs with my Wiki.js installation) but these directories don't show up as clickable menu items. 😢

This is what I want to build:

[NGPixel]

Directories are not actual pages. You must create a page inside for them to appear in the navigation.

[bennycode]

I created a Markdown page inside the newly created directories but they didn't show up in my navigation. 😢

I looked up this directory to get a grasp of what's going on. In the screenshot it's shown that the sidebar navigation is named "Admin Guide" but the folder inside the "Requarks/docs" repo is just called "admin-guide", so how does the translation (from "admin-guide" directory to "Admin Guide" navigation) happen?

[NGPixel]

Your folders (and files) must follow the kebab case naming if you create them outside Wiki.js. Otherwise they won't be indexed properly.

Names are automatically converted back to normal case when displayed. e.g. admin-guide becomes Admin Guide

[bennycode]

Thanks for the info!

Instead of naming my directory "Curriculum", I named it "the-curriculum" and it was picked up by the automatic GitHub synchronization. 👍

[el3ctrician]

can we keep this sidebar fixed ? when you open a page it disappears is there is a way to keep the folder structure ?

[Frankstar]

@el3ctrician i would love this feature too - but i dont think it makes sense to discuss it here - open a new issue/feautre request

the best solution would be to have an option to fix it or show breadcrumbs top/bottom of the page
(mayb this is planned for 2.0 anyways)