Ben typedocs ile bu tam bir sorun vardı. README.md çalıştı ama doc dizelerim tarafından oluşturulan gerçek belgelerin hiçbiri görüntülenmedi, sadece 404 Github Sayfaları ekranım var.
Bunu düzeltmek için / docs dizininize (veya dokümanlarınızı oluşturduğunuz her yere) boş bir dosya yerleştirin ve dosyayı arayın .nojekyll
Onaylamak için dosya yapınız şimdi şöyle görünmelidir:
./docs/.nojekyll # plus all your generated docs
Bunu uzaktan Github deponuza itin ve bağlantılarınız vb. Şimdi çalışmalıdır.
Ayrıca Github ayarlarınızda seçtiğinizden emin olun:
Settings -> Github Pages -> Source -> master brach /docs folder
Doküman çerçevenize bağlı olarak, muhtemelen dokümanlarınızı her güncellediğinizde bu dosyayı yeniden oluşturmanız gerekir; bu, typedocs kullanımına ve bir package.json dosyasında her seferinde .nojekyll dosyasını oluşturmaya bir örnektir:
# package.json
"scripts": {
"typedoc": "typedoc --out docs src && touch docs/.nojekyll"
},