Github pages and _static

[joedaws]

Github pages processes site files using Jekyll and this means that underscore prefixed directories don't get copied over to the final site. Since the style sheet of a wb generated page is in _static/css the stylesheet won't load for a page hosted on github pages. I think the solution is to follow the suggestion in https://github.blog/2009-12-29-bypassing-jekyll-on-github-pages/ and add a file called .nojekyll or at least that worked for me.

[aerosol]

@joedaws do you think this warrants adding those files to the repo or should we document GH pages deployment on its own page?

[joedaws]

In my opinion, its sufficient to make a note in the documentation about publishing a wb generated site on github pages. Maybe in the Generate for the internets section on the page https://mtod.org/wb/docs/usage.html

[joedaws]

On the other hand, it might be nice to have an optional flag so that wb gen /tmp/my-wiki-prod my-wiki https://cool.web --nojekyll will produce the html files with a .nojekyll file in the output root.