GitHub Pages にホスティングしたTypeDocが404になる

GitHub Pagesは、 _で始まるファイルが表示されない。これはGitHubの仕様である模様。

TypoeDocは module ディレクトリ以下に _ で挟まれたHTMLファイルを生成する。そのまま、GitHub Pagesにホスティングしてしまうと404になってしまう。

これらのファイルを表示するためには、ドキュメントのルートに（ docs 下をGitHubPagesで公開していたら docs ディレクトリ直下）.nojekyll ファイルを設置すればよい。

touch .nojekyll

References

• Files that start with an underscore are missing
• All documentation has "_" as a prefix: This prevents typedocs from being served in gh-pages. · Issue #149 · TypeStrong/typedoc · GitHub