Folders or grouping pages in GitHub Wikis #23914
-
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 |
Beta Was this translation helpful? Give feedback.
Replies: 43 comments 19 replies
-
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, |
Beta Was this translation helpful? Give feedback.
-
Hi! @matthewheath Thanks so much again and best regards. |
Beta Was this translation helpful? Give feedback.
-
Hello @dknacht, Sure — they’re just HTML code using list elements. The actual code would look something like
That would then give you a nested list like the image shows. |
Beta Was this translation helpful? Give feedback.
-
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 |
Beta Was this translation helpful? Give feedback.
-
Please implement this! I’m sendin a message to support as well. |
Beta Was this translation helpful? Give feedback.
-
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! |
Beta Was this translation helpful? Give feedback.
-
Hi, where exactly do you add the HTML formating for the list? In the first page of the section which you want to create? |
Beta Was this translation helpful? Give feedback.
-
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 |
Beta Was this translation helpful? Give feedback.
-
Please implement this feature. GitLab Wiki does this and it’s really useful |
Beta Was this translation helpful? Give feedback.
-
please implement this. i also contacted support for this |
Beta Was this translation helpful? Give feedback.
-
We need this feature desperately. Maintaining Wiki with more than a few pages is very impractical under current functionality. Thank you. 🙏🏻 |
Beta Was this translation helpful? Give feedback.
-
Adding my support. |
Beta Was this translation helpful? Give feedback.
-
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 |
Beta Was this translation helpful? Give feedback.
-
PLEASE add this :) |
Beta Was this translation helpful? Give feedback.
-
Pretty please add this feature :) |
Beta Was this translation helpful? Give feedback.
-
I found the following project that works around this using custom sidebar (although not perfect) https://github.com/adriantanasa/github-wiki-sidebar You can see an example here: |
Beta Was this translation helpful? Give feedback.
-
Wiki has grown on our project, would love to have nested pages to organize. |
Beta Was this translation helpful? Give feedback.
-
Also voicing in that I started using Pages in one project, ran into this, and now it feels stunted. I'm actively avoiding using Pages for other projects solely for this reason. I'm sure your product managers look at the existing adoption of a suite of features (Pages) as a measure to indicate how many users would benefit from a new feature (nesting pages/folders) - but I implore you think of the negative adoption induced by this missing feature, overall adoption of Pages would surely rise! |
Beta Was this translation helpful? Give feedback.
-
A suggestion: Allow users to create a folder structure or sub-pages via forward slashes in the page name. eg page names would create a folder or parent page named "Reference" with two sub-pages, "Function1" and "Function2". Azure Blob Storage uses this concept to create storage folders. I think it's an elegant and simple approach, easy for users to understand. And no doubt easier to code up that some sort of drag and drop functionality, like Confluence has. |
Beta Was this translation helpful? Give feedback.
-
We need this feature! |
Beta Was this translation helpful? Give feedback.
-
+1 |
Beta Was this translation helpful? Give feedback.
This comment was marked as off-topic.
This comment was marked as off-topic.
-
Most wikis allow organizing pages using categories or tags. Utilize these features to group pages by language. Alternatively, consider using templates or naming conventions to distinguish between languages within the page titles. |
Beta Was this translation helpful? Give feedback.
-
It would be great to have this feature, otherwise using Wiki to write and manage documentation is a nightmare for everybody... |
Beta Was this translation helpful? Give feedback.
-
+1 how is this still an issue? ... |
Beta Was this translation helpful? Give feedback.
-
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. |
Beta Was this translation helpful? Give feedback.
-
And here we are again. ⏳ |
Beta Was this translation helpful? Give feedback.
-
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 |
Beta Was this translation helpful? Give feedback.
-
Looks like all the people who worked on this at GH were hit by the layoffs 😐 |
Beta Was this translation helpful? Give feedback.
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