GitHub Wiki目录


85

带有GitHub存储库安装的Wiki是否支持目录?我们的Wiki上杂乱无章,我们正在寻找一种更好地组织页面的方法。

我们尝试拉回仓库,创建本地目录以及移动其他内容,但是当提交回去时,Wiki没有接受更改。

Answers:


60

我遇到了完全相同的问题,并尝试了您尝试过的方法。没有卡住。向GitHub询问有关此问题的支持,并且收到的答复基本上是“不,但是我们会让开发人员知道人们对此功能感兴趣”。

因此,简短的答案是“否”,长答案是“否,但将来可能会。”


8
当前的简短答案是“是”。:)
Marco Marco

2
@Marco三年后?GitHub认真对待用户的要求!:|
trejder 2015年

9
是的,五年后仍然没有
林肯·伯根森

1
六年。顺便说一句,听到有人抱怨#Microsoft将#GitHub带回了办公室。今天我实在太令人失望了,我想我现在可以面对他们笑。
DevOvercome


30

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

我能够做到以下几点:

  • 将现有的markdown文件移动到新目录。
  • 在现有目录中创建新的markdown文件(在上一步中创建)。
  • 在新目录中创建一个新的markdown文件。

在所有情况下,现有页面仍然存在,并添加了新页面。

剩下的一个限制是文件名必须唯一。如果您有多个同名文件,则其中只有一个会显示在Wiki中(我不确定是哪个..)。


9
因此,基本上,它只是用于组织页面,而没有给您更多的功能。
Rene Pot

26

GitHub Wiki(又名Gollum)确实使用目录,但未按照您期望的方式使用。

Gollum Wiki上的文档可能需要一些工作,但这是我主要通过测试得出的结果。

  • 所有文件都将出现在Wiki的根目录中,无论它们位于存储库中的何处。
  • _Header_Footer_Sidebar文件是每个目录,但如果存在没有在子文件夹继承。
  • 文件链接可以相对于源文件(将文件与内容保持在一起)。

因此,如果您要使用用于命名空间的目录,则很不走运。考虑使用该{namespace}-{page}方案进行命名间隔。


7
缺少子页面使Gollum和GitHub Wiki扩展为残缺的“ Wiki”。

14

这不是理想的解决方案,但解决方法是创建一个自定义边栏,在该边栏中创建带有指向页面链接的目录。我发现无论如何它还是比文件夹更好,因为它允许您在多个层次结构下具有指向单个页面的链接。


这就是我所采用的方法,但是留下了一个“页面”部分,这是一堆乱七八糟的页面(在我的项目中超过60个)。
杰森·肖特

“页面”部分已折叠,因此不会使侧边栏混乱,
谢谢

1

实际上,仍然存在限制。是的,您可以添加1个级别(因此1个子文件夹)。就是这样!我重构了整个文档的布局,创建了用于组织的多个子文件夹级别,但这是不行的。

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


2
我认为这是不正确的。我正在查看git推荐的wiki网站之一github.com/showcases/projects-with-great-wikis。我做了一个git clone,并确定它们至少具有三个级别的子目录。例如,查看技术文档/ 1-trackers / ruby​​-tracker。
Ed Ost

好的,我自己进行了测试,似乎gollum的子目录甚至与链接文本都具有相同的名称。这有点奇怪。我会理解实际的页面名称是否存在冲突,但是当使用mediaWiki语法[[Link Text | WikiPage]]时,确实确实在Link Text和实际目录名称之间感到困惑。
Ed Ost 2014年

[PageName](PageName)
Ed Ost 2014年

1
gollum-lib确实允许页面名称带有斜线,其行为与您期望的一样。不幸的是,无论是GitHub还是基于“官方”基于Sinatra的Gollum前端都不明智地支持这些。
格温兹2014年

1
Ed Ost评论中的github展示不再存在。另一种FWIW quora.com/...
simesy
By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.