GitHub wiki dizinleri

87

GitHub deposu ile yüklenen wiki, dizinleri destekliyor mu? Wiki'miz sayfalarla dolu ve onları daha iyi organize etmenin bir yolunu arıyoruz.

Depoyu çıkarmayı, yerel dizinler oluşturmayı ve bir şeyleri başka yere taşımayı denedik, ancak geri dönüldüğünde wiki değişiklikleri algılamadı.

github wiki

— John Livermore
kaynak

60

Ben de aynı sorunu yaşıyordum ve denediğin şeyin çeşitlerini denedim. Hiçbir şey sıkışmadı. GitHub desteğine bu konuda soru sordu ve esasen "Hayır, ancak geliştiricilere insanların bu özellikle ilgilendiğini bildireceğiz" şeklinde bir yanıt aldık.

Yani kısa cevap "Hayır" ve uzun cevap "Hayır, ama belki gelecekte".

— Collin M
kaynak

8

Mevcut kısa cevap "Evet" dir. :)

— Marco

2

@Marco ÜÇ yıl sonra? GitHub, kullanıcılarının talebini gerçekten ciddiye alıyor! : |

— trejder

9

Evet, hala hayır, beş yıl sonra

— Lincoln Bergeson

1

Altı yıl. Btw, #Microsoft'un #GitHub'ı ofise geri getirdiği konusunda inleyen insanları duydum. Bugün çok fazla hayal kırıklığım var ve sanırım artık yüz yüze gülebiliyorum.

— DevOvercome

Bunu bu şekilde yapabiliriz docs.gitlab.com/ee/user/project/wiki

— Amrita Deb

30

Aslında, github son zamanlarda dizinler için destek ekledi gibi görünüyor.

Aşağıdakileri yapabildim:

Mevcut bir markdown dosyasını yeni bir dizine taşıyın.
Mevcut bir dizinde (önceki adımda oluşturulan) yeni bir markdown dosyası oluşturun.
Yeni bir dizinde yeni bir markdown dosyası oluşturun.

Her durumda, mevcut sayfalar hala oradaydı ve yeni sayfalar eklendi.

Geriye kalan tek kısıt, dosya adlarınızın benzersiz olması gerektiğidir. Aynı ada sahip birden fazla dosyanız varsa, wikide bunlardan yalnızca biri görünecektir (hangisi olduğundan emin değilim ..).

— Marco
kaynak

9

Yani temelde, sadece sayfalarınızı düzenlemek içindir, ancak size daha fazlasını vermez.

— Rene Pot

26

GitHub wiki ( Gollum olarak da bilinir ) dizinleri kullanır, ancak beklediğiniz şekilde değildir.

Gollum wiki'deki dokümantasyon biraz çalışma gerektirebilir, ancak bu çoğunlukla test yoluyla anladığım şeydi.

Depoda nereye yerleştirilirse yerleştirilsin tüm dosyalar wiki'nin kök dizininde görünür.
_Header, _FooterVe _Sidebardosyalar dizin başına, ama bir çocuk klasöründe hiçbiri mevcut varsa miras.
Dosya bağları kaynak dosyaya göre olabilir (dosyalarınızı içeriğinizle birlikte tutun).

Yani, isim aralığı için dizinler istiyorsanız, şansınız kalmaz. Ad aralığı için {namespace}-{page}şemayı kullanmayı düşünün .

— Kevin Cox
kaynak

7

alt sayfaların olmaması Gollum ve GitHub wiki'yi uzantıya göre sakat bir "wiki" yapar.

14

Bu ideal bir çözüm değil, ancak geçici çözüm, sayfalarınıza bağlantılar içeren bir içindekiler tablosu oluşturduğunuz özel bir kenar çubuğu oluşturmak olabilir. Bunu zaten klasörlerden daha iyi buluyorum çünkü birden çok hiyerarşi altında tek bir sayfaya bir bağlantıya sahip olmanıza izin veriyor.

— Thanh Nguyen
kaynak

Benim aldığım yaklaşım buydu, ancak sayfaların büyük bir karmaşası olan bir "Sayfalar" kısmı bırakıyor (projemde 60'ın üzerinde).

— Jason Short

Sayfalar bölümü daraltıldı, böylece kenar çubuğunu neyse ki karıştırmaz

— pd12

1

Aslında hala bir sınırlama var. Evet, 1 seviye (yani 1 alt klasör) ekleyebilirsiniz. Ama bu kadar! Tüm dokümantasyon düzenimi yeniden düzenledim, organizasyon için birden fazla alt klasör seviyesi oluşturdum, ancak bu hiç de geçerli değildi.

iç çekmek

Şunu söylemeliyim: Bu Gollum olayından dehşete düştüm. Github'ın onu almasına bile şaşırdım.

— Gjoris
kaynak

2

Bunun doğru olduğunu sanmıyorum. Git tarafından önerilen wiki sitelerinden biri olan github.com/showcases/projects-with-great-wikis'e bakıyordum . Bir git klonu yaptım ve kesinlikle en az üç alt dizine sahip olduklarından eminim. Örneğin teknik belgelere / 1-izleyicilere / yakut izleyiciye bir göz atın.

— Ed Ost

Tamam, kendim test ettim ve görünüşe göre gollum, bağlantı metni ile aynı adı taşıyan alt dizinlerle ilgili bir sorun yaşıyor. Bu biraz tuhaf. Gerçek sayfa adında bir çakışma olup olmadığını anlardım, ancak mediaWiki sözdizimini [[Bağlantı Metni | WikiPage]] kullanırken, Bağlantı Metni ile gerçek dizin adı arasında gerçekten kafa karıştırıyor gibi görünüyor.

— Ed Ost

Bu inanılmaz derecede çirkin ve gereksiz format çalışıyor gibi görünüyor [PageName] (PageName)

— Ed Ost

1

gollum-lib, sayfa adlarının beklediğiniz gibi davranan eğik çizgilere sahip olmasına izin verir. Ne yazık ki, ne GitHub ne de "resmi" Sinatra tabanlı Gollum ön ucu bunları mantıklı bir şekilde desteklemiyor.

— gerwitz

1

Ed Ost'un yorumundaki o github vitrini artık yok. Alternatif bir fwiw quora.com/…

— simesy