GitHub wiki目录

安装了GitHub仓库的wiki是否支持目录? 我们的wiki杂乱无章,我们正在寻找一种更好地组织它们的方法。

我们尝试了回购,创build本地目录和移动东西,但是当提交时,维基并没有拿起这些变化。

我有完全相同的问题,并尝试了你尝试的变种。 没有卡住。 当被问及GitHub对此的支持并收到回复时,基本上说“不,但我们会让开发人员知道人们对此function感兴趣”。

所以简短的答案是“不”,而长的答案是“不,但也许在将来”。

实际上,看起来github最近增加了对目录的支持。

我能够做到以下几点:

  • 将现有的降价文件移至新目录。
  • 在现有目录中创build一个新的降价文件(在前一步中创build)。
  • 在新目录中创build一个新的降价文件。

在所有情况下,现有的页面仍然在那里,新的页面被添加。

剩下的一个约束是你的文件名必须是唯一的。 如果你有多个同名的文件,其中只有一个会出现在wiki中(我不确定哪个是..)。

github wiki(又名Gollum )确实使用了目录,但是并不像你期望的那样。

咕噜wiki上的文档可以使用一些工作,但这是我主要通过testing发现的。

  • 所有的文件都出现在wiki的根目录,不pipe它们放在回购站的什么地方。
  • _Header_Footer_Sidebar文件是每个目录,但是如果在子文件夹中不存在则inheritance。
  • 文件链接可以是相对于源文件(保持您的文件与您的内容)。

所以,如果你想要命名空间的目录,你是不幸的。 考虑为命名空间使用NS-Pagescheme。

这不是一个理想的解决scheme,但是解决方法是创build一个自定义边栏,在其中创build一个带有指向页面的链接的目录。 我发现这比文件夹更好,因为它允许你有一个链接到多个层次下的单个页面。

其实还有一个限制。 是的,你可以添加1级(所以,1子文件夹)。 但就是这样! 我重构了我的整个文档布局,为组织创build了多个子文件夹层次,但这是一个不行。

我必须说:我对这个Gollum的事情感到震惊。 我很惊讶Github甚至把它拿起来了。