У мене була така точна проблема з typedocs. README.md працював, але жоден із фактичних документів, створених моїми рядками документа, не відображався, я щойно отримав екран 404 Github Pages.
Щоб виправити це, просто помістіть порожній файл у каталог / docs (або там, де ви генеруєте ваші документи) та зателефонуйте .nojekyll
Для підтвердження, ваша файлова структура повинна виглядати так:
./docs/.nojekyll # plus all your generated docs
Надішліть це до віддаленого репортажу Github, і ваші посилання тощо повинні працювати зараз.
Також переконайтесь, що ви вибрали в налаштуваннях Github:
Settings -> Github Pages -> Source -> master brach /docs folder
Залежно від вашого документа doc, вам, ймовірно, доведеться відтворювати цей файл щоразу, коли ви оновлюєте документи, це приклад використання typedocs та створення .nojekyll-файлу кожного разу у файлі package.json:
# package.json
"scripts": {
"typedoc": "typedoc --out docs src && touch docs/.nojekyll"
},