Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

GitHub wiki directories

Tags:

github

wiki

Does the wiki that installs with a GitHub repo support directories? Our wiki is cluttered with pages, and we are looking for a way to organize them better.

We tried pulling the repo, creating local directories, and moving things around, but when committed back, the wiki didn't pick up the changes.

like image 543
John Livermore Avatar asked Jun 18 '12 17:06

John Livermore


People also ask

Is there a wiki in GitHub?

Wikis are available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud and GitHub Enterprise Server.

How do GitHub wikis work?

GitHub wikis are themselves git repositories. This means you can keep track of changes to the wiki and accept issues and pull requests to a repository made to contain the wiki. To allow contributors outside of our team to submit pull requests and issues to the wiki, it makes sense to set it up as a separate repository.


2 Answers

I was having the exact same issue and tried variants of what you tried. Nothing stuck. Asked GitHub support about it and received a reply that essentially said "No, but we'll let the developers know that people are interested in this feature."

So the short answer is "No", and the long answer is "No, but maybe in the future."

like image 90
Collin M Avatar answered Sep 22 '22 21:09

Collin M


Actually, it looks like github added support for directories recently.

I was able to do the following:

  • Move an existing markdown file to a new directory.
  • Create a new markdown file in an existing directory (created in the former step).
  • Create a new markdown file in a new directory.

In all cases, the existing pages were still there and new pages were added.

The one constraint that remains is that your file names must be unique. If you have more than one file with the same name, only one of them will show up in the wiki (I'm not sure which.. ).

like image 37
Marco Avatar answered Sep 21 '22 21:09

Marco