Katalogi wiki GitHub

Czy wiki, które instaluje się z repozytorium GitHub, obsługuje katalogi? Nasza wiki jest zaśmiecona stronami i szukamy sposobu na ich lepszą organizację.

Próbowaliśmy pobrać repozytorium, utworzyć lokalne katalogi i przenosić różne rzeczy, ale po przywróceniu, wiki nie wychwyciło zmian.

Miałem dokładnie ten sam problem i wypróbowałem różne warianty tego, co wypróbowałeś. Nic nie utknęło. Poprosiłem o to wsparcie GitHub i otrzymałem odpowiedź, która zasadniczo brzmiała: „Nie, ale poinformujemy programistów, że ludzie są zainteresowani tą funkcją”.

Zatem krótka odpowiedź brzmi „nie”, a długa odpowiedź brzmi „nie, ale może w przyszłości”.

Właściwie wygląda na to, że github ostatnio dodał obsługę katalogów.

Udało mi się wykonać następujące czynności:

• Przenieś istniejący plik znaczników do nowego katalogu.
• Utwórz nowy plik przeceny w istniejącym katalogu (utworzonym w poprzednim kroku).
• Utwórz nowy plik przeceny w nowym katalogu.

We wszystkich przypadkach istniejące strony nadal istniały, a nowe strony zostały dodane.

Jedynym ograniczeniem, które pozostaje, jest to, że nazwy plików muszą być unikalne. Jeśli masz więcej niż jeden plik o tej samej nazwie, tylko jeden z nich pojawi się na wiki (nie jestem pewien który…).

Witryna wiki GitHub (znana również jako Gollum ) korzysta z katalogów, ale nie w sposób, jakiego można się spodziewać.

Dokumentacja na wiki Golluma przydałaby się trochę pracy, ale właśnie to odkryłem głównie podczas testów.

• Wszystkie pliki pojawiają się w katalogu głównym wiki, bez względu na to, gdzie są umieszczone w repozytorium.
• _Header, _Footera _Sidebarpliki są przypisane do katalogu, ale są dziedziczone, jeśli nie ma ich w folderze podrzędnym.
• Linki do plików mogą być względne w stosunku do pliku źródłowego (zachowaj pliki razem z zawartością).

Tak więc, jeśli potrzebujesz katalogów do przestrzeni nazw, nie masz szczęścia. Rozważ użycie {namespace}-{page}schematu dla przestrzeni nazw.

Nie jest to idealne rozwiązanie, ale obejściem byłoby utworzenie niestandardowego paska bocznego, w którym tworzysz spis treści z linkami do swoich stron. Uważam, że i tak jest to lepsze niż foldery, ponieważ pozwala mieć link do pojedynczej strony w wielu hierarchiach.

W rzeczywistości nadal istnieje ograniczenie. Tak, możesz dodać 1 poziom (czyli 1 podfolder). Ale to jest to! Przebudowałem cały układ dokumentacji, tworząc wiele poziomów podfolderów dla organizacji, ale nie było to możliwe.

westchnienie

Muszę powiedzieć: jestem przerażony tą rzeczą z Gollumem. Jestem zaskoczony, że Github nawet go odebrał.