如何构建GitHub wiki文件?

时间:2014-06-16 04:53:32

标签: github filesystems wiki

我已在本地克隆了我的一个GitHub项目的wiki,我想重组文件系统。默认情况下,添加到Wiki的不同页面都在父目录中创建:

/wiki
     home.md
     wiki_page_1.md
     ...

我想要一个类似于此的目录结构:

/wiki
  /setup
    setup_procedures.md
    index.md
  /development
    index.md
    tools.md
  /images
    front_page.png

我试图以类似方式构建我的wiki文件,但它不适用于.md文件。但是,它适用于images文件夹。有没有办法使这项工作?

2 个答案:

答案 0 :(得分:13)

如果GitHub仍在使用github/gollum,那么,如“How can you use subdirectories in a GitHub wiki checkout?”中所述,不支持子文件夹(或者在分叉时出现错误)。

gollum/gollum supports that organization的更新版本,即使最近的公关(拉请求)仍在修复问题(例如PR 787)。

OP tsega添加in the comments

  

试图自己查看Gollum wiki,结果是你可以在目录下整理你的文件,但这不是你访问它们的方式

     

每个页面都是从wiki的根目录访问的,例如。 github.com/user/repo/wiki/file-name不是github.com/user/repo/wiki/directory/file-name

     

文件名应该是唯一的,如果你想拥有合适的标题,他们需要大写和虚线(没有强调)。

答案 1 :(得分:1)

我遇到了同样的问题,我已经使用自定义菜单栏解决了问题,并使用常规Markdown,即标题和链接来创建文件夹结构。