2012-06-18 61 views
61

安裝了GitHub repo支持目錄的wiki是否?我們的wiki雜亂無章,我們正在尋找一種更好的組織方式。GitHub wiki目錄

我們嘗試了拉回購,創建本地目錄和移動東西,但是當提交回來時,維基並未提取這些更改。

回答

45

我有完全相同的問題,並嘗試過你嘗試過的變種。沒有卡住。當被問及GitHub對它的支持並收到回覆時,基本上說「不,但我們會讓開發人員知道人們對此功能感興趣。」

所以簡短的答案是「否」,而長的答案是「不,但也許在將來」。

+6

真的很糟糕。我只想爲i18n使用不同的目錄。但是... –

+4

目前的簡短答案是「是」。 :) – Marco

+2

@Marco三年後? GitHub真的認真對待用戶的請求! :| – trejder

25

實際上,它看起來像github最近增加了對目錄的支持。

我能做到以下幾點:

  • 將現有的降價文件到新的目錄。
  • 在現有目錄中創建新的降價文件(在前一步驟中創建)。
  • 在新目錄中創建一個新的降價文件。

在所有情況下,現有頁面仍然存在,並且添加了新頁面。

剩下的一個約束是您的文件名必須是唯一的。如果你有多個同名的文件,其中只有一個會出現在wiki中(我不確定哪個..)。

+6

所以基本上,它只是爲了組織你的網頁,但沒有給你更多的東西。 –

20

github wiki(aka Gollum)確實使用了目錄,但沒有按照您預期的方式。

關於Gollum wiki的文檔可能會使用一些工作,但這是我主要通過測試發現的。

  • 所有文件出現在wiki的根目錄,不管它們放置在回購站的什麼位置。
  • _Header,_Footer_Sidebar文件是按目錄存放的,但是如果在子文件夾中沒有 則繼承。
  • 文件鏈接可以是相對於源文件(保持您的文件與您的內容)。

所以,如果你想要命名空間的目錄,你是運氣不好。考慮對命名空間使用NS-Page方案。

+4

由於缺少子頁面,Gollum和GitHub wiki被擴展爲一個癱瘓的「wiki」。 –

0

其實還有一個限制。是的,你可以添加1級(如此,1個子文件夾)。但就是這樣!我重構了整個文檔佈局,爲組織創建了多個子文件夾級別,但這是一個不行。

嘆息

我必須說:我這個咕嚕的事情感到震驚。我很驚訝Github甚至拿起它。

+0

我不認爲這是正確的。我在看git推薦的wiki站點之一,https://github.com/showcases/projects-with-great-wikis。我做了一個git克隆,果然他們至少有三級子目錄。例如,看一下技術文檔/ 1-trackers/ruby​​-tracker。 –

+0

好的,我自己測試了一下,看起來gollum的子目錄和鏈接文本的名字一樣,都有問題。這有點奇怪。我會理解,如果在實際頁面名稱中存在衝突,但是在使用mediaWiki語法[[Link Text | WikiPage]]時,確實似乎在鏈接文本和實際目錄名稱之間產生混淆。 –

+0

這種令人難以置信的醜陋和多餘的格式似乎可行[頁面名稱](PageName) –

9

這不是一個理想的解決方案,但解決方法是創建一個自定義邊欄,您可以在其中創建帶有指向您網頁的鏈接的目錄。無論如何,我發現這比文件夾更好,因爲它允許您在多個層次結構中鏈接到單個頁面。

+0

這是我採取的方法,但它留下了「頁面」部分,這是一大堆頁面(我的項目超過60)。 –

+0

頁面部分已摺疊,所以它不會讓側邊欄感到困惑 – pd12