Folders or grouping pages in GitHub Wikis

[ghost]

Hi!

I was working on translating the documentation of a project and I stumble in a problem. How to organize documentation of diferent languages in a wiki? Is there a way to group pages in folders or in collapsable groups?

As far as I see, all the pages get placed in the same “level”.

Any ideas? thanks in avance.

Dknacht

[ghost]

Hi @dknacht,

While there currently isn’t a way to group pages by folder or in collapsible groups, you could set up a custom sidebar to achieve a similar effect which would allow you to link to each Wiki page in categorised lists. It might also be worth contacting GitHub Support to note this as a feature request.

Would something like that work for you? ​If there’s anything else I can help you with, let me know; so happy to help further!

Kindest regards,
Matthew

[tormung83]

The answer is simple: GitHub does not support this feature and it won't support it anytime soon. I got a response from Support stating this is not in their roadmap.
I will cancel my Pro subscription for now but continue using the free version and move my project to GitBook as it offers what GitHub can't right now.
Then I will just integrate it with GitHub. Here are some tutorials that convinced me to move to GitBook.
(18) GitBook - Getting started - YouTube
(18) GitBook - GitHub integration - YouTube

[pythoninthegrass]

Good find @tormung83. Seems like such a basic feature and disappointing that we have to resort to third-party sites to implement it.

[ghost]

Hi! @matthewheath
Thanks so much for your answer.
I will check the custom sidebars, it looks like they are going to do the job.
In this page the image shows pages listed in embedded lists. Do you know how to make this?

Thanks so much again and best regards.
Dknacht.

[ghost]

Hello @dknacht,

Sure — they’re just HTML code using list elements.

The actual code would look something like

<ul>
  <li>Top level page
    <ul>
      <li>Sub-page</li>
      <li>Sub-page two</li>
    </ul>
</li>
</ul>

That would then give you a nested list like the image shows.

[ghost]

Great!,

That’s what I needed.

I am going to conact github support tho so see if they can implement something.

Thanks man!

Have a good day!.

Dknacht

[berto]

Please implement this! 

I’m sendin a message to support as well.

[ThirdEyeRose]

Hi @dknacht and @tallberto,

Thanks for this feedback! We’re always working to improve GitHub and the GitHub Community Forum, and we consider every suggestion we receive. I’ve logged your feature request in our internal feature request list. Though I can’t guarantee anything or share a timeline for this, I can tell you that it’s been shared with the appropriate teams for consideration.

Please let me know if you have any other questions.

Thanks!

[tormung83]

Hello, @ThirdEyeRose did this feature ever made it to the discussion table? I personally need to work on a Wiki project and a Side bar is not really what I'm really looking for. I need to place notes (pages) inside folders or collapsable pages.

[ThirdEyeRose]

Unfortunately, I do not know. I left GitHub a few years ago. During that time, I had very little insight into the product roadmap as a support person.

[rusioana]

Hi, where exactly do you add the HTML formating for the list? In the first page of the section which you want to create?

[MarkBennett12]

I’m trying to do this too and I cannot get it to work, I’ve googled it extensively and found a couple of links, specifically https://github.com/tajmone/github-tests/wiki/subpage, https://stackoverflow.com/questions/11088285/github-wiki-directories and https://github.com/KirstieJane/STEMMRoleModels/wiki/Creating-new-folders-in-GitHub-repository-via-the-browser

When I try it, I don’t get anything like a subfolder, just a new file with the path as it’s name and the forward slashes replaced with space, like this

subfolder subpage.md

When I try creating the sub sidebar it just overwrites the original sidebar and the Create Custom Sidebar dissapears, which is not what I want.

I know this can be done because I’ve seen several github wikis which do this. But I don’t know exactly how. Please help, going slightly nuts here

[demisx]

Please implement this feature. GitLab Wiki does this and it’s really useful

[bisdevres]

please implement this.

i also contacted support for this

[demisx]

We need this feature desperately. Maintaining Wiki with more than a few pages is very impractical under current functionality. Thank you. 🙏🏻

[abalter]

Adding my support.

[TonyWhiteSMS]

Having to replace a Confluence site with GitHub wiki as business won't pay for enough licences to make Confluence accessible by those that need it. Folders and grouping really are needed

[jakurll]

PLEASE add this :)

[knassre-cmu]

Pretty please add this feature :)

[C5H8NNaO4]

+1 how is this still an issue? ...

[XavierEymard]

I dunno if my answer is appropriate but you can numbering your pages with 1, 1.1, 1.2, 1.2.1 - blabla. it will create an unlimited hierarchy. BUT you won't be able to exceed the 0 to 9 main chapters with this numbering plan. Hope it helps.

[joaoluiz-tw-em]

And here we are again. ⏳

[binkley]

I tried an experiment of:

cd $MY_WIKI_REPO
mkdir test
echo '# Test wiki organizing' >test/Test.md
git add .
git commit -m 'Testing wiki organizing'
git push

I can find my "Test" page in the "Pages" droplist in the navbar, however there is no directory structure preserved, no mention of the "test" directory. This one simple thing would immediately open to me ways of structuring the large GitHub wiki I work on. Presently we fallback on edits to _Sidebar.md and a Home.md page with a handmade table of contents.

[davidvc]

[Arcanorum]

Looks like all the people who worked on this at GH were hit by the layoffs 😐

[HotNoob]

y no github implement a needed and low maintence feature that can be added in 5 minutes?

[Waterstraal]

+1

Is this on a roadmap item I can track? Or is this feature not planned at all? I would be interested to know before I migrate my wiki over.

Thanks

[Arcanorum]

"As an AI language model..."

[LiteBrite82]

Hi @1543siddhant

We’ve clarified our stance on using generative AI tools like ChatGPT within our Community via this announcement. Please review the guidelines to ensure your post meets them as failure to adhere to those rules can result in action taken by our moderator team.  You can read our updated Code of Conduct and the announcement for more details. Thank you for helping us maintain an authentic and beneficial space for everyone.

[tsmcgrath]

Categories, Tags, Namespaces, used to replace hierarchies all are hacks that do not replace the core functionality of a folder hierarchy that 1) organizes and 2) hides non-relevant pages. Table of Contents should be automatically generated from folders (like a chapter) and heading level. This is a core feature of other Wikis and makes them functional for any organization with more than one individual. Without it, this is a drastically neutered feature. I live with the neutered feature set of Github Projects but don't like it. I cannot use the neutered feature set of Github Wikis.

[carlitoplatanito]

Just curious, if you clone the wiki and edit it that way - even if not displayed on GitHub correctly, the folders are tech still in the repo when/if others clone it as well right?

[dxm1244]

It's an embarrassment that GitHub didn't have this feature SIX years ago when this issue was created. Even more now.

[JonathanDHolden]

I've just paid for GitHub wiki, only to discover that it's unusable as there are no folders.

Looks like it's time for a chargeback.

[gabezurita]

The need for Github WIki folders has been a request for at least 12 years:
https://stackoverflow.com/questions/11088285/github-wiki-directories

Here is some additional history:
https://github.com/orgs/community/discussions/14020